268 lines
18 KiB
Markdown
268 lines
18 KiB
Markdown
---
|
||
kind: wireframe-package
|
||
project: HiveGrid Screen Project
|
||
ticket: D-P3
|
||
package: WF-P3 Benachrichtigungen
|
||
typ: Flow
|
||
status: Validiert · Development-Handoff
|
||
subframe: "https://app.subframe.com/f023064a5ca0/flow/f6bc85c2-186c-40d9-a0c1-bacb03fad68a/edit"
|
||
canvas: "WF-P3 Benachrichtigungen.canvas"
|
||
---
|
||
|
||
# WF-P3 Benachrichtigungen
|
||
|
||
Status: **validiert** · Produktregeln, Timings und alle Referenzscreens für den Development-Handoff abgeschlossen
|
||
|
||
Subframe-Link: [Finaler Handoff-Flow](<https://app.subframe.com/f023064a5ca0/flow/f6bc85c2-186c-40d9-a0c1-bacb03fad68a/edit>)
|
||
|
||
Canvas: [Canvas](<WF-P3 Benachrichtigungen.canvas>)
|
||
|
||
Ticket-Handoff: [D-P3 Benachrichtigungen](<../../../Tickets/Fertige Tickets/D-P3 Benachrichtigungen.md>)
|
||
|
||
Stand: 2026-08-27
|
||
|
||
---
|
||
|
||
## 1. Kurzfassung
|
||
|
||
Globales In-App-System für fünf klar getrennte Ausgabeflächen: Mikro-Feedback, Status-Toast, Live-Notification, Notification Center und kritischer Dialog. Banner bleiben ein eigener Kontextbaustein. Produktregeln, Timings, Einstellungen und die acht finalen Referenzscreens S01 bis S08 sind für den Development-Handoff validiert.
|
||
|
||
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. Die nicht mehr benötigte Übersichtsseite S00 wurde ebenfalls aus Subframe und Obsidian entfernt.
|
||
|
||
---
|
||
|
||
## 2. Intent Check
|
||
|
||
| Frage | Antwort |
|
||
|---|---|
|
||
| Welches Ticket/Modul ist betroffen? | D-P3 (Teil Benachrichtigungen), Dev-Pendant AK-P3 |
|
||
| Was soll der Nutzer am Ende schaffen? | Relevante Ereignisse sofort erkennen, später wiederfinden und per Pflicht-Deeplink exakt zur Sache springen; häufiges Produktfeedback soll ruhig bleiben |
|
||
| Flow, Screen, Zustand oder Doku? | Handoff-Flow aus Live-Overlay, Drawer, Vollseite, Settings, Banner-, Toast-, Mikro- und Dialog-Referenzen |
|
||
| Welche Planning-Quellen wurden geprüft? | Screen Paket Tracker, HiveGrid Map und der bisherige Subframe-Flow |
|
||
| Was ist sicher im Scope? | In-App only, globales Item, neun Quellen, Deeplinks, chronologische Liste, Read-State, Dismissibility, fünf Ausgabeflächen und verbindliche Timing-Leitplanken |
|
||
| Was ist sicher nicht im Scope? | Push/SMS, Quiet Hours, Snooze, Digest, vollständiger Ereignis- und Empfängerkatalog sowie tool-spezifische Notification-Layouts |
|
||
| Admin/Normalrolle-Unterschiede? | Empfänger werden erst im Development anhand von Zuständigkeit und Berechtigungen finalisiert |
|
||
| Development-owned Follow-ups? | Konkrete Empfängerlogik, Ereignis-Katalog, Deeplink-Fallback und die explizite Liste echter nicht schließbarer Blocker |
|
||
|
||
---
|
||
|
||
## 3. Scope
|
||
|
||
| Punkt | Inhalt |
|
||
|---|---|
|
||
| Ticket/Modul | D-P3 · Benachrichtigungen |
|
||
| Nutzerrolle | Alle (persönlicher Bereich) |
|
||
| Startpunkt | Live-Ereignis im App-Shell oder Glocke in der Topbar |
|
||
| Ziel | Meldung verstanden → im Drawer/Center wiederfinden → per Pflicht-Deeplink zur Sache |
|
||
| Haupt-Archetyp | A2 Liste + Drawer · A6 Settings · flüchtige Overlays · blockierender Dialog |
|
||
| Bespoke-Anteil | Niedrig — bestehende Komponenten werden global komponiert |
|
||
| Out of scope | Externe Kanäle, tool-eigene Sonderlayouts, vollständige Event-Matrix und Empfängerregeln |
|
||
|
||
---
|
||
|
||
## 4. Entscheidungen (Produktstand 2026-08-27)
|
||
|
||
| Entscheidung | Status | Notiz |
|
||
|---|---|---|
|
||
| Nur In-App | Validiert | E-Mail, Push und SMS sind keine Benachrichtigungskanäle in diesen Settings |
|
||
| Eingehende E-Mail als Quelle | Validiert | Jede eingehende E-Mail ist ein eigener chronologischer Eintrag mit Betreff, Ausschnitt und Deeplink |
|
||
| Nur Quellen, keine Kategorien | Validiert | Quelle ist die einzige fachliche Taxonomie und Filtergrundlage; es gibt keine zusätzliche globale Kategorie-Ebene |
|
||
| Feste Quellen | Validiert | Chat · E-Mail · Aufgaben · Kalender · Leads · Projekte · Automation · System · Billing; Integrationen werden unter System geführt |
|
||
| Quellenfarben ohne Severity-Bedeutung | Validiert | Chat grün · E-Mail teal · Aufgaben rot · Kalender gelb · Leads blau · Projekte violett · Automation orange · System grau · Billing indigo |
|
||
| Pflicht-Deeplink | Validiert | Jedes persistente Notification-Item führt zum exakten Tool, Objekt oder Fallback-Ziel |
|
||
| Ausgabefläche statt Attention-Level | Validiert | Mikro-Feedback, Status-Toast, Notification-Event und kritische Unterbrechung sind verschiedene Verhaltensklassen, keine farbigen Dringlichkeitspunkte |
|
||
| Ungelesen-Zustand | Validiert | Fokus-Schatten plus kleiner blauer Punkt am Quell-Icon; kein zusätzlicher leerer oder numerischer Kreis rechts |
|
||
| Keine Center-Aggregation | Validiert | Ein Ereignis entspricht genau einem Listeneintrag; auch mehrere E-Mails stehen einzeln nach Zeit sortiert |
|
||
| Dismissibility der Ausgabeflächen | Validiert | Live-Overlays, Status-Toasts, Standard Banner und der normale kritische Dialog sind per X schließbar; Permanent Banner bleibt die feste Ausnahme |
|
||
| Aktionen im Live-Overlay | Validiert | `Gelesen` markiert den persistenten Eintrag als gelesen und beendet das Live-Overlay; X schließt nur das Overlay und lässt den Eintrag ungelesen im Center |
|
||
| Center-Dismissibility | Validiert | Center-Einträge haben kein X; gelesen/ungelesen ist der einzige Listenstatus. X existiert nur am Live-Overlay und verändert den Read-State nicht |
|
||
| Einstellungen S03 | Validiert | Globaler Schalter plus neun Quellen steuern ausschließlich Live-Pop-ups; ausgeschaltete Einblendungen bleiben vollständig im Notification Center |
|
||
| Kritischer Dialog | Validiert | Echte `Dialog`-Komponente, kein Auto-Dismiss, standardmäßig X/Schließen; Titel, Beschreibung und Hauptaktion sind ereignisabhängig |
|
||
| Nicht schließbarer Dialog | Development-owned | Nur für ausdrücklich definierte echte Blocker; dann darf das X ereignisspezifisch entfallen |
|
||
| Live-Overlay-Limit | Validiert | Oben rechts höchstens drei sichtbare Karten; weitere Ereignisse werden als Stapel mit `+N`-Badge an der obersten Karte angedeutet |
|
||
| Status-Toast-Limit | Validiert | Unten rechts höchstens fünf sichtbare Toasts; neuester Toast liegt am unteren Rand |
|
||
| Timing-Regeln | Validiert | Auto-Dismiss, Loading-Verzögerung, Pausen und Zustandswechsel gelten wie in Abschnitt 6 |
|
||
| Standard Banner | Validiert | Bestehender `Banner Alert`; immer dismissible |
|
||
| Permanent Banner | Validiert | Dünner globaler Baustein ganz oben; niemals dismissible, bleibt bis zur Lösung |
|
||
| Offline als Permanent-Banner-Zustand | Validiert | Keine eigene Komponente. Offline belegt denselben Slot mit höchster Priorität; nach Reconnect erscheint der zuvor relevante permanente Hinweis wieder |
|
||
| Empfängerlogik | Development-owned | Design liefert Suggestions; Zuständigkeit/Berechtigung entscheiden final |
|
||
|
||
### Hauptfluss
|
||
|
||
1. Ein persistentes Ereignis erscheint oben rechts als Live-Notification (S05); maximal drei Karten sind sichtbar.
|
||
2. Klick auf den Kartenkörper öffnet S01, scrollt das zugehörige Item in den sichtbaren Bereich und lässt dessen Fokusrahmen kurz heller aufscheinen. Allein das Öffnen setzt den Eintrag noch nicht auf gelesen.
|
||
3. Klick auf den blauen Ziel-Link springt direkt zum exakten Ziel und setzt das Ereignis auf gelesen.
|
||
4. Im Drawer kann jedes ungelesene Item einzeln über `Gelesen` markiert werden. Die globale Aktion `Alle als gelesen` existiert nur auf S02B.
|
||
5. `Alle Benachrichtigungen öffnen` ist im Drawer oben links und unten vorhanden und führt zu S02B.
|
||
6. S02B trennt Alle / Ungelesen / Gelesen, filtert ausschließlich nach Quelle und Zeitraum und unterstützt Checkboxen plus Bulk-Aktionen.
|
||
7. Mehrere Ereignisse derselben Quelle bleiben einzelne, chronologisch einsortierte Items.
|
||
|
||
---
|
||
|
||
## 5. Development-Modell und Interaktionen
|
||
|
||
### Ausgabeflächen
|
||
|
||
| Technischer Name | Bedeutung | Gespeichert? | Referenz |
|
||
|---|---|---|---|
|
||
| `micro-feedback` | Sehr häufige, harmlose Bestätigung wie „Änderungen gespeichert" | nein | S07 |
|
||
| `status-toast` | Fortschritt, Hintergrundstatus, Erfolg, Warnung oder behebbarer Fehler | nein | S06 |
|
||
| `notification-event` | Relevantes, anklickbares Ereignis mit Read-State und Pflicht-Deeplink | ja | S05 → S01/S02B |
|
||
| `critical-interruption` | Seltener unterbrechender Dialog bei unmittelbarem Risiko; standardmäßig schließbar und bei Bedarf parallel als Notification-Event gespeichert | ereignisabhängig | S08 |
|
||
| `banner` | Kontextbezogener oder global permanenter Zustand | nein | S04 |
|
||
|
||
### Minimaler Event-Vertrag
|
||
|
||
- `id`
|
||
- `source`: eine der neun festen Quellen; für die sichtbare Quelle Chat lautet der technische Wert `chat`
|
||
- `title`
|
||
- `summary`
|
||
- `createdAt`
|
||
- `readAt` oder eindeutiger Read-State
|
||
- `targetLabel` und `targetUrl`
|
||
- optional `actor`, Avatar oder Tool-Icon
|
||
- optional `criticalInterruption`, wenn zusätzlich S08 ausgelöst wird
|
||
|
||
Das Center erhält eine flache Ereignisliste und sortiert nach `createdAt` absteigend. Quelle, Read-State und Zeitraum sind Filtermerkmale; es gibt weder Kategorien noch visuelle Sammelgruppen.
|
||
|
||
### Live-Notification → Drawer
|
||
|
||
- Klick auf den Kartenkörper: S01 öffnen, relevantes Item fokussieren, Read-State unverändert lassen.
|
||
- Ziel-Link: direkt zum Ziel navigieren und als gelesen markieren.
|
||
- `Gelesen`: persistenten Eintrag als gelesen markieren und die Live-Karte schließen, ohne zu navigieren.
|
||
- X im Live-Overlay: nur das flüchtige Overlay schließen; der persistente Center-Eintrag bleibt bestehen.
|
||
- Fokus-Schein im Drawer: 150 ms aufhellen, 350 ms halten, 200 ms zurücknehmen; kein Bounce. Bei reduzierter Bewegung nur den Rahmen für etwa 700 ms heller zeigen.
|
||
- Klick auf das `+N`-Badge oder den Stapel öffnet den Drawer am neuesten noch nicht sichtbaren Ereignis.
|
||
|
||
### Settings-Vertrag für Live-Einblendungen
|
||
|
||
- `liveOverlayEnabled`: globaler boolescher Schalter für S05.
|
||
- `liveOverlayBySource`: boolesche Einstellung je fester Quelle.
|
||
- Ist der globale Schalter aus, erscheinen keine Live-Pop-ups; die je Quelle gespeicherten Werte bleiben erhalten und gelten wieder nach dem Einschalten.
|
||
- Ist nur eine Quelle aus, wird S05 für Ereignisse dieser Quelle unterdrückt.
|
||
- Ereigniserzeugung, Center-Persistenz, Read-State sowie S01/S02B bleiben von beiden Einstellungen unberührt.
|
||
- Kritische Dialoge, Permanent Banner, Status-Toasts und Microfeedback umgehen diese Settings vollständig.
|
||
|
||
---
|
||
|
||
## 6. Timing und Stapelregeln · validiert
|
||
|
||
| Zustand | Sichtbarkeit | Ende |
|
||
|---|---|---|
|
||
| Live-Notification | 8 s | automatisch oder X; Hover/Fokus pausiert |
|
||
| Erfolg-Toast | 4 s | automatisch oder X |
|
||
| Info-Toast | 6 s | automatisch oder X |
|
||
| Warnung | 8 s | automatisch oder X |
|
||
| Fehler mit Aktion | unbegrenzt | X oder erfolgreiche Aktion; ein fehlgeschlagener Retry hält den Toast offen |
|
||
| Loading/Fortschritt | ab 500 ms Verzögerung, dann solange aktiv | derselbe Toast wandelt sich in Erfolg oder Fehler um |
|
||
| Langer Hintergrundprozess | nach 10 s zu „Läuft im Hintergrund" verdichten | nach weiteren 5 s ausblenden; Prozess läuft weiter |
|
||
| Mikro-Feedback | 1,5 s | automatisch; kein X und kein Stapel |
|
||
| Kritischer Dialog | kein Auto-Dismiss | X, `Schließen` oder erfolgreiche ereignisspezifische Hauptaktion; echte nicht schließbare Blocker nur nach expliziter Development-Regel |
|
||
|
||
Für Live-Notifications gelten maximal drei sichtbare Karten und ein Überlaufstapel. Für Status-Toasts gelten maximal fünf sichtbare Karten. Mikro-Feedback zeigt immer nur eine Instanz; ein neuer identischer Hinweis ersetzt den bestehenden. Hover, Tastaturfokus und ein nicht sichtbarer Browser-Tab pausieren automatische Timer; nach Rückkehr bleiben mindestens zwei Sekunden Restzeit.
|
||
|
||
Status-Toast und Mikro-Feedback werden über eine gemeinsame Ereignis- beziehungsweise Operations-ID dedupliziert. Beschreiben beide denselben Vorgang oder dasselbe Ergebnis, wird nur die informationsreichere Fläche gezeigt: Ein aktiver Status-Toast gewinnt gegenüber Mikro-Feedback. Gehören sie zu unterschiedlichen Vorgängen, dürfen beide gleichzeitig erscheinen; das Mikro-Feedback steht links neben dem unten rechts verankerten Status-Toast-Stapel und überlagert ihn nicht.
|
||
|
||
Wird aus einem laufenden Status-Toast ein später relevantes Ergebnis mit Ziel, endet der Toast und derselbe Vorgang wechselt zu genau einem persistenten `notification-event`. Es erscheinen nicht zusätzlich ein Erfolg-Toast und eine Live-Notification für dasselbe Ergebnis.
|
||
|
||
Bewegung: Live-Notification und Toast ca. 250 ms hinein, 180 ms hinaus; Mikro-Feedback 150 ms hinein und 120 ms hinaus; kritischer Dialog 320 ms mit 8 px ruhigem Settle. Bei `prefers-reduced-motion` nur über Opacity wechseln.
|
||
|
||
---
|
||
|
||
## 7. Brainstorming: Kurzinfos und Status
|
||
|
||
| Fall | Empfohlene Fläche | Beispiel |
|
||
|---|---|---|
|
||
| Sehr häufige Bestätigung | Mikro-Feedback | Änderungen gespeichert · Link kopiert · Reihenfolge aktualisiert |
|
||
| Bekannter Fortschritt | Status-Toast mit Progress | Datei hochladen · Import · Download |
|
||
| Unbestimmter Hintergrundprozess | Status-Toast mit Spinner | Synchronisierung läuft · Daten werden verarbeitet |
|
||
| Relevanter Abschluss ohne weiteres Ziel | Erfolg-Toast | Import abgeschlossen · Datei hochgeladen |
|
||
| Abschluss mit später nutzbarem Ergebnis | Notification-Event | Export fertig · Bericht erstellt · Dokument bereit |
|
||
| Verzögerung oder instabile Verbindung | Warn-Toast | Speichern verzögert · Synchronisierung pausiert |
|
||
| Behebbarer Fehler | persistenter Fehler-Toast | Upload fehlgeschlagen · erneut versuchen |
|
||
| Rückgängig machbare Aktion | Aktions-Toast | Projekt archiviert · Rückgängig |
|
||
| Kontextfehler im Formular | Inline Alert | Pflichtfeld fehlt · Eingabe ungültig |
|
||
| App offline | Permanent Banner | Offline – Änderungen werden später synchronisiert |
|
||
| Akutes Risiko / mögliche Datenverluste | kritischer Dialog plus Center-Eintrag | Änderungen konnten nicht gespeichert werden |
|
||
|
||
Faustregel: Nur ein Ereignis mit später relevantem Ziel gehört ins Notification Center. Reines Feedback zur gerade ausgeführten Aktion bleibt Mikro-Feedback, Toast oder Inline Alert.
|
||
|
||
---
|
||
|
||
## 8. Komponentenstand
|
||
|
||
| Komponente | Zweck | Status |
|
||
|---|---|---|
|
||
| [Review Draft – Notification Item](<https://app.subframe.com/f023064a5ca0/design/5e430568-e5d8-4a3d-a842-40ba6e3555a8/edit>) | Einheitliches Item für Live-Overlay, Drawer und Vollseite | Validiert |
|
||
| [Review Draft – Permanent Banner](<https://app.subframe.com/f023064a5ca0/design/b4beb642-5c8a-4a98-af93-83922bc91ed0/edit>) | Dünner globaler, nicht schließbarer Banner | Validiert |
|
||
|
||
Der bestehende `Banner Alert` bleibt der Standard Banner. Für Offline gibt es keine separate Komponente: Text, Icon und Farbe werden als Zustand des `Banner Permanent` gesetzt. Die frühere Subframe-Komponente `Banner Offline` wurde gelöscht. `Alert` und `Badge Feedback` bleiben erhalten, gehören aber nicht zum persistenten Notification-System.
|
||
|
||
Im Notification Item steuert `sourceColor` nur Icon/Avatar und Quellenlabel. `metadata` steht als kleiner Zeitstempel oben rechts. `targetLabel` ist die einzeilige blaue Zielverknüpfung und erhält bei Hover eine leichte neutrale Fläche. Das Item selbst bekommt bei Hover einen leichten Schatten.
|
||
|
||
`state="unread"` steuert Fokus-Schatten und kleinen blauen Punkt am Quell-Icon/Avatar. Der zuvor getestete zusätzliche blaue Kreis/Count rechts wurde vollständig verworfen. `markAsRead` blendet den dauerhaft sichtbaren Button `Gelesen` mit Haken ein. Bei `state="read"` verschwinden Icon-Punkt und Gelesen-Aktion.
|
||
|
||
---
|
||
|
||
## 9. Validierte Handoff-Screens
|
||
|
||
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
||
|---|---|---|---|---|---|
|
||
| S01 | Notification Center – Glocken-Drawer | Drawer | Gebaut | Topbar, global | Validiert |
|
||
| S02B | Benachrichtigungen – Vollseite mit Fokus-Schatten | Screen | Gebaut | `/notifications` | Validiert |
|
||
| S03 | Benachrichtigungen – Globale Einstellungen | Settings | Gebaut | `/settings/notifications` | Validiert |
|
||
| S04 | Permanent und Standard Banner | Referenzscreen | Gebaut | global + Content | Validiert |
|
||
| S05 | Live-Notifications im App-Shell | Overlay-Referenz | Gebaut | oben rechts | Validiert |
|
||
| S06 | Kurzinfos, Status und Upload | Toast-Referenz | Gebaut | unten rechts | Validiert |
|
||
| S07 | Mikro-Feedback | Micro-Referenz | Gebaut | unten rechts | Validiert |
|
||
| S08 | Kritischer Dialog | Dialog-Referenz | Gebaut | modal | Validiert |
|
||
|
||
---
|
||
|
||
## 10. Grid
|
||
|
||
```text
|
||
Notification-Event -> S05 Live-Overlay -> Kartenkörper -> S01 Drawer -> S02B Vollseite
|
||
-> Ziel-Link -> exaktes Ziel
|
||
S01/S02B -> Einstellungen -> S03
|
||
Häufige Bestätigung -> S07 Mikro-Feedback
|
||
Fortschritt / Ergebnis / behebbarer Fehler -> S06 Status-Toast
|
||
Akutes Risiko -> S08 kritischer Dialog + persistenter Center-Eintrag
|
||
Fortbestehendes Problem / Offline -> S04 Permanent Banner
|
||
Kontextbezogener Hinweis -> S04 Standard Banner
|
||
```
|
||
|
||
---
|
||
|
||
## 11. Screen-Pakete
|
||
|
||
- [[S01 Glocken-Drawer]]
|
||
- [[S02 Benachrichtigungen Seite]]
|
||
- [[S03 Benachrichtigungen Einstellungen]]
|
||
- [[S04 Permanent und Standard Banner]]
|
||
- [[S05 Live Notifications im App-Shell]]
|
||
- [[S06 Kurzinfos Status und Upload]]
|
||
- [[S07 Mikro Feedback]]
|
||
- [[S08 Kritischer Dialog]]
|
||
|
||
---
|
||
|
||
## 12. Development-owned Follow-ups
|
||
|
||
- Welche konkreten Ereignisse werden als `notification-event` gespeichert?
|
||
- Welche Empfänger werden je Ereignis anhand von Zuständigkeit und Berechtigungen ermittelt?
|
||
- Welcher Fallback erscheint, wenn das Deeplink-Ziel gelöscht oder nicht mehr erlaubt ist?
|
||
- Welche wenigen Ereignisse sind echte nicht schließbare Dialog-Blocker?
|
||
|
||
## Handoff-Check
|
||
|
||
- [x] Neuer unabhängiger Subframe-Flow ist verlinkt.
|
||
- [x] Alter siebenseitiger Flow wurde nach der Abschlussreview gelöscht.
|
||
- [x] Acht finale Handoff-Seiten S01 bis S08 und zwei Komponenten sind gebaut und gerendert geprüft.
|
||
- [x] Die nur für die Review benötigte Übersichtsseite S00 wurde aus Subframe und Obsidian entfernt.
|
||
- [x] Quellenmodell, Stapellimits, Klickverhalten, Timings und Status-Beispiele sind als Development-Leitplanken dokumentiert.
|
||
- [x] Definitiv entschiedene Produktregeln und Timings sind als validiert markiert.
|
||
- [x] Gemeinsame Screen-Review abgeschlossen.
|
||
- [x] S03 und sämtliche Designentscheidungen finalisiert.
|
||
- [x] Verbleibende Ereignis-, Empfänger- und Berechtigungslogik ist ausdrücklich als Development-owned markiert.
|