Files
tsumugu/docs/review/03_ANFORDERUNGEN_UX_UND_AUFTRAEGE.md
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

8.0 KiB
Raw Permalink Blame History

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.