9.7 KiB
kind, project, ticket, package, id, screen, typ, umsetzung, status, subframe, source_checked
| kind | project | ticket | package | id | screen | typ | umsetzung | status | subframe | source_checked |
|---|---|---|---|---|---|---|---|---|---|---|
| screen-contract | HiveGrid Screen Project | D-P4 | WF-P4 Aufgaben | Z01 | Zustände und Feedback | Development-Vertrag | Nur dokumentieren | Fertig / Development-Handoff | 2026-08-23 |
Z01 — Zustände und Feedback
[!important] Bewusster Design-Scope · 2026-08-23 Die folgenden Empty-, Loading-, Error-, Upload-, Autosave-, Erfolgs- und Undo-Zustände erhalten keine eigenen Subframe-Seiten. Sie sind ein verbindlicher Development- und QA-Vertrag. Mobile ist für diese Validierungsrunde vollständig außerhalb des Scopes.
Die bestätigten Normalzustände sowie entscheidungsrelevante Dialoge stehen in Subframe. Zustände, die ausschließlich Rückmeldung geben oder einen technischen Ausnahmefall abbilden, werden mit vorhandenen Standardkomponenten umgesetzt: Empty State, Skeleton, Toast, Form save Retry, File Upload und gegebenenfalls ein bestehender Offline-/Hinweisbanner.
1. Empty States
| Kontext | Auslöser | Inhalt / CTA |
|---|---|---|
| S01 · noch keine Aufgaben | Konto/Scope enthält keine Aufgabe | Titel Noch keine Aufgaben; Kurztext; primär Neue Aufgabe |
| S01 · Filter ohne Treffer | Suche oder Filter liefert 0 Treffer | Titel Keine Aufgaben gefunden; aktive Filter benennen; primär Filter zurücksetzen, Suche beibehalten |
| S03 · keine offenen eigenen Aufgaben | Drawer-Abfrage liefert 0 aktive Aufgaben | Titel Alles erledigt; Text Du hast aktuell keine offenen Aufgaben.; sekundär Vollansicht, primär Neue Aufgabe |
| V01 · keine Aufgabe am Datensatz | Objekt besitzt keine verknüpfte Aufgabe | Titel Noch keine Aufgaben zu diesem Eintrag; primär Aufgabe hinzufügen mit vorbefüllter Verknüpfung |
| S02 · keine Anhänge | Aufgabe hat keine Dateien | kompakte Inline-Zeile Noch keine Dateien; Aktion Datei hinzufügen; kein großflächiger Empty State |
| S02 · keine Verknüpfungen | Aufgabe besitzt keine Kontext-Verknüpfung | kompakte Inline-Zeile Noch keine Verknüpfungen; Aktion Verknüpfung hinzufügen |
| S02 · kein Verlauf außer Erstellung | keine weiteren Ereignisse | Erstellung als erster Eintrag sichtbar lassen; keinen separaten Empty State zeigen |
| M03 · Suche ohne Treffer | Relationensuche liefert 0 Treffer | Keine passenden Einträge gefunden; Suchbegriff sichtbar lassen; keine Anlage fremder Datensätze aus diesem Dialog |
| Auswahlfelder | Verantwortliche, Beobachter, Tags oder Verknüpfungen ohne Treffer | kompakter Keine Treffer-Eintrag im geöffneten Menü; keine eigene Seite |
2. Loading und Aktualisierung
| Kontext | Verhalten |
|---|---|
| S01 / V01 | Tabellen-/Zeilenskeleton mit stabilen Spaltenbreiten; Kopf, Filter und Primäraktion bleiben stehen |
| S02 | Struktur-Skeleton für Kopf, Eigenschaften und Inhaltsbereiche; keine springenden Spalten |
| S03 | Drawer-Kopf und Footer bleiben stehen; 4–5 kompakte Zeilenskeletons im Scrollbereich |
| Suchauswahl M03 / Picker | Spinner im Suchfeld beziehungsweise am Listenende; bestehende Treffer nicht sofort leeren |
| Pagination / Filterwechsel | vorhandenen Inhalt bis zum Ergebnis gedimmt stehen lassen; Mehrfachauslösung verhindern |
| Mutation eines Einzelwerts | nur das betroffene Control sperren; restliche Aufgabe bleibt bedienbar |
3. Fehler und Validierung
| Fall | Rückmeldung | Recovery |
|---|---|---|
| Aufgabe nicht vorhanden / kein Recht | neutraler 404-State Aufgabe nicht gefunden; keine Information über fremde Aufgaben preisgeben |
Zur Aufgabenübersicht |
| S01/S03/V01 kann nicht geladen werden | Error-Variante der Standardkomponente mit Klartext | Erneut versuchen; Navigation bleibt verfügbar |
| S02 kann nicht geladen werden | seitenweiter Error-State innerhalb der Vollansicht | Erneut versuchen und Zurück |
| Inline-Mutation fehlgeschlagen | alten Wert wiederherstellen; Fehler-Toast mit betroffenen Feld | Erneut versuchen, sofern idempotent |
| Gleichzeitige Änderung / Versionskonflikt | lokale Eingabe nicht still überschreiben | Hinweis Aufgabe wurde zwischenzeitlich geändert; Neu laden |
| Offline | keine erfolgreiche Speicherung vortäuschen | Offline-Banner; ausstehende lokale Eingabe erhalten; nach Verbindung erneut senden |
| M01 · Titel leer | Inline-Text Titel ist erforderlich; Fokus auf Titel |
Dialog bleibt offen |
| M01 · Verantwortlich leer | technisch verhindern, weil eigener Nutzer Default ist; bei fehlerhaften Daten Inline-Hinweis | eigenen Nutzer erneut setzen oder Picker öffnen |
| M01 · Uhrzeit ohne Fälligkeit | Uhrzeit deaktivieren oder Inline-Hinweis Bitte zuerst ein Datum wählen |
Datum wählen / Uhrzeit entfernen |
| M01 · Speichern fehlgeschlagen | Eingaben und Upload-Auswahl vollständig erhalten; Fehler-Toast | Erneut versuchen; kein doppeltes Anlegen |
| M03 · Ziel inzwischen gelöscht / kein Recht | Dialog offen lassen; betroffene Zeile entfernen oder deaktivieren; Klartext-Hinweis | anderes Ziel wählen |
| Datei · Typ nicht unterstützt | Fehler direkt an der Datei | Datei entfernen/ersetzen |
| Datei · zu groß | erlaubte Maximalgröße nennen | Datei entfernen/ersetzen |
| Datei · Netzwerk-/Serverfehler | fehlerhafte Datei in der Liste erhalten | Erneut versuchen oder entfernen |
| Datei · Sicherheitsprüfung abgelehnt | neutraler Klartext ohne technische Interna | Datei entfernen; Supportweg nur falls nötig |
| Bulk-Aktion teilweise fehlgeschlagen | Erfolgs- und Fehleranzahl nennen; fehlgeschlagene Zeilen markiert/selektiert lassen | Aktion für Rest erneut ausführen |
4. Speichern, Erfolg und Undo
Feedback-Prinzip
- Direkte Feldänderungen in S01/S02 verwenden optimistische Aktualisierung. Ein Erfolg erzeugt normalerweise keinen Toast; bei längeren Schreibvorgängen erscheint lokal
Speichert …, danach kurzGespeichert. - Abgeschlossene, vom Nutzer bewusst ausgelöste Vorgänge erhalten genau einen kompakten Toast. Gleichartige Bulk-Ereignisse werden zusammengefasst.
- Ein Toast verschwindet nicht, solange der Nutzer zum Verständnis oder zur Wiederherstellung handeln muss.
- Destruktive Vorgänge, die im Bestätigungsdialog ausdrücklich als nicht wiederherstellbar bezeichnet sind, bieten anschließend kein Undo.
| Vorgang | Erfolgsfeedback | Undo / Folgeaktion |
|---|---|---|
| Aufgabe erstellt | Aufgabe wurde erstellt |
optional Öffnen; kein Undo |
| Aufgabe dupliziert | Aufgabe wurde dupliziert |
Öffnen; kein Undo |
| Aufgabe erledigt | Aufgabe als erledigt markiert |
Rückgängig setzt vorherigen Status |
| Aufgabe wieder geöffnet | Aufgabe wieder geöffnet |
Rückgängig |
| Status/Priorität/Fälligkeit/Zuständigkeit/Tags geändert | lokal Gespeichert; bei Bulk ein zusammengefasster Toast |
bei Bulk optional Rückgängig, sofern atomar möglich |
| Notiz hinzugefügt | Notiz wurde hinzugefügt |
kein Undo; Eintrag im Verlauf sichtbar |
| Datei hinzugefügt | Datei wurde hinzugefügt beziehungsweise Anzahl |
kein Toast pro Datei bei Mehrfachupload; kein Undo |
| Anhang entfernt | Anhang wurde von der Aufgabe entfernt |
kein Undo; die Entscheidung wurde zuvor in M08b bestätigt, Originaldatei bleibt erhalten |
| Verknüpfung hinzugefügt | Verknüpfung wurde hinzugefügt |
Rückgängig darf die gerade erzeugte Verbindung lösen |
| Verknüpfung gelöst | Verknüpfung wurde gelöst |
kein Undo, wenn M04 dies als endgültige Entscheidung bestätigt; sonst M04-Wording anpassen |
| Aufgabe gelöscht | Aufgabe wurde gelöscht |
kein Undo |
| mehrere Aufgaben gelöscht | 3 Aufgaben wurden gelöscht |
kein Undo |
| Filter-Preset gespeichert | Preset wurde gespeichert |
optional Preset öffnen; kein Undo |
5. Fachliche Hinweisbanner
Diese Hinweise sind ebenfalls nur dokumentiert und werden nicht als zusätzliche Subframe-Screens gebaut.
| Hinweis | Ort | Verhalten |
|---|---|---|
| Zuständiger deaktiviert | S02 unter dem Kopf; optional kompakt in S01 | Warnung ohne Blockade; primär Neu zuweisen; Aufgabe bleibt sichtbar |
| Archivierung in 30 Tagen | S02 unter dem Kopf | Datum der Archivierung nennen; Aktion Archivierung verhindern, sofern Rolle berechtigt |
| Verknüpfter Datensatz gelöscht | S02 bei Verknüpfungen und einmalig als Hinweis | gelöschtes Ziel nicht verlinken; Aktion Verknüpfung entfernen oder Neu verknüpfen |
| Überfällig | bestehende Darstellung verwenden | S01 rote Fälligkeit + Zähler; S02 bestehender Banner; keine zusätzliche Toast-Flut |
| Berechtigung während offener Ansicht entzogen | betroffene Ansicht | Eingaben stoppen, neutral informieren, sichere Navigation anbieten |
6. Datei-Upload-Zustandsmaschine
Ausgewählt -> Wird hochgeladen -> Sicherheitsprüfung -> Hinzugefügt
| | |
+-> Typ/Größe +-> Netzwerkfehler +-> abgelehnt
- Fortschritt, Abbrechen, Retry und Dateifehler werden mit der vorhandenen
File Upload-Komponente umgesetzt. - Schließen während eines aktiven Uploads benötigt eine Warnung, falls der Upload dadurch tatsächlich abgebrochen wird; läuft er im Hintergrund weiter, genügt ein neutraler Hinweis.
- Doppelte Dateinamen sind erlaubt, sofern die Produktlogik nicht eindeutig dieselbe Datei erkennt; im Konfliktfall nicht still überschreiben.
7. QA-Abnahmekriterien
- Jede Mutation hat genau einen erkennbaren Ausgang: gespeichert, rückgängig gemacht oder fehlgeschlagen.
- Fehler verlieren keine Texteingabe, Auswahl oder noch nicht übertragene Datei.
- Retry erzeugt keine Duplikate.
- Tastaturfokus springt bei Inline-Fehlern zum ersten fehlerhaften Feld und kehrt nach einem Dialog zur auslösenden Aktion zurück.
- Screenreader-Text nennt Objekt und Wirkung destruktiver Aktionen; Farbe ist nie der einzige Indikator.
- Mobile bleibt ausdrücklich ungetestet und ist kein Abnahmekriterium dieser Runde.