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