Files

7.3 KiB
Raw Permalink Blame History

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) Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.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/ROADMAP nachgezogen:
  • Plane-Ticket (R-P1a/b, AK-P1c) aktualisiert: