Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P26b.md
T

4.7 KiB

VA-P26b · P26 Customer-Portal: Upload/Reklamation + Subunternehmer/Skalierung/DSGVO ⭐

Typ Dev (Code)
Owner Akeshan
Phase P26 — Customer-Portal · v2-P6 (ex-P18)
Cycle/Fenster v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-22
Status geplant

Abhängigkeiten & Parallelität

  • Blocked by: VA-P26a (Portal-Auth-Schicht + PortalUser + Projekt-Sicht)
  • Blocks: VJ-3 (Website — Portal-Verlinkung/Marketing)
  • Läuft parallel zu: Raffaels VR-P5/KWP im selben Fenster v2-W2 — disjunkte Domänen. Erweitert prisma/schema/customer-portal.prisma (VA-P26a) additiv.
  • Konflikt-Risiko: gering — additiv auf der bereits getrennten Portal-Auth-Schicht aus VA-P26a.

Was wir bauen

Den Skalierungs- und Endkunden-Interaktions-Teil des Customer-Portals (⭐ externer Polish): Endkunden laden Dateien hoch (mobile Kamera, Multi-File) → Files + Activity + Projektleiter-Notification, und melden Reklamationen. Subunternehmer erhalten Zugang (M144), eine Skalierungs-Sicht/Service-Inbox (M145) bündelt eingehende Portal-Aktivität. Der Tenant-Admin konfiguriert Phasen-Sichtbarkeit, Dokument-Auto-Freigabe und Mail-Templates; DSGVO-Lösch/Export für PortalUser ist vorhanden (M146).

Benötigte Screens (Backend bedient — Design liefert D-P26, externer Polish)

Screen [Route] Kern-Inhalt
Endkunde · Upload [/portal/{tenant}/upload] Datei-Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + PL-Notification
Endkunde · Reklamation [/portal/{tenant}/projects/:id] Reklamations-Formular (portal_form-Renderer)
Endkunde · Settings [/portal/{tenant}/settings · /notifications · /account-delete] Profil, Benachrichtigungs-Präferenzen, DSGVO-Account-Löschung/Export
Tenant-Admin · Portal-Konfig [/admin/portal] Phasen-Sichtbarkeit, Dokument-Auto-Freigabe-Regeln, Aktivierung pro Projekt-Typ
Tenant-Admin · PortalUser-Verwaltung [/admin/portal/users] PortalUser-Liste, Einladen, Zugang sperren/entziehen, Status
Tenant-Admin · Access-Matrix [/admin/portal/access] Wer-sieht-welches-Projekt + Subunternehmer-Zugang
Tenant-Admin · Skalierungs-Sicht/Service-Inbox [/admin/portal] Eingehende Portal-Aktivität (Uploads/Reklamationen) gebündelt

Definition of Done

  • Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + PL-Notification; Reklamation melden
  • Subunternehmer-Zugang (M144) + Skalierungs-Sicht/Service-Inbox (M145)
  • Tenant-Admin-Konfig (Phasen-Sichtbarkeit / Doc-Auto-Freigabe / Mail-Templates)
  • DSGVO-Lösch/Export für PortalUser + Lebensdauer-/Konfig-Verwaltung (M146)
  • Wiederverwendung v1: Files/FileEntityLink, Form-Builder (portal_form), Automation (portal.*), notify(), DSGVO-Lösch-Workflow
  • RLS auf allen Portal-Tabellen; Access-Filter serverseitig; Frozen → Read-Only

Technische Bausteine

  • Entities (Delta auf prisma/schema/customer-portal.prisma aus VA-P26a, AD-21): PortalUpload/-Verknüpfung über FileEntityLink, PortalComplaint (Reklamation, via portal_form-FormSubmission), PortalSubcontractorAccess (M144), Portal-Konfig (PortalStageVisibility erweitert, Doc-Auto-Freigabe-Regeln), DSGVO-Lösch-/Export-Record je PortalUser (M146). files.prisma/form.prisma nur über FK.
  • Upload-Pipeline: mobile-Kamera-Capture + Multi-File → @toolctrl/storage + FileEntityLink; schreibt Activity (actor_kind=system) + notify() an Projektleiter.
  • Reklamation + Forms: v1-Form-Builder mit Subtype portal_form (FormSubmission + FormAction); Service-Inbox aggregiert Portal-Activity.
  • DSGVO: Lösch-/Export-Workflow für PortalUser über v1-DSGVO-Lösch-Workflow; Lebensdauer-/Konfig-Verwaltung (M146).
  • Härtung & RLS: Frozen→Read-Only respektieren; RLS überall; is_demo_data auf seedbaren Demos.

Quellen (granular)

  • ROADMAP-V2.md → §v2-P6 (Upload/Reklamation/Subunternehmer/Skalierung/DSGVO = Hauptquelle)
  • ENTITY-MODEL.md → Domäne 4 Files/FileEntityLink + Domäne 9 Forms (portal_form) + Domäne 13 DSGVO-Lösch-Workflow
  • ROADMAP.md → Phase 26 · PHASE-SOURCES.md → Phase 26 (M143 Upload/Reklamation, M144 Subunternehmer, M145 Skalierung/Service-Inbox, M146 Lebensdauer/DSGVO/Konfig)
  • designer-briefs/P26-customer-portal.md (⭐ externer Polish, Access-Matrix, DSGVO-Flow)
  • _bmad-output/specs/M15-customer-portal.md (Portal-Skalierung)
  • Querverweis: ticket-docs/VA-P26a.md (Portal-Auth-Schicht, auf der dies aufbaut)

Dev-Nachzug (nach Davids D-P26-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket VA-P26b aktualisiert