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>
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.