docs: finalize D-P3 notification handoff

This commit is contained in:
david committed 2026-08-27 03:19:37 +02:00
1 parent 1eb7765b41
commit 628d5e1c87
15 files changed
+805 -266

No files matched your search

@@ -6,17 +6,17 @@ package: WF-P3 Benachrichtigungen
id: S01
screen: Glocken-Drawer
typ: Drawer
umsetzung: Bauen
umsetzung: Gebaut
status: Validiert
route: "Topbar, global"
subframe: ""
subframe: "https://app.subframe.com/f023064a5ca0/design/c6db2245-5962-459e-82b9-e700272c692f/edit"
---
# S01 — Glocken-Drawer
## Ziel
Schneller Blick auf Neues, ohne den aktuellen Kontext zu verlassen. Wird das Muster für alle künftigen Topbar-Drawer.
Schneller Blick auf Neues, ohne den aktuellen Kontext zu verlassen. Der Screen ist die validierte Leitseite für das globale Notification-Item im Drawer.
## Pattern / Archetyp
@@ -24,28 +24,47 @@ A2 Liste als Drawer/Panel, öffnet aus der Glocke in der Topbar (App-Gerüst D0
## Daten
- Einträge, neueste zuerst: Typ-Icon je Quelle (Aufgabe, E-Mail, Antrag, Erwähnung, System …), Titel, kurzer Body, Actor, Zeit (relativ), Ungelesen-Punkt, Prioritäts-Marker
- Einträge mit Quelle, Titel, kurzer Zusammenfassung, Zeit, Read-Status und Actor/Icon
- Bereiche: Neu und Früher; keine fachlichen Kategorien oder Sammelgruppen
- Repräsentative Quellen: Chat, E-Mail, Aufgaben, Kalender, Leads, Projekte, Automation, System und Billing
- Drei aufeinanderfolgende E-Mails erscheinen als drei eigenständige Items, nach Eingangszeit einsortiert; E-Mail ist Quelle, nicht Kanal
- Quellenfarbe unabhängig von Dringlichkeit: Chat grün, E-Mail teal, Aufgaben rot, Kalender gelb, Leads blau, Projekte violett, Automation orange, System grau, Billing indigo
- Keine farbigen Severity-/Attention-Punkte; ungelesene Items zeigen stattdessen Fokus-Schatten und einen kleinen blauen Punkt am Quell-Icon/Avatar
- Kein zusätzlicher blauer Kreis oder Count im rechten Aktionsbereich
- Notification-Hover: leichter Schatten statt grauer Flächenwechsel; Deeplink-Hover: leichte neutrale Fläche nur direkt am Link
- Eingangszeit klein oben rechts im Item
- Explizite einzeilige Zielverknüpfung unter der Zusammenfassung im Aufgaben-Muster „Typ · konkretes Objekt"
- Tabs: Alle / Ungelesen
- Zähler kommt aus der Topbar-Glocke (D0)
## Aktionen
- Klick auf Eintrag → typ-abhängiger Sprung zur Sache (neue Aufgabe → Aufgabe öffnen usw.); Eintrag wird dabei gelesen
- Einzelnen Eintrag wegklicken (X), wenn erledigt
- „Alle als gelesen"
- Aktualisieren-Knopf
- „Alle anzeigen" → [[S02 Benachrichtigungen Seite]]
- Explizite Zielverknüpfung → exaktes Tool, Objekt oder eine passende gefilterte Liste; Eintrag wird dabei gelesen
- Ungelesener Eintrag → dauerhaft sichtbarer Button `Gelesen` mit Haken; der Button setzt nur diesen Eintrag auf gelesen
- Center-Einträge besitzen kein X; `Gelesen` ist die einzige direkte Statusaktion am Item
- Zahnrad → [[S03 Benachrichtigungen Einstellungen]]
- `Alle Benachrichtigungen öffnen` steht oben links mit Maximize-Icon und zusätzlich am unteren Ende → [[S02 Benachrichtigungen Seite]]
- Keine Aktion `Alle als gelesen` und kein Ungelesen-Zähler im Drawer-Kopf; beides bleibt der Vollseite vorbehalten
## Live-Overlay-Übergang
- Klick auf den Kartenkörper in S05 öffnet diesen Drawer und scrollt das zugehörige Item in den sichtbaren Bereich.
- Das Ziel-Item erhält einmalig einen kurzen helleren Fokus-Schein: 150 ms aufhellen, 350 ms halten, 200 ms zurücknehmen.
- Das Öffnen des Drawers markiert das Item noch nicht als gelesen.
- Klick auf den blauen Ziel-Link springt dagegen direkt zum Ziel und setzt den Eintrag auf gelesen.
- Das X in S05 schließt nur die Live-Karte; der persistente Eintrag bleibt im Drawer.
- `Gelesen` in S05 setzt den Eintrag auf gelesen und schließt die Live-Karte ohne Navigation.
## Banner / Hinweise
- Bounce-Banner: „E-Mails an dich kommen aktuell nicht an." + Prüf-Knopf (nur wenn E-Mail-Zustellung pausiert)
- Banner sind nicht Teil des Drawers; Regeln und Referenz stehen in [[S04 Permanent und Standard Banner]].
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Bounce (E-Mail-Zustellung pausiert) | Banner | nein | Nur dokumentieren | s. oben |
| Live-Verbindung weg | Inline | nein | Nur dokumentieren | „Aktualisiert sich gerade nicht — neu laden." |
| Ziel nicht verfügbar | Deeplink-Fallback | nein | Development klären | Kein toter Link |
| Liste nicht aktuell | Inline | nein | Nur dokumentieren | „Aktualisiert sich gerade nicht — neu laden." |
## Zustände
@@ -57,13 +76,13 @@ A2 Liste als Drawer/Panel, öffnet aus der Glocke in der Topbar (App-Gerüst D0
## Permissions / Gates
Keine — jeder sieht nur die eigenen Benachrichtigungen.
Der Drawer zeigt die für den aktuellen Nutzer ermittelten Hinweise. Empfänger- und Berechtigungslogik wird im Development finalisiert.
## Subframe
- (erst nach explizitem OK)
- [S01 Notification Center – Glocken-Drawer](<https://app.subframe.com/f023064a5ca0/design/c6db2245-5962-459e-82b9-e700272c692f/edit>)
## Notizen
- Offen: Zahnrad im Drawer-Kopf als Direkteinstieg zu S03?
- Offen (Dev): Wegklicken = löschen oder archivieren?
- Quellenmodell, Gelesen-Aktion, beide Einstiege zur Vollseite, Center ohne X sowie der Übergang von S05 inklusive Fokus-Schein sind validiert.
- Empfängerlogik wird im Development finalisiert.
@@ -3,20 +3,20 @@ kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S02
screen: Benachrichtigungen Seite
id: S02B
screen: Benachrichtigungen Seite mit Fokus-Schatten
typ: Liste
umsetzung: Bauen
umsetzung: Gebaut
status: Validiert
route: "/notifications"
subframe: ""
subframe: "https://app.subframe.com/f023064a5ca0/design/66571863-970d-4890-8352-a112c057e910/edit"
---
# S02 — Benachrichtigungen Seite
# S02B — Benachrichtigungen Seite
## Ziel
Der Drawer in groß: alle Meldungen durchsehen, in Ruhe aufräumen.
Alle persistenten, anklickbaren In-App-Benachrichtigungen chronologisch durchsuchen und nach Quelle, Lesestatus und Zeitraum eingrenzen.
## Pattern / Archetyp
@@ -24,26 +24,41 @@ A2 Liste (volle Seite in der App-Shell), gleiche Einträge wie S01.
## Daten
- Gleiche Eintrags-Struktur wie [[S01 Glocken-Drawer]] (Typ-Icon, Titel, Body, Actor, Zeit, Read-Status, Prioritäts-Marker)
- Tabs: Alle / Ungelesen
- Gleiches globales Notification-Item wie [[S01 Glocken-Drawer]]
- Segmented Control: Alle / Ungelesen / Gelesen, rechts im Seitenkopf bei den globalen Aktionen
- Filter Bar mit Presets; Filter: Quelle und Zeitraum
- Quellen-Presets und Quellenfilter enthalten Chat, E-Mail, Aufgaben, Kalender, Leads, Projekte, Automation, System und Billing
- Zeitabschnitte: Heute, Gestern, ältere Tage
- Innerhalb der Zeitabschnitte streng nach Ereigniszeit absteigend; gleiche Quellen werden nicht zusammengefasst
- Quellenfarben wie S01: Chat grün, E-Mail teal, Aufgaben rot, Kalender gelb, Leads blau, Projekte violett, Automation orange, System grau, Billing indigo
- Keine farbigen Severity-/Attention-Punkte; ungelesene Items verwenden den manuell gesetzten Fokus-Schatten
- Eingangszeit klein oben rechts im Item
- Explizite einzeilige, blau hervorgehobene Zielverknüpfung unter der Zusammenfassung im Aufgaben-Muster „Typ · konkretes Objekt"
- `state="unread"` zeigt Fokus-Schatten und einen kleinen blauen Punkt oben rechts am Quell-Icon/Avatar
- Kein zusätzlicher blauer Kreis oder Count im rechten Aktionsbereich
- Größerer vertikaler Abstand verhindert, dass die Fokus-Schatten ineinanderlaufen
- Notification-Hover: leichter Schatten statt grauer Flächenwechsel; Deeplink-Hover: leichte neutrale Fläche nur direkt am Link
- Mehrere aufeinanderfolgende E-Mails oder andere Ereignisse erscheinen als eigenständige Notification-Items mit eigener Zeit, Beschreibung und Zielverknüpfung
## Aktionen
- Klick → typ-abhängiger Sprung zur Sache
- Einzeln als gelesen/ungelesen markieren
- Einzeln wegklicken
- Bulk-Aufräumen („alle als gelesen" / Auswahl entfernen)
- Aktualisieren
- Explizite Zielverknüpfung → exaktes Tool, Objekt oder eine passende gefilterte Liste
- Ungelesenes Item: dauerhaft sichtbarer Button „Gelesen" mit einfachem Haken statt X; nach dem Lesen verschwindet die Aktion
- Kein Wegklicken einzelner Items auf der Vollseite
- Globale Aktion `Alle als gelesen` im Seitenkopf
- Checkboxen links neben jedem Item; die ersten zwei Items zeigen den ausgewählten Zustand als visuelle Referenz
- Bestehende `Bulk Action Bar` mit zwei klaren Buttons: `Als gelesen markieren` und `Als ungelesen markieren`
- Bulk-Bar zeigt Auswahlanzahl und `Alle 20 auswählen`; kein Dropdown für die Read-Aktion
## Banner / Hinweise
- Bounce-Banner wie in S01
- Standard/Permanent Banner sind getrennte Oberflächen; siehe [[S04 Permanent und Standard Banner]].
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Bounce | Banner | nein | Nur dokumentieren | wie S01 |
| Ziel nicht verfügbar | Deeplink-Fallback | nein | Development klären | Kein toter Link |
| Live-Verbindung weg | Inline | nein | Nur dokumentieren | wie S01 |
## Zustände
@@ -56,12 +71,14 @@ A2 Liste (volle Seite in der App-Shell), gleiche Einträge wie S01.
## Permissions / Gates
Keine — nur eigene Benachrichtigungen.
Die Seite zeigt die für den aktuellen Nutzer ermittelten Hinweise. Empfänger- und Berechtigungslogik wird im Development finalisiert.
## Subframe
- (erst nach explizitem OK)
- [S02B – Fokus-Schatten, gewählte Referenzvariante](<https://app.subframe.com/f023064a5ca0/design/66571863-970d-4890-8352-a112c057e910/edit>)
## Notizen
- Erreichbar über „Alle anzeigen" im Drawer; ob es zusätzlich einen Sidebar-Punkt braucht: nein (bewusst nur über Glocke).
- Erreichbar über „Alle Benachrichtigungen öffnen" im Drawer; im validierten Stand gibt es keinen eigenen Sidebar-Punkt.
- Vollseiten-Referenz, Filterumfang und Read-/Bulk-Aktionen sind validiert.
- S02B ist die einzige verbleibende Subframe-Referenz. Die früheren S02-/S02A-Vergleichsstände wurden entfernt.
@@ -6,17 +6,17 @@ package: WF-P3 Benachrichtigungen
id: S03
screen: Benachrichtigungen Einstellungen
typ: Settings
umsetzung: Bauen
umsetzung: Gebaut
status: Validiert
route: "/settings/notifications"
subframe: ""
subframe: "https://app.subframe.com/f023064a5ca0/design/ad1f213a-39cf-451f-8525-ff4e9b3a0854/edit"
---
# S03 — Benachrichtigungen Einstellungen
## Ziel
Selbst steuern, worüber man wie informiert wird — pro Ereignis-Typ.
Steuern, welche neuen Benachrichtigungen kurz als Live-Pop-up oben rechts erscheinen. Das Notification Center bleibt unabhängig von diesen Einstellungen vollständig.
## Pattern / Archetyp
@@ -24,18 +24,27 @@ A6 Settings-Seite unter Einstellungen → Persönlich → Benachrichtigungen (P2
## Daten
- Ereignis-Typen **nach Modul gruppiert** (z. B. Aufgaben, Leads, Projekte, Chat, HR …)
- Je Zeile: Name + Kurzbeschreibung des Ereignisses, Toggle **In-App**, Toggle **E-Mail**, Prioritäts-Selektor (ab welcher Wichtigkeit)
- Oben: **Master-Schalter „alle E-Mails aus"** mit Klartext: „Gilt auch für Ereignis-Typen, die später dazukommen."
- Nur In-App; keine E-Mail-, Push- oder SMS-Kanalsteuerung
- Ein globaler Schalter steuert sämtliche Live-Einblendungen
- Je ein Schalter für die neun Quellen: Chat, E-Mail, Aufgaben, Kalender, Leads, Projekte, Automation, System und Billing
- Integrationen werden unter System geführt
- Ausgeschaltete Live-Einblendungen verschwinden nicht: Sie bleiben unter der Glocke und auf der Benachrichtigungsseite erhalten
- Es gibt keine Kategorie-, Attention- oder Ereignistyp-Matrix
- Kritische Dialoge und permanente Hinweise bleiben unabhängig von diesen Einstellungen immer aktiv
- Microfeedback und Status-Toasts sind Produktfeedback und keine Benachrichtigungseinstellungen
- Empfänger werden anhand von Zuständigkeit und Berechtigungen ermittelt
## Aktionen
- Toggles je Zeile (speichern sofort, Toast als Bestätigung)
- Master-Schalter (graut E-Mail-Spalte aus)
- Globaler Toggle `Neue Benachrichtigungen live anzeigen`
- Ein Toggle je Quelle; er beeinflusst nur das Live-Pop-up dieser Quelle
- Beim Ausschalten des globalen Toggles bleiben die individuellen Quellenwerte gespeichert und gelten nach dem erneuten Einschalten weiter
- Kritische Hinweise sind als gesperrter, aktivierter Schalter sichtbar
- Automation ist im Referenzscreen beispielhaft ausgeschaltet, bleibt aber weiterhin im Notification Center sichtbar
## Banner / Hinweise
- Bei aktivem Bounce: Hinweis „E-Mails an dich kommen aktuell nicht an" auch hier sichtbar
- Prominente Infozeile: „Ausgeschaltete Live-Einblendungen sind nicht weg: Alle Benachrichtigungen bleiben unter der Glocke und auf der Benachrichtigungsseite verfügbar."
## Meldungsentscheidung
@@ -56,9 +65,11 @@ Keine — persönliche Einstellungen.
## Subframe
- (erst nach explizitem OK)
- [S03 Benachrichtigungen – Globale Einstellungen](<https://app.subframe.com/f023064a5ca0/design/ad1f213a-39cf-451f-8525-ff4e9b3a0854/edit>)
## Notizen
- v2 (nicht bauen, nicht andeuten): Ruhezeiten, Bündelung, Push-Geräte.
- E-Mail-Spalte bei Master-aus: ausgegraut, nicht versteckt (Nutzer soll sehen, was er verpasst).
- Globaler Schalter, neun Quellen-Schalter, erklärende Persistenz-Copy und der gesperrte kritische Zustand sind validiert.
- Die Settings steuern ausschließlich Live-Pop-ups; Center-Persistenz, Read-State und Empfängerlogik sind keine User-Settings.
- Das Center aggregiert Ereignisse grundsätzlich nicht.
- Out of scope: Quiet Hours, Snooze, Digest und Geräte-/Push-Verwaltung.
@@ -0,0 +1,54 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S04
screen: Permanent und Standard Banner
typ: Referenzscreen
umsetzung: Gebaut
status: Validiert
route: "global + Content"
subframe: "https://app.subframe.com/f023064a5ca0/design/f6eccfbe-058c-4b5a-b984-ce656526efab/edit"
---
# S04 — Permanent und Standard Banner
## Ziel
Die zwei Banner-Regeln im realen App-Shell eindeutig voneinander abgrenzen.
Der Inhaltsbereich ist bewusst ein leerer, klar beschrifteter Platzhalter wie in S05 und S06. Bewertet werden hier ausschließlich Position, Breite und Verhalten der beiden Banner.
## Standard Banner
- Bestehender `Banner Alert`
- Innerhalb des jeweiligen Inhaltskontexts
- Immer dismissible
- Mit Deeplink-Aktion zum passenden Ziel
## Permanent Banner
- Ein globaler `Banner Permanent`-Baustein, ca. 28 px hoch
- Ganz oben über Sidebar und Header
- Nie dismissible; bleibt bis zur Lösung
- Für fortbestehende Probleme wie offene Rechnung oder notwendige Kontoverifizierung
- Bei mehreren Problemen: wichtigstes zeigen plus Anzahl weiterer
## Offline-Zustand
- Offline ist keine eigene Komponente, sondern ein Zustand des `Banner Permanent`.
- Die App besitzt nur einen globalen Permanent-Banner-Slot.
- Der bestehende Baustein kann dafür `message`, `icon`, `actionLabel` und `variant` dynamisch wechseln; eine zusätzliche UI-Komponente ist nicht nötig.
- Solange die App offline ist, hat die Offline-Meldung in diesem Slot Vorrang vor offenen Rechnungen oder anderen permanenten Hinweisen.
- Nach wiederhergestellter Verbindung verschwindet die Offline-Meldung und der zuvor relevante permanente Hinweis wird wieder angezeigt.
- Der Offline-Zustand übernimmt das Verhalten des Permanent Banners und ist deshalb nicht dismissible.
- Die frühere Subframe-Komponente `Banner Offline` wurde entfernt.
## Subframe
- [S04 App-Shell – Permanent und Standard Banner](<https://app.subframe.com/f023064a5ca0/design/f6eccfbe-058c-4b5a-b984-ce656526efab/edit>)
## Status
Standard Banner, Permanent Banner, Offline-Priorität und die Darstellung im Platzhalter-App-Shell sind validiert.
@@ -0,0 +1,55 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S05
screen: Live Notifications im App-Shell
typ: Overlay-Referenz
umsetzung: Gebaut
status: Validiert
route: "global, oben rechts"
subframe: "https://app.subframe.com/f023064a5ca0/design/14386a95-8c95-46c6-8127-61c261f6e305/edit"
---
# S05 — Live Notifications im App-Shell
## Ziel
Zeigen, wie ein neues persistentes Notification-Ereignis live im aktuellen Arbeitskontext erscheint, bevor es im Drawer oder auf der Vollseite weiterbearbeitet wird.
## Darstellung
- Position oben rechts innerhalb des App-Shell
- Kompaktere Variante des globalen Notification Items
- Maximal drei sichtbare Karten; neueste Karte oben
- Bei mehr als drei Ereignissen erhält die oberste Karte zwei flache Backplates und ein rundes `+N`-Badge für weitere, gerade nicht sichtbare Karten
- Das Badge ist nur Überlaufanzeige; im Notification Center werden Ereignisse weiterhin einzeln und chronologisch geführt
- Zeitmetadaten entfallen in dieser kompakten, dismissiblen Darstellung zugunsten eines X
- Jede ungelesene Live-Karte zeigt zusätzlich dauerhaft `Gelesen` mit Haken
- Jede Karte besitzt weiterhin einen einzeiligen blauen Ziel-Link
## Aktionen
- Kartenkörper → [[S01 Glocken-Drawer]] öffnen, das passende Item in den sichtbaren Bereich scrollen und dessen Fokusrahmen einmal kurz heller aufscheinen lassen
- Das Öffnen des Drawers markiert die Notification nicht automatisch als gelesen
- Blauer Ziel-Link → direkt zum exakten Ziel und Eintrag als gelesen markieren
- `Gelesen` → Eintrag als gelesen markieren und die Live-Karte schließen, ohne zu navigieren
- X → nur Live-Overlay schließen; Center-Eintrag bleibt bestehen
- Stapel oder `+N`-Badge → Drawer am neuesten noch nicht sichtbaren Ereignis öffnen
## Timing / Motion
- Standarddauer: 8 Sekunden
- Hover, Tastaturfokus und inaktiver Browser-Tab pausieren den Timer; nach Rückkehr bleiben mindestens zwei Sekunden
- Eintritt ca. 250 ms, Austritt ca. 180 ms
- Drawer-Fokus-Schein: 150 ms aufhellen, 350 ms halten, 200 ms zurücknehmen
- Reduzierte Bewegung: nur Opacity und statisch hellerer Rahmen, kein Slide oder Bounce
## Subframe
- [S05 App-Shell – Live Notifications](<https://app.subframe.com/f023064a5ca0/design/14386a95-8c95-46c6-8127-61c261f6e305/edit>)
## Status
Position oben rechts, maximal drei sichtbare Karten, der `+N`-Überlaufstapel, die getrennten Aktionen `Gelesen` und X sowie der Übergang in den Drawer sind validiert.
@@ -0,0 +1,65 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S06
screen: Kurzinfos Status und Upload
typ: Toast-Referenz
umsetzung: Gebaut
status: Validiert
route: "global, unten rechts"
subframe: "https://app.subframe.com/f023064a5ca0/design/66b46a36-1d7f-418b-b0ea-3550569c3374/edit"
---
# S06 — Kurzinfos, Status und Upload
## Ziel
Flüchtiges Produktfeedback für laufende Aktionen, Ergebnisse, Warnungen und behebbare Fehler im App-Shell definieren. Diese Toasts werden nicht im Notification Center gespeichert.
## Stapel
- Position unten rechts
- Maximal fünf sichtbare Toasts
- Neuester Toast liegt am unteren Rand; ältere wandern nach oben
- Alle Toasts besitzen ein X
- Kein Sammel-Count nötig; bei mehr als fünf entscheidet die Queue nach Priorität und Aktualität
## Varianten
| Variante | Beispiel | Verhalten |
|---|---|---|
| Fortschritt | `Datei wird hochgeladen` mit Dateiname, MB-Angabe, Progress und `Abbrechen` | bleibt bis Abschluss/Abbruch |
| Hintergrundstatus | `Synchronisierung läuft` | bleibt während des Prozesses |
| Erfolg | `Import abgeschlossen` | 4 Sekunden |
| Information | neutraler Status ohne Aktion | 6 Sekunden |
| Warnung | `Speichern verzögert` | 8 Sekunden |
| Fehler mit Aktion | `Upload fehlgeschlagen` plus `Erneut versuchen` | bleibt bis X oder erfolgreicher Aktion |
| Rückgängig | `Projekt archiviert` plus `Rückgängig` | zeitlich begrenzte Aktionschance |
## Prozesslogik
- Loading-/Progress-UI erscheint erst nach etwa 500 ms, damit sehr kurze Vorgänge nicht flackern.
- Während ein Prozess läuft, gibt es kein Auto-Dismiss.
- Derselbe Toast wechselt bei Erfolg in den Erfolgszustand und schließt dann nach vier Sekunden.
- Bei Fehler wechselt derselbe Toast in den Fehlerzustand und bleibt offen.
- Ein fehlgeschlagener Retry hält den Toast offen; ein erfolgreicher Retry schließt ihn nach dem Erfolgsfeedback.
- Nach zehn Sekunden darf ein langer Prozess zu `Läuft im Hintergrund` verdichtet und nach weiteren fünf Sekunden ausgeblendet werden; der Prozess läuft weiter.
- Wird der Abschluss später relevant und besitzt ein Ziel, endet der Status-Toast und derselbe Vorgang wechselt zu genau einem persistenten Notification-Event. Für dasselbe Ergebnis erscheinen nicht zusätzlich Erfolg-Toast und Live-Notification.
## Abgrenzung
- Ein Ergebnis mit später relevantem Ziel, etwa `Export fertig`, wechselt vom Status-Toast zu genau einem persistenten Notification-Event.
- Sehr häufige Bestätigungen wie `Änderungen gespeichert` verwenden [[S07 Mikro Feedback]].
- Status-Toast und Mikro-Feedback desselben Vorgangs werden dedupliziert; der informationsreichere Status-Toast gewinnt.
- Bei verschiedenen Vorgängen dürfen beide gleichzeitig sichtbar sein. Das Mikro-Feedback steht dann links neben dem Toast-Stapel und überlagert ihn nicht.
- Formularvalidierung bleibt Inline Alert; Offline bleibt Permanent Banner.
## Subframe
- [S06 App-Shell – Kurzinfos und Statusfarben](<https://app.subframe.com/f023064a5ca0/design/66b46a36-1d7f-418b-b0ea-3550569c3374/edit>)
## Status
Validiert sind maximal fünf Toasts, die dokumentierten Timings, Upload-/Loading-Übergänge und das persistente Fehlerverhalten bis X oder erfolgreiche Aktion. Der Screen bleibt eine visuelle Referenz für diese Regeln.
@@ -0,0 +1,58 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S07
screen: Mikro Feedback
typ: Micro-Referenz
umsetzung: Gebaut
status: Validiert
route: "global, unten rechts"
subframe: "https://app.subframe.com/f023064a5ca0/design/78c8e52f-c328-4583-9a97-40cf95130a47/edit"
---
# S07 — Mikro Feedback
## Ziel
Sehr häufige, harmlose Bestätigungen sichtbar machen, ohne Nutzer mit großen Toasts oder wiederholtem Wegklicken zu belasten.
## Darstellung
- Kleine, ruhige Pill unten rechts
- Leichter positiver Rahmen zur besseren Erkennbarkeit, ohne wie ein voller Toast zu wirken
- Ein kurzes Statuswort oder ein sehr kurzer Satz plus positives Icon
- Kein Titel-Body-Aufbau, kein Link, kein Fortschritt und kein X
- Maximal eine Instanz; ein neuer identischer Hinweis ersetzt den bestehenden statt zu stapeln
- Bei einem gleichzeitig sichtbaren Status-Toast zu einem anderen Vorgang steht die Pill links neben dem unten rechts verankerten Toast-Stapel
- Beziehen sich Toast und Mikro-Feedback auf denselben Vorgang oder dasselbe Ergebnis, erscheint nur der informationsreichere Status-Toast
## Geeignete Beispiele
- Änderungen gespeichert
- Link kopiert
- Reihenfolge aktualisiert
- Zuordnung geändert
## Nicht verwenden für
- Fehler oder Warnungen
- Loading und Fortschritt
- Ergebnisse mit später relevantem Ziel
- Handlungen, die bestätigt oder rückgängig gemacht werden müssen
## Timing / Motion
- Etwa 150 ms Fade plus 4 px ruhige Aufwärtsbewegung
- 1,5 Sekunden sichtbar
- Etwa 120 ms Fade-out
- Bei reduzierter Bewegung nur Opacity
## Subframe
- [S07 App-Shell – Micro Feedback](<https://app.subframe.com/f023064a5ca0/design/78c8e52f-c328-4583-9a97-40cf95130a47/edit>)
## Status
Eigene kleine Verhaltensklasse, maximal eine Instanz, 1,5 Sekunden Sichtbarkeit, leichter Rahmen und Kollisionsregel mit Status-Toasts sind validiert.
@@ -0,0 +1,51 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Benachrichtigungen
id: S08
screen: Kritischer Dialog
typ: Dialog-Referenz
umsetzung: Gebaut
status: Validiert
route: "global, modal"
subframe: "https://app.subframe.com/f023064a5ca0/design/4ecac4cb-d303-40f3-8c32-8aa04ef3cbad/edit"
---
# S08 — Kritischer Dialog
## Ziel
Seltene Situationen sichtbar unterbrechen, in denen ein Vorgang unmittelbare Aufmerksamkeit braucht. Inhalt und Hauptaktion werden je Ereignis gesetzt; das gezeigte Layout bleibt global wiederverwendbar.
## Darstellung
- Echte bestehende `Dialog`-Root mit `Dialog.Content`; kein manuell gebautes Overlay und kein künstlicher Blur-Hintergrund
- Zentrierter Dialog auf dem von der Komponente gelieferten Overlay
- Keine Auto-Dismiss-Zeit
- Standardmäßig X oben rechts und zusätzliche Aktion `Schließen`
- Klare Problembeschreibung, Konsequenz und höchstens zwei sinnvolle Aktionen
- Allgemeine Referenzcopy: `Aktion erforderlich`
- Hauptaktion im Referenzscreen: `Problem beheben`; Development ersetzt sie ereignisspezifisch
## Verhalten
- Der Dialog hat kein Auto-Dismiss, kann standardmäßig aber über X oder `Schließen` verlassen werden.
- Hauptaktion, Folgefeedback und Schließverhalten nach erfolgreicher Aktion werden je Ereignis definiert.
- Ein wirklich nicht schließbarer Dialog ist kein Standard. Development darf X und `Schließen` nur für ausdrücklich festgelegte echte Blocker ausblenden.
- Das kritische Ereignis bleibt parallel als persistenter Eintrag im Notification Center, sofern es später noch relevant oder nachvollziehbar ist.
- Kritisch ist eine zusätzliche Ausgabefläche, keine rote Quellenkategorie.
## Motion
- Backdrop ca. 200 ms einblenden
- Dialog ca. 320 ms mit 8 px ruhigem Settle, ohne Bounce
- Bei reduzierter Bewegung ausschließlich Fade
## Subframe
- [S08 App-Shell – Kritischer Dialog](<https://app.subframe.com/f023064a5ca0/design/4ecac4cb-d303-40f3-8c32-8aa04ef3cbad/edit>)
## Status
Echte Dialog-Komponente, kein Auto-Dismiss, standardmäßige Schließbarkeit und ereignisspezifische Inhalte/Aktionen sind validiert.