7.6 KiB
Designer-Brief · P26 — Customer-Portal (v2-P6) ⭐ (ex-P18)
Phase: 26/34 (v2-P6) · Modul: M15 (M141–M146 + AD-30-Delta) · Owner-Dev: Akeshan (VA-P26a/b/c) · Designer: David · Slot: parallel zu P26, Zieltermin offen; VA-P26a 16.07.–05.08., VA-P26b frühestens ab 06.08., VA-P26c Termin offen
Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.md.
Subframe: Pflicht je Route. Eigener Polish — extern sichtbar. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings, Auth-Flow).
🔴 Auth-Trennung & externer Polish: Eigene
PortalUser-Klasse strikt getrennt von TenantUser (eigene hostgebundene Cookies, keine Permission-Vermischung), Magic-Link primär. Standard-Routes liegen unterhttps://portal.hivegrid.de/<tenant>/…; ein verifizierter Custom-Host zeigt dieselben Screens ohne Tenant-Slug. Endkunden-Screens laufen im separatenhivegrid-portal-Container, Workspace-Admin-Screens weiterhin inhivegrid-web; das ändert den gemeinsamen VM-/Action-Contract und die Optik nicht. Eigene Auth = eigenes Härtungs-Budget (Rate-Limits, Captcha, kein User-Enumeration, fehlender Zugang → 404 statt Existenz-Offenlegung). Dies ist die einzige extern sichtbare Endkunden-Oberfläche → höchster Design-Polish. Ausgeklammert: eigenes Portal-Image im ersten Schnitt, Multi-Portal, vollständiges App-White-Label, Apex-/Wildcard-/Mehrfach-Domains, eigenes PortalSubscription-Modell und PWA-Push.
Was dieses Modul tut (Kurzfassung)
Endkunden (PortalUser) sehen über eine eigene Auth-Schicht 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, bedingungsgesteuert). Der Workspace-Admin konfiguriert Phasen-Sichtbarkeit, Dokument-Auto-Freigabe und Mail-Templates, bucht das Portal-Add-on und richtet optional per DNS-Self-Service eine Custom-Domain ein; DSGVO-Lösch/Export für PortalUser ist vorhanden.
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 auf einen Blick, 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, 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] |
Hostname, TXT-/CNAME-Anleitung, Verify-Aktion, Provisioning-/TLS-/Fehlerstatus, 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, bleiben die Endkundenpfade identisch, aber ohne
/{tenant}. Der Standardhost ist immer sichtbar als Fallback-Link.
Geplante Features (muss abgedeckt sein)
- Eigene
PortalUser-Klasse strikt getrennt von TenantUser (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 konfiguriert 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
- Paket-/Paywall-Zustände: Starter/Team 19,99 EUR netto/Monat, Business/Enterprise inklusive; Custom-Domain Starter/Team/Business 299,99 EUR netto je Einrichtung, Enterprise eine inklusive; Domainwechsel ist eine neue kostenpflichtige Einrichtung, sofern keine individuelle Enterprise-Regel greift
- Custom-Domain-Self-Service mit verständlicher DNS-Anleitung und allen Zuständen (
pending_dns,verified,provisioning,active, Fehler/deaktiviert); Standardhost-Fallback und 30-Tage-Reclaim-Cooldown bei Entfernen/Wechseln bleiben sichtbar - Wiederverwendung v1: Auth-Pattern (parallel, NICHT geteilt), Files/FileEntityLink, Sende-Domain (Auto-Mails), Form-Builder (
portal_form), Automation (portal.*), notify(), DSGVO-Lösch-Workflow
Benötigte 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 und Add-on-CTA, Domain-Eingabe, kopierbare TXT-/CNAME-Werte, DNS-Prüfen-Aktion, Domain-/TLS-Status-Timeline, Fehlerbehebung, Standardhost-Fallback, Domain-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 (Endkunden-facing).
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev:
Dev-Nachzug (wir nach Davids Delta)
- Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- REQUIREMENTS/ROADMAP nachgezogen:
- Plane-Ticket (VA-P26a/b/c) aktualisiert: