Files
tsumugu/docs
LarsandClaude Sonnet 5.5 5f60e1fe40
Deploy Development / deploy (push) Successful in 39s
Test Suite / pytest-backend (push) Successful in 5m24s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 21s
Vereine Ablage, Akte und Vorgang in einem Navigationsbaum mit Fokus und Nachladen.
Der Baum Meine Ablage steht jetzt auch auf den Seiten von Akte und Vorgang und ersetzt die Spalte Struktur. Ein Klick öffnet den Eintrag und klappt seine Struktur auf: Überblick, Kapitel und Unterkapitel, Unterakten, Vorgänge und Teilvorgänge. Der Pfad bleibt offen, die aktuelle Zeile ist hervorgehoben und nach dem Neuladen stimmt der Fokus wieder. Ein Vorgang steht unter jeder Akte, in der er liegt, und unter Vorgänge; ein Klick unter einer Akte öffnet ihn in diesem Aktenkontext. So wechselt man direkt von Vorgang zu Vorgang. Kapitel anlegen und verschieben geht im Baum.

Die Struktur eines Knotens kommt aus neuen schlanken Endpunkten (cases und matters outline), die nur Lesbares liefern, und wird beim Aufklappen einmal nachgeladen. Die Zweispaltenansicht mit dem Lesebereich beginnt erst, wenn neben dem Baum genug Platz bleibt.

Im Browser gegen die lokale Umgebung durchgespielt (Akte, Vorgang unter der Akte, Wechsel zwischen Vorgängen, Kapitel anlegen, Neuladen, Vorgang ohne Akte, Handy, Hell und Dunkel). Die Backend-Suite läuft mit 149 Tests grün, der Frontend-Build und 37 Node-Tests ebenfalls.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 12:11:36 +02:00
..

Tsumugu – Dokumentation

Übersicht aller Dokumente im Repository. Verbindlichkeit laut AGENTS.md: Fachlich führend ist die Produktspezifikation, technisch der Entwurf in architecture/. Vorläufige Rechte- und Löschregeln stehen in den MVP-Annahmen.

Einstieg

Ich will … Dokument
wissen, was Tsumugu ist und wo es läuft ../README.md
lokal entwickeln und testen ENTWICKLUNG_UND_TESTS.md
deployen und Ports nachschlagen DEPLOYMENT.md
den fachlichen Stand und offene Entscheidungen kennen product/TSUMUGU_PRODUCT_SPEC.md
den aktuellen Qualitätsstand und offene Mängel sehen review/README.md

Produkt (product/)

Dokument Rolle Stand
TSUMUGU_PRODUCT_SPEC.md führende Fachspezifikation, alle bestätigten Entscheidungen F-01 bis F-08, S-01 0.37
TSUMUGU_UX_MVP_ERGAENZUNG.md Bedienung, Orientierung, Abnahmekriterien UX-01 bis UX-21 0.8
TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md Auftrag F-06f, hat Vorrang vor älteren Darstellungsvorgaben 1.0
TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md Auftrag F-06e 1.2
TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md Auftrag F-06c, Typ-Symbole und Logo-Rahmen 17.10.2026
TSUMUGU_ENSO_ANIMATION_AUFTRAG.md Einbindung der Ensō-Animation 17.10.2026
TSUMUGU_EXPORT_NAECHSTE_LIEFERUNG_2026-10-17.md Auftrag F-07a–c, Übergabepaket 17.10.2026
TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md Prüfbericht der Exportlieferung 17.10.2026
TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md Auftrag F-08a 17.10.2026
TSUMUGU_UNTERKAPITEL_PRUEFBERICHT_2026-10-17.md Prüfbericht Unterkapitel 17.10.2026
TSUMUGU_CONNECTOREN_BEFUND_2026-10-17.md Bestandsanalyse Paperless/IMAP, Umbauschätzung 17.10.2026
TSUMUGU_CONNECTOR_UMBAU_AUFTRAG_2026-10-19.md begrenzter Umsetzungsauftrag, Abschnitt A beauftragt, Abschnitt B der nächste Ausbau 19.10.2026
TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md Abschlusskriterien der Kapselung; Vorrang vor einem teilweise integrierten Zwischenstand 19.10.2026
TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md Kriterium, Nachweis und Ergebnis der Kapselung 19.10.2026
TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md Nacharbeit: IMAP-Seiten, Paperless-Suche, Markdown-Notiz 19.10.2026
TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md Korrektur K1–K7: IMAP-Ordner, MIME, Transaktion, Markdown, Leser, Paperless-Antworten 20.10.2026
TSUMUGU_IMAP_SENT_ITEMS_MIME_BEFUND_UND_FIXAUFTRAG_2026-10-20.md Befund zu Sent Items und MIME, unverändert übernommen 20.10.2026
TSUMUGU_RELEASE_GATE_BACKUP_AUFTRAG_2026-10-22.md Auftrag P7: Release-Gate, Backup und Restore vor Produktion (R-21), für eine eigene Sitzung 22.10.2026
TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md Review der Nacharbeit, unverändert übernommen 20.10.2026
TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md früherer Zwischenstand von Abschnitt A vor den Abschlusskriterien 19.10.2026
TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md Einstieg für die fachliche Weiterplanung 17.10.2026
TECHNICAL_SPEC_HANDOFF.md historischer Auftrag zur technischen Spezifikation 16.10.2026
Tsumugu_Product_Recovery_Baseline_v0.1.md unveränderte historische Ausgangsbasis 0.1

Architektur (architecture/)

Dokument Rolle Stand
TSUMUGU_TECHNICAL_SPEC.md technischer Entwurf (Soll): Pakete, Datenmodell, Rechte, API, Nachweise 0.3 mit Ergänzungen
API_REFERENZ.md tatsächlich registrierte Endpunkte (Ist) 19.10.2026
DATENMODELL_IST.md Schema nach allen Migrationen (Ist) 19.10.2026
RECHTEMODELL_IST.md implementierte Rechteauswertung (Ist) 19.10.2026
BENUTZERVERWALTUNG.md Konten, Rollen, Einmal-Passwort, Einladungen, Audit (Ist) und Abgrenzung zum Sicherheitskonzept 20.10.2026
ARCHITECTURE_DISCOVERY.md Ist-Aufnahme der Jinkendo-Familie vor Tsumugu, keine Beschlüsse 15.10.2026
TSUMUGU_CONNECTOR_STORAGE_VERTRAG_v0.1_2026-10-19.md Umsetzungsvorschlag Source- und Storage-Vertrag 19.10.2026
Tsumugu_Connector_Suite_Architektur_v0.2.md Zielarchitektur der Connector Suite, keine pauschale Beschlussübernahme 19.10.2026
TSUMUGU_STORAGE_SCHLUESSEL_PRUEFAUFTRAG_2026-10-19.md vorbereiteter Prüfauftrag an die Architektur-Session, nicht versandt 19.10.2026

Design (design/)

Dokument Rolle Stand
LIEFERUNG_2026-10-17.md Lieferbericht der Arbeitsfläche, bewusste Abweichungen 17.10.2026, historisch

Das ausgewählte Designkonzept und die Assetpakete liegen außerhalb des Repositorys unter C:/Dev/jinkendo-app-design-2026-10-17/. Die übernommenen Assets stehen in frontend/public/brand/ und frontend/public/ui/.

Referenz (reference/)

Familienweite Vorgaben der Jinkendo-Anwendungen. Verbindliche Verträge und anpassbare Defaults sind dort jeweils getrennt.

Dokument Geltung für Tsumugu
A – Technische Referenzarchitektur v0.3 verbindlich
B – Implementation Blueprint Foundation v0.3 verbindlich
C – Technische Entscheidungen v0.3 verbindlich
Auth, Session & Scope verbindlich
Medien, Dateien & sicheres Rendering verbindlich
Release, Betrieb & Recovery verbindlich vor echtem Betrieb (Paket P7)
KI-Gateway, Prompt/Workflow, Entitlements nur als Grenze; keine MVP-Pflicht

Die Links innerhalb der Referenzdokumente zeigen auf die ursprünglichen Ablageorte unter C:/Dev/… und funktionieren im Repository nicht.

Betrieb und Regeln

Dokument Rolle
DEPLOYMENT.md Umgebungen, Ports, Workflows, Proxy, bekannte Betriebsgrenzen
MVP_ANNAHMEN.md vorläufige Rechte- und Löschregeln, Cookie-Abweichung in Development
ENTWICKLUNG_UND_TESTS.md Konfiguration, lokaler Start, Tests, neue Migration und Route

Review (review/)

Dokument Inhalt
review/README.md Code-Review vom 18.10.2026: Gesamtbewertung, Anforderungsabdeckung, Befunde, Maßnahmenplan

Pflege

  • Neue Fachentscheidung → Produktspezifikation (Abschnitt 5 und Fortschreibung).
  • Neue Route, Migration oder Rechteregel → die passende Ist-Datei in architecture/ im selben Commit.
  • Neuer Auftrag oder Prüfbericht → product/, hier in der Tabelle eintragen.