diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index b1a6db9..44f7789 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.4, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.5, 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. @@ -26,6 +26,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). - 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). - 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. @@ -57,7 +58,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 mit kontextbezogenen Anmerkungen (F-01b), Bearbeitungsrecht aus der Akte und gleichberechtigte Bearbeitungsorte bei Vollzugriff (F-01c). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Nächste Frage F-01d: Entfernen einer Einbindung gegenüber Löschen des gemeinsamen Elements. Offen bleiben weitere Freigabebefugnisse, globale Schutzregeln, Unterakten, Datenraumgrenzen, Eigentum und Rechteentzug. | +| 1 / F-01 | Teilweise geklärt: Aktenrechte mit kontextbezogenen Einschränkungen (F-01a), gemeinsamer Notizinhalt mit kontextbezogenen Anmerkungen (F-01b), Bearbeitungsrecht und Bearbeitungsorte (F-01c), Entfernen einer Einbindung getrennt vom globalen Löschen (F-01d). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Nächste Frage F-01e: Befugnis zum Weiterfreigeben. Offen bleiben konkrete Löschbefugnisse, globale Schutzregeln, Unterakten, Datenraumgrenzen, Eigentum und Rechteentzug. | | 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. | @@ -108,13 +109,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Abgrenzung:** Weiterfreigabe, globales Löschen und Änderungen an externen Quellen sind nicht automatisch mitentschieden. Ebenso offen ist die Auflösung widersprüchlicher Rechte, etwa Schreibschutz in A bei bestehendem Schreibrecht in B; der bestätigte Vollzugriff auf beide Vorgänge ist kein solcher Konfliktfall. -### F-01d – Einbindung entfernen gegenüber Element löschen: nächste Frage, offen +### F-01d – Einbindung entfernen gegenüber Element löschen: bestätigt am 16.10.2026 -Soll das Entfernen eines mehrfach eingebundenen Elements aus Vorgang B grundsätzlich nur dessen Einbindung in B lösen, sodass der gemeinsame Inhalt in A erhalten bleibt? +**Beschluss:** Der Nutzer bestätigt die Empfehlung: „Aus diesem Vorgang entfernen“ löst nur die Zuordnung im jeweiligen Vorgang. „Element überall löschen“ ist eine eigene Aktion, die den gemeinsamen Inhalt entfernt und eine gesondert festzulegende Berechtigung benötigt. Wird ein gemeinsames Element aus B entfernt, bleiben sein Inhalt und die Einbindung in A erhalten. -**Vorschlag:** Ja. „Aus diesem Vorgang entfernen“ und „Element überall löschen“ sind getrennte Aktionen mit getrennt zu bestimmenden Berechtigungen. Vorteil: Eine lokale Aufräumaktion beeinträchtigt keine anderen Vorgänge. Nachteil: Das Aufräumen der Zusammenstellung und das endgültige Löschen des Inhalts sind zwei unterschiedliche Vorgänge. Die Einordnung der zu B gehörenden Anmerkungen, das Entfernen der letzten Einbindung, Wiederherstellung und globale Löschbefugnisse werden hier noch nicht vorweggenommen. +**Begründung:** Eine Zusammenstellung lässt sich aufräumen, ohne andere Vorgänge zu beeinträchtigen. Die unterschiedliche Reichweite der Aktionen ist in der Bedienung erkennbar zu machen. -**Alternative:** Das Entfernen aus einer Akte kann zugleich das gemeinsame Element in allen Akten löschen. Diese Kopplung ist einfacher als ein einziges Löschkonzept, hat aber Auswirkungen auf sämtliche anderen Einbindungen und wird nicht empfohlen. +**Auswirkungen auf Fachmodell und MVP:** Einbindung und gemeinsamer Inhalt haben getrennte Entfernungs-/Löschaktionen. Fachliches Prüfszenario: Entfernen der Einbindung in B lässt das Element in A unverändert zugänglich. Daraus folgt weder eine konkrete Rolle für globales Löschen noch eine Freigabe zum Löschen externer Originale in Paperless oder anderen Quellen. + +**Weiterhin offen:** Befugnisse für beide Aktionen, Umgang mit der letzten Einbindung und kontextbezogenen Anmerkungen, Wiederherstellung und Lebenszyklus nach globalem Löschen. Diese Regeln sind nicht durch die Trennung der Aktionen mitentschieden. + +### F-01e – Weiterfreigabe gegenüber Bearbeiten: nächste Frage, offen + +Soll das Freigeben eines Elements für weitere Personen eine eigene Berechtigung erfordern, getrennt vom Bearbeiten seines Inhalts? + +**Vorschlag:** Ja. Die Berechtigung „Freigeben“ wird grundsätzlich über die Akte vergeben und kann am Element ausdrücklich eingeschränkt werden. Reiner Lese- oder Bearbeitungszugriff genügt nicht, um den Empfängerkreis durch Einbindung in einen weiteren Vorgang zu erweitern. Vorteil: Mitarbeit an Inhalten eröffnet nicht automatisch die Weitergabe an andere Personen; Nachteil: die Aktenberechtigungen müssen Bearbeiten und Freigeben unterscheiden. Die konkrete Vergabe an Rollen/Personen sowie das Zusammenspiel von Freigabebefugnis im bisherigen Kontext und Einfügebefugnis im Zielvorgang bleiben auszuarbeiten. + +**Alternative:** Wer den Inhalt bearbeiten darf, darf ihn grundsätzlich auch für weitere Personen freigeben. Das reduziert die Anzahl unterschiedlicher Berechtigungen, vergrößert aber zugleich den Kreis der zur Weitergabe befugten Personen. Noch keine Variante beschlossen. ## 6. Fortschreibung @@ -126,4 +137,6 @@ Soll das Entfernen eines mehrfach eingebundenen Elements aus Vorgang B grundsät 16.10.2026, Arbeitsstand 0.4: F-01c bestätigt: Bearbeitungsrecht aus der Akte mit expliziten Einschränkungen; Nutzer ergänzt gleichberechtigte Bearbeitung von jeder Einbindung aus bei vollständigem Zugriff auf beide Vorgänge. Fachmodell und MVP-Prüfszenarien aktualisiert. Nächste Frage F-01d betrifft Entfernen gegenüber Löschen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.5: F-01d durch ausdrückliche Zustimmung bestätigt: Einbindung entfernen und gemeinsames Element global löschen sind getrennte Aktionen; andere Einbindungen bleiben beim lokalen Entfernen erhalten. Konkrete Löschberechtigungen bleiben offen. Nächste Frage F-01e betrifft die Befugnis zum Weiterfreigeben. 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.