Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -4,37 +4,56 @@
|---|---|
| **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) |
| **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, 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
- **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 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**.
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/{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 |
| 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
@@ -45,16 +64,18 @@ Das **Customer-Portal** für Endkunden (PortalUser): über eine **eigene Auth-Sc
- [ ] 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: 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.**
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)
- `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`
- 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: