diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 3c192ab..7ccb52b 100644 --- a/docs/product/TSUMUGU_PRODUCT_SPEC.md +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -1,6 +1,6 @@ # Tsumugu – Fachliche Produktspezifikation -**Stand:** 16.10.2026 · **Arbeitsstand:** 0.6, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.7, Product Recovery und fachliches Interview. **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. @@ -9,6 +9,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Aktueller Nutzerauftrag: eingefügter Text „Tsumugu – Product Recovery, Specification & Development“, 16.10.2026. Bestätigt den universellen Umfang und die stufenweise fachliche Klärung. - Fachliches Interview vom 16.10.2026 in dieser Session: ausdrückliche Bestätigungen zu Aktenrechten und Kontexten (F-01a), gemeinsamem Notizinhalt (F-01b), Bearbeitungsrechten und -orten (F-01c), Entfernen gegenüber Löschen (F-01d) und gesonderter Weiterfreigabeberechtigung bei einfacher Familiennutzung (F-01e); siehe Abschnitt 5. +- Weitere Präzisierung im Interview: Datenraumübergreifende Freigaben gelten allgemein, nicht nur für Familien. Der Anleger besitzt die ursprüngliche Hoheit und kann Rechte einschließlich Lesen, Ändern, Ownership und Löschen vergeben; sowohl auf Element- als auch auf Akten-/Vorgangsebene. Geringe Rechtekomplexität und die Konzeption der fachlichen Strukturbegriffe sind ausdrückliche Vorgaben (F-01f und Strukturvorschlag S-01). - [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. @@ -27,7 +28,8 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Mehrfach eingebundene Notizen haben einen gemeinsamen Inhalt. Berechtigte Änderungen daran sind in allen Einbindungen sichtbar; vorgangsspezifische Anmerkungen werden separat im jeweiligen Kontext geführt (F-01b bestätigt). Daraus folgt noch keine Regel für die Bearbeitung externer Originale oder Paperless-Felder. - Das Bearbeitungsrecht einer Akte berechtigt grundsätzlich auch zur Änderung dort eingebundener gemeinsamer Notizen, sofern sie in diesem Kontext nicht ausdrücklich schreibgeschützt sind. Bei vollständigem Zugriff auf A und B kann der Bearbeiter das gemeinsame Element von jeder Einbindung aus ändern; es gibt keinen exklusiven Bearbeitungsort in einer Ursprungsakte (F-01c bestätigt). - „Aus diesem Vorgang entfernen“ löst nur die jeweilige Einbindung; das gemeinsame Element und seine anderen Einbindungen bleiben erhalten. „Element überall löschen“ ist eine separate Aktion mit gesondert festzulegender Berechtigung (F-01d bestätigt). -- Freigeben für weitere Personen ist eine eigene Berechtigung, getrennt vom Bearbeiten. Sie wird grundsätzlich über die Akte vergeben und kann am Element ausdrücklich eingeschränkt werden. Die Handhabung muss für die private/Familiennutzung einfach bleiben; Einzelregelungen sind seltene Ausnahmen (F-01e bestätigt). +- Freigeben für weitere Personen ist eine eigene Berechtigung, getrennt vom Bearbeiten. Sie wird grundsätzlich über die Akte vergeben und kann am Element ausdrücklich eingeschränkt werden. Die Handhabung muss allgemein einfach bleiben; Einzelregelungen sind Ausnahmen (F-01e/F-01f bestätigt). Familie ist ein Beispiel, keine Grenze des Modells. +- Der Anleger hat die ursprüngliche Hoheit über ein Element und kann gezielt Rechte wie Lesen, Ändern, Ownership und Löschen vergeben. Dasselbe Prinzip gilt auf Akten-/Vorgangsebene. Datenraumübergreifende Einbindung und ausdrückliche Freigabe erfolgen grundsätzlich am selben Element, ohne automatische Kopie oder Eigentumsübertragung (F-01f bestätigt). Konkrete Ownership-Übertragung, mehrere Eigentümer und die genaue Reichweite einzelner Rechte bleiben zu spezifizieren. - Private Inhalte bleiben privat, bis sie bewusst freigegeben werden. Die Freigabe eines Elements in Vorgang B eröffnet weder Zugriff auf Vorgang A, in dem dasselbe Element eingebunden ist, noch auf weitere Inhalte von A. Eine Einschränkung im Kontext A ist nicht automatisch eine globale Sperre für eine ausdrücklich erlaubte Einbindung in B; globale Schutzregeln sind noch zu klären. - 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. @@ -59,7 +61,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt | Prio / ID | Entscheidungsgegenstand und Status | Einfluss, bestätigter Teil und verbleibende Vorschläge | |---|---|---| -| 1 / F-01 | Teilweise geklärt: Aktenrechte mit kontextbezogenen Einschränkungen (F-01a), gemeinsamer Notizinhalt (F-01b), Bearbeitungsrechte/-orte (F-01c), Entfernen gegenüber Löschen (F-01d), getrennte Weiterfreigabeberechtigung bei einfacher Handhabung (F-01e). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Nächste Frage F-01f: gezielte Einbindung zwischen persönlichem und gemeinsamem Datenraum. Offen bleiben konkrete Rollen/Löschbefugnisse, globale Schutzregeln, Unterakten, Eigentum und Rechteentzug. | +| 1 / F-01 | Grundprinzipien geklärt: Aktenrechte und Kontexte (F-01a), gemeinsamer Inhalt (F-01b), Bearbeiten (F-01c), Entfernen/Löschen (F-01d), getrennte Weiterfreigabe (F-01e), allgemeine Datenraumfreigabe und ursprüngliche Hoheit des Anlegers (F-01f). | Auf Nutzerwunsch jetzt fachliche Struktur von Akte, Vorgang/Teilvorgang, Sicht und virtueller Zusammenstellung klären (S-01). Konkrete Rechte-/Ownership-Übergänge, Rollen, Löschbefugnisse und Rechteentzug bleiben offen; keine weitere Detailrunde vor der Strukturklärung. | | 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. | @@ -128,13 +130,36 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Weiterhin offen:** Konkrete Rollen/Standardbelegungen sowie das Zusammenspiel von Freigabebefugnis und Einfügebefugnis im Zielvorgang. Ein umfangreiches konfigurierbares Rollenmodell oder ein zusätzlicher Genehmigungsablauf ist keine aus diesem Beschluss abzuleitende Anforderung. -### F-01f – Einbindung zwischen persönlichen und gemeinsamen Datenräumen: nächste Frage, offen +### F-01f – Allgemeine Datenraumfreigabe und ursprüngliche Hoheit: bestätigt am 16.10.2026 -Soll eine persönliche Notiz gezielt in eine gemeinsame Familienakte eingebunden und dort freigegeben werden können, während ihr gemeinsamer Inhalt dem persönlichen Datenraum zugeordnet bleibt? +**Beschluss:** Der Nutzer bestätigt das Einbinden und Freigeben desselben Elements zwischen persönlichem und gemeinsamem Datenraum und stellt klar, dass dies generell gilt, nicht nur für Familien. Der Inhalt kann dem bisherigen Datenraum zugeordnet bleiben. Eine Freigabe ist keine automatische Kopie, Verschiebung oder Ownership-Übertragung. -**Vorschlag:** Ja, als ausdrücklich freigegebene Einbindung desselben Elements ohne automatische Kopie oder Verschiebung. Die Familie erhält nur die für diesen Kontext freigegebenen Rechte; andere persönliche Inhalte bleiben unzugänglich. Vorteil: konsistente Mehrfachnutzung auch zwischen privaten und gemeinsamen Bereichen; Nachteil: der gemeinsame Zugriff hängt von einer Freigabe über die Datenraumgrenze ab. Lebenszyklus, Entzug und Ausscheiden aus einem gemeinsamen Raum müssen anschließend konkretisiert werden. +**Zusätzliche ausdrückliche Festlegungen:** -**Alternative:** Gemeinsame Nutzung nur innerhalb desselben Datenraums; für die Familienakte müsste der Inhalt bewusst übertragen oder kopiert werden. Das vereinfacht Datenraumgrenzen, schränkt aber die gewünschte Mehrfachnutzung ein. Noch keine Variante beschlossen. +1. Der Anleger hat die ursprüngliche Hoheit am Element. Er kann Rechte zum Lesen, Ändern, Ownership und Löschen vergeben. Die Aufzählung ist keine abschließende Rechte-/Rollenmatrix. +2. Einzelne Elemente können ausdrücklich Sonderrechte erhalten. Dasselbe Prinzip der ursprünglichen Hoheit und Rechtevergabe gilt für Akten/Vorgänge. +3. Aktenbasierte Rechte bleiben der Regelfall, explizite Elementrechte die Ausnahme. Es soll keine extreme Rechtekomplexität entstehen. +4. Akten, Vorgänge, Teilvorgänge, Sichten und virtuelle Zusammenstellungen sollen nun fachlich konzipiert werden. + +**Auswirkungen auf Fachmodell und MVP:** Ersteller, aktuelle Ownership, Rechtevergabe und kontextbezogene Einbindung sind unterscheidbare Sachverhalte. Ein Datenraum oder ein anderer Einbindungskontext übernimmt nicht allein durch die Referenz die Hoheit über das Element. Eine wirksam vergebene Lesefreigabe kann gezielt über eine Datenraumgrenze wirken, ohne die übrigen Inhalte dieses Datenraums zu öffnen. Fachliches Prüfszenario: Der Anleger gibt ein persönliches Element in einem gemeinsamen Kontext nur zum Lesen frei; andere persönliche Inhalte bleiben unzugänglich, die Einbindung gewährt weder Bearbeitungs- noch Ownership- oder Löschrechte. + +**Weiterhin offen:** Ownership übertragen oder gemeinsam vergeben; Rechte nach einer Übertragung; genaue Bedeutung delegierter Lösch-/Freigaberechte und deren Verhältnis zur Aktenvererbung; Entzug und Ausscheiden aus Datenräumen. Aus „Anleger“ wird kein unveränderlicher Eigentümer und aus „Ownership vergeben“ keine bereits entschiedene Anzahl möglicher Eigentümer abgeleitet. Externe Quellsystemrechte bleiben gesondert zu klären. + +### S-01 – Strukturmodell: Vorschlag zur nächsten Interviewfrage, noch nicht beschlossen + +Der Nutzer hat die Strukturklärung ausdrücklich priorisiert. Empfehlung: Akte und Vorgang fachlich unterscheiden, aber gemeinsame Grundfunktionen wie Ressourcenverknüpfung, Berechtigungen und Chronologie vorsehen. Eine Trennung physischer Tabellen, eine verpflichtende Ebene oder ein neuer technischer Architekturaufbau folgt daraus nicht. + +| Begriff | Vorgeschlagene Bedeutung | Beispiel | +|---|---|---| +| Akte | Dauerhafter fachlicher Zusammenhang, in dem Ressourcen und mehrere Vorgänge zusammengehören können. | Mietverhältnis Wohnung X. | +| Vorgang | Konkreter bearbeitbarer Sachverhalt mit eigenem Verlauf und Abschluss. | Betriebskostenabrechnung 2025 oder Kautionsabrechnung. | +| Teilvorgang | Inhaltlich untergeordneter Vorgang mit denselben Grundfähigkeiten wie ein Vorgang; kein separates komplexes Prozessmodell. | Belegeinsicht zur Betriebskostenabrechnung 2025. | +| Sicht | Gespeicherte, dynamische Auswahl vorhandener Inhalte nach Kriterien; erzeugt durch ihre Anzeige allein keine zusätzlichen Rechte. | Alle offenen Fristen über mehrere Akten. | +| Virtuelle Zusammenstellung | Bewusste Auswahl und Anordnung vorhandener Inhalte durch Referenzen; erzeugt durch das Zusammenstellen allein keine zusätzlichen Rechte. | Ausgewählte Unterlagen für ein Anwaltsgespräch. | + +**Nächste einzelne Frage S-01a:** Sollen Akte und Vorgang diese unterschiedlichen fachlichen Bedeutungen haben: Akte als dauerhafter Zusammenhang, Vorgang als konkreter bearbeitbarer Sachverhalt? + +**Empfehlung:** Ja, bei gemeinsam gehaltenen Grundfunktionen. Vorteil: langfristige Zusammenhänge und abschließbare Arbeiten bleiben verständlich unterscheidbar. Nachteil: zwei Begriffe mit unterschiedlicher Bedeutung. Alternative: ein einziger universeller Container, der je nach Nutzung Akte oder Vorgang heißt; weniger Begriffstrennung, dafür weniger klare fachliche Bedeutung. Die Definitionen der übrigen Begriffe, erlaubte Einbindungen, freie Vorgänge ohne Akte, Hierarchietiefe, Unterakten/Kapitel und die Freigabewirkung von Sichten/Zusammenstellungen sind damit noch nicht beschlossen. ## 6. Fortschreibung @@ -150,4 +175,6 @@ Soll eine persönliche Notiz gezielt in eine gemeinsame Familienakte eingebunden 16.10.2026, Arbeitsstand 0.6: F-01e bestätigt: Weiterfreigabe getrennt vom Bearbeiten, grundsätzlich aktenbasiert mit Elementausnahmen. Nutzerbedingung geringer Komplexität für die private/Familiennutzung ausdrücklich aufgenommen. Nächste Frage F-01f betrifft persönliche und gemeinsame Datenräume. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.7: F-01f bestätigt und verallgemeinert: Datenraumfreigabe für alle Nutzungskontexte, ursprüngliche Hoheit des Anlegers, gezielte Rechtevergabe einschließlich Ownership/Löschen auf Element- und Akten-/Vorgangsebene. Geringe Rechtekomplexität bleibt Vorgabe. Auf Nutzerwunsch Strukturvorschlag S-01 mit erster Frage zur Unterscheidung Akte/Vorgang aufgenommen; noch keine Freigabe dieses Vorschlags. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. + 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.