docs: finalize D-P3 notification handoff
This commit is contained in:
david committed
1 parent
1eb7765b41
commit
628d5e1c87
15 files changed
+805
-266
No files matched your search
@@ -0,0 +1,112 @@
|
||||
---
|
||||
kind: ticket-handoff
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
area: Benachrichtigungen
|
||||
status: Fertig / Development-Handoff
|
||||
scope: Teil Benachrichtigungen
|
||||
repo: https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Wireframes
|
||||
stand: 2026-08-27
|
||||
---
|
||||
|
||||
# D-P3 Benachrichtigungen
|
||||
|
||||
Repo: https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Wireframes
|
||||
|
||||
Zentrale Tracker-Datei: [Screen Paket Tracker](../../02%20Wireframes/Screen%20Paket%20Tracker.md)
|
||||
|
||||
Flow-Paket: [WF-P3 Benachrichtigungen](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen.md)
|
||||
|
||||
Canvas: [WF-P3 Benachrichtigungen.canvas](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen.canvas)
|
||||
|
||||
Subframe: [Finaler Handoff-Flow](https://app.subframe.com/f023064a5ca0/flow/f6bc85c2-186c-40d9-a0c1-bacb03fad68a/edit)
|
||||
|
||||
## Kurzfassung
|
||||
|
||||
Der Benachrichtigungs-Teil von D-P3 ist als Development-Handoff abgeschlossen. Der finale Live-Stand umfasst **acht Seiten in einem Subframe-Flow**: S01, S02B und S03 bis S08. Drawer, Vollseite, Einstellungen, Live-Einblendungen, Banner, Status-Toasts, Mikro-Feedback und kritischer Dialog sind gemeinsam validiert.
|
||||
|
||||
Die nur für die Systemreview gebaute Übersichtsseite S00 wurde anschließend aus Subframe und Obsidian entfernt. Die Systemzusammenfassung bleibt im Paket-MD und im Obsidian-Canvas erhalten. Zwei globale Komponenten sind als Referenzen verlinkt: Notification Item und Permanent Banner.
|
||||
|
||||
Der Subframe-Flow trägt technisch noch den internen Altnamen `(MCP) WF-P16 Benachrichtigungen – Review-Draft 2026-08`. Die stabile Flow-URL und dieses Handoff ordnen ihn eindeutig D-P3 / WF-P3 zu; der Altname blockiert Development nicht.
|
||||
|
||||
D-P3 umfasst außerdem den getrennten Bereich Audit Log. Dieses Handoff finalisiert ausschließlich den Teil **Benachrichtigungen** und verändert den Status des separaten Pakets `WF-P3 Audit Log` nicht.
|
||||
|
||||
## Gemacht
|
||||
|
||||
- Einheitliches, quellenbasiertes In-App-Modell ohne zusätzliche Kategorie- oder Severity-Ebene festgelegt.
|
||||
- Notification Item für Live-Overlay, Drawer und Vollseite validiert.
|
||||
- Drawer ohne X an Center-Einträgen, mit einzelner Aktion `Gelesen` und zwei Einstiegen zur Vollseite abgeschlossen.
|
||||
- Vollseite mit Alle/Ungelesen/Gelesen, Quellen- und Zeitraumfiltern, Checkboxen sowie zwei klaren Bulk-Aktionen abgeschlossen.
|
||||
- Einstellungen auf einen globalen Live-Schalter plus neun Quellenschalter reduziert; Center-Persistenz bleibt davon unberührt.
|
||||
- Live-Notification oben rechts mit X, `Gelesen`, maximal drei sichtbaren Karten und `+N`-Stapel festgelegt.
|
||||
- Status-Toast, Upload/Loading, Mikro-Feedback, Standard/Permanent Banner und kritischen Dialog als getrennte Referenzen gebaut.
|
||||
- Timings, Timer-Pausen, Deduplizierung, Zustandswechsel und Reduced-Motion-Leitplanken dokumentiert.
|
||||
- Quellenbezeichnung final von Team auf Chat vereinheitlicht; technischer Wert ist `source: "chat"`.
|
||||
|
||||
## Finale Produktentscheidungen
|
||||
|
||||
- **Nur In-App:** E-Mail, Push und SMS sind keine Notification-Kanäle. Eine eingehende E-Mail ist eine Quelle und erzeugt einen normalen Center-Eintrag.
|
||||
- **Neun Quellen:** Chat, E-Mail, Aufgaben, Kalender, Leads, Projekte, Automation, System und Billing. Integrationen gehören zu System.
|
||||
- **Ein Ereignis, ein Eintrag:** keine Aggregation oder ausklappbaren Gruppen; die Liste ist flach und chronologisch absteigend.
|
||||
- **Pflicht-Deeplink:** jedes persistente Ereignis führt zum exakten Tool, Objekt oder definierten Fallback.
|
||||
- **Read-State:** ungelesen wird über Fokus-Schatten und blauen Punkt am Quell-Icon gezeigt. Der verworfene Count-Kreis rechts existiert nicht.
|
||||
- **Center ohne X:** Center-Einträge werden gelesen oder ungelesen gesetzt, nicht weggeklickt. X existiert nur am flüchtigen Live-Overlay.
|
||||
- **Live-Einstellungen:** global und je Quelle steuerbar; abgeschaltete Live-Pop-ups bleiben im Drawer und auf der Vollseite erhalten.
|
||||
- **Kurzes Produktfeedback:** Mikro-Feedback und Status-Toasts sind nicht persistent und nicht Teil der Notification-Einstellungen.
|
||||
- **Banner:** Standard Banner ist dismissible. Permanent Banner ist dünn, global, nicht dismissible; Offline ist sein höchst priorisierter Zustand und keine eigene Komponente.
|
||||
- **Kritischer Dialog:** kein Auto-Dismiss, standardmäßig X/Schließen; echte nicht schließbare Blocker müssen Development explizit festlegen.
|
||||
|
||||
## Ausgabeflächen
|
||||
|
||||
| Fläche | Persistiert | Referenz | Kernverhalten |
|
||||
|---|---:|---|---|
|
||||
| Mikro-Feedback | nein | S07 | sehr häufige Bestätigung, 1,5 s, kein X |
|
||||
| Status-Toast | nein | S06 | Fortschritt, Ergebnis, Warnung oder behebbarer Fehler |
|
||||
| Live-Notification | ja, im Center | S05 | 8 s, Hover/Fokus pausiert, X oder `Gelesen` |
|
||||
| Notification Center | ja | S01/S02B | flache Chronologie, Read-State, Filter und Deeplinks |
|
||||
| Kritischer Dialog | ereignisabhängig | S08 | unterbrechend, kein Auto-Dismiss |
|
||||
| Banner | nein | S04 | kontextbezogener oder permanenter globaler Zustand |
|
||||
|
||||
## Finales Subframe-Inventar
|
||||
|
||||
| # | Live-Name | UUID | Repo | Subframe |
|
||||
|---:|---|---|---|---|
|
||||
| 1 | S01 Notification Center – Glocken-Drawer | `c6db2245-5962-459e-82b9-e700272c692f` | [S01](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S01%20Glocken-Drawer.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/c6db2245-5962-459e-82b9-e700272c692f/edit) |
|
||||
| 2 | S02B · Blauer Fokusrahmen | `66571863-970d-4890-8352-a112c057e910` | [S02B](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S02%20Benachrichtigungen%20Seite.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/66571863-970d-4890-8352-a112c057e910/edit) |
|
||||
| 3 | S03 Benachrichtigungen – Globale Einstellungen | `ad1f213a-39cf-451f-8525-ff4e9b3a0854` | [S03](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S03%20Benachrichtigungen%20Einstellungen.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/ad1f213a-39cf-451f-8525-ff4e9b3a0854/edit) |
|
||||
| 4 | S04 App-Shell – Permanent und Standard Banner | `f6eccfbe-058c-4b5a-b984-ce656526efab` | [S04](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S04%20Permanent%20und%20Standard%20Banner.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/f6eccfbe-058c-4b5a-b984-ce656526efab/edit) |
|
||||
| 5 | S05 App-Shell – Notification Center geöffnet | `14386a95-8c95-46c6-8127-61c261f6e305` | [S05](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S05%20Live%20Notifications%20im%20App-Shell.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/14386a95-8c95-46c6-8127-61c261f6e305/edit) |
|
||||
| 6 | S06 App-Shell – Kurzinfos und Statusfarben | `66b46a36-1d7f-418b-b0ea-3550569c3374` | [S06](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S06%20Kurzinfos%20Status%20und%20Upload.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/66b46a36-1d7f-418b-b0ea-3550569c3374/edit) |
|
||||
| 7 | S07 App-Shell – Micro Feedback | `78c8e52f-c328-4583-9a97-40cf95130a47` | [S07](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S07%20Mikro%20Feedback.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/78c8e52f-c328-4583-9a97-40cf95130a47/edit) |
|
||||
| 8 | S08 App-Shell – Kritischer Dialog | `4ecac4cb-d303-40f3-8c32-8aa04ef3cbad` | [S08](../../02%20Wireframes/P3%20Benachrichtigungen/WF-P3%20Benachrichtigungen/Screens/S08%20Kritischer%20Dialog.md) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/4ecac4cb-d303-40f3-8c32-8aa04ef3cbad/edit) |
|
||||
|
||||
## Komponenten
|
||||
|
||||
| Komponente | UUID | Status | Subframe |
|
||||
|---|---|---|---|
|
||||
| Review Draft – Notification Item | `5e430568-e5d8-4a3d-a842-40ba6e3555a8` | Validiert | [Öffnen](https://app.subframe.com/f023064a5ca0/design/5e430568-e5d8-4a3d-a842-40ba6e3555a8/edit) |
|
||||
| Review Draft – Permanent Banner | `b4beb642-5c8a-4a98-af93-83922bc91ed0` | Validiert | [Öffnen](https://app.subframe.com/f023064a5ca0/design/b4beb642-5c8a-4a98-af93-83922bc91ed0/edit) |
|
||||
|
||||
## Development-Vertrag
|
||||
|
||||
Ein persistentes `notification-event` enthält mindestens `id`, `source`, `title`, `summary`, `createdAt`, Read-State sowie `targetLabel` und `targetUrl`. Optional kommen Actor/Avatar, Tool-Icon und das Flag für eine zusätzliche kritische Unterbrechung hinzu.
|
||||
|
||||
`liveOverlayEnabled` steuert S05 global, `liveOverlayBySource` je Quelle. Beide Einstellungen beeinflussen ausschließlich die Live-Einblendung; Ereigniserzeugung, Center-Persistenz, Read-State, S01 und S02B bleiben unverändert. Kritische Dialoge, Permanent Banner, Status-Toasts und Mikro-Feedback umgehen diese Settings.
|
||||
|
||||
Live-Notifications zeigen maximal drei Karten plus Überlaufstapel. Status-Toasts zeigen maximal fünf Karten. Ein Loading-Toast wandelt sich in Erfolg oder Fehler um, statt eine zweite Meldung zu erzeugen. Status-Toast und Mikro-Feedback werden über Operations-ID dedupliziert; wird ein Ergebnis später relevant und anklickbar, wechselt derselbe Vorgang zu genau einem persistenten Notification-Event.
|
||||
|
||||
## Development-owned Follow-ups
|
||||
|
||||
- Konkreter Ereigniskatalog je Quelle.
|
||||
- Empfängerlogik anhand von Zuständigkeit und Berechtigungen.
|
||||
- Fallback für gelöschte oder nicht mehr erlaubte Deeplink-Ziele.
|
||||
- Explizite Liste der wenigen echten nicht schließbaren Dialog-Blocker.
|
||||
|
||||
## Abschlusscheck
|
||||
|
||||
- [x] Acht finale Subframe-Seiten inventarisiert, verlinkt und visuell geprüft.
|
||||
- [x] S00 aus Subframe, Tracker und Screen-Paket entfernt.
|
||||
- [x] Paket-MD, Screen-MDs, Canvas, Tracker und HiveGrid Map synchronisiert.
|
||||
- [x] Produktregeln, Timings, Quellen, Einstellungen und Interaktionen validiert.
|
||||
- [x] Nicht vom Design zu entscheidende Details ausdrücklich als Development-owned markiert.
|
||||
- [x] Benachrichtigungs-Teil von D-P3 ist bereit für Development.
|
||||
@@ -19,6 +19,7 @@ Die Detailwahrheit bleibt in den Wireframe-Paketen und im `Screen Paket Tracker`
|
||||
| Ticket | Datei |
|
||||
|---|---|
|
||||
| D-P2 | [D-P2 Auth Wireframes](<Fertige Tickets/D-P2 Auth Wireframes.md>) |
|
||||
| D-P3 (Benachrichtigungen) | [D-P3 Benachrichtigungen](<Fertige Tickets/D-P3 Benachrichtigungen.md>) |
|
||||
| D-D0b | [D-D0b Layout Standards](<Fertige Tickets/D-D0b Layout Standards.md>) |
|
||||
| D-FORM | [D-FORM Form Builder](<Fertige Tickets/D-FORM Form Builder.md>) |
|
||||
| D-P8 + D-KANBAN | [D-P8 Pipelines Wireframes](<Fertige Tickets/D-P8 Pipelines Wireframes.md>) |
|
||||
|
||||
Reference in new issue
Block a user