8.0 KiB
8.0 KiB
03 – Abgleich mit UX-Ergänzung und Einzelaufträgen
Grundlage: TSUMUGU_UX_MVP_ERGAENZUNG.md Fassung 0.8 sowie die Aufträge im Produktordner. Darstellung und Bedienung wurden aus dem Code abgeleitet, nicht im Browser bedient. Kennzeichen siehe 01.
1. Abnahmekriterien UX-01 bis UX-21
| ID | Kriterium (Kurzform) | Status | Beleg | Bemerkung |
|---|---|---|---|---|
| UX-01 | Eigenständiger Vorgang ohne Akte anlegbar, später zuordnen | ✅ | Matters.jsx, POST /matters, POST /matters/{id}/case-links |
– |
| UX-02 | Hierarchie über objektbezogenen Breadcrumb und Gliederung; Aktenzuordnung separat | ✅ | present.case_trail, matter_trail, matter_placements |
– |
| UX-03 | Inhalte unmittelbar, keine leeren Strukturabschnitte davor | ✅ | Vorgangsseite mit einer zentralen Fläche | – |
| UX-04 | Stabile Datumssortierung, undatiert am Ende, Erfassungsdatum kein Ersatz | ✅ | order.arrange; Test test_date_order_keeps_undated_last_and_ignores_recorded_time |
– |
| UX-05 | Eigene Reihenfolge bleibt nach Neuladen/Anmeldung und Moduswechsel | ✅ | Test test_custom_order_survives_reload_login_and_date_mode |
– |
| UX-06 | Dasselbe Element mit unabhängigen Positionen in zwei Containern | ✅ | Test test_same_element_has_independent_positions |
– |
| UX-07 | Kapitel bleiben beim Sortieren; direkte Akteninhalte von Vorgangsinhalten unterscheidbar | ✅ | Tests test_chapters_and_contained_matters_stay_distinct, test_chapters_follow_the_container_not_the_entry |
– |
| UX-08 | Unterlage öffnet mit Vorschau bzw. Text als Hauptinhalt | ✅ | ReadingPane.jsx (pdf.js, Bild, E-Mail, Notiz) |
Auslieferung aktiver Inhalte → R-03 |
| UX-09 | Protokoll separat; Verlauf ohne technische Mehrfachabbilder | ✅ | Ansichten in content.jsx; Test test_course_is_not_a_copy_of_the_audit_log |
Einzelne Aktionen ohne Label → R-18 |
| UX-10 | Aufgabe und Frist erfassen, zentral wiederfinden, getrennte Erledigung | 🟡 | Work.jsx, Übersicht |
zentrale Liste begrenzt vor Rechteprüfung → R-11 |
| UX-11 | Leser ändern keine Ordnung; manipulierte IDs ohne Wirkung; keine verborgenen Titel/Anzahlen | ✅ | Test test_reorder_rejects_readers_foreign_ids_and_conflicts |
Detach ohne Kontextprüfung → R-02 |
| UX-12 | Bestandsdaten bleiben nach Migrationen | ✅ | Migrationen additiv; Test test_existing_position_mode_is_not_rewritten, test_flat_chapters_keep_identity_order_and_bindings |
– |
| UX-13 | Desktop und schmaler Bildschirm, Alternative zum Ziehen, Tastatur | ❔ | „Nach oben/unten“ im Zeilenmenü vorhanden | Bedienung nicht geprüft; Prüfberichte nennen 390/360 px |
| UX-14 | Gleicher Struktur-Breadcrumb über Liste, Akte, Direktlink | ✅ | Tests test_direct_matter_trail_invents_no_case, test_teilvorgang_keeps_its_parent_in_the_trail |
– |
| UX-15 | Genau eine zentrale Ansicht, kein Block „Struktur und Zuordnung“ | ✅ | content.jsx Ansichtswechsel |
– |
| UX-16 | Typ-Symbol, Titel, Datum/„Ohne Datum“, Typ/Quelle getrennt, Auszug | ✅ | EntryMark, contentSymbol |
– |
| UX-17 | Echtes Drag-and-drop mit Zeiger, mindestens acht Einträge, inkl. Abbruch und Scrollen | ❔ | Pointer-Capture, Einfügelinie, Auto-Scroll (content.jsx:1356–1417) |
Ein dokumentierter Bedienungsnachweis fehlt. LIEFERUNG_2026-10-17.md nennt Drag-and-drop ausdrücklich „nicht ausgeführt“ |
| UX-18 | Fehler/Konflikte verständlich; kein wirkungsloses Drag im Datumsmodus | 🟡 | canSort && custom steuert die Aktionen |
Konfliktanzeige nicht geprüft |
| UX-19 | „Alle Inhalte“ einer Akte mit Herkunft | ✅ | case_detail.contained, Ansicht „Überblick“ |
– |
| UX-20 | Vorschauen bleiben auch über Direktabruf geschützt | ✅ | Vorschauen laufen über dieselben geprüften Endpunkte, kein Cache, no-store |
Vorgangsausnahme wirkt nicht auf Element-Endpunkte → R-07 |
| UX-21 | Bereichswahl vor Kapitel-/Inhaltsaktion; neues Kapitel vorausgewählt | ✅ | Test test_chapters_follow_the_container_not_the_entry; ChapterForm |
– |
Weitere UX-Vorgaben:
| Abschnitt | Vorgabe | Status | Bemerkung |
|---|---|---|---|
| 4 | Hauptnavigation Übersicht, Vorgänge, Akten, Aufgaben & Fristen; Verwaltung gebündelt | ✅ | Shell.jsx |
| 4 | Übersicht mit zuletzt bearbeiteten Vorgängen | ✅ | GET /views/recent-matters |
| 10 | Warnung bei ungesicherten Eingaben vor dem Verlassen | 🟡 | nur in Modals, beim Datenraum- und Kontextwechsel (isDirty). Kein Routen-Blocker, kein beforeunload |
| 10 | Mehrfachanlage verhindern, Fehler am Feld | 🟡 | pending-Sperre vorhanden; Fehler meist als Sammelmeldung |
| 11 | Ladezustand, Leerzustand, Fehler, fehlende Berechtigung unterscheidbar | ❔ | nicht systematisch geprüft |
| 12 | Kein öffentlicher Nebenweg für Vorschauen | ✅ | nur Blob-URLs aus geprüften Abrufen |
2. Einzelaufträge
Symbole und Logo-Rahmen (TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md)
| Vorgabe | Status | Beleg |
|---|---|---|
| Notiz als Sprechblase mit Stift, hell/dunkel | ✅ | public/ui/content-symbols-v1/{light,dark}/note.svg, Hash-Revision in content-symbol.mjs |
| Typ-Symbol in jeder Zeile, Miniatur nur bei Bildern | ✅ | EntryMark lädt nur bei symbol === "image" |
| Paperless nicht automatisch als PDF | ✅ | contentSymbol gibt für Paperless ohne MIME file zurück |
| Lucide-Lizenz übernommen | ✅ | LICENSE-LUCIDE.txt |
| Logo auf dunkler Fläche mit transparenter Rundung | ✅ | public/brand/logos-on-dark-v1/, logo-frame.css |
Ensō-Animation
| Vorgabe | Status | Beleg |
|---|---|---|
| Intro beim Login, Busy nur bei laufender Anmeldung | ✅ | Login.jsx: markMotion = pending ? "busy" : … |
| Reduced Motion, Poster-Fallback | ❔ | in JinkendoMark.jsx/CSS angelegt, nicht im Browser geprüft |
Kommunikationsrichtung 1.2 und kompakte Inhaltsliste 1.0
| Vorgabe | Status | Beleg |
|---|---|---|
Richtung je Einbindung, Werte in/out/local/leer |
✅ | Migrationen …180000Z…, …193000Z… |
| Bewusstes Leeren bleibt gespeichert | ✅ | direction_explicit; Test test_dates_do_not_invent_a_direction_and_explicit_choice_survives |
| Keine Ableitung aus Versand-/Zugangsdatum | ✅ | communication_from_row |
| IMAP-Vorbelegung nur bei eindeutigem Fach | ✅ | sources._direction (Posteingang/Gesendet) |
| Zweite Einbindung behält eigene Richtung | ✅ | Test test_a_second_binding_keeps_its_own_direction |
| Ein Beleg klassifiziert nicht das Kapitel | ✅ | Test test_one_beleg_does_not_classify_the_chapter |
| Zeichen als einziges Bedienelement, kein Dauer-Dropdown | ✅ | DirectionChoice |
| Bezüge als kompakter Auslöser ohne Klammern | ✅ | Auslöser „Bezüge n“ mit Popover (content.jsx:576–588); keine Regel .preview-row--linked mehr in styles.css |
| Zeilenhöhen 80–110 px bzw. 100–140 px | ❔ | nicht gemessen |
Übergabepaket (Export-Auftrag und Prüfbericht)
| Abnahmeschritt | Status | Beleg |
|---|---|---|
| 1–3 Auswahl mit Zwischenzustand, vollständige E-Mail | ✅ | test_export.py |
| 4 ZIP ohne Tsumugu nutzbar, relative Links | ✅ | _html_overview, _relative |
| 5 Gleichnamige Anlagen, Größe über Vorschaugrenze | ✅ | _unique_path, 80-MiB-Grenze |
| 6 Unerreichbare Quelle → kein irreführendes Paket | ✅ | RetrievalFailure blockiert ready |
| 7 Eingeschränkter Benutzer, verborgene Gegenstücke | 🟡 | Freigabe wird geprüft. Ein unlesbares Bezugsziel blockiert das Paket und verrät, dass ein Bezug existiert → R-13 |
| 8 Späterer Stand ändert altes ZIP nicht | ✅ | Paket wird nicht gespeichert |
Unterkapitel (Auftrag und Prüfbericht)
Alle acht Abnahmeschritte sind im Code nachvollziehbar: Anlage unter Elternkapitel, Mehrfacheinordnung (POST …/bindings/chapters), Umhängen mit Zyklus- und Tiefenprüfung (App und DB-Trigger), Auflösen mit Aufrücken, Export als Verzeichnisse. Die Tests stehen in test_chapters.py und test_export.py::test_nested_chapter_export_keeps_path_and_complete_mail. Die Bedienung mit 390/360 px ist nur durch den Prüfbericht belegt.