Files

18 KiB
Raw Permalink Blame History

kind, project, ticket, package, typ, status, subframe, canvas
kind project ticket package typ status subframe canvas
wireframe-package HiveGrid Screen Project D-P3 WF-P3 Benachrichtigungen Flow Validiert · Development-Handoff https://app.subframe.com/f023064a5ca0/flow/f6bc85c2-186c-40d9-a0c1-bacb03fad68a/edit 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

Canvas: Canvas

Ticket-Handoff: D-P3 Benachrichtigungen

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 Einheitliches Item für Live-Overlay, Drawer und Vollseite Validiert
Review Draft – Permanent Banner 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

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


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

  • Neuer unabhängiger Subframe-Flow ist verlinkt.
  • Alter siebenseitiger Flow wurde nach der Abschlussreview gelöscht.
  • Acht finale Handoff-Seiten S01 bis S08 und zwei Komponenten sind gebaut und gerendert geprüft.
  • Die nur für die Review benötigte Übersichtsseite S00 wurde aus Subframe und Obsidian entfernt.
  • Quellenmodell, Stapellimits, Klickverhalten, Timings und Status-Beispiele sind als Development-Leitplanken dokumentiert.
  • Definitiv entschiedene Produktregeln und Timings sind als validiert markiert.
  • Gemeinsame Screen-Review abgeschlossen.
  • S03 und sämtliche Designentscheidungen finalisiert.
  • Verbleibende Ereignis-, Empfänger- und Berechtigungslogik ist ausdrücklich als Development-owned markiert.