Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,51 @@
# Designer-Brief · P1 — Fundament & Walking-Skeleton
**Phase:** 1/21 · **Modul:** M00/Querschnitt (logActivity · Search-Registry · Subframe-Adapter · Feature-Flags · Audit · notify · i18n) · **Owner-Dev:** Raffael (R-P1a/b) + Akeshan (AK-P1c) · **Designer:** David (D-P1, App-Shell-Baseline → blockt ~70 % aller Folge-Screens)
**Quellen:** `ROADMAP.md` §Phase 1 · `SCREEN-MAP.md` §0 (D0/App-Shell + Archetypen A2–A7) · `REQUIREMENTS.md` Querschnitt-Block + M21/M22/M30/M32-Datenmodelle · `ENTITY-MODEL.md` Cross-Cutting + Domäne 2 (Service-Kern-Teile) · `docs/INTEGRATION-CONTRACTS.md`, `docs/ARCHITECTURE-DECISIONS.md`; Service-Kern-Specs `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md`, `M32-feature-flags.md`
**Subframe:** Pflicht je Route. Diese Phase liefert die **Archetypen-Baseline** selbst (A1 App-Shell + A2–A7 + Basis-Primitives), aus der alle Folge-Phasen komponieren.
> ⚙️ **Sonder-Hinweis (überwiegend Querschnittsdienste, kaum Fach-UI):** Phase 1 ist primär Backend/Plattform-Fundament (logActivity, Search-Registry, Subframe-Adapter, Mass-Action-Schutz, Audit-Hash-Kette, notify(), i18n-Engine, Feature-Flag-Engine + Entitlement-Gate). Es gibt **keine fachlichen Screens** — der UI-Anteil ist (1) die **App-Shell-Baseline** (§0, Single Source of Truth für alle Folge-Screens) und (2) eine **Walking-Skeleton-Beispielroute**, die das View-Model-Muster, die Sidebar-Registrierung und das Konnektor-Gating exemplarisch zeigt. David designt hier das Fundament; Fach-Screens kommen ab P2.
## Was dieses Modul tut (Kurzfassung)
Macht das Repo zu einer lauffähigen, EU-sterilen Codebasis und stellt die Querschnittsdienste bereit, auf denen alle Folge-Module aufsetzen: `logActivity()` (append-only Activity-Stream), Search-Registry, Subframe-Adapter, Mass-Action-Schutz, Audit-Event mit SHA-256-Hash-Kette (Prisma-Middleware, default-on), `notify()` mit Kanal-Abstraktion (In-App/Email; Push-Stub bis v2), `packages/i18n` (Resolution User → Tenant → DE, Build-Lint gegen Hard-Strings) und die Feature-Flag-Engine mit Entitlement-Gate (`tenantHasModule()` — Konnektor-Prinzip: jede Modul-Phase schaltet Sidebar/Routes/Actions plan-gebunden). Liefert außerdem die verbindlichen URL-Schemata und eine Walking-Skeleton-Route als grünen Smoke-Test-Anker.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **App-Shell-Baseline** [global, kein eigener Pfad] | Sidebar (Modul-Navigation mit Icons+Labels, **Konnektor-Gating-Zustand** je `tenantHasModule()` — ausgeblendet/gesperrt, Sektionen Arbeit + Verwaltung, Collapse, aktiver Eintrag, Mobile-Drawer/Bottom-Nav 📱) · Topbar (Tenant-Switcher, Cmd+K-Trigger, Notification-Bell mit Unread-Badge, User-Menü mit Hell/Dunkel-Toggle + Logout) · Breadcrumb · **Status-Banner-System** (past_due/frozen/deletion_pending/suspended, stapelbar) · Toast/Inline-Feedback (Erfolg / Klartext-Fehler mit Lösungs-Knopf / Warnung) | A1 |
| **Archetypen-Kit A2–A7** [keine Route] | A2 List-View-Kit · A3 Detail-View-Kit (inkl. Activity-Stream-Komponente) · A4 Form/Input-Kit (12 Feldtypen) · A5 Modal/Wizard-Kit · A6 Settings/Connection-Kit · A7 Zustands-Kit (leer/laden/Fehler/keine-Berechtigung/offline) | A2–A7 |
| **Basis-Primitives** [keine Route] | Buttons (primär/sekundär/destruktiv/ghost), Badges/Status-Pills, Tags (farbig), Avatare + Avatar-Stapel, Tabs, Dropdown, Date/Time-Picker, Tooltip, KPI-Kachel, Chart-Basis (Linie/Balken/Donut), Drawer, Markdown-Editor + -Renderer, Datei-Dropzone mit Progress, Unterschriften-Feld (Touch) 📱, Emoji-Picker, Mention-Highlight | Primitives |
| Walking-Skeleton-Route [Beispiel-Modul-Route] | Eine in der Sidebar registrierte Beispielroute, die das View-Model-im-Loader-Muster + Konnektor-Gating exemplarisch zeigt (grüner Smoke-Test gegen `packages/ui-mock`) — minimal, nur als Compose-Beispiel aus A2 | A2 (minimal) |
*(Audit-Viewer/Notification-Center/Notification-Settings/Sprach-Settings = Oberflächen → P3. Auth-Screens → P2. Files/Tasks → P4. Hier nur die Service-Kerne + die Shell.)*
## Geplante Features (muss abgedeckt sein)
- [ ] App-Shell-Baseline mit Sidebar inkl. Konnektor-Gating-Zustand (Modul je `tenantHasModule()` ausgeblendet/gesperrt) — Sektionen Arbeit + Verwaltung, Collapse, Mobile-Variante
- [ ] Topbar mit Tenant-Switcher, Cmd+K-Trigger, Notification-Bell (Unread-Badge), User-Menü (Hell/Dunkel-Toggle, Logout) + Breadcrumb
- [ ] Status-Banner-System (past_due/frozen/deletion_pending/suspended, je Text + Action-Button, stapelbar) + Toast/Inline-Feedback mit Klartext-Fehler + Lösungs-Knopf (Bauprinzip A.1)
- [ ] Archetypen A2–A7 + Basis-Primitives einmal designt, überall komponierbar (inkl. Activity-Stream-Komponente, 4 Zustände, Unterschriften-Feld, Markdown)
- [ ] Walking-Skeleton-Route in Sidebar registriert, Loader gibt View-Model zurück, Konnektor-Gate exemplarisch, grüner Smoke-Test
- [ ] Service-Kerne aufrufbar (Backend, kein UI): `logActivity()`, Search-Registry, Subframe-Adapter, Mass-Action-Schutz, Audit-Hash-Kette (Prisma-Middleware default-on), `notify()` (In-App/Email, Push-Stub), `packages/i18n` (Resolution User→Tenant→DE, Build-Lint Hard-Strings), Feature-Flag-Engine + `tenantHasModule()` mit Redis-Cache
- [ ] EU-Sterilisation: GitHub/Google-OAuth-Reste + `User.githubId/googleId` entfernt, kein US-Kern im Auth-Pfad
- [ ] Verbindliche URL-Schemata dokumentiert (App, Admin, Portal, Forms, Booking, Help, API)
- [ ] Entitlement-Gate-Muster `tenantHasModule('<modul>')` mit Beispiel-Anwendung an der Walking-Skeleton-Route (Konnektor-Prinzip — jede Folge-Phase registriert ihren Feature-Konnektor)
## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Sidebar mit Icon+Label-Navigationseinträgen und drei Konnektor-Zuständen (aktiv/ausgeblendet/gesperrt), Sektions-Gruppierung, Collapse-Steuerung, Mobile-Drawer/Bottom-Nav-Variante, aktiv-Markierung; Topbar mit Tenant-Switcher-Dropdown (zuletzt-genutzt-Liste, Suchfeld ab 5 Tenants), Cmd+K-Such-Trigger, Notification-Bell mit Unread-Badge, User-Menü mit Theme-Toggle; Breadcrumb-Pfad; stapelbares Status-Banner-System mit Text + Action-Button je Tenant-Status; Toast- und Inline-Feedback-Komponente (Erfolg/Fehler-mit-Lösungs-Knopf/Warnung); Daten-Tabelle (sortierbar/paginiert) + Karten-Alternative + Filter-Bar + Bulk-Action-Bar + Spalten-Konfig + CSV-Export-Button + Archiviert-Toggle + Leerzustand-mit-CTA (A2); Detail-Panel mit Inline-Edit-Feld + Related-Panels + Activity-Timeline (Actor-Kind-Marker user/system/automation/ki) + Custom-Felder-Sektion + Tags-Zeile + Sub-Tabs (A3); Form-Kit mit allen 12 Feldtypen + Validierungs-/Klartext-Fehler-Zuständen + Auto-Complete-Picker + Pflichtfeld-Markierung (A4); Modal/Wizard mit Progress + Bestätigungs-Dialog mit Confirm-Phrase-Variante + Side-Panel/Drawer (A5); Settings-Sektions-Layout + Toggle-Zeile mit Klartext + Connection-Card mit Status-Ampel + Key/Secret-Reveal (A6); Zustands-Kit (leer/laden-Skeleton/Fehler-mit-Lösungs-Knopf/keine-Berechtigung/offline 📱) (A7); Basis-Primitives (Buttons in 4 Varianten, Badges/Status-Pills, farbige Tags, Avatare+Stapel, Tabs, Dropdown, Date/Time-Picker, Tooltip, KPI-Kachel, Chart-Basis, Drawer, Markdown-Editor+Renderer, Datei-Dropzone mit Progress, Touch-Unterschriften-Feld, Emoji-Picker, Mention-Highlight); Hell/Dunkel-Theme-Tokens flash-frei.
## 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/PHASE-SOURCES nachgezogen:
- [ ] Plane-Ticket (R-P1a/b, AK-P1c) aktualisiert: