From c9031ed572e3d70264ffb4deb05716bdb7c33b6c Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 12:31:58 +0200 Subject: [PATCH] Sichere Tsumugu-Produktbaseline und fachlichen Recovery-Stand --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 77 ++++++++ .../Tsumugu_Product_Recovery_Baseline_v0.1.md | 176 ++++++++++++++++++ 2 files changed, 253 insertions(+) create mode 100644 docs/product/TSUMUGU_PRODUCT_SPEC.md create mode 100644 docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md new file mode 100644 index 0000000..48b227a --- /dev/null +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -0,0 +1,77 @@ +# Tsumugu – Fachliche Produktspezifikation + +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.1, Etappe A – Product Recovery. +**Status:** Führende fachliche Arbeitsdatei; noch keine freigegebene Gesamtspezifikation. + +Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das nächste Interview. Sie nimmt keine offenen Produktentscheidungen vorweg. Datenmodell, konkrete Workflows, MVP-Abnahmebedingungen und Implementierungsaufträge werden nach den jeweiligen Entscheidungen hier ergänzt. Anwendungscode, Datenbanken und Deployments sind nicht Gegenstand dieser Etappe. + +## 1. Quellen und Verbindlichkeit + +- Aktueller Nutzerauftrag: eingefügter Text „Tsumugu – Product Recovery, Specification & Development“, 16.10.2026. Bestätigt den universellen Umfang und die stufenweise fachliche Klärung. +- [Recovery-Baseline v0.1](Tsumugu_Product_Recovery_Baseline_v0.1.md): unveränderte historische Kopie der bereitgestellten Datei. B/R/D/O bleiben dort in ihrer ursprünglichen Bedeutung erhalten. +- Originalchat **„Paperless Vorgangsverwaltung“**, ID `6ad06138-1b60-83eb-9b84-21037ddb3604`: ursprüngliche Nutzernachrichten vom 15.10.2026 wurden gezielt gelesen. Frühere Assistentenantworten waren über die verfügbare Chat-Lesefunktion nur als Inhaltsverweise zugänglich; deren konkrete Vorschläge und etwaige nur darauf bezogene Zustimmungen sind damit nicht vollständig verifiziert. +- [README](../../README.md), [Deployment](../DEPLOYMENT.md), [Architecture Discovery](../architecture/ARCHITECTURE_DISCOVERY.md): vollständig gelesen. Die Discovery erklärt ausdrücklich, dass ihr die Fachspezifikation nicht vorlag und ihre Vorschläge keine Beschlüsse sind. +- `backend/main.py` und `frontend/index.html`: gezielter Abgleich bestätigt Health-Endpunkt und Platzhalteroberfläche. Keine implementierte Fachdomaine in diesen Dateien. Keine neue Architekturinventur und keine Prüfung laufender Systeme. + +**Kennzeichnung in dieser Datei:** Bestätigt = aktueller Nutzerauftrag oder direkt lesbare ursprüngliche Nutzeraussage; Rekonstruktion = nur durch Recovery belegt; Vorschlag = neue Empfehlung ohne Freigabe; Offen = noch zu entscheiden. Technische Discovery-Vorschläge werden nicht zu Fachanforderungen erhoben. + +## 2. Gesicherter fachlicher Kern + +**Bestätigt durch aktuellen Auftrag und/oder ursprüngliche Nutzeraussagen:** + +- Universeller Vorgangs- und Informationsmanager. Akte/Vorgang ist der zentrale Zusammenhang; Mietfälle und Erstattungen validieren das Modell, begrenzen es aber nicht. +- Eigenständiger MVP; Multiuser- und Familienfähigkeit von Beginn an; eigene persönliche und ausdrücklich gemeinsame Datenräume. +- Akten, Kapitel/Unterakten und virtuelle Zusammenstellungen mit Mehrfachverknüpfungen; konkrete Struktur und Rechtewirkung offen. Der aktuelle Auftrag bestätigt diese Konzepte; im Original war ihre Ausgestaltung noch Gegenstand von Überlegungen. +- Private Inhalte bleiben privat; bewusste Freigabe vorwiegend am Vorgang, bei Bedarf auch an Unterakten und einzelnen Ressourcen. Eine Referenz darf keine unbeabsichtigte Offenlegung erzeugen. +- Paperless-Dokumente werden referenziert. Ausgewählte Metadaten müssen bidirektional synchronisierbar sein. Tsumugu hält eigene fachliche Beziehungen und Metadaten; Feldhoheit und Umfang der Übernahme vorhandener Paperless-Metadaten sind offen. +- Gesprächsnotizen, E-Mails und gegebenenfalls Sprachaufnahmen sind mögliche Ressourcen außerhalb von Paperless. Eigene Ablage und externe Referenz, etwa auf IMAP, sind noch keine entschiedenen Speicherverfahren. +- Chronologische Kommunikation, Ereignisse, Aufgaben und Fristen. Dokumentdatum, Versand, Zugang und Erfassung bleiben semantisch getrennt; diese ausdrückliche Trennung ist im aktuellen Auftrag über die übernommene Baseline abgesichert, im direkt lesbaren Original nur teilweise aus dem Anwendungsfall belegbar. +- Aufgaben zunächst in Tsumugu; keine Übernahme der komplexen Kairo-Projektsteuerung. Später sollen Aufgaben auch in Kairo angelegt und verfolgt werden können. +- Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. +- Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. + +## 3. Ergebnisse des Originalabgleichs + +Zeitangaben stammen aus den gelesenen Nachrichtenmetadaten, dargestellt in Europe/Berlin. Die ungefähren Uhrzeiten der historischen Baseline werden nicht überschrieben. + +| Quelle: 15.10.2026, Nachricht-ID | Befund und Bedeutung | +|---|---| +| 07:35 · `4a69ee78-d353-4a68-972e-3a47111a84d4` | Gesetzliche und von Parteien gesetzte Fristen, Verlängerungsbedarf bei ausstehender Erstattung und bereits in Paperless gepflegte Beträge, Zahlungsziele und Status sind konkrete Ausgangsanforderungen. Daraus folgt noch keine automatische juristische Fristberechnung. Die Formulierung zum Zahlungsempfänger ist uneindeutig; im späteren Finanzinterview klären. | +| 07:48 · `6e642bda-5aca-4640-a33f-4763311a55e9` | Bidirektionale ausgewählte Paperless-Metadaten, Multiuser/Familie und manuelle Finanzzuordnung ausdrücklich bestätigt. Keine erneute Grundsatzentscheidung hierzu nötig. | +| 07:57 · `06b19ef2-3da6-4551-b75e-681319e22e0b` | Persönliche und gemeinsame Datenräume ausdrücklich gewünscht; Vorgangsebene bevorzugt, Ausnahmen an Dokumenten/manuellen Einträgen vorgesehen. Kapitel und virtuelle Strukturen angesprochen; konkrete Hierarchie und Vererbung unentschieden. | +| 08:04 · `3fc54616-90c2-4bda-915a-9bb8ed4b41c5` | Ein umfassend berechtigter Paperless-API-Nutzer oder mehrere nutzerbezogene Schlüssel sind ausdrücklich Alternativen, keine getroffene Auswahl. Referenzieren und tatsächlicher Dokumentzugriff müssen bei der Spezifikation unterschieden werden. | +| 08:15 · `6f4ca874-6405-4ebd-ab1c-050f800f2e04` | Eigene Metadaten gewünscht; ausschließliche Paperless-Haltung bestimmter bereits vorhandener Metadaten bei hinreichendem Zugriff als Möglichkeit erwähnt. Kein Widerruf der zuvor verlangten bidirektionalen Synchronisierbarkeit. Nicht jedes Paperless-Feld muss automatisch lokal gespiegelt werden. | +| 08:25 · `1ff6e6fc-485f-4a09-ae0c-39175c2cc3b7` | Praktischen Paperless-Test zurückstellen; Aufgaben zunächst lokal, spätere Kairo-Anbindung ausdrücklich gewünscht. „Bleibt möglich“ in der Baseline beschreibt diesen Zukunftswunsch zu schwach. | +| 08:30 · `be0d32a8-99ca-418c-b7df-bf646e6ef613` | Portalbeschaffung und automatische Vorgangszuordnung gewünscht, komplexe Kairo-Steuerung hier nicht benötigt. Verbindlicher MVP-Umfang der Beschaffung/Automatik nicht nachgewiesen. | +| 09:14 · `7cadc3c0-20e5-4bc4-afe4-4a6148a81040` | Spätere automatische Zuordnungen sollen manuell prüfbar und änderbar bleiben. Lernendes System als Wunsch; kein freigegebener Lernmechanismus und keine gesicherte MVP-Pflicht. Das Ziel der manuellen Korrigierbarkeit fehlt in der Baseline. | + +**Bewertung:** Die Recovery-Baseline ist als fachlicher Kern belastbar und intern weitgehend konsistent. Sie ist kein implementierbares vollständiges Fachmodell. Die wichtigsten ausdrücklichen Produktentscheidungen sind nun direkt am Original belegt. Lücken betreffen überwiegend die genaue Semantik und Abgrenzung; Assistentenvorschläge im ursprünglichen Verlauf bleiben nur teilweise rekonstruierbar. + +## 4. Priorisierte offene Grundsatzentscheidungen + +Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkte sind Klärungsfelder, keine fünf gebündelt zu beantwortenden Fragebögen. Pro Schritt wird nur eine konkrete Entscheidungsfrage gestellt. + +| Prio / ID | Offener Entscheidungsgegenstand | Einfluss und vorgeschlagene Richtung – noch nicht beschlossen | +|---|---|---| +| 1 / F-01 | Zusammenspiel von Datenraum, Aktenhierarchie, Ressourcenrechten und Mehrfachverweisen: Vererbung, Ausnahmen und Freigabe über Datenraumgrenzen. | Bestimmt die Grenzen des Fachmodells. Vorschlag zum Einstieg: Neu innerhalb einer Akte angelegte Inhalte übernehmen deren Rechte, explizite Einschränkungen sind möglich. Eine schon private Ressource wird durch bloßes Referenzieren nicht freigegeben. Eigentum, Rechteänderung, Entzug, Löschung und externe Beteiligte anschließend konkretisieren. | +| 2 / F-02 | Datenhoheit und Lebenszyklus je Ressourcentyp; darunter Paperless-Feldhoheit, Synchronisationskonflikte und Zugriff im Nutzerkontext. | Bestimmt Speicherung, Verfügbarkeit und Änderbarkeit. Vorschlag: Paperless bleibt Dateiarchiv seiner Dokumente; Tsumugu führt seine Beziehungen und Fachinformationen. Überlappende Metadaten feldweise festlegen. Eigene Notizen und externe Referenzen benötigen ausdrückliche Regeln bei Änderung/Löschung der Quelle. API-Schlüsselmodell nicht vorwegnehmen. | +| 3 / F-03 | Bedeutung der Finanzbeziehungen und Status: beantragt, bewilligt, eingegangen, bezahlt; Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen. | Verhindert falsche Offensummen und Vermischung von Zusage und Zahlung. Vorschlag: Beträge manuell und nachvollziehbar zuordnen, unklare Beträge unzugeordnet lassen; keine erzwungene Eindeutigkeit oder automatische Buchhaltung. Umfang der Korrekturregeln gemeinsam festlegen. | +| 4 / F-04 | Fachliche Chronologie und Fristen: Ereignistypen, belegte/unsichere Zeitangaben, Bezug zu Aufgaben, Verlängerungen und Erinnerungen. | Bestimmt, ob die beiden Ausgangsfälle praktisch bearbeitbar sind. Vorschlag: Fachereignisse von technischen Änderungen unterscheiden; Fristursprung und Änderungen erfassen. Automatische Rechtsfristberechnung nicht ohne gesonderte Entscheidung annehmen. | +| 5 / F-05 | Erster nutzbarer MVP-Durchstich und anschließende Ausbaureihenfolge innerhalb des bestätigten Rahmens. | Legt Fertigkriterien fest und verhindert eine Überladung. Vorschlag: Zuerst einen vollständigen manuellen Ablauf vom Ressourceneingang über Zuordnung bis zum Abschluss validieren und am zweiten Anwendungsfall gegenprüfen. Bereits bestätigte MVP-Bestandteile nicht stillschweigend streichen; Portalautomatik, KI, Importer und Kairo-Kopplung gesondert zeitlich einordnen. | + +Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei diesen Klärungen ergänzt. Zielgruppen über die belegte persönliche/Familiennutzung hinaus, externe Zusammenarbeit und messbare nichtfunktionale Anforderungen sind noch auszuarbeiten; sie begründen derzeit keine weitere vorgeschaltete Grundsatzrunde. + +## 5. Erste Interviewentscheidung – offen + +**F-01a:** Soll eine freigegebene Akte neu darin angelegten Inhalten standardmäßig ihre Rechte mitgeben, mit gezielten privaten Ausnahmen und separater ausdrücklicher Freigabe bereits privater, nur verknüpfter Ressourcen? + +- **Vorschlag A:** Ja. Beispiel: Eine neue Notiz in der gemeinsamen Familienakte ist für deren berechtigte Mitglieder sichtbar. Ein aus einer privaten Akte verknüpftes Arztdokument wird erst nach ausdrücklicher Freigabe sichtbar. Vorteil: geringer Freigabeaufwand im Alltag; Nachteil: Ausnahmen und ihre Wirkung müssen klar erkennbar sein. +- **Alternative B:** Jede neue Ressource ist zunächst separat privat und muss einzeln freigegeben werden, auch innerhalb gemeinsamer Akten. Vorteil: bewusste Einzelkontrolle; Nachteil: hoher Pflegeaufwand und leichter unvollständige gemeinsame Akten. + +Beide Varianten müssen unbeabsichtigte Offenlegung durch Referenzen verhindern. Ob und welche eingeschränkten Verweise überhaupt angezeigt werden, ist noch nicht festgelegt. Eine Antwort auf F-01a entscheidet nicht automatisch Eigentum, Datenraumwechsel oder alle Rechteausnahmen. + +## 6. Fortschreibung + +16.10.2026: Recovery vollständig gelesen, Repository-Unterlagen gezielt abgeglichen, ursprüngliche Nutzernachrichten geprüft und Ergänzungen gesichert. Historische Baseline unverändert übernommen. Noch keine neue fachliche Entscheidung getroffen. Nächster Schritt: Antwort auf F-01a einarbeiten und den nächsten tatsächlich offenen Teil gezielt klären. + +Nach jeder Entscheidung diese Datei mit kurzer Begründung und Auswirkungen auf Fachmodell/MVP aktualisieren. Die historische Baseline bleibt unverändert. Keine Implementierung ohne ausdrückliche Freigabe; technische Umsetzung später anhand der dann freigegebenen Jinkendo-Blueprints. diff --git a/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md b/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md new file mode 100644 index 0000000..c60a72b --- /dev/null +++ b/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md @@ -0,0 +1,176 @@ +# 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.