diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 2513392..d0f7a10 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.10, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.11, 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. @@ -23,7 +23,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Universeller Vorgangs- und Informationsmanager. Akten bilden dauerhafte fachliche Zusammenhänge, Vorgänge konkrete bearbeitbare Sachverhalte mit eigenem Verlauf und Abschluss. Mietfälle und Erstattungen validieren das Modell, begrenzen es aber nicht (Begriffstrennung S-01a bestätigt). - 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. +- 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 gliedern Inhalte ohne eigenen Status oder eigene Rechte. Unterakten sind eigenständige fachliche Bereiche innerhalb einer Akte und können abweichende Rechte tragen (S-01d bestätigt). - Ein Teilvorgang ist ein untergeordneter Vorgang mit denselben Grundfähigkeiten. Sichten sind gespeicherte dynamische Auswahlen nach Kriterien; virtuelle Zusammenstellungen gezielt ausgewählte und angeordnete Verweise auf vorhandene Inhalte (S-01a bestätigt). Welche Objekte jeweils einbindbar sind und wie die Strukturen zusammenhängen, bleibt zu klären. - Ein Vorgang kann eigenständig bestehen und keiner, einer oder mehreren Akten zugeordnet werden. Es bleibt derselbe Vorgang mit gemeinsamem Bearbeitungsstand; eine führende Akte ist nicht verpflichtend, zusätzliche Zuordnung überträgt keine Ownership (S-01b bestätigt). - Ein Teilvorgang hat genau einen fachlich übergeordneten Vorgang. Derselbe Teilvorgang kann in weiteren Vorgängen referenziert werden, ohne eine zweite fachliche Hauptzuordnung oder Kopie zu erzeugen (S-01c bestätigt). @@ -64,7 +64,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 geklärt: Aktenrechte und Kontexte (F-01a), gemeinsamer Inhalt (F-01b), Bearbeiten (F-01c), Entfernen/Löschen (F-01d), Weiterfreigabe (F-01e), allgemeine Datenraumfreigabe und ursprüngliche Hoheit (F-01f). Strukturbegriffe (S-01a), Vorgänge mit optionaler Mehrfachzuordnung zu Akten (S-01b) und ein fachlicher Elternvorgang je Teilvorgang plus Querverweise (S-01c) bestätigt. | Nächste Frage S-01d: Kapitel als Gliederung gegenüber Unterakten/Teilvorgängen mit eigener fachlicher Bedeutung und Rechten. Weitere Strukturbeziehungen, konkrete Rechte-/Ownership-Übergänge, Rollen und Rechteentzug bleiben offen. | +| 1 / F-01 | Grundprinzipien geklärt: Aktenrechte und Kontexte (F-01a), gemeinsamer Inhalt (F-01b), Bearbeiten (F-01c), Entfernen/Löschen (F-01d), Weiterfreigabe (F-01e), allgemeine Datenraumfreigabe und ursprüngliche Hoheit (F-01f). Strukturbegriffe (S-01a), Vorgangszuordnung (S-01b), Teilvorgangshierarchie (S-01c) und Kapitel gegenüber Unterakten (S-01d) bestätigt. | Nächste Frage S-01e: ausdrückliche Sammelfreigabe ausgewählter Inhalte einer virtuellen Zusammenstellung. Weitere Strukturbeziehungen, konkrete Rechte-/Ownership-Übergänge, Rollen und Rechteentzug bleiben offen. | | 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. | @@ -184,13 +184,21 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Weiterhin offen:** Tiefe der Hierarchie, Verschieben/Verselbstständigen und die Wirkung von Statusänderungen. Aus der Unterordnung folgen keine automatisch beschlossenen Abschlussabhängigkeiten oder komplexen Kairo-Workflows. -### S-01d – Kapitel gegenüber Unterakten: nächste Frage, offen +### S-01d – Kapitel gegenüber Unterakten: bestätigt am 16.10.2026 -Sollen Kapitel reine Gliederungsabschnitte sein und für Bereiche mit eigenen Rechten oder eigener fachlicher Bedeutung Unterakten beziehungsweise Teilvorgänge verwendet werden? +**Beschluss:** Der Nutzer bestätigt: Kapitel dienen der Gliederung, etwa „Schriftverkehr“ und „Nachweise“, ohne eigenen Status oder eigene Rechte. Sonderrechte einzelner Elemente bleiben möglich. Unterakten bilden eigenständige fachliche Bereiche innerhalb einer Akte und können abweichende Rechte erhalten; Teilvorgänge stehen für eigenständig bearbeitbare Sachverhalte innerhalb eines Vorgangs. -**Vorschlag:** Ja. Ein Kapitel ordnet die Darstellung, etwa „Schriftverkehr“ und „Nachweise“, ohne eigenen Status, eigene Ownership oder gesonderte Kapitelrechte. Einschränkungen einzelner Inhalte bleiben gemäß F-01 möglich. Eine Unterakte ist eine Akte innerhalb einer übergeordneten Akte mit denselben fachlichen Grundfähigkeiten und bei Bedarf ausdrücklich abweichenden Rechten; für einen eigenständig bearbeitbaren Sachverhalt wird ein Vorgang/Teilvorgang verwendet. Vorteil: klare Trennung von Darstellung und fachlichen Objekten, keine zusätzliche Rechteebene für Kapitel; Nachteil: Für einen ganzen Abschnitt mit abweichenden Rechten benötigt man eine Unterakte statt eines Kapitels. +**Begründung:** Keine zusätzliche Rechteebene für reine Gliederungsabschnitte. Für einen ganzen Bereich mit abweichenden Rechten wird eine Unterakte verwendet, für einen eigenständig bearbeitbaren Sachverhalt ein Vorgang/Teilvorgang. -**Alternative:** Auch Kapitel sind eigenständig berechtigbare Container. Das ermöglicht Freigaben unmittelbar an beliebigen Abschnitten, fügt aber neben Akten, Vorgängen und Elementausnahmen eine weitere Rechteebene hinzu. Noch keine Variante beschlossen. Unteraktenhierarchie, Kapitel in virtuellen Zusammenstellungen und genaue Bedienung bleiben offen. +**Auswirkungen auf Fachmodell und MVP:** Ein Kapitel erzeugt keine eigene fachliche Status-/Rechteverwaltung; Unterakten und Teilvorgänge nutzen die Grundfähigkeiten ihres jeweiligen Typs. Fachliches Prüfszenario: Gliedern nach Kapiteln verändert keine Inhaltsrechte; Einschränkungen einzelner Elemente bleiben wirksam. Unteraktenhierarchie, Kapitel in virtuellen Zusammenstellungen und die genaue Bedienung bleiben offen. + +### S-01e – Virtuelle Zusammenstellung als gezielt freigegebenes Paket: nächste Frage, offen + +Soll das ausdrückliche Teilen einer virtuellen Zusammenstellung die ausgewählten Inhalte gesammelt zum Lesen freigeben können, ohne Zugriff auf ihre Herkunftsakten zu gewähren? + +**Vorschlag:** Ja. Eine Zusammenstellung wie „Unterlagen für das Anwaltsgespräch“ bündelt ausgewählte Inhalte per Referenz. Beim bewussten Teilen kann die dafür berechtigte Person diese ausgewählten Inhalte gesammelt zum Lesen freigeben; nur Inhalte, für die sie eine entsprechende Freigabebefugnis hat, dürfen so zugänglich werden. Die übrigen Inhalte und Herkunftsakten werden dadurch nicht freigegeben. Vorteil: eine nutzbare Zusammenstellung lässt sich ohne viele einzelne Freigabeaktionen bereitstellen; Nachteil: Zugriff auf die Zusammenstellung und Freigabebefugnis für ihre Inhalte müssen unterschieden werden. + +**Alternative:** Teilen macht ausschließlich die Zusammenstellung sichtbar; fehlende Leserechte müssen separat je Inhalt vergeben werden. Das vereinfacht die Freigabeaktion selbst, kann aber zu für Empfänger nur teilweise lesbaren Zusammenstellungen führen. Noch keine Variante beschlossen. Später hinzugefügte Inhalte, dynamische Sichten, Entzug, Inhalte ohne Freigabebefugnis, Aufnahme ganzer Vorgänge/Akten, externe Gäste und Export/Snapshots sind nicht durch diese Frage entschieden. ## 6. Fortschreibung @@ -214,4 +222,6 @@ Sollen Kapitel reine Gliederungsabschnitte sein und für Bereiche mit eigenen Re 16.10.2026, Arbeitsstand 0.10: S-01c bestätigt: ein fachlicher Elternvorgang je Teilvorgang, zusätzliche Querverweise ohne Kopie. Nächste Frage S-01d grenzt reine Kapitelgliederung von Unterakten/Teilvorgängen ab. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.11: S-01d bestätigt: Kapitel nur Gliederung ohne eigenen Status/Rechte; Unterakten und Teilvorgänge für eigenständige fachliche Bereiche mit möglichen eigenen Rechten. Nächste Frage S-01e betrifft das gezielte Teilen virtueller Zusammenstellungen. 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.