Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P26.md
T

85 lines
9.3 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`/`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-D0a` App-Shell, `D-D0b` Archetypen A2/A3/A5/A6 + Auth-Flow) — Portal-Auth ist **strikt getrennt** (eigene `PortalUser`-Klasse, hostgebundene Cookies, Standardhost `portal.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`](../../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`; bedient `VA-P26a` (16.07.–05.08.), `VA-P26b` (frühestens ab 06.08., Ziel offen) und `VA-P26c` (Termin offen); externer Polish → `VD-6`
- `docs/ARCHITECTURE-DECISIONS.md` AD-30 · `docs/CHANGE-REQUESTS.md` CR-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: