Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-D0a.md
T

51 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: