Files
tsumugu/docs/README.md
T
LarsandClaude Sonnet 5.5 037c0724a8
Deploy Development / deploy (push) Successful in 42s
Test Suite / pytest-backend (push) Successful in 3m28s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 20s
Ergänze die Benutzerverwaltung, damit der Betreiber Konten, Rollen und Zugänge verwalten kann.
Der Betreiber legt Konten mit Einmal-Passwort an, deaktiviert und aktiviert sie, setzt Passwörter zurück, beendet Sitzungen und vergibt die Betreiberrolle; der letzte Betreiber und das eigene Konto sind geschützt. Nutzer ändern ihr Passwort und sehen ihre Geräte. Räume kennen neben Mitglied und Verwalter die Rolle Leser, die nichts anlegt und keine Bearbeiten- oder Freigeben-Grants erhält. Verwalter pflegen Mitglieder, Rollen und Einladungen mit Rolle; der Betreiber sieht Räume ohne Inhalte und liest das Verwaltungsprotokoll. Die Login-Begrenzung steht in der Datenbank, unbekannte Konten laufen durch einen Zeitausgleich.

Die lokale Suite läuft mit 116 Tests grün, der Frontend-Build und 16 Node-Tests ebenfalls. Die Oberfläche wurde noch nicht im Browser bedient.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-20 12:49:23 +02:00

8.7 KiB
Raw Blame History

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