Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P26.md
T

64 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# VD-P26 · Screens P26 — Customer-Portal (extern sichtbar, eigener Polish)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P26 — Customer-Portal (v2-P6, ex-P18) · bedient `VA-P26a`/`VA-P26b` |
| **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · 2026-07-20 → fällig 2026-07-22 |
| **Status** | geplant (NEU — Phasen-Ticket) |
> ♻️ **Löst Sammel-Ticket auf / erweitert:** Dieses Phasen-Ticket ersetzt und erweitert das alte Sammel-Ticket **`VD-2`** („Portal-Shell, extern sichtbar, eigener Polish") um den vollen Screen-Satz (Endkunde + Tenant-Admin-Konfig).
> 🔴 **Extern sichtbar → höchster Design-Polish (eigener Polish).** Einzige extern sichtbare Endkunden-Oberfläche.
## Abhängigkeiten & Parallelität
- **Blocked by:** D0-Baseline (`D-D0a` App-Shell, `D-D0b` Archetypen A2/A3/A5/A6 + Auth-Flow) — Portal-Auth ist **strikt getrennt** (eigene `PortalUser`-Klasse, eigene Cookies, Routes unter `/portal/<tenant>/…`), v1-Auth-Pattern parallel verwendet (NICHT geteilt)
- **Bedient (Dev):** `VA-P26a` (Auth/Magic-Link + Projekt-Sicht, 20.07.), `VA-P26b` (Upload/Reklamation + Subunternehmer-Zugang, 21.–22.07.)
- **Läuft parallel zu:** `VD-P27` (Mobile-PWA), KWP-Screens (`VD-P32`) — v2-W2
- **Eigener Polish:** extern sichtbar → fließt zusätzlich in `VD-6` (v2-Politur extern + Visual-Reg-Baselines)
- **Subframe:** Pflicht je Route (Auth-Flow, A2, A3, A5, A6)
## Was wir bauen
Das **Customer-Portal** für Endkunden (PortalUser): über eine **eigene Auth-Schicht** (Magic-Link primär) sehen sie ihre Projekte, deren Status (nur konfigurierte Stages) und freigegebene Dokumente, **laden Dateien hoch** (mobile Kamera, Multi-File) und melden Reklamationen. Bei `project.stage_changed` gehen **Auto-Status-Mails** raus (debounced). Der Tenant-Admin konfiguriert Phasen-Sichtbarkeit, Dokument-Auto-Freigabe, Access-Matrix und Mail-Templates; DSGVO-Lösch/Export für PortalUser vorhanden. Härtung: Rate-Limits, Captcha, **kein User-Enumeration**, fehlender Zugang → **404**.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Endkunde · Login [`/portal/{tenant}/login` · `/login/magic-sent`] | E-Mail-Login (Magic-Link primär, Passwort sekundär), „Magic-Link gesendet"-Bestätigung, kein User-Enumeration | Auth-Flow |
| Endkunde · Setup/Verify/Reset [`/portal/{tenant}/setup/{token}` · `/verify-email/{token}` · `/forgot-password` · `/reset-password/{token}`] | Erstzugang-Setup, E-Mail-Verifizierung, Passwort-Vergessen/-Reset | Auth-Flow |
| Endkunde · Portal-Dashboard [`/portal/{tenant}`] | Übersicht eigene Projekte + Status, freigegebene Dokumente, Schnellaktionen | A3/Dashboard |
| Endkunde · Projekte-Liste [`/portal/{tenant}/projects`] | Liste eigener Projekte (Name, Stage/Fortschritt, letztes Update) | A2 |
| Endkunde · Project-Detail [`/portal/{tenant}/projects/:id`] | Fortschritt (nur sichtbare Stages), freigegebene Dokumente (Download), Upload, Reklamation melden, Forms (`portal_form`) | A3 |
| Endkunde · Upload [`/portal/{tenant}/upload`] | Datei-Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + PL-Notification | A5 |
| Endkunde · Settings [`/portal/{tenant}/settings` · `/notifications` · `/account-delete`] | Profil, Benachrichtigungs-Präferenzen, DSGVO-Account-Löschung/Export | A6 |
| Tenant-Admin · Portal-Konfig [`/admin/portal`] | Phasen-Sichtbarkeit, Dokument-Auto-Freigabe-Regeln, Aktivierung pro Projekt-Typ | A6 |
| Tenant-Admin · PortalUser-Verwaltung [`/admin/portal/users`] | PortalUser-Liste, Einladen, Zugang sperren/entziehen, Status | A2 |
| Tenant-Admin · Access-Matrix [`/admin/portal/access`] | Wer-sieht-welches-Projekt (Zugriffs-Matrix), Subunternehmer-Zugang | A2 |
| Tenant-Admin · Mail-Template-Editor [`/admin/portal/email-templates`] | Auto-Status-Mail-Vorlagen je Stage-Event, Variablen, Vorschau | A3 |
## Features (muss abgedeckt sein)
- [ ] Eigene `PortalUser`-Klasse strikt getrennt (eigene Cookies/Routes, keine Permission-Vermischung); Magic-Link primär
- [ ] Endkunde sieht nur eigene Projekte / konfigurierte Stages / freigegebene Dokumente; fehlender Zugang → 404 (keine Existenz-Offenlegung)
- [ ] Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + Projektleiter-Notification; Reklamation melden
- [ ] Auto-Status-Mails bei `project.stage_changed` (Debounce; Bedingungen: sichtbare Stage / aktiver Access / Pref / nicht frozen)
- [ ] Tenant-Admin: Phasen-Sichtbarkeit / Doc-Auto-Freigabe / Templates; Subunternehmer-Zugang (M144); Service-Inbox/Skalierungs-Sicht (M145)
- [ ] DSGVO-Lösch/Export für PortalUser + Lebensdauer-/Konfig-Verwaltung (M146)
- [ ] Härtung: Rate-Limits, Captcha, kein User-Enumeration, wasserdichte Cookie-Trennung
- [ ] **Hoher externer Polish** (Endkunden-facing) + Hell/Dunkel + Mobile
- [ ] Wiederverwendung v1: Auth-Pattern (parallel, NICHT geteilt), Files/FileEntityLink, Sende-Domain (Auto-Mails), Form-Builder (`portal_form`), Automation (`portal.*`), notify(), DSGVO-Lösch-Workflow
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Magic-Link-Login-Formular (E-Mail-Feld, „Link senden"); „Magic-Link gesendet"-Bestätigung; Passwort-Setup/-Reset-Formulare; Captcha-Einbindung; Projekt-Karten/-Liste mit Fortschritts-/Stage-Indikator (nur sichtbare Stages); Dokument-Liste mit Download (freigegebene); Upload-Control (mobile-Kamera-Capture, Multi-File-Drag-Drop, Größen-/Typ-Limit-Hinweis); Reklamations-Formular; Portal-Form-Renderer (`portal_form`); Benachrichtigungs-Präferenz-Toggles; Account-Lösch-/Export-Flow (Bestätigung); Admin: Zugriffs-Matrix-Tabelle, PortalUser-Verwaltungs-Tabelle (Einladen/Sperren), Phasen-Sichtbarkeits-Konfig (Stage-Toggles), Doc-Auto-Freigabe-Regel-Editor, Mail-Template-Editor mit Variablen + Vorschau; 404-/Kein-Zugang-State (ohne Existenz-Offenlegung); Empty-/Loading-/Frozen-Read-Only-States (Klartext). **Hoher externer Polish.**
## Quellen (granular)
- `designer-briefs/P26-customer-portal.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Portal-Domäne (M15)** + Project-Stages/Files/FileEntityLink (Domäne 3/5)
- `ROADMAP-V2.md` §v2-P6 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 26 · `_bmad-output/specs/M15-customer-portal.md`
- Plane-Snapshot: ersetzt/erweitert `VD-2`; bedient `VA-P26a`/`VA-P26b` (v2-W2, 20.–22.07.); externer Polish → `VD-6`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: