9.3 KiB
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/VA-P26c |
| Cycle/Fenster | parallel zu P26 · Zieltermin offen |
| Status | geplant (NEU — Phasen-Ticket) · 0/11 Features = 0 % done |
♻️ 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-D0aApp-Shell,D-D0bArchetypen A2/A3/A5/A6 + Auth-Flow) — Portal-Auth ist strikt getrennt (eigenePortalUser-Klasse, hostgebundene Cookies, Standardhostportal.hivegrid.de/<tenant>), v1-Auth-Pattern parallel verwendet (NICHT geteilt) - Bedient (Dev):
VA-P26a(Auth/Magic-Link + Projekt-Sicht, 16.07.–05.08.),VA-P26b(Upload/Reklamation + Subunternehmer-Zugang, frühestens ab 06.08., Ziel offen),VA-P26c(Paket-Gates + Custom-Domain, Termin offen). Durch AD-28 sind die Design-Deltas Nachzüge, keine harten Dev-Blocker. - Läuft parallel zu:
VD-P27(Mobile-PWA) und KWP-Screens (VD-P32); der eigene Zieltermin bleibt offen - 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)
Technischer Handoff 2026-07-21: VA-P26a steht bei 8/8, VA-P26b bei 6/6 und VA-P26c bei
8/8 DoD. PR #202, Staging-Deploy #10925 und der anschließende read-only Nachweis belegen den
deprovisionierten HTTPS-Host mit dem vertraglichen 404, ohne Kill-Switch-Replay oder
Produktionsänderung. Der vollständige technische Abschluss verändert den Designstand nicht:
VD-P26 bleibt 0/11 Features = 0 % done und als separater design-nachzug offen.
UI-Rescue-Handoff 2026-07-22: PR #212 vereinheitlicht die aktuelle Interim-UI mit dem realen
HiveGrid-App-Shell-Vertrag, macht die Portalnavigation vollständig bedienbar, reduziert Dashboard-,
Projekt-, Upload- und Settings-Flächen und ergänzt Tenant-Logo plus HiveGrid-Fallback. Main-Revision
090e2558a6965e1c5804eb24d3eab5da8c8611a8 wurde über Deploy #11018 erfolgreich nach Staging
ausgerollt. Die aktuelle Oberfläche und ihre bewussten Grenzen sind in
docs/features/customer-portal.md dokumentiert.
Dieser Rescue ist weiterhin AD-28-Interim-UI und ersetzt weder Davids Delta noch die elf finalen
Subframe-Screens. VD-P26 bleibt deshalb 0/11 Features = 0 % done.
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 Workspace-Admin konfiguriert Phasen-Sichtbarkeit, Dokument-Auto-Freigabe, Access-Matrix und Mail-Templates, bucht das Portal-Add-on und richtet optional per TXT/CNAME eine Custom-Domain ein. DSGVO-Lösch/Export für PortalUser vorhanden. Härtung: Rate-Limits, Captcha, kein User-Enumeration, fehlender Zugang/Host → 404.
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Endkunde · Login [portal.hivegrid.de/{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.hivegrid.de/{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.hivegrid.de/{tenant}] |
Übersicht eigene Projekte + Status, freigegebene Dokumente, Schnellaktionen | A3/Dashboard |
Endkunde · Projekte-Liste [portal.hivegrid.de/{tenant}/projects] |
Liste eigener Projekte (Name, Stage/Fortschritt, letztes Update) | A2 |
Endkunde · Project-Detail [portal.hivegrid.de/{tenant}/projects/:id] |
Fortschritt (nur sichtbare Stages), freigegebene Dokumente (Download), Upload, Reklamation melden, Forms (portal_form) |
A3 |
Endkunde · Upload [portal.hivegrid.de/{tenant}/upload] |
Datei-Upload (mobile-Kamera, Multi-File, Basispaket-Limits) → Files + Activity + PL-Notification | A5 |
Endkunde · Settings [portal.hivegrid.de/{tenant}/settings · /notifications · /account-delete] |
Profil, Benachrichtigungs-Präferenzen, DSGVO-Account-Löschung/Export | A6 |
Workspace-Admin · Portal-Konfig [app.hivegrid.de/settings/customer-portal] |
Paketstatus/Paywall, Phasen-Sichtbarkeit, Dokument-Auto-Freigabe-Regeln, Aktivierung pro Projekt-Typ | A6 |
Workspace-Admin · Custom-Domain [app.hivegrid.de/settings/customer-portal/domain] |
Paketberechtigung, Hostname, TXT/CNAME-Anleitung, Verify/Provisioning/TLS/Fehler, Standardhost-Fallback, Entfernen/Wechseln | A6 + Web-Flow |
Workspace-Admin · PortalUser-Verwaltung [app.hivegrid.de/settings/customer-portal/users] |
PortalUser-Liste, Einladen, Zugang sperren/entziehen, Status | A2 |
Workspace-Admin · Access-Matrix [app.hivegrid.de/settings/customer-portal/access] |
Wer-sieht-welches-Projekt (Zugriffs-Matrix), Subunternehmer-Zugang | A2 |
Workspace-Admin · Mail-Template-Editor [app.hivegrid.de/settings/customer-portal/email-templates] |
Auto-Status-Mail-Vorlagen je Stage-Event, Variablen, Vorschau | A3 |
Auf einem aktiven Custom-Host, z. B. portal.geerkens.de, gelten dieselben Endkundenpfade ohne /{tenant}.
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
- Paket-/Paywall-Zustände gemäß AD-30 (Starter/Team bezahlt, Business/Enterprise inklusive; Custom-Domain bei Starter/Team/Business 299,99 EUR netto je Einrichtung, bei Enterprise eine inklusive; ein Domainwechsel ist eine neue kostenpflichtige Einrichtung, sofern keine individuelle Enterprise-Regel greift) sowie unveränderte Ressourcenlimit-Hinweise
- Custom-Domain-Self-Service mit verständlicher DNS-Anleitung, vollständiger Status-/Fehlerstrecke, sichtbarem Standardhost-Fallback und erklärtem 30-Tage-Reclaim-Cooldown bei Entfernen/Wechseln
- 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: Paket-/Entitlement-Status, Add-on-CTA/Payment-Zustände, Domain-Eingabe, kopierbare TXT-/CNAME-Werte, Verify-Aktion, Status-Timeline, TLS-/DNS-Fehlerbehebung, Fallback-Link, Entfernen-/Wechseln-Bestätigung, 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)- Plane-Snapshot: ersetzt/erweitert
VD-2; bedientVA-P26a(16.07.–05.08.),VA-P26b(frühestens ab 06.08., Ziel offen) undVA-P26c(Termin offen); externer Polish →VD-6 docs/ARCHITECTURE-DECISIONS.mdAD-30 ·docs/CHANGE-REQUESTS.mdCR-001 ·docs/INTEGRATION-CONTRACTS.md§3/§14
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev: