docs(p4): finalize tasks handoff
This commit is contained in:
1 parent
058d72be72
commit
1eb7765b41
14 files changed
+1346
-239
No files matched your search
@@ -0,0 +1,124 @@
|
||||
---
|
||||
kind: screen-contract
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P4
|
||||
package: WF-P4 Aufgaben
|
||||
id: Z01
|
||||
screen: Zustände und Feedback
|
||||
typ: Development-Vertrag
|
||||
umsetzung: Nur dokumentieren
|
||||
status: Fertig / Development-Handoff
|
||||
subframe: ""
|
||||
source_checked: 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 kurz `Gespeichert`.
|
||||
- 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
|
||||
|
||||
```text
|
||||
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.
|
||||
Reference in new issue
Block a user