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

6.5 KiB
Raw Blame History

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: