Files
tsumugu/docs/design/LIEFERUNG_2026-10-17.md
LarsandCursor dc8a9c2db6
Deploy Development / deploy (push) Successful in 27s
Test Suite / pytest-backend (push) Successful in 1m7s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 8s
Zeige den Vorgang in seiner Akte, ordne mehrere Aufgaben einer Frist zu und verwende Logo sowie Favicon aus der Lieferung.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-17 14:57:48 +02:00

6.9 KiB
Raw Permalink Blame History

Lieferung der Arbeitsfläche, 17.10.2026

Lokaler Stand auf develop, nicht committed und nicht nach develop gepusht. Es gibt deshalb kein Development-Deploy und keinen Production-Stand. docs/architecture/ARCHITECTURE_DISCOVERY.md ist unverändert fremde Arbeit.

Was benutzbar ist

Die bestehende Anwendung zeigt Akten, Vorgänge und Teilvorgänge in einer Fläche: dunkelgrüne Navigation, Strukturnavigator, Vorschauzeilen und Leser. Der Ablauf Akte öffnen, Unterakte wählen, Vorgang öffnen, Teilvorgang öffnen, Kapitel wechseln oder anlegen, Inhalt hinzufügen, Reihenfolge ändern, Dokument lesen und ins Kapitel zurückkehren läuft im Bestand.

Fachlichkeit und serverseitige Rechte sind unverändert. Kapitel bleiben am geöffneten Objekt. „Alle Inhalte“ zeigt die direkten Einträge dieses Objekts, nicht still die Inhalte eines Teilvorgangs. Eigene Reihenfolge liegt serverseitig und bleibt nach Neuladen erhalten. Datumssortierung ist davon getrennt.

Der Leser hängt an eintrag und kapitel in der Adresse. Schließen nimmt den Eintrag aus der Adresse und lässt das Kapitel stehen. Ein alter Direktlink auf die bisherige Leserroute landet in dieser Fläche.

Tsumugu bindet das große Logo unverändert aus approved-logos-v1/tsumugu ein: frontend/public/brand/logo-original.png (280×298). Die Browser-Favicons sind die Kleinform ohne Ensō aus favicons-v2/tsumugu unter frontend/public/brand/favicons-v2/. Apple-Touch-Icon und PWA-Icons bleiben die bisherigen Rasterdateien. frontend/brand/render.mjs zeichnet nichts und überschreibt diese Dateien nicht. Ein Service Worker ist bewusst nicht enthalten; Offline-Schreiben gehört nicht zu dieser Lieferung. Andere App-Repositories sind nicht geändert.

Bewusste Abweichungen

  • Der sichtbare Objektpfad ist die Vorgangslinie. Die Akte steht daneben als „In Akte“, nicht im selben Breadcrumb. So bleibt der Handlungskontext von der Zuordnung getrennt.
  • Eine Akte öffnet zuerst ihre direkten Inhalte. Die gemischte Lesesicht heißt „Überblick“ und ist nur Datum sortiert.
  • Ein Vorgang aus der Akte öffnet die Vorgangsseite im Aktenkontext, er wird nicht in die Akte eingebettet.
  • Das Kapitel steht im Navigator und in der Liste, nicht im Breadcrumb.
  • Ohne gewähltes Kapitel ist „Alle Inhalte“ aktiv, nicht das erste Kapitel.
  • Es gibt weiterhin nur eine Unteraktenebene und eine Teilvorgangsebene.
  • Ohne Aktenkontext zeigt der Navigator nicht die Geschwister aus dem Aktenbaum.
  • E-Mail ist kein neuer Fachtyp.
  • Die Suche öffnet den Treffer mit Eintrag und Kapitel. Sie übergibt dabei nicht zusätzlich den Aktenkontext. Der Vorgang nennt seine Akten, der Handlungskontext ist dann direkt.

Prüfung am 17.10.2026

Geprüft im lokalen Browser gegen eine eigene Datenbank tsumugu_ui_test auf einem portablen Postgres, Port 60269. API http://127.0.0.1:8011, Oberfläche http://127.0.0.1:5173. Nicht gegen tsumugu oder tsumugu_dev. Die Beispieldaten und das Konto sind fiktiv. Die große Beispielrechnung aus dem Referenzbild ist keine eingebaute Oberfläche.

Konto nur für diese lokale Datenbank: pruefung@example.test / Beispiel-Pruefung-2026, Anzeigename Max Lehmann.

Ausgeführt:

  • Anmeldung, Akte Vermietung, Unterakte Wohnung am Park, Vorgang Nebenkosten 2025, Teilvorgang Belegeinsicht.
  • Kapitel Belege gewählt, dreiseitiges PDF im Leser, Seite 2 über „Nächste Seite“.
  • Notiz „Nachtrag zur Prüfung“ im Kapitel Belege angelegt. Zähler danach: Belege 4, Alle Inhalte 6, neues Kapitel Rückfragen 0.
  • „Notiz zur Belegpruefung“ per Nach-unten hinter die Hausverwaltungszeile geschoben. Nach Neuladen dieselbe Reihenfolge, Leser und Kapitel aus der Adresse wieder da.
  • Paperless-Referenz ohne Quelle: Leser sagt, Paperless sei nicht verbunden und die Vorschau sei nicht verfügbar.
  • Schließen des Lesers bleibt im Kapitel Belege.
  • Suche „Heizkosten“ findet die Abrechnung und die Notiz. Der Treffer öffnet den Leser.
  • Querverweis öffnet Kautionsabrechnung, ohne das Kapitel mitzunehmen.
  • Vorgang „Eigenstaendig ohne Akte“ ohne Aktenzeile. „Versicherung Hausrat“ zeigt Ferienhaus und Wohnung am Park, mit gesetztem Handlungskontext.
  • Breiten: 1920 mit Navigator, Liste und Leser; 1280 mit geteilter Liste und Leser, Struktur über den Schalter; 820 mit kompakter Icon-Leiste und Leser statt Liste, Zurück zum Kapitel; 390 mit Leser ohne globale Leiste und ohne untere Navigation; 360 mit unterer Navigation Start, Vorgänge, Akten, Aufgaben, Mehr und ohne horizontales Überlaufen. Zurück aus dem Leser zeigt wieder die untere Navigation und das Kapitel.

npm run build im Frontend ist durchgelaufen. Die Backend-Suite auf der separaten Datenbank tsumugu_local_test: 34 bestanden, 2 Fehler schon beim Aufbau der Paperless-Dateitests wegen verweigertem Zugriff auf C:\Users\lars\AppData\Local\Temp\pytest-of-lars. Das ist diese Windows-Umgebung, kein fachlicher Fehlschlag der neuen Fläche.

Nicht ausgeführt: Ziehen per Drag-and-drop, Pfeiltasten im Leser, Escape zum Schließen. Die Schalter Nach-oben und Nach-unten sowie „Nächste Seite“ sind geprüft.

Während der Prüfung korrigiert: PDF-Vorschauzeilen zeichnen die erste Seite, geschlossene Zeilenmenüs überdecken nicht mehr die nächste Zeile, der Hinzufügen-Schalter auf dem Handy liegt in der Kopfzeile statt über dem Text, die Struktur lässt den letzten Eintrag über der unteren Navigation frei.

Nutzungsrunde

Dieselbe lokale Oberfläche und dasselbe Konto. Vorschlag, etwa 20 Minuten, eine Person klickt, die andere notiert nur Beobachtetes:

  1. Akte Vermietung, Wohnung am Park, Nebenkosten 2025, Belegeinsicht. Wirkt der Weg lang oder klar?
  2. Kapitel Belege, die Abrechnung lesen, eine Seite weiter, schließen. Ist das Kapitel danach noch das richtige?
  3. Eine eigene Notiz anlegen und eine Zeile nach oben oder unten schieben. Seite neu laden.
  4. Auf einem schmalen Fenster oder Handy: Struktur öffnen, Kapitel wählen, lesen, zurück.
  5. Suche nach Heizkosten und den Treffer öffnen. Fehlt dabei die Akte als Handlungskontext?

Keine Wertung vorweg nehmen. Was sich wiederholt, wird Kandidat für eine Regel. Ein einzelner Eindruck bleibt eine Beobachtung.

Kandidaten für Jinkendo-Designregeln

Diese Punkte sind gestaltet, in Tsumugu umgesetzt und in der lokalen Prüfung gesehen. Sie sind nicht alltagsbewährt.

  • Dunkle Markenleiste, warme Arbeitsfläche, Inhalt in Vorschauzeilen, das geöffnete Dokument daneben oder an seiner Stelle.
  • Struktur und Kapitel gehören zum geöffneten Objekt. Die Akte ist Kontext, nicht eine zweite Elternzeile im Pfad.
  • Eine Liste. Der Leser ersetzt sie auf schmalen Breiten und steht daneben, sobald genug Platz da ist.
  • Zurück aus dem Dokument führt ins Kapitel, nicht in eine andere Ebene.
  • Eigene Reihenfolge ist eine gespeicherte Position. Sortieren nach Datum ist eine Ansicht und kein stilles Umsortieren dieser Position.
  • Eine fehlende Vorschau zeigt einen benannten Zustand und einen Öffnungsweg, keine erfundene Seite.