51 lines
4.1 KiB
Markdown
51 lines
4.1 KiB
Markdown
# D-D0a · D0 Design-System + App-Shell (A1)
|
||
|
||
| | |
|
||
|---|---|
|
||
| **Typ** | Screen (Design) |
|
||
| **Owner** | David |
|
||
| **Phase** | P1 — Fundament & Walking-Skeleton (globale Baseline, kein Fach-Modul) |
|
||
| **Cycle/Fenster** | W1 — Fundament & Identität · 2026-06-16 → fällig 2026-06-18 |
|
||
| **Status** | geplant |
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **Blocked by:** — (Fundament-Ticket, hat keinen Vorgänger)
|
||
- **Blockt:** ALLE Folge-Screens (App-Shell ist Single Source of Truth, ~70 % aller Screens komponieren darauf), `H-PITCH`
|
||
- **Bedient (Dev):** `R-P1a`/`R-P1b` (Querschnittsdienste + Subframe-Adapter) — die App-Shell ist die UI-Hülle, in der jede Dev-Route rendert
|
||
- **Läuft parallel zu:** `D-WEB` (Brand-Tokens, gleiche W1) — Tokens müssen Web + App konsistent halten
|
||
- **Subframe:** Pflicht je Route. Dieses Ticket **liefert** die A1-App-Shell-Baseline selbst (kein Fach-Screen), aus der alle Folge-Phasen komponieren.
|
||
|
||
## Was wir bauen
|
||
Die **globale App-Shell-Baseline (A1)** plus das **Design-System-Fundament** (Tokens für Farben/Typografie/Spacing, Hell/Dunkel flash-frei). Das ist das Gerüst, das jede spätere Route umgibt: Sidebar mit Konnektor-Gating, Topbar, Breadcrumb, Status-Banner-System und Toast/Inline-Feedback. Kein fachlicher Screen — reine Plattform-Hülle.
|
||
|
||
## Benötigte Screens
|
||
| Screen [Route] | Kern-Inhalt | Archetyp |
|
||
|---|---|---|
|
||
| **App-Shell-Baseline** [global, kein eigener Pfad] | Sidebar (Modul-Navigation Icon+Label, **Konnektor-Gating-Zustand** je `tenantHasModule()` — aktiv/ausgeblendet/gesperrt; Sektionen Arbeit + Verwaltung; Collapse; aktiver Eintrag; Mobile-Drawer/Bottom-Nav 📱) · Topbar (Tenant-Switcher mit zuletzt-genutzt-Liste + Suchfeld ab 5 Tenants, 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, je Text + Action-Button, stapelbar) · Toast/Inline-Feedback (Erfolg / Klartext-Fehler mit Lösungs-Knopf / Warnung) | A1 |
|
||
| **Design-Tokens** [keine Route] | Farben/Typografie/Spacing, Hell/Dunkel-Theme flash-frei (App-Seite; Web-Seite koordiniert mit `D-WEB`) | Tokens |
|
||
|
||
*(Archetypen A2–A7 + Primitives + Zustands-Kit → `D-D0b`. Walking-Skeleton-Beispielroute = Dev-seitig in `R-P1a/b`. Auth-Screens → `D-P2`. Audit/Notif/Files/Tasks-Oberflächen → P3/P4.)*
|
||
|
||
## Features (muss abgedeckt sein)
|
||
- [ ] Design-Tokens (Farben/Typografie/Spacing) + Hell/Dunkel-Theme flash-frei
|
||
- [ ] Sidebar inkl. Konnektor-Gating (Modul je `tenantHasModule()` aktiv/ausgeblendet/gesperrt), Sektionen Arbeit + Verwaltung, Collapse, Mobile-Variante, aktiv-Markierung
|
||
- [ ] Topbar mit Tenant-Switcher (zuletzt-genutzt + Suche ab 5), Cmd+K-Trigger, Notification-Bell (Unread-Badge), User-Menü (Theme-Toggle, Logout)
|
||
- [ ] Breadcrumb-Pfad
|
||
- [ ] Status-Banner-System (4 Tenant-Status, stapelbar, je Text + Action-Button)
|
||
- [ ] Toast + Inline-Feedback (Erfolg / Klartext-Fehler-mit-Lösungs-Knopf / Warnung — Bauprinzip A.1)
|
||
|
||
## 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 + Logout; 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); Hell/Dunkel-Theme-Tokens flash-frei.
|
||
|
||
## Quellen (granular)
|
||
- `designer-briefs/P01-fundament-walking-skeleton.md` → §Benötigte Screens „App-Shell-Baseline (A1)" + §Features (App-Shell/Topbar/Status-Banner/Toast) + §UI-Elemente (Sidebar/Topbar/Banner-Teile)
|
||
- `SCREEN-MAP.md` → §0.1 App-Shell
|
||
- `DESIGNER-FIRST-PLAYBOOK.md` → §1
|
||
- `ROADMAP.md` → Phase 1 · Querschnitt-Block (M00)
|
||
|
||
## Davids Delta (David füllt aus)
|
||
- [ ] Überschriebene/geänderte Spec-Punkte:
|
||
- [ ] Neue UI/UX-Entscheidungen:
|
||
- [ ] Subframe-Screen-Link(s):
|
||
- [ ] Offene Fragen an Dev:
|