Dokumentiere gemeinsamen Notizinhalt und kontextbezogene Anmerkungen

This commit is contained in:
Lars committed 2026-10-16 12:58:23 +02:00
1 parent 997da92c9b
commit 92e2b5c5fc
1 file changed
+20 -7
+20 -7
View File
@@ -1,6 +1,6 @@
# Tsumugu – Fachliche Produktspezifikation
**Stand:** 16.10.2026 · **Arbeitsstand:** 0.2, Product Recovery und fachliches Interview.
**Stand:** 16.10.2026 · **Arbeitsstand:** 0.3, 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,7 +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).
- 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). Anschließend bestätigt er gemeinsamen Notizinhalt mit kontextbezogenen Anmerkungen (F-01b, jeweils 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.
@@ -24,6 +24,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch
- Eigenständiger MVP; Multiuser- und Familienfähigkeit von Beginn an; eigene persönliche und ausdrücklich gemeinsame Datenräume.
- 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).
- 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.
- 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.
@@ -55,7 +56,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 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. |
| 1 / F-01 | Teilweise geklärt: Aktenrechte, explizite Einschränkungen und kontextbezogene Elementrechte (F-01a); gemeinsamer Notizinhalt mit kontextbezogenen Anmerkungen (F-01b). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Offen bleiben die Ableitung der Bearbeitungsbefugnis (nächste Frage F-01c), weitere 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. |
@@ -84,13 +85,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d
**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
### F-01b – Gemeinsamer Inhalt bei Mehrfacheinbindung: bestätigt am 16.10.2026
Wenn eine Notiz in A und B eingebunden ist, soll eine berechtigte Änderung am Notiztext in beiden Vorgängen sichtbar werden?
**Beschluss:** Der Nutzer folgt ausdrücklich der Empfehlung: Eine in A und B eingebundene Notiz hat einen gemeinsamen Inhalt. Eine berechtigte Änderung am Notiztext ist in beiden Vorgängen sichtbar. Anmerkungen, die ausschließlich zu B gehören, werden separat im Kontext B ergänzt. Es entstehen nicht automatisch unabhängig bearbeitbare Fassungen je Vorgang.
**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.
**Begründung:** Die ursprüngliche Information bleibt konsistent, ohne dass Fassungen verschiedener Vorgänge auseinanderlaufen. Eine Änderung kann mehrere Vorgänge betreffen; diese Reichweite muss beim Bearbeiten deutlich sein, ohne dadurch geschützte andere Vorgänge offenzulegen.
**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.
**Auswirkungen auf das Fachmodell:** Gemeinsamer Notizinhalt und kontextbezogene Anmerkungen sind fachlich getrennt. Das gilt zusätzlich zur bereits beschlossenen kontextbezogenen Berechtigung. Wer den gemeinsamen Inhalt bearbeiten darf, folgt noch nicht aus diesem Beschluss. Für externe Originale und Paperless-Metadaten bleibt F-02 maßgeblich.
**Auswirkungen auf den MVP:** Fachliches Prüfszenario: Eine berechtigte Textänderung der gemeinsamen Notiz wird in A und B angezeigt. Eine nur für B ergänzte Anmerkung erscheint nicht in A. Die Aktenrechte bleiben dabei unverändert; die gemeinsame Notiz eröffnet weiterhin keinen Zugriff auf die jeweils andere Akte.
### F-01c – Bearbeitungsrecht für gemeinsamen Notizinhalt: nächste Frage, offen
Soll das Bearbeitungsrecht einer Akte grundsätzlich auch zum Ändern einer dort eingebundenen gemeinsamen Notiz berechtigen, sofern die Notiz in diesem Kontext nicht ausdrücklich schreibgeschützt ist?
**Vorschlag:** Ja. Die Berechtigung folgt wie beschlossen grundsätzlich der Akte, mit expliziter Einschränkung am Element im jeweiligen Kontext. Wer in B nur lesen darf, erhält kein Änderungsrecht. Wer in B bearbeiten darf und dort nicht eingeschränkt ist, darf den gemeinsamen Notiztext ändern; die Änderung ist gemäß F-01b auch in A sichtbar, ohne Zugriff auf A zu gewähren. Vorteil: einheitliches, alltagstaugliches Rechtemodell; Nachteil: Bearbeiter eines Kontexts können Informationen verändern, die auch in anderen Kontexten verwendet werden.
**Alternative:** Für den gemeinsamen Inhalt ist zusätzlich eine eigene Bearbeitungsfreigabe erforderlich, unabhängig vom Bearbeitungsrecht der Akte. Vorteil: engerer Kreis von Bearbeitern; Nachteil: zusätzlicher Freigabe- und Verwaltungsaufwand. Die Entscheidung betrifft Inhaltsbearbeitung, nicht automatisch Weiterfreigabe, Löschen oder Änderungen an externen Quellen.
## 6. Fortschreibung
@@ -98,4 +109,6 @@ Wenn eine Notiz in A und B eingebunden ist, soll eine berechtigte Änderung am N
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.
16.10.2026, Arbeitsstand 0.3: F-01b durch ausdrückliche Zustimmung zur Empfehlung bestätigt: gemeinsamer Notizinhalt, Änderungen in allen Einbindungen sichtbar, vorgangsspezifische Anmerkungen separat. Nächste Frage F-01c betrifft die Ableitung der Bearbeitungsbefugnis aus Aktenrechten. 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.