Die gemeinsame Suchroute kennt keine Filternamen mehr; das Modul deklariert sie und unbekannte Parameter werden abgewiesen. Unvollständige Zusatzfeld-Zeilen werden gemeldet statt weggelassen. Vorschaubilder nur als Rastergrafik. Abschlussmatrix und API-Referenz nachgeführt. 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.