From 997da92c9bd1ea4c1dfdf932dcc2cea4e2d59402 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 12:56:02 +0200 Subject: [PATCH] Halte kontextbezogene Akten- und Elementrechte fest --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 46 +++++++++++++++++++++------- 1 file changed, 35 insertions(+), 11 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 48b227a..2afdc8e 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.1, Etappe A – Product Recovery. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.2, 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. @@ -8,6 +8,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch ## 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. +- Fachliches Interview vom 16.10.2026 in dieser Session: Nutzer bestätigt aktenbasierte Rechte mit expliziten Einschränkungen und präzisiert kontextbezogene Rechte bei Mehrfacheinbindung (F-01a, Abschnitt 5). - [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. @@ -21,8 +22,9 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. +- Akten und Vorgänge sind logische fachliche Zusammenstellungen. Ein Element kann in mehreren Zusammenstellungen vorkommen; eine einzige physische Ablagehierarchie bestimmt nicht alle Zusammenhänge. Kapitel/Unterakten bleiben vorgesehen; ihre genaue Struktur ist offen. +- Rechte werden grundsätzlich über die Akte vergeben und an deren Inhalte weitergegeben. Einschränkungen werden ausdrücklich gesetzt. Bei Mehrfacheinbindung werden Elementrechte im jeweiligen Kontext bestimmt (F-01a bestätigt). +- 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. - 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. @@ -51,9 +53,9 @@ Zeitangaben stammen aus den gelesenen Nachrichtenmetadaten, dargestellt in Europ 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 | +| Prio / ID | Entscheidungsgegenstand und Status | Einfluss, bestätigter Teil und verbleibende Vorschläge | |---|---|---| -| 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. | +| 1 / F-01 | Teilweise geklärt: Aktenrechte als Grundlage, explizite Einschränkungen und kontextbezogene Elementrechte bei Mehrfacheinbindung bestätigt (F-01a). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Offen bleiben gemeinsamer Inhalt und Änderungen (nächste Frage F-01b), Bearbeitungs-/Freigabebefugnisse, globale Schutzregeln, Unterakten, Datenraumgrenzen, Eigentum, Entzug und Löschung. | | 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. | @@ -61,17 +63,39 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt 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 +## 5. Interviewentscheidungen -**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? +### F-01a – Aktenrechte und kontextbezogene Freigabe: bestätigt am 16.10.2026 -- **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. +**Beschluss:** Der Nutzer bestätigt die Vererbung von Aktenrechten mit expliziten Einschränkungen und präzisiert: Elemente können in mehreren Akten/Vorgängen eingebunden sein; ihre Rechte gelten im jeweiligen Kontext. Vorgänge/Akten bilden unterschiedliche logische Zusammenstellungen und sind nicht auf das physische Papieraktenprinzip beschränkt. -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. +**Bestätigte Regeln und Beispiele:** + +1. Eine innerhalb einer Akte neu angelegte Notiz übernimmt grundsätzlich die Aktenrechte. Abweichende Einschränkungen werden ausdrücklich gesetzt. +2. Dieselbe Notiz kann sowohl in Vorgang A als auch in Vorgang B relevant und eingebunden sein. Ein in B erlaubter Zugriff auf die Notiz gewährt keinen Zugriff auf A oder dessen weitere Inhalte. +3. Die Freigabe im Kontext B ändert nicht automatisch die Berechtigungen des Kontexts A. Bereits private Inhalte werden durch bloßes Referenzieren nicht stillschweigend freigegeben; ihre bewusste Freigabe kann sich auf B beschränken. +4. Akten und Vorgänge benötigen keine exklusive physische Zugehörigkeit jedes Elements. Mehrfacheinbindungen und unterschiedliche Zusammenstellungen gehören zum Fachmodell. + +**Begründung:** Rechte sollen im Alltag auf Aktenebene handhabbar bleiben und zugleich die flexible Wiederverwendung einzelner Informationen ermöglichen, ohne andere Vorgänge offenzulegen. + +**Auswirkungen auf das Fachmodell:** Inhalt/Element, Einbindung in einen Kontext und dessen Berechtigungen müssen fachlich unterscheidbar sein. Ein Modell, das allen Einbindungen eines Elements zwingend dieselben Rechte auferlegt oder aus dem Elementzugriff Aktenzugriff ableitet, erfüllt den Beschluss nicht. Konkrete Tabellen und technische Umsetzung sind nicht festgelegt. + +**Auswirkungen auf den MVP:** Die bestätigten Mehrfachverknüpfungen müssen kontextbezogene Rechte berücksichtigen. Fachliches Prüfszenario: Ein Nutzer mit Zugriff nur auf B kann die dort bewusst freigegebene gemeinsame Notiz lesen; darüber erhält er keinen Zugriff auf A oder andere Inhalte von A. Die genaue Darstellung fremder/gesperrter Verweise bleibt offen. + +**Weiterhin offen:** Schreib-, Lösch- und Freigabebefugnisse; wer eine weitere Einbindung autorisieren darf; globale Schutzregeln; Umgang mit Rechteentzug; Unteraktenvererbung und Datenraumgrenzen; ob Herkunft oder andere Einbindungen angezeigt werden dürfen. Aus der bestätigten Lesesichtbarkeit folgt noch kein Änderungsrecht. + +### F-01b – Gemeinsamer Inhalt bei Mehrfacheinbindung: nächste Frage, offen + +Wenn eine Notiz in A und B eingebunden ist, soll eine berechtigte Änderung am Notiztext in beiden Vorgängen sichtbar werden? + +**Vorschlag:** Ein gemeinsamer Inhalt für dasselbe Element; eine berechtigte Änderung ist in allen Einbindungen sichtbar. Ergänzende Bewertungen oder Kommentare, die nur zu B gehören, werden als eigene kontextbezogene Informationen geführt. Vorteil: ein konsistenter Inhalt ohne auseinanderlaufende Kopien; Nachteil: eine Änderung kann mehrere Vorgänge betreffen und muss in ihrer Reichweite verständlich sein. Wer den gemeinsamen Inhalt ändern darf und wie Änderungen nachvollziehbar bleiben, ist noch gesondert zu bestimmen. + +**Alternative:** Je Vorgang getrennt bearbeitbare Fassungen. Vorteil: unabhängige Entwicklung der Inhalte; Nachteil: unterschiedliche Fassungen desselben Ausgangsinhalts und zusätzlicher Abgleichbedarf. Keine dieser Varianten ist bisher beschlossen. ## 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. +16.10.2026, Arbeitsstand 0.1: Recovery vollständig gelesen, Repository-Unterlagen gezielt abgeglichen, ursprüngliche Nutzernachrichten geprüft und Ergänzungen gesichert. Historische Baseline unverändert übernommen. + +16.10.2026, Arbeitsstand 0.2: F-01a anhand der ausdrücklichen Nutzerantwort bestätigt und präzisiert: Aktenrechte mit expliziten Einschränkungen; Elementrechte bei Mehrfacheinbindung kontextbezogen; kein Zugriff auf andere Akten durch Elementfreigabe. Fachmodell-/MVP-Auswirkungen festgehalten. Nächste Frage F-01b betrifft die Wirkung von Inhaltsänderungen. 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.