From 7e6371a2f36c41131f851c3f4070ee0567f0a660 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:57:03 +0200 Subject: [PATCH] Bestaetige feldweise Zustaendigkeit bei bidirektionalem Metadatenabgleich --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index da5a8aa..0670f1e 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.14, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.15, 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. @@ -36,7 +36,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. +- Paperless-Dokumente werden referenziert. Ausgewählte Metadaten müssen bidirektional synchronisierbar sein. Je synchronisiertem Feld wird ein fachlich maßgebliches System festgelegt; zulässige Änderungen können weiterhin aus beiden Systemen übernommen werden. Tsumugu hält eigene fachliche Beziehungen und Metadaten. Konkrete Feldliste, Zuordnung und Umfang der Übernahme vorhandener Paperless-Metadaten sind offen (F-02b bestätigt). - Tsumugu kann eigene Dateien und Anhänge dauerhaft geschützt speichern, die nicht in Paperless liegen, und daneben externe Referenzen verwalten. Paperless-Dokumentdateien bleiben dort archiviert und werden referenziert. Eigene Ablage etwa für gespeicherte E-Mails mit Anhängen, Fotos oder später Sprachaufnahmen und externe Verweise etwa auf IMAP sind grundsätzlich möglich (F-02a bestätigt); genaue Ressourcentypen, Importfunktionen und MVP-Lieferumfang bleiben offen. - 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. @@ -67,7 +67,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 | Grundprinzipien F-01a–f und Strukturentscheidungen S-01a–f bestätigt, einschließlich ausdrücklicher Freigabe nachträglich ergänzter Inhalte. Späterer Zugang für einen Anwalt ausdrücklich gewünscht. | Erster Interviewdurchgang abgeschlossen; kein vollständiges Rechte-/Lebenszyklusmodell. Weitere Strukturbeziehungen, dynamische Sichten, externe Zugangsverfahren, konkrete Rechte-/Ownership-Übergänge, Rollen und Rechteentzug bleiben für die Ausarbeitung offen. | -| 2 / F-02 | Jetzt im Interview: eigene Datei-/Anhangsspeicherung neben externen Referenzen bestätigt (F-02a). Paperless bleibt Archiv seiner Dokumente. | Nächste Frage F-02b: feldweise Zuständigkeit bei der bestätigten bidirektionalen Metadatensynchronisation. Konkrete Felder, Konfliktregeln, Quellenlebenszyklus und Rechtekontext anschließend klären. | +| 2 / F-02 | Jetzt im Interview: eigene Datei-/Anhangsspeicherung (F-02a) und feldweise Zuständigkeit bei weiterhin bidirektionaler Metadatensynchronisation (F-02b) bestätigt. Paperless bleibt Archiv seiner Dokumente. | Nächste Frage F-02c: widersprüchliche Änderungen desselben Feldes seit dem letzten Abgleich. Konkrete Felder, Quellenlebenszyklus und Rechtekontext bleiben offen. | | 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. | @@ -222,13 +222,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Weiterhin offen:** Dateiformate, Größen, konkrete Speichertechnik, genaue Ressourcentypen, Importautomatik und MVP-Lieferumfang. Späteres Überführen in Paperless sowie Originale/Arbeitskopien und Verhalten bei Quellenänderung/-löschung bleiben gesondert zu klären. Die Zustimmung zur Speicherfähigkeit ist keine Freigabe sämtlicher Importer oder Audiofunktionen für den MVP. -### F-02b – Feldweise Zuständigkeit bei bidirektionaler Synchronisation: nächste Frage, offen +### F-02b – Feldweise Zuständigkeit bei bidirektionaler Synchronisation: bestätigt am 16.10.2026 -Soll für jedes zwischen Tsumugu und Paperless synchronisierte Metadatenfeld festgelegt werden, welches System dafür fachlich maßgeblich ist, während zulässige Änderungen weiterhin aus beiden Systemen übernommen werden können? +**Beschluss:** Der Nutzer bestätigt: Je synchronisiertem Feld wird festgelegt, welches System fachlich maßgeblich ist. Zulässige Änderungen können weiterhin in beiden Systemen vorgenommen und bidirektional übernommen werden. „Maßgeblich“ bedeutet weder ausschließliches Bearbeiten in diesem System noch automatisches Überschreiben widersprüchlicher Änderungen. -**Vorschlag:** Ja. Dokumentbezogene Metadaten und Tsumugu-eigene Fachinformationen erhalten klar benannte Zuständigkeiten. Die tatsächliche Feldliste und Zuordnung wird anschließend anhand des vorhandenen Paperless-Gebrauchs festgelegt; weder eine pauschale Führung aller Felder durch Paperless noch eine pauschale Führung durch Tsumugu wird vorweggenommen. Änderungen dürfen für die vereinbarten Felder in beiden Systemen möglich bleiben und synchronisiert werden. Die fachliche Zuständigkeit allein ist keine Erlaubnis zum stillen Überschreiben konkurrierender Änderungen; deren Behandlung ist gesondert festzulegen. +**Begründung:** Eine überschaubare Auswahl gemeinsamer Felder mit klarer fachlicher Zuständigkeit erleichtert die Pflege und Interpretation. Dokumentbezogene Angaben könnten bei Paperless, vorgangsbezogene Informationen bei Tsumugu geführt werden; das sind Beispiele, keine beschlossene Feldzuordnung. -**Abwägung:** Klare Feldzuständigkeit erleichtert die Interpretation gleicher Informationen in beiden Systemen und schützt Tsumugu-spezifische Beziehungen/Informationen. Dafür muss die überschaubare Liste tatsächlich geteilter Felder einmal konkret zugeordnet werden. Alternative: beide Systeme für alle geteilten Felder gleichrangig behandeln und die Entscheidung ausschließlich einer allgemeinen Konfliktregel überlassen. Noch keine Variante beschlossen; der bereits bestätigte bidirektionale Abgleich wird durch keine Variante zu einer reinen Einwegverlinkung reduziert. +**Auswirkungen auf Fachmodell und MVP:** Für tatsächlich synchronisierte Felder sind fachliche Zuständigkeit und erlaubte Änderungsrichtungen festzuhalten. Der Abgleich darf durch eine Zuständigkeitszuordnung nicht stillschweigend zur reinen Einwegverlinkung werden. Fachliches Prüfszenario: Eine zulässige Änderung eines vereinbarten gemeinsamen Feldes wird unabhängig davon berücksichtigt, in welchem der beiden Systeme sie vorgenommen wurde; konkurrierende Änderungen werden nicht allein aufgrund der Feldzuständigkeit still überschrieben. + +**Weiterhin offen:** Tatsächliche Feldliste und Zuordnung anhand der bestehenden Paperless-Nutzung, feldspezifische Regeln, Konfliktbehandlung (F-02c), Synchronisationsauslöser und Berechtigungen. + +### F-02c – Widersprüchliche Änderungen beim Metadatenabgleich: nächste Frage, offen + +Sollen unterschiedliche Änderungen desselben Feldes in beiden Systemen seit dem letzten erfolgreichen Abgleich als Konflikt angezeigt werden, den ein berechtigter Nutzer auflöst? + +**Vorschlag:** Ja. Eindeutige, nur auf einer Seite vorgenommene zulässige Änderungen werden gemäß den vereinbarten Feldregeln automatisch abgeglichen. Wenn dasselbe Feld auf beiden Seiten seit dem letzten gemeinsamen Stand unterschiedlich geändert wurde, bleiben beide Werte bis zur bewussten Auswahl erhalten; für dieses Feld wird nicht still überschrieben. Tsumugu zeigt die Abweichung zur Entscheidung an. Gleiche neue Werte sind kein Widerspruch. Vorteil: keine unbeabsichtigt verlorene konkurrierende Änderung; Nachteil: echte Konflikte erfordern eine manuelle Entscheidung. + +**Alternative:** Bei einem Widerspruch automatisch den Wert des je Feld maßgeblichen Systems übernehmen. Das benötigt weniger manuelle Entscheidungen, kann aber eine Änderung im anderen System verwerfen. Noch keine Variante beschlossen. Darstellung, Wiederholungsversuche, Feldtypen und technische Erkennung bleiben für die Ausarbeitung offen. ## 6. Fortschreibung @@ -260,4 +270,6 @@ Soll für jedes zwischen Tsumugu und Paperless synchronisierte Metadatenfeld fes 16.10.2026, Arbeitsstand 0.14: F-02a bestätigt: dauerhafte eigene Datei-/Anhangsspeicherung zusätzlich zu externen Referenzen; Paperless-Dateien bleiben dort archiviert. Konkrete Dateitypen/Importer und MVP-Lieferumfang bleiben offen. Nächste Frage F-02b betrifft die feldweise Zuständigkeit bei bidirektionaler Metadatensynchronisation. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.15: F-02b bestätigt: je synchronisiertem Feld fachlich maßgebliches System festlegen, zulässige Änderungen weiterhin aus beiden Systemen übernehmen. Feldliste/-zuordnung und Konfliktbehandlung bleiben offen. Nächste Frage F-02c betrifft konkurrierende unterschiedliche Änderungen seit dem letzten Abgleich. 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.