Files
HiveGrid-Wireframes/Tickets/Fertige Tickets/D-P3 Benachrichtigungen.md
T

113 lines
9.5 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.
---
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 finale Subframe-Flow trägt den Namen `WF-P3 Benachrichtigungen`. Der frühere siebenseitige Flow `WF-P16 Benachrichtigungen` wurde nach der Abschlussreview gelöscht.
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.