Files
tsumugu/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md

13 KiB
Raw Permalink Blame History

Tsumugu – Product Recovery Baseline

Version: 0.1 · Sicherungsdatum: 16.10.2026
Status: Rekonstruierte fachliche Arbeitsgrundlage, keine vollständig verifizierte oder neu freigegebene Spezifikation.
Zweck: Dauerhafte Wissensbasis für den getrennten Tsumugu-Workstream.

1. Quellen und Statuskennzeichnung

Dieses Dokument sichert die in der aktuellen Unterhaltung rekonstruierte ursprüngliche Tsumugu-Produktkonzeption. Die Rekonstruktion stützt sich auf frühere, im Recovery wiedergefundene Tsumugu-Gesprächsaussagen vom 15.10.2026 sowie ergänzend auf die ARCHITECTURE_DISCOVERY.md vom 15.10.2026. Ein vollständiges Originaltranskript ist in dieser Datei nicht enthalten.

  • B – Früher ausdrücklich besprochen/entschieden: im Recovery als konkrete Nutzeraussage wiedergefunden. Wortlaut und Zeitangaben bleiben, falls verfügbar, mit dem Original abzugleichen.
  • R – Rekonstruiert: aus mehreren Aussagen zusammengeführt, nicht als separate Nutzerentscheidung nachgewiesen.
  • D – Discovery-Vorschlag: technisch oder fachlich in der Discovery vorgeschlagen; dort ausdrücklich nicht automatisch als beschlossen gekennzeichnet.
  • O – Offen: keine zuverlässige abschließende Entscheidung rekonstruierbar.

Diese Statuskennzeichen sind Teil der Baseline. Offene Punkte werden nicht stillschweigend durch neue Annahmen ersetzt.

2. Produktvision [B]

Tsumugu (紡ぐ) ist ein universeller Vorgangs- und Informationsmanager, nicht lediglich ein Dokumentenarchiv. Der zentrale Arbeitsgegenstand ist ein Vorgang/eine Akte. Tsumugu verknüpft Dokumente, Informationen, Kommunikation, Beteiligte, Ereignisse, Aufgaben, Fristen und finanzielle Sachverhalte zu einem nachvollziehbaren Zusammenhang.

Die Ausgangsfälle Mietangelegenheiten und Krankenkassenerstattungen dienen der Anforderungsfindung; das Produkt soll ebenso für Versicherungen, Behörden, Verträge und andere länger laufende Sachverhalte nutzbar sein.

Anwendungsfall A: Mietangelegenheiten/Rechtsstreitigkeiten [B]

Ein Vorgang verbindet Schreiben, Gesprächsnotizen, E-Mails, Nachweise, Beteiligte und anwaltliche Kommunikation. Wesentlich sind eine überprüfbare Chronologie sowie Aufgaben und Fristen. Unterschiedliche Zeitpunkte dürfen nicht gleichgesetzt werden: Dokumentdatum, Versand, Zugang und Erfassung sind verschiedene Sachverhalte.

Anwendungsfall B: Krankenkassen-/Erstattungsfälle [B]

Rechnungen, Erstattungsanträge, Sammelabrechnungen, Zahlungen, Bankeingänge und Fälligkeiten gehören in einen gemeinsamen Vorgangskontext. Zuordnungen können mehrdeutig sein: Eine Sammelerstattung kann mehrere Rechnungen betreffen; ein einzelner Zahlungseingang lässt sich nicht immer eindeutig zuordnen. Die manuelle Zuordnung war ausdrücklich Teil der ursprünglichen MVP-Richtung.

3. Fachliches Modell

Konzept Ursprünglicher Zweck Status
Vorgang/Akte Zentraler fachlicher Zusammenhang B
Kapitel/Unterakten Komplexe Vorgänge hierarchisch strukturieren B; genaue Struktur O
Ressourcen Dokumente, E-Mails, Notizen, ggf. Audio und andere Informationen verknüpfen B; Ressourcentypen/Speicherung O
Chronologie Kommunikation und Ereignisse nachvollziehen B; Datenmodell O
Aufgaben und Fristen Tätigkeiten, Verantwortlichkeiten und Fälligkeiten erfassen B; Detailregeln O
Finanzen Rechnungen, Zahlungen, Erstattungen manuell zuordnen B; Betrags- und Korrekturmodell O
Virtuelle Zusammenstellungen Gleiche Information in mehreren Kontexten referenzieren, ohne Kopien B; Freigabesemantik O
Datenräume Private und ausdrücklich gemeinsam genutzte Bereiche B; physisches Modell D/O
Audit Nachvollziehbare Vorgangsänderungen D; Schema O

Das sind fachliche Konzepte, keine bereits bestätigte physische Datenbankstruktur.

4. Paperless-ngx und weitere Ressourcen

Früher festgelegt [B]

  1. Tsumugu soll als eigenständiger MVP entwickelt werden.
  2. Paperless-ngx bleibt das bestehende Dokumentenarchiv für dort gehaltene Dokumentdateien; Tsumugu bildet den Vorgangs- und Beziehungszusammenhang ab.
  3. Tsumugu hält eigene Metadaten, fachliche Beziehungen und Referenzen zu Paperless-Dokumenten. Eine vollständige Dateiduplikation ist nicht automatisch vorgesehen.
  4. Ausgewählte Paperless-Metadaten sollen bidirektional synchronisierbar sein. Diese Entscheidung darf nicht auf eine reine Einweg-Verlinkung reduziert werden.
  5. E-Mails, Notizen und ggf. Audio können unabhängig von Paperless verwaltet werden; sie sind nicht automatisch Paperless-Dokumente.
  6. Der praktische Paperless-Integrationstest sollte zunächst zurückgestellt werden.
  7. Die eigenen Metadaten und Verknüpfungen sollen lokal und geschützt gespeichert sowie später für autorisierte KI-Kontexte aufbereitbar sein.

Technischer Discovery-Vorschlag [D]

Für externe Quellen Referenzen mit Quelle, externer ID und Anzeige-Metadaten vorsehen; Dokumente verbleiben im Quellsystem. Dies allein beschreibt noch nicht die früher gewünschte bidirektionale Metadatensynchronisation.

Offen [O]

Welche Metadaten in welche Richtung synchronisiert werden, das führende System je Feld, Konfliktauflösung, Synchronisationsfrequenz/-auslöser, Rechtekontext und technische Nutzeridentität. Ebenso der Lebenszyklus anderer Ressourcentypen sowie konkrete Datei-/Anhangsspeicherung.

5. Multiuser, Familiennutzung und Rechte

Fachliche Anforderungen [B]

  • Von Beginn an mehrbenutzer- und familienfähig.
  • Private Inhalte bleiben privat, Freigabe erfolgt bewusst.
  • Rechte vorzugsweise auf Vorgangs-/Aktenebene, bei Bedarf differenziert für Unterakten oder einzelne Ressourcen.
  • Virtuelle Ansichten/Mehrfachverknüpfungen dürfen keine ungewollte Offenlegung privater Ressourcen verursachen.

Discovery-Vorschläge [D]

Eigene Datenräume mit Mitgliedschaften und Rollen, getrennt von Objektsichtbarkeit (privat/gemeinsam). Kein direktes Kopieren des Shinkan-Vereinsmodells. Wirksame Nutzeridentität aus der Session; keine Identitätsfestlegung über Client-Header. Neue geschützte Fachendpunkte mit wirksamer Capability-Prüfung (enforce).

Offen [O]

Genauer Verlauf der Vererbung/Überschreibung von Freigaben, externe Dritte/Anwälte, Mitgliedschaftsänderung, Unterakten, einzelne Ressourcen, virtuelle Verweise, Besitzerwechsel und Löschrechte.

6. Chronologie, Aufgaben, Fristen, Finanzen

Chronologie [B]: Schriftverkehr und fachliche Ereignisse im Zusammenhang zeigen. Zeitangaben müssen semantisch unterscheidbar bleiben.

Chronologie-Implementierung [D]: Als Lesemodell aus Fachereignissen und Audit. Audit append-only mit Actor, Datenraum, Aktion, Ressourcentyp, Ressourcen-ID und Zeitpunkt.

Aufgaben [B]: Aufgabenverwaltung zunächst eigenständig in Tsumugu, ohne Kairos komplexere Projekt-/Roadmap-Logik vorauszusetzen. Spätere Kairo-Kopplung bleibt möglich.

Fristen [B/O]: Bestandteil der Vorgangsbearbeitung; genaue Fachregeln zu Fristberechnung, Erinnerungen und Statusübergängen sind nicht vollständig überliefert.

Finanzen [B]: Zunächst manuelle Beziehungen zwischen Rechnungen, Zahlungen, Erstattungen und Vorgängen. Mehrere Rechnungen pro Erstattung bzw. ein nicht eindeutig zugeordneter Bankeingang müssen fachlich berücksichtigt werden. Teilbeträge, Korrekturen, Storno und Rundung sind noch zu spezifizieren.

7. KI und weitere Integration

Gesichert [B]: Tsumugu soll perspektivisch aus berechtigt zugänglichen Vorgangsdaten KI-geeignete Informationspakete erzeugen können. Eine bereits laufende KI-Engine oder ein autonomer Agent ist keine gesicherte MVP-Pflicht.

Discovery [D]: Spätere Kairo-/Agentenanbindung über HTTP-APIs und eingeschränkte datenraumgebundene technische Identitäten; keine gemeinsame Fachdatenbank. Privacy- und Egress-Prüfungen bleiben wichtige technische Grenzen.

Offen [O]: Konkrete KI-Anwendungsfälle, Anbieter, Freigaben, Orchestrierung, Automatisierungsgrad.

8. Rekonstruierter MVP-Rahmen

Die frühere Gesprächsfolge stützt folgende MVP-Richtung [B]:

  1. Eigenständige Akten-/Vorgangsverwaltung.
  2. Private und bewusst gemeinsame Datenräume.
  3. Hierarchische Aktenstruktur sowie Ressourcen- und Mehrfachverknüpfungen.
  4. Chronologische Nachvollziehbarkeit, Aufgaben und Fristen.
  5. Verknüpfung zu Paperless und ausgewählte bidirektionale Metadatensynchronisation.
  6. Manuelle Finanz-/Erstattungszuordnungen.
  7. Datenmodell und Berechtigungsgrenzen, die spätere KI-Funktionen ermöglichen.

Nicht gesichert als Pflicht des ersten MVP [R/O]: Vollautomatischer Bankabgleich, umfassende E-Mail-/Audioimporter, autonomer KI-Agent, Billing, zentraler Workflowdienst, umfangreiche Kairo-Integration.

Dies ist eine rekonstruierte Arbeitsgrenze, keine vollständige priorisierte und endgültig abgenommene Featureliste.

9. Entscheidungs- und Recovery-Log

Die folgenden ungefähren Uhrzeiten vom 15.10.2026 wurden in der vorhergehenden Chat-Rekonstruktion benannt. Mangels vollständig gesicherten Gesprächstranskripts sind sie nicht unabhängig verifizierte Original-Zeitstempel.

Gesprächsphase Rekonstruierte Aussage Einordnung
ca. 05:35 Universeller Vorgangsmanager; bestehende Open-Source-/Paperless-Lösungen prüfen B
ca. 05:48 Eigenständiger MVP, Multiuser, ausgewählte bidirektionale Paperless-Metadaten, manuelle Finanzzuordnung B
ca. 05:57 Privat und gemeinsam, Rechte vor allem am Vorgang, Kapitel/Unterakten, virtuelle Ansichten B
ca. 06:04 Paperless-Dokumente referenzieren; E-Mails/Notizen/ggf. Audio außerhalb möglich B
ca. 06:15 Eigene Metadaten lokal schützen, später KI-Kontextpakete B
ca. 06:25 Paperless-Integrationstest verschieben; Aufgaben zunächst lokal B

Wichtige Abgrenzungen

  • Nicht bloß ein Akten-Frontend für Paperless. [B]
  • Nicht auf Shinkans Vereins-/Sportobjekte festgelegt. [D]
  • Kein ungeschütztes Übernehmen von Mitais Profil-Header-Schema. [D]
  • Keine Kopie von Kairos vollständigem Aufgaben-/Steuerungsmodell als MVP-Pflicht. [B/R]
  • Keine ungeprüfte Umdeutung von Discovery-Vorschlägen zu verbindlichen Produktentscheidungen.

10. Tatsächlich offene fachliche Entscheidungen

Vor verbindlicher Datenmodellimplementierung:

  1. Ressourcentypen, eigenes vs. externes Speichern, Paperless-Feldhoheit.
  2. Rechte-/Sichtbarkeitsvererbung zwischen Datenraum, Akte, Unterakte, Ressource und virtueller Zusammenstellung.
  3. Finanzbeziehungen und Mehrfach-/Teilzuordnungen einschließlich Korrekturen.

Bei der konkreten Produktfunktion: Zeit- und Ereignistypen, Fristberechnung und Erinnerungen, Statusmodelle, MVP-Reihenfolge und Akzeptanzkriterien.

Bei der Paperless-Anbindung: genaue Feldliste, Konfliktlösung, Benutzeridentitäten und Synchronisationsfehler.

Kein zusätzlicher langwieriger Grundsatzreview nötig; blockierende Fachentscheidungen werden gezielt geklärt.

11. Technischer Kontext – nicht Teil der Fachfreigabe

Die vorhandene ARCHITECTURE_DISCOVERY.md vom 15.10.2026 dokumentiert Tsumugu damals als technisches Deployment-Gerüst ohne fertige Fachdomaine. Sie erwähnt getrennte Dev-/Prod-Umgebungen, Docker Compose, FastAPI, React/Vite, PostgreSQL und technische Security-/Deploy-Maßnahmen. Die spätere Jinkendo Technical Reference Architecture ist ein getrennter technischer Workstream.

Technische Architekturvorgaben dürfen bereits bestätigte Tsumugu-Fachentscheidungen nicht stillschweigend ersetzen. Umgekehrt wird eine Tsumugu-Fachentscheidung nicht ohne Prüfung zum allgemeinen Jinkendo-Standard.

12. Übergabe an zwei getrennte Work-Sessions

Tsumugu Product & Development: Dieses Dokument als fachliche Recovery-Baseline übernehmen. Fehlende Anforderungen nur gezielt klären, fachliche Spec und MVP danach fortschreiben. Tsumugu ist der erste reale Anwendungsfall der Jinkendo-Blueprints.

Jinkendo Technical Architecture: Technische Referenzarchitektur, Guardrails und Sicherheits-/Foundation-Blueprints getrennt pflegen. Erkenntnisse aus der Tsumugu-Implementierung können die technischen Blueprints korrigieren, ohne Tsumugus Fachmodell zu verallgemeinern.

Änderungsregel: Diese Recovery-Baseline versioniert behalten. Fachliche Änderungen ausdrücklich dokumentieren; keine stillen Überschreibungen durch neue Architekturberichte.

13. Quellenlage und Einschränkungen

  • Frühere Tsumugu-Unterhaltung vom 15.10.2026, über die bisherige Chat-Rekonstruktion indirekt wiedergegeben, nicht als vollständiges Wortlautprotokoll gesichert.
  • ARCHITECTURE_DISCOVERY.md (15.10.2026), aus der ursprünglichen Tsumugu-Bestandsaufnahme, ausdrücklich mit nicht freigegebenen Vorschlägen.
  • Jinkendo-Architekturberichte Phase 3.1/3.2 nur als technischer Kontext, nicht als Ursprung neuer Tsumugu-Produktanforderungen.

Einschränkung: Das Dokument sichert den wiederherstellbaren fachlichen Kern. Es behauptet ausdrücklich nicht, sämtliche ursprünglichen Details oder Entscheidungen lückenlos wiederhergestellt zu haben.