From c9031ed572e3d70264ffb4deb05716bdb7c33b6c Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 12:31:58 +0200 Subject: [PATCH 01/58] Sichere Tsumugu-Produktbaseline und fachlichen Recovery-Stand --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 77 ++++++++ .../Tsumugu_Product_Recovery_Baseline_v0.1.md | 176 ++++++++++++++++++ 2 files changed, 253 insertions(+) create mode 100644 docs/product/TSUMUGU_PRODUCT_SPEC.md create mode 100644 docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md new file mode 100644 index 0000000..48b227a --- /dev/null +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -0,0 +1,77 @@ +# Tsumugu – Fachliche Produktspezifikation + +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.1, Etappe A – Product Recovery. +**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. + +## 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. +- [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. +- `backend/main.py` und `frontend/index.html`: gezielter Abgleich bestätigt Health-Endpunkt und Platzhalteroberfläche. Keine implementierte Fachdomaine in diesen Dateien. Keine neue Architekturinventur und keine Prüfung laufender Systeme. + +**Kennzeichnung in dieser Datei:** Bestätigt = aktueller Nutzerauftrag oder direkt lesbare ursprüngliche Nutzeraussage; Rekonstruktion = nur durch Recovery belegt; Vorschlag = neue Empfehlung ohne Freigabe; Offen = noch zu entscheiden. Technische Discovery-Vorschläge werden nicht zu Fachanforderungen erhoben. + +## 2. Gesicherter fachlicher Kern + +**Bestätigt durch aktuellen Auftrag und/oder ursprüngliche Nutzeraussagen:** + +- 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. +- 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. +- Aufgaben zunächst in Tsumugu; keine Übernahme der komplexen Kairo-Projektsteuerung. Später sollen Aufgaben auch in Kairo angelegt und verfolgt werden können. +- Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. +- Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. + +## 3. Ergebnisse des Originalabgleichs + +Zeitangaben stammen aus den gelesenen Nachrichtenmetadaten, dargestellt in Europe/Berlin. Die ungefähren Uhrzeiten der historischen Baseline werden nicht überschrieben. + +| Quelle: 15.10.2026, Nachricht-ID | Befund und Bedeutung | +|---|---| +| 07:35 · `4a69ee78-d353-4a68-972e-3a47111a84d4` | Gesetzliche und von Parteien gesetzte Fristen, Verlängerungsbedarf bei ausstehender Erstattung und bereits in Paperless gepflegte Beträge, Zahlungsziele und Status sind konkrete Ausgangsanforderungen. Daraus folgt noch keine automatische juristische Fristberechnung. Die Formulierung zum Zahlungsempfänger ist uneindeutig; im späteren Finanzinterview klären. | +| 07:48 · `6e642bda-5aca-4640-a33f-4763311a55e9` | Bidirektionale ausgewählte Paperless-Metadaten, Multiuser/Familie und manuelle Finanzzuordnung ausdrücklich bestätigt. Keine erneute Grundsatzentscheidung hierzu nötig. | +| 07:57 · `06b19ef2-3da6-4551-b75e-681319e22e0b` | Persönliche und gemeinsame Datenräume ausdrücklich gewünscht; Vorgangsebene bevorzugt, Ausnahmen an Dokumenten/manuellen Einträgen vorgesehen. Kapitel und virtuelle Strukturen angesprochen; konkrete Hierarchie und Vererbung unentschieden. | +| 08:04 · `3fc54616-90c2-4bda-915a-9bb8ed4b41c5` | Ein umfassend berechtigter Paperless-API-Nutzer oder mehrere nutzerbezogene Schlüssel sind ausdrücklich Alternativen, keine getroffene Auswahl. Referenzieren und tatsächlicher Dokumentzugriff müssen bei der Spezifikation unterschieden werden. | +| 08:15 · `6f4ca874-6405-4ebd-ab1c-050f800f2e04` | Eigene Metadaten gewünscht; ausschließliche Paperless-Haltung bestimmter bereits vorhandener Metadaten bei hinreichendem Zugriff als Möglichkeit erwähnt. Kein Widerruf der zuvor verlangten bidirektionalen Synchronisierbarkeit. Nicht jedes Paperless-Feld muss automatisch lokal gespiegelt werden. | +| 08:25 · `1ff6e6fc-485f-4a09-ae0c-39175c2cc3b7` | Praktischen Paperless-Test zurückstellen; Aufgaben zunächst lokal, spätere Kairo-Anbindung ausdrücklich gewünscht. „Bleibt möglich“ in der Baseline beschreibt diesen Zukunftswunsch zu schwach. | +| 08:30 · `be0d32a8-99ca-418c-b7df-bf646e6ef613` | Portalbeschaffung und automatische Vorgangszuordnung gewünscht, komplexe Kairo-Steuerung hier nicht benötigt. Verbindlicher MVP-Umfang der Beschaffung/Automatik nicht nachgewiesen. | +| 09:14 · `7cadc3c0-20e5-4bc4-afe4-4a6148a81040` | Spätere automatische Zuordnungen sollen manuell prüfbar und änderbar bleiben. Lernendes System als Wunsch; kein freigegebener Lernmechanismus und keine gesicherte MVP-Pflicht. Das Ziel der manuellen Korrigierbarkeit fehlt in der Baseline. | + +**Bewertung:** Die Recovery-Baseline ist als fachlicher Kern belastbar und intern weitgehend konsistent. Sie ist kein implementierbares vollständiges Fachmodell. Die wichtigsten ausdrücklichen Produktentscheidungen sind nun direkt am Original belegt. Lücken betreffen überwiegend die genaue Semantik und Abgrenzung; Assistentenvorschläge im ursprünglichen Verlauf bleiben nur teilweise rekonstruierbar. + +## 4. Priorisierte offene Grundsatzentscheidungen + +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 | +|---|---|---| +| 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. | +| 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. | +| 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. | + +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 + +**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? + +- **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. + +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. + +## 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. + +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. diff --git a/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md b/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md new file mode 100644 index 0000000..c60a72b --- /dev/null +++ b/docs/product/Tsumugu_Product_Recovery_Baseline_v0.1.md @@ -0,0 +1,176 @@ +# Tsumugu – Product Recovery Baseline + +**Version:** 0.1 · **Sicherungsdatum:** 16.10.2026 +**Status:** Rekonstruierte fachliche Arbeitsgrundlage, keine vollständig verifizierte oder neu freigegebene Spezifikation. +**Zweck:** Dauerhafte Wissensbasis für den getrennten Tsumugu-Workstream. + +## 1. Quellen und Statuskennzeichnung + +Dieses Dokument sichert die in der aktuellen Unterhaltung rekonstruierte ursprüngliche Tsumugu-Produktkonzeption. Die Rekonstruktion stützt sich auf frühere, im Recovery wiedergefundene Tsumugu-Gesprächsaussagen vom 15.10.2026 sowie ergänzend auf die `ARCHITECTURE_DISCOVERY.md` vom 15.10.2026. Ein vollständiges Originaltranskript ist in dieser Datei nicht enthalten. + +- **B – Früher ausdrücklich besprochen/entschieden:** im Recovery als konkrete Nutzeraussage wiedergefunden. Wortlaut und Zeitangaben bleiben, falls verfügbar, mit dem Original abzugleichen. +- **R – Rekonstruiert:** aus mehreren Aussagen zusammengeführt, nicht als separate Nutzerentscheidung nachgewiesen. +- **D – Discovery-Vorschlag:** technisch oder fachlich in der Discovery vorgeschlagen; dort ausdrücklich nicht automatisch als beschlossen gekennzeichnet. +- **O – Offen:** keine zuverlässige abschließende Entscheidung rekonstruierbar. + +Diese Statuskennzeichen sind Teil der Baseline. Offene Punkte werden nicht stillschweigend durch neue Annahmen ersetzt. + +## 2. Produktvision [B] + +**Tsumugu (紡ぐ)** ist ein **universeller Vorgangs- und Informationsmanager**, nicht lediglich ein Dokumentenarchiv. Der zentrale Arbeitsgegenstand ist ein **Vorgang/eine Akte**. Tsumugu verknüpft Dokumente, Informationen, Kommunikation, Beteiligte, Ereignisse, Aufgaben, Fristen und finanzielle Sachverhalte zu einem nachvollziehbaren Zusammenhang. + +Die Ausgangsfälle Mietangelegenheiten und Krankenkassenerstattungen dienen der Anforderungsfindung; das Produkt soll ebenso für Versicherungen, Behörden, Verträge und andere länger laufende Sachverhalte nutzbar sein. + +### Anwendungsfall A: Mietangelegenheiten/Rechtsstreitigkeiten [B] + +Ein Vorgang verbindet Schreiben, Gesprächsnotizen, E-Mails, Nachweise, Beteiligte und anwaltliche Kommunikation. Wesentlich sind eine überprüfbare Chronologie sowie Aufgaben und Fristen. Unterschiedliche Zeitpunkte dürfen **nicht gleichgesetzt** werden: Dokumentdatum, Versand, Zugang und Erfassung sind verschiedene Sachverhalte. + +### Anwendungsfall B: Krankenkassen-/Erstattungsfälle [B] + +Rechnungen, Erstattungsanträge, Sammelabrechnungen, Zahlungen, Bankeingänge und Fälligkeiten gehören in einen gemeinsamen Vorgangskontext. Zuordnungen können mehrdeutig sein: Eine Sammelerstattung kann mehrere Rechnungen betreffen; ein einzelner Zahlungseingang lässt sich nicht immer eindeutig zuordnen. Die **manuelle** Zuordnung war ausdrücklich Teil der ursprünglichen MVP-Richtung. + +## 3. Fachliches Modell + +| Konzept | Ursprünglicher Zweck | Status | +|---|---|---| +| Vorgang/Akte | Zentraler fachlicher Zusammenhang | B | +| Kapitel/Unterakten | Komplexe Vorgänge hierarchisch strukturieren | B; genaue Struktur O | +| Ressourcen | Dokumente, E-Mails, Notizen, ggf. Audio und andere Informationen verknüpfen | B; Ressourcentypen/Speicherung O | +| Chronologie | Kommunikation und Ereignisse nachvollziehen | B; Datenmodell O | +| Aufgaben und Fristen | Tätigkeiten, Verantwortlichkeiten und Fälligkeiten erfassen | B; Detailregeln O | +| Finanzen | Rechnungen, Zahlungen, Erstattungen manuell zuordnen | B; Betrags- und Korrekturmodell O | +| Virtuelle Zusammenstellungen | Gleiche Information in mehreren Kontexten referenzieren, ohne Kopien | B; Freigabesemantik O | +| Datenräume | Private und ausdrücklich gemeinsam genutzte Bereiche | B; physisches Modell D/O | +| Audit | Nachvollziehbare Vorgangsänderungen | D; Schema O | + +Das sind **fachliche Konzepte**, keine bereits bestätigte physische Datenbankstruktur. + +## 4. Paperless-ngx und weitere Ressourcen + +### Früher festgelegt [B] + +1. Tsumugu soll als **eigenständiger MVP** entwickelt werden. +2. **Paperless-ngx bleibt das bestehende Dokumentenarchiv für dort gehaltene Dokumentdateien**; Tsumugu bildet den Vorgangs- und Beziehungszusammenhang ab. +3. Tsumugu hält eigene Metadaten, fachliche Beziehungen und Referenzen zu Paperless-Dokumenten. Eine vollständige Dateiduplikation ist nicht automatisch vorgesehen. +4. **Ausgewählte Paperless-Metadaten sollen bidirektional synchronisierbar sein.** Diese Entscheidung darf nicht auf eine reine Einweg-Verlinkung reduziert werden. +5. E-Mails, Notizen und ggf. Audio können unabhängig von Paperless verwaltet werden; sie sind nicht automatisch Paperless-Dokumente. +6. Der praktische Paperless-Integrationstest sollte zunächst zurückgestellt werden. +7. Die eigenen Metadaten und Verknüpfungen sollen lokal und geschützt gespeichert sowie später für autorisierte KI-Kontexte aufbereitbar sein. + +### Technischer Discovery-Vorschlag [D] + +Für externe Quellen Referenzen mit Quelle, externer ID und Anzeige-Metadaten vorsehen; Dokumente verbleiben im Quellsystem. **Dies allein beschreibt noch nicht die früher gewünschte bidirektionale Metadatensynchronisation.** + +### Offen [O] + +Welche Metadaten in welche Richtung synchronisiert werden, das führende System je Feld, Konfliktauflösung, Synchronisationsfrequenz/-auslöser, Rechtekontext und technische Nutzeridentität. Ebenso der Lebenszyklus anderer Ressourcentypen sowie konkrete Datei-/Anhangsspeicherung. + +## 5. Multiuser, Familiennutzung und Rechte + +### Fachliche Anforderungen [B] + +- Von Beginn an **mehrbenutzer- und familienfähig**. +- Private Inhalte bleiben privat, Freigabe erfolgt bewusst. +- Rechte vorzugsweise auf **Vorgangs-/Aktenebene**, bei Bedarf differenziert für Unterakten oder einzelne Ressourcen. +- Virtuelle Ansichten/Mehrfachverknüpfungen dürfen keine ungewollte Offenlegung privater Ressourcen verursachen. + +### Discovery-Vorschläge [D] + +Eigene Datenräume mit Mitgliedschaften und Rollen, getrennt von Objektsichtbarkeit (`privat`/`gemeinsam`). Kein direktes Kopieren des Shinkan-Vereinsmodells. Wirksame Nutzeridentität aus der Session; keine Identitätsfestlegung über Client-Header. Neue geschützte Fachendpunkte mit wirksamer Capability-Prüfung (`enforce`). + +### Offen [O] + +Genauer Verlauf der Vererbung/Überschreibung von Freigaben, externe Dritte/Anwälte, Mitgliedschaftsänderung, Unterakten, einzelne Ressourcen, virtuelle Verweise, Besitzerwechsel und Löschrechte. + +## 6. Chronologie, Aufgaben, Fristen, Finanzen + +**Chronologie [B]:** Schriftverkehr und fachliche Ereignisse im Zusammenhang zeigen. Zeitangaben müssen semantisch unterscheidbar bleiben. + +**Chronologie-Implementierung [D]:** Als Lesemodell aus Fachereignissen und Audit. Audit append-only mit Actor, Datenraum, Aktion, Ressourcentyp, Ressourcen-ID und Zeitpunkt. + +**Aufgaben [B]:** Aufgabenverwaltung zunächst **eigenständig in Tsumugu**, ohne Kairos komplexere Projekt-/Roadmap-Logik vorauszusetzen. Spätere Kairo-Kopplung bleibt möglich. + +**Fristen [B/O]:** Bestandteil der Vorgangsbearbeitung; genaue Fachregeln zu Fristberechnung, Erinnerungen und Statusübergängen sind nicht vollständig überliefert. + +**Finanzen [B]:** Zunächst manuelle Beziehungen zwischen Rechnungen, Zahlungen, Erstattungen und Vorgängen. Mehrere Rechnungen pro Erstattung bzw. ein nicht eindeutig zugeordneter Bankeingang müssen fachlich berücksichtigt werden. Teilbeträge, Korrekturen, Storno und Rundung sind noch zu spezifizieren. + +## 7. KI und weitere Integration + +**Gesichert [B]:** Tsumugu soll perspektivisch aus berechtigt zugänglichen Vorgangsdaten **KI-geeignete Informationspakete** erzeugen können. Eine bereits laufende KI-Engine oder ein autonomer Agent ist **keine gesicherte MVP-Pflicht**. + +**Discovery [D]:** Spätere Kairo-/Agentenanbindung über HTTP-APIs und eingeschränkte datenraumgebundene technische Identitäten; keine gemeinsame Fachdatenbank. Privacy- und Egress-Prüfungen bleiben wichtige technische Grenzen. + +**Offen [O]:** Konkrete KI-Anwendungsfälle, Anbieter, Freigaben, Orchestrierung, Automatisierungsgrad. + +## 8. Rekonstruierter MVP-Rahmen + +Die frühere Gesprächsfolge stützt folgende MVP-Richtung [B]: + +1. Eigenständige Akten-/Vorgangsverwaltung. +2. Private und bewusst gemeinsame Datenräume. +3. Hierarchische Aktenstruktur sowie Ressourcen- und Mehrfachverknüpfungen. +4. Chronologische Nachvollziehbarkeit, Aufgaben und Fristen. +5. Verknüpfung zu Paperless und ausgewählte bidirektionale Metadatensynchronisation. +6. Manuelle Finanz-/Erstattungszuordnungen. +7. Datenmodell und Berechtigungsgrenzen, die spätere KI-Funktionen ermöglichen. + +**Nicht gesichert als Pflicht des ersten MVP [R/O]:** Vollautomatischer Bankabgleich, umfassende E-Mail-/Audioimporter, autonomer KI-Agent, Billing, zentraler Workflowdienst, umfangreiche Kairo-Integration. + +Dies ist eine **rekonstruierte Arbeitsgrenze**, keine vollständige priorisierte und endgültig abgenommene Featureliste. + +## 9. Entscheidungs- und Recovery-Log + +Die folgenden ungefähren Uhrzeiten vom 15.10.2026 wurden in der vorhergehenden Chat-Rekonstruktion benannt. Mangels vollständig gesicherten Gesprächstranskripts sind sie **nicht unabhängig verifizierte Original-Zeitstempel**. + +| Gesprächsphase | Rekonstruierte Aussage | Einordnung | +|---|---|---| +| ca. 05:35 | Universeller Vorgangsmanager; bestehende Open-Source-/Paperless-Lösungen prüfen | B | +| ca. 05:48 | Eigenständiger MVP, Multiuser, ausgewählte bidirektionale Paperless-Metadaten, manuelle Finanzzuordnung | B | +| ca. 05:57 | Privat und gemeinsam, Rechte vor allem am Vorgang, Kapitel/Unterakten, virtuelle Ansichten | B | +| ca. 06:04 | Paperless-Dokumente referenzieren; E-Mails/Notizen/ggf. Audio außerhalb möglich | B | +| ca. 06:15 | Eigene Metadaten lokal schützen, später KI-Kontextpakete | B | +| ca. 06:25 | Paperless-Integrationstest verschieben; Aufgaben zunächst lokal | B | + +### Wichtige Abgrenzungen + +- Nicht bloß ein Akten-Frontend für Paperless. [B] +- Nicht auf Shinkans Vereins-/Sportobjekte festgelegt. [D] +- Kein ungeschütztes Übernehmen von Mitais Profil-Header-Schema. [D] +- Keine Kopie von Kairos vollständigem Aufgaben-/Steuerungsmodell als MVP-Pflicht. [B/R] +- Keine ungeprüfte Umdeutung von Discovery-Vorschlägen zu verbindlichen Produktentscheidungen. + +## 10. Tatsächlich offene fachliche Entscheidungen + +**Vor verbindlicher Datenmodellimplementierung:** + +1. Ressourcentypen, eigenes vs. externes Speichern, Paperless-Feldhoheit. +2. Rechte-/Sichtbarkeitsvererbung zwischen Datenraum, Akte, Unterakte, Ressource und virtueller Zusammenstellung. +3. Finanzbeziehungen und Mehrfach-/Teilzuordnungen einschließlich Korrekturen. + +**Bei der konkreten Produktfunktion:** Zeit- und Ereignistypen, Fristberechnung und Erinnerungen, Statusmodelle, MVP-Reihenfolge und Akzeptanzkriterien. + +**Bei der Paperless-Anbindung:** genaue Feldliste, Konfliktlösung, Benutzeridentitäten und Synchronisationsfehler. + +Kein zusätzlicher langwieriger Grundsatzreview nötig; blockierende Fachentscheidungen werden gezielt geklärt. + +## 11. Technischer Kontext – nicht Teil der Fachfreigabe + +Die vorhandene `ARCHITECTURE_DISCOVERY.md` vom 15.10.2026 dokumentiert Tsumugu damals als technisches Deployment-Gerüst ohne fertige Fachdomaine. Sie erwähnt getrennte Dev-/Prod-Umgebungen, Docker Compose, FastAPI, React/Vite, PostgreSQL und technische Security-/Deploy-Maßnahmen. Die spätere Jinkendo Technical Reference Architecture ist **ein getrennter technischer Workstream**. + +Technische Architekturvorgaben dürfen bereits bestätigte Tsumugu-Fachentscheidungen nicht stillschweigend ersetzen. Umgekehrt wird eine Tsumugu-Fachentscheidung nicht ohne Prüfung zum allgemeinen Jinkendo-Standard. + +## 12. Übergabe an zwei getrennte Work-Sessions + +**Tsumugu Product & Development:** Dieses Dokument als fachliche Recovery-Baseline übernehmen. Fehlende Anforderungen nur gezielt klären, fachliche Spec und MVP danach fortschreiben. Tsumugu ist der erste reale Anwendungsfall der Jinkendo-Blueprints. + +**Jinkendo Technical Architecture:** Technische Referenzarchitektur, Guardrails und Sicherheits-/Foundation-Blueprints getrennt pflegen. Erkenntnisse aus der Tsumugu-Implementierung können die technischen Blueprints korrigieren, ohne Tsumugus Fachmodell zu verallgemeinern. + +**Änderungsregel:** Diese Recovery-Baseline versioniert behalten. Fachliche Änderungen ausdrücklich dokumentieren; keine stillen Überschreibungen durch neue Architekturberichte. + +## 13. Quellenlage und Einschränkungen + +- Frühere Tsumugu-Unterhaltung vom 15.10.2026, **über die bisherige Chat-Rekonstruktion indirekt wiedergegeben**, nicht als vollständiges Wortlautprotokoll gesichert. +- `ARCHITECTURE_DISCOVERY.md` (15.10.2026), aus der ursprünglichen Tsumugu-Bestandsaufnahme, ausdrücklich mit nicht freigegebenen Vorschlägen. +- Jinkendo-Architekturberichte Phase 3.1/3.2 nur als technischer Kontext, nicht als Ursprung neuer Tsumugu-Produktanforderungen. + +**Einschränkung:** Das Dokument sichert den wiederherstellbaren fachlichen Kern. Es behauptet ausdrücklich nicht, sämtliche ursprünglichen Details oder Entscheidungen lückenlos wiederhergestellt zu haben. -- 2.43.0 From 997da92c9bd1ea4c1dfdf932dcc2cea4e2d59402 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 12:56:02 +0200 Subject: [PATCH 02/58] 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. -- 2.43.0 From 92e2b5c5fcc1b5d9a78299661b2d84e0a1e575a8 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 12:58:23 +0200 Subject: [PATCH 03/58] Dokumentiere gemeinsamen Notizinhalt und kontextbezogene Anmerkungen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 2afdc8e..003d034 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.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. -- 2.43.0 From c88b93080ddebd43cfc9b711e0031f8d0f020fa3 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:00:48 +0200 Subject: [PATCH 04/58] Konkretisiere Bearbeitungsrechte und gleichberechtigte Einbindungen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 33 ++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 003d034..b1a6db9 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.3, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.4, 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). Anschließend bestätigt er gemeinsamen Notizinhalt mit kontextbezogenen Anmerkungen (F-01b, jeweils 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) sowie die Ableitung der Bearbeitungsbefugnis aus der Akte und Bearbeitung von jeder Einbindung aus bei vollständigem Zugriff auf beide Vorgänge (F-01c, 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. @@ -25,6 +25,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. +- 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). - 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. @@ -56,7 +57,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, 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. | +| 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. | | 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. | @@ -83,7 +84,7 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **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. +**Abgrenzung:** Lesesichtbarkeit allein gewährt kein Änderungsrecht; die Bearbeitungsbefugnis ist in F-01c konkretisiert. Offen bleiben 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. ### F-01b – Gemeinsamer Inhalt bei Mehrfacheinbindung: bestätigt am 16.10.2026 @@ -91,17 +92,29 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **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. -**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 das Fachmodell:** Gemeinsamer Notizinhalt und kontextbezogene Anmerkungen sind fachlich getrennt. Das gilt zusätzlich zur bereits beschlossenen kontextbezogenen Berechtigung. Die Bearbeitungsbefugnis ist gesondert in F-01c festgelegt. 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 +### F-01c – Bearbeitungsrecht und Bearbeitungsort: bestätigt am 16.10.2026 -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? +**Beschluss:** Der Nutzer bestätigt: Das Bearbeitungsrecht einer Akte berechtigt grundsätzlich auch zum Ändern einer dort eingebundenen gemeinsamen Notiz, sofern sie in diesem Kontext nicht ausdrücklich schreibgeschützt ist. Er ergänzt ausdrücklich: Wer auf beide Vorgänge vollständigen Zugriff hat, darf das gemeinsame Element an beliebiger Stelle ändern. -**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. +**Begründung:** Die Rechteverwaltung bleibt auf Aktenbasis einheitlich. Der Bedienort einer gemeinsamen Information begründet bei vollständiger Berechtigung keine zusätzliche Einschränkung und keine besondere Zuständigkeit einer Ursprungsakte. -**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. +**Auswirkungen auf das Fachmodell:** Wer in B nur lesen darf, erhält daraus kein Änderungsrecht. Wer dort bearbeiten darf und am Element nicht eingeschränkt ist, darf den gemeinsamen Inhalt ändern; die Änderung ist gemäß F-01b auch in A sichtbar, ohne Zugriff auf A zu gewähren. Vollständiger Zugriff auf A und B erlaubt die Bearbeitung von A oder B aus. Eine zusätzliche, vom Aktenrecht unabhängige Bearbeitungsfreigabe für jede gemeinsame Notiz ist nicht grundsätzlich erforderlich. + +**Auswirkungen auf den MVP:** Fachliche Prüfszenarien: (1) Vollzugriff auf A und B ermöglicht Änderung desselben Inhalts von beiden Einbindungen aus. (2) Ein berechtigter Bearbeiter nur von B kann den gemeinsamen Text gemäß seinen Rechten in B ändern und erhält dadurch keinen Aktenzugriff auf A. (3) Reiner Lesezugriff oder eine ausdrückliche Schreibsperre im betrachteten Kontext erlauben aus diesem Kontext allein keine Änderung. + +**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 + +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? + +**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. + +**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. ## 6. Fortschreibung @@ -111,4 +124,6 @@ Soll das Bearbeitungsrecht einer Akte grundsätzlich auch zum Ändern einer dort 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. +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. + 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. -- 2.43.0 From 0e55e9e65d0214eff380c035d52eee94f3f91cc9 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:02:11 +0200 Subject: [PATCH 05/58] Trenne Entfernen einer Einbindung vom globalen Loeschen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) 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. -- 2.43.0 From 75cdbeaa9a08ebae651d8f4dce4a56efccab16fc Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:08:38 +0200 Subject: [PATCH 06/58] Sichere einfache aktenbasierte Weiterfreigabe fuer Familiennutzung --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 44f7789..3c192ab 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.5, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.6, 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). Anschließend bestätigt er gemeinsamen Notizinhalt mit kontextbezogenen Anmerkungen (F-01b) sowie die Ableitung der Bearbeitungsbefugnis aus der Akte und Bearbeitung von jeder Einbindung aus bei vollständigem Zugriff auf beide Vorgänge (F-01c, jeweils Abschnitt 5). +- Fachliches Interview vom 16.10.2026 in dieser Session: ausdrückliche Bestätigungen zu Aktenrechten und Kontexten (F-01a), gemeinsamem Notizinhalt (F-01b), Bearbeitungsrechten und -orten (F-01c), Entfernen gegenüber Löschen (F-01d) und gesonderter Weiterfreigabeberechtigung bei einfacher Familiennutzung (F-01e); siehe 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. @@ -27,6 +27,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). +- 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 für die private/Familiennutzung einfach bleiben; Einzelregelungen sind seltene Ausnahmen (F-01e 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. @@ -58,7 +59,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 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. | +| 1 / F-01 | Teilweise geklärt: Aktenrechte mit kontextbezogenen Einschränkungen (F-01a), gemeinsamer Notizinhalt (F-01b), Bearbeitungsrechte/-orte (F-01c), Entfernen gegenüber Löschen (F-01d), getrennte Weiterfreigabeberechtigung bei einfacher Handhabung (F-01e). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Nächste Frage F-01f: gezielte Einbindung zwischen persönlichem und gemeinsamem Datenraum. Offen bleiben konkrete Rollen/Löschbefugnisse, globale Schutzregeln, Unterakten, 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. | @@ -119,13 +120,21 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **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 +### F-01e – Weiterfreigabe gegenüber Bearbeiten: bestätigt am 16.10.2026 -Soll das Freigeben eines Elements für weitere Personen eine eigene Berechtigung erfordern, getrennt vom Bearbeiten seines Inhalts? +**Beschluss:** Der Nutzer stimmt einer gesonderten Berechtigung zum Freigeben zu. Sie wird grundsätzlich über die Akte vergeben und kann am einzelnen Element eingeschränkt werden. Reiner Lese- oder Bearbeitungszugriff erlaubt nicht automatisch, ein Element weiteren Personen zugänglich zu machen. Der Nutzer betont geringe Komplexität: Solche Ausnahmen sind in der privaten Nutzung selten, zwischen Eltern und Söhnen aber denkbar. -**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. +**Begründung und Auswirkungen:** Inhaltliche Mitarbeit und Entscheidung über weitere Empfänger bleiben unterscheidbar. Die Bedienung muss mit einfachen Aktenfreigaben auskommen; seltene Elementausnahmen dürfen nicht zur regelmäßigen Einzelkonfiguration aller Inhalte führen. Fachliches MVP-Prüfszenario: Ein Bearbeiter ohne Freigabebefugnis kann den Inhalt bearbeiten, aber dessen Empfängerkreis nicht durch eine weitere Einbindung erweitern. -**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. +**Weiterhin offen:** Konkrete Rollen/Standardbelegungen sowie das Zusammenspiel von Freigabebefugnis und Einfügebefugnis im Zielvorgang. Ein umfangreiches konfigurierbares Rollenmodell oder ein zusätzlicher Genehmigungsablauf ist keine aus diesem Beschluss abzuleitende Anforderung. + +### F-01f – Einbindung zwischen persönlichen und gemeinsamen Datenräumen: nächste Frage, offen + +Soll eine persönliche Notiz gezielt in eine gemeinsame Familienakte eingebunden und dort freigegeben werden können, während ihr gemeinsamer Inhalt dem persönlichen Datenraum zugeordnet bleibt? + +**Vorschlag:** Ja, als ausdrücklich freigegebene Einbindung desselben Elements ohne automatische Kopie oder Verschiebung. Die Familie erhält nur die für diesen Kontext freigegebenen Rechte; andere persönliche Inhalte bleiben unzugänglich. Vorteil: konsistente Mehrfachnutzung auch zwischen privaten und gemeinsamen Bereichen; Nachteil: der gemeinsame Zugriff hängt von einer Freigabe über die Datenraumgrenze ab. Lebenszyklus, Entzug und Ausscheiden aus einem gemeinsamen Raum müssen anschließend konkretisiert werden. + +**Alternative:** Gemeinsame Nutzung nur innerhalb desselben Datenraums; für die Familienakte müsste der Inhalt bewusst übertragen oder kopiert werden. Das vereinfacht Datenraumgrenzen, schränkt aber die gewünschte Mehrfachnutzung ein. Noch keine Variante beschlossen. ## 6. Fortschreibung @@ -139,4 +148,6 @@ Soll das Freigeben eines Elements für weitere Personen eine eigene Berechtigung 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. +16.10.2026, Arbeitsstand 0.6: F-01e bestätigt: Weiterfreigabe getrennt vom Bearbeiten, grundsätzlich aktenbasiert mit Elementausnahmen. Nutzerbedingung geringer Komplexität für die private/Familiennutzung ausdrücklich aufgenommen. Nächste Frage F-01f betrifft persönliche und gemeinsame Datenräume. 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. -- 2.43.0 From f06b74f4c39b552800e1fdf5c3d8cbd7fa5fc9d0 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:17:12 +0200 Subject: [PATCH 07/58] Sichere allgemeine Datenhoheit und bereite fachliches Strukturmodell vor --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 41 +++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 3c192ab..7ccb52b 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.6, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.7, 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. @@ -9,6 +9,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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: ausdrückliche Bestätigungen zu Aktenrechten und Kontexten (F-01a), gemeinsamem Notizinhalt (F-01b), Bearbeitungsrechten und -orten (F-01c), Entfernen gegenüber Löschen (F-01d) und gesonderter Weiterfreigabeberechtigung bei einfacher Familiennutzung (F-01e); siehe Abschnitt 5. +- Weitere Präzisierung im Interview: Datenraumübergreifende Freigaben gelten allgemein, nicht nur für Familien. Der Anleger besitzt die ursprüngliche Hoheit und kann Rechte einschließlich Lesen, Ändern, Ownership und Löschen vergeben; sowohl auf Element- als auch auf Akten-/Vorgangsebene. Geringe Rechtekomplexität und die Konzeption der fachlichen Strukturbegriffe sind ausdrückliche Vorgaben (F-01f und Strukturvorschlag S-01). - [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. @@ -27,7 +28,8 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). -- 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 für die private/Familiennutzung einfach bleiben; Einzelregelungen sind seltene Ausnahmen (F-01e bestätigt). +- 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. - 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. @@ -59,7 +61,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 (F-01b), Bearbeitungsrechte/-orte (F-01c), Entfernen gegenüber Löschen (F-01d), getrennte Weiterfreigabeberechtigung bei einfacher Handhabung (F-01e). | Kein Zugriff auf andere Akten durch ein gemeinsam eingebundenes Element. Nächste Frage F-01f: gezielte Einbindung zwischen persönlichem und gemeinsamem Datenraum. Offen bleiben konkrete Rollen/Löschbefugnisse, globale Schutzregeln, Unterakten, Eigentum und Rechteentzug. | +| 1 / F-01 | Grundprinzipien geklärt: Aktenrechte und Kontexte (F-01a), gemeinsamer Inhalt (F-01b), Bearbeiten (F-01c), Entfernen/Löschen (F-01d), getrennte Weiterfreigabe (F-01e), allgemeine Datenraumfreigabe und ursprüngliche Hoheit des Anlegers (F-01f). | Auf Nutzerwunsch jetzt fachliche Struktur von Akte, Vorgang/Teilvorgang, Sicht und virtueller Zusammenstellung klären (S-01). Konkrete Rechte-/Ownership-Übergänge, Rollen, Löschbefugnisse und Rechteentzug bleiben offen; keine weitere Detailrunde vor der Strukturklärung. | | 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. | @@ -128,13 +130,36 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Weiterhin offen:** Konkrete Rollen/Standardbelegungen sowie das Zusammenspiel von Freigabebefugnis und Einfügebefugnis im Zielvorgang. Ein umfangreiches konfigurierbares Rollenmodell oder ein zusätzlicher Genehmigungsablauf ist keine aus diesem Beschluss abzuleitende Anforderung. -### F-01f – Einbindung zwischen persönlichen und gemeinsamen Datenräumen: nächste Frage, offen +### F-01f – Allgemeine Datenraumfreigabe und ursprüngliche Hoheit: bestätigt am 16.10.2026 -Soll eine persönliche Notiz gezielt in eine gemeinsame Familienakte eingebunden und dort freigegeben werden können, während ihr gemeinsamer Inhalt dem persönlichen Datenraum zugeordnet bleibt? +**Beschluss:** Der Nutzer bestätigt das Einbinden und Freigeben desselben Elements zwischen persönlichem und gemeinsamem Datenraum und stellt klar, dass dies generell gilt, nicht nur für Familien. Der Inhalt kann dem bisherigen Datenraum zugeordnet bleiben. Eine Freigabe ist keine automatische Kopie, Verschiebung oder Ownership-Übertragung. -**Vorschlag:** Ja, als ausdrücklich freigegebene Einbindung desselben Elements ohne automatische Kopie oder Verschiebung. Die Familie erhält nur die für diesen Kontext freigegebenen Rechte; andere persönliche Inhalte bleiben unzugänglich. Vorteil: konsistente Mehrfachnutzung auch zwischen privaten und gemeinsamen Bereichen; Nachteil: der gemeinsame Zugriff hängt von einer Freigabe über die Datenraumgrenze ab. Lebenszyklus, Entzug und Ausscheiden aus einem gemeinsamen Raum müssen anschließend konkretisiert werden. +**Zusätzliche ausdrückliche Festlegungen:** -**Alternative:** Gemeinsame Nutzung nur innerhalb desselben Datenraums; für die Familienakte müsste der Inhalt bewusst übertragen oder kopiert werden. Das vereinfacht Datenraumgrenzen, schränkt aber die gewünschte Mehrfachnutzung ein. Noch keine Variante beschlossen. +1. Der Anleger hat die ursprüngliche Hoheit am Element. Er kann Rechte zum Lesen, Ändern, Ownership und Löschen vergeben. Die Aufzählung ist keine abschließende Rechte-/Rollenmatrix. +2. Einzelne Elemente können ausdrücklich Sonderrechte erhalten. Dasselbe Prinzip der ursprünglichen Hoheit und Rechtevergabe gilt für Akten/Vorgänge. +3. Aktenbasierte Rechte bleiben der Regelfall, explizite Elementrechte die Ausnahme. Es soll keine extreme Rechtekomplexität entstehen. +4. Akten, Vorgänge, Teilvorgänge, Sichten und virtuelle Zusammenstellungen sollen nun fachlich konzipiert werden. + +**Auswirkungen auf Fachmodell und MVP:** Ersteller, aktuelle Ownership, Rechtevergabe und kontextbezogene Einbindung sind unterscheidbare Sachverhalte. Ein Datenraum oder ein anderer Einbindungskontext übernimmt nicht allein durch die Referenz die Hoheit über das Element. Eine wirksam vergebene Lesefreigabe kann gezielt über eine Datenraumgrenze wirken, ohne die übrigen Inhalte dieses Datenraums zu öffnen. Fachliches Prüfszenario: Der Anleger gibt ein persönliches Element in einem gemeinsamen Kontext nur zum Lesen frei; andere persönliche Inhalte bleiben unzugänglich, die Einbindung gewährt weder Bearbeitungs- noch Ownership- oder Löschrechte. + +**Weiterhin offen:** Ownership übertragen oder gemeinsam vergeben; Rechte nach einer Übertragung; genaue Bedeutung delegierter Lösch-/Freigaberechte und deren Verhältnis zur Aktenvererbung; Entzug und Ausscheiden aus Datenräumen. Aus „Anleger“ wird kein unveränderlicher Eigentümer und aus „Ownership vergeben“ keine bereits entschiedene Anzahl möglicher Eigentümer abgeleitet. Externe Quellsystemrechte bleiben gesondert zu klären. + +### S-01 – Strukturmodell: Vorschlag zur nächsten Interviewfrage, noch nicht beschlossen + +Der Nutzer hat die Strukturklärung ausdrücklich priorisiert. Empfehlung: Akte und Vorgang fachlich unterscheiden, aber gemeinsame Grundfunktionen wie Ressourcenverknüpfung, Berechtigungen und Chronologie vorsehen. Eine Trennung physischer Tabellen, eine verpflichtende Ebene oder ein neuer technischer Architekturaufbau folgt daraus nicht. + +| Begriff | Vorgeschlagene Bedeutung | Beispiel | +|---|---|---| +| Akte | Dauerhafter fachlicher Zusammenhang, in dem Ressourcen und mehrere Vorgänge zusammengehören können. | Mietverhältnis Wohnung X. | +| Vorgang | Konkreter bearbeitbarer Sachverhalt mit eigenem Verlauf und Abschluss. | Betriebskostenabrechnung 2025 oder Kautionsabrechnung. | +| Teilvorgang | Inhaltlich untergeordneter Vorgang mit denselben Grundfähigkeiten wie ein Vorgang; kein separates komplexes Prozessmodell. | Belegeinsicht zur Betriebskostenabrechnung 2025. | +| Sicht | Gespeicherte, dynamische Auswahl vorhandener Inhalte nach Kriterien; erzeugt durch ihre Anzeige allein keine zusätzlichen Rechte. | Alle offenen Fristen über mehrere Akten. | +| Virtuelle Zusammenstellung | Bewusste Auswahl und Anordnung vorhandener Inhalte durch Referenzen; erzeugt durch das Zusammenstellen allein keine zusätzlichen Rechte. | Ausgewählte Unterlagen für ein Anwaltsgespräch. | + +**Nächste einzelne Frage S-01a:** Sollen Akte und Vorgang diese unterschiedlichen fachlichen Bedeutungen haben: Akte als dauerhafter Zusammenhang, Vorgang als konkreter bearbeitbarer Sachverhalt? + +**Empfehlung:** Ja, bei gemeinsam gehaltenen Grundfunktionen. Vorteil: langfristige Zusammenhänge und abschließbare Arbeiten bleiben verständlich unterscheidbar. Nachteil: zwei Begriffe mit unterschiedlicher Bedeutung. Alternative: ein einziger universeller Container, der je nach Nutzung Akte oder Vorgang heißt; weniger Begriffstrennung, dafür weniger klare fachliche Bedeutung. Die Definitionen der übrigen Begriffe, erlaubte Einbindungen, freie Vorgänge ohne Akte, Hierarchietiefe, Unterakten/Kapitel und die Freigabewirkung von Sichten/Zusammenstellungen sind damit noch nicht beschlossen. ## 6. Fortschreibung @@ -150,4 +175,6 @@ Soll eine persönliche Notiz gezielt in eine gemeinsame Familienakte eingebunden 16.10.2026, Arbeitsstand 0.6: F-01e bestätigt: Weiterfreigabe getrennt vom Bearbeiten, grundsätzlich aktenbasiert mit Elementausnahmen. Nutzerbedingung geringer Komplexität für die private/Familiennutzung ausdrücklich aufgenommen. Nächste Frage F-01f betrifft persönliche und gemeinsame Datenräume. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.7: F-01f bestätigt und verallgemeinert: Datenraumfreigabe für alle Nutzungskontexte, ursprüngliche Hoheit des Anlegers, gezielte Rechtevergabe einschließlich Ownership/Löschen auf Element- und Akten-/Vorgangsebene. Geringe Rechtekomplexität bleibt Vorgabe. Auf Nutzerwunsch Strukturvorschlag S-01 mit erster Frage zur Unterscheidung Akte/Vorgang aufgenommen; noch keine Freigabe dieses Vorschlags. 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. -- 2.43.0 From 54581d962423fcd3973e1bdac3068d4d2e9c4d89 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:19:41 +0200 Subject: [PATCH 08/58] Bestaetige fachliche Begriffe fuer Akten Vorgaenge und Sichten --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 29 +++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 7ccb52b..5c6fbff 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.7, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.8, 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. @@ -9,7 +9,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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: ausdrückliche Bestätigungen zu Aktenrechten und Kontexten (F-01a), gemeinsamem Notizinhalt (F-01b), Bearbeitungsrechten und -orten (F-01c), Entfernen gegenüber Löschen (F-01d) und gesonderter Weiterfreigabeberechtigung bei einfacher Familiennutzung (F-01e); siehe Abschnitt 5. -- Weitere Präzisierung im Interview: Datenraumübergreifende Freigaben gelten allgemein, nicht nur für Familien. Der Anleger besitzt die ursprüngliche Hoheit und kann Rechte einschließlich Lesen, Ändern, Ownership und Löschen vergeben; sowohl auf Element- als auch auf Akten-/Vorgangsebene. Geringe Rechtekomplexität und die Konzeption der fachlichen Strukturbegriffe sind ausdrückliche Vorgaben (F-01f und Strukturvorschlag S-01). +- Weitere Präzisierung im Interview: Datenraumübergreifende Freigaben gelten allgemein, nicht nur für Familien. Der Anleger besitzt die ursprüngliche Hoheit und kann Rechte einschließlich Lesen, Ändern, Ownership und Löschen vergeben; sowohl auf Element- als auch auf Akten-/Vorgangsebene. Geringe Rechtekomplexität bleibt Vorgabe (F-01f). Die anschließend vorgeschlagene Begriffstrennung Akte, Vorgang, Teilvorgang, Sicht und virtuelle Zusammenstellung wurde insgesamt bestätigt (S-01a). - [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,9 +21,10 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch **Bestätigt durch aktuellen Auftrag und/oder ursprüngliche Nutzeraussagen:** -- Universeller Vorgangs- und Informationsmanager. Akte/Vorgang ist der zentrale Zusammenhang; Mietfälle und Erstattungen validieren das Modell, begrenzen es aber nicht. +- 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. +- 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. - 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). @@ -61,7 +62,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), getrennte Weiterfreigabe (F-01e), allgemeine Datenraumfreigabe und ursprüngliche Hoheit des Anlegers (F-01f). | Auf Nutzerwunsch jetzt fachliche Struktur von Akte, Vorgang/Teilvorgang, Sicht und virtueller Zusammenstellung klären (S-01). Konkrete Rechte-/Ownership-Übergänge, Rollen, Löschbefugnisse und Rechteentzug bleiben offen; keine weitere Detailrunde vor der Strukturklärung. | +| 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 insgesamt bestätigt (S-01a). | Nächste Frage S-01b: eigenständige Vorgänge und Zuordnung zu keiner, einer oder mehreren Akten. Beziehungen, Unterakten/Kapitel, 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. | @@ -145,11 +146,11 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Weiterhin offen:** Ownership übertragen oder gemeinsam vergeben; Rechte nach einer Übertragung; genaue Bedeutung delegierter Lösch-/Freigaberechte und deren Verhältnis zur Aktenvererbung; Entzug und Ausscheiden aus Datenräumen. Aus „Anleger“ wird kein unveränderlicher Eigentümer und aus „Ownership vergeben“ keine bereits entschiedene Anzahl möglicher Eigentümer abgeleitet. Externe Quellsystemrechte bleiben gesondert zu klären. -### S-01 – Strukturmodell: Vorschlag zur nächsten Interviewfrage, noch nicht beschlossen +### S-01a – Fachliche Strukturbegriffe: bestätigt am 16.10.2026 -Der Nutzer hat die Strukturklärung ausdrücklich priorisiert. Empfehlung: Akte und Vorgang fachlich unterscheiden, aber gemeinsame Grundfunktionen wie Ressourcenverknüpfung, Berechtigungen und Chronologie vorsehen. Eine Trennung physischer Tabellen, eine verpflichtende Ebene oder ein neuer technischer Architekturaufbau folgt daraus nicht. +**Beschluss:** Der Nutzer bestätigt die vorgeschlagene Begriffstrennung insgesamt. Die fünf Begriffe erhalten folgende fachliche Bedeutung. Akte und Vorgang werden in ihrer Bedeutung unterschieden; gemeinsame Grundfunktionen wie Ressourcenverknüpfung, Rechtevergabe und Chronologie sollen einheitlich gehalten werden. Daraus folgt keine Entscheidung über physische Tabellen, verpflichtende Ebenen oder einen neuen technischen Architekturaufbau. -| Begriff | Vorgeschlagene Bedeutung | Beispiel | +| Begriff | Bestätigte fachliche Bedeutung | Beispiel | |---|---|---| | Akte | Dauerhafter fachlicher Zusammenhang, in dem Ressourcen und mehrere Vorgänge zusammengehören können. | Mietverhältnis Wohnung X. | | Vorgang | Konkreter bearbeitbarer Sachverhalt mit eigenem Verlauf und Abschluss. | Betriebskostenabrechnung 2025 oder Kautionsabrechnung. | @@ -157,9 +158,17 @@ Der Nutzer hat die Strukturklärung ausdrücklich priorisiert. Empfehlung: Akte | Sicht | Gespeicherte, dynamische Auswahl vorhandener Inhalte nach Kriterien; erzeugt durch ihre Anzeige allein keine zusätzlichen Rechte. | Alle offenen Fristen über mehrere Akten. | | Virtuelle Zusammenstellung | Bewusste Auswahl und Anordnung vorhandener Inhalte durch Referenzen; erzeugt durch das Zusammenstellen allein keine zusätzlichen Rechte. | Ausgewählte Unterlagen für ein Anwaltsgespräch. | -**Nächste einzelne Frage S-01a:** Sollen Akte und Vorgang diese unterschiedlichen fachlichen Bedeutungen haben: Akte als dauerhafter Zusammenhang, Vorgang als konkreter bearbeitbarer Sachverhalt? +**Begründung:** Langfristige Zusammenhänge und abschließbare Sachverhalte bleiben verständlich unterscheidbar. Teilvorgänge benötigen kein eigenes komplexes Prozessmodell. Sichten und bewusst zusammengestellte Inhalte erfüllen unterschiedliche Arbeitszwecke. -**Empfehlung:** Ja, bei gemeinsam gehaltenen Grundfunktionen. Vorteil: langfristige Zusammenhänge und abschließbare Arbeiten bleiben verständlich unterscheidbar. Nachteil: zwei Begriffe mit unterschiedlicher Bedeutung. Alternative: ein einziger universeller Container, der je nach Nutzung Akte oder Vorgang heißt; weniger Begriffstrennung, dafür weniger klare fachliche Bedeutung. Die Definitionen der übrigen Begriffe, erlaubte Einbindungen, freie Vorgänge ohne Akte, Hierarchietiefe, Unterakten/Kapitel und die Freigabewirkung von Sichten/Zusammenstellungen sind damit noch nicht beschlossen. +**Auswirkungen auf Fachmodell und MVP:** Die Begriffe sind in Spezifikation und Bedienung konsistent zu verwenden. Die konkrete Ausgestaltung und Lieferreihenfolge der fünf Konzepte ist durch die Begriffszustimmung nicht vollständig festgelegt. Zulässige Beziehungen, Pflichtzuordnungen, Hierarchietiefe, Unterakten/Kapitel sowie das Freigeben von Sichten und virtuellen Zusammenstellungen bleiben offen. Das Anzeigen oder Zusammenstellen allein erteilt keine zusätzlichen Inhaltsrechte; ausdrückliche Freigabe bleibt ein eigener Sachverhalt. + +### S-01b – Eigenständigkeit und Aktenzuordnung eines Vorgangs: nächste Frage, offen + +Soll ein Vorgang eigenständig existieren können und bei Bedarf keiner, einer oder mehreren Akten zugeordnet werden können? + +**Vorschlag:** Ja. Der Vorgang ist ein gemeinsamer Sachverhalt mit eigener Identität und eigenem Bearbeitungsstand; Akten binden ihn ein. Beispiel: Die Betriebskostenabrechnung 2025 ist sowohl in der Akte „Mietverhältnis Wohnung X“ als auch in „Steuerunterlagen 2025“ relevant. Derselbe Vorgang wird referenziert, nicht als unabhängig zu bearbeitende Kopie angelegt. Ein zunächst einzeln erfasster Vorgang benötigt keine künstliche Akte, bevor er bearbeitet werden kann. + +**Abwägung:** Flexible Zuordnung und ein konsistenter Bearbeitungsstand vermeiden starre Ablagezwänge. Dafür ist eine Akte kein eindeutiger, exklusiver Elternort jedes Vorgangs; Ownership und Rechte dürfen nicht unbemerkt aus einer beliebigen zusätzlichen Einbindung neu abgeleitet werden. Die genauen Rechte bei Mehrfachzuordnung eines ganzen Vorgangs sind noch auszuarbeiten. Alternative: Jeder Vorgang benötigt genau eine führende Akte, andere Akten können auf ihn verweisen. Noch keine Variante beschlossen; Anzahl der übergeordneten Teilvorgänge und Aktenhierarchien sind nicht Gegenstand dieser Frage. ## 6. Fortschreibung @@ -177,4 +186,6 @@ Der Nutzer hat die Strukturklärung ausdrücklich priorisiert. Empfehlung: Akte 16.10.2026, Arbeitsstand 0.7: F-01f bestätigt und verallgemeinert: Datenraumfreigabe für alle Nutzungskontexte, ursprüngliche Hoheit des Anlegers, gezielte Rechtevergabe einschließlich Ownership/Löschen auf Element- und Akten-/Vorgangsebene. Geringe Rechtekomplexität bleibt Vorgabe. Auf Nutzerwunsch Strukturvorschlag S-01 mit erster Frage zur Unterscheidung Akte/Vorgang aufgenommen; noch keine Freigabe dieses Vorschlags. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.8: Nutzer bestätigt die Begriffstrennung insgesamt. S-01a mit fünf fachlichen Begriffen als beschlossen übernommen; Strukturbeziehungen und konkrete MVP-Ausgestaltung bleiben offen. Nächste Frage S-01b betrifft eigenständige Vorgänge und deren Aktenzuordnungen. 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. -- 2.43.0 From 8ae5bd91897031147833bd1bd8f87715477f1c97 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:39:49 +0200 Subject: [PATCH 09/58] Bestaetige eigenstaendige Vorgaenge mit mehrfacher Aktenzuordnung --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 5c6fbff..e59129a 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.8, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.9, 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. @@ -25,6 +25,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. - 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). - 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). @@ -62,7 +63,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 insgesamt bestätigt (S-01a). | Nächste Frage S-01b: eigenständige Vorgänge und Zuordnung zu keiner, einer oder mehreren Akten. Beziehungen, Unterakten/Kapitel, 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) sowie eigenständige Vorgänge mit optionaler Mehrfachzuordnung zu Akten (S-01b) bestätigt. | Nächste Frage S-01c: fachliche Unterordnung von Teilvorgängen gegenüber zusätzlichen Referenzen. Unterakten/Kapitel, 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. | @@ -162,13 +163,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Die Begriffe sind in Spezifikation und Bedienung konsistent zu verwenden. Die konkrete Ausgestaltung und Lieferreihenfolge der fünf Konzepte ist durch die Begriffszustimmung nicht vollständig festgelegt. Zulässige Beziehungen, Pflichtzuordnungen, Hierarchietiefe, Unterakten/Kapitel sowie das Freigeben von Sichten und virtuellen Zusammenstellungen bleiben offen. Das Anzeigen oder Zusammenstellen allein erteilt keine zusätzlichen Inhaltsrechte; ausdrückliche Freigabe bleibt ein eigener Sachverhalt. -### S-01b – Eigenständigkeit und Aktenzuordnung eines Vorgangs: nächste Frage, offen +### S-01b – Eigenständigkeit und Aktenzuordnung eines Vorgangs: bestätigt am 16.10.2026 -Soll ein Vorgang eigenständig existieren können und bei Bedarf keiner, einer oder mehreren Akten zugeordnet werden können? +**Beschluss:** Der Nutzer bestätigt: Ein Vorgang kann eigenständig bestehen und keiner, einer oder mehreren Akten zugeordnet sein. Es bleibt derselbe Vorgang mit gemeinsamem Bearbeitungsstand. Die zusätzliche Aktenzuordnung ändert seine Ownership nicht automatisch. Eine verpflichtende führende Akte ist nicht vorgesehen. -**Vorschlag:** Ja. Der Vorgang ist ein gemeinsamer Sachverhalt mit eigener Identität und eigenem Bearbeitungsstand; Akten binden ihn ein. Beispiel: Die Betriebskostenabrechnung 2025 ist sowohl in der Akte „Mietverhältnis Wohnung X“ als auch in „Steuerunterlagen 2025“ relevant. Derselbe Vorgang wird referenziert, nicht als unabhängig zu bearbeitende Kopie angelegt. Ein zunächst einzeln erfasster Vorgang benötigt keine künstliche Akte, bevor er bearbeitet werden kann. +**Begründung:** Flexible Zusammenstellungen ohne Pflicht, zunächst eine Akte anzulegen; konsistenter Bearbeitungsstand statt unabhängig zu pflegender Kopien. -**Abwägung:** Flexible Zuordnung und ein konsistenter Bearbeitungsstand vermeiden starre Ablagezwänge. Dafür ist eine Akte kein eindeutiger, exklusiver Elternort jedes Vorgangs; Ownership und Rechte dürfen nicht unbemerkt aus einer beliebigen zusätzlichen Einbindung neu abgeleitet werden. Die genauen Rechte bei Mehrfachzuordnung eines ganzen Vorgangs sind noch auszuarbeiten. Alternative: Jeder Vorgang benötigt genau eine führende Akte, andere Akten können auf ihn verweisen. Noch keine Variante beschlossen; Anzahl der übergeordneten Teilvorgänge und Aktenhierarchien sind nicht Gegenstand dieser Frage. +**Auswirkungen auf Fachmodell und MVP:** Aktenzuordnung ist vom Bestehen des Vorgangs getrennt. Fachliche Prüfszenarien: Einen Vorgang ohne Akte anlegen und bearbeiten; denselben Vorgang in zwei Akten einbinden und in beiden denselben Bearbeitungsstand anzeigen. Beispiel: „Betriebskostenabrechnung 2025“ in „Mietverhältnis Wohnung X“ und „Steuerunterlagen 2025“. Berechtigungen und Ownership dürfen sich durch die zusätzliche Referenz nicht unbemerkt erweitern; die genaue Freigabe eines ganzen Vorgangs mit seinen eingeschränkten Inhalten bleibt auszuarbeiten. + +**Weiterhin offen:** Die Anzahl übergeordneter Vorgänge eines Teilvorgangs, Aktenhierarchien und ihre Abgrenzung zu bloßen Querverweisen sind durch die optionale Mehrfachzuordnung zu Akten nicht entschieden. + +### S-01c – Teilvorgangshierarchie gegenüber Querverweisen: nächste Frage, offen + +Soll ein Teilvorgang genau einen fachlich übergeordneten Vorgang haben und bei Bedarf in weiteren Vorgängen referenziert werden können? + +**Vorschlag:** Ja. Die fachliche Unterordnung bildet eine verständliche Hierarchie; zusätzliche Verweise drücken weitere Relevanz aus, ohne eine zweite Hauptzuordnung oder Kopie zu erzeugen. Beispiel: „Belegeinsicht“ ist Teilvorgang der „Betriebskostenabrechnung 2025“ und kann zugleich im Vorgang „Rechtsstreit“ verlinkt sein. Das unterscheidet die Unterordnung von der bereits bestätigten freien Zuordnung zu mehreren Akten. Vorteil: klarer Zusammenhang bei erhaltener Mehrfachnutzung; Nachteil: eine Hauptzuordnung muss festgelegt werden, wenn ein Sachverhalt in mehreren Vorgängen gleichrangig erscheint. + +**Alternative:** Derselbe Teilvorgang kann gleichzeitig mehrere fachlich übergeordnete Vorgänge haben. Dies ist flexibler, macht aber Hierarchie, Vererbung und mögliche Abschlussregeln schwieriger. Noch keine Variante beschlossen. Tiefe der Hierarchie, Verschieben und die Wirkung von Statusänderungen bleiben gesondert zu klären. ## 6. Fortschreibung @@ -188,4 +199,6 @@ Soll ein Vorgang eigenständig existieren können und bei Bedarf keiner, einer o 16.10.2026, Arbeitsstand 0.8: Nutzer bestätigt die Begriffstrennung insgesamt. S-01a mit fünf fachlichen Begriffen als beschlossen übernommen; Strukturbeziehungen und konkrete MVP-Ausgestaltung bleiben offen. Nächste Frage S-01b betrifft eigenständige Vorgänge und deren Aktenzuordnungen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.9: S-01b bestätigt: Vorgänge eigenständig, Zuordnung zu keiner/einer/mehreren Akten, gemeinsamer Bearbeitungsstand und keine automatische Ownership-Änderung. Nächste Frage S-01c betrifft die Unterordnung von Teilvorgängen gegenüber weiteren Querverweisen. 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. -- 2.43.0 From c6f6ec3d0acf2cec68224eb4229ceaaf407bc67a Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:43:47 +0200 Subject: [PATCH 10/58] Bestaetige Teilvorgangshierarchie mit zusaetzlichen Querverweisen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index e59129a..2513392 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.9, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.10, 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 - 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. - 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). - 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). @@ -63,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) sowie eigenständige Vorgänge mit optionaler Mehrfachzuordnung zu Akten (S-01b) bestätigt. | Nächste Frage S-01c: fachliche Unterordnung von Teilvorgängen gegenüber zusätzlichen Referenzen. Unterakten/Kapitel, 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), 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. | | 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. | @@ -171,15 +172,25 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Aktenzuordnung ist vom Bestehen des Vorgangs getrennt. Fachliche Prüfszenarien: Einen Vorgang ohne Akte anlegen und bearbeiten; denselben Vorgang in zwei Akten einbinden und in beiden denselben Bearbeitungsstand anzeigen. Beispiel: „Betriebskostenabrechnung 2025“ in „Mietverhältnis Wohnung X“ und „Steuerunterlagen 2025“. Berechtigungen und Ownership dürfen sich durch die zusätzliche Referenz nicht unbemerkt erweitern; die genaue Freigabe eines ganzen Vorgangs mit seinen eingeschränkten Inhalten bleibt auszuarbeiten. -**Weiterhin offen:** Die Anzahl übergeordneter Vorgänge eines Teilvorgangs, Aktenhierarchien und ihre Abgrenzung zu bloßen Querverweisen sind durch die optionale Mehrfachzuordnung zu Akten nicht entschieden. +**Abgrenzung:** Die Unterordnung von Teilvorgängen ist gesondert in S-01c geregelt. Aktenhierarchien und ihre Abgrenzung zu bloßen Querverweisen bleiben offen. -### S-01c – Teilvorgangshierarchie gegenüber Querverweisen: nächste Frage, offen +### S-01c – Teilvorgangshierarchie gegenüber Querverweisen: bestätigt am 16.10.2026 -Soll ein Teilvorgang genau einen fachlich übergeordneten Vorgang haben und bei Bedarf in weiteren Vorgängen referenziert werden können? +**Beschluss:** Der Nutzer bestätigt: Ein Teilvorgang hat genau einen fachlich übergeordneten Vorgang und kann zusätzlich in anderen Vorgängen verlinkt werden. Weitere Referenzen erzeugen weder eine zweite fachliche Hauptzuordnung noch eine Kopie. -**Vorschlag:** Ja. Die fachliche Unterordnung bildet eine verständliche Hierarchie; zusätzliche Verweise drücken weitere Relevanz aus, ohne eine zweite Hauptzuordnung oder Kopie zu erzeugen. Beispiel: „Belegeinsicht“ ist Teilvorgang der „Betriebskostenabrechnung 2025“ und kann zugleich im Vorgang „Rechtsstreit“ verlinkt sein. Das unterscheidet die Unterordnung von der bereits bestätigten freien Zuordnung zu mehreren Akten. Vorteil: klarer Zusammenhang bei erhaltener Mehrfachnutzung; Nachteil: eine Hauptzuordnung muss festgelegt werden, wenn ein Sachverhalt in mehreren Vorgängen gleichrangig erscheint. +**Begründung:** Verständliche Hierarchie bei erhaltener Mehrfachnutzung. Beispiel: „Belegeinsicht“ gehört als Teilvorgang zur „Betriebskostenabrechnung 2025“ und kann zugleich im Vorgang „Rechtsstreit“ verlinkt sein. -**Alternative:** Derselbe Teilvorgang kann gleichzeitig mehrere fachlich übergeordnete Vorgänge haben. Dies ist flexibler, macht aber Hierarchie, Vererbung und mögliche Abschlussregeln schwieriger. Noch keine Variante beschlossen. Tiefe der Hierarchie, Verschieben und die Wirkung von Statusänderungen bleiben gesondert zu klären. +**Auswirkungen auf Fachmodell und MVP:** Fachliche Unterordnung und zusätzliche Referenzen sind verschiedene Beziehungen. Ein als Teilvorgang geführter Vorgang hat genau einen fachlichen Elternvorgang; seine bereits bestätigte Zuordnung zu mehreren Akten wird dadurch nicht aufgehoben. Fachliches Prüfszenario: Die Belegeinsicht wird unter der Abrechnung und als Querverweis im Rechtsstreit angezeigt; beide Zugriffe beziehen sich auf denselben Vorgang und Bearbeitungsstand. + +**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 + +Sollen Kapitel reine Gliederungsabschnitte sein und für Bereiche mit eigenen Rechten oder eigener fachlicher Bedeutung Unterakten beziehungsweise Teilvorgänge verwendet werden? + +**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. + +**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. ## 6. Fortschreibung @@ -201,4 +212,6 @@ Soll ein Teilvorgang genau einen fachlich übergeordneten Vorgang haben und bei 16.10.2026, Arbeitsstand 0.9: S-01b bestätigt: Vorgänge eigenständig, Zuordnung zu keiner/einer/mehreren Akten, gemeinsamer Bearbeitungsstand und keine automatische Ownership-Änderung. Nächste Frage S-01c betrifft die Unterordnung von Teilvorgängen gegenüber weiteren Querverweisen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +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. + 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. -- 2.43.0 From 802eb1bc65fad411bf7f6bb45b5ef42236b93fe5 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:45:15 +0200 Subject: [PATCH 11/58] Grenze Kapitelgliederung von Unterakten und Teilvorgaengen ab --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) 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. -- 2.43.0 From b44faf7f509311e642e76a1c1b77e3db20dc3c3b Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:48:40 +0200 Subject: [PATCH 12/58] Sichere Sammelfreigabe und spaeteren gezielten Anwaltszugang --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index d0f7a10..8e61708 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.11, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.12, 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. @@ -27,6 +27,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). +- Virtuelle Zusammenstellungen können ausgewählte Inhalte durch ausdrückliches Teilen gesammelt zum Lesen freigeben, sofern die teilende Person für die Inhalte freigabeberechtigt ist. Herkunftsakten und übrige Inhalte bleiben unzugänglich. Später muss eine solche Zusammenstellung ausdrücklich einem Anwalt zugänglich gemacht werden können (S-01e bestätigt); Zugangsverfahren und konkreter Lieferzeitpunkt sind 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. - 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). @@ -64,7 +65,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), 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. | +| 1 / F-01 | Grundprinzipien F-01a–f geklärt. Strukturbegriffe (S-01a), Vorgangszuordnung (S-01b), Teilvorgangshierarchie (S-01c), Kapitel/Unterakten (S-01d) und ausdrückliche Sammelfreigabe virtueller Zusammenstellungen (S-01e) bestätigt. Späterer Zugang für einen Anwalt ausdrücklich gewünscht. | Nächste Frage S-01f: Freigabe nachträglich ergänzter Inhalte. Weitere Strukturbeziehungen, externe Zugangsverfahren, 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. | @@ -192,13 +193,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **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 +### S-01e – Virtuelle Zusammenstellung als gezielt freigegebenes Paket: bestätigt am 16.10.2026 -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? +**Beschluss:** Der Nutzer bestätigt: Das ausdrückliche Teilen einer virtuellen Zusammenstellung kann die ausgewählten Inhalte gesammelt zum Lesen freigeben, sofern die teilende Person diese Inhalte freigeben darf. Herkunftsakten und übrige Inhalte werden dadurch nicht geöffnet. Er ergänzt ausdrücklich, dass eine solche Zusammenstellung später einem Anwalt zugänglich gemacht werden können soll. -**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. +**Begründung:** Zusammenstellungen sollen für Empfänger nutzbar sein, ohne dass die berechtigte teilende Person jeden Inhalt in einer separaten Aktion freigeben muss. Die gezielte externe Zusammenarbeit ist ein ausdrückliches späteres Produktziel und nicht auf die Familie beschränkt. -**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. +**Auswirkungen auf Fachmodell und MVP:** Zugriff auf eine Zusammenstellung und Befugnis zum Freigeben ihrer Inhalte sind unterscheidbar. Die Freigabeaktion kann die ausgewählten, zur Freigabe berechtigten Inhalte gemeinsam erfassen. Fachliches Prüfszenario: Eine lesende Person sieht die ausdrücklich freigegebenen Schreiben und Notizen einer Zusammenstellung, erhält aber keinen Aktenzugriff auf deren Herkunftskontexte oder Bearbeitungsrechte allein aus der Lesefreigabe. + +**Weiterhin offen:** Später hinzugefügte Inhalte (S-01f), dynamische Sichten, Entzug, Umgang mit Inhalten ohne Freigabebefugnis, Aufnahme ganzer Vorgänge/Akten und Export/Snapshots. Für den späteren Anwaltszugang sind Konto/Einladung, Gastzugang oder andere Zugangsformen sowie der Lieferzeitpunkt noch nicht entschieden. Das externe Zugangsverfahren ist keine automatisch freigegebene MVP-Erweiterung. + +### S-01f – Nachträglich ergänzte Inhalte einer geteilten Zusammenstellung: nächste Frage, offen + +Sollen nachträglich ergänzte Inhalte einer bereits geteilten Zusammenstellung erst durch eine weitere ausdrückliche Freigabe für deren Empfänger sichtbar werden? + +**Vorschlag:** Ja. Der Nutzer kann neue Inhalte ergänzen und sie anschließend gesammelt für die vorhandenen Empfänger freigeben. Das betrifft neue Einbindungen; berechtigte Änderungen am Inhalt bereits freigegebener gemeinsamer Notizen bleiben gemäß F-01b sichtbar. Vorteil: Das Zusammenstellen neuer Unterlagen erweitert nicht unbemerkt den freigegebenen Bestand; Nachteil: Bei Ergänzungen ist eine zusätzliche, als Sammelaktion mögliche Freigabe nötig. + +**Alternative:** Neu ergänzte Inhalte werden automatisch im Rahmen der bestehenden Freigabe sichtbar, sofern die ergänzende Person sie freigeben darf. Das erleichtert laufende Zusammenarbeit, koppelt aber Ergänzen und Veröffentlichen. Noch keine Variante beschlossen; dynamische Sichten und festgehaltene Exportstände bleiben gesonderte Themen. ## 6. Fortschreibung @@ -224,4 +235,6 @@ Soll das ausdrückliche Teilen einer virtuellen Zusammenstellung die ausgewählt 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. +16.10.2026, Arbeitsstand 0.12: S-01e bestätigt: bewusste Sammellesefreigabe ausgewählter Inhalte bei bestehender Freigabebefugnis, ohne Zugriff auf Herkunftsakten. Späterer gezielter Zugang für einen Anwalt als ausdrückliche Anforderung aufgenommen; Zugangsverfahren und Lieferzeitpunkt offen. Nächste Frage S-01f betrifft nachträglich ergänzte Inhalte. 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. -- 2.43.0 From f0ffac579a1630b3de73930f4e50726e322d7efb Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:50:49 +0200 Subject: [PATCH 13/58] Sichere ausdrueckliche Freigabe nachtraeglich ergaenzter Inhalte --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 8e61708..2f4456e 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.12, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.13, 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. @@ -28,6 +28,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). - Virtuelle Zusammenstellungen können ausgewählte Inhalte durch ausdrückliches Teilen gesammelt zum Lesen freigeben, sofern die teilende Person für die Inhalte freigabeberechtigt ist. Herkunftsakten und übrige Inhalte bleiben unzugänglich. Später muss eine solche Zusammenstellung ausdrücklich einem Anwalt zugänglich gemacht werden können (S-01e bestätigt); Zugangsverfahren und konkreter Lieferzeitpunkt sind offen. +- Nachträglich ergänzte Elemente einer bereits geteilten virtuellen Zusammenstellung werden erst nach weiterer ausdrücklicher Freigabe für deren Empfänger sichtbar. Neue Inhalte lassen sich gesammelt freigeben. Änderungen an bereits freigegebenen gemeinsamen Notizen bleiben gemäß F-01b sichtbar (S-01f bestätigt). - 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). @@ -65,8 +66,8 @@ 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 geklärt. Strukturbegriffe (S-01a), Vorgangszuordnung (S-01b), Teilvorgangshierarchie (S-01c), Kapitel/Unterakten (S-01d) und ausdrückliche Sammelfreigabe virtueller Zusammenstellungen (S-01e) bestätigt. Späterer Zugang für einen Anwalt ausdrücklich gewünscht. | Nächste Frage S-01f: Freigabe nachträglich ergänzter Inhalte. Weitere Strukturbeziehungen, externe Zugangsverfahren, 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. | +| 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: Datenhoheit und Lebenszyklus je Ressourcentyp; darunter Paperless-Feldhoheit, Synchronisationskonflikte und Zugriff im Nutzerkontext. | Nächste Frage F-02a: eigene Datei-/Anhangsspeicherung neben externen Referenzen. Paperless bleibt Archiv seiner Dokumente; Tsumugu führt seine Beziehungen und Fachinformationen. Überlappende Metadaten, Lebenszyklus und API-Schlüsselmodell anschließend klären. | | 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. | @@ -201,15 +202,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Zugriff auf eine Zusammenstellung und Befugnis zum Freigeben ihrer Inhalte sind unterscheidbar. Die Freigabeaktion kann die ausgewählten, zur Freigabe berechtigten Inhalte gemeinsam erfassen. Fachliches Prüfszenario: Eine lesende Person sieht die ausdrücklich freigegebenen Schreiben und Notizen einer Zusammenstellung, erhält aber keinen Aktenzugriff auf deren Herkunftskontexte oder Bearbeitungsrechte allein aus der Lesefreigabe. -**Weiterhin offen:** Später hinzugefügte Inhalte (S-01f), dynamische Sichten, Entzug, Umgang mit Inhalten ohne Freigabebefugnis, Aufnahme ganzer Vorgänge/Akten und Export/Snapshots. Für den späteren Anwaltszugang sind Konto/Einladung, Gastzugang oder andere Zugangsformen sowie der Lieferzeitpunkt noch nicht entschieden. Das externe Zugangsverfahren ist keine automatisch freigegebene MVP-Erweiterung. +**Abgrenzung:** Nachträglich ergänzte Inhalte sind in S-01f geregelt. Offen bleiben dynamische Sichten, Entzug, Umgang mit Inhalten ohne Freigabebefugnis, Aufnahme ganzer Vorgänge/Akten und Export/Snapshots. Für den späteren Anwaltszugang sind Konto/Einladung, Gastzugang oder andere Zugangsformen sowie der Lieferzeitpunkt noch nicht entschieden. Das externe Zugangsverfahren ist keine automatisch freigegebene MVP-Erweiterung. -### S-01f – Nachträglich ergänzte Inhalte einer geteilten Zusammenstellung: nächste Frage, offen +### S-01f – Nachträglich ergänzte Inhalte einer geteilten Zusammenstellung: bestätigt am 16.10.2026 -Sollen nachträglich ergänzte Inhalte einer bereits geteilten Zusammenstellung erst durch eine weitere ausdrückliche Freigabe für deren Empfänger sichtbar werden? +**Beschluss:** Der Nutzer bestätigt: Neu hinzugefügte Elemente einer bereits geteilten virtuellen Zusammenstellung werden erst nach weiterer ausdrücklicher Freigabe für die Empfänger sichtbar. Dies kann durch eine einfache Sammelaktion „Neue Inhalte freigeben“ erfolgen. Änderungen an bereits freigegebenen gemeinsamen Notizen bleiben gemäß F-01b sichtbar. -**Vorschlag:** Ja. Der Nutzer kann neue Inhalte ergänzen und sie anschließend gesammelt für die vorhandenen Empfänger freigeben. Das betrifft neue Einbindungen; berechtigte Änderungen am Inhalt bereits freigegebener gemeinsamer Notizen bleiben gemäß F-01b sichtbar. Vorteil: Das Zusammenstellen neuer Unterlagen erweitert nicht unbemerkt den freigegebenen Bestand; Nachteil: Bei Ergänzungen ist eine zusätzliche, als Sammelaktion mögliche Freigabe nötig. +**Begründung:** Zusammenstellen und bewusstes Zugänglichmachen neuer Unterlagen bleiben getrennt, ohne einzelne Freigabeaktionen für jedes Element zu verlangen. -**Alternative:** Neu ergänzte Inhalte werden automatisch im Rahmen der bestehenden Freigabe sichtbar, sofern die ergänzende Person sie freigeben darf. Das erleichtert laufende Zusammenarbeit, koppelt aber Ergänzen und Veröffentlichen. Noch keine Variante beschlossen; dynamische Sichten und festgehaltene Exportstände bleiben gesonderte Themen. +**Auswirkungen auf Fachmodell und MVP:** Ein Element kann in der bearbeitbaren Zusammenstellung enthalten sein, ohne bereits über deren Freigabe für Empfänger sichtbar zu sein. Fachliches Prüfszenario: Ein neues Element ist nach dem Hinzufügen für einen Empfänger ohne anderweitige Leseberechtigung nicht zugänglich und wird erst nach berechtigter Freigabe sichtbar. Die Regel entzieht keine unabhängig bestehende Berechtigung am Element. Dynamische Sichten und festgehaltene Exportstände sind nicht mitentschieden. + +### F-02a – Eigene Dateien und Anhänge neben externen Referenzen: nächste Frage, offen + +Soll Tsumugu neben externen Referenzen auch eigene Dateien und Anhänge dauerhaft speichern können, die nicht in Paperless liegen? + +**Vorschlag:** Ja. Paperless-Dokumentdateien bleiben wie bestätigt grundsätzlich dort und werden referenziert. Für eigene Inhalte und zugehörige Dateien, etwa gespeicherte E-Mails mit Anhängen, Fotos oder gegebenenfalls Sprachaufnahmen, kann Tsumugu eine eigene geschützte Ablage verwenden. Externe Referenzen, etwa auf eine E-Mail im IMAP-Konto, bleiben daneben möglich. Diese Entscheidung betrifft die Speicherfähigkeit; konkrete Ressourcentypen, Importautomatik, Dateiformate und MVP-Lieferumfang sind damit noch nicht festgelegt. + +**Abwägung:** Eigene Dateien sind unabhängig von der Verfügbarkeit einer externen Ablage nutzbar und lassen sich im Tsumugu-Rechtekontext verwalten. Dafür muss Tsumugu deren Speicherbedarf, Sicherung und Löschung selbst berücksichtigen. Alternative: Dateien ausschließlich in externen Ablagen halten; Tsumugu speichert nur eigene strukturierte Inhalte und Referenzen. Noch keine Variante beschlossen. Ein späteres Überführen in Paperless und die Behandlung von Originalen/Arbeitskopien sind gesondert zu klären. ## 6. Fortschreibung @@ -237,4 +246,6 @@ Sollen nachträglich ergänzte Inhalte einer bereits geteilten Zusammenstellung 16.10.2026, Arbeitsstand 0.12: S-01e bestätigt: bewusste Sammellesefreigabe ausgewählter Inhalte bei bestehender Freigabebefugnis, ohne Zugriff auf Herkunftsakten. Späterer gezielter Zugang für einen Anwalt als ausdrückliche Anforderung aufgenommen; Zugangsverfahren und Lieferzeitpunkt offen. Nächste Frage S-01f betrifft nachträglich ergänzte Inhalte. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.13: S-01f bestätigt: neue Elemente einer geteilten Zusammenstellung erst nach ausdrücklicher, gesammelt möglicher Freigabe sichtbar; Inhaltsänderungen bestehender gemeinsamer Notizen unverändert gemäß F-01b. Ersten Durchgang zu Struktur/Freigaben abgeschlossen, Detailpunkte offen gehalten. Nächste Frage F-02a betrifft eigene Dateien/Anhänge neben externen Referenzen. 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. -- 2.43.0 From 78bf29ae12b1e55e8a98277a016d345d9746dc60 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:54:46 +0200 Subject: [PATCH 14/58] Bestaetige eigene geschuetzte Dateiablage neben externen Referenzen --- 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 2f4456e..da5a8aa 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.13, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.14, 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. @@ -37,7 +37,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. -- 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. +- 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. - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. @@ -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: Datenhoheit und Lebenszyklus je Ressourcentyp; darunter Paperless-Feldhoheit, Synchronisationskonflikte und Zugriff im Nutzerkontext. | Nächste Frage F-02a: eigene Datei-/Anhangsspeicherung neben externen Referenzen. Paperless bleibt Archiv seiner Dokumente; Tsumugu führt seine Beziehungen und Fachinformationen. Überlappende Metadaten, Lebenszyklus und API-Schlüsselmodell anschließend klären. | +| 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. | | 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. | @@ -212,13 +212,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Ein Element kann in der bearbeitbaren Zusammenstellung enthalten sein, ohne bereits über deren Freigabe für Empfänger sichtbar zu sein. Fachliches Prüfszenario: Ein neues Element ist nach dem Hinzufügen für einen Empfänger ohne anderweitige Leseberechtigung nicht zugänglich und wird erst nach berechtigter Freigabe sichtbar. Die Regel entzieht keine unabhängig bestehende Berechtigung am Element. Dynamische Sichten und festgehaltene Exportstände sind nicht mitentschieden. -### F-02a – Eigene Dateien und Anhänge neben externen Referenzen: nächste Frage, offen +### F-02a – Eigene Dateien und Anhänge neben externen Referenzen: bestätigt am 16.10.2026 -Soll Tsumugu neben externen Referenzen auch eigene Dateien und Anhänge dauerhaft speichern können, die nicht in Paperless liegen? +**Beschluss:** Der Nutzer bestätigt: Tsumugu kann neben externen Referenzen auch eigene Dateien und Anhänge dauerhaft geschützt speichern, die nicht in Paperless liegen. Paperless-Dokumentdateien bleiben dort archiviert und werden referenziert. Eigene Inhalte und Dateien wie gespeicherte E-Mails mit Anhängen, Fotos oder später Sprachaufnahmen können in Tsumugu abgelegt werden; externe Verweise, etwa auf eine E-Mail im IMAP-Konto, bleiben zusätzlich möglich. -**Vorschlag:** Ja. Paperless-Dokumentdateien bleiben wie bestätigt grundsätzlich dort und werden referenziert. Für eigene Inhalte und zugehörige Dateien, etwa gespeicherte E-Mails mit Anhängen, Fotos oder gegebenenfalls Sprachaufnahmen, kann Tsumugu eine eigene geschützte Ablage verwenden. Externe Referenzen, etwa auf eine E-Mail im IMAP-Konto, bleiben daneben möglich. Diese Entscheidung betrifft die Speicherfähigkeit; konkrete Ressourcentypen, Importautomatik, Dateiformate und MVP-Lieferumfang sind damit noch nicht festgelegt. +**Begründung:** Unterschiedliche Informationsarten sollen ohne verpflichtende Übertragung sämtlicher Dateien nach Paperless verwaltbar sein. Tsumugu muss für seine eigenen Dateien Sicherung, Zugriff und Löschung berücksichtigen. -**Abwägung:** Eigene Dateien sind unabhängig von der Verfügbarkeit einer externen Ablage nutzbar und lassen sich im Tsumugu-Rechtekontext verwalten. Dafür muss Tsumugu deren Speicherbedarf, Sicherung und Löschung selbst berücksichtigen. Alternative: Dateien ausschließlich in externen Ablagen halten; Tsumugu speichert nur eigene strukturierte Inhalte und Referenzen. Noch keine Variante beschlossen. Ein späteres Überführen in Paperless und die Behandlung von Originalen/Arbeitskopien sind gesondert zu klären. +**Auswirkungen auf Fachmodell und MVP:** Ressourcen können auf extern gehaltene Inhalte verweisen oder eigene Inhalte/Dateien tragen. Die Herkunft und die zuständige Ablage müssen unterscheidbar sein; es entsteht keine automatische Pflicht, bereits in Paperless gehaltene Dokumentdateien zu duplizieren. Fachliches Prüfszenario: Eine eigene Datei lässt sich berechtigt einem Vorgang zuordnen, ohne eine Paperless-Dokument-ID zu benötigen; ein Paperless-Dokument lässt sich daneben referenzieren. + +**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 + +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? + +**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. + +**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. ## 6. Fortschreibung @@ -248,4 +258,6 @@ Soll Tsumugu neben externen Referenzen auch eigene Dateien und Anhänge dauerhaf 16.10.2026, Arbeitsstand 0.13: S-01f bestätigt: neue Elemente einer geteilten Zusammenstellung erst nach ausdrücklicher, gesammelt möglicher Freigabe sichtbar; Inhaltsänderungen bestehender gemeinsamer Notizen unverändert gemäß F-01b. Ersten Durchgang zu Struktur/Freigaben abgeschlossen, Detailpunkte offen gehalten. Nächste Frage F-02a betrifft eigene Dateien/Anhänge neben externen Referenzen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +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. + 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. -- 2.43.0 From 7e6371a2f36c41131f851c3f4070ee0567f0a660 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:57:03 +0200 Subject: [PATCH 15/58] 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. -- 2.43.0 From 4698718e5d2e6b9745e94880888d65292c252222 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 13:58:15 +0200 Subject: [PATCH 16/58] Bestaetige bewusste Aufloesung konkurrierender Metadatenaenderungen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 0670f1e..3cfe425 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.15, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.16, 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. @@ -37,6 +37,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. 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). +- Eindeutige zulässige Metadatenänderungen werden automatisch abgeglichen. Wurde dasselbe Feld seit dem letzten gemeinsamen Stand in beiden Systemen unterschiedlich geändert, bleiben beide Werte bis zur bewussten Auflösung durch einen berechtigten Nutzer erhalten. Identische neue Werte sind kein Konflikt (F-02c 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 +68,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 (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. | +| 2 / F-02 | Jetzt im Interview: eigene Datei-/Anhangsspeicherung (F-02a), feldweise Zuständigkeit bei bidirektionaler Metadatensynchronisation (F-02b) und bewusste Auflösung echter Änderungskonflikte (F-02c) bestätigt. | Nächster Schritt F-02d: tatsächlich genutzte zusätzliche Paperless-Felder erfassen. Konkrete Feldzuordnung, 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. | @@ -230,15 +231,23 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **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. +**Abgrenzung:** Konfliktbehandlung ist in F-02c geregelt. Offen bleiben die tatsächliche Feldliste und Zuordnung anhand der bestehenden Paperless-Nutzung, feldspezifische Regeln, Synchronisationsauslöser und Berechtigungen. -### F-02c – Widersprüchliche Änderungen beim Metadatenabgleich: nächste Frage, offen +### F-02c – Widersprüchliche Änderungen beim Metadatenabgleich: bestätigt am 16.10.2026 -Sollen unterschiedliche Änderungen desselben Feldes in beiden Systemen seit dem letzten erfolgreichen Abgleich als Konflikt angezeigt werden, den ein berechtigter Nutzer auflöst? +**Beschluss:** Der Nutzer bestätigt: Eindeutige, zulässige Änderungen auf nur einer Seite werden automatisch übernommen. Wurde dasselbe Feld seit dem letzten Abgleich in beiden Systemen unterschiedlich geändert, bleiben beide Werte erhalten, bis ein berechtigter Nutzer den Konflikt bewusst auflöst. Identische neue Werte stellen keinen Konflikt dar. -**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. +**Begründung:** Vermeidet verlorene konkurrierende Änderungen und verlangt nur bei tatsächlichen Widersprüchen einen manuellen Eingriff. Die Feldzuständigkeit aus F-02b dient nicht als automatische Überschreibungsregel für Konflikte. -**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. +**Auswirkungen auf Fachmodell und MVP:** Der Abgleich muss den letzten gemeinsam abgeglichenen Stand gegenüber den aktuellen Werten beider Seiten unterscheiden können. Fachliche Prüfszenarien: Einseitige Änderung wird übernommen; unterschiedliche beidseitige Änderung wird zur Entscheidung angezeigt und nicht still überschrieben; gleiche beidseitige Änderung wird ohne Konflikt behandelt. Darstellung, Wiederholungsversuche, besondere Feldtypen und technische Erkennung bleiben für die Ausarbeitung offen. + +### F-02d – Bestehende zusätzliche Paperless-Felder: nächste Bestandsfrage, offen + +Welche selbst angelegten Felder nutzt der Nutzer aktuell in Paperless, insbesondere für Rechnungen und Erstattungen? + +**Bereits belegt:** Betrag, Zahlungsziel, Statusfelder und Verknüpfungen von Erstattungsbelegen zu Rechnungen werden im ursprünglichen Anwendungsfall erwähnt. Exakte Feldnamen, Datentypen, Statuswerte und die Umsetzung der Verknüpfungen sind nicht bekannt. Daraus wird noch keine vollständige oder verbindliche Synchronisationsfeldliste abgeleitet. + +**Empfehlung zum Vorgehen:** Zunächst die tatsächlich genutzte Struktur anhand einer groben Nutzerliste erfassen und danach die benötigten gemeinsamen Felder auswählen. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden; konkrete Zuordnung und Migrationsbedarf erst anhand der Fachanforderungen festlegen. Keine praktische Paperless-Verbindung oder Änderung an bestehenden Daten in diesem Schritt. ## 6. Fortschreibung @@ -272,4 +281,6 @@ Sollen unterschiedliche Änderungen desselben Feldes in beiden Systemen seit dem 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. +16.10.2026, Arbeitsstand 0.16: F-02c bestätigt: eindeutige zulässige Änderungen automatisch abgleichen, echte konkurrierende Widersprüche ohne stilles Überschreiben zur bewussten Entscheidung erhalten. Nächster Schritt F-02d erfasst die tatsächlich genutzten zusätzlichen Paperless-Felder, bevor konkrete Synchronisationsfelder zugeordnet werden. 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. -- 2.43.0 From 20b431399c5f17c446da4130c70f7f83562fa776 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:10:44 +0200 Subject: [PATCH 17/58] Erfasse bestehende Paperless-Felder fuer Rechnungen und Erstattungen --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 31 +++++++++++++++++++++------- 1 file changed, 24 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 3cfe425..ef453ee 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.16, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.17, 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. @@ -38,6 +38,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. 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). - Eindeutige zulässige Metadatenänderungen werden automatisch abgeglichen. Wurde dasselbe Feld seit dem letzten gemeinsamen Stand in beiden Systemen unterschiedlich geändert, bleiben beide Werte bis zur bewussten Auflösung durch einen berechtigten Nutzer erhalten. Identische neue Werte sind kein Konflikt (F-02c bestätigt). +- Bestehende Paperless-Felder laut Nutzer: Rechnungsbetrag, Erstattungsbetrag, Zahlungsziel, bezahlt_am, erstattet_am, eingerecht_am sowie Ablaufdatum für die Aufbewahrungsfrist (F-02d). Dies ist eine Bestandsangabe, noch keine abschließende Synchronisationsfeldliste oder Feldzuordnung. - 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. @@ -68,8 +69,8 @@ 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 (F-02a), feldweise Zuständigkeit bei bidirektionaler Metadatensynchronisation (F-02b) und bewusste Auflösung echter Änderungskonflikte (F-02c) bestätigt. | Nächster Schritt F-02d: tatsächlich genutzte zusätzliche Paperless-Felder erfassen. Konkrete Feldzuordnung, 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. | +| 2 / F-02 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | +| 3 / F-03 | Jetzt zur Klärung der bestehenden Felder: finanzielle Bedeutung von Erstattung, Geldeingang und Zahlung; danach Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen. | Nächste Frage F-03a: bezeichnet „erstattet_am“ den tatsächlichen Geldeingang oder eine Erstattungsmitteilung? Verhindert Vermischung von Zusage und Zahlung. Manuelle Zuordnung bleibt bestätigt; konkrete Regeln und Umfang offen. | | 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. | @@ -241,13 +242,27 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Der Abgleich muss den letzten gemeinsam abgeglichenen Stand gegenüber den aktuellen Werten beider Seiten unterscheiden können. Fachliche Prüfszenarien: Einseitige Änderung wird übernommen; unterschiedliche beidseitige Änderung wird zur Entscheidung angezeigt und nicht still überschrieben; gleiche beidseitige Änderung wird ohne Konflikt behandelt. Darstellung, Wiederholungsversuche, besondere Feldtypen und technische Erkennung bleiben für die Ausarbeitung offen. -### F-02d – Bestehende zusätzliche Paperless-Felder: nächste Bestandsfrage, offen +### F-02d – Bestehende zusätzliche Paperless-Felder: Nutzerbestand erfasst am 16.10.2026 -Welche selbst angelegten Felder nutzt der Nutzer aktuell in Paperless, insbesondere für Rechnungen und Erstattungen? +Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als Gesprächsangaben gesichert; exakte API-Feldnamen, IDs und Datentypen sind nicht geprüft. -**Bereits belegt:** Betrag, Zahlungsziel, Statusfelder und Verknüpfungen von Erstattungsbelegen zu Rechnungen werden im ursprünglichen Anwendungsfall erwähnt. Exakte Feldnamen, Datentypen, Statuswerte und die Umsetzung der Verknüpfungen sind nicht bekannt. Daraus wird noch keine vollständige oder verbindliche Synchronisationsfeldliste abgeleitet. +| Vom Nutzer benanntes Feld | Gesicherte Bedeutung / noch offene Semantik | +|---|---| +| Rechnungsbetrag | Genanntes Betragsfeld. Währung, brutto/netto und Korrekturregeln noch nicht spezifiziert. | +| Erstattungsbetrag | Genanntes Betragsfeld; mitgeteilter/bewilligter gegenüber tatsächlich eingegangener Betrag noch zu unterscheiden. | +| Zahlungsziel | Bereits im ursprünglichen Anwendungsfall als Fälligkeit der Rechnung beschrieben; Verlängerungen noch zu modellieren. | +| bezahlt_am | Genanntes Zahlungsdatumsfeld; genaue Zahlungszuordnung und Teilzahlungen noch offen. | +| erstattet_am | Genanntes Datumsfeld; Erstattungsmitteilung gegenüber tatsächlichem Geldeingang offen (F-03a). | +| eingerecht_am | Schreibweise aus der Nutzerantwort. Als Einreichungsdatum verstanden; diese Deutung ist eine Arbeitsinterpretation, der genaue Feldname bleibt beim späteren Abgleich zu prüfen. | +| Ablaufdatum | Vom Nutzer ausdrücklich auf die Aufbewahrungsfrist bezogen. Daraus folgt keine bereits beschlossene automatische Löschung oder Fristberechnung. | -**Empfehlung zum Vorgehen:** Zunächst die tatsächlich genutzte Struktur anhand einer groben Nutzerliste erfassen und danach die benötigten gemeinsamen Felder auswählen. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden; konkrete Zuordnung und Migrationsbedarf erst anhand der Fachanforderungen festlegen. Keine praktische Paperless-Verbindung oder Änderung an bestehenden Daten in diesem Schritt. +**Abgrenzung:** Die im Originalchat erwähnten Statusfelder und Verknüpfungen zu Erstattungsbelegen bleiben als Ausgangsanforderung erhalten, sind durch diese Liste aber nicht genauer beschrieben. Aus der Bestandsliste folgen weder eine automatische Übernahme sämtlicher Felder noch eine abschließende Synchronisationsfeldliste. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden. Keine praktische Verbindung oder Änderung an bestehenden Daten. + +### F-03a – Erstattungsdatum gegenüber Mitteilungsdatum: nächste Frage, offen + +Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder das Datum der Erstattungsmitteilung? + +**Empfehlung:** Als Erstattungsdatum den tatsächlichen Geldeingang verstehen und das Datum einer Mitteilung/eines Bescheids bei Bedarf als eigenen Zeitbezug führen. Vorteil: zugesagte Erstattung und verfügbare Zahlung bleiben für die Bearbeitung unterscheidbar; Nachteil: sofern beide Zeitpunkte benötigt werden, reicht ein einzelnes Datumsfeld nicht aus. Das ist noch kein Beschluss über neue Pflichtfelder. Die historische Nutzung des bestehenden Feldes muss erhalten bzw. bei einer späteren Übernahme bewusst abgebildet werden; eine abweichende bestehende Bedeutung wird nicht still umgedeutet. Mehrere Eingänge und Teilzahlungen sind anschließend gesondert zu modellieren. ## 6. Fortschreibung @@ -283,4 +298,6 @@ Welche selbst angelegten Felder nutzt der Nutzer aktuell in Paperless, insbesond 16.10.2026, Arbeitsstand 0.16: F-02c bestätigt: eindeutige zulässige Änderungen automatisch abgleichen, echte konkurrierende Widersprüche ohne stilles Überschreiben zur bewussten Entscheidung erhalten. Nächster Schritt F-02d erfasst die tatsächlich genutzten zusätzlichen Paperless-Felder, bevor konkrete Synchronisationsfelder zugeordnet werden. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.17: Sieben bestehende Paperless-Felder vom Nutzer erfasst (F-02d), einschließlich Ablaufdatum ausdrücklich für Aufbewahrung. Originalschreibweise „eingerecht_am“ erhalten, Einreichungsdatum als Arbeitsinterpretation gekennzeichnet. Vor Feldzuordnung nächste Frage F-03a zur Bedeutung von „erstattet_am“; weitere Integrationspunkte bleiben offen. 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. -- 2.43.0 From 337fcfb544cf6413b4b0bbcf5d41329a9ca129ef Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:12:34 +0200 Subject: [PATCH 18/58] Klaere bestehendes Erstattungsdatum als Datum der Mitteilung --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index ef453ee..e03bd0f 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.17, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.18, 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. @@ -39,6 +39,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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). - Eindeutige zulässige Metadatenänderungen werden automatisch abgeglichen. Wurde dasselbe Feld seit dem letzten gemeinsamen Stand in beiden Systemen unterschiedlich geändert, bleiben beide Werte bis zur bewussten Auflösung durch einen berechtigten Nutzer erhalten. Identische neue Werte sind kein Konflikt (F-02c bestätigt). - Bestehende Paperless-Felder laut Nutzer: Rechnungsbetrag, Erstattungsbetrag, Zahlungsziel, bezahlt_am, erstattet_am, eingerecht_am sowie Ablaufdatum für die Aufbewahrungsfrist (F-02d). Dies ist eine Bestandsangabe, noch keine abschließende Synchronisationsfeldliste oder Feldzuordnung. +- „erstattet_am“ bezeichnet in der bestehenden Nutzung das Datum der Erstattungsmitteilung. Tatsächliche Zahlungseingänge werden bisher nicht überwacht (F-03a bestätigt). Historische Werte sind daher kein Nachweis für einen Geldeingang und dürfen beim späteren Abgleich nicht in Zahlungsdaten umgedeutet werden. - 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. @@ -70,7 +71,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt |---|---|---| | 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | Jetzt zur Klärung der bestehenden Felder: finanzielle Bedeutung von Erstattung, Geldeingang und Zahlung; danach Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen. | Nächste Frage F-03a: bezeichnet „erstattet_am“ den tatsächlichen Geldeingang oder eine Erstattungsmitteilung? Verhindert Vermischung von Zusage und Zahlung. Manuelle Zuordnung bleibt bestätigt; konkrete Regeln und Umfang offen. | +| 3 / F-03 | Jetzt zur Klärung der bestehenden Felder: „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). Manuelle Finanzzuordnung bleibt bestätigter MVP-Rahmen. | Nächste Bestandsfrage F-03b: wird der Erstattungsbetrag je Rechnung, auf dem Sammelbeleg oder auf beiden Ebenen gepflegt? Anschließend Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen konkretisieren. | | 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. | @@ -252,17 +253,27 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G | Erstattungsbetrag | Genanntes Betragsfeld; mitgeteilter/bewilligter gegenüber tatsächlich eingegangener Betrag noch zu unterscheiden. | | Zahlungsziel | Bereits im ursprünglichen Anwendungsfall als Fälligkeit der Rechnung beschrieben; Verlängerungen noch zu modellieren. | | bezahlt_am | Genanntes Zahlungsdatumsfeld; genaue Zahlungszuordnung und Teilzahlungen noch offen. | -| erstattet_am | Genanntes Datumsfeld; Erstattungsmitteilung gegenüber tatsächlichem Geldeingang offen (F-03a). | +| erstattet_am | Datum der Erstattungsmitteilung, kein Datum eines überwachten tatsächlichen Zahlungseingangs (F-03a bestätigt). | | eingerecht_am | Schreibweise aus der Nutzerantwort. Als Einreichungsdatum verstanden; diese Deutung ist eine Arbeitsinterpretation, der genaue Feldname bleibt beim späteren Abgleich zu prüfen. | | Ablaufdatum | Vom Nutzer ausdrücklich auf die Aufbewahrungsfrist bezogen. Daraus folgt keine bereits beschlossene automatische Löschung oder Fristberechnung. | **Abgrenzung:** Die im Originalchat erwähnten Statusfelder und Verknüpfungen zu Erstattungsbelegen bleiben als Ausgangsanforderung erhalten, sind durch diese Liste aber nicht genauer beschrieben. Aus der Bestandsliste folgen weder eine automatische Übernahme sämtlicher Felder noch eine abschließende Synchronisationsfeldliste. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden. Keine praktische Verbindung oder Änderung an bestehenden Daten. -### F-03a – Erstattungsdatum gegenüber Mitteilungsdatum: nächste Frage, offen +### F-03a – Bestehendes Erstattungsdatum ist Mitteilungsdatum: geklärt am 16.10.2026 -Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder das Datum der Erstattungsmitteilung? +**Bestätigte Bestandsangabe:** Der Nutzer erklärt ausdrücklich: „erstattet_am“ bezeichnet aktuell das Datum der Erstattungsmitteilung. Zahlungseingänge überwacht er bisher nicht. -**Empfehlung:** Als Erstattungsdatum den tatsächlichen Geldeingang verstehen und das Datum einer Mitteilung/eines Bescheids bei Bedarf als eigenen Zeitbezug führen. Vorteil: zugesagte Erstattung und verfügbare Zahlung bleiben für die Bearbeitung unterscheidbar; Nachteil: sofern beide Zeitpunkte benötigt werden, reicht ein einzelnes Datumsfeld nicht aus. Das ist noch kein Beschluss über neue Pflichtfelder. Die historische Nutzung des bestehenden Feldes muss erhalten bzw. bei einer späteren Übernahme bewusst abgebildet werden; eine abweichende bestehende Bedeutung wird nicht still umgedeutet. Mehrere Eingänge und Teilzahlungen sind anschließend gesondert zu modellieren. +**Auswirkungen auf Fachmodell und Datenübernahme:** Das bestehende Feld wird fachlich dem Mitteilungsdatum zugeordnet. Seine Werte dürfen weder durch bloße Umbenennung zu Zahlungseingängen werden noch als bestätigte Bankeingänge in Summen/Status einfließen. Dass keine Zahlungseingänge erfasst sind, belegt ebenso wenig, dass tatsächlich kein Geld eingegangen ist. Feldzuordnung und technische Synchronisationsnamen bleiben noch festzulegen. + +**Vorschlag für Tsumugu, noch nicht abschließend beschlossen:** Erstattungsmitteilung, mitgeteilter Betrag und tatsächliche Zahlungseingänge getrennt führen. Die bereits bestätigte manuelle Zahlungszuordnung im MVP bleibt bestehen; konkrete Zahlungsdaten, Teilbeträge und Mehrfachbeziehungen sind als Nächstes zu spezifizieren. Die vorherige Empfehlung, „erstattet_am“ für den Geldeingang zu verwenden, ist durch die Bestandsklärung nicht angenommen und wird nicht auf historische Daten angewandt. + +### F-03b – Bestehende Zuordnung des Erstattungsbetrags: nächste Bestandsfrage, offen + +Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zugerechneter Betrag, an der Erstattungsmitteilung als Gesamtbetrag oder auf beiden Ebenen gepflegt? + +**Zweck:** Die aktuelle Abbildung von Sammelerstattungen verstehen, bevor ein Modell für Betragszuordnungen und die Synchronisationsfelder festgelegt wird. Keine Variante der bestehenden Nutzung wird vorausgesetzt. + +**Empfehlung für das spätere Modell, noch offen:** Gesamtbetrag einer Erstattungsmitteilung und die davon einzelnen Rechnungen zugeordneten Beträge fachlich unterscheiden; tatsächliche Zahlungen zusätzlich getrennt behandeln. Die aktuelle Paperless-Abbildung soll gezielt übernommen/abgebildet werden, ohne die Erweiterbarkeit durch bisherige Feldgrenzen einzuschränken. ## 6. Fortschreibung @@ -300,4 +311,6 @@ Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder 16.10.2026, Arbeitsstand 0.17: Sieben bestehende Paperless-Felder vom Nutzer erfasst (F-02d), einschließlich Ablaufdatum ausdrücklich für Aufbewahrung. Originalschreibweise „eingerecht_am“ erhalten, Einreichungsdatum als Arbeitsinterpretation gekennzeichnet. Vor Feldzuordnung nächste Frage F-03a zur Bedeutung von „erstattet_am“; weitere Integrationspunkte bleiben offen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.18: F-03a als Bestandsklärung gesichert: „erstattet_am“ ist Datum der Erstattungsmitteilung, tatsächliche Zahlungseingänge werden bisher nicht überwacht. Keine Umdeutung historischer Daten; keine Zustimmung zur vorigen Empfehlung eines Eingangsdatums unter diesem Feldnamen angenommen. Nächste Bestandsfrage F-03b betrifft die Ebene des gepflegten Erstattungsbetrags. 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. -- 2.43.0 From bb1c777558f43b4e2474cb64e60376ceb6760c09 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:15:44 +0200 Subject: [PATCH 19/58] Erfasse manuelle Erstattungsbetraege je Rechnung mit Belegreferenz --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index e03bd0f..2e874e6 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.18, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.19, 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. @@ -40,6 +40,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Eindeutige zulässige Metadatenänderungen werden automatisch abgeglichen. Wurde dasselbe Feld seit dem letzten gemeinsamen Stand in beiden Systemen unterschiedlich geändert, bleiben beide Werte bis zur bewussten Auflösung durch einen berechtigten Nutzer erhalten. Identische neue Werte sind kein Konflikt (F-02c bestätigt). - Bestehende Paperless-Felder laut Nutzer: Rechnungsbetrag, Erstattungsbetrag, Zahlungsziel, bezahlt_am, erstattet_am, eingerecht_am sowie Ablaufdatum für die Aufbewahrungsfrist (F-02d). Dies ist eine Bestandsangabe, noch keine abschließende Synchronisationsfeldliste oder Feldzuordnung. - „erstattet_am“ bezeichnet in der bestehenden Nutzung das Datum der Erstattungsmitteilung. Tatsächliche Zahlungseingänge werden bisher nicht überwacht (F-03a bestätigt). Historische Werte sind daher kein Nachweis für einen Geldeingang und dürfen beim späteren Abgleich nicht in Zahlungsdaten umgedeutet werden. +- Der bestehende „Erstattungsbetrag“ wird nur an der Rechnung gepflegt. Rechnungen werden mit Erstattungsbelegen verknüpft; der Nutzer versucht aus deren Angaben die jeweils betroffene Rechnung und den zugehörigen Betrag zu erkennen (F-03b). Dies ist eine manuelle fachliche Zuordnung, kein überwachter Zahlungseingang. - 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. @@ -71,7 +72,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt |---|---|---| | 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | Jetzt zur Klärung der bestehenden Felder: „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). Manuelle Finanzzuordnung bleibt bestätigter MVP-Rahmen. | Nächste Bestandsfrage F-03b: wird der Erstattungsbetrag je Rechnung, auf dem Sammelbeleg oder auf beiden Ebenen gepflegt? Anschließend Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen konkretisieren. | +| 3 / F-03 | „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). „Erstattungsbetrag“ bisher nur an der Rechnung; Referenz zum Beleg und manuelle Interpretation der Belegangaben (F-03b). | Nächste Frage F-03c: mehrere betragsbezogene Erstattungszuordnungen je Rechnung und deren Summe. Zahlungszuordnung, Differenzen und Korrekturen anschließend konkretisieren. | | 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. | @@ -250,7 +251,7 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G | Vom Nutzer benanntes Feld | Gesicherte Bedeutung / noch offene Semantik | |---|---| | Rechnungsbetrag | Genanntes Betragsfeld. Währung, brutto/netto und Korrekturregeln noch nicht spezifiziert. | -| Erstattungsbetrag | Genanntes Betragsfeld; mitgeteilter/bewilligter gegenüber tatsächlich eingegangener Betrag noch zu unterscheiden. | +| Erstattungsbetrag | Wird ausschließlich an der Rechnung gepflegt; Zuordnung aus den Angaben verknüpfter Erstattungsbelege, kein überwachter Zahlungseingang (F-03b). Mehrere Teilzuordnungen noch nicht spezifiziert. | | Zahlungsziel | Bereits im ursprünglichen Anwendungsfall als Fälligkeit der Rechnung beschrieben; Verlängerungen noch zu modellieren. | | bezahlt_am | Genanntes Zahlungsdatumsfeld; genaue Zahlungszuordnung und Teilzahlungen noch offen. | | erstattet_am | Datum der Erstattungsmitteilung, kein Datum eines überwachten tatsächlichen Zahlungseingangs (F-03a bestätigt). | @@ -267,13 +268,21 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Vorschlag für Tsumugu, noch nicht abschließend beschlossen:** Erstattungsmitteilung, mitgeteilter Betrag und tatsächliche Zahlungseingänge getrennt führen. Die bereits bestätigte manuelle Zahlungszuordnung im MVP bleibt bestehen; konkrete Zahlungsdaten, Teilbeträge und Mehrfachbeziehungen sind als Nächstes zu spezifizieren. Die vorherige Empfehlung, „erstattet_am“ für den Geldeingang zu verwenden, ist durch die Bestandsklärung nicht angenommen und wird nicht auf historische Daten angewandt. -### F-03b – Bestehende Zuordnung des Erstattungsbetrags: nächste Bestandsfrage, offen +### F-03b – Bestehende Zuordnung des Erstattungsbetrags: geklärt am 16.10.2026 -Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zugerechneter Betrag, an der Erstattungsmitteilung als Gesamtbetrag oder auf beiden Ebenen gepflegt? +**Bestätigte Bestandsangabe:** Der Nutzer pflegt den Erstattungsbetrag aktuell ausschließlich an der Rechnung. Die Rechnungen werden dem Erstattungsbeleg zugeordnet, sodass eine Referenz entsteht. Aus dem Erstattungsbeleg versucht der Nutzer zu erkennen, auf welche konkrete Rechnung sich die einzelnen Beträge beziehen. Ein eigenes gepflegtes Gesamtbetragsfeld am Erstattungsbeleg ist damit nicht belegt. -**Zweck:** Die aktuelle Abbildung von Sammelerstattungen verstehen, bevor ein Modell für Betragszuordnungen und die Synchronisationsfelder festgelegt wird. Keine Variante der bestehenden Nutzung wird vorausgesetzt. +**Auswirkungen:** Referenz und Betragszuordnung sind fachlich unterscheidbar. Eine bloße Referenz auf einen Sammelbeleg ersetzt noch keine zuverlässige Verteilung seiner Beträge auf Rechnungen. Die Zuordnung kann Interpretation erfordern und darf nicht als automatisch eindeutig oder als Nachweis tatsächlicher Zahlung verstanden werden. Der universelle manuelle Zuordnungsbedarf aus der Recovery wird durch das konkrete Vorgehen bestätigt. -**Empfehlung für das spätere Modell, noch offen:** Gesamtbetrag einer Erstattungsmitteilung und die davon einzelnen Rechnungen zugeordneten Beträge fachlich unterscheiden; tatsächliche Zahlungen zusätzlich getrennt behandeln. Die aktuelle Paperless-Abbildung soll gezielt übernommen/abgebildet werden, ohne die Erweiterbarkeit durch bisherige Feldgrenzen einzuschränken. +**Weiterhin offen:** Umgang mit mehreren Belegen pro Rechnung, Bedeutung/Summierung des einzelnen bisherigen Betragsfeldes in solchen Fällen, Korrekturen und unsichere Zuordnungen. Historische Teilbeträge je Referenz lassen sich aus einem einzelnen Rechnungsfeld nicht ohne gesicherte Grundlage rekonstruieren. + +### F-03c – Mehrere betragsbezogene Erstattungszuordnungen je Rechnung: nächste Frage, offen + +Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und Bezug zum Erstattungsbeleg erhalten können, deren Summe als zugeordneter Erstattungsbetrag angezeigt wird? + +**Vorschlag:** Ja. Ein Erstattungsbeleg kann wie bereits bestätigt mehrere Rechnungen betreffen; zusätzlich kann eine Rechnung mehrere Teil-/Nacherstattungen aus unterschiedlichen Belegen erhalten. Der Betrag gehört fachlich zur jeweiligen Zuordnung, die Rechnung zeigt die Summe dieser Zuordnungen. Beispiel: Rechnung 200 Euro, Beleg A ordnet 120 Euro zu, Beleg B weitere 50 Euro; die zugeordnete Erstattung beträgt 170 Euro. Daraus folgt noch kein tatsächlicher Geldeingang und keine Entscheidung darüber, ob die verbleibenden 30 Euro erwartet, abgelehnt oder ungeklärt sind. + +**Abwägung:** Beträge und Herkunft bleiben nachvollziehbar, ohne frühere Werte bei einer weiteren Erstattung überschreiben zu müssen. Dafür benötigt die Rechnung bei mehreren Belegen eine kurze Liste ihrer Zuordnungen. Alternative: nur ein direkt gepflegter Gesamtwert je Rechnung plus Belegreferenzen ohne eigene Zuordnungsbeträge; weniger Eingaben, aber keine nachvollziehbare Verteilung auf die Belege. Noch keine Variante beschlossen. Korrekturen/Storno, unklare Zuordnungen, Beträge über dem Rechnungsbetrag, Währung und Synchronisation des Summenwerts bleiben offen. ## 6. Fortschreibung @@ -313,4 +322,6 @@ Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zu 16.10.2026, Arbeitsstand 0.18: F-03a als Bestandsklärung gesichert: „erstattet_am“ ist Datum der Erstattungsmitteilung, tatsächliche Zahlungseingänge werden bisher nicht überwacht. Keine Umdeutung historischer Daten; keine Zustimmung zur vorigen Empfehlung eines Eingangsdatums unter diesem Feldnamen angenommen. Nächste Bestandsfrage F-03b betrifft die Ebene des gepflegten Erstattungsbetrags. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.19: F-03b geklärt: Erstattungsbetrag bisher nur an der Rechnung, Referenz zum Erstattungsbeleg; konkrete Rechnung/Beträge werden aus dem Beleg manuell erschlossen. Nächste Frage F-03c betrifft mehrere betragsbezogene Erstattungszuordnungen je Rechnung. 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. -- 2.43.0 From 431007953f502bdab30162e333eeb9c26791aec3 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:18:55 +0200 Subject: [PATCH 20/58] Praezisiere Teilbetraege offene Erstattungen und Aufgabenbezug --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 2e874e6..3eaf6bd 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.19, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.20, 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. @@ -45,6 +45,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. +- Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Nicht erstattbare Restbeträge und genaue Abschlussregeln sind noch zu klären. - Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. ## 3. Ergebnisse des Originalabgleichs @@ -72,7 +73,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt |---|---|---| | 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). „Erstattungsbetrag“ bisher nur an der Rechnung; Referenz zum Beleg und manuelle Interpretation der Belegangaben (F-03b). | Nächste Frage F-03c: mehrere betragsbezogene Erstattungszuordnungen je Rechnung und deren Summe. Zahlungszuordnung, Differenzen und Korrekturen anschließend konkretisieren. | +| 3 / F-03 | Bestehende Erstattungsdaten geklärt (F-03a/b). Mehrfach-/Teilerstattungen als seltene Fälle, offene Rückfragen/Nachweise mit Aufgabenbezug und anteilige Rechnungszahlungen als allgemeiner Bedarf bestätigt (F-03c). | Nächste Frage F-03d: fachlicher Abschluss bei endgültig nicht erstattbarem Restbetrag. Konkrete Betragszuordnungen, Zahlungszuordnung und Korrekturen anschließend konkretisieren. | | 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. | @@ -276,13 +277,23 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Weiterhin offen:** Umgang mit mehreren Belegen pro Rechnung, Bedeutung/Summierung des einzelnen bisherigen Betragsfeldes in solchen Fällen, Korrekturen und unsichere Zuordnungen. Historische Teilbeträge je Referenz lassen sich aus einem einzelnen Rechnungsfeld nicht ohne gesicherte Grundlage rekonstruieren. -### F-03c – Mehrere betragsbezogene Erstattungszuordnungen je Rechnung: nächste Frage, offen +### F-03c – Teilbeträge und offene Erstattungsfälle: Bedarf präzisiert am 16.10.2026 -Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und Bezug zum Erstattungsbeleg erhalten können, deren Summe als zugeordneter Erstattungsbetrag angezeigt wird? +**Bestätigter Bedarf und Gewichtung:** Der Nutzer erklärt, dass eine Erstattung den Vorgang im Regelfall erledigen soll. Mehrere Teil-/Nacherstattungen derselben Rechnung sind in diesem Anwendungsfall eher untypisch, können aber in seltenen Fällen vorkommen. Nicht erstattete Teilbeträge können durch Grenzen entstehen; eine Erstattung kann außerdem wegen Rückfragen oder fehlender Belege noch ausstehen. Solange hierzu Klärungs-/Nachreichungsbedarf besteht, bleibt der Vorgang offen und muss in der Aufgabenliste berücksichtigt werden. In anderen Anwendungsfällen sind anteilige Zahlungen auf eine Rechnung ausdrücklich relevant. -**Vorschlag:** Ja. Ein Erstattungsbeleg kann wie bereits bestätigt mehrere Rechnungen betreffen; zusätzlich kann eine Rechnung mehrere Teil-/Nacherstattungen aus unterschiedlichen Belegen erhalten. Der Betrag gehört fachlich zur jeweiligen Zuordnung, die Rechnung zeigt die Summe dieser Zuordnungen. Beispiel: Rechnung 200 Euro, Beleg A ordnet 120 Euro zu, Beleg B weitere 50 Euro; die zugeordnete Erstattung beträgt 170 Euro. Daraus folgt noch kein tatsächlicher Geldeingang und keine Entscheidung darüber, ob die verbleibenden 30 Euro erwartet, abgelehnt oder ungeklärt sind. +**Auswirkungen auf Fachmodell und MVP:** Ein Modell, das pro Rechnung zwingend nur eine Erstattung oder eine Zahlung zulässt, deckt den beschriebenen Bedarf nicht ab. Der häufige einfache Fall soll einfach bedienbar bleiben; weitere Teilbeträge kommen bei Bedarf hinzu. Eine unvollständige Erstattung, ein endgültig nicht erstattbarer Anteil, eine noch offene fachliche Klärung und eine tatsächliche Teilzahlung sind unterschiedliche Sachverhalte. Das Modell darf nicht auf Krankenkassenerstattungen begrenzt werden. -**Abwägung:** Beträge und Herkunft bleiben nachvollziehbar, ohne frühere Werte bei einer weiteren Erstattung überschreiben zu müssen. Dafür benötigt die Rechnung bei mehreren Belegen eine kurze Liste ihrer Zuordnungen. Alternative: nur ein direkt gepflegter Gesamtwert je Rechnung plus Belegreferenzen ohne eigene Zuordnungsbeträge; weniger Eingaben, aber keine nachvollziehbare Verteilung auf die Belege. Noch keine Variante beschlossen. Korrekturen/Storno, unklare Zuordnungen, Beträge über dem Rechnungsbetrag, Währung und Synchronisation des Summenwerts bleiben offen. +**Weiterführender Modellvorschlag:** Beträge je Beziehung zwischen Rechnung und Erstattungsbeleg nachvollziehbar erfassen und an der Rechnung summieren; Zahlungen separat betragsbezogen zuordnen. Die Nutzerantwort bestätigt den Bedarf an Teil-/Mehrfachfällen und deren geringe Häufigkeit im Erstattungsfall, noch keine vollständige Feld-/Summen-/Korrekturregel. Fachliches Prüfszenario für die spätere Ausarbeitung: Eine ausstehende Erstattung mit nachzureichendem Beleg bleibt offen und erscheint mit dem nötigen Handlungsbedarf in der Aufgabenliste; eine anteilig bezahlte Rechnung verliert die Information über den noch offenen Zahlungsbetrag nicht. + +**Weiterhin offen:** Umgang mit endgültig nicht erstattbaren Anteilen (F-03d), Bedeutung von „Vorgang“ im konkreten Erstattungsablauf gegenüber einzelner Rechnung/Sammelabrechnung, Abschluss im Verhältnis zu Zahlungseingängen, Aufgabenanlage/-zuordnung/-fristen, Korrekturen/Storno, unklare Zuordnungen und Synchronisation von Summenwerten. „In der Aufgabenliste“ bedeutet noch keine beschlossene automatische Erzeugung separater Aufgaben für jede offene Rechnung. + +### F-03d – Abschluss bei endgültig nicht erstattbarem Anteil: nächste Frage, offen + +Soll ein Erstattungsvorgang fachlich abgeschlossen werden können, wenn der nicht erstattete Restbetrag endgültig geklärt und als nicht erstattbar akzeptiert ist? + +**Vorschlag:** Ja. Beispiel: Von 200 Euro Rechnungsbetrag werden 170 Euro erstattet; 30 Euro sind wegen einer bestätigten Grenze endgültig nicht erstattbar und es wird keine weitere Klärung verfolgt. Der Vorgang kann dann fachlich abgeschlossen werden, obwohl keine vollständige Erstattung vorliegt. Besteht dagegen noch eine Rückfrage oder wird ein weiterer Betrag erwartet, bleibt die Bearbeitung offen und der Handlungsbedarf sichtbar. Vorteil: bekannte nicht erstattbare Anteile erzeugen keine dauerhaften falschen offenen Erstattungsfälle; Nachteil: der Unterschied zwischen akzeptiertem Abschluss und weiter zu verfolgendem Rest muss ausdrücklich erkennbar sein. + +**Abgrenzung des Vorschlags:** Ein fachlicher Abschluss ist kein Nachweis eines tatsächlichen Geldeingangs oder der vollständigen Zahlung der Rechnung. Die genaue Abschlussregel im Verhältnis zu separaten Zahlungsvorgängen bleibt offen. Ein Restbetrag wird nicht allein wegen seiner Höhe oder einer vermuteten Grenze automatisch als endgültig nicht erstattbar behandelt. Noch keine Entscheidung hierzu getroffen. ## 6. Fortschreibung @@ -324,4 +335,6 @@ Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und 16.10.2026, Arbeitsstand 0.19: F-03b geklärt: Erstattungsbetrag bisher nur an der Rechnung, Referenz zum Erstattungsbeleg; konkrete Rechnung/Beträge werden aus dem Beleg manuell erschlossen. Nächste Frage F-03c betrifft mehrere betragsbezogene Erstattungszuordnungen je Rechnung. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.20: Nutzer präzisiert F-03c: einfache vollständige Erledigung als Erstattungsregelfall, seltene Teil-/Nacherstattungen, offene Rückfragen/Nachweise mit Aufgabenbezug; anteilige Rechnungszahlungen in anderen Anwendungsfällen relevant. Bedarf gesichert, keine pauschale Freigabe aller vorgeschlagenen Betrags-/Statusregeln angenommen. Nächste Frage F-03d betrifft Abschluss bei endgültig nicht erstattbarem Rest. 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. -- 2.43.0 From c6ed2f86f59c2fbe61b4a26bdc2fbef4ef901e49 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:21:09 +0200 Subject: [PATCH 21/58] Bestaetige Erstattungsabschluss bei akzeptiertem Eigenanteil --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 29 ++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 3eaf6bd..89664ff 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.20, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.21, 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. @@ -45,7 +45,8 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. -- Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Nicht erstattbare Restbeträge und genaue Abschlussregeln sind noch zu klären. +- Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Die Behandlung akzeptierter nicht erstattbarer Anteile ist in F-03d geregelt; konkrete Status- und Gesamtabschlussregeln bleiben offen. +- Die Erstattungsbearbeitung kann bei einem endgültig geklärten und akzeptierten nicht erstattbaren Anteil fachlich abgeschlossen werden. Besteht noch Klärungsbedarf oder wird weitere Erstattung erwartet, bleibt sie offen. Fachlicher Erstattungsabschluss, tatsächlicher Geldeingang und Bezahlung der Rechnung sind getrennte Sachverhalte (F-03d bestätigt). - Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. ## 3. Ergebnisse des Originalabgleichs @@ -73,7 +74,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt |---|---|---| | 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | Bestehende Erstattungsdaten geklärt (F-03a/b). Mehrfach-/Teilerstattungen als seltene Fälle, offene Rückfragen/Nachweise mit Aufgabenbezug und anteilige Rechnungszahlungen als allgemeiner Bedarf bestätigt (F-03c). | Nächste Frage F-03d: fachlicher Abschluss bei endgültig nicht erstattbarem Restbetrag. Konkrete Betragszuordnungen, Zahlungszuordnung und Korrekturen anschließend konkretisieren. | +| 3 / F-03 | Bestehende Erstattungsdaten geklärt (F-03a/b). Teilbeträge und Aufgabenbezug (F-03c) sowie fachlicher Erstattungsabschluss bei akzeptiertem Eigenanteil (F-03d) bestätigt. | Nächste Frage F-03e: eigener Zahlungs-/Erstattungsstand jeder Rechnung gegenüber dem Gesamtstatus eines Vorgangs. Konkrete Betrags-/Zahlungszuordnung und Korrekturen bleiben offen. | | 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. | @@ -285,15 +286,25 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Weiterführender Modellvorschlag:** Beträge je Beziehung zwischen Rechnung und Erstattungsbeleg nachvollziehbar erfassen und an der Rechnung summieren; Zahlungen separat betragsbezogen zuordnen. Die Nutzerantwort bestätigt den Bedarf an Teil-/Mehrfachfällen und deren geringe Häufigkeit im Erstattungsfall, noch keine vollständige Feld-/Summen-/Korrekturregel. Fachliches Prüfszenario für die spätere Ausarbeitung: Eine ausstehende Erstattung mit nachzureichendem Beleg bleibt offen und erscheint mit dem nötigen Handlungsbedarf in der Aufgabenliste; eine anteilig bezahlte Rechnung verliert die Information über den noch offenen Zahlungsbetrag nicht. -**Weiterhin offen:** Umgang mit endgültig nicht erstattbaren Anteilen (F-03d), Bedeutung von „Vorgang“ im konkreten Erstattungsablauf gegenüber einzelner Rechnung/Sammelabrechnung, Abschluss im Verhältnis zu Zahlungseingängen, Aufgabenanlage/-zuordnung/-fristen, Korrekturen/Storno, unklare Zuordnungen und Synchronisation von Summenwerten. „In der Aufgabenliste“ bedeutet noch keine beschlossene automatische Erzeugung separater Aufgaben für jede offene Rechnung. +**Abgrenzung:** Endgültig nicht erstattbare Anteile sind in F-03d geregelt. Offen bleiben die Bedeutung von „Vorgang“ im konkreten Erstattungsablauf gegenüber einzelner Rechnung/Sammelabrechnung, Gesamtabschluss im Verhältnis zu offenen Zahlungen, Aufgabenanlage/-zuordnung/-fristen, Korrekturen/Storno, unklare Zuordnungen und Synchronisation von Summenwerten. „In der Aufgabenliste“ bedeutet noch keine beschlossene automatische Erzeugung separater Aufgaben für jede offene Rechnung. -### F-03d – Abschluss bei endgültig nicht erstattbarem Anteil: nächste Frage, offen +### F-03d – Abschluss bei endgültig nicht erstattbarem Anteil: bestätigt am 16.10.2026 -Soll ein Erstattungsvorgang fachlich abgeschlossen werden können, wenn der nicht erstattete Restbetrag endgültig geklärt und als nicht erstattbar akzeptiert ist? +**Beschluss:** Der Nutzer bestätigt: Ein Erstattungsvorgang beziehungsweise dessen Erstattungsbearbeitung kann fachlich abgeschlossen werden, wenn ein verbleibender nicht erstattbarer Anteil endgültig geklärt und akzeptiert ist. Besteht noch Klärungsbedarf oder wird weitere Erstattung erwartet, bleibt die Bearbeitung offen. Tatsächlicher Geldeingang und Bezahlung der Rechnung sind davon getrennte Sachverhalte. -**Vorschlag:** Ja. Beispiel: Von 200 Euro Rechnungsbetrag werden 170 Euro erstattet; 30 Euro sind wegen einer bestätigten Grenze endgültig nicht erstattbar und es wird keine weitere Klärung verfolgt. Der Vorgang kann dann fachlich abgeschlossen werden, obwohl keine vollständige Erstattung vorliegt. Besteht dagegen noch eine Rückfrage oder wird ein weiterer Betrag erwartet, bleibt die Bearbeitung offen und der Handlungsbedarf sichtbar. Vorteil: bekannte nicht erstattbare Anteile erzeugen keine dauerhaften falschen offenen Erstattungsfälle; Nachteil: der Unterschied zwischen akzeptiertem Abschluss und weiter zu verfolgendem Rest muss ausdrücklich erkennbar sein. +**Begründung:** Akzeptierte endgültig nicht erstattbare Beträge erzeugen keine dauerhaft offenen Erstattungsfälle. Beispiel: Rechnung 200 Euro, Erstattung 170 Euro, endgültig akzeptierter Eigenanteil 30 Euro; die Erstattungsbearbeitung kann erledigt sein. -**Abgrenzung des Vorschlags:** Ein fachlicher Abschluss ist kein Nachweis eines tatsächlichen Geldeingangs oder der vollständigen Zahlung der Rechnung. Die genaue Abschlussregel im Verhältnis zu separaten Zahlungsvorgängen bleibt offen. Ein Restbetrag wird nicht allein wegen seiner Höhe oder einer vermuteten Grenze automatisch als endgültig nicht erstattbar behandelt. Noch keine Entscheidung hierzu getroffen. +**Auswirkungen auf Fachmodell und MVP:** Offener, weiter zu verfolgender Erstattungsrest und akzeptierter endgültiger Eigenanteil müssen fachlich unterscheidbar bleiben. Fachliches Prüfszenario: Der bestätigte Eigenanteil hält die Erstattungsbearbeitung nicht offen; eine ausstehende Belegnachreichung oder erwartete weitere Erstattung dagegen schon. Ein fachlicher Abschluss ist kein Zahlungsnachweis. Aus einem Restbetrag allein lässt sich dessen endgültige Akzeptanz nicht ableiten. + +**Weiterhin offen:** Konkrete Statuswerte, Speicherung der Akzeptanz/Begründung, Wiederaufnahme sowie die Ableitung eines Gesamtstatus bei mehreren Rechnungen oder offenen Zahlungen. Keine automatische Komplettschließung eines umfangreicheren Vorgangs aus einer einzelnen Erstattung abgeleitet. + +### F-03e – Rechnungsbezogener Bearbeitungsstand gegenüber Vorgangsstatus: nächste Frage, offen + +Sollen Rechnungen ihren eigenen Zahlungsstand und gegebenenfalls Erstattungsstand führen, unabhängig vom Gesamtstatus des Vorgangs, in den sie eingebunden sind? + +**Vorschlag:** Ja. Ein Vorgang kann mehrere Rechnungen zusammenführen; jede behält ihre eigenen Beträge, Zahlungsziele, Zahlungen und gegebenenfalls Erstattungszuordnungen. Beispiel: In einem Behandlungsvorgang ist die Erstattungsbearbeitung für Rechnung A erledigt, für Rechnung B fehlt noch ein Beleg. Der Handlungsbedarf von B bleibt einzeln sichtbar. Eine Rechnung ohne Erstattungsbezug benötigt keinen künstlichen Erstattungsablauf. Vorteil: unterschiedliche Bearbeitungsstände bleiben auch in größeren Zusammenhängen sichtbar; Nachteil: Gesamtstatus und Rechnungsstände sind getrennt anzuzeigen. + +**Alternative:** Bearbeitungsstand ausschließlich am Vorgang führen und für unabhängig zu verfolgende Rechnungen jeweils eigene Vorgänge/Teilvorgänge verlangen. Das vereinfacht den Rechnungsdatensatz, erzeugt aber zusätzliche Struktur im Alltag. Noch keine Variante beschlossen; genaue Statuswerte und automatische Zusammenfassung/Abschlussregeln sind nicht Gegenstand dieser Frage. ## 6. Fortschreibung @@ -337,4 +348,6 @@ Soll ein Erstattungsvorgang fachlich abgeschlossen werden können, wenn der nich 16.10.2026, Arbeitsstand 0.20: Nutzer präzisiert F-03c: einfache vollständige Erledigung als Erstattungsregelfall, seltene Teil-/Nacherstattungen, offene Rückfragen/Nachweise mit Aufgabenbezug; anteilige Rechnungszahlungen in anderen Anwendungsfällen relevant. Bedarf gesichert, keine pauschale Freigabe aller vorgeschlagenen Betrags-/Statusregeln angenommen. Nächste Frage F-03d betrifft Abschluss bei endgültig nicht erstattbarem Rest. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.21: F-03d bestätigt: endgültig geklärter und akzeptierter Eigenanteil erlaubt fachlichen Abschluss der Erstattungsbearbeitung; Klärungsbedarf/erwartete weitere Erstattung bleibt offen. Zahlungsnachweise und Gesamtstatus eines umfangreicheren Vorgangs sind damit nicht automatisch entschieden. Nächste Frage F-03e betrifft rechnungseigene Zahlungs-/Erstattungsstände. 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. -- 2.43.0 From 2afdb50ee96f75053a260c80448be8cbfba40b39 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:29:39 +0200 Subject: [PATCH 22/58] Bestaetige rechnungseigene Zahlungs- und Erstattungsstaende --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 89664ff..b2d5231 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.21, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.22, 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. @@ -47,6 +47,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. - Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Die Behandlung akzeptierter nicht erstattbarer Anteile ist in F-03d geregelt; konkrete Status- und Gesamtabschlussregeln bleiben offen. - Die Erstattungsbearbeitung kann bei einem endgültig geklärten und akzeptierten nicht erstattbaren Anteil fachlich abgeschlossen werden. Besteht noch Klärungsbedarf oder wird weitere Erstattung erwartet, bleibt sie offen. Fachlicher Erstattungsabschluss, tatsächlicher Geldeingang und Bezahlung der Rechnung sind getrennte Sachverhalte (F-03d bestätigt). +- Rechnungen führen einen eigenen Zahlungsstand und gegebenenfalls Erstattungsstand unabhängig vom Gesamtstatus ihres Vorgangs. Mehrere Rechnungen können in einem Vorgang zusammengeführt werden, ohne pro Rechnung zwingend einen eigenen Vorgang anzulegen. Einzelner Handlungsbedarf bleibt sichtbar; Rechnungen ohne Erstattungsbezug benötigen keinen Erstattungsablauf (F-03e bestätigt). - Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. ## 3. Ergebnisse des Originalabgleichs @@ -74,8 +75,8 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt |---|---|---| | 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | Bestehende Erstattungsdaten geklärt (F-03a/b). Teilbeträge und Aufgabenbezug (F-03c) sowie fachlicher Erstattungsabschluss bei akzeptiertem Eigenanteil (F-03d) bestätigt. | Nächste Frage F-03e: eigener Zahlungs-/Erstattungsstand jeder Rechnung gegenüber dem Gesamtstatus eines Vorgangs. Konkrete Betrags-/Zahlungszuordnung und Korrekturen bleiben offen. | -| 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. | +| 3 / F-03 | Erster Durchgang abgeschlossen: bestehende Erstattungsdaten (F-03a/b), Teilbeträge/Aufgabenbezug (F-03c), akzeptierter Eigenanteil (F-03d) und rechnungseigene Zahlungs-/Erstattungsstände (F-03e). | Konkrete Betrags-/Zahlungszuordnung, Summen, Statuswerte, Korrekturen und Synchronisationsabbildung bleiben für die Ausarbeitung offen. | +| 4 / F-04 | Jetzt im Interview: fachliche Chronologie, Aufgaben und Fristen. | Nächste Frage F-04a: Frist als eigenständiger Sachverhalt unabhängig von einer Aufgabe. Ereignistypen, belegte/unsichere Zeitangaben, Verlängerungen und Erinnerungen anschließend klären. Keine automatische Rechtsfristberechnung vorausgesetzt. | | 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. | 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. @@ -298,13 +299,21 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Weiterhin offen:** Konkrete Statuswerte, Speicherung der Akzeptanz/Begründung, Wiederaufnahme sowie die Ableitung eines Gesamtstatus bei mehreren Rechnungen oder offenen Zahlungen. Keine automatische Komplettschließung eines umfangreicheren Vorgangs aus einer einzelnen Erstattung abgeleitet. -### F-03e – Rechnungsbezogener Bearbeitungsstand gegenüber Vorgangsstatus: nächste Frage, offen +### F-03e – Rechnungsbezogener Bearbeitungsstand gegenüber Vorgangsstatus: bestätigt am 16.10.2026 -Sollen Rechnungen ihren eigenen Zahlungsstand und gegebenenfalls Erstattungsstand führen, unabhängig vom Gesamtstatus des Vorgangs, in den sie eingebunden sind? +**Beschluss:** Der Nutzer bestätigt: Einzelne Rechnungen führen ihren eigenen Zahlungsstand und gegebenenfalls Erstattungsstand unabhängig vom Gesamtstatus ihres Vorgangs. Ein Vorgang kann mehrere Rechnungen zusammenführen; deren unterschiedlicher Handlungsbedarf bleibt einzeln sichtbar. Es besteht kein Zwang, für jede Rechnung einen eigenen Vorgang anzulegen. Rechnungen ohne Erstattungsbezug benötigen keinen Erstattungsablauf. -**Vorschlag:** Ja. Ein Vorgang kann mehrere Rechnungen zusammenführen; jede behält ihre eigenen Beträge, Zahlungsziele, Zahlungen und gegebenenfalls Erstattungszuordnungen. Beispiel: In einem Behandlungsvorgang ist die Erstattungsbearbeitung für Rechnung A erledigt, für Rechnung B fehlt noch ein Beleg. Der Handlungsbedarf von B bleibt einzeln sichtbar. Eine Rechnung ohne Erstattungsbezug benötigt keinen künstlichen Erstattungsablauf. Vorteil: unterschiedliche Bearbeitungsstände bleiben auch in größeren Zusammenhängen sichtbar; Nachteil: Gesamtstatus und Rechnungsstände sind getrennt anzuzeigen. +**Begründung:** Unterschiedliche Bearbeitungsstände bleiben auch in größeren Zusammenhängen sichtbar, ohne zusätzliche Vorgänge/Teilvorgänge nur für die Statusführung zu verlangen. Rechnungsstände und Gesamtstatus werden dafür getrennt dargestellt. -**Alternative:** Bearbeitungsstand ausschließlich am Vorgang führen und für unabhängig zu verfolgende Rechnungen jeweils eigene Vorgänge/Teilvorgänge verlangen. Das vereinfacht den Rechnungsdatensatz, erzeugt aber zusätzliche Struktur im Alltag. Noch keine Variante beschlossen; genaue Statuswerte und automatische Zusammenfassung/Abschlussregeln sind nicht Gegenstand dieser Frage. +**Auswirkungen auf Fachmodell und MVP:** Rechnung, Zahlungsstand, Erstattungsbearbeitung und Gesamtvorgang sind unterscheidbar. Fachliches Prüfszenario: Rechnung A ist bezahlt und ihre Erstattung erledigt, Rechnung B benötigt noch eine Belegnachreichung; die offene Bearbeitung von B bleibt im selben Vorgang sichtbar. Konkrete Statuswerte, Ableitung aus Betragszuordnungen und automatische Gesamtabschlussregeln bleiben offen. + +### F-04a – Frist unabhängig von einer Aufgabe: nächste Frage, offen + +Soll eine Frist unabhängig von einer Aufgabe an einem Vorgang oder Fachobjekt, etwa einer Rechnung, bestehen können, während Aufgaben zu ihrer Einhaltung damit verknüpft werden? + +**Vorschlag:** Ja. Eine Frist beschreibt den maßgeblichen Termin, eine Aufgabe eine zu erledigende Tätigkeit. Beispiel: Antwortfrist 30. November; dazu Aufgabe „Unterlagen vorbereiten“ mit eigenem Arbeitsziel 25. November. Auch wenn die Vorbereitungsaufgabe erledigt ist, folgt daraus noch nicht, dass die Antwortfrist eingehalten wurde. Umgekehrt kann eine Aufgabe ohne Frist existieren. Vorteil: Frist und Vorbereitung gehen nicht ineinander verloren; Nachteil: beide Sachverhalte müssen verständlich verbunden dargestellt werden. + +**Alternative:** Fristen ausschließlich als Fälligkeitsdatum von Aufgaben führen. Das benötigt weniger verschiedene Fachobjekte, erschwert aber die Unterscheidung von maßgeblichem Termin und vorbereitenden Tätigkeiten. Noch keine Variante beschlossen. Friststatus, Abschlussnachweis, Berechnung, Verlängerung und Erinnerungen sind mit dieser Frage nicht festgelegt. ## 6. Fortschreibung @@ -350,4 +359,6 @@ Sollen Rechnungen ihren eigenen Zahlungsstand und gegebenenfalls Erstattungsstan 16.10.2026, Arbeitsstand 0.21: F-03d bestätigt: endgültig geklärter und akzeptierter Eigenanteil erlaubt fachlichen Abschluss der Erstattungsbearbeitung; Klärungsbedarf/erwartete weitere Erstattung bleibt offen. Zahlungsnachweise und Gesamtstatus eines umfangreicheren Vorgangs sind damit nicht automatisch entschieden. Nächste Frage F-03e betrifft rechnungseigene Zahlungs-/Erstattungsstände. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.22: F-03e bestätigt: eigener Zahlungs-/Erstattungsstand je Rechnung unabhängig vom Gesamtvorgang, ohne Pflicht zu einem Vorgang je Rechnung. Ersten Finanzdurchgang abgeschlossen, konkrete Zuordnungs-/Korrekturregeln offen gehalten. Nächste Frage F-04a betrifft Fristen unabhängig von Aufgaben. 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. -- 2.43.0 From 94390797c1f794e07109401a44acd6caeb0da6bd Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:33:26 +0200 Subject: [PATCH 23/58] Bestaetige eigenstaendige Fristen und pragmatische MVP-Ausrichtung --- docs/product/TSUMUGU_PRODUCT_SPEC.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index b2d5231..8e4f91b 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.22, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.23, 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. @@ -44,6 +44,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. +- Eine Frist kann unabhängig von einer Aufgabe bestehen; Tätigkeiten zu ihrer Einhaltung können damit verknüpft werden. Eine Vorbereitungsaufgabe darf einen früheren Arbeitstermin haben als die maßgebliche Frist. Ihre Erledigung weist nicht automatisch die Fristeinhaltung nach; Aufgaben ohne Frist sind ebenfalls möglich (F-04a bestätigt). - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. - Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Die Behandlung akzeptierter nicht erstattbarer Anteile ist in F-03d geregelt; konkrete Status- und Gesamtabschlussregeln bleiben offen. - Die Erstattungsbearbeitung kann bei einem endgültig geklärten und akzeptierten nicht erstattbaren Anteil fachlich abgeschlossen werden. Besteht noch Klärungsbedarf oder wird weitere Erstattung erwartet, bleibt sie offen. Fachlicher Erstattungsabschluss, tatsächlicher Geldeingang und Bezahlung der Rechnung sind getrennte Sachverhalte (F-03d bestätigt). @@ -74,13 +75,17 @@ 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 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | +| 2 / F-02 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d), Erstattungssemantik in F-03a/b geklärt. | Konkrete Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen und werden für den gewählten MVP-Schnitt gezielt ausgearbeitet. | | 3 / F-03 | Erster Durchgang abgeschlossen: bestehende Erstattungsdaten (F-03a/b), Teilbeträge/Aufgabenbezug (F-03c), akzeptierter Eigenanteil (F-03d) und rechnungseigene Zahlungs-/Erstattungsstände (F-03e). | Konkrete Betrags-/Zahlungszuordnung, Summen, Statuswerte, Korrekturen und Synchronisationsabbildung bleiben für die Ausarbeitung offen. | -| 4 / F-04 | Jetzt im Interview: fachliche Chronologie, Aufgaben und Fristen. | Nächste Frage F-04a: Frist als eigenständiger Sachverhalt unabhängig von einer Aufgabe. Ereignistypen, belegte/unsichere Zeitangaben, Verlängerungen und Erinnerungen anschließend klären. Keine automatische Rechtsfristberechnung vorausgesetzt. | +| 4 / F-04 | Frist als eigenständiger Sachverhalt unabhängig von einer Aufgabe bestätigt (F-04a). | Weitere Klärung auf für Organisation/Nachverfolgung und den MVP tatsächlich blockierende Punkte begrenzen. Konkrete Ereignistypen, Verlängerungen und Erinnerungen nicht vorab für sämtliche Sonderfälle ausarbeiten. Keine automatische Rechtsfristberechnung vorausgesetzt. | | 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. | 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. +**Aktuelle Nutzersteuerung vom 16.10.2026 – pragmatischer MVP:** Der Nutzer bestätigt F-04a und verlangt eine begrenzte Detaillierung, um bald mit einem MVP als Keimzelle iterativer Entwicklung zu beginnen. Wichtige Grundfragen zu Organisation und Nachverfolgung bleiben zentral zu klären; die beiden Validierungsfälle werden nicht vor der Umsetzung bis in alle Sonderfälle vollständig spezifiziert. Nächster praktischer Arbeitsschritt ist eine kompakte, überprüfbare MVP-Abgrenzung aus dem bestätigten Kern mit nur den noch blockierenden Grundfragen. Bestehende Anforderungen bleiben erhalten; zeitliche Zurückstellungen sind als Vorschläge ausdrücklich kenntlich zu machen. Dies ist keine Freigabe zur Änderung von Anwendungscode, Datenbanken oder Deployments. + +**Die ursprünglichen Validierungsfälle:** (1) Mietangelegenheiten/Rechtsstreitigkeiten mit Kommunikation, nachvollziehbarer Chronologie, Aufgaben, Fristen und später gezielter Zusammenarbeit mit einem Anwalt. (2) Krankenkassenabrechnung/Erstattungen mit Rechnungen, Einreichung, Sammelerstattungsbelegen, manuellen Betragszuordnungen, Zahlungszielen und Nachverfolgung offener Klärungen. Das universelle Produktmodell wird an beiden geprüft, nicht auf diese Fälle beschränkt. + ## 5. Interviewentscheidungen ### F-01a – Aktenrechte und kontextbezogene Freigabe: bestätigt am 16.10.2026 @@ -307,13 +312,13 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Auswirkungen auf Fachmodell und MVP:** Rechnung, Zahlungsstand, Erstattungsbearbeitung und Gesamtvorgang sind unterscheidbar. Fachliches Prüfszenario: Rechnung A ist bezahlt und ihre Erstattung erledigt, Rechnung B benötigt noch eine Belegnachreichung; die offene Bearbeitung von B bleibt im selben Vorgang sichtbar. Konkrete Statuswerte, Ableitung aus Betragszuordnungen und automatische Gesamtabschlussregeln bleiben offen. -### F-04a – Frist unabhängig von einer Aufgabe: nächste Frage, offen +### F-04a – Frist unabhängig von einer Aufgabe: bestätigt am 16.10.2026 -Soll eine Frist unabhängig von einer Aufgabe an einem Vorgang oder Fachobjekt, etwa einer Rechnung, bestehen können, während Aufgaben zu ihrer Einhaltung damit verknüpft werden? +**Beschluss:** Der Nutzer bestätigt: Eine Frist kann unabhängig von einer Aufgabe an einem Vorgang oder Fachobjekt bestehen, während Aufgaben zu ihrer Einhaltung damit verknüpft werden. Maßgeblicher Termin und vorbereitende Tätigkeit sind getrennt. Eine Aufgabe kann auch ohne Frist existieren. -**Vorschlag:** Ja. Eine Frist beschreibt den maßgeblichen Termin, eine Aufgabe eine zu erledigende Tätigkeit. Beispiel: Antwortfrist 30. November; dazu Aufgabe „Unterlagen vorbereiten“ mit eigenem Arbeitsziel 25. November. Auch wenn die Vorbereitungsaufgabe erledigt ist, folgt daraus noch nicht, dass die Antwortfrist eingehalten wurde. Umgekehrt kann eine Aufgabe ohne Frist existieren. Vorteil: Frist und Vorbereitung gehen nicht ineinander verloren; Nachteil: beide Sachverhalte müssen verständlich verbunden dargestellt werden. +**Begründung und Auswirkungen:** Maßgebliche Termine und vorbereitende Arbeit dürfen nicht ineinander verloren gehen. Beispiel: Antwortfrist 30. November, Unterlagen vorbereiten bis 25. November. Das Erledigen der Vorbereitung belegt noch keine Einhaltung der Antwortfrist. Fachliches MVP-Prüfszenario: Die vorbereitende Aufgabe wird erledigt, die verknüpfte Frist bleibt bis zur gesondert geregelten Erfüllung als Sachverhalt bestehen. -**Alternative:** Fristen ausschließlich als Fälligkeitsdatum von Aufgaben führen. Das benötigt weniger verschiedene Fachobjekte, erschwert aber die Unterscheidung von maßgeblichem Termin und vorbereitenden Tätigkeiten. Noch keine Variante beschlossen. Friststatus, Abschlussnachweis, Berechnung, Verlängerung und Erinnerungen sind mit dieser Frage nicht festgelegt. +**Weiterhin offen:** Friststatus, Abschlussnachweis, Berechnung, Verlängerung und Erinnerungen. Gemäß aktueller Nutzersteuerung werden diese Punkte nur so weit geklärt, wie es die Organisation/Nachverfolgung im gewählten MVP erfordert; keine weitere umfassende Sonderfallrunde gestartet. ## 6. Fortschreibung @@ -361,4 +366,6 @@ Soll eine Frist unabhängig von einer Aufgabe an einem Vorgang oder Fachobjekt, 16.10.2026, Arbeitsstand 0.22: F-03e bestätigt: eigener Zahlungs-/Erstattungsstand je Rechnung unabhängig vom Gesamtvorgang, ohne Pflicht zu einem Vorgang je Rechnung. Ersten Finanzdurchgang abgeschlossen, konkrete Zuordnungs-/Korrekturregeln offen gehalten. Nächste Frage F-04a betrifft Fristen unabhängig von Aufgaben. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.23: F-04a bestätigt: Frist und Aufgabe getrennt, miteinander verknüpfbar. Nutzersteuerung zu pragmatischer Detaillierung und baldiger MVP-Umsetzung gesichert; zentrale Grundfragen zu Organisation/Nachverfolgung bleiben wichtig. Beide ursprünglichen Validierungsfälle festgehalten. Keine nächste Detailfrage angefügt; nächste Ausarbeitung auf kompakte MVP-Abgrenzung ausrichten. 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. -- 2.43.0 From e9ed29fedf8ad6aca01bd0934e6a39f69fbbb172 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 14:43:44 +0200 Subject: [PATCH 24/58] Bereite Uebergabe fuer technische MVP-Spezifikation mit Blueprintquellen vor --- docs/product/TECHNICAL_SPEC_HANDOFF.md | 90 ++++++++++++++++++++++++++ docs/product/TSUMUGU_PRODUCT_SPEC.md | 6 +- 2 files changed, 95 insertions(+), 1 deletion(-) create mode 100644 docs/product/TECHNICAL_SPEC_HANDOFF.md diff --git a/docs/product/TECHNICAL_SPEC_HANDOFF.md b/docs/product/TECHNICAL_SPEC_HANDOFF.md new file mode 100644 index 0000000..4d0ec13 --- /dev/null +++ b/docs/product/TECHNICAL_SPEC_HANDOFF.md @@ -0,0 +1,90 @@ +# Tsumugu – Auftrag zur technischen MVP-Spezifikation + +**Stand:** 16.10.2026 · **Zielrepository:** `C:\Dev\tsumugu` +**Auftrag:** Technische Spezifikation erstellen, noch keine Implementierung. + +## Ziel und Arbeitsweise + +Überführe die vorhandene fachliche Tsumugu-Spezifikation in eine umsetzbare technische MVP-Spezifikation. Tsumugu ist ein universeller Vorgangs- und Informationsmanager und die erste reale Anwendung der Jinkendo-Blueprints. Erfinde das Produkt nicht neu und führe keine weitere allgemeine Architekturinventur durch. + +Wir wollen bald einen praktisch nutzbaren MVP als Keimzelle für iterative Entwicklung umsetzen. Kläre deshalb nur Grundfragen, die Organisation, Nachverfolgung, Datenhoheit, Rechte oder die konkrete Umsetzung wesentlich beeinflussen. Spezifiziere die beiden Anwendungsfälle nicht vorab bis in alle Sonderfälle. + +Arbeite eigenständig innerhalb der bestätigten fachlichen und technischen Vorgaben. Triff keine grundlegenden Produktentscheidungen stillschweigend. Technische Details und begründete Anpassungen technischer Defaults benötigen keine zusätzliche allgemeine Freigaberunde. + +## 1. Fachliche Grundlage und vorhandenes Repository + +Lies zunächst vollständig: + +- `C:\Dev\tsumugu\docs\product\TSUMUGU_PRODUCT_SPEC.md` – führende fachliche Arbeitsdatei; beim Erstellen dieses Auftrags Arbeitsstand 0.24. Bestätigte Entscheidungen, Bestandsangaben, Vorschläge und offene Punkte sind ausdrücklich unterschieden. +- `C:\Dev\tsumugu\docs\product\Tsumugu_Product_Recovery_Baseline_v0.1.md` – unveränderter historischer Ausgangspunkt; neue Interviewentscheidungen stehen in der führenden Spezifikation. +- `C:\Dev\tsumugu\README.md` +- `C:\Dev\tsumugu\docs\architecture\ARCHITECTURE_DISCOVERY.md` +- `C:\Dev\tsumugu\docs\DEPLOYMENT.md` + +Prüfe danach gezielt den aktuellen Code, vorhandene Konfigurationen und Git-Arbeitsstand im Zielrepository. Beachte tatsächlich vorhandene `AGENTS.md`-Anweisungen. Bestehende geeignete Komponenten bleiben erhalten. Nicht zum Auftrag gehörende lokale Änderungen bleiben unberührt. + +Die letzte gezielte Sichtung zeigte einen FastAPI-Health-Endpunkt mit PostgreSQL, eine statische HTML-/Nginx-Platzhalteroberfläche und Compose-/Gitea-Deploymentdefinitionen. Eine React-/Vite-Fachanwendung ist damit nicht als bereits implementiert belegt. Prüfe diesen Stand selbst; weder einen kompletten Neuaufbau noch bereits fertige Fachkomponenten voraussetzen. + +## 2. Architekturrichtlinien und Blueprints + +Diese lokal vorhandenen Fassungen sind die konkreten technischen Quellen dieses Auftrags: + +### Referenzarchitektur und Foundation – vollständig lesen + +- `C:\Dev\jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16\A_Jinkendo_Technical_Reference_Architecture.md` +- `C:\Dev\jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16\B_Implementation_Blueprint_Application_Foundation.md` +- `C:\Dev\jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16\C_Technical_Decisions_Open_Issues.md` + +### Für Tsumugu unmittelbar relevante Spezial-Blueprints – relevante Verträge und Abläufe lesen + +- `C:\Dev\jinkendo-phase3-3-auth-session-scope-blueprint-2026-10-16\Jinkendo_Auth_Session_Scope_Blueprint.md` +- `C:\Dev\jinkendo-release-betrieb-recovery-blueprint-2026-10-16\Jinkendo_Release_Betrieb_Recovery_Blueprint.md` +- `C:\Dev\jinkendo-medien-dateien-rendering-blueprint-2026-10-16\Jinkendo_Media_Files_Safe_Rendering_Blueprint.md` + +### Erweiterungskontext – nur soweit für tatsächlich benötigte Grenzen relevant + +- `C:\Dev\jinkendo-ki-gateway-provider-privacy-blueprint-2026-10-16\Jinkendo_AI_Gateway_Provider_Privacy_Blueprint.md` +- `C:\Dev\jinkendo-prompt-placeholder-workflow-blueprint-2026-10-16\Jinkendo_Prompt_Placeholder_Workflow_Blueprint.md` +- `C:\Dev\jinkendo-entitlements-usage-quotas-blueprint-2026-10-16\Jinkendo_Entitlements_Usage_Quotas_Blueprint.md` + +Die Existenz dieser zusätzlichen Blueprints macht KI-Ausführung, Workflow-Engine, Billing oder kommerzielle Kontingente nicht zur Tsumugu-MVP-Pflicht. Benötigte Sicherheits- und Ressourcengrenzen sind davon zu unterscheiden. Folge Querverweisen nur gezielt, wenn sie für einen konkreten Vertrag oder Wiederverwendungskandidaten erforderlich sind. + +Beachte den Status der Quellen: A/B/C v0.3 und die Spezial-Blueprints unterscheiden beschlossene Architekturverträge, anpassbare technische Defaults und noch nicht integriert/getestete Vorschläge. Vorhandene Testdateien sind kein bestandener Testnachweis. Keine ungeprüfte Übernahme von Beispielschemas, Dateistrukturen oder Paketversionsangaben als bereits freigegebene, validierte Implementierung. Kein pauschales Framework-Upgrade. + +## 3. Verbindlichkeit und Umgang mit offenen Fragen + +- Ausdrückliche Nutzerentscheidungen und bestätigte Fachanforderungen bestimmen das Produkt. Recovery-Rekonstruktionen sind entsprechend ihrem Nachweisstatus zu behandeln. +- Beschlossene Schutz-, Identitäts-, Transaktions- und Releaseverträge der Architektur bleiben wirksam. Anpassbare technische Defaults können für das bestehende Repository begründet ausgestaltet werden. +- Discovery-Vorschläge und als Vorschlag gekennzeichnete Passagen der Fachspec sind keine freigegebenen Produktentscheidungen. +- Die Fachspec ist keine vollständig abgenommene Gesamtspezifikation. Ein endgültiger MVP-Schnitt liegt noch nicht vor: Erstelle dafür einen konkreten Vorschlag, kennzeichne Rückstellungen und streiche bestätigte Anforderungen nicht stillschweigend. +- Bei einem echten Konflikt zwischen Fachanforderung und Architekturvertrag: konkrete Quellenstellen, Auswirkung und eine Empfehlung knapp dokumentieren. Weder Schutzregeln umgehen noch das Fachmodell an einen unpassenden Default anpassen. +- Arbeite an unabhängigen Teilen weiter. Führe am Ende höchstens drei aktuell blockierende Produktfragen mit Empfehlung auf. Weitere Detailfragen nur am betroffenen späteren Umsetzungsschritt festhalten. + +Besonders zu prüfen ist die produktbezogene Autorisierung: Tsumugu erlaubt gezielte Freigaben desselben Elements über Datenraumgrenzen und unterschiedliche Kontextrechte. Die persönlichen Standardadapter des Auth-Blueprints und die Scope-/Assetprüfungen des Datei-Blueprints sind damit gezielt abzugleichen. Das ist zunächst ein Prüfpunkt, kein pauschal festgestellter Blueprint-Konflikt. Keine globale Rechtevereinigung über fremde Akten und keine reine Scope-ID-Gleichheitsregel, die bestätigte Freigaben unmöglich macht. Prüfe auch, wo die Fachspec die Auflösung mehrerer Rechtepfade noch offenlässt. + +## 4. Erwartetes Ergebnis + +Erstelle eine führende technische Datei: + +`C:\Dev\tsumugu\docs\architecture\TSUMUGU_TECHNICAL_SPEC.md` + +Verwende klare, kompakte Abschnitte. Die Spezifikation muss die ersten Implementierungsschritte ermöglichen, nicht sämtliche späteren Ausbaustufen vorwegnehmen. + +1. **MVP-Vorschlag und Reifestand:** Erster nutzbarer Umfang, spätere Lieferungen und tatsächlich blockierende Entscheidungen. Beide ursprünglichen Anwendungsfälle bleiben Validierungsfälle: Mietangelegenheiten/Rechtsstreitigkeiten sowie Rechnungen/Krankenkassenerstattungen. Universellen Produktumfang erhalten. +2. **Gezielter Bestandsabgleich:** Was bleibt, was muss ergänzt werden und warum. Referenzen auf konkrete vorhandene Dateien statt neuer Gesamtinventur. +3. **Technischer Zuschnitt:** Benötigte Module, Verantwortlichkeiten und ihre Schnittstellen anhand der vorhandenen Architekturverträge; Wiederverwendung gezielt begründen. Keine allgemeine neue Plattform. +4. **Datenmodell und Invarianten:** Entitäten, relevante Felder, Beziehungen, Kardinalitäten, Ownership und Kontextbezüge; als Tabellen und bei Bedarf ER-Diagramm. Bestätigte Beziehungen von offenen Modellvorschlägen trennen. Gemeinsame Inhalte, deren Einbindungen und kontextbezogene Anmerkungen unterscheiden. Akte, Vorgang, Teilvorgang, Kapitel, Sicht und virtuelle Zusammenstellung fachlich konsistent abbilden. Schemaentwurf ist noch keine auszuführende Migration. +5. **Zugriff und Datenräume:** Ein einfaches vorgeschlagenes Rechte-/Rollenmodell für Lesen, Bearbeiten, Freigeben, Ownership und Löschen; Aktenvererbung, Elementausnahmen, gezielte Datenraumfreigaben und Entzug konkret prüfen. Entfernen einer Einbindung von globalem Löschen unterscheiden. Unfreigegebene Inhalte und fremde Herkunftskontexte auch über Suche, Counts, Chronologie, Downloads und Exporte schützen. Späteren gezielten Anwaltszugang berücksichtigen, ohne eine noch nicht entschiedene Zugangsform zur MVP-Pflicht zu machen. +6. **Arbeitsabläufe und Schnittstellen:** Die wenigen für den MVP erforderlichen API-/UI-Verträge, Statusübergänge und Transaktionsgrenzen. Insbesondere Vorgang anlegen, Ressourcen zuordnen, Chronologie nachvollziehen, Aufgaben und unabhängige Fristen verfolgen sowie private/gemeinsame Bearbeitung. Ein knappes API-Verzeichnis mit Ein-/Ausgaben genügt; keine zweite große OpenAPI-Handschrift. +7. **Dateien, Paperless und Finanzen:** Eigene geschützte Ablage gegenüber externen Referenzen; notwendige Datei-/Lifecycleverträge. Ausgewählte bidirektionale Metadaten, Feldzuständigkeit, bewusste Konfliktauflösung und Ausfallsichtbarkeit konkretisieren. Bisheriges `erstattet_am` ist Mitteilungsdatum und kein Zahlungseingang. Erstattungsbeträge stehen bisher an Rechnungen mit Belegreferenz. Rechnungszahlung, Erstattungsbearbeitung und tatsächliche Eingänge unterscheiden; Teilbeträge unterstützen, den Regelfall einfach halten. Noch offene Produktregeln nicht als entschieden ausgeben. +8. **Überprüfbare Umsetzungsschritte:** Wenige geordnete Arbeitspakete mit Ergebnis, Abhängigkeiten und passenden Abnahmekriterien. Sinnvolle Nachweise für Rechteisolation/gezielte Freigaben, gemeinsame Inhalte, Fristen, Finanzzuordnungen und Metadatenkonflikte benennen. Release-/Recovery-Anforderungen für den ersten echten Betrieb berücksichtigen. Tests als geplant kennzeichnen; hier keine Implementierungs- oder Laufzeitnachweise behaupten. + +Halte ein kleines Mapping von den tatsächlich benötigten Blueprint-Verträgen zu ihrer Tsumugu-Ausprägung fest. Keine neue umfassende Compliance-/Governancematrix und keine Vervielfachung der Produktspezifikation. Offene Frage, technischer Vorschlag und bestätigte Vorgabe müssen auch im Ergebnis erkennbar bleiben. + +## 5. Grenzen und Abschluss + +Dieser Auftrag erlaubt ausschließlich das Erstellen/Aktualisieren der technischen Spezifikation im Zielrepository. Die fachliche Spezifikation und die historische Baseline bleiben inhaltlich unverändert. Dokumentiere neu benötigte Fachentscheidungen als Vorschläge oder Fragen in der technischen Datei; sie werden nach der Nutzerentscheidung in die führende Fachspec übernommen. + +Keine Änderungen an Anwendungscode, Datenbanken, Migrationen, Abhängigkeiten, CI/CD, Deployments oder anderen Produkt-Repositories. Keine Paketinstallation, keine Netz-/Provider-/Paperless-Integrationstests und keine Eingriffe in laufende Systeme. Keine Implementierung starten, auch wenn Beispiele in Blueprints als Coding-Aufträge formuliert sind. Kein Push oder Deployment aus diesem Auftrag. + +Liefere abschließend eine kurze Zusammenfassung mit Dateilink, empfohlenem MVP-Schnitt, erstem vorgeschlagenem Umsetzungspaket und höchstens drei wirklich blockierenden Fragen. Danach auf die ausdrückliche Freigabe für den konkreten Implementierungsauftrag warten. diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 8e4f91b..9cae719 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.23, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.24, fachliche Arbeitsgrundlage zur technischen Spezifikation. **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. @@ -86,6 +86,8 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Die ursprünglichen Validierungsfälle:** (1) Mietangelegenheiten/Rechtsstreitigkeiten mit Kommunikation, nachvollziehbarer Chronologie, Aufgaben, Fristen und später gezielter Zusammenarbeit mit einem Anwalt. (2) Krankenkassenabrechnung/Erstattungen mit Rechnungen, Einreichung, Sammelerstattungsbelegen, manuellen Betragszuordnungen, Zahlungszielen und Nachverfolgung offener Klärungen. Das universelle Produktmodell wird an beiden geprüft, nicht auf diese Fälle beschränkt. +**Aktuelle Übergabe:** Der Nutzer möchte diese Fachspec einem Coding-Agenten zur Erstellung der technischen Spezifikation unter Berücksichtigung der Jinkendo-Architekturrichtlinien und vorhandenen Blueprints übergeben. Der [Übergabeauftrag](TECHNICAL_SPEC_HANDOFF.md) benennt die lokalen Quellen, die erwartete technische Datei und die Grenze zur Implementierung. Diese Übergabe erklärt weder die gesamte Fachspec noch einen konkreten MVP-Schnitt für abschließend freigegeben. Keine erneute umfassende Fachinterviewrunde; Vorschläge konkret ausarbeiten und nur tatsächlich blockierende Grundfragen zurückgeben. + ## 5. Interviewentscheidungen ### F-01a – Aktenrechte und kontextbezogene Freigabe: bestätigt am 16.10.2026 @@ -368,4 +370,6 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G 16.10.2026, Arbeitsstand 0.23: F-04a bestätigt: Frist und Aufgabe getrennt, miteinander verknüpfbar. Nutzersteuerung zu pragmatischer Detaillierung und baldiger MVP-Umsetzung gesichert; zentrale Grundfragen zu Organisation/Nachverfolgung bleiben wichtig. Beide ursprünglichen Validierungsfälle festgehalten. Keine nächste Detailfrage angefügt; nächste Ausarbeitung auf kompakte MVP-Abgrenzung ausrichten. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +16.10.2026, Arbeitsstand 0.24: Auf Nutzerwunsch Übergabe zur technischen Spezifikation vorbereitet. Referenzarchitektur A/B/C v0.3 und vorhandene Spezial-Blueprints gezielt hinsichtlich Geltung/Quellpfaden eingeordnet. Arbeitsauftrag in `TECHNICAL_SPEC_HANDOFF.md`; technische Ausgestaltung und MVP-Schnitt bleiben Ergebnis des nächsten Arbeitsschritts. Keine Implementierung und keine Nachricht an einen anderen Chat versandt. + 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. -- 2.43.0 From cfe17ff90937f313b04ae72d9c3daf21c574fc15 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 21:36:42 +0200 Subject: [PATCH 25/58] Bestaetige erste Lieferung Organisieren und Nachverfolgen --- docs/architecture/TSUMUGU_TECHNICAL_SPEC.md | 627 ++++++++++++++++++++ docs/product/TSUMUGU_PRODUCT_SPEC.md | 26 +- 2 files changed, 651 insertions(+), 2 deletions(-) create mode 100644 docs/architecture/TSUMUGU_TECHNICAL_SPEC.md diff --git a/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md new file mode 100644 index 0000000..c2abef0 --- /dev/null +++ b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md @@ -0,0 +1,627 @@ +# Tsumugu – Technische MVP-Spezifikation + +**Stand:** 16.10.2026 · **Fassung:** 0.3 · **Status:** Erster fachlicher Lieferumfang bestätigt; technische Ausgestaltung und offene Produktregeln bleiben Vorschläge. Keine Implementierung, keine Migration, kein Testnachweis. + +**Fachliche Grundlage:** [TSUMUGU_PRODUCT_SPEC.md](../product/TSUMUGU_PRODUCT_SPEC.md), Arbeitsstand 0.25 einschließlich Lieferentscheidung F-05a. Die historische [Recovery-Baseline](../product/Tsumugu_Product_Recovery_Baseline_v0.1.md) bleibt unverändert; wo das Interview eine Recovery-Aussage präzisiert hat, gilt die Fachspec. + +**Technische Grundlagen:** Jinkendo-Referenzarchitektur A/B/C v0.3 vom 16.10.2026 sowie die Blueprints Auth/Session/Scope, Release/Betrieb/Recovery und Medien/Dateien. KI-Gateway, Prompt-/Workflow-Laufzeit und Entitlements gelten nur als Grenze, nicht als MVP-Pflicht. + +### Änderungsnotiz 0.3 + +F-05a bestätigt die erste benutzbare Lieferung „Organisieren und Nachverfolgen“. Finanzfunktionen und bidirektionaler Paperless-Abgleich folgen anschließend, ohne gestrichen zu werden. Die zuvor kombinierten Pakete P4 und P5 sind dafür in unabhängig lieferbare Teile aufgeteilt; P7 sichert schon den ersten echten Betrieb ab. Die technische Präzisierung des Akten-Handlungskontexts ist in Abschnitt 6.2 ergänzt. Diese Angleichung ist keine pauschale Freigabe der offenen Rechte-/Löschvorschläge und kein Implementierungsauftrag. + +### Änderungsnotiz 0.2 – historischer Korrekturstand + +Korrektur der Fassung 0.1, ohne neuen MVP-Schnitt und ohne neue Lieferreihenfolge. Die Einordnung der Paperless-Synchronisation als Paket P6 bleibt ein Vorschlag. + +| Befund | Korrektur | +|---|---| +| Zahlungsrichtung | Zahlung ist ein eigenes Objekt mit Richtung. Zuordnung ist davon getrennt. Nur ausgehende Zahlungen zählen auf den Rechnungszahlungsstand. Eingänge, Mitteilungen und Rechnungszahlungen bleiben drei Sachverhalte. | +| Aktenvererbung | Aktenzuordnung ist der regelhafte Rechtepfad auf den Vorgang. Unveränderte Ownership schließt diese Vererbung nicht aus. Querverweise vererben nicht. | +| Eigenständige Anker | Aufgaben, Fristen, Rechnungen, Zahlungen und Mitteilungen ohne Vorgang nutzen denselben Owner-/Grant-Pfad. Die zugewiesene Person ist nicht der Owner. | +| Korrekturvorzeichen | Gespeicherte Zeilen sind vorzeichenbehaftet. Der wirksame Betrag ist ihre Summe. Eine Korrektur wird nicht zusätzlich abgezogen. | +| Verborgene Einbindungen | Antworten benennen und zählen nur sichtbare Einbindungen. Ein allgemeiner Hinweis auf die Wirkung gemeinsamer Textänderungen hängt nicht von verborgenen Beziehungen ab. | + +## Lesart + +| Kennzeichnung | Bedeutung in dieser Datei | +|---|---| +| Bestätigt | Ausdrückliche Entscheidung in der Fachspec 0.25 | +| Vertrag | Beschlossener Architekturvertrag aus A/B/C oder einem Spezial-Blueprint | +| Vorschlag | Technische Ausgestaltung dieser Fassung, noch keine Produktfreigabe | +| Offen | Bewusst nicht entschieden; Rückfrage in Abschnitt 10 oder ein späterer Umsetzungsschritt | + +Discovery-Abschnitte 5–8 und als Vorschlag markierte Fachstellen sind keine Produktbeschlüsse. Beispielschemas, Verzeichnisbäume und Versionslinien der Blueprints sind V/K: noch keine ausgeführte, getestete Implementierung. Diese Datei übernimmt sie nicht als bereits validierten Code. + +Ein Schema in Abschnitt 4 ist ein Entwurf für spätere SQL-Dateien. Es ist keine ausführbare Migration. + +## 1. Lieferumfang und Reifestand + +Tsumugu bleibt ein universeller Vorgangs- und Informationsmanager. Mietangelegenheiten/Rechtsstreitigkeiten und Rechnungen/Krankenkassenerstattungen sind die beiden Validierungsfälle, keine Produktgrenze. + +### 1.1 Bestätigter erster nutzbarer Schnitt + +F-05a bestätigt den Schwerpunkt „Organisieren und Nachverfolgen“. Die erste Lieferung umfasst: + +- Persönlicher Datenraum je Konto und ausdrücklich angelegte gemeinsame Datenräume mit Mitgliedschaft. +- Akte, eine Ebene Unterakte, eigenständiger Vorgang, eine Ebene Teilvorgang, Kapitel nur als Gliederung. +- Zuordnung eines Vorgangs zu keiner, einer oder mehreren Akten, ohne Ownership zu verschieben. +- Gemeinsame Notizen, kontextbezogene Anmerkungen, eigene Dateien und manuell erfasste externe Referenzen. +- Kontextbezogene Rechte: Lesen, Bearbeiten, Freigeben, Ownership, Löschen; Aktenvererbung mit ausdrücklichen Ausnahmen; gezielte Freigabe über Datenraumgrenzen am selben Element. +- Chronologie der selbst sichtbaren Ereignisse. Aufgaben und davon unabhängige Fristen. +- Zentrale Übersicht offener Aufgaben und Fristen. Eine Sicht verleiht keine Rechte. + +Erster praktischer Abnahmeablauf ist der Miet-/Rechtsstreitfall: Vorgang mit Aktenzuordnung, Schreiben als Referenz oder Datei, gemeinsame Notiz mit kontextbezogenen Rechten, unterscheidbare Chronologie, Aufgabe und unabhängige Frist mit zentraler Übersicht. Die Erledigung einer vorbereitenden Aufgabe erfüllt nicht automatisch die Frist. Die Struktur bleibt universell; der vollständige Finanz-/Erstattungsablauf folgt mit dem Ausbau. + +Die eine Hierarchieebene und die konkrete Rollen-/Löschgestaltung bleiben technische bzw. noch zu bestätigende Produktvorschläge der Fassung 0.2. Die Freigabe des ersten Lieferumfangs bestätigt diese Details nicht automatisch. + +### 1.2 Zurückgestellt, nicht gestrichen + +| Thema | Einordnung | Spätere Lieferung | +|---|---|---| +| Finanzfunktionen | Bestätigte Fähigkeiten; gemäß F-05a nach der ersten benutzbaren Lieferung. | P4b: Rechnungen, Zahlungen, Teil-/Sammelzuordnungen, Erstattungen und Eigenanteile. | +| Bidirektionale Paperless-Synchronisation | Bestätigte Fähigkeit; gemäß F-05a nach der ersten benutzbaren Lieferung. Manuelle Referenzen sind bereits im ersten Schnitt enthalten. | P6. Modell, Feldzuständigkeit und Konflikte stehen in Abschnitt 7; praktischer Anschlusstest vor Realanbindung. | +| Virtuelle Zusammenstellungen und Erstattungssicht | Bestätigte Konzepte, kein zusätzliches Fertigkriterium des in F-05a bestätigten ersten Schnitts. | P5b ist der technische Ausbauvorschlag; genaue Lieferposition noch offen. | +| Zugang für einen Anwalt | Bestätigt als späteres Ziel. Zugangsform offen. | Grant-Modell bleibt anschlussfähig. Konto, Gastzugang oder Export sind keine MVP-Pflicht. | +| Aufgaben in Kairo | Bestätigt als späterer Wunsch. | HTTP und datenraumgebundene technische Identität, keine gemeinsame Datenbank. | +| KI-Kontextpakete | Bestätigt als Vorbereitung, kein Agent im MVP. | Kein Modellaufruf. Stabile IDs, Versionen, Scope und Audit bleiben die Naht. | +| Portalbeschaffung, lernende Zuordnung, IMAP, Audio, Sammelimporte | Nicht als MVP-Pflicht belegt. | Eigene Aufträge. | +| Ownership-Übertragung, mehrere Eigentümer, delegiertes Löschen | In F-01f ausdrücklich offen. | Ein Owner-Feld jetzt; Übertragung später. | +| Tiefere Hierarchien, frei definierbare Sichtkriterien, Erinnerungen, juristische Fristberechnung | Für den ersten Schnitt nicht erforderlich. | Je eigener Ausbau. | +| Kommerzielle Kontingente, Billing, Workflow-Engine | Keine Fachanforderung. | Nicht vorbereiten außer den Sicherheitsgrenzen aus Abschnitt 3. | + +### 1.3 Reifestand des Repositories + +Geprüft am 16.10.2026 auf Branch `develop`: lauffähiges Deploy-Gerüst, keine Fachanwendung. `GET /api/health` in `backend/main.py` prüft PostgreSQL. `frontend/index.html` ist eine statische Platzhalterseite. Eine React-/Vite-Anwendung, Auth, Migrationen und Fachtabellen sind nicht vorhanden. Tests wurden nicht ausgeführt; es gibt keinen T-Nachweis. + +## 2. Gezielter Bestandsabgleich + +| Vorhanden | Umgang | Grund | +|---|---|---| +| `backend/main.py`, `backend/Dockerfile`, `backend/requirements.txt` | Health-URL und Prozessmodell bleiben, Internes wird beim Foundation-Paket ersetzt. | Deploy-Smoke `curl -sf …/api/health` in `.gitea/workflows/deploy-dev.yml` und `deploy-prod.yml`. | +| `frontend/index.html`, `frontend/nginx.conf`, `frontend/Dockerfile` | Platzhalter bleibt bis zum ersten Fach-UI. Nginx-Proxy `/api/` bleibt. | Es gibt keine Fach-SPA, die man erweitern könnte. | +| `docker-compose.yml`, `docker-compose.dev-env.yml`, `.env.example` | Compose-Projekt, Postgres 16, getrennte Dev-/Prod-DB bleiben. | Vertrag der eigenen Datenbank je Anwendung. | +| `docs/DEPLOYMENT.md`, Hostports 3007/8007 und 3094/8094 | Betriebsrahmen bleibt. | TLS endet weiter auf dem Synology-Proxy. | +| `docs/architecture/ARCHITECTURE_DISCOVERY.md` | Ist-Aufnahme, keine Produktvorgabe. | Dort ausdrücklich keine Beschlüsse. | +| `docs/product/*` | Fachlich führend bzw. historische Baseline. | Dieser Auftrag ändert sie nicht. | + +Vor dem ersten Fachendpunkt, als Bestandteil von Paket P0 und nicht in diesem Auftrag: + +- Host-Port des Backends nur an `127.0.0.1`. Der Container spricht weiter Port 8000; das Frontend erreicht ihn im Compose-Netz. Die bestehenden Localhost-Smokes bleiben damit gültig. +- Security-Header am Frontend-Nginx, angelehnt an das vorhandene Shinkan-Muster: CSP, `X-Content-Type-Options`, `X-Frame-Options`, `Referrer-Policy`, `Permissions-Policy`. HSTS bleibt am äußeren Proxy und wird vor dem ersten echten Betrieb nachgewiesen, nicht im Anwendungscode erfunden. +- `/api/health` antwortet weiterhin erfolgreich oder mit 503, nennt aber nur noch `status` und `app`. Umgebung und Datenbankdetail gehören nicht in die öffentliche Health-Antwort. `/health/live` und `/health/ready` kommen nach dem Foundation-Vertrag dazu. +- OpenAPI bleibt in Produktion aus (`docs_url=None`). +- Psycopg 3 löst `psycopg2-binary` ab, wenn die Foundation gebaut wird. Die einzige heutige Verwendung ist der Health-Connect; eine Fachcode-Migration von Psycopg 2 gibt es nicht. Konkrete Patchstände entstehen erst mit Lockfiles. + +Begründete Strukturanpassung gegenüber dem Foundation-Baum: Compose-Dateien bleiben im Repository-Root, Workflows bleiben unter `.gitea/workflows/`. Neuer Anwendungscode liegt unter `backend/app/` und `frontend/src/` gemäß Blueprint B. `AGENTS.md` entsteht mit dem Foundation-Paket und verweist auf A/B und diese Datei; in diesem Auftrag wird sie nicht angelegt. + +## 3. Technischer Zuschnitt + +Eine produktlokale modulare Anwendung. Keine gemeinsame Fachdatenbank, keine Familienbibliothek, kein neuer Plattformdienst. + +```text +Browser → Frontend-Nginx (Same-Origin) + → FastAPI + BrowserBoundary → PrincipalResolver → ScopeResolver + Fachservice, eine Transaktion + AccessPolicy → Repository → PostgreSQL + Audit in derselben Transaktion + Media-/Storage-Port nur für eigene Dateien, außerhalb der offenen Transaktion +``` + +| Modul | Verantwortung | Schnitt | +|---|---|---| +| `core` | Settings, RequestContext, Fehler, Logs, Ports | Kennt keine Fachmodule | +| `db` | Pool, Transaktion, Migrations-CLI | Runtime ohne DDL | +| `auth` | Konto, Einladung, Session, Cookie, CSRF | Principal nur aus der Session | +| `access` | Datenraum, Mitgliedschaft, Grants, Sichtbarkeit | Fail-closed, dieselbe Transaktion wie der Write | +| `structure` | Akte, Unterakte, Vorgang, Teilvorgang, Kapitel, Zuordnung, Querverweis | Aktenrechte als Regelfall, Ausnahmen und eigene Grants am Vorgang | +| `content` | Element, Notiz, Anmerkung, Einbindung, Zusammenstellung | Gemeinsamer Inhalt, kontextbezogene Rechte | +| `chronology` | Lesemodell über Fachereignisse | Filter mit derselben Sichtbarkeit wie Detail | +| `tracking` | Aufgabe, Frist, Verknüpfung, Zuweisung | Dieselben Grants. Zugewiesene Person ist kein zweites Rechtssystem. | +| `finance` | Rechnung, Zahlung, Zuordnung, Erstattungsmitteilung, Eigenanteil | Richtung der Zahlung bestimmt, ob sie eine Rechnung bezahlt | +| `media` | Eigene Dateien nach dem Datei-Blueprint | Asset getrennt von der Einbindung | +| `external` | Referenz und späterer Feldabgleich | Kein Dokumentduplikat aus Paperless | +| Frontend-Module | Dieselben Fachschnitte, Data Router, Session-Store mit Epoche | UI ist keine Sicherheitsgrenze | + +Abhängigkeitsrichtung: Router → Service → Repository. Nur der Composition Root verdrahtet Adapter. Fremde Funktionalität läuft über eine Service-Schnittstelle. + +**Wiederverwendung, jeweils lokal neu und angepasst:** + +- Session, bcrypt, Widerruf und Fail-closed-Policy aus dem Auth-Blueprint; Shinkan als Mechanikreferenz, ohne `X-Auth-Token`, ohne `CAPABILITY_ENFORCE=0`, ohne `min(club_ids)`. +- Mitai-Kontobindung nur als persönlicher Scope. `X-Profile-Id` und Erstprofilfallback werden nicht übernommen. +- Kairo-Actor-Token nur als späterer Port für Kairo/Agenten. Im MVP kein Operational-Router. +- Medienlifecycle, Uploadphasen und Readplan aus dem Datei-Blueprint. Shinkan-Vereinsrechte und automatische Sichtbarkeitspromotion werden nicht übernommen. +- Registry-Vertrag mit Duplikatsperre für Frontend-Module, ohne Mitai-Platzhalterkatalog. +- Release-, Backup- und Restore-Vertrag für Paket P7. Die heutigen Workflows bauen auf dem Pi neu und sind noch kein qualifiziertes Release-Gate. + +**Im MVP nicht verdrahten:** ModelGateway, Prompt-Renderer, Workflow-Engine, Entitlement-/Billing-Pläne, SSO. Technische Grenzen bleiben trotzdem wirksam: Uploadgröße, Request-Timeout, Listenlimit, Poolgrenze, keine Session in Medien-URLs, keine persönlichen API-Caches. + +### 3.1 Technische Defaults für diesen Bestand + +| Default | Tsumugu-Ausprägung | +|---|---| +| Neue Fach-API | `/api/v1`, `snake_case`, opake IDs, UTC mit `Z`, Datum `YYYY-MM-DD`, Geld als Dezimalzeichenkette plus Währung | +| Listen | `limit` 50, höchstens 200, stabile Sortierung mit ID | +| Fehler | RFC-9457-Problem-Details. Unsichtbares Objekt 404, fehlende Befugnis bei sichtbarem Objekt 403, fehlende Session 401 | +| Transaktion | Eine Verbindung je Anwendungsfall, Commit vor der Antwort, Audit in derselben Transaktion | +| Migration | Neue SQL-Dateien `YYYYMMDDTHHMMSSZ_name.sql`, Ledger mit Prüfsumme, CLI vor dem Prozesswechsel, nicht beim Import | +| Frontend | React/Vite/Router in den Versionslinien aus A1, weil hier keine bestehende SPA migriert wird. Exakte Stände erst beim Bau mit Lockfiles. Kein pauschales Upgrade anderer Produkte. | +| Session | HttpOnly-Cookie `__Host-jinkendo-session`, CSRF, Originprüfung. Kein Token in `localStorage` oder URL. | +| Scope-Header | `X-Scope-Kind` und `X-Scope-Id`. Auswahl ist keine Berechtigung. | +| Registrierung | Vorschlag: nur Einladung. Betreiberkonto über die lokale CLI des Auth-Blueprints, mit verpflichtender MFA für Betreiberaktionen. Offene Selbstregistrierung ist nicht vorgesehen. | +| Kontingente | Kein kommerzielles Kontingent. Harte technische Grenzen für Dateigröße, Parallelität und Listen bleiben. | + +Versionslinien sind keine bereits erzeugten Lockfiles und kein T-Nachweis. + +## 4. Datenmodell und Invarianten + +Alle fachlichen IDs sind UUIDs. `version` ist eine monotone ganze Zahl für 409-Konflikte. `home_scope_id` ist der Datenraum, in dem das Objekt entstanden ist und dessen Owner es führt. Zeitpunkte sind `timestamptz`, reine Termine sind `date`. + +### 4.1 Bestätigte Beziehungen + +| Beziehung | Kardinalität | Regel | +|---|---|---| +| Konto und persönlicher Datenraum | 1:1 | Scope-Art `personal`, Scope-ID = Konto-ID. Vertrag des persönlichen Adapters. | +| Konto und gemeinsamer Datenraum | n:m über Mitgliedschaft | Bewusste Mitgliedschaft. Sie öffnet nicht den persönlichen Raum eines anderen. | +| Akte und Unterakte | 1:n, im MVP eine Ebene | Unterakte ist eine Akte mit abweichenden Rechten. Bestätigt S-01d. | +| Kapitel und Akte oder Vorgang | n:1 | Gliederung ohne Status und ohne eigene Rechte. Bestätigt S-01d. | +| Vorgang und Akte | n:m über Zuordnung | Auch null Akten. Dieselbe Vorgangsversion überall. Zuordnung ändert Ownership nicht. Bestätigt S-01b. Die Rechtewirkung der Zuordnung ist in Abschnitt 4.5 als Vorschlag ausgearbeitet. | +| Teilvorgang und Elternvorgang | n:1 | Genau ein fachlicher Elternvorgang. Bestätigt S-01c. | +| Teilvorgang und weiterer Vorgang | n:m Querverweis | Referenz, keine zweite Elternschaft und keine Kopie. Bestätigt S-01c. | +| Element und Einbindung | 1:n | Dasselbe Element in mehreren Kontexten. Bestätigt F-01a. | +| Notiztext und Einbindungen | 1:n | Ein gemeinsamer Inhalt. Bestätigt F-01b. | +| Anmerkung und Kontext | n:1 je Einbindung | Sichtbar nur in diesem Kontext. Bestätigt F-01b. | +| Zusammenstellung und Inhalt | 1:n Referenzen | Zusammenstellen allein gibt keine Rechte. Bestätigt S-01a, S-01e, S-01f. | +| Aufgabe und Frist | n:m, beide optional | Frist kann ohne Aufgabe bestehen. Erledigen der Aufgabe erfüllt die Frist nicht. Bestätigt F-04a. Beide können ohne Vorgang bestehen. | +| Rechnung und Vorgang | n:1 optional | Mehrere Rechnungen je Vorgang, ohne Pflicht zu einem Vorgang je Rechnung. Bestätigt F-03e. Eine Rechnung kann auch ohne Vorgang bestehen. | +| Zahlung und Rechnung | Zahlung 1:n Zuordnungen, Zuordnung n:1 Rechnung | Die Zahlung existiert vor und ohne Zuordnung. Nur die Richtung `outbound` darf einer Rechnung zugeordnet werden. Teil- und Sammelzahlungen sind mehrere Zuordnungszeilen. Bestätigter Bedarf F-03c. | +| Zahlungseingang und Rechnung | keine Zahlungsanrechnung | Ein Eingang ist eine Zahlung mit Richtung `inbound`. Er verändert den Zahlungsstand der Rechnung nicht. | +| Rechnung und Erstattungsmitteilung | n:m über Betragszuordnung | Referenz und mitgeteilter Betrag sind kein Geldeingang und keine Rechnungszahlung. Bestätigt F-03b. | +| Erstattungsbearbeitung, Geldeingang, Rechnungszahlung | drei Stände | Bestätigt F-03d, F-03e. | + +### 4.2 Vorschlag der Tabellen + +Gemeinsame Spalten der fachlichen Ankerobjekte `cases`, `matters`, `elements`, `compilations`, `tasks`, `deadlines`, `invoices`, `payments`, `reimbursement_notices`: `id`, `home_scope_id`, `owner_subject_id`, `created_by`, `version`, `created_at`, `updated_at`, `deleted_at`. Soweit ein Titel fachlich nötig ist, kommt `title` dazu. Zahlung, Rechnung und Mitteilung tragen statt eines freien Titels ihre fachlichen Betrags- und Datumsfelder. + +| Tabelle | Felder neben dem Anker | Bedeutung | +|---|---|---| +| `data_rooms` | `kind` `personal` oder `organization`, `name`, `status` | `organization` ist die technische Scope-Art des Auth-Blueprints für einen gemeinsamen Datenraum. Fachlich heißt er Datenraum, nicht Verein und nicht Club. | +| `room_memberships` | `room_id`, `subject_id`, `role` `member` oder `manager`, `status` | Manager lädt ein und verwaltet Mitgliedschaft. Er liest dadurch keine fremden persönlichen Inhalte. | +| `cases` | `parent_case_id` null oder eine Akte, `rights_mode` `inherit_parent` oder `explicit`, `matter_status` | `matter_status` nur als Arbeitsstatus der Akte, Vorschlag `open` / `closed`. Unterakte mit `inherit_parent` nutzt die Grants der Elternakte. `explicit` trägt eigene Grants. | +| `chapters` | `container_kind`, `container_id`, `position` | Keine Grants, kein Status. | +| `matters` | `parent_matter_id` null oder genau ein Vorgang, `matter_status` | Teilvorgang ist ein Vorgang mit gesetztem Elternteil. Status Vorschlag `open` / `closed`, manuell, nicht aus Rechnungen abgeleitet. | +| `matter_case_links` | `matter_id`, `case_id` | Zuordnung. Kein Ownership-Feld und keine kopierten Grant-Zeilen. Sie ist der regelhafte Vererbungskontext aus Abschnitt 4.5. | +| `matter_cross_links` | `from_matter_id`, `to_matter_id` | Querverweis. Elternzeiger bleibt unverändert. Keine Rechtevererbung. | +| `elements` | `kind` `note`, `correspondence`, `file` oder `external_ref` | Gemeinsamer Inhaltsträger. Rechnungen verweisen auf ein Element, sind aber eigene Finanzobjekte. | +| `note_bodies` | `element_id`, `document_json`, `version` | Ein Text je Notiz. Begrenzter Renderbaum aus dem Datei-Blueprint, keine freie HTML-Ablage. | +| `correspondence_dates` | `element_id`, `document_on`, `sent_on`, `received_on` | Vier getrennte Datumssachen. `recorded_at` ist `elements.created_at`. | +| `bindings` | `element_id`, `context_kind`, `context_id`, `chapter_id` null, `position`, `release_state` | Kontext ist Akte, Vorgang oder Zusammenstellung. `release_state` `visible` oder `pending` für noch nicht freigegebene neue Zusammenstellungsinhalte. | +| `context_annotations` | `binding_id`, `body`, `author_subject_id` | Gehört zur Einbindung, nicht zum gemeinsamen Text. | +| `access_grants` | `grantee_subject_id`, `resource_kind`, `resource_id`, `context_kind`, `context_id`, `can_read`, `can_edit`, `can_share`, `can_delete` | Explizite Grants. Vererbung wird berechnet und nur bei Abweichung materialisiert. | +| `compilations` | Ankerfelder | Virtuelle Zusammenstellung. | +| `tasks` | `title`, `matter_id` null, `assignee_subject_id` null, `due_on` null, `task_status` | Vorschlag `open` / `done`. Ohne Vorgang ist die Aufgabe selbst der Rechteanker. `assignee_subject_id` ist keine Owner-Spalte. | +| `deadlines` | `title`, `matter_id` null, `element_id` null, `assignee_subject_id` null, `due_on`, `deadline_status`, `fulfilled_at` | Vorschlag `open` / `fulfilled`. Unabhängig von Aufgaben. Dieselben Ankerregeln wie Aufgaben. | +| `task_deadline_links` | `task_id`, `deadline_id` | Verknüpfung ohne Statuskopplung. Sichtbar nur, wenn beide Seiten lesbar sind. | +| `invoices` | `matter_id` null, `document_element_id`, Betrags- und Datumsfelder aus Abschnitt 7 | Eigener Zahlungs- und Erstattungsstand. Ohne Vorgang eigener Rechteanker. | +| `payments` | `direction` `outbound` oder `inbound`, `currency`, `paid_on` | Die Geldbewegung. `outbound` ist eine Rechnungszahlung, `inbound` ein Zahlungseingang. Der Betrag steht in `payment_lines`, nicht in einer zweiten Summe. | +| `payment_lines` | `payment_id`, `amount`, `kind` `posting` oder `correction` | Genau eine Buchungszeile mit positivem Betrag. Jede Korrektur ist eine weitere Zeile mit negativem Betrag. | +| `payment_allocations` | `payment_id`, `target_kind`, `target_id`, `amount`, `kind` `allocation` oder `correction` | Verwendung eines Teils der Zahlung. `outbound` nur auf `invoice`. `inbound` nur auf `reimbursement_notice` oder ohne Ziel. Beträge vorzeichenbehaftet, Korrekturen negativ. | +| `reimbursement_notices` | `matter_id` null, `document_element_id`, `notified_on` | Mitteilung, kein Geldeingang und keine Rechnungszahlung. | +| `reimbursement_allocations` | `invoice_id`, `notice_id`, `amount`, `kind` `allocation` oder `correction` | Manuell zugeordneter mitgeteilter Betrag. Dieselbe Vorzeichenregel, keine Zahlungszeile. | +| `accepted_shares` | `invoice_id`, `amount`, `reason` | Endgültig akzeptierter nicht erstattbarer Anteil. | +| `domain_events` | Actor, Scope, Aktion, Ressourcentyp, Ressourcen-ID, Zeitpunkt, Ergebnis | Append-only. Keine Notiztexte und keine Geldbeträge im Klartext, wenn die Chronologiezeile auch ohne Betragsrecht sichtbar würde. Beträge stehen in der Finanzansicht. | +| `external_field_states` | Quelle, externe ID, Feld, letzter gemeinsamer Wert, lokaler Wert, entfernter Wert, `sync_status` | Erst mit P6 befüllt. Die Tabelle darf früher leer existieren. | +| Medientabellen | gemäß Datei-Blueprint `media_assets`, `media_operations` | Asset-Owner ist der Element-Owner. Die Einbindung ist der fachliche Link, kein zweites Byteobjekt. | + +Auth-Tabellen `auth_accounts` und `auth_sessions` folgen dem Auth-Blueprint. Ein Anzeigename ist kein Identitätsbeweis. + +### 4.3 Überblick + +```mermaid +erDiagram + Account ||--|| DataRoom : "persoenlicher Raum" + Account }o--o{ DataRoom : "Mitgliedschaft gemeinsamer Raum" + DataRoom ||--o{ Case : "Heimat" + DataRoom ||--o{ Matter : "Heimat" + DataRoom ||--o{ Element : "Heimat" + DataRoom ||--o{ Task : "Heimat" + DataRoom ||--o{ Payment : "Heimat" + Case ||--o{ Case : "Unterakte" + Case ||--o{ Chapter : "Gliederung" + Matter ||--o{ Chapter : "Gliederung" + Matter ||--o{ Matter : "Teilvorgang" + Matter }o--o{ Case : "Zuordnung" + Matter }o--o{ Matter : "Querverweis" + Element ||--o{ Binding : "Einbindung" + Case ||--o{ Binding : "Kontext" + Matter ||--o{ Binding : "Kontext" + Compilation ||--o{ Binding : "Kontext" + Binding ||--o{ ContextAnnotation : "Anmerkung" + Element ||--o| NoteBody : "gemeinsamer Text" + Payment ||--o{ PaymentLine : "Buchung und Korrektur" + Payment ||--o{ PaymentAllocation : "Verwendung" + Invoice ||--o{ PaymentAllocation : "nur outbound" + Invoice ||--o{ ReimbursementAllocation : "mitgeteilter Betrag" + ReimbursementNotice ||--o{ ReimbursementAllocation : "Mitteilung" + ReimbursementNotice ||--o{ PaymentAllocation : "nur inbound" + Invoice ||--o| AcceptedShare : "Eigenanteil" + Matter ||--o{ Task : "optionaler Kontext" + Matter ||--o{ Deadline : "optionaler Kontext" + Task }o--o{ Deadline : "Verknuepfung" +``` + +### 4.4 Invarianten + +1. Ein Element, ein Vorgang, eine Akte, eine Aufgabe, eine Frist, eine Rechnung, eine Zahlung und eine Erstattungsmitteilung haben genau einen Heimatdatenraum und genau einen aktuellen Owner. Einbindung, Zuordnung, Zuweisung und Betragsverwendung ändern daran nichts. +2. Ein Teilvorgang hat genau einen Elternvorgang. Ein Querverweis setzt keinen zweiten. +3. Strukturelle Elternschaft bleibt im selben Heimatdatenraum: Unterakte zur Akte, Teilvorgang zum Vorgang, Kapitel zum Behälter. Dafür gilt eine zusammengesetzte Fremdschlüsselbindung auf `(id, home_scope_id)`. +4. Zuordnung, Querverweis, Einbindung und Grant dürfen einen anderen Datenraum referenzieren. Hier wird die Scope-ID nicht gleichgesetzt. Das ist die gezielte Anpassung gegenüber dem Composite-Key für organisatorische Eltern im Auth-Blueprint, Abschnitt 9.3. Teilen ist dort ein eigener Anwendungsfall und kein gewöhnliches Update-Feld. +5. Der gemeinsame Notiztext existiert einmal. Eine berechtigte Änderung ist in jeder Einbindung sichtbar, die der Leser sehen darf. +6. Eine Anmerkung hängt an genau einer Einbindung. +7. Eine Sicht speichert Kriterien und liefert zur Laufzeit nur Objekte, die derselbe Leseprädikat-Filter bereits zulässt. +8. Eine Zusammenstellung speichert Verweise. `release_state = pending` ist für Empfänger ohne eigenes Leserecht unsichtbar. +9. Detach löscht die Einbindung. Das Element bleibt. Globales Löschen ist eine zweite Aktion. +10. Der Zahlungsstand einer Rechnung entsteht nur aus der Summe der Zuordnungen ausgehender Zahlungen auf diese Rechnung. Erstattungsstand, Mitteilungsbeträge, Zahlungseingänge und Vorgangsstatus schreiben ihn nicht. +11. `notified_on` nimmt die Bedeutung des bisherigen `erstattet_am` auf. Es ist kein Zahlungseingang. Ein Zahlungseingang ist eine Zahlung mit `direction = inbound`. +12. Unsichtbare Objekte fehlen in Liste, Suche, Count, Chronologie, Download und Export. Die Antwort enthält keinen Titel, keine Anzahl und keinen Herkunftsnamen. Dasselbe gilt für verborgene Einbindungen, Zuordnungen und Verknüpfungen: gezählt und benannt wird nur, was der aktuelle Nutzer lesen darf. +13. Wirksame Geldbeträge sind die Summe der gespeicherten vorzeichenbehafteten Zeilen. `kind` benennt die Zeile und ist kein zweiter Rechenoperator. + +### 4.5 Vorschlag zur aktenbasierten Vererbung + +Bestätigt ist der Regelfall: Rechte werden über die Akte vergeben und an ihre Inhalte weitergegeben. Einschränkungen und bewusste Freigaben gelten im jeweiligen Kontext. Eine zusätzliche Aktenzuordnung überträgt keine Ownership. Bloßes Referenzieren gibt private Inhalte nicht frei. Zugriff über einen Kontext öffnet keine anderen Herkunftskontexte. + +Daraus folgt kein genereller Ausschluss der Vererbung. Unveränderte Ownership und weitergegebene Nutzungsrechte sind zwei Sachverhalte. Der folgende Pfad ist ein Vorschlag. + +| Zugang | Rechtewirkung | Ownership | +|---|---|---| +| Einbindung direkt in der Akte | Aktenrechte, abzüglich ausdrücklicher Elementausnahme in dieser Akte | bleibt am Element | +| Aktenzuordnung eines Vorgangs | Aktenrechte gelten für diesen Vorgang in genau dieser Akte, abzüglich einer ausdrücklichen Vorgangsausnahme in diesem Aktenkontext | bleibt am Vorgang. Es werden keine Grant-Zeilen kopiert. | +| Inhalte dieses Vorgangs, solange die Aktion über dieselbe Akte läuft | dieselben Aktenrechte, abzüglich Elementausnahme in diesem Kontext | bleibt am Inhalt | +| Unterakte mit `inherit_parent` | Rechte der Elternakte | unverändert | +| Unterakte mit `explicit` | eigene Grants der Unterakte | unverändert | +| Teilvorgang, geöffnet über den Elternvorgang in demselben Kontext | wirksame Rechte des Elternvorgangs, abzüglich eigener Ausnahme | bleibt am Teilvorgang | +| Vorgang ohne Akte, direkt geöffnet | eigene Grants und Owner | unverändert | +| Querverweis | keine Vererbung. Das Ziel erscheint nur, wenn der Akteur es über einen eigenen zulässigen Kontext bereits lesen darf | unverändert | +| Zweiter Aktenkontext desselben Vorgangs | nur die Rechte der zweiten Akte. Keine Vereinigung mit der ersten Akte, kein Blick in deren übrige Inhalte | unverändert | + +Die Zuordnung ist der bewusste Schritt in diesen Vererbungspfad. Sie verlangt Freigaberecht am Vorgang und Bearbeitungsrecht an der Zielakte. Ein Inhalt des Vorgangs, den der Zuordnende nicht freigeben darf, wird in diesem Aktenkontext nicht sichtbar. Die Zuordnung des Vorgangsrumpfs kann bestehen; der geschützte Inhalt fehlt ohne Titel und ohne Anzahl. Ein Querverweis ist diese Zuordnung nicht und öffnet nichts. + +Damit bleibt der Alltag aktenbasiert: Wer die Akte lesen, bearbeiten oder weitergeben darf, darf dasselbe an den zugeordneten Vorgängen und ihren nicht ausgenommenen Inhalten, solange er in diesem Aktenkontext handelt. Eine Ausnahme wird ausdrücklich am Vorgang oder am Element in diesem Kontext gesetzt. Ein eigener Grant je Vorgang ist der Weg für einen Vorgang ohne Akte und für eine bewusst engere oder weitere Freigabe gegenüber der Akte, nicht die Voraussetzung jeder Aktenarbeit. + +Offen bleibt die in S-01b benannte genaue Freigabe eines ganzen Vorgangs mit bereits eingeschränkten Inhalten. Die Empfehlung dieser Fassung steht oben: Vererben, Ausnahme und fehlendes Freigaberecht begrenzen den Kontext, Ownership bleibt, Querverweise vererben nicht. Ob stattdessen jeder bereits vorhandene Inhalt trotz Aktenzuordnung eine zusätzliche Einzelfreigabe braucht, ist keine still entschiedene Produktregel. Bis zu einer abweichenden Entscheidung gilt der Vorschlag als technische Arbeitsgrundlage der übrigen Abschnitte. + +## 5. Zugriff und Datenräume + +### 5.1 Abgleich mit den Blueprints + +Prüfergebnis: kein pauschaler Konflikt, eine notwendige produktlokale Ausprägung. + +Der persönliche Standardadapter verlangt, dass die gewählte persönliche Scope-ID das eigene Konto ist. Das bleibt für die Auswahl des persönlichen Raums gültig. Der gemeinsame Datenraum nutzt die Scope-Art `organization` mit aktueller Mitgliedschaft. Nicht registrierte Scope-Arten werden verweigert. Ein fehlender Scope bedeutet nicht „alle Räume“. + +Rechte aus Raum A werden nicht mit Rechten aus Raum B vereinigt. Eine Mitgliedschaft öffnet keine fremde Akte. Eine reine Bedingung `request.scope_id = element.home_scope_id` würde die bestätigte datenraumübergreifende Freigabe unmöglich machen und wird für Einbindungen nicht verwendet. + +Der Datei-Blueprint prüft Parent und Asset gemeinsam und verbietet, private Medien durch eine Parentfreigabe automatisch zu veröffentlichen. In Tsumugu ist das Asset-Leserecht im Handlungscontext entweder Eigentum im Heimtraum oder ein ausdrückliches Grant für genau diesen Context. Der Empfänger muss den Heimtraum nicht auswählen und nicht Mitglied dort sein. Herkunftsakte und übrige Inhalte bleiben unzugänglich. Listen, Counts, Thumbnails, Downloads und HEAD verwenden denselben Filter. Unsichtbare Dateien antworten 404 ohne Dateiname, Größe oder ETag. + +Ein Betreiber- oder Managerrecht ist kein Leserecht auf persönliche Inhalte. Dafür gibt es im MVP keinen Sonderpfad. + +### 5.2 Rollen + +Vorschlag mit wenigen Bündeln. Kein konfigurierbarer Rolleneditor. + +| Ort | Rolle | Lesen | Bearbeiten | Freigeben | Löschen des Behälters | Mitgliedschaft verwalten | +|---|---|---|---|---|---|---| +| Datenraum | Mitglied | nur ausdrücklich geöffnete Inhalte | nur mit Grant | nur mit Grant | nein | nein | +| Datenraum | Manager | wie Mitglied | wie Mitglied | wie Mitglied | nein | ja | +| Akte, Unterakte, Vorgang | Leser | ja, abzüglich Elementausnahme | nein | nein | nein | — | +| Akte, Unterakte, Vorgang | Bearbeiter | ja | ja, abzüglich Schreibschutz | nein | nein | — | +| Akte, Unterakte, Vorgang | Freigebender | ja | nein | ja | nein | — | +| Objekt | Owner | ja | ja | ja | ja, globales Löschen | — | + +Bearbeiten und Freigeben sind getrennt. Ein Grant kann beide zugleich setzen. Der Owner ist kein zusätzliches Häkchen, sondern `owner_subject_id`. Im MVP gibt es genau einen Owner, den Anleger. Ownership-Übertragung wird nicht ausgeführt. + +Die Rollen der Akte gelten im Regelfall auch für zugeordnete Vorgänge und deren nicht ausgenommene Inhalte, solange die Aktion in diesem Aktenkontext stattfindet. Dafür ist kein zweites Grant je Vorgang erforderlich. Ein Grant direkt am Vorgang bleibt der Rechteanker eines Vorgangs ohne Akte und die Stelle für eine ausdrückliche Ausnahme. Neue Notizen in einer Akte oder in einem so erbenden Vorgang erhalten die wirksamen Rechte dieses Kontexts. Eine Ausnahme wird als Grant- oder Sperrzeile am Element in diesem Kontext gespeichert. Der Regelfall bleibt die Akte ohne Einzelkonfiguration. + +### 5.3 Auswertung einer Aktion + +Die Auswertung gilt für den Kontext, aus dem die Aktion kommt. Andere Kontexte desselben Elements werden nicht hinzugemischt und nicht als zusätzliche Sperre gelesen. + +1. Identität, Session, Konto und gewählter Datenraum sind aktuell gültig. Sonst 401 oder 403. +2. Der Behälter des Kontexts ist für den Akteur lesbar, oder der Akteur ist Owner des Elements und handelt im Heimtraum. Sonst 404. +3. `release_state = pending` und kein eigenes Leserecht: 404, ohne Titel. +4. Explizite Elementausnahme in diesem Kontext entfernt Rechte. Ein Schreibschutz entfernt Bearbeiten. Eine Freigabesperre entfernt Freigeben. Eine Ausblendung entfernt Lesen. +5. Sonst gelten die Rechte des Handlungscontexts aus Abschnitt 4.5. Über eine Aktenzuordnung sind das die Aktenrechte, abzüglich einer Ausnahme an Vorgang oder Element in genau dieser Akte. Ein Vorgang ohne diese Zuordnung nutzt eigene Grants. Ein Querverweis fügt keine Rechte hinzu. Eine freigegebene Zusammenstellung gibt nur Lesen auf bereits freigegebene Einträge. Eigenständige Aufgaben, Fristen und Finanzobjekte folgen Abschnitt 5.5. +6. Der Owner darf die Ausnahme selbst ändern. Solange der Schreibschutz im gewählten Kontext besteht, ändert auch der Owner den gemeinsamen Text von diesem Kontext aus nicht. +7. Lesen fehlt: 404. Lesen ist da, die verlangte Fähigkeit fehlt: 403. + +Dieser Ablauf ist der Vorschlag zu der in F-01c offengelassenen Auflösung widersprüchlicher Pfade. Er folgt der bestätigten Aussage, dass eine Einschränkung in A keine globale Sperre einer ausdrücklich erlaubten Einbindung in B ist. Eine spätere globale Schutzregel, etwa ein Hold, ist im MVP nicht vorhanden und würde vor das Kontextrecht treten, ohne die übrigen Inhalte zu öffnen. + +### 5.4 Freigeben, Entziehen, Detach, Löschen + +Neue Einbindung, die jemand anderem Sicht verschaffen kann: der Akteur braucht `can_share` am Element in einem Kontext, den er selbst lesen darf, und `can_edit` am Zielkontext. Die Aktion schreibt Grant und Einbindung in einer Transaktion. Reines Bearbeiten ändert den gemeinsamen Text und vorhandene eigene Einbindungen, erzeugt aber keine neue Sichtbarkeit. + +Sammelfreigabe einer Zusammenstellung setzt an jedem ausgewählten, bereits freigabeberechtigten Eintrag ein Leserecht für die genannten vorhandenen Konten und setzt `release_state = visible`. Fehlt die Freigabebefugnis für einen Eintrag, schlägt die gesamte Aktion fehl; es entsteht keine teilweise neue Sicht. Nachträglich ergänzte Einträge bleiben `pending`, bis „Neue Inhalte freigeben“ sie in einer weiteren Transaktion erfasst. Eine Textänderung an einer schon sichtbaren gemeinsamen Notiz braucht diese zweite Freigabe nicht. + +Entzug löscht oder verengt das Grant und wird in derselben Transaktion auditiert. Bereits laufende Dateistreams enden an der nächsten Read-Lease-Prüfung des Datei-Blueprints. Ein Entzug in B lässt ein eigenständiges Grant in A bestehen. + +Detach entfernt eine Einbindung und ihre Anmerkungen. Andere Einbindungen und der gemeinsame Text bleiben. Die letzte Einbindung entfernt das Element nicht; es bleibt beim Owner im Heimatdatenraum. + +Globales Löschen, Vorschlag bis zur Rückfrage: nur der aktuelle Owner. Es setzt `deleted_at`, entfernt alle Einbindungen und startet für eigene Dateien den Purge-Vertrag des Datei-Blueprints. Paperless-Dateien werden in Paperless nicht gelöscht. Wiederherstellung ist im MVP nicht vorgesehen. + +Eine Aktenzuordnung ist für die Berechtigten dieser Akte sichtbar, weil sie der Vererbungskontext ist. Ein Querverweis wird nur angezeigt, wenn das Ziel über einen eigenen zulässigen Kontext lesbar ist. Andernfalls fehlt die Zeile. Es gibt keinen gesperrten Eintrag mit fremdem Titel. Eine Antwort zählt und benennt nur Einbindungen, die der aktuelle Nutzer lesen darf. Sie enthält kein Feld und keinen Satz, der allein die Existenz einer verborgenen Einbindung anzeigt. Der allgemeine Hinweis, dass eine Textänderung den gemeinsamen Inhalt betrifft, darf bei jeder solchen Änderung erscheinen, unabhängig davon, ob weitere Einbindungen existieren. + +### 5.5 Eigenständige Aufgaben, Fristen und Finanzobjekte + +Aufgaben, Fristen, Rechnungen, Zahlungen und Erstattungsmitteilungen verwenden `home_scope_id`, `owner_subject_id` und `access_grants`. Es entsteht kein zweites Rollenmodell. Die zugewiesene Person ist ein begrenztes Grant auf dieses eine Objekt: lesen und den Arbeitsstatus ändern. Sie erhält dadurch kein Freigeben, kein Löschen, keine Ownership und keinen Zugriff auf verknüpfte Objekte. + +| Aktion | Ohne Vorgang | Im Vorgangskontext | +|---|---|---| +| Anlegen | Akteur wird Owner im gewählten Datenraum. Andere Raummitglieder sehen das Objekt erst nach Grant oder Zuweisung. | Bearbeitungsrecht am Vorgang. Heimat und Owner bleiben am neuen Objekt. Die Vorgangsrechte gelten zusätzlich in diesem Kontext, abzüglich einer Ausnahme. | +| Lesen | Owner, explizites Grant oder zugewiesene Person | dieselben Personen und wer den Vorgang in diesem Kontext lesen darf | +| Ändern | Owner oder Bearbeitungsgrant. Die zugewiesene Person darf Status und eigene Arbeitsfelder ändern, nicht Grants und nicht den Owner. | Bearbeitungsrecht des Vorgangskontexts, mit derselben Grenze für die zugewiesene Person | +| Zuweisen | Freigaberecht am Objekt. Die Zuweisung legt nur das begrenzte Grant der Zielperson an. | Freigaberecht im Vorgangskontext oder am Objekt. Die Zielperson wird nicht berechtigt am Vorgang. | +| Löschen | Vorschlag: der Owner, analog zum globalen Löschen von Elementen | Aus dem Vorgang lösen entfernt nur die Kontextbindung. Das Objekt und seine anderen Nutzungen bleiben. | +| Listen, Suche, Sichten | dasselbe Leseprädikat. Die festen Aufgaben-/Fristensichten zeigen eigenständige Objekte ihrem Owner, ihren Grants und der zugewiesenen Person; die Erstattungssicht folgt mit dem Finanzausbau. | zusätzlich den Personen, die den Vorgang lesen dürfen. Ein Treffer nennt den Vorgang nur, wenn dieser selbst lesbar ist. | + +Eine Verknüpfung mit einem geschützten Objekt setzt voraus, dass der Akteur das Ziel lesen und das Ankerobjekt bearbeiten darf. Sie überträgt die Rechte nicht in der anderen Richtung. Die zugewiesene Person sieht ihre Aufgabe oder Frist, nicht den Vorgang, die Akte oder die Rechnung, die sie nicht lesen darf. In der Aufgabe fehlt dann jede Zielzeile, ohne Hinweis, dass ein geschütztes Ziel existiert. + +Dieselbe Grenze gilt für Finanzobjekte. Eine unzugeordnete Zahlung sehen Owner und Grants. Eine Zuordnung auf eine Rechnung sehen die Leser dieser Rechnung als Betrag und Datum dieser Verwendung. Weitere Verwendungen derselben Zahlung, unlesbare Rechnungen und der nicht sichtbare Rest erscheinen nicht und werden nicht gezählt. Ein Zahlungseingang wird nie als Verwendung auf eine Rechnung gespeichert. Wer eine Mitteilung lesen darf, sieht einen verknüpften Eingang nur in dem Umfang, in dem er auch die Zahlung oder diese eine Verwendung lesen darf. + +### 5.6 Anwalt und RLS + +Der spätere Anwaltszugang kann ein Leserecht auf eine Zusammenstellung an ein weiteres Subjekt vergeben. Die Zugangsform bleibt offen und ist keine MVP-Funktion. Ein Exportpaket wäre ein eigenes Asset mit dem Stand zum Erzeugungszeitpunkt; auch das liegt außerhalb des MVP. + +Vertrag ADR-06 und offener Punkt O1: vertrauliche Mehrraumdaten brauchen eine ausdrückliche RLS-Prüfung. Vorschlag: ab P1 App-Policy, zusammengesetzte Fremdschlüssel und eine Runtime-Rolle ohne DDL, Owner und `BYPASSRLS`. Vor dem ersten Produktivbetrieb mit echten Daten zusätzlich RLS als zweite Linie, mit transaktionslokalem Subjekt und einem Grant-Prädikat, das datenraumübergreifende Leserechte nur über `access_grants` zulässt. Pool-Rückgabe darf diesen Kontext nicht behalten. RLS ersetzt die App-Policy nicht. Ein stiller, auf die Scope-ID beschränkter RLS-Filter wäre ein Fehler, weil er bestätigte Freigaben aussperren oder, bei zu weiter Policy, fremde Akten öffnen würde. + +## 6. Arbeitsabläufe und Schnittstellen + +Jede fachliche Route verlangt Session, CSRF bei Schreibzugriffen und das Scope-Headerpaar. Der Server prüft die Mitgliedschaft neu. Antwort-DTOs enthalten nur freigegebene Felder. + +Gemeinsame Schreibregel: `expected_version` am geänderten Anker, 409 bei Abweichung, Audit in derselben Transaktion, keine externe HTTP-Kommunikation bei offener Transaktion. Dateibytes werden nach dem Datei-Blueprint in den Phasen U0–U3 geschrieben; die fachliche Aktivierung ist der Commit von U3. + +### 6.1 Ablaufkern + +| Ablauf | Transaktion | Ergebnis | +|---|---|---| +| Vorgang anlegen | Insert Vorgang, Owner = Akteur, Audit | Vorgang ohne Akte, Status `open` | +| Akte zuordnen | Insert `matter_case_links`, keine Grant-Kopie, keine Owner-Änderung. Freigaberecht am Vorgang und Bearbeitungsrecht an der Akte. | Dieselbe Vorgangsversion. Aktenrechte gelten danach in diesem Aktenkontext nach Abschnitt 4.5. Nicht freigebbare Inhalte bleiben unsichtbar. | +| Teilvorgang anlegen | Insert mit genau einem `parent_matter_id` im selben Heimatraum | Eigene Ownership. Im Elternkontext gelten die Elternrechte, abzüglich einer eigenen Ausnahme. Keine kopierte zweite Grant-Menge. | +| Querverweis | Insert `matter_cross_links`, wenn das Ziel bereits über einen zulässigen Kontext lesbar ist und der Ausgangskontext bearbeitbar ist | Keine zweite Elternschaft und keine Vererbung | +| Notiz im Kontext anlegen | Element, Body, Einbindung, Audit | Erbt den Behälter, sofern keine Ausnahme mitgegeben wird | +| Gemeinsamen Text ändern | Update `note_bodies` nach Kontextrecht, Version, Audit | Derselbe Text in jeder Einbindung, die der Leser sehen darf. Die Antwort nennt nur diese sichtbaren Einbindungen und ihre Anzahl. Ein stehender Hinweis besagt, dass die Änderung den gemeinsamen Inhalt betrifft. Dieser Hinweis erscheint bei jeder solchen Änderung und nicht erst, wenn verborgene Einbindungen existieren. | +| Anmerkung | Insert an der Einbindung | Erscheint nicht in anderen Kontexten | +| Einbindung lösen | Delete Binding und zugehörige Anmerkungen | Element bleibt | +| Element löschen | Owner, Tombstone, Bindings weg, Datei-Purge anstoßen | Paperless-Original bleibt | +| Aufgabe anlegen oder zuweisen | Insert im Datenraum oder im Vorgangskontext, optionales begrenztes Grant der zugewiesenen Person | Zugewiesene Person ist nicht Owner und sieht verknüpfte geschützte Ziele nicht | +| Aufgabe erledigen | `task_status = done` | Verknüpfte Frist bleibt `open` | +| Frist erfüllen | eigene Aktion, `fulfilled_at` | Unabhängig von Aufgaben | +| Zahlung erfassen | Insert `payments` plus eine positive `payment_lines`-Buchung | Richtung `outbound` oder `inbound`. Noch keine Rechnungswirkung. | +| Zahlung verwenden | Insert `payment_allocations` mit positivem Betrag | `outbound` nur auf eine les- und bearbeitbare Rechnung. `inbound` nie auf eine Rechnung. | +| Korrektur | Weitere Zeile mit gespeichertem negativem Betrag an Zahlung oder Zuordnung | Wirksamer Betrag = Summe der Zeilen. Keine zweite Subtraktion. | +| Rechnung anlegen | Insert Rechnung, optional Dokumentelement, optionaler Vorgang | Zahlungs- und Erstattungsstand starten unabhängig vom Vorgang und von späteren Eingängen | +| Zusammenstellung freigeben | Grants plus `release_state` in einer Transaktion | Empfänger sieht weder Herkunftsakte noch `pending`-Einträge | + +Vorgangsstatus wird von Hand gesetzt. Offene Rechnungen, Aufgaben oder Fristen schließen ihn nicht automatisch und halten ihn nicht automatisch offen. Die offene Erstattungsklärung bleibt an der Rechnung und in der Sicht sichtbar; eine verknüpfte Aufgabe ist der Arbeitsnachweis, entsteht im MVP aber nur, wenn der Nutzer sie anlegt. Eine automatische Aufgabe je offener Rechnung ist nicht beschlossen. + +### 6.2 API-Verzeichnis + +Eingaben sind JSON-Körper ohne unbekannte Felder. Anlage antwortet 201 mit `Location`. Löschen und Detach antworten 204. Listen antworten `{items, next_cursor}`. + +**Handlungskontext:** Das Scope-Headerpaar wählt den Datenraum, nicht den Rechtepfad innerhalb dieses Raums. Wird ein Vorgang oder dessen Inhalt über eine Akte geöffnet/bearbeitet, tragen Leseaufrufe zusätzlich `context_kind` und `context_id` als Queryparameter, Schreibaufrufe einen `context` mit `kind` und `id` im JSON. Die folgenden Eingabetabellen sind um diesen Kontext zu verstehen, wo die Operation einen geerbten Rechtepfad nutzt. Der Server prüft den Kontext, die aktuelle Zuordnung zum Ziel und die effektiven Ausnahmen in derselben Rechteauswertung; ein mitgesendeter Kontext allein erteilt keine Rechte. Ohne Kontext sind nur direkte Owner-/Objektgrants nutzbar, keine zufällig ausgewählte Aktenzuordnung. Es werden weder Rechte aus mehreren Akten vereinigt noch versteckte Alternativpfade gesucht. Aktenchronologie und Detailansichten verwenden denselben geprüften Kontext. Die Kontextwahl ist ein technischer Vertrag, keine neue Rollenentscheidung. + +| Methode und Pfad | Eingabe | Ausgabe | +|---|---|---| +| `GET /api/health` | — | `{status, app}` für den bestehenden Deploy-Smoke | +| `GET /health/live`, `GET /health/ready` | — | sicherer Liveness-/Readiness-Status | +| `POST /api/v1/auth/login`, `POST /api/v1/auth/logout`, `GET /api/v1/auth/session` | Login: E-Mail, Passwort | Session-Sicht ohne Tokenkörper. Cookie setzt der Server. | +| `POST /api/v1/auth/session/scope` | gewünschte Scope-Art und ID | bestätigter Scope oder geschlossene Fachansicht | +| `POST /api/v1/invitations` | E-Mail, optional Raum | Einladung. Nur Betreiber oder Manager. | +| `POST /api/v1/invitations/{id}/accept` | Anzeigename, Passwort | Konto und persönlicher Raum | +| `GET /api/v1/rooms` | — | Räume, die die Session auswählen darf | +| `POST /api/v1/rooms` | Name | gemeinsamer Raum, Akteur wird Manager | +| `POST /api/v1/cases` | Titel, optionale Elternakte | Akte | +| `GET /api/v1/cases/{id}` | — | Akte, sichtbare Kapitel, sichtbare Einbindungen, sichtbare Vorgangszuordnungen | +| `PATCH /api/v1/cases/{id}` | Titel, Status, `expected_version` | Akte | +| `POST /api/v1/cases/{id}/grants` | Subjekt, Fähigkeiten | Grant | +| `DELETE /api/v1/grants/{id}` | — | Entzug | +| `POST /api/v1/cases/{id}/chapters` | Titel, Position | Kapitel | +| `POST /api/v1/matters` | Titel, optional Elternvorgang | Vorgang | +| `GET /api/v1/matters/{id}` | optional `context_kind`, `context_id`; erforderlich für einen geerbten Rechtepfad | Vorgang, im Kontext sichtbare Einbindungen, Aufgaben, Fristen; Rechnungsstände ab Finanzausbau | +| `PATCH /api/v1/matters/{id}` | Titel, Status, `expected_version`, bei geerbtem Rechtepfad `context` | Vorgang | +| `POST /api/v1/matters/{id}/case-links` | `case_id` | Zuordnung. Keine Owner-Änderung. Die Antwort nennt keine Inhalte, die wegen fehlenden Freigaberechts unsichtbar bleiben, und auch nicht deren Anzahl. | +| `DELETE /api/v1/matter-case-links/{id}` | — | Zuordnung gelöst, Vorgang bleibt | +| `POST /api/v1/matters/{id}/cross-links` | Zielvorgang | Querverweis | +| `POST /api/v1/notes` | Kontext, Titel, Dokument | Element und Einbindung | +| `POST /api/v1/bindings/{id}/annotations` | Text | Anmerkung | +| `POST /api/v1/bindings` | Element, Zielkontext | neue Einbindung | +| `DELETE /api/v1/bindings/{id}` | — | Detach | +| `POST /api/v1/elements/{id}/delete` | `expected_version` | globales Löschen | +| `GET /api/v1/matters/{id}/chronology`, `GET /api/v1/cases/{id}/chronology` | Cursor, gegebenenfalls geprüfter Aktenkontext | nur im Kontext sichtbare Ereignisse | +| `PATCH /api/v1/notes/{id}` | Dokument, `expected_version`, Kontext der Aktion | gemeinsamer Text, `visible_bindings` nur mit lesbaren Einbindungen, stehender Hinweis auf die gemeinsame Wirkung | +| `POST /api/v1/tasks`, `PATCH /api/v1/tasks/{id}` | Titel, optional Vorgang, Status, `expected_version` | Aufgabe ohne geschützte Zielzeile | +| `POST /api/v1/tasks/{id}/assignee` | Subjekt | begrenztes Grant. Antwort enthält keine neuen Rechte am Vorgang. | +| `POST /api/v1/deadlines`, `POST /api/v1/deadlines/{id}/fulfill` | Titel, Datum, optional Vorgang oder Element | Frist | +| `GET /api/v1/views/open-tasks`, `/open-deadlines`, `/open-reimbursements` | optional Raum | nur selbst lesbare Treffer, einschließlich berechtigter eigenständiger Objekte | +| `GET /api/v1/search` | `q` | sichtbare Titel und Notiztexte, ohne Treffer aus unlesbaren Ankern | +| `POST /api/v1/payments` | `direction`, positive Betragszeichenkette, Währung, `paid_on` | Zahlung und eine positive Buchungszeile, ohne Rechnungswirkung | +| `POST /api/v1/payments/{id}/corrections` | positive Betragszeichenkette der Rücknahme | gespeicherte negative Zeile. Ausgabe enthält den wirksamen Betrag als Summe. | +| `POST /api/v1/payments/{id}/allocations` | Zielart, Ziel-ID, positive Betragszeichenkette | Zuordnung. `inbound` auf eine Rechnung wird mit 422 abgelehnt. | +| `POST /api/v1/payment-allocations/{id}/corrections` | positive Betragszeichenkette | gespeicherte negative Zuordnungszeile | +| `POST /api/v1/invoices` | Betrag, Währung, optionales Dokument, optionaler Vorgang | Rechnung. Zahlungsstand aus ausgehenden Zuordnungen, zunächst offen. | +| `GET /api/v1/invoices/{id}` | — | Betrag, abgeleiteter Zahlungsstand, Erstattungsstand, sichtbare Zuordnungen. Keine Geschwisterziele und kein verdeckter Rest. | +| `POST /api/v1/compilations`, Einträge, `POST …/release`, `POST …/release-new` | Auswahl, Empfänger-Subjekte | Zusammenstellung ohne Herkunftsdaten | +| Medienpfade | Upload, Content-PUT, Download, Detach | Datei-Blueprint, Parent ist das Dateielement | + +Kein zweites OpenAPI-Dokument in dieser Fassung. Die spätere Generierung aus den Pydantic-Modellen ist der Maschinenvertrag. + +Die Finanz-, Erstattungs- und Zusammenstellungsrouten sind hier bereits als Ausbauentwurf beschrieben; sie gehören nicht allein durch ihre Auflistung zum ersten nutzbaren Schnitt. Es werden jeweils nur die tatsächlich gelieferten Routen registriert. `/views/open-reimbursements` folgt mit den Finanzfunktionen; Aufgaben-/Fristenübersichten sind schon im ersten Schnitt enthalten. + +### 6.3 Oberfläche + +Bedienflächen für F-05a, ohne neue visuelle Richtlinie: Raumwahl, Liste und Detail von Vorgang und Akte, Notiz mit gemeinsamem Text und getrenntem Anmerkungsfeld, Dateien/Referenzen, Aufgaben- und Fristenleiste sowie zentrale Aufgaben-/Fristenübersicht. Rechnungsblock, Erstattungssicht und virtuelle Zusammenstellung folgen als Ausbau. Ein Scope-Wechsel bricht laufende Requests ab und verwirft personenbezogene Ergebnisse der vorigen Epoche. Ungespeicherte Formulare werden vor dem Wechsel angehalten. + +Die genaue Darstellung vollständig gesperrter Verweise ist durch Weglassen entschieden genug für den MVP. Eine Vorschau mit Titel bleibt offen und wird nicht gebaut. + +## 7. Dateien, Paperless und Finanzen + +### 7.1 Eigene Ablage und externe Referenz + +| Art | Bytes | Metadaten | Löschen | +|---|---|---|---| +| Eigenes Element `file` | Tsumugu-Storage hinter `StoragePort`, versionierte Wurzel, kein Pfad aus dem Client | Asset plus Einbindung | Detach löst nur die Einbindung. Globales Löschen folgt dem Purge-Vertrag. | +| Element `external_ref` | bleiben in Paperless oder einer späteren Quelle | Tsumugu hält Quelle, externe ID, Anzeigetitel und die synchronisierten Felder | Tsumugu löscht die Referenz und die eigenen Beziehungen. Das Quelldokument bleibt. | +| Element `note` / `correspondence` | kein Medienobjekt, Text in `note_bodies` | fachliche Daten in Tsumugu | wie andere Elemente | + +Erster Dateischnitt, Vorschlag der registrierten Profile: JPEG, PNG, WebP und PDF als Anhang. Größen und Quarantäne folgen den Defaults des Datei-Blueprints und dürfen im Produktprofil begründet angepasst werden. Video, Audio und E-Mail-Import sind nicht im MVP. Ein IMAP-Verweis kann später ein weiteres `external_ref` werden; im MVP gibt es dafür keinen Abruf. + +Upload startet nur bei Bearbeitungsrecht am Zielkontext. Der Download nutzt den Readplan: Sessioncookie, geprüfter Scope, lesbare Einbindung, lesbares Asset, aktuelle Revision. Kein öffentlicher `/media`-Mount und keine Session in der URL. + +Ausfall des Storage: neue Uploads und Downloads antworten 503 `storage_unavailable`. Bereits gespeicherte fachliche Metadaten bleiben lesbar. Die Oberfläche zeigt den Dateizustand `unavailable`, ohne einen leeren Erfolg zu melden. + +### 7.2 Paperless-Felder + +Die sieben genannten Bestandsfelder sind noch keine geprüften API-Namen. P6 gleicht die echten Feldschlüssel ab. Bis dahin gelten diese fachlichen Ziele. Maßgeblichkeit erlaubt weiterhin Änderungen auf beiden Seiten und ist keine Überschreibungsregel bei Konflikten. Bestätigt F-02b und F-02c. + +| Bestandsfeld | Tsumugu-Ziel | Vorschlag der Zuständigkeit | Nicht tun | +|---|---|---|---| +| Rechnungsbetrag | `invoices.amount` | Paperless für den Belegbetrag, beide Richtungen | nicht mit Zahlungssumme überschreiben | +| Erstattungsbetrag | Summe der `reimbursement_allocations` der Rechnung | Tsumugu für die einzelnen Zuordnungen. Der Paperless-Skalar ist der bisherige Sammelwert. | nicht als Geldeingang und nicht als einzige historische Teilbetragsquelle lesen | +| Zahlungsziel | `invoices.due_on` | Paperless für das Belegdatum, beide Richtungen | keine automatische Verlängerungsberechnung | +| bezahlt_am | `invoices.document_paid_on` | Belegfeld, beide Richtungen | nicht in `payments` oder `payment_lines` umwandeln | +| erstattet_am | `reimbursement_notices.notified_on` | Mitteilungsdatum, beide Richtungen | nicht als Zahlungseingang, nicht als `payment_lines` und nicht im Rechnungszahlungsstand | +| eingerecht_am | `invoices.submitted_on` | Arbeitsdeutung Einreichungsdatum, beide Richtungen. Der technische Feldname wird in P6 geprüft. | nicht als Zugang oder Zahlung | +| Ablaufdatum | `retain_until` am referenzierten Element | Aufbewahrungsdatum, beide Richtungen | keine automatische Löschung | + +Nur Tsumugu, ohne Spiegel: Zahlungen, Zahlungs- und Mitteilungszuordnungen, akzeptierter Eigenanteil, Aufgaben, Fristen, Grants, Vorgangsstatus, Anmerkungen. + +Abgleich je Feld gegen den letzten gemeinsamen Stand: + +- Nur eine Seite weicht ab: diesen Wert übernehmen und den gemeinsamen Stand fortschreiben. +- Beide Seiten weichen ab und sind verschieden: `sync_status = conflict`, beide Werte behalten, keine stille Wahl nach Zuständigkeit. +- Beide Seiten setzen denselben neuen Wert: übernehmen, kein Konflikt. +- Paperless nicht erreichbar: `sync_status = source_unavailable`. Lokale Arbeit geht weiter. Die Oberfläche zeigt den Stand je Feld. Ein fehlgeschlagener Lauf meldet keinen Erfolg. + +Identische Werte sind kein Konflikt. Historische `erstattet_am`-Werte werden bei einer späteren Übernahme nur nach `notified_on` kopiert. + +Die Paperless-Identität, ein technischer API-Nutzer oder nutzerbezogene Schlüssel, bleibt am Paket P6 offen. Sie war im Ursprungsgespräch ausdrücklich unentschieden. + +### 7.3 Finanzmodell + +Vorschlag eines kleinen manuellen Modells. Kein Kontenrahmen, keine Soll- und Habenbuchung und kein Bankabgleich. Währung trägt jede Zahlung und jede Rechnung selbst. Vorschlag für den Regelfall ist EUR. Eine Zuordnung ist nur bei gleicher Währung zulässig. Beträge sind `numeric` und in der API Dezimalzeichenketten. Summen runden auf die kleinste Währungseinheit. Kein Netto-Brutto-Split und kein Währungswechsel im MVP. + +Eine Zahlung hat eine eigene Identität. Die Richtung ist `outbound` für Geld, mit dem eine Rechnung bezahlt wird, und `inbound` für einen tatsächlichen Geldeingang, etwa eine überwiesene Erstattung. Betrag, Währung und Datum gehören zur Zahlung. Sie kann ohne jede Zuordnung bestehen und bleibt dann ein eigenständiger Rechteanker nach Abschnitt 5.5. + +Die Zuordnung ist ein zweiter Sachverhalt: sie verwendet einen Teil einer bestehenden Zahlung für ein zulässiges Ziel. Eine ausgehende Zahlung kann auf mehrere Rechnungen verteilt werden. Das ist die Sammelzahlung. Eine Rechnung kann Zuordnungen aus mehreren Zahlungen tragen. Das ist die Teilzahlung. Ein Eingang darf keiner Rechnung als Bezahlung zugeordnet werden; ein solcher Versuch endet mit 422. Ein Eingang kann optional einer Erstattungsmitteilung zugeordnet werden. Diese Verbindung erklärt den Eingang, bezahlt keine Rechnung und schließt die Erstattungsbearbeitung nicht. + +| Begriff | Speicher | Berechnung und Bedeutung | +|---|---|---| +| Buchung einer Zahlung | eine `payment_lines`-Zeile, `kind = posting`, Betrag > 0 | Ausgangsbetrag | +| Korrektur einer Zahlung | weitere `payment_lines`-Zeile, `kind = correction`, Betrag < 0 | Rücknahme eines Teils der Zahlung | +| Wirksamer Zahlungsbetrag | Summe aller `payment_lines.amount` dieser Zahlung | Beispiel: Buchung `100.00` und Korrektur `-20.00` ergeben `80.00`. Die Korrektur wird nicht noch einmal abgezogen. | +| Verwendung | `payment_allocations.amount`, Zuordnung > 0, Korrektur < 0 | Summe der Zeilen einer Zahlung bleibt zwischen 0 und dem wirksamen Zahlungsbetrag, jeweils einschließlich | +| Rechnungszahlung | Summe der Zuordnungszeilen mit Ziel dieser Rechnung aus Zahlungen `outbound` | abgeleitet `open` bei Summe ≤ 0, `partial` bei 0 < Summe < Rechnungsbetrag, `paid` bei Summe ≥ Rechnungsbetrag | +| Belegdatum bezahlt | `document_paid_on` | unabhängig von der Summe | +| Einreichung | `submitted_on` | unabhängig von Mitteilung und Zahlung | +| Erstattungsmitteilung | `notified_on` plus Dokumentreferenz | kein Geldeingang | +| Mitgeteilter Betrag | Summe der `reimbursement_allocations.amount` je Rechnung, dieselbe Vorzeichenregel | kein Zahlungsstand | +| Zahlungseingang | Zahlung `inbound` | zählt in keiner Rechnungssumme | +| Akzeptierter Eigenanteil | `accepted_shares.amount` | nur durch ausdrückliche Erfassung | +| Erstattungsbearbeitung | `reimbursement_state` `none`, `open`, `done` | unabhängig von beiden Zahlungsrichtungen und vom Vorgang | + +Die API nimmt eine Rücknahme als positive Betragszeichenkette entgegen und speichert den negierten Wert. Gerechnet wird ausschließlich mit den gespeicherten Zeilen. `kind` dient der Anzeige und der Prüfung, dass Buchung und Zuordnung positiv und Korrekturen negativ sind. Eine positive Korrekturzeile und eine Formel „Zahlungen abzüglich Korrekturen“ gibt es nicht. + +Regelfall in der Bedienung: eine ausgehende Zahlung über den Rechnungsbetrag und eine Zuordnung auf diese Rechnung. Bei einer Erstattung eine Mitteilung, eine Betragszuordnung auf die Rechnung und, wenn der Rest endgültig akzeptiert ist, eine Eigenanteilszeile, die die Bearbeitung auf `done` setzt. Der spätere Geldeingang ist eine eigene eingehende Zahlung. Weitere Teilzahlungen, Teilzuordnungen und Nacherstattungen sind zusätzliche Zeilen, nicht der voreingestellte Dialog. + +`done` ist zulässig, wenn der Nutzer die Erstattungsbearbeitung abschließt, einschließlich eines akzeptierten Eigenanteils. Ein Klärungsbedarf bleibt `open`. Eine offene Rechnungszahlung bleibt im Zahlungsstand sichtbar, auch wenn die Erstattung `done` oder ein Eingang erfasst ist. Zwei Rechnungen desselben Vorgangs tragen getrennte Stände. + +Eine Sammelmitteilung ohne erkannte Rechnung bleibt eine Mitteilung ohne Betragszuordnung und wird nicht automatisch verteilt. Ein Eingang ohne Mitteilung bleibt eine unzugeordnete Zahlung `inbound`. Eine ausgehende Zahlung ohne Rechnung bleibt eine unzugeordnete Zahlung `outbound`. + +Diese Statusnamen sind Vorschläge. Die Trennung von Mitteilung, Geldeingang und Rechnungszahlung ist bestätigt. + +## 8. Umsetzungspakete + +Jedes Paket liefert Migrationsdateien, Fachcode und die genannten Tests. Die Tests sind geplant. Diese Fassung hat sie nicht ausgeführt und behauptet kein Testergebnis. Negativtests laufen gegen kurzlebiges PostgreSQL, nicht gegen die Dev- oder Prod-Datenbank auf dem Pi. + +| Paket | Ergebnis | Abhängig von | Geplante Abnahme | +|---|---|---|---| +| P0 Foundation und Rand | `create_app`, Settings, Pool, Migrations-CLI, sichere Health-URLs, Problem-Details, Backend nur an `127.0.0.1`, Security-Header. Noch keine Fachrouten. | bestehendes Compose-Gerüst | Import ohne Datenbank, unbekannte Umgebung startet nicht, `/api/health` bleibt für die vorhandenen Workflows erfolgreich, Runtime-Rolle ohne DDL. | +| P1 Identität und Policy | Einladung, Session-Cookie, persönlicher und gemeinsamer Raum, Grant-Auswertung, Audit. | P0 | 401 ohne Session, 403 bei fehlender Fähigkeit, 404 für fremde IDs, Manager liest keine fremden persönlichen Elemente. | +| P2 Struktur und Notizen | Akte, Unterakte, Vorgang, Teilvorgang, Kapitel, Einbindung, Anmerkung, Chronologie, erste Oberfläche. | P1 | Szenarien T-ISO, T-SHARE, T-DETACH unten. Vorgang ohne Akte. Dieselbe Version in zwei Akten. | +| P3 Eigene Dateien und Referenzen | Upload, geschützter Download, externes Referenzobjekt ohne Live-Abgleich. | P2 | Download nur mit Einbindungs- und Assetrecht. Detach löscht keine Bytes. Paperless-ID ohne Dateikopie. Storage-Ausfall 503. | +| P4a Aufgaben und Fristen | Aufgaben, unabhängige Fristen und ihre Verknüpfungen. Erste benutzbare Lieferung. | P2 | T-DL und T-ANCHOR-01 unten. | +| P5a Übersicht und Suche | Offene Aufgaben/Fristen, berechtigte Suche und Counts. Erste benutzbare Lieferung. | P2, P4a | Sichten ändern keine Grants. Aufgaben und Fristen aus mehreren Akten bleiben zentral auffindbar, ohne Trefferleck. | +| P4b Finanzen | Rechnungen, Zahlungen, Zuordnungen, Eigenanteil. Nach der ersten benutzbaren Lieferung. | P2 | T-FIN und T-ANCHOR-02 unten. | +| P5b Weitere Sichten und Zusammenstellungen | Erstattungssicht, virtuelle Zusammenstellung, Sammelfreigabe, nachträgliche Freigabe. Lieferposition noch offen. | P2; Erstattungssicht P4b; für Dateien P3 | T-COMP. Sichten ändern keine Grants. Suche und Counts ohne Trefferleck. | +| P6 Paperless-Abgleich | Feldweise Synchronisation, Konflikt, Ausfallanzeige. Nach der ersten benutzbaren Lieferung. | P3, für Finanzfelder P4b und ein ausdrücklich erlaubter Anschlusstest | T-META. Kein Test gegen ein Produktionssystem in diesem Spezifikationsauftrag. | +| P7 Erster echter Betrieb | Qualifiziertes Release, konsistentes Backup von Datenbank und Medien, Restore-Übung, RLS-Prüfung, HSTS-Nachweis, Produktprofil mit RPO/RTO. Bereits für die erste Lieferung mit echten Daten erforderlich. | Qualifizierung von P0–P3, P4a und P5a; spätere Ausbauten jeweils zusätzlich qualifizieren | Synthetischer Restore, Sessions nach Restore ungültig, Grant-RLS lässt eine berechtigte Fremdfreigabe zu und eine unberechtigte nicht. | + +Der erste Implementierungsauftrag sollte weiterhin nur P0 umfassen. Die erste benutzbare fachliche Lieferung besteht aus P0–P3, P4a und P5a. P7 qualifiziert sie vor Nutzung mit echten personenbezogenen Daten; die Betriebsvorbereitung kann parallel entstehen und wartet nicht auf Finanzen. P4b und P6 erfüllen anschließend die bestätigten Finanz- und Synchronisationsfähigkeiten. Die gegenseitige Lieferreihenfolge ist fachlich noch nicht separat entschieden; technisch setzen Finanz-Synchronisationsfelder die betreffenden Finanzobjekte voraus. P5b bleibt ein gesonderter Ausbauvorschlag. Kein Paket startet allein durch diese Dokumentation. + +### 8.1 Geplante Nachweise + +| ID | Nachweis | +|---|---| +| T-ISO-01 | Nutzer mit Recht nur an B liest die dort freigegebene Notiz und erhält an A und an anderen Inhalten von A 404. | +| T-ISO-02 | Suche, Count, Chronologie und Download enthalten die nicht freigegebene Notiz nicht, auch nicht als Anzahl oder Titel. | +| T-SHARE-01 | Textänderung ist in A und B sichtbar. Eine Anmerkung an B fehlt in A. | +| T-SHARE-02 | Vollzugriff auf A und B ändert denselben Text von beiden Einbindungen. | +| T-SHARE-03 | Leserecht oder Schreibschutz im gewählten Kontext ändert den Text von dort nicht. | +| T-SHARE-04 | Die Antwort auf eine Textänderung enthält nur Einbindungen, die der Aufrufer lesen darf. Sie ist in Anzahl, Namen und Hinweistext gleich, ob eine für ihn unsichtbare weitere Einbindung existiert oder nicht. Der allgemeine Hinweis auf die gemeinsame Textwirkung erscheint in beiden Fällen. | +| T-CONTEXT-01 | Derselbe Vorgang ist in zwei Akten desselben Datenraums unterschiedlich berechtigt. Lesen, Änderung und Chronologie verwenden ausschließlich den explizit geprüften Handlungskontext. Fehlender, fremder oder nicht zum Ziel gehörender Kontext öffnet keinen anderen Rechtepfad. | +| T-DETACH-01 | Detach in B lässt Element und Einbindung A bestehen. | +| T-GRANT-01 | Bearbeiter ohne Freigaberecht legt keine neue sichtbare Einbindung an. | +| T-COMP-01 | Empfänger der Zusammenstellung liest die freigegebenen Stücke und nicht die Herkunftsakte. | +| T-COMP-02 | Ein später ergänzter Eintrag bleibt für den Empfänger unsichtbar, bis er ausdrücklich freigegeben wird. Eine bereits freigegebene Textänderung bleibt sichtbar. | +| T-DL-01 | Erledigte Vorbereitungsaufgabe lässt die verknüpfte Frist offen. | +| T-ANCHOR-01 | Eine eigenständige Aufgabe sehen andere Mitglieder desselben Raums nicht. Die zugewiesene Person sieht die Aufgabe und ihren Status, nicht den verknüpften Vorgang, den sie nicht lesen darf, und keinen Hinweis auf dieses Ziel. | +| T-ANCHOR-02 | Eine unzugeordnete Zahlung sehen nur Owner und Grants. Suche und offene Finanzsicht enthalten sie für andere Personen nicht. | +| T-FIN-01 | Eine ausgehende Teilzuordnung lässt den offenen Rest der Rechnung bestehen. Eine zweite Zuordnung derselben Zahlung auf eine weitere Rechnung ist nachvollziehbar, ohne die erste zu überschreiben. | +| T-FIN-02 | Akzeptierter Eigenanteil setzt die Erstattungsbearbeitung auf `done` und gilt nicht als Zahlungsnachweis. | +| T-FIN-03 | Zwei Rechnungen eines Vorgangs zeigen getrennte Stände. | +| T-FIN-04 | Übernommenes `erstattet_am` steht in `notified_on`. Ein Eingang ist eine Zahlung `inbound` und steht in keiner Rechnungssumme. | +| T-FIN-05 | Buchung `100.00` und Korrekturzeile `-20.00` ergeben den wirksamen Zahlungsbetrag `80.00`. Dieselbe Summe gilt, wenn `80.00` einer Rechnung zugeordnet sind. Eine zusätzliche Subtraktion findet nicht statt. | +| T-FIN-06 | Ein Eingang über den Erstattungsbetrag lässt den Zahlungsstand der Rechnung unverändert. Die Leser einer Rechnung sehen keine weiteren Verwendungsziele derselben Sammelzahlung und keine Anzahl solcher Ziele. | +| T-META-01 | Einseitige Änderung wird übernommen, abweichende beidseitige Änderung bleibt Konflikt, identische beidseitige Änderung ist kein Konflikt. | +| T-META-02 | Bei unerreichbarem Paperless bleibt der lokale Vorgang nutzbar und der Feldstatus `source_unavailable`. | + +### 8.2 Betrieb des ersten echten Schnitts + +Die vorhandenen Workflows deployen `develop` und `main` durch einen Neubau auf dem Pi. Das erfüllt den Release-Vertrag noch nicht: kein Pflicht-Gate vor der Produktionsumschaltung, keine eindeutige Artefaktzuordnung, kein getrennt qualifizierter Prod-Kandidat. Vorschlag: Entwicklung des MVP darf diesen Weg für synthetische Dev-Daten weiter nutzen. Produktion mit echten Akten wartet auf P7. + +P7 übernimmt das Blueprint-Startprofil als Produktprofilvorschlag: RPO 24 Stunden, RTO 4 Stunden, Sicherung alle zwölf Stunden, sieben tägliche, vier wöchentliche und drei monatliche Stände. Bevorzugt wird R1, sobald eine Ablage für identische Images vorhanden ist. Bis dahin ist ein kontrollierter getrennter Build nur mit eigenem Gate für genau diesen Prod-Kandidaten zulässig. Gitea-`environment` ersetzt die menschliche Freigabe nicht. Ob Branch-Schutz und Runner-Isolation auf `192.168.2.144` das bereits hergeben, ist ungeprüft und wird in P7 festgestellt, nicht hier verändert. + +Backup umfasst Datenbank und eigene Dateien nach einem gemeinsamen Freeze. Paperless-Dateien liegen außerhalb dieses Sets; die Referenz wird mitgesichert, die Bytes bleiben bei Paperless zu sichern. Restore invalidiert Sessions und öffnet Konten erst nach gezielter Freigabe. Ein älteres Backup stellt entzogene Grants nicht als aktuell gültig zurück, ohne die Recovery-Nachbehandlung. + +## 9. Abbildung der Blueprint-Verträge + +| Vertrag | Tsumugu | +|---|---| +| Identität aus der Session, kein Client-Profilheader | Cookie-Session, persönlicher Scope = Konto | +| Fail-closed, keine Probe-Flags | Jede Fachroute registriert eine Capability. Unbekannte Capability startet die App nicht. | +| Scope-Auswahl ist keine Autorität | Headerpaar, Mitgliedschaft oder Eigentum des persönlichen Raums | +| Gemeinsame Sichtbarkeit für Liste, Detail, Suche, Count, Download | Ein Prädikat in `access`, von Chronologie und Medien-Readplan benutzt | +| Teilen als eigener Anwendungsfall | `access_grants` und Einbindung, auditiert, ohne Scope-Gleichheit | +| Eine Transaktion je Änderung inklusive Audit | Services in Abschnitt 6 | +| Migration mit Ledger, Runtime ohne DDL | Paket P0, CLI vor Umschaltung | +| Datei: keine falsche Atomarität, Detach ist nicht Purge | Paket P3 und P7 | +| Release-Gate, Backup, Restore | Paket P7, nicht der heutige Workflow | +| KI nur mit autorisiertem Kontext und Gateway | Im MVP kein Aufruf. Späterer Kontext darf nur bereits lesbare Objekte materialisieren. | +| Entitlement ersetzt keine Objektberechtigung | Kein Tarif. Technische Größengrenzen bleiben. | +| RLS bei vertraulichen Mehrraumdaten prüfen | Vorschlag in Abschnitt 5.6, Umsetzung in P7 | + +## 10. Rückfragen vor der Implementierung + +Die technische Ausgestaltung bleibt eine Arbeitsgrundlage für ausdrücklich beauftragte Pakete. Vier Produktfragen sind noch nicht beschlossen. Die Empfehlung ist jeweils der in dieser Datei ausgearbeitete Vorschlag. Die ersten drei betreffen die Rechte- oder Löschwirkung vor Paket P2. Die vierte betrifft die Reichweite der Aktenvererbung und ist in Abschnitt 4.5 als Arbeitsgrundlage verwendet, nicht als Fachbeschluss. + +1. **Widersprüchliche Rechte.** Schreibschutz in A und Bearbeitungsrecht in B. Empfehlung: Es gilt nur der Kontext der Aktion. A sperrt B nicht. Rechte werden weder über unsichtbare Kontexte vereinigt noch geschnitten. Eine globale Schutzregel gibt es im MVP nicht. +2. **Neue Einbindung.** Empfehlung: Sicht für weitere Personen entsteht nur mit Freigaberecht am Element und Bearbeitungsrecht am Ziel. Bearbeiten allein erweitert den Empfängerkreis nicht. Die Sammelfreigabe ist ganz oder gar nicht. +3. **Letzte Einbindung und globales Löschen.** Empfehlung: Detach entfernt Einbindung und kontextbezogene Anmerkungen. Das Element bleibt beim Owner, auch ohne Einbindung. Globales Löschen darf nur der aktuelle Owner. Paperless-Originale werden nicht gelöscht. Delegiertes Löschen und Ownership-Übertragung bleiben außerhalb des MVP. +4. **Aktenvererbung bei bereits eingeschränkten Vorgangsinhalten.** Empfehlung: Die Aktenzuordnung vererbt die Aktenrechte auf den Vorgang und auf Inhalte ohne ausdrückliche Ausnahme in diesem Aktenkontext. Ein Inhalt ohne Freigaberecht des Zuordnenden bleibt unsichtbar. Querverweise vererben nicht. Ownership bleibt unverändert. Die noch offene Alternative wäre, trotz Aktenzuordnung jeden bereits vorhandenen Inhalt einzeln freizugeben. + +Am späteren Schritt, nicht blockierend: echte Paperless-Feldschlüssel und API-Identität in P6; Zugangsform für den Anwalt; Erinnerungen und Fristverlängerung; Tiefe über eine Unterakten- und Teilvorgangsebene hinaus; Netto/Brutto. Ob ein gesperrter Verweis später einen titellosen Platzhalter zeigen soll, bleibt ebenfalls später. Die Fassung 0.2 zeigt solche Verweise nicht und verrät ihre Existenz nicht. + +Nach Entscheidungen zu den vier Fragen gehören die Beschlüsse in die führende Fachspec. Diese technische Datei wird danach angeglichen, wenn die Entscheidung vom Vorschlag abweicht. F-05a entscheidet die Lieferstaffelung, nicht diese offenen Rechte-/Löschdetails. + +## 11. Grenze dieser Fassung + +Dieser Stand spezifiziert. Fassung 0.3 gleicht die technische Lieferstaffelung an den parallel in der führenden Fachspec festgehaltenen Beschluss F-05a an. Anwendungscode, historische Baseline, Datenbanken, Abhängigkeiten, Workflow-Dateien und andere Repositories bleiben unverändert. Es wurde kein Paperless-, Netz- oder Deploy-Vorgang ausgeführt. Ein Implementierungsauftrag beginnt ausdrücklich und mindestens mit Paket P0. diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 9cae719..86ad5eb 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.24, fachliche Arbeitsgrundlage zur technischen Spezifikation. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.25, erster fachlicher Lieferumfang bestätigt. **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. @@ -78,7 +78,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt | 2 / F-02 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d), Erstattungssemantik in F-03a/b geklärt. | Konkrete Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen und werden für den gewählten MVP-Schnitt gezielt ausgearbeitet. | | 3 / F-03 | Erster Durchgang abgeschlossen: bestehende Erstattungsdaten (F-03a/b), Teilbeträge/Aufgabenbezug (F-03c), akzeptierter Eigenanteil (F-03d) und rechnungseigene Zahlungs-/Erstattungsstände (F-03e). | Konkrete Betrags-/Zahlungszuordnung, Summen, Statuswerte, Korrekturen und Synchronisationsabbildung bleiben für die Ausarbeitung offen. | | 4 / F-04 | Frist als eigenständiger Sachverhalt unabhängig von einer Aufgabe bestätigt (F-04a). | Weitere Klärung auf für Organisation/Nachverfolgung und den MVP tatsächlich blockierende Punkte begrenzen. Konkrete Ereignistypen, Verlängerungen und Erinnerungen nicht vorab für sämtliche Sonderfälle ausarbeiten. Keine automatische Rechtsfristberechnung vorausgesetzt. | -| 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. | +| 5 / F-05 | Erste benutzbare Lieferung „Organisieren und Nachverfolgen“ bestätigt (F-05a). Finanzfunktionen und bidirektionale Paperless-Synchronisation folgen anschließend. | Die bestätigten Anforderungen bleiben erhalten. Konkrete technische Umsetzungspakete und noch offene Rechte-/Löschdetails sind keine durch diese Umfangsentscheidung pauschal freigegebene Implementierung. | 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. @@ -88,6 +88,8 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Aktuelle Übergabe:** Der Nutzer möchte diese Fachspec einem Coding-Agenten zur Erstellung der technischen Spezifikation unter Berücksichtigung der Jinkendo-Architekturrichtlinien und vorhandenen Blueprints übergeben. Der [Übergabeauftrag](TECHNICAL_SPEC_HANDOFF.md) benennt die lokalen Quellen, die erwartete technische Datei und die Grenze zur Implementierung. Diese Übergabe erklärt weder die gesamte Fachspec noch einen konkreten MVP-Schnitt für abschließend freigegeben. Keine erneute umfassende Fachinterviewrunde; Vorschläge konkret ausarbeiten und nur tatsächlich blockierende Grundfragen zurückgeben. +**Aktueller Beschluss zum Lieferumfang:** Nach gezielter Prüfung der technischen Fassung 0.2 bestätigt der Nutzer die erste Lieferung mit Schwerpunkt „Organisieren und Nachverfolgen“ (F-05a). Diese neuere Entscheidung konkretisiert die frühere Übergabe: Der erste fachliche Schnitt steht fest; die vollständige technische Ausgestaltung und offene Produktregeln bleiben davon unterscheidbar. + ## 5. Interviewentscheidungen ### F-01a – Aktenrechte und kontextbezogene Freigabe: bestätigt am 16.10.2026 @@ -322,6 +324,24 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Weiterhin offen:** Friststatus, Abschlussnachweis, Berechnung, Verlängerung und Erinnerungen. Gemäß aktueller Nutzersteuerung werden diese Punkte nur so weit geklärt, wie es die Organisation/Nachverfolgung im gewählten MVP erfordert; keine weitere umfassende Sonderfallrunde gestartet. +### F-05a – Erste benutzbare Lieferung: bestätigt am 16.10.2026 + +**Beschluss:** Der Nutzer bestätigt als erste benutzbare Lieferung den Schwerpunkt „Organisieren und Nachverfolgen“. Finanzfunktionen und bidirektionale Paperless-Synchronisation folgen anschließend als Ausbauschritte. Diese Staffelung streicht keine zuvor bestätigten Anforderungen; insbesondere bleiben manuelle Finanzzuordnungen und ausgewählte bidirektionale Metadaten Bestandteil des Produktziels. + +| In der ersten Lieferung | Zweck | +|---|---| +| Persönliche und gemeinsame Datenräume mit einfachen Aktenrechten | Private und gemeinsame Bearbeitung von Beginn an. | +| Akten, Vorgänge und ihre Verknüpfungen | Sachverhalte strukturiert führen, Inhalte ohne Kopien mehrfach nutzen. | +| Notizen, eigene Dateien und manuelle Paperless-Referenzen | Relevante Informationen am Vorgang zusammenführen, ohne bereits Live-Synchronisation zu benötigen. | +| Chronologie | Fachliche Kommunikation und Ereignisse zeitlich nachvollziehen. | +| Aufgaben, unabhängige Fristen und zentrale Übersicht offener Arbeit | Nächste Schritte und maßgebliche Termine verfolgen. | + +**Erster praktischer Abnahmeablauf:** Einen Miet-/Rechtsstreitvorgang anlegen, mit einer Akte verbinden, ein Schreiben referenzieren oder als eigene Datei ablegen und eine Notiz ergänzen. Eine Aufgabe mit Arbeitsziel und eine unabhängige Frist erfassen; beide erscheinen berechtigt in der zentralen Übersicht. Die Vorbereitung erledigen, ohne dadurch die Frist als eingehalten zu behandeln. Einen zulässigen gemeinsamen Bearbeitungskontext nutzen, während private Inhalte und andere Herkunftskontexte unzugänglich bleiben. Die Chronologie zeigt unterscheidbare fachliche Zeitbezüge. + +**Anschließend:** Rechnungs-/Erstattungs-/Zahlungsfunktionen und ausgewählte bidirektionale Paperless-Metadaten. Deren gegenseitige Lieferreihenfolge ist nicht separat festgelegt. Die Lieferposition weiterer bestätigter Fähigkeiten, insbesondere virtueller Zusammenstellungen mit Sammelfreigabe, wird dadurch nicht endgültig entschieden; sie sind kein zusätzliches Fertigkriterium des hier bestätigten ersten Schnitts. + +**Auswirkungen:** Technische Pakete für Nachverfolgung und Übersichten dürfen nicht auf Finanzfunktionen oder virtuelle Zusammenstellungen warten müssen. Die für echte personenbezogene Daten erforderlichen Schutz-, Release- und Recovery-Verträge gehören zum ersten realen Betrieb und werden nicht bis zum Finanzausbau aufgeschoben. Noch offene Rechte-/Ownership-/Löschregeln bleiben ausdrücklich offen. Es wurde mit dieser Entscheidung noch kein Implementierungsauftrag erteilt. + ## 6. Fortschreibung 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. @@ -372,4 +392,6 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G 16.10.2026, Arbeitsstand 0.24: Auf Nutzerwunsch Übergabe zur technischen Spezifikation vorbereitet. Referenzarchitektur A/B/C v0.3 und vorhandene Spezial-Blueprints gezielt hinsichtlich Geltung/Quellpfaden eingeordnet. Arbeitsauftrag in `TECHNICAL_SPEC_HANDOFF.md`; technische Ausgestaltung und MVP-Schnitt bleiben Ergebnis des nächsten Arbeitsschritts. Keine Implementierung und keine Nachricht an einen anderen Chat versandt. +16.10.2026, Arbeitsstand 0.25: F-05a bestätigt: erste nutzbare Lieferung „Organisieren und Nachverfolgen“, Finanzfunktionen und bidirektionale Paperless-Synchronisation anschließend. Ersten fachlichen Abnahmeablauf und Auswirkungen auf die technische Lieferstaffelung festgehalten. Technische Spec 0.3 wird daran angeglichen; keine Implementierung. + 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. -- 2.43.0 From 2558239bfdfb54cda98e973c34473bb620a39446 Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 16 Oct 2026 22:09:08 +0200 Subject: [PATCH 26/58] Stelle den ersten nutzbaren Ablauf zum Organisieren und Nachverfolgen bereit. Anmeldung, Datenraeume, Akten, Vorgaenge, gemeinsame Notizen, Dateien, manuelle Paperless-Referenzen, Aufgaben und unabhaengige Fristen laufen damit in der Entwicklungsumgebung. Co-authored-by: Cursor --- AGENTS.md | 7 + README.md | 13 +- backend/.dockerignore | 5 + backend/Dockerfile | 6 +- backend/app/__init__.py | 1 + backend/app/access/__init__.py | 1 + backend/app/access/policy.py | 763 ++++++++ backend/app/api/__init__.py | 1 + backend/app/api/deps.py | 97 + backend/app/api/routes.py | 1193 ++++++++++++ backend/app/api/schemas.py | 203 ++ backend/app/auth/__init__.py | 1 + backend/app/auth/accounts.py | 78 + backend/app/auth/security.py | 74 + backend/app/cli.py | 44 + backend/app/content/__init__.py | 1 + backend/app/content/documents.py | 25 + backend/app/core/__init__.py | 1 + backend/app/core/errors.py | 71 + backend/app/core/settings.py | 47 + backend/app/core/timeutil.py | 23 + backend/app/db/__init__.py | 1 + backend/app/db/migrate.py | 90 + backend/app/db/pool.py | 19 + backend/app/entrypoint.py | 18 + backend/app/main.py | 119 ++ backend/app/media/__init__.py | 1 + backend/app/media/storage.py | 71 + backend/app/ops.py | 784 ++++++++ backend/app/present.py | 490 +++++ backend/app/seed.py | 211 ++ backend/main.py | 43 +- .../20261016T210000Z_foundation.sql | 356 ++++ backend/requirements-dev.txt | 3 + backend/requirements.txt | 6 +- docker-compose.dev-env.yml | 7 +- docker-compose.yml | 7 +- docs/DEPLOYMENT.md | 2 + docs/MVP_ANNAHMEN.md | 12 + docs/architecture/TSUMUGU_TECHNICAL_SPEC.md | 2 +- frontend/.dockerignore | 2 + frontend/Dockerfile | 13 +- frontend/index.html | 24 +- frontend/nginx.conf | 21 +- frontend/package-lock.json | 1735 +++++++++++++++++ frontend/package.json | 19 + frontend/src/App.jsx | 85 + frontend/src/api.js | 101 + frontend/src/main.jsx | 13 + frontend/src/pages/Cases.jsx | 395 ++++ frontend/src/pages/Login.jsx | 82 + frontend/src/pages/Matters.jsx | 343 ++++ frontend/src/pages/Overview.jsx | 119 ++ frontend/src/pages/Rooms.jsx | 87 + frontend/src/pages/Search.jsx | 68 + frontend/src/pages/Shell.jsx | 66 + frontend/src/pages/widgets.jsx | 339 ++++ frontend/src/session.js | 3 + frontend/src/styles.css | 113 ++ frontend/vite.config.js | 13 + 60 files changed, 8467 insertions(+), 71 deletions(-) create mode 100644 AGENTS.md create mode 100644 backend/.dockerignore create mode 100644 backend/app/__init__.py create mode 100644 backend/app/access/__init__.py create mode 100644 backend/app/access/policy.py create mode 100644 backend/app/api/__init__.py create mode 100644 backend/app/api/deps.py create mode 100644 backend/app/api/routes.py create mode 100644 backend/app/api/schemas.py create mode 100644 backend/app/auth/__init__.py create mode 100644 backend/app/auth/accounts.py create mode 100644 backend/app/auth/security.py create mode 100644 backend/app/cli.py create mode 100644 backend/app/content/__init__.py create mode 100644 backend/app/content/documents.py create mode 100644 backend/app/core/__init__.py create mode 100644 backend/app/core/errors.py create mode 100644 backend/app/core/settings.py create mode 100644 backend/app/core/timeutil.py create mode 100644 backend/app/db/__init__.py create mode 100644 backend/app/db/migrate.py create mode 100644 backend/app/db/pool.py create mode 100644 backend/app/entrypoint.py create mode 100644 backend/app/main.py create mode 100644 backend/app/media/__init__.py create mode 100644 backend/app/media/storage.py create mode 100644 backend/app/ops.py create mode 100644 backend/app/present.py create mode 100644 backend/app/seed.py create mode 100644 backend/migrations/20261016T210000Z_foundation.sql create mode 100644 backend/requirements-dev.txt create mode 100644 docs/MVP_ANNAHMEN.md create mode 100644 frontend/.dockerignore create mode 100644 frontend/package-lock.json create mode 100644 frontend/package.json create mode 100644 frontend/src/App.jsx create mode 100644 frontend/src/api.js create mode 100644 frontend/src/main.jsx create mode 100644 frontend/src/pages/Cases.jsx create mode 100644 frontend/src/pages/Login.jsx create mode 100644 frontend/src/pages/Matters.jsx create mode 100644 frontend/src/pages/Overview.jsx create mode 100644 frontend/src/pages/Rooms.jsx create mode 100644 frontend/src/pages/Search.jsx create mode 100644 frontend/src/pages/Shell.jsx create mode 100644 frontend/src/pages/widgets.jsx create mode 100644 frontend/src/session.js create mode 100644 frontend/src/styles.css create mode 100644 frontend/vite.config.js diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5eeaf40 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,7 @@ +# Tsumugu + +Fachlich führend ist `docs/product/TSUMUGU_PRODUCT_SPEC.md`. Der technische Entwurf ist `docs/architecture/TSUMUGU_TECHNICAL_SPEC.md`. Vorläufige Rechte- und Löschregeln der ersten Lieferung stehen in `docs/MVP_ANNAHMEN.md` und sind keine endgültigen Produktentscheidungen. + +Deployment und Ports: `docs/DEPLOYMENT.md`. Gearbeitet wird auf `develop`. Ein Push dorthin startet das Development-Deploy auf dem Raspberry Pi. Production entsteht nur durch einen Merge nach `main`. + +Die Anwendung bleibt produktlokal: FastAPI, PostgreSQL, React. Keine gemeinsame Fachdatenbank mit anderen Jinkendo-Anwendungen. Finanzfunktionen, Paperless-Abgleich, KI und externer Anwaltszugang gehören nicht in diese Lieferung. diff --git a/README.md b/README.md index a2a804c..c38523e 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,9 @@ Remote: `http://192.168.2.144:3000/Lars/tsumugu.git` ## Stand -Das Repository enthält das Deploy-Gerüst. Ein Push auf `develop` baut und startet Development, ein Merge von `develop` nach `main` die Produktion. Der Gitea-Runner auf dem Raspberry Pi (`192.168.2.49`) übernimmt Build und Deploy. +Die erste benutzbare Lieferung organisiert und verfolgt: Anmeldung, Datenräume, Akten und Vorgänge, Notizen, Dateien, manuelle Paperless-Referenzen, Chronologie, Aufgaben und unabhängige Fristen. Finanzfunktionen, automatische Paperless-Synchronisation, KI und externer Anwaltszugang folgen später. + +Ein Push auf `develop` baut und startet Development, ein Merge von `develop` nach `main` die Produktion. Der Gitea-Runner auf dem Raspberry Pi (`192.168.2.49`) übernimmt Build und Deploy. Beim Start führt das Backend die Migrationen aus. In Development legt es synthetische Beispieldaten an, in Production nicht. | | Development | Production | |---|---|---| @@ -17,4 +19,11 @@ Das Repository enthält das Deploy-Gerüst. Ein Push auf `develop` baut und star Details, Ports und der Synology-Reverse-Proxy: `docs/DEPLOYMENT.md`. -Backend und Frontend sind bewusst schmal: `/api/health` prüft Postgres, das Frontend reicht `/api/` an das Backend durch. Die Anwendung selbst ist noch nicht begonnen. +Development ist nach dem Deploy unter https://dev.tsumugu.jinkendo.de oder http://192.168.2.49:3094 erreichbar. Die Beispielkonten stehen auf der Anmeldeseite: + +| | E-Mail | Passwort | +|---|---|---| +| Ada Beispiel | ada@example.test | Beispiel-Ada-2026 | +| Ben Beispiel | ben@example.test | Beispiel-Ben-2026 | + +Ada führt den Mietstreit Musterstraße. Ben darf diesen Kontext bearbeiten und sieht die private Verhandlungsstrategie nicht. Vorläufige Rechte- und Löschannahmen: `docs/MVP_ANNAHMEN.md`. `/api/health` prüft weiterhin nur, ob die Anwendung und die Datenbank antworten. diff --git a/backend/.dockerignore b/backend/.dockerignore new file mode 100644 index 0000000..853f620 --- /dev/null +++ b/backend/.dockerignore @@ -0,0 +1,5 @@ +__pycache__ +.pytest_cache +.venv +data +*.pyc diff --git a/backend/Dockerfile b/backend/Dockerfile index 18ed63f..e9339d8 100644 --- a/backend/Dockerfile +++ b/backend/Dockerfile @@ -2,11 +2,15 @@ FROM python:3.12-slim WORKDIR /app +ENV PYTHONDONTWRITEBYTECODE=1 + COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY main.py . +COPY app ./app +COPY migrations ./migrations EXPOSE 8000 -CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] +CMD ["python", "-m", "app.entrypoint"] diff --git a/backend/app/__init__.py b/backend/app/__init__.py new file mode 100644 index 0000000..d486c71 --- /dev/null +++ b/backend/app/__init__.py @@ -0,0 +1 @@ +"""Tsumugu application package.""" diff --git a/backend/app/access/__init__.py b/backend/app/access/__init__.py new file mode 100644 index 0000000..2569485 --- /dev/null +++ b/backend/app/access/__init__.py @@ -0,0 +1 @@ +"""Data rooms and the case-based access policy.""" diff --git a/backend/app/access/policy.py b/backend/app/access/policy.py new file mode 100644 index 0000000..dff0794 --- /dev/null +++ b/backend/app/access/policy.py @@ -0,0 +1,763 @@ +"""Context rights for the first delivery. + +Provisional MVP assumptions, not final product decisions, live in docs/MVP_ANNAHMEN.md. +The action context is the only rights path used here. A case link inherits that case's +rights. Cross-links do not. Exceptions apply only in the context they name. +""" + +from __future__ import annotations + +from dataclasses import dataclass +from typing import Any +from uuid import UUID + +from app.core.errors import conflict, forbidden, not_found, unprocessable + +SHARED_NOTICE = "Diese Änderung betrifft den gemeinsamen Inhalt der Notiz." + + +@dataclass(frozen=True) +class Rights: + read: bool = False + edit: bool = False + share: bool = False + delete: bool = False + + @classmethod + def full(cls) -> Rights: + return cls(True, True, True, True) + + @classmethod + def from_row(cls, row: dict | None) -> Rights: + if row is None: + return cls() + return cls(bool(row["can_read"]), bool(row["can_edit"]), bool(row["can_share"]), bool(row["can_delete"])) + + def without(self, blocked: Rights) -> Rights: + return Rights( + self.read and not blocked.read, + self.edit and not blocked.edit, + self.share and not blocked.share, + self.delete and not blocked.delete, + ) + + def allows(self, need: str) -> bool: + return bool(getattr(self, need)) + + def as_dict(self) -> dict[str, bool]: + return {"read": self.read, "edit": self.edit, "share": self.share, "delete": self.delete} + + +@dataclass(frozen=True) +class Ctx: + kind: str + id: UUID + + def as_dict(self) -> dict[str, str]: + return {"kind": self.kind, "id": str(self.id)} + + +def parse_context(payload: dict | None, *, required: bool = False) -> Ctx | None: + if not payload: + if required: + raise unprocessable("Der Handlungskontext fehlt.") + return None + kind = payload.get("kind") + raw = payload.get("id") + if kind not in ("case", "matter") or not raw: + raise unprocessable("Der Handlungskontext ist ungültig.") + try: + return Ctx(kind, UUID(str(raw))) + except ValueError as exc: + raise unprocessable("Der Handlungskontext ist ungültig.") from exc + + +def parse_query_context(kind: str | None, raw: str | None) -> Ctx | None: + if kind is None and raw is None: + return None + return parse_context({"kind": kind, "id": raw}, required=True) + + +def audit( + conn, + actor_id: UUID | None, + scope_id: UUID | None, + action: str, + resource_kind: str, + resource_id: UUID, + context: Ctx | None = None, + occurred_on=None, +) -> None: + conn.execute( + """ + INSERT INTO domain_events ( + actor_subject_id, scope_id, action, resource_kind, resource_id, + context_kind, context_id, occurred_on + ) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s) + """, + ( + actor_id, + scope_id, + action, + resource_kind, + resource_id, + context.kind if context else None, + context.id if context else None, + occurred_on, + ), + ) + + +def bump_version(conn, table: str, row_id: UUID, expected: int) -> int: + if table not in {"cases", "matters", "elements", "tasks", "deadlines"}: + raise RuntimeError("unsupported version table") + row = conn.execute( + f"UPDATE {table} SET version = version + 1, updated_at = now() " + f"WHERE id = %s AND version = %s AND deleted_at IS NULL RETURNING version", + (row_id, expected), + ).fetchone() + if row is None: + current = conn.execute( + f"SELECT version, deleted_at FROM {table} WHERE id = %s", + (row_id,), + ).fetchone() + if current is None or current["deleted_at"] is not None: + raise not_found() + raise conflict() + return int(row["version"]) + + +def _get(conn, table: str, row_id: UUID) -> dict | None: + if table not in {"cases", "matters", "elements", "tasks", "deadlines", "data_rooms"}: + raise RuntimeError("unsupported lookup") + return conn.execute(f"SELECT * FROM {table} WHERE id = %s", (row_id,)).fetchone() + + +def get_case(conn, case_id: UUID) -> dict | None: + row = _get(conn, "cases", case_id) + if row is None or row["deleted_at"] is not None: + return None + return row + + +def get_matter(conn, matter_id: UUID) -> dict | None: + row = _get(conn, "matters", matter_id) + if row is None or row["deleted_at"] is not None: + return None + return row + + +def get_element(conn, element_id: UUID) -> dict | None: + row = _get(conn, "elements", element_id) + if row is None or row["deleted_at"] is not None: + return None + return row + + +def get_task(conn, task_id: UUID) -> dict | None: + row = _get(conn, "tasks", task_id) + if row is None or row["deleted_at"] is not None: + return None + return row + + +def get_deadline(conn, deadline_id: UUID) -> dict | None: + row = _get(conn, "deadlines", deadline_id) + if row is None or row["deleted_at"] is not None: + return None + return row + + +def _direct_grant(conn, actor: UUID, kind: str, resource_id: UUID) -> Rights: + row = conn.execute( + """ + SELECT can_read, can_edit, can_share, can_delete + FROM access_grants + WHERE NOT is_exception + AND grantee_subject_id = %s + AND resource_kind = %s + AND resource_id = %s + AND context_kind IS NULL + """, + (actor, kind, resource_id), + ).fetchone() + return Rights.from_row(row) + + +def _exceptions(conn, actor: UUID, kind: str, resource_id: UUID, context: Ctx | None) -> Rights: + rows = conn.execute( + """ + SELECT can_read, can_edit, can_share, can_delete + FROM access_grants + WHERE is_exception + AND resource_kind = %s + AND resource_id = %s + AND context_kind IS NOT DISTINCT FROM %s + AND context_id IS NOT DISTINCT FROM %s + AND (grantee_subject_id IS NULL OR grantee_subject_id = %s) + """, + ( + kind, + resource_id, + context.kind if context else None, + context.id if context else None, + actor, + ), + ).fetchall() + blocked = Rights() + for row in rows: + blocked = Rights( + blocked.read or row["can_read"], + blocked.edit or row["can_edit"], + blocked.share or row["can_share"], + blocked.delete or row["can_delete"], + ) + return blocked + + +def case_rights(conn, actor: UUID, case: dict) -> Rights: + if case["parent_case_id"] is not None and case["rights_mode"] == "inherit_parent": + parent = get_case(conn, case["parent_case_id"]) + base = case_rights(conn, actor, parent) if parent else Rights() + elif case["owner_subject_id"] == actor: + base = Rights.full() + else: + base = _direct_grant(conn, actor, "case", case["id"]) + return base.without(_exceptions(conn, actor, "case", case["id"], None)) + + +def _linked(conn, matter_id: UUID, case_id: UUID) -> bool: + row = conn.execute( + "SELECT 1 FROM matter_case_links WHERE matter_id = %s AND case_id = %s", + (matter_id, case_id), + ).fetchone() + return row is not None + + +def matter_rights(conn, actor: UUID, matter: dict, context: Ctx | None) -> Rights: + if context is None: + base = Rights.full() if matter["owner_subject_id"] == actor else _direct_grant(conn, actor, "matter", matter["id"]) + return base.without(_exceptions(conn, actor, "matter", matter["id"], None)) + + if context.kind == "case": + anchor_id = matter["id"] + if not _linked(conn, matter["id"], context.id) and matter["parent_matter_id"] is not None: + if _linked(conn, matter["parent_matter_id"], context.id): + anchor_id = matter["parent_matter_id"] + else: + return Rights() + elif not _linked(conn, matter["id"], context.id): + return Rights() + case = get_case(conn, context.id) + if case is None: + return Rights() + base = case_rights(conn, actor, case) + if anchor_id != matter["id"]: + parent = get_matter(conn, anchor_id) + if parent is None: + return Rights() + base = matter_rights(conn, actor, parent, context) + return base.without(_exceptions(conn, actor, "matter", matter["id"], context)) + + if context.kind == "matter": + if matter["parent_matter_id"] != context.id: + return Rights() + parent = get_matter(conn, context.id) + if parent is None: + return Rights() + base = matter_rights(conn, actor, parent, None) + return base.without(_exceptions(conn, actor, "matter", matter["id"], context)) + return Rights() + + +def _bindings(conn, element_id: UUID) -> list[dict]: + return conn.execute( + "SELECT * FROM bindings WHERE element_id = %s ORDER BY position, created_at", + (element_id,), + ).fetchall() + + +def _blocked(conn, case_id: UUID, element_id: UUID) -> bool: + row = conn.execute( + """ + SELECT 1 + FROM case_link_blocks b + JOIN matter_case_links l ON l.id = b.link_id + WHERE l.case_id = %s AND b.element_id = %s + """, + (case_id, element_id), + ).fetchone() + return row is not None + + +def _matter_reaches_case(conn, matter_id: UUID, case_id: UUID) -> bool: + matter = get_matter(conn, matter_id) + if matter is None: + return False + if _linked(conn, matter_id, case_id): + return True + return bool(matter["parent_matter_id"] and _linked(conn, matter["parent_matter_id"], case_id)) + + +def element_rights(conn, actor: UUID, element: dict, context: Ctx | None) -> Rights: + if context is None: + base = ( + Rights.full() + if element["owner_subject_id"] == actor + else _direct_grant(conn, actor, "element", element["id"]) + ) + return base.without(_exceptions(conn, actor, "element", element["id"], None)) + + bindings = _bindings(conn, element["id"]) + if context.kind == "case": + on_case = any(item["context_kind"] == "case" and item["context_id"] == context.id for item in bindings) + via_matter = [ + item + for item in bindings + if item["context_kind"] == "matter" and _matter_reaches_case(conn, item["context_id"], context.id) + ] + if not on_case and not via_matter: + return Rights() + if not on_case and _blocked(conn, context.id, element["id"]): + return Rights() + case = get_case(conn, context.id) + if case is None: + return Rights() + base = case_rights(conn, actor, case) + return base.without(_exceptions(conn, actor, "element", element["id"], context)) + + if context.kind == "matter": + matter = get_matter(conn, context.id) + if matter is None: + return Rights() + hosted = any( + item["context_kind"] == "matter" + and (item["context_id"] == context.id or _child_of(conn, item["context_id"], context.id)) + for item in bindings + ) + if not hosted: + return Rights() + base = matter_rights(conn, actor, matter, None) + return base.without(_exceptions(conn, actor, "element", element["id"], context)) + return Rights() + + +def _child_of(conn, matter_id: UUID, parent_id: UUID) -> bool: + matter = get_matter(conn, matter_id) + return bool(matter and matter["parent_matter_id"] == parent_id) + + +def element_rights_via_case_or_direct(conn, actor: UUID, element: dict, context: Ctx | None) -> Rights: + """Rights for an element bound to a matter when the caller names a case path. + + A matter context uses direct matter rights. A case context uses that case only. + """ + if context is None: + return element_rights(conn, actor, element, None) + if context.kind == "matter": + return element_rights(conn, actor, element, context) + return element_rights(conn, actor, element, context) + + +def task_rights(conn, actor: UUID, task: dict, context: Ctx | None) -> Rights: + if task["assignee_subject_id"] == actor and context is None: + granted = _direct_grant(conn, actor, "task", task["id"]) + base = Rights(read=True, edit=granted.edit, share=False, delete=False) + if task["owner_subject_id"] == actor: + base = Rights.full() + return base.without(_exceptions(conn, actor, "task", task["id"], None)) + if context is None: + base = Rights.full() if task["owner_subject_id"] == actor else _direct_grant(conn, actor, "task", task["id"]) + return base.without(_exceptions(conn, actor, "task", task["id"], None)) + if task["matter_id"] is None: + return Rights() + matter = get_matter(conn, task["matter_id"]) + if matter is None: + return Rights() + if context.kind == "matter" and context.id == task["matter_id"]: + base = matter_rights(conn, actor, matter, None) + elif context.kind == "case": + base = matter_rights(conn, actor, matter, context) + elif context.kind == "matter" and matter["parent_matter_id"] == context.id: + base = matter_rights(conn, actor, matter, context) + else: + return Rights() + return base.without(_exceptions(conn, actor, "task", task["id"], context)) + + +def deadline_rights(conn, actor: UUID, deadline: dict, context: Ctx | None) -> Rights: + if deadline["assignee_subject_id"] == actor and context is None: + base = Rights(read=True, edit=False, share=False, delete=False) + if deadline["owner_subject_id"] == actor: + base = Rights.full() + return base.without(_exceptions(conn, actor, "deadline", deadline["id"], None)) + if context is None: + base = ( + Rights.full() + if deadline["owner_subject_id"] == actor + else _direct_grant(conn, actor, "deadline", deadline["id"]) + ) + return base.without(_exceptions(conn, actor, "deadline", deadline["id"], None)) + if deadline["matter_id"] is None: + return Rights() + matter = get_matter(conn, deadline["matter_id"]) + if matter is None: + return Rights() + if context.kind == "matter" and context.id == deadline["matter_id"]: + base = matter_rights(conn, actor, matter, None) + elif context.kind == "case": + base = matter_rights(conn, actor, matter, context) + else: + return Rights() + return base.without(_exceptions(conn, actor, "deadline", deadline["id"], context)) + + +def require_case(conn, actor: UUID, case_id: UUID, need: str) -> tuple[dict, Rights]: + case = get_case(conn, case_id) + if case is None: + raise not_found() + rights = case_rights(conn, actor, case) + _require(rights, need) + return case, rights + + +def require_matter(conn, actor: UUID, matter_id: UUID, context: Ctx | None, need: str) -> tuple[dict, Rights]: + matter = get_matter(conn, matter_id) + if matter is None: + raise not_found() + rights = matter_rights(conn, actor, matter, context) + _require(rights, need) + return matter, rights + + +def require_element(conn, actor: UUID, element_id: UUID, context: Ctx | None, need: str) -> tuple[dict, Rights]: + element = get_element(conn, element_id) + if element is None: + raise not_found() + rights = element_rights(conn, actor, element, context) + _require(rights, need) + return element, rights + + +def _require(rights: Rights, need: str) -> None: + if not rights.read: + raise not_found() + if need != "read" and not rights.allows(need): + raise forbidden() + + +def can_change_status(actor: UUID, row: dict, rights: Rights, assignee_key: str = "assignee_subject_id") -> bool: + if rights.edit or row["owner_subject_id"] == actor: + return True + return row[assignee_key] == actor and rights.read + + +def readable_matter_contexts(conn, actor: UUID, matter: dict) -> list[dict]: + found: list[dict] = [] + direct = matter_rights(conn, actor, matter, None) + if direct.read: + found.append({"kind": "matter", "id": str(matter["id"]), "title": matter["title"], "rights": direct.as_dict()}) + links = conn.execute( + """ + SELECT l.case_id, c.title + FROM matter_case_links l + JOIN cases c ON c.id = l.case_id + WHERE l.matter_id = %s AND c.deleted_at IS NULL + """, + (matter["id"],), + ).fetchall() + if matter["parent_matter_id"] is not None: + links = list(links) + list( + conn.execute( + """ + SELECT l.case_id, c.title + FROM matter_case_links l + JOIN cases c ON c.id = l.case_id + WHERE l.matter_id = %s AND c.deleted_at IS NULL + """, + (matter["parent_matter_id"],), + ).fetchall() + ) + seen: set[UUID] = set() + for link in links: + if link["case_id"] in seen: + continue + seen.add(link["case_id"]) + rights = matter_rights(conn, actor, matter, Ctx("case", link["case_id"])) + if rights.read: + found.append( + { + "kind": "case", + "id": str(link["case_id"]), + "title": link["title"], + "rights": rights.as_dict(), + } + ) + return found + + +def list_cases(conn, actor: UUID) -> list[dict]: + rows = conn.execute( + """ + SELECT c.* + FROM cases c + WHERE c.deleted_at IS NULL + AND ( + c.owner_subject_id = %(actor)s + OR EXISTS ( + SELECT 1 FROM access_grants g + WHERE g.resource_kind = 'case' AND g.resource_id = c.id + AND g.grantee_subject_id = %(actor)s AND NOT g.is_exception AND g.can_read + AND g.context_id IS NULL + ) + OR ( + c.rights_mode = 'inherit_parent' AND c.parent_case_id IS NOT NULL AND EXISTS ( + SELECT 1 FROM cases p + WHERE p.id = c.parent_case_id AND p.deleted_at IS NULL + AND ( + p.owner_subject_id = %(actor)s + OR EXISTS ( + SELECT 1 FROM access_grants g + WHERE g.resource_kind = 'case' AND g.resource_id = p.id + AND g.grantee_subject_id = %(actor)s AND NOT g.is_exception + AND g.can_read AND g.context_id IS NULL + ) + ) + ) + ) + ) + ORDER BY c.updated_at DESC, c.id DESC + """, + {"actor": actor}, + ).fetchall() + visible = [] + for row in rows: + rights = case_rights(conn, actor, row) + if rights.read: + visible.append((row, rights)) + return visible + + +def list_matters(conn, actor: UUID) -> list[tuple[dict, list[dict]]]: + rows = conn.execute( + """ + SELECT m.* + FROM matters m + WHERE m.deleted_at IS NULL + AND ( + m.owner_subject_id = %(actor)s + OR EXISTS ( + SELECT 1 FROM access_grants g + WHERE g.resource_kind = 'matter' AND g.resource_id = m.id + AND g.grantee_subject_id = %(actor)s AND NOT g.is_exception AND g.can_read + AND g.context_id IS NULL + ) + OR EXISTS ( + SELECT 1 FROM matter_case_links l + JOIN cases c ON c.id = l.case_id AND c.deleted_at IS NULL + WHERE l.matter_id = m.id + AND ( + c.owner_subject_id = %(actor)s + OR EXISTS ( + SELECT 1 FROM access_grants g + WHERE g.resource_kind = 'case' AND g.resource_id = c.id + AND g.grantee_subject_id = %(actor)s AND NOT g.is_exception + AND g.can_read AND g.context_id IS NULL + ) + ) + ) + ) + ORDER BY m.updated_at DESC, m.id DESC + """, + {"actor": actor}, + ).fetchall() + visible = [] + for row in rows: + contexts = readable_matter_contexts(conn, actor, row) + if contexts: + visible.append((row, contexts)) + return visible + + +def assert_scope_can_host(conn, scope_id: UUID) -> dict: + room = _get(conn, "data_rooms", scope_id) + if room is None or room["status"] != "active": + raise forbidden("Der gewählte Datenraum ist nicht verfügbar.") + return room + + +def same_home(row: dict, scope_id: UUID) -> None: + if row["home_scope_id"] != scope_id: + raise unprocessable( + "Unterakten, Teilvorgänge und Kapitel bleiben im Datenraum ihres Behälters. " + "Wähle diesen Datenraum, wenn du dort Mitglied bist, oder lege einen Querverweis an." + ) + + +def account_by_email(conn, email: str) -> dict | None: + return conn.execute( + "SELECT id, email, display_name, status FROM auth_accounts WHERE email = %s", + (email.strip().lower(),), + ).fetchone() + + +def display_name(conn, account_id: UUID | None) -> str | None: + if account_id is None: + return None + row = conn.execute("SELECT display_name FROM auth_accounts WHERE id = %s", (account_id,)).fetchone() + return row["display_name"] if row else None + + +def room_name(conn, room_id: UUID) -> str | None: + row = conn.execute("SELECT name FROM data_rooms WHERE id = %s", (room_id,)).fetchone() + return row["name"] if row else None + + +def visible_bindings_for_element(conn, actor: UUID, element: dict) -> list[dict]: + """Names and counts only bindings the actor can actually read.""" + result = [] + for binding in _bindings(conn, element["id"]): + if binding["context_kind"] == "case": + context = Ctx("case", binding["context_id"]) + rights = element_rights(conn, actor, element, context) + if not rights.read: + continue + case = get_case(conn, binding["context_id"]) + if case is None: + continue + title = case["title"] + else: + matter = get_matter(conn, binding["context_id"]) + if matter is None: + continue + contexts = readable_matter_contexts(conn, actor, matter) + if not contexts: + continue + direct = element_rights(conn, actor, element, Ctx("matter", matter["id"])) + via_cases = [] + for item in contexts: + if item["kind"] != "case": + continue + case_rights_now = element_rights(conn, actor, element, Ctx("case", UUID(item["id"]))) + if case_rights_now.read: + via_cases.append(item) + if not direct.read and not via_cases: + continue + title = matter["title"] + context = Ctx("matter", matter["id"]) + result.append( + { + "id": str(binding["id"]), + "context_kind": binding["context_kind"], + "context_id": str(binding["context_id"]), + "context_title": title, + } + ) + return result + + +def chapter_for(conn, chapter_id: UUID | None, kind: str, container_id: UUID) -> None: + if chapter_id is None: + return + column = "case_id" if kind == "case" else "matter_id" + row = conn.execute( + f"SELECT id FROM chapters WHERE id = %s AND {column} = %s", + (chapter_id, container_id), + ).fetchone() + if row is None: + raise unprocessable("Das Kapitel gehört nicht zu diesem Kontext.") + + +def next_position(conn, kind: str, container_id: UUID) -> int: + row = conn.execute( + "SELECT COALESCE(MAX(position), 0) + 1 AS pos FROM bindings WHERE context_kind = %s AND context_id = %s", + (kind, container_id), + ).fetchone() + return int(row["pos"]) + + +def insert_binding(conn, element_id: UUID, kind: str, container_id: UUID, chapter_id: UUID | None, actor: UUID) -> dict: + existing = conn.execute( + """ + SELECT id FROM bindings + WHERE element_id = %s AND context_kind = %s AND context_id = %s + """, + (element_id, kind, container_id), + ).fetchone() + if existing is not None: + raise unprocessable("Die Notiz ist in diesem Kontext bereits eingebunden.") + chapter_for(conn, chapter_id, kind, container_id) + row = conn.execute( + """ + INSERT INTO bindings (element_id, context_kind, context_id, chapter_id, position, created_by) + VALUES (%s, %s, %s, %s, %s, %s) + RETURNING * + """, + (element_id, kind, container_id, chapter_id, next_position(conn, kind, container_id), actor), + ).fetchone() + return row + + +def block_unsharable_matter_elements(conn, actor: UUID, link_id: UUID, matter: dict) -> None: + """Contents the linking actor cannot share stay invisible in that case. No titles are stored.""" + matter_ids = [matter["id"]] + children = conn.execute( + "SELECT id FROM matters WHERE parent_matter_id = %s AND deleted_at IS NULL", + (matter["id"],), + ).fetchall() + matter_ids.extend(item["id"] for item in children) + for matter_id in matter_ids: + bindings = conn.execute( + "SELECT element_id FROM bindings WHERE context_kind = 'matter' AND context_id = %s", + (matter_id,), + ).fetchall() + container = get_matter(conn, matter_id) + if container is None: + continue + for binding in bindings: + element = get_element(conn, binding["element_id"]) + if element is None: + continue + rights = element_rights(conn, actor, element, Ctx("matter", matter_id)) + if matter_id != matter["id"]: + parent_rights = element_rights(conn, actor, element, Ctx("matter", matter["id"])) + if parent_rights.share: + rights = parent_rights + if rights.share: + continue + conn.execute( + "INSERT INTO case_link_blocks (link_id, element_id) VALUES (%s, %s) ON CONFLICT DO NOTHING", + (link_id, element["id"]), + ) + + +def matter_title_if_readable(conn, actor: UUID, matter_id: UUID | None) -> str | None: + if matter_id is None: + return None + matter = get_matter(conn, matter_id) + if matter is None: + return None + if readable_matter_contexts(conn, actor, matter): + return matter["title"] + return None + + +def ensure_member_or_personal(conn, account_id: UUID, kind: str, scope_id: UUID) -> dict: + room = assert_scope_can_host(conn, scope_id) + if kind == "personal": + if room["kind"] != "personal" or room["id"] != account_id: + raise forbidden("Der persönliche Datenraum gehört zu einem anderen Konto.") + return room + if kind != "organization" or room["kind"] != "organization": + raise forbidden("Dieser Datenraum kann nicht gewählt werden.") + membership = conn.execute( + """ + SELECT role FROM room_memberships + WHERE room_id = %s AND subject_id = %s AND status = 'active' + """, + (scope_id, account_id), + ).fetchone() + if membership is None: + raise forbidden("Du bist in diesem Datenraum nicht Mitglied.") + return room diff --git a/backend/app/api/__init__.py b/backend/app/api/__init__.py new file mode 100644 index 0000000..36ad2dc --- /dev/null +++ b/backend/app/api/__init__.py @@ -0,0 +1 @@ +"""HTTP adapters. Authorization stays in the domain services.""" diff --git a/backend/app/api/deps.py b/backend/app/api/deps.py new file mode 100644 index 0000000..dbf6482 --- /dev/null +++ b/backend/app/api/deps.py @@ -0,0 +1,97 @@ +"""Request scope: one transaction, a session principal, and no client-supplied identity.""" + +from __future__ import annotations + +from dataclasses import dataclass +from pathlib import Path +from uuid import UUID + +from fastapi import Depends, Request +from psycopg import Connection + +from app.access.policy import ensure_member_or_personal +from app.auth.security import hash_secret, read_session_token +from app.core.errors import forbidden, unauthorized +from app.core.timeutil import utcnow + + +@dataclass(frozen=True) +class Principal: + account_id: UUID + email: str + display_name: str + session_id: UUID + scope_kind: str + scope_id: UUID + scope_name: str + epoch: int + + +def get_conn(request: Request): + pool = request.app.state.pool + with pool.connection() as conn: + try: + conn.execute("SET TIME ZONE 'UTC'") + yield conn + conn.commit() + for path in getattr(request.state, "delete_after_commit", []): + Path(path).unlink(missing_ok=True) + except Exception: + conn.rollback() + for path in getattr(request.state, "cleanup_files", []): + Path(path).unlink(missing_ok=True) + raise + + +def _session_row(conn: Connection, request: Request) -> dict: + token = read_session_token(request) + if not token: + raise unauthorized() + row = conn.execute( + """ + SELECT s.id, s.account_id, s.csrf_token, s.scope_kind, s.scope_id, s.epoch, + s.expires_at, s.revoked_at, a.email, a.display_name, a.status AS account_status + FROM auth_sessions s + JOIN auth_accounts a ON a.id = s.account_id + WHERE s.secret_hash = %s + """, + (hash_secret(token),), + ).fetchone() + if row is None or row["revoked_at"] is not None or row["expires_at"] <= utcnow(): + raise unauthorized() + if row["account_status"] != "active": + raise unauthorized() + if request.method not in {"GET", "HEAD", "OPTIONS"}: + sent = request.headers.get("x-csrf-token") or "" + if not sent or sent != row["csrf_token"]: + raise forbidden("Die Anfrage konnte der Sitzung nicht zugeordnet werden.") + return row + + +def get_session(request: Request, conn: Connection = Depends(get_conn)) -> dict: + return _session_row(conn, request) + + +def get_principal(request: Request, conn: Connection = Depends(get_conn)) -> Principal: + row = _session_row(conn, request) + kind = request.headers.get("x-scope-kind") + raw_scope = request.headers.get("x-scope-id") + if not kind or not raw_scope: + raise forbidden("Der Datenraum ist nicht gewählt.") + try: + scope_id = UUID(raw_scope) + except ValueError as exc: + raise forbidden("Der Datenraum ist nicht gewählt.") from exc + if kind != row["scope_kind"] or scope_id != row["scope_id"]: + raise forbidden("Der gewählte Datenraum entspricht nicht mehr der Sitzung.") + room = ensure_member_or_personal(conn, row["account_id"], kind, scope_id) + return Principal( + account_id=row["account_id"], + email=row["email"], + display_name=row["display_name"], + session_id=row["id"], + scope_kind=kind, + scope_id=scope_id, + scope_name=room["name"], + epoch=row["epoch"], + ) diff --git a/backend/app/api/routes.py b/backend/app/api/routes.py new file mode 100644 index 0000000..01c9131 --- /dev/null +++ b/backend/app/api/routes.py @@ -0,0 +1,1193 @@ +"""HTTP routes for the first usable delivery.""" + +from __future__ import annotations + +from datetime import date, datetime, timedelta, timezone +from uuid import UUID + +from fastapi import APIRouter, Depends, File, Form, Request, Response, UploadFile +from fastapi.responses import JSONResponse +from psycopg import Connection + +from app.access.policy import ( + Ctx, + account_by_email, + case_rights, + deadline_rights, + element_rights, + get_case, + get_deadline, + get_element, + get_matter, + get_task, + list_cases, + list_matters, + matter_rights, + parse_context, + parse_query_context, + require_case, + require_matter, + task_rights, +) +from app.api.deps import Principal, get_conn, get_principal, get_session +from app.api.schemas import ( + AcceptInviteIn, + AnnotationIn, + AssigneeIn, + BindingIn, + CaseIn, + CaseLinkIn, + CasePatch, + ChapterIn, + CrossLinkIn, + DeadlineIn, + DeadlinePatch, + DeleteElementIn, + ExceptionIn, + ExternalIn, + FulfillIn, + GrantIn, + InvitationIn, + LoginIn, + MatterIn, + MatterPatch, + MemberIn, + NoteIn, + NotePatch, + RoomIn, + ScopeIn, + TaskDeadlineIn, + TaskIn, + TaskPatch, +) +from app.auth.accounts import create_account, list_rooms, normalize_email, start_session +from app.auth.security import ( + clear_session_cookie, + hash_secret, + new_secret, + session_expiry, + set_session_cookie, + verify_password, +) +from app.core.errors import Problem, forbidden, not_found, too_many, unprocessable +from app.core.timeutil import utcnow +from app.media.storage import content_disposition, read_bytes +from app.media.storage import asset_path +from app.ops import ( + add_annotation, + assign_task, + bind_element, + create_case, + create_chapter, + create_cross_link, + create_deadline, + create_external, + create_file, + create_matter, + create_note, + create_task, + delete_cross_link, + delete_element, + detach_binding, + fulfill_deadline, + grant_access, + link_matter_to_case, + link_task_deadline, + patch_case, + patch_deadline, + patch_matter, + patch_task, + revoke_grant, + set_exception, + unlink_matter_case, + update_note, +) +from app.present import ( + LABELS, + binding_payload, + case_detail, + case_summary, + deadline_payload, + matter_detail, + matter_summary, + note_update_payload, + task_payload, +) +from app.seed import demo_public + +router = APIRouter() +_login_attempts: dict[str, list[datetime]] = {} + + +def _created(path: str, payload: dict) -> JSONResponse: + return JSONResponse(status_code=201, content=payload, headers={"Location": path}) + + +def _ctx_model(value) -> Ctx | None: + return None if value is None else Ctx(value.kind, value.id) + + +def _session_body(conn, account_id: UUID, scope_kind: str, scope_id: UUID, csrf: str, epoch: int) -> dict: + account = conn.execute( + "SELECT id, email, display_name FROM auth_accounts WHERE id = %s", + (account_id,), + ).fetchone() + room = conn.execute("SELECT id, kind, name FROM data_rooms WHERE id = %s", (scope_id,)).fetchone() + return { + "account": { + "id": str(account["id"]), + "email": account["email"], + "display_name": account["display_name"], + }, + "scope": {"kind": scope_kind, "id": str(room["id"]), "name": room["name"]}, + "rooms": list_rooms(conn, account_id), + "csrf_token": csrf, + "epoch": epoch, + } + + +def _limit_login(key: str) -> None: + now = utcnow() + window = [item for item in _login_attempts.get(key, []) if now - item < timedelta(minutes=10)] + if len(window) >= 8: + _login_attempts[key] = window + raise too_many() + window.append(now) + _login_attempts[key] = window + + +@router.post("/api/v1/auth/login") +def login(body: LoginIn, request: Request, conn: Connection = Depends(get_conn)): + email = normalize_email(body.email) + _limit_login(f"{request.client.host if request.client else 'local'}:{email}") + account = conn.execute( + "SELECT * FROM auth_accounts WHERE email = %s", + (email,), + ).fetchone() + if account is None or account["status"] != "active" or not verify_password(body.password, account["password_hash"]): + raise Problem(401, "Anmeldung fehlgeschlagen", "E-Mail oder Passwort ist nicht richtig.", "unauthorized") + settings = request.app.state.settings + token, csrf = start_session(conn, settings, account["id"]) + payload = _session_body(conn, account["id"], "personal", account["id"], csrf, 1) + response = JSONResponse(payload) + set_session_cookie(response, request, settings, token) + return response + + +@router.post("/api/v1/auth/logout", status_code=204) +def logout(request: Request, session: dict = Depends(get_session), conn: Connection = Depends(get_conn)): + conn.execute("UPDATE auth_sessions SET revoked_at = now() WHERE id = %s", (session["id"],)) + response = Response(status_code=204) + clear_session_cookie(response, request, request.app.state.settings) + return response + + +@router.get("/api/v1/auth/session") +def session_view(session: dict = Depends(get_session), conn: Connection = Depends(get_conn)): + return _session_body( + conn, + session["account_id"], + session["scope_kind"], + session["scope_id"], + session["csrf_token"], + session["epoch"], + ) + + +@router.post("/api/v1/auth/session/scope") +def choose_scope( + body: ScopeIn, + request: Request, + session: dict = Depends(get_session), + conn: Connection = Depends(get_conn), +): + from app.access.policy import ensure_member_or_personal + + room = ensure_member_or_personal(conn, session["account_id"], body.kind, body.id) + row = conn.execute( + """ + UPDATE auth_sessions + SET scope_kind = %s, scope_id = %s, epoch = epoch + 1 + WHERE id = %s + RETURNING epoch, csrf_token + """, + (body.kind, room["id"], session["id"]), + ).fetchone() + return _session_body(conn, session["account_id"], body.kind, room["id"], row["csrf_token"], row["epoch"]) + + +@router.get("/api/v1/auth/demo") +def demo(request: Request): + return demo_public(request.app.state.settings) + + +@router.post("/api/v1/invitations") +def invite( + body: InvitationIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + room = conn.execute("SELECT * FROM data_rooms WHERE id = %s", (body.room_id,)).fetchone() + if room is None or room["kind"] != "organization": + raise not_found() + membership = conn.execute( + """ + SELECT role FROM room_memberships + WHERE room_id = %s AND subject_id = %s AND status = 'active' + """, + (room["id"], principal.account_id), + ).fetchone() + if membership is None or membership["role"] != "manager": + raise forbidden() + email = normalize_email(body.email) + if account_by_email(conn, email): + raise unprocessable("Es gibt bereits ein Konto. Füge die Person als Mitglied hinzu.") + token = new_secret() + row = conn.execute( + """ + INSERT INTO auth_invitations (email, room_id, token_hash, invited_by, expires_at) + VALUES (%s, %s, %s, %s, %s) + RETURNING id, expires_at + """, + (email, room["id"], hash_secret(token), principal.account_id, utcnow() + timedelta(days=7)), + ).fetchone() + return _created( + f"/api/v1/invitations/{row['id']}", + {"id": str(row["id"]), "email": email, "expires_at": row["expires_at"].isoformat(), "token": token}, + ) + + +@router.post("/api/v1/invitations/{invitation_id}/accept") +def accept_invite( + invitation_id: UUID, + body: AcceptInviteIn, + request: Request, + conn: Connection = Depends(get_conn), +): + row = conn.execute("SELECT * FROM auth_invitations WHERE id = %s", (invitation_id,)).fetchone() + if row is None or row["accepted_at"] is not None or row["expires_at"] <= utcnow(): + raise not_found() + if row["token_hash"] != hash_secret(body.token): + raise not_found() + account = create_account(conn, row["email"], body.display_name, body.password) + conn.execute( + """ + INSERT INTO room_memberships (room_id, subject_id, role) + VALUES (%s, %s, 'member') + """, + (row["room_id"], account["id"]), + ) + conn.execute("UPDATE auth_invitations SET accepted_at = now() WHERE id = %s", (invitation_id,)) + settings = request.app.state.settings + token, csrf = start_session(conn, settings, account["id"]) + payload = _session_body(conn, account["id"], "personal", account["id"], csrf, 1) + response = JSONResponse(status_code=201, content=payload) + set_session_cookie(response, request, settings, token) + return response + + +@router.get("/api/v1/rooms") +def rooms(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + return {"items": list_rooms(conn, principal.account_id), "next_cursor": None} + + +@router.post("/api/v1/rooms") +def create_room(body: RoomIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + from uuid import uuid4 + + room_id = uuid4() + conn.execute( + """ + INSERT INTO data_rooms (id, kind, name, created_by) + VALUES (%s, 'organization', %s, %s) + """, + (room_id, body.name.strip(), principal.account_id), + ) + conn.execute( + """ + INSERT INTO room_memberships (room_id, subject_id, role) + VALUES (%s, %s, 'manager') + """, + (room_id, principal.account_id), + ) + return _created(f"/api/v1/rooms/{room_id}", {"id": str(room_id), "kind": "organization", "name": body.name.strip()}) + + +@router.get("/api/v1/rooms/{room_id}/members") +def members(room_id: UUID, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + _require_manager(conn, principal, room_id) + rows = conn.execute( + """ + SELECT m.subject_id, m.role, a.email, a.display_name + FROM room_memberships m + JOIN auth_accounts a ON a.id = m.subject_id + WHERE m.room_id = %s AND m.status = 'active' + ORDER BY a.display_name, a.id + """, + (room_id,), + ).fetchall() + return { + "items": [ + { + "subject_id": str(row["subject_id"]), + "email": row["email"], + "display_name": row["display_name"], + "role": row["role"], + } + for row in rows + ] + } + + +@router.post("/api/v1/rooms/{room_id}/members") +def add_member( + room_id: UUID, + body: MemberIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + _require_manager(conn, principal, room_id) + account = account_by_email(conn, body.email) + if account is None or account["status"] != "active": + raise not_found() + conn.execute( + """ + INSERT INTO room_memberships (room_id, subject_id, role, status) + VALUES (%s, %s, %s, 'active') + ON CONFLICT (room_id, subject_id) DO UPDATE SET role = EXCLUDED.role, status = 'active' + """, + (room_id, account["id"], body.role), + ) + return {"subject_id": str(account["id"]), "role": body.role} + + +@router.delete("/api/v1/rooms/{room_id}/members/{subject_id}", status_code=204) +def remove_member( + room_id: UUID, + subject_id: UUID, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + _require_manager(conn, principal, room_id) + if subject_id == principal.account_id: + managers = conn.execute( + """ + SELECT count(*) AS n FROM room_memberships + WHERE room_id = %s AND role = 'manager' AND status = 'active' + """, + (room_id,), + ).fetchone() + if managers["n"] <= 1: + raise unprocessable("Der letzte Verwalter kann den Datenraum nicht verlassen.") + conn.execute( + """ + UPDATE room_memberships SET status = 'removed' + WHERE room_id = %s AND subject_id = %s + """, + (room_id, subject_id), + ) + return Response(status_code=204) + + +def _require_manager(conn, principal: Principal, room_id: UUID) -> None: + membership = conn.execute( + """ + SELECT role FROM room_memberships + WHERE room_id = %s AND subject_id = %s AND status = 'active' + """, + (room_id, principal.account_id), + ).fetchone() + room = conn.execute("SELECT kind FROM data_rooms WHERE id = %s", (room_id,)).fetchone() + if room is None or room["kind"] != "organization" or membership is None or membership["role"] != "manager": + raise forbidden() + + +@router.get("/api/v1/principals") +def find_principal(email: str, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + account = account_by_email(conn, email) + if account is None or account["status"] != "active": + raise not_found() + return {"id": str(account["id"]), "email": account["email"], "display_name": account["display_name"]} + + +@router.get("/api/v1/cases") +def cases(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + items = [case_summary(case, rights) for case, rights in list_cases(conn, principal.account_id)] + return {"items": items, "next_cursor": None} + + +@router.post("/api/v1/cases") +def post_case(body: CaseIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + case = create_case(conn, principal.account_id, principal.scope_id, body.title, body.parent_case_id, body.rights_mode) + rights = case_rights(conn, principal.account_id, case) + return _created(f"/api/v1/cases/{case['id']}", case_summary(case, rights)) + + +@router.get("/api/v1/cases/{case_id}") +def get_one_case(case_id: UUID, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + case, rights = require_case(conn, principal.account_id, case_id, "read") + return case_detail(conn, principal.account_id, case, rights) + + +@router.patch("/api/v1/cases/{case_id}") +def patch_one_case( + case_id: UUID, + body: CasePatch, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + case = patch_case(conn, principal.account_id, case_id, body.expected_version, body.title, body.status) + rights = case_rights(conn, principal.account_id, case) + return case_summary(case, rights) + + +@router.post("/api/v1/cases/{case_id}/chapters") +def post_case_chapter( + case_id: UUID, + body: ChapterIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + row = create_chapter(conn, principal.account_id, "case", case_id, body.title, body.position, None) + return _created(f"/api/v1/cases/{case_id}/chapters/{row['id']}", {"id": str(row["id"]), "title": row["title"], "position": row["position"]}) + + +@router.post("/api/v1/cases/{case_id}/grants") +def post_case_grant( + case_id: UUID, + body: GrantIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + account = account_by_email(conn, body.email) + if account is None: + raise not_found() + grant = grant_access( + conn, principal.account_id, "case", case_id, account["id"], body.can_read, body.can_edit, body.can_share, None + ) + return _created(f"/api/v1/grants/{grant['id']}", {"id": str(grant["id"])}) + + +@router.get("/api/v1/matters") +def matters(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + items = [matter_summary(conn, principal.account_id, matter) for matter, _contexts in list_matters(conn, principal.account_id)] + return {"items": items, "next_cursor": None} + + +@router.post("/api/v1/matters") +def post_matter(body: MatterIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + matter = create_matter( + conn, principal.account_id, principal.scope_id, body.title, body.parent_matter_id, _ctx_model(body.context) + ) + return _created(f"/api/v1/matters/{matter['id']}", matter_summary(conn, principal.account_id, matter)) + + +@router.get("/api/v1/matters/{matter_id}") +def get_one_matter( + matter_id: UUID, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + context = parse_query_context(context_kind, context_id) + matter, rights = require_matter(conn, principal.account_id, matter_id, context, "read") + return matter_detail(conn, principal.account_id, matter, rights, context) + + +@router.patch("/api/v1/matters/{matter_id}") +def patch_one_matter( + matter_id: UUID, + body: MatterPatch, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + matter = patch_matter( + conn, principal.account_id, matter_id, body.expected_version, body.title, body.status, _ctx_model(body.context) + ) + return matter_summary(conn, principal.account_id, matter) + + +@router.post("/api/v1/matters/{matter_id}/chapters") +def post_matter_chapter( + matter_id: UUID, + body: ChapterIn, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + context = parse_query_context(context_kind, context_id) + row = create_chapter(conn, principal.account_id, "matter", matter_id, body.title, body.position, context) + return _created( + f"/api/v1/matters/{matter_id}/chapters/{row['id']}", + {"id": str(row["id"]), "title": row["title"], "position": row["position"]}, + ) + + +@router.post("/api/v1/matters/{matter_id}/case-links") +def post_case_link( + matter_id: UUID, + body: CaseLinkIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + link = link_matter_to_case(conn, principal.account_id, matter_id, body.case_id, _ctx_model(body.context)) + return _created(f"/api/v1/matter-case-links/{link['id']}", {"id": str(link["id"]), "case_id": str(body.case_id)}) + + +@router.delete("/api/v1/matter-case-links/{link_id}", status_code=204) +def delete_case_link(link_id: UUID, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + unlink_matter_case(conn, principal.account_id, link_id) + return Response(status_code=204) + + +@router.post("/api/v1/matters/{matter_id}/cross-links") +def post_cross_link( + matter_id: UUID, + body: CrossLinkIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + row = create_cross_link( + conn, + principal.account_id, + matter_id, + body.target_matter_id, + _ctx_model(body.source_context), + Ctx(body.target_context.kind, body.target_context.id), + ) + return _created(f"/api/v1/matter-cross-links/{row['id']}", {"id": str(row["id"])}) + + +@router.delete("/api/v1/matter-cross-links/{link_id}", status_code=204) +def remove_cross_link( + link_id: UUID, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + delete_cross_link(conn, principal.account_id, link_id, parse_query_context(context_kind, context_id)) + return Response(status_code=204) + + +@router.post("/api/v1/matters/{matter_id}/grants") +def post_matter_grant( + matter_id: UUID, + body: GrantIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + account = account_by_email(conn, body.email) + if account is None: + raise not_found() + grant = grant_access( + conn, principal.account_id, "matter", matter_id, account["id"], body.can_read, body.can_edit, body.can_share, None + ) + return _created(f"/api/v1/grants/{grant['id']}", {"id": str(grant["id"])}) + + +@router.delete("/api/v1/grants/{grant_id}", status_code=204) +def delete_grant(grant_id: UUID, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + revoke_grant(conn, principal.account_id, grant_id) + return Response(status_code=204) + + +@router.put("/api/v1/exceptions") +def put_exception(body: ExceptionIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + set_exception( + conn, + principal.account_id, + body.resource_kind, + body.resource_id, + Ctx(body.context.kind, body.context.id), + body.remove_read, + body.remove_edit, + body.remove_share, + ) + return {"ok": True} + + +@router.post("/api/v1/notes") +def post_note(body: NoteIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + created = create_note( + conn, + principal.account_id, + principal.scope_id, + body.title, + body.document.model_dump(), + Ctx(body.context.kind, body.context.id), + _ctx_model(body.placement), + body.chapter_id, + ) + element = created["element"] + return _created( + f"/api/v1/notes/{element['id']}", + note_update_payload(conn, principal.account_id, element, created["document"]), + ) + + +@router.patch("/api/v1/notes/{element_id}") +def patch_note( + element_id: UUID, + body: NotePatch, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + updated = update_note( + conn, + principal.account_id, + element_id, + body.expected_version, + body.document.model_dump(), + _ctx_model(body.context), + ) + return note_update_payload(conn, principal.account_id, updated["element"], updated["document"]) + + +@router.post("/api/v1/bindings") +def post_binding(body: BindingIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + binding = bind_element( + conn, + principal.account_id, + body.element_id, + Ctx(body.source_context.kind, body.source_context.id), + Ctx(body.target.kind, body.target.id), + _ctx_model(body.target_context), + body.chapter_id, + ) + return _created(f"/api/v1/bindings/{binding['id']}", {"id": str(binding["id"])}) + + +@router.delete("/api/v1/bindings/{binding_id}", status_code=204) +def delete_binding( + binding_id: UUID, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + detach_binding(conn, principal.account_id, binding_id, parse_query_context(context_kind, context_id)) + return Response(status_code=204) + + +@router.post("/api/v1/bindings/{binding_id}/annotations") +def post_annotation( + binding_id: UUID, + body: AnnotationIn, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + row = add_annotation( + conn, principal.account_id, binding_id, body.body, parse_query_context(context_kind, context_id) + ) + return _created(f"/api/v1/bindings/{binding_id}/annotations/{row['id']}", {"id": str(row["id"]), "body": row["body"]}) + + +@router.post("/api/v1/external-refs") +def post_external(body: ExternalIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + element = create_external( + conn, + principal.account_id, + principal.scope_id, + body.title, + body.source, + body.external_id, + Ctx(body.context.kind, body.context.id), + _ctx_model(body.placement), + body.chapter_id, + body.dates.document_on, + body.dates.sent_on, + body.dates.received_on, + ) + return _created(f"/api/v1/elements/{element['id']}", {"id": str(element["id"]), "title": element["title"]}) + + +@router.post("/api/v1/files") +def post_file( + request: Request, + title: str = Form(), + context_kind: str = Form(), + context_id: UUID = Form(), + upload: UploadFile = File(), + placement_kind: str | None = Form(default=None), + placement_id: UUID | None = Form(default=None), + chapter_id: UUID | None = Form(default=None), + document_on: str | None = Form(default=None), + sent_on: str | None = Form(default=None), + received_on: str | None = Form(default=None), + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + settings = request.app.state.settings + cleaned_title = title.strip() + if not cleaned_title or len(cleaned_title) > 200: + raise unprocessable("Der Titel fehlt oder ist zu lang.") + data = upload.file.read(settings.upload_max_bytes + 1) + context = parse_context({"kind": context_kind, "id": str(context_id)}, required=True) + placement = None + if placement_kind or placement_id: + placement = parse_context({"kind": placement_kind, "id": str(placement_id)}, required=True) + request.state.cleanup_files = [] + element = create_file( + conn, + principal.account_id, + principal.scope_id, + cleaned_title, + upload.filename or "datei", + data, + context, + placement, + chapter_id, + _parse_date(document_on), + _parse_date(sent_on), + _parse_date(received_on), + settings.media_root, + settings.upload_max_bytes, + request.state.cleanup_files, + ) + return _created(f"/api/v1/elements/{element['id']}", {"id": str(element["id"]), "title": element["title"]}) + + +@router.get("/api/v1/files/{element_id}/content") +def download_file( + element_id: UUID, + request: Request, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + context = parse_query_context(context_kind, context_id) + element = get_element(conn, element_id) + if element is None or element["kind"] != "file": + raise not_found() + rights = element_rights(conn, principal.account_id, element, context) + if not rights.read: + raise not_found() + asset = conn.execute( + "SELECT id, original_filename, content_type, status FROM media_assets WHERE element_id = %s", + (element_id,), + ).fetchone() + if asset is None or asset["status"] != "active": + raise not_found() + payload = read_bytes(asset_path(request.app.state.settings.media_root, asset["id"])) + return Response( + content=payload, + media_type=asset["content_type"], + headers={ + "Content-Disposition": content_disposition(asset["original_filename"]), + "X-Content-Type-Options": "nosniff", + "Cache-Control": "private, no-store", + }, + ) + + +@router.post("/api/v1/elements/{element_id}/delete", status_code=204) +def destroy_element( + element_id: UUID, + body: DeleteElementIn, + request: Request, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + request.state.delete_after_commit = [] + delete_element( + conn, + principal.account_id, + element_id, + body.expected_version, + request.app.state.settings.media_root, + request.state.delete_after_commit, + ) + return Response(status_code=204) + + +@router.get("/api/v1/elements") +def elements(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + rows = conn.execute( + """ + SELECT * FROM elements + WHERE owner_subject_id = %s AND deleted_at IS NULL + AND NOT EXISTS (SELECT 1 FROM bindings b WHERE b.element_id = elements.id) + ORDER BY updated_at DESC, id DESC + LIMIT 100 + """, + (principal.account_id,), + ).fetchall() + return { + "items": [{"id": str(row["id"]), "kind": row["kind"], "title": row["title"], "version": row["version"]} for row in rows], + "next_cursor": None, + } + + +@router.post("/api/v1/tasks") +def post_task(body: TaskIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + task = create_task( + conn, principal.account_id, principal.scope_id, body.title, body.due_on, body.matter_id, _ctx_model(body.context) + ) + rights = task_rights(conn, principal.account_id, task, _ctx_model(body.context)) + return _created(f"/api/v1/tasks/{task['id']}", task_payload(conn, principal.account_id, task, rights)) + + +@router.patch("/api/v1/tasks/{task_id}") +def patch_one_task( + task_id: UUID, + body: TaskPatch, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + task = patch_task( + conn, + principal.account_id, + task_id, + body.expected_version, + body.title, + body.due_on, + body.clear_due_on, + body.status, + _ctx_model(body.context), + ) + rights = task_rights(conn, principal.account_id, task, _ctx_model(body.context)) + return task_payload(conn, principal.account_id, task, rights) + + +@router.post("/api/v1/tasks/{task_id}/assignee") +def post_assignee( + task_id: UUID, + body: AssigneeIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + assignee = None + if body.email: + account = account_by_email(conn, body.email) + if account is None: + raise not_found() + assignee = account["id"] + task = assign_task(conn, principal.account_id, task_id, assignee, _ctx_model(body.context)) + rights = task_rights(conn, principal.account_id, task, _ctx_model(body.context)) + return task_payload(conn, principal.account_id, task, rights) + + +@router.post("/api/v1/tasks/{task_id}/deadline-links", status_code=204) +def post_task_deadline( + task_id: UUID, + body: TaskDeadlineIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + link_task_deadline(conn, principal.account_id, task_id, body.deadline_id, _ctx_model(body.context)) + return Response(status_code=204) + + +@router.post("/api/v1/deadlines") +def post_deadline(body: DeadlineIn, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + deadline = create_deadline( + conn, principal.account_id, principal.scope_id, body.title, body.due_on, body.matter_id, _ctx_model(body.context) + ) + return _created(f"/api/v1/deadlines/{deadline['id']}", deadline_payload(conn, principal.account_id, deadline)) + + +@router.patch("/api/v1/deadlines/{deadline_id}") +def patch_one_deadline( + deadline_id: UUID, + body: DeadlinePatch, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + deadline = patch_deadline( + conn, principal.account_id, deadline_id, body.expected_version, body.title, body.due_on, _ctx_model(body.context) + ) + return deadline_payload(conn, principal.account_id, deadline) + + +@router.post("/api/v1/deadlines/{deadline_id}/fulfill") +def post_fulfill( + deadline_id: UUID, + body: FulfillIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + deadline = fulfill_deadline(conn, principal.account_id, deadline_id, body.expected_version, _ctx_model(body.context)) + return deadline_payload(conn, principal.account_id, deadline) + + +@router.get("/api/v1/views/open-tasks") +def open_tasks(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + rows = conn.execute( + """ + SELECT * FROM tasks + WHERE deleted_at IS NULL AND task_status = 'open' + ORDER BY due_on NULLS LAST, created_at, id + LIMIT 200 + """ + ).fetchall() + items = [] + for task in rows: + if _task_visible(conn, principal.account_id, task): + items.append(task_payload(conn, principal.account_id, task)) + return {"items": items, "next_cursor": None} + + +@router.get("/api/v1/views/open-deadlines") +def open_deadlines(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + rows = conn.execute( + """ + SELECT * FROM deadlines + WHERE deleted_at IS NULL AND deadline_status = 'open' + ORDER BY due_on, created_at, id + LIMIT 200 + """ + ).fetchall() + items = [] + for deadline in rows: + if _deadline_visible(conn, principal.account_id, deadline): + items.append(deadline_payload(conn, principal.account_id, deadline)) + return {"items": items, "next_cursor": None} + + +@router.get("/api/v1/placement-targets") +def placement_targets(principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + items = [] + for case, rights in list_cases(conn, principal.account_id): + if rights.edit: + items.append({"kind": "case", "id": str(case["id"]), "title": case["title"]}) + for matter, contexts in list_matters(conn, principal.account_id): + editable = [item for item in contexts if item["rights"]["edit"]] + if editable: + items.append( + { + "kind": "matter", + "id": str(matter["id"]), + "title": matter["title"], + "contexts": [ + { + "kind": "direct" if item["kind"] == "matter" else item["kind"], + "id": item["id"], + "title": item["title"], + } + for item in editable + ], + } + ) + return {"items": items} + + +@router.get("/api/v1/search") +def search(q: str, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + term = q.strip() + if len(term) < 2: + raise unprocessable("Bitte mindestens zwei Zeichen suchen.") + pattern = "%" + term.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_") + "%" + items = [] + for case, rights in list_cases(conn, principal.account_id): + if rights.read and term.casefold() in case["title"].casefold(): + items.append({"kind": "case", "id": str(case["id"]), "title": case["title"], "contexts": []}) + for matter, contexts in list_matters(conn, principal.account_id): + if term.casefold() in matter["title"].casefold(): + items.append( + { + "kind": "matter", + "id": str(matter["id"]), + "title": matter["title"], + "contexts": [ + {"kind": "direct" if item["kind"] == "matter" else item["kind"], "id": item["id"], "title": item["title"]} + for item in contexts + ], + } + ) + elements = conn.execute( + """ + SELECT e.* + FROM elements e + LEFT JOIN note_bodies n ON n.element_id = e.id + WHERE e.deleted_at IS NULL + AND (e.title ILIKE %s ESCAPE '\\' OR COALESCE(n.document_json::text, '') ILIKE %s ESCAPE '\\') + ORDER BY e.updated_at DESC + LIMIT 100 + """, + (pattern, pattern), + ).fetchall() + for element in elements: + from app.access.policy import visible_bindings_for_element + + bindings = visible_bindings_for_element(conn, principal.account_id, element) + owner = element["owner_subject_id"] == principal.account_id + if not bindings and not owner: + continue + if not bindings and owner: + direct = element_rights(conn, principal.account_id, element, None) + if not direct.read: + continue + items.append( + { + "kind": element["kind"], + "id": str(element["id"]), + "title": element["title"], + "contexts": [ + {"kind": item["context_kind"], "id": item["context_id"], "title": item["context_title"]} + for item in bindings + ], + } + ) + return {"items": items[:50], "next_cursor": None} + + +@router.get("/api/v1/cases/{case_id}/chronology") +def case_chronology(case_id: UUID, principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn)): + case, _rights = require_case(conn, principal.account_id, case_id, "read") + page = Ctx("case", case["id"]) + rows = conn.execute( + """ + SELECT * + FROM domain_events + WHERE (resource_kind = 'case' AND resource_id = %(case)s) + OR (context_kind = 'case' AND context_id = %(case)s) + OR resource_id IN (SELECT matter_id FROM matter_case_links WHERE case_id = %(case)s) + OR resource_id IN ( + SELECT element_id FROM bindings WHERE context_kind = 'case' AND context_id = %(case)s + UNION + SELECT b.element_id + FROM bindings b + JOIN matter_case_links l ON b.context_kind = 'matter' AND b.context_id = l.matter_id + WHERE l.case_id = %(case)s + ) + ORDER BY COALESCE(occurred_on, occurred_at::date), occurred_at, id + """, + {"case": case_id}, + ).fetchall() + return {"items": _visible_events(conn, principal.account_id, rows, page)} + + +@router.get("/api/v1/matters/{matter_id}/chronology") +def matter_chronology( + matter_id: UUID, + context_kind: str | None = None, + context_id: str | None = None, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + context = parse_query_context(context_kind, context_id) + matter, _rights = require_matter(conn, principal.account_id, matter_id, context, "read") + page = context or Ctx("matter", matter["id"]) + rows = conn.execute( + """ + SELECT * + FROM domain_events + WHERE resource_id = %(matter)s + OR (context_kind = 'matter' AND context_id = %(matter)s) + OR resource_id IN ( + SELECT element_id FROM bindings WHERE context_kind = 'matter' AND context_id = %(matter)s + ) + OR resource_id IN ( + SELECT id FROM tasks WHERE matter_id = %(matter)s + UNION + SELECT id FROM deadlines WHERE matter_id = %(matter)s + ) + ORDER BY COALESCE(occurred_on, occurred_at::date), occurred_at, id + """, + {"matter": matter_id}, + ).fetchall() + return {"items": _visible_events(conn, principal.account_id, rows, page)} + + +def _parse_date(value: str | None) -> date | None: + if value is None or value == "": + return None + try: + return date.fromisoformat(value) + except ValueError as exc: + raise unprocessable("Ein Datum ist ungültig.") from exc + + +def _task_visible(conn, actor: UUID, task: dict) -> bool: + if task_rights(conn, actor, task, None).read: + return True + matter = get_matter(conn, task["matter_id"]) if task["matter_id"] else None + if matter is None: + return False + return any(task_rights(conn, actor, task, Ctx(item["kind"], UUID(item["id"]))).read for item in _case_contexts(conn, actor, matter)) + + +def _deadline_visible(conn, actor: UUID, deadline: dict) -> bool: + if deadline_rights(conn, actor, deadline, None).read: + return True + matter = get_matter(conn, deadline["matter_id"]) if deadline["matter_id"] else None + if matter is None: + return False + return any( + deadline_rights(conn, actor, deadline, Ctx(item["kind"], UUID(item["id"]))).read + for item in _case_contexts(conn, actor, matter) + ) + + +def _case_contexts(conn, actor, matter) -> list[dict]: + from app.access.policy import readable_matter_contexts + + return [item for item in readable_matter_contexts(conn, actor, matter) if item["kind"] == "case"] + + +def _visible_events(conn, actor: UUID, rows: list[dict], page: Ctx) -> list[dict]: + items = [] + for event in rows: + title = _event_title(conn, actor, event, page) + if title is None: + continue + items.append( + { + "id": str(event["id"]), + "action": event["action"], + "label": LABELS.get(event["action"], "Ereignis"), + "title": title, + "occurred_on": event["occurred_on"].isoformat() if event["occurred_on"] else None, + "occurred_at": event["occurred_at"].astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), + "resource_kind": event["resource_kind"], + "resource_id": str(event["resource_id"]), + } + ) + return items + + +def _event_title(conn, actor: UUID, event: dict, page: Ctx) -> str | None: + kind = event["resource_kind"] + resource_id = event["resource_id"] + if kind == "case": + case = get_case(conn, resource_id) + if case is None or not case_rights(conn, actor, case).read: + return None + return case["title"] + if kind == "matter": + matter = get_matter(conn, resource_id) + if matter is None: + return None + context = page if page.kind == "case" else None + if not matter_rights(conn, actor, matter, context).read and not matter_rights(conn, actor, matter, None).read: + return None + if page.kind == "case" and not matter_rights(conn, actor, matter, page).read: + return None + return matter["title"] + if kind == "element": + element = get_element(conn, resource_id) + if element is None or not element_rights(conn, actor, element, page).read: + return None + return element["title"] + if kind == "task": + task = get_task(conn, resource_id) + if task is None or not task_rights(conn, actor, task, None if page.kind == "matter" else page).read: + if task is None or not task_rights(conn, actor, task, page).read: + return None + return task["title"] if task else None + if kind == "deadline": + deadline = get_deadline(conn, resource_id) + if deadline is None: + return None + direct = deadline_rights(conn, actor, deadline, None) + via = deadline_rights(conn, actor, deadline, page) + if not direct.read and not via.read: + return None + return deadline["title"] + return None diff --git a/backend/app/api/schemas.py b/backend/app/api/schemas.py new file mode 100644 index 0000000..d6330c2 --- /dev/null +++ b/backend/app/api/schemas.py @@ -0,0 +1,203 @@ +"""Request bodies. Unknown fields are rejected.""" + +from __future__ import annotations + +from datetime import date +from typing import Annotated, Literal +from uuid import UUID + +from pydantic import BaseModel, ConfigDict, Field + +Email = Annotated[str, Field(min_length=3, max_length=320, pattern=r"^[^@\s]+@[^@\s]+\.[^@\s]+$")] + + +class APIModel(BaseModel): + model_config = ConfigDict(extra="forbid") + + +class LoginIn(APIModel): + email: Email + password: str = Field(min_length=1, max_length=200) + + +class ScopeIn(APIModel): + kind: Literal["personal", "organization"] + id: UUID + + +class AcceptInviteIn(APIModel): + token: str = Field(min_length=20, max_length=200) + display_name: str = Field(min_length=1, max_length=120) + password: str = Field(min_length=10, max_length=200) + + +class InvitationIn(APIModel): + email: Email + room_id: UUID + + +class RoomIn(APIModel): + name: str = Field(min_length=1, max_length=160) + + +class MemberIn(APIModel): + email: Email + role: Literal["member", "manager"] + + +class ContextIn(APIModel): + kind: Literal["case", "matter"] + id: UUID + + +class CaseIn(APIModel): + title: str = Field(min_length=1, max_length=200) + parent_case_id: UUID | None = None + rights_mode: Literal["inherit_parent", "explicit"] = "inherit_parent" + + +class CasePatch(APIModel): + expected_version: int = Field(ge=1) + title: str | None = Field(default=None, min_length=1, max_length=200) + status: Literal["open", "closed"] | None = None + + +class ChapterIn(APIModel): + title: str = Field(min_length=1, max_length=200) + position: int | None = Field(default=None, ge=0, le=10000) + + +class MatterIn(APIModel): + title: str = Field(min_length=1, max_length=200) + parent_matter_id: UUID | None = None + context: ContextIn | None = None + + +class MatterPatch(APIModel): + expected_version: int = Field(ge=1) + title: str | None = Field(default=None, min_length=1, max_length=200) + status: Literal["open", "closed"] | None = None + context: ContextIn | None = None + + +class CaseLinkIn(APIModel): + case_id: UUID + context: ContextIn | None = None + + +class CrossLinkIn(APIModel): + target_matter_id: UUID + target_context: ContextIn + source_context: ContextIn | None = None + + +class GrantIn(APIModel): + email: Email + can_read: bool = True + can_edit: bool = False + can_share: bool = False + + +class ExceptionIn(APIModel): + resource_kind: Literal["element", "matter", "task", "deadline"] + resource_id: UUID + context: ContextIn + remove_read: bool = False + remove_edit: bool = False + remove_share: bool = False + + +class DocumentIn(APIModel): + version: Literal[1] = 1 + blocks: list[dict] + + +class NoteIn(APIModel): + title: str = Field(min_length=1, max_length=200) + document: DocumentIn + context: ContextIn + placement: ContextIn | None = None + chapter_id: UUID | None = None + + +class NotePatch(APIModel): + expected_version: int = Field(ge=1) + document: DocumentIn + context: ContextIn | None = None + + +class BindingIn(APIModel): + element_id: UUID + source_context: ContextIn + target: ContextIn + target_context: ContextIn | None = None + chapter_id: UUID | None = None + + +class AnnotationIn(APIModel): + body: str = Field(min_length=1, max_length=4000) + + +class DatesIn(APIModel): + document_on: date | None = None + sent_on: date | None = None + received_on: date | None = None + + +class ExternalIn(APIModel): + title: str = Field(min_length=1, max_length=200) + source: Literal["paperless", "url"] + external_id: str = Field(min_length=1, max_length=200) + context: ContextIn + placement: ContextIn | None = None + chapter_id: UUID | None = None + dates: DatesIn = DatesIn() + + +class DeleteElementIn(APIModel): + expected_version: int = Field(ge=1) + + +class TaskIn(APIModel): + title: str = Field(min_length=1, max_length=200) + due_on: date | None = None + matter_id: UUID | None = None + context: ContextIn | None = None + + +class TaskPatch(APIModel): + expected_version: int = Field(ge=1) + title: str | None = Field(default=None, min_length=1, max_length=200) + due_on: date | None = None + clear_due_on: bool = False + status: Literal["open", "done"] | None = None + context: ContextIn | None = None + + +class AssigneeIn(APIModel): + email: str | None = None + context: ContextIn | None = None + + +class DeadlineIn(APIModel): + title: str = Field(min_length=1, max_length=200) + due_on: date + matter_id: UUID | None = None + context: ContextIn | None = None + + +class DeadlinePatch(APIModel): + expected_version: int = Field(ge=1) + title: str | None = Field(default=None, min_length=1, max_length=200) + due_on: date | None = None + context: ContextIn | None = None + + +class FulfillIn(APIModel): + expected_version: int = Field(ge=1) + context: ContextIn | None = None + + +class TaskDeadlineIn(APIModel): + deadline_id: UUID + context: ContextIn | None = None diff --git a/backend/app/auth/__init__.py b/backend/app/auth/__init__.py new file mode 100644 index 0000000..1674b43 --- /dev/null +++ b/backend/app/auth/__init__.py @@ -0,0 +1 @@ +"""Accounts, sessions and cookies.""" diff --git a/backend/app/auth/accounts.py b/backend/app/auth/accounts.py new file mode 100644 index 0000000..d333306 --- /dev/null +++ b/backend/app/auth/accounts.py @@ -0,0 +1,78 @@ +"""Accounts, personal rooms and sessions.""" + +from __future__ import annotations + +from uuid import UUID, uuid4 + +from app.auth.security import hash_password, hash_secret, new_secret, session_expiry +from app.core.errors import unprocessable +from app.core.settings import Settings + + +def normalize_email(email: str) -> str: + return email.strip().lower() + + +def create_account(conn, email: str, display_name: str, password: str) -> dict: + email = normalize_email(email) + display_name = display_name.strip() + if conn.execute("SELECT 1 FROM auth_accounts WHERE email = %s", (email,)).fetchone(): + raise unprocessable("Für diese E-Mail gibt es bereits ein Konto.") + account_id = uuid4() + password_hash = hash_password(password) + conn.execute( + """ + INSERT INTO auth_accounts (id, email, display_name, password_hash) + VALUES (%s, %s, %s, %s) + """, + (account_id, email, display_name, password_hash), + ) + conn.execute( + """ + INSERT INTO data_rooms (id, kind, name, created_by) + VALUES (%s, 'personal', 'Persönlicher Raum', %s) + """, + (account_id, account_id), + ) + return conn.execute( + "SELECT id, email, display_name FROM auth_accounts WHERE id = %s", + (account_id,), + ).fetchone() + + +def start_session(conn, settings: Settings, account_id: UUID) -> tuple[str, str]: + token = new_secret() + csrf = new_secret() + conn.execute( + """ + INSERT INTO auth_sessions ( + account_id, secret_hash, csrf_token, scope_kind, scope_id, expires_at + ) + VALUES (%s, %s, %s, 'personal', %s, %s) + """, + (account_id, hash_secret(token), csrf, account_id, session_expiry(settings)), + ) + return token, csrf + + +def list_rooms(conn, account_id: UUID) -> list[dict]: + personal = conn.execute( + "SELECT id, kind, name FROM data_rooms WHERE id = %s AND kind = 'personal'", + (account_id,), + ).fetchone() + rooms = [] + if personal is not None: + rooms.append({"id": str(personal["id"]), "kind": personal["kind"], "name": personal["name"], "role": "owner"}) + shared = conn.execute( + """ + SELECT r.id, r.kind, r.name, m.role + FROM room_memberships m + JOIN data_rooms r ON r.id = m.room_id + WHERE m.subject_id = %s AND m.status = 'active' AND r.status = 'active' AND r.kind = 'organization' + ORDER BY r.name, r.id + """, + (account_id,), + ).fetchall() + for room in shared: + rooms.append({"id": str(room["id"]), "kind": room["kind"], "name": room["name"], "role": room["role"]}) + return rooms diff --git a/backend/app/auth/security.py b/backend/app/auth/security.py new file mode 100644 index 0000000..c0a30be --- /dev/null +++ b/backend/app/auth/security.py @@ -0,0 +1,74 @@ +"""Password hashing, session cookies and CSRF.""" + +from __future__ import annotations + +import hashlib +import secrets +from datetime import timedelta + +import bcrypt +from fastapi import Request, Response + +from app.core.settings import Settings +from app.core.timeutil import utcnow + +HOST_COOKIE = "__Host-jinkendo-session" +PLAIN_COOKIE = "jinkendo-session" + + +def hash_password(password: str) -> str: + return bcrypt.hashpw(password.encode("utf-8"), bcrypt.gensalt(rounds=12)).decode("utf-8") + + +def verify_password(password: str, password_hash: str) -> bool: + try: + return bcrypt.checkpw(password.encode("utf-8"), password_hash.encode("utf-8")) + except ValueError: + return False + + +def new_secret() -> str: + return secrets.token_urlsafe(32) + + +def hash_secret(secret: str) -> str: + return hashlib.sha256(secret.encode("utf-8")).hexdigest() + + +def cookie_name_and_secure(request: Request, settings: Settings) -> tuple[str, bool]: + # __Host- cookies require Secure. Production is only published behind HTTPS. + # Development also serves the documented plain HTTP LAN addresses, which cannot store them. + if settings.tsumugu_env == "production": + return HOST_COOKIE, True + forwarded = request.headers.get("x-forwarded-proto", request.url.scheme) + if forwarded == "https": + return HOST_COOKIE, True + return PLAIN_COOKIE, False + + +def read_session_token(request: Request) -> str | None: + return request.cookies.get(HOST_COOKIE) or request.cookies.get(PLAIN_COOKIE) + + +def set_session_cookie(response: Response, request: Request, settings: Settings, token: str) -> None: + name, secure = cookie_name_and_secure(request, settings) + response.set_cookie( + key=name, + value=token, + httponly=True, + secure=secure, + samesite="lax", + path="/", + max_age=settings.session_ttl_hours * 3600, + ) + + +def clear_session_cookie(response: Response, request: Request, settings: Settings) -> None: + name, secure = cookie_name_and_secure(request, settings) + response.delete_cookie(key=name, path="/", secure=secure, httponly=True, samesite="lax") + if name != PLAIN_COOKIE: + response.delete_cookie(key=PLAIN_COOKIE, path="/", httponly=True, samesite="lax") + + +def session_expiry(settings: Settings): + return utcnow() + timedelta(hours=settings.session_ttl_hours) diff --git a/backend/app/cli.py b/backend/app/cli.py new file mode 100644 index 0000000..1fe9d1e --- /dev/null +++ b/backend/app/cli.py @@ -0,0 +1,44 @@ +"""Operator commands: migrate, seed demo data, create the first account.""" + +from __future__ import annotations + +import argparse + +from app.auth.accounts import create_account +from app.core.settings import get_settings +from app.db.migrate import migrate +from app.seed import seed_demo + +import psycopg +from psycopg.rows import dict_row + + +def main() -> None: + parser = argparse.ArgumentParser(prog="tsumugu") + sub = parser.add_subparsers(dest="command", required=True) + sub.add_parser("migrate") + sub.add_parser("seed-demo") + create = sub.add_parser("create-account") + create.add_argument("--email", required=True) + create.add_argument("--name", required=True) + create.add_argument("--password", required=True) + args = parser.parse_args() + settings = get_settings() + if args.command == "migrate": + applied = migrate(settings) + print("applied" if applied else "up to date") + return + if args.command == "seed-demo": + created = seed_demo(settings) + print("seeded" if created else "unchanged") + return + if len(args.password) < 10: + raise SystemExit("password must be at least 10 characters") + with psycopg.connect(settings.dsn(), row_factory=dict_row) as conn: + account = create_account(conn, args.email, args.name, args.password) + conn.commit() + print(account["id"]) + + +if __name__ == "__main__": + main() diff --git a/backend/app/content/__init__.py b/backend/app/content/__init__.py new file mode 100644 index 0000000..3ba5923 --- /dev/null +++ b/backend/app/content/__init__.py @@ -0,0 +1 @@ +"""Notes, bindings, files and external references.""" diff --git a/backend/app/content/documents.py b/backend/app/content/documents.py new file mode 100644 index 0000000..e30d524 --- /dev/null +++ b/backend/app/content/documents.py @@ -0,0 +1,25 @@ +"""Bounded note documents. Only paragraph text is stored.""" + +from __future__ import annotations + +from app.core.errors import unprocessable + + +def clean_document(document: dict) -> dict: + blocks = document.get("blocks") + if not isinstance(blocks, list) or len(blocks) > 400: + raise unprocessable("Die Notiz hat kein gültiges Dokument.") + clean = [] + for block in blocks: + if not isinstance(block, dict) or set(block) - {"type", "text"}: + raise unprocessable("Die Notiz enthält einen nicht unterstützten Block.") + if block.get("type") != "paragraph" or not isinstance(block.get("text"), str): + raise unprocessable("Die Notiz enthält einen nicht unterstützten Block.") + if len(block["text"]) > 20000: + raise unprocessable("Ein Absatz ist zu lang.") + clean.append({"type": "paragraph", "text": block["text"]}) + return {"version": 1, "blocks": clean} + + +def document_text(document: dict) -> str: + return "\n".join(block["text"] for block in document.get("blocks", [])) diff --git a/backend/app/core/__init__.py b/backend/app/core/__init__.py new file mode 100644 index 0000000..ebe0959 --- /dev/null +++ b/backend/app/core/__init__.py @@ -0,0 +1 @@ +"""Core settings, errors and request helpers.""" diff --git a/backend/app/core/errors.py b/backend/app/core/errors.py new file mode 100644 index 0000000..ce16081 --- /dev/null +++ b/backend/app/core/errors.py @@ -0,0 +1,71 @@ +"""RFC 9457 problem responses. Hidden objects use the same 404 as missing ones.""" + +from __future__ import annotations + +from fastapi import Request +from fastapi.responses import JSONResponse + + +class Problem(Exception): + def __init__(self, status: int, title: str, detail: str, code: str) -> None: + super().__init__(detail) + self.status = status + self.title = title + self.detail = detail + self.code = code + + def body(self, instance: str) -> dict: + return { + "type": "about:blank", + "title": self.title, + "status": self.status, + "detail": self.detail, + "instance": instance, + "code": self.code, + } + + +def unauthorized() -> Problem: + return Problem(401, "Anmeldung erforderlich", "Die Sitzung fehlt oder ist abgelaufen.", "unauthorized") + + +def forbidden(detail: str = "Diese Aktion ist im gewählten Kontext nicht erlaubt.") -> Problem: + return Problem(403, "Keine Berechtigung", detail, "forbidden") + + +def not_found() -> Problem: + return Problem(404, "Nicht gefunden", "Der Eintrag ist nicht vorhanden.", "not_found") + + +def conflict() -> Problem: + return Problem( + 409, + "Versionskonflikt", + "Der Stand hat sich geändert. Bitte neu laden.", + "conflict", + ) + + +def unprocessable(detail: str) -> Problem: + return Problem(422, "Eingabe ungültig", detail, "unprocessable") + + +def too_many() -> Problem: + return Problem(429, "Zu viele Versuche", "Bitte kurz warten und es erneut versuchen.", "too_many_requests") + + +def storage_unavailable() -> Problem: + return Problem( + 503, + "Speicher nicht verfügbar", + "Die Datei kann gerade nicht gelesen oder geschrieben werden.", + "storage_unavailable", + ) + + +def problem_response(problem: Problem, request: Request) -> JSONResponse: + return JSONResponse( + status_code=problem.status, + content=problem.body(request.url.path), + media_type="application/problem+json", + ) diff --git a/backend/app/core/settings.py b/backend/app/core/settings.py new file mode 100644 index 0000000..f08008a --- /dev/null +++ b/backend/app/core/settings.py @@ -0,0 +1,47 @@ +"""Process settings. Unknown environments refuse to start.""" + +from __future__ import annotations + +from functools import lru_cache +from typing import Literal + +from pydantic import field_validator +from pydantic_settings import BaseSettings, SettingsConfigDict + + +class Settings(BaseSettings): + model_config = SettingsConfigDict(extra="ignore") + + tsumugu_env: Literal["development", "production"] + db_host: str = "localhost" + db_port: int = 5432 + db_name: str + db_user: str + db_password: str + db_runtime_user: str = "tsumugu_runtime" + app_url: str = "http://localhost:5173" + allowed_origins: str = "http://localhost:5173,http://localhost:3094" + media_root: str = "data/media" + seed_demo: bool = False + session_ttl_hours: int = 336 + upload_max_bytes: int = 20 * 1024 * 1024 + + @field_validator("allowed_origins") + @classmethod + def strip_origins(cls, value: str) -> str: + return value.strip() + + @property + def origin_set(self) -> set[str]: + return {item.strip() for item in self.allowed_origins.split(",") if item.strip()} + + def dsn(self, user: str | None = None) -> str: + return ( + f"host={self.db_host} port={self.db_port} dbname={self.db_name} " + f"user={user or self.db_user} password={self.db_password} connect_timeout=5" + ) + + +@lru_cache +def get_settings() -> Settings: + return Settings() diff --git a/backend/app/core/timeutil.py b/backend/app/core/timeutil.py new file mode 100644 index 0000000..a5a254f --- /dev/null +++ b/backend/app/core/timeutil.py @@ -0,0 +1,23 @@ +"""UTC formatting for API values.""" + +from __future__ import annotations + +from datetime import date, datetime, timezone + + +def utcnow() -> datetime: + return datetime.now(timezone.utc) + + +def dump_dt(value: datetime | None) -> str | None: + if value is None: + return None + if value.tzinfo is None: + value = value.replace(tzinfo=timezone.utc) + return value.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ") + + +def dump_date(value: date | None) -> str | None: + if value is None: + return None + return value.isoformat() diff --git a/backend/app/db/__init__.py b/backend/app/db/__init__.py new file mode 100644 index 0000000..f87718e --- /dev/null +++ b/backend/app/db/__init__.py @@ -0,0 +1 @@ +"""Database pool and migrations.""" diff --git a/backend/app/db/migrate.py b/backend/app/db/migrate.py new file mode 100644 index 0000000..a2ff974 --- /dev/null +++ b/backend/app/db/migrate.py @@ -0,0 +1,90 @@ +"""SQL migrations with a checksum ledger, then a runtime role without DDL.""" + +from __future__ import annotations + +import hashlib +from pathlib import Path + +import psycopg +from psycopg import ClientCursor, sql + +from app.core.settings import Settings, get_settings + +MIGRATIONS = Path(__file__).resolve().parent.parent.parent / "migrations" + + +def _checksum(path: Path) -> str: + return hashlib.sha256(path.read_bytes()).hexdigest() + + +def migrate(settings: Settings | None = None) -> list[str]: + settings = settings or get_settings() + applied: list[str] = [] + with psycopg.connect(settings.dsn(), autocommit=True, cursor_factory=ClientCursor) as conn: + conn.execute( + """ + CREATE TABLE IF NOT EXISTS schema_migrations ( + version text PRIMARY KEY, + checksum text NOT NULL, + applied_at timestamptz NOT NULL DEFAULT now() + ) + """ + ) + for path in sorted(MIGRATIONS.glob("*.sql")): + version = path.name + checksum = _checksum(path) + row = conn.execute( + "SELECT checksum FROM schema_migrations WHERE version = %s", + (version,), + ).fetchone() + if row is not None: + if row[0] != checksum: + raise RuntimeError(f"checksum mismatch for migration {version}") + continue + with conn.transaction(): + conn.execute(path.read_text(encoding="utf-8")) + conn.execute( + "INSERT INTO schema_migrations (version, checksum) VALUES (%s, %s)", + (version, checksum), + ) + applied.append(version) + _ensure_runtime_role(conn, settings) + return applied + + +def _ensure_runtime_role(conn: psycopg.Connection, settings: Settings) -> None: + role = sql.Identifier(settings.db_runtime_user) + database = sql.Identifier(settings.db_name) + owner = sql.Identifier(settings.db_user) + password = sql.Literal(settings.db_password) + exists = conn.execute( + "SELECT 1 FROM pg_roles WHERE rolname = %s", + (settings.db_runtime_user,), + ).fetchone() + if exists is None: + conn.execute( + sql.SQL( + "CREATE ROLE {} LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT PASSWORD {}" + ).format(role, password) + ) + else: + conn.execute( + sql.SQL( + "ALTER ROLE {} WITH LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT PASSWORD {}" + ).format(role, password) + ) + conn.execute(sql.SQL("GRANT CONNECT ON DATABASE {} TO {}").format(database, role)) + conn.execute(sql.SQL("GRANT USAGE ON SCHEMA public TO {}").format(role)) + conn.execute(sql.SQL("REVOKE CREATE ON SCHEMA public FROM {}").format(role)) + conn.execute( + sql.SQL( + "GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO {}" + ).format(role) + ) + conn.execute(sql.SQL("REVOKE ALL ON TABLE schema_migrations FROM {}").format(role)) + conn.execute( + sql.SQL( + "ALTER DEFAULT PRIVILEGES FOR ROLE {} IN SCHEMA public " + "GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO {}" + ).format(owner, role) + ) diff --git a/backend/app/db/pool.py b/backend/app/db/pool.py new file mode 100644 index 0000000..7c11a4f --- /dev/null +++ b/backend/app/db/pool.py @@ -0,0 +1,19 @@ +"""Runtime connection pool. Importing the app does not open it.""" + +from __future__ import annotations + +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool + +from app.core.settings import Settings + + +def open_pool(settings: Settings) -> ConnectionPool: + return ConnectionPool( + conninfo=settings.dsn(settings.db_runtime_user), + kwargs={"row_factory": dict_row}, + min_size=1, + max_size=10, + open=True, + timeout=10, + ) diff --git a/backend/app/entrypoint.py b/backend/app/entrypoint.py new file mode 100644 index 0000000..fb6a895 --- /dev/null +++ b/backend/app/entrypoint.py @@ -0,0 +1,18 @@ +"""Migrate, optionally seed development data, then serve.""" + +from __future__ import annotations + +import os + +from app.db.migrate import migrate +from app.seed import seed_demo + + +def main() -> None: + migrate() + seed_demo() + os.execvp("uvicorn", ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]) + + +if __name__ == "__main__": + main() diff --git a/backend/app/main.py b/backend/app/main.py new file mode 100644 index 0000000..5c9788e --- /dev/null +++ b/backend/app/main.py @@ -0,0 +1,119 @@ +"""Application factory. Importing this module does not open a database connection.""" + +from __future__ import annotations + +import logging +from contextlib import asynccontextmanager + +from fastapi import FastAPI, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse + +from app.api.routes import router +from app.core.errors import Problem, problem_response +from app.core.settings import get_settings +from app.db.pool import open_pool + +logger = logging.getLogger("tsumugu") + + +def _database_ok(app: FastAPI) -> bool: + pool = getattr(app.state, "pool", None) + if pool is None: + return False + try: + with pool.connection() as conn: + conn.execute("SELECT 1") + conn.rollback() + return True + except Exception: + logger.warning("database check failed") + return False + + +def create_app() -> FastAPI: + settings = get_settings() + logging.basicConfig(level=logging.INFO, format="%(levelname)s %(name)s %(message)s") + + @asynccontextmanager + async def lifespan(app: FastAPI): + app.state.pool = open_pool(settings) + try: + yield + finally: + app.state.pool.close() + + app = FastAPI(title="Tsumugu", docs_url=None, redoc_url=None, openapi_url=None, lifespan=lifespan) + app.state.settings = settings + + @app.middleware("http") + async def origin_guard(request: Request, call_next): + if request.method not in {"GET", "HEAD", "OPTIONS"} and request.url.path.startswith("/api/"): + origin = request.headers.get("origin") + if origin not in settings.origin_set: + problem = Problem(403, "Keine Berechtigung", "Der Ursprung der Anfrage ist nicht erlaubt.", "forbidden") + return problem_response(problem, request) + response = await call_next(request) + logger.info("%s %s -> %s", request.method, request.url.path, response.status_code) + return response + + @app.exception_handler(Problem) + async def handle_problem(request: Request, exc: Problem): + return problem_response(exc, request) + + @app.exception_handler(RequestValidationError) + async def handle_validation(request: Request, exc: RequestValidationError): + return JSONResponse( + status_code=422, + content={ + "type": "about:blank", + "title": "Eingabe ungültig", + "status": 422, + "detail": "Die Eingabe ist unvollständig oder ungültig.", + "instance": request.url.path, + "code": "unprocessable", + }, + media_type="application/problem+json", + ) + + @app.exception_handler(Exception) + async def handle_unexpected(request: Request, exc: Exception): + logger.exception("unhandled error") + return JSONResponse( + status_code=500, + content={ + "type": "about:blank", + "title": "Unerwarteter Fehler", + "status": 500, + "detail": "Die Aktion konnte nicht abgeschlossen werden.", + "instance": request.url.path, + "code": "internal", + }, + media_type="application/problem+json", + ) + + @app.get("/api/health") + def api_health(): + ok = _database_ok(app) + return JSONResponse( + status_code=200 if ok else 503, + content={"status": "ok" if ok else "degraded", "app": "tsumugu"}, + ) + + @app.get("/health/live") + def health_live(): + return {"status": "ok", "app": "tsumugu"} + + @app.get("/health/ready") + def health_ready(): + ok = _database_ok(app) + return JSONResponse( + status_code=200 if ok else 503, + content={"status": "ok" if ok else "degraded", "app": "tsumugu"}, + ) + + app.include_router(router) + return app + + +app = create_app() diff --git a/backend/app/media/__init__.py b/backend/app/media/__init__.py new file mode 100644 index 0000000..4ed08e7 --- /dev/null +++ b/backend/app/media/__init__.py @@ -0,0 +1 @@ +"""Private file storage. Paths are server-generated.""" diff --git a/backend/app/media/storage.py b/backend/app/media/storage.py new file mode 100644 index 0000000..5002fcb --- /dev/null +++ b/backend/app/media/storage.py @@ -0,0 +1,71 @@ +"""Sniff uploads and keep client names out of the storage path.""" + +from __future__ import annotations + +import hashlib +from pathlib import Path +from uuid import UUID + +from app.core.errors import storage_unavailable, unprocessable + +ALLOWED = { + "application/pdf": "pdf", + "image/png": "png", + "image/jpeg": "jpg", + "image/webp": "webp", +} + + +def sniff(data: bytes) -> str: + if data.startswith(b"%PDF"): + return "application/pdf" + if data.startswith(b"\x89PNG\r\n\x1a\n"): + return "image/png" + if data.startswith(b"\xff\xd8\xff"): + return "image/jpeg" + if len(data) >= 12 and data[:4] == b"RIFF" and data[8:12] == b"WEBP": + return "image/webp" + raise unprocessable("Erlaubt sind PDF, PNG, JPEG und WebP.") + + +def asset_path(media_root: str, asset_id: UUID) -> Path: + root = Path(media_root).resolve() + root.mkdir(parents=True, exist_ok=True) + target = (root / str(asset_id)).resolve() + if target.parent != root: + raise unprocessable("Ungültiger Speicherpfad.") + return target + + +def write_bytes(path: Path, data: bytes) -> None: + try: + path.write_bytes(data) + except OSError as exc: + raise storage_unavailable() from exc + + +def read_bytes(path: Path) -> bytes: + try: + if not path.is_file(): + raise storage_unavailable() + return path.read_bytes() + except OSError as exc: + raise storage_unavailable() from exc + + +def sha256(data: bytes) -> str: + return hashlib.sha256(data).hexdigest() + + +def display_filename(name: str) -> str: + cleaned = [] + for char in name.replace("\\", "/").split("/")[-1]: + if char.isprintable() and char not in {'"', "\r", "\n", ":"}: + cleaned.append(char) + text = "".join(cleaned).strip() or "datei" + return text[:240] + + +def content_disposition(filename: str) -> str: + safe = display_filename(filename).replace('"', "") + return f'attachment; filename="{safe}"' diff --git a/backend/app/ops.py b/backend/app/ops.py new file mode 100644 index 0000000..e1e0dd6 --- /dev/null +++ b/backend/app/ops.py @@ -0,0 +1,784 @@ +"""Use-cases for organisation, content and tracking. One transaction is the caller's.""" + +from __future__ import annotations + +from datetime import date +from pathlib import Path +from uuid import UUID, uuid4 + +from psycopg.types.json import Json + +from app.access.policy import ( + Ctx, + Rights, + audit, + block_unsharable_matter_elements, + bump_version, + can_change_status, + case_rights, + chapter_for, + deadline_rights, + display_name, + element_rights, + get_case, + get_deadline, + get_element, + get_matter, + get_task, + insert_binding, + matter_rights, + require_case, + require_element, + require_matter, + task_rights, +) +from app.content.documents import clean_document +from app.core.errors import forbidden, not_found, unprocessable +from app.core.timeutil import utcnow +from app.media.storage import asset_path, display_filename, sha256, sniff, write_bytes + + +def _ctx(value) -> Ctx | None: + if value is None: + return None + if isinstance(value, Ctx): + return value + return Ctx(value.kind, value.id) + + +def require_container_edit(conn, actor: UUID, target: Ctx, rights_context: Ctx | None) -> None: + if target.kind == "case": + if rights_context is not None and (rights_context.kind != "case" or rights_context.id != target.id): + raise unprocessable("Der Handlungskontext passt nicht zur Akte.") + require_case(conn, actor, target.id, "edit") + return + if rights_context is None or (rights_context.kind == "matter" and rights_context.id == target.id): + require_matter(conn, actor, target.id, None, "edit") + return + require_matter(conn, actor, target.id, rights_context, "edit") + + +def _placement(context: Ctx, placement: Ctx | None) -> tuple[Ctx, Ctx]: + target = placement or context + rights_context = None if placement is None and context.kind == "matter" else context + if placement is None and context.kind == "matter": + return target, None + if placement is not None and placement.kind == "matter" and context.kind == "case": + return placement, context + if placement is not None and placement == context: + return target, None if context.kind == "matter" else context + return target, context if context.kind == "case" or placement is not None else None + + +def create_case(conn, actor: UUID, scope_id: UUID, title: str, parent_case_id: UUID | None, rights_mode: str) -> dict: + title = title.strip() + if parent_case_id is None: + row = conn.execute( + """ + INSERT INTO cases ( + home_scope_id, owner_subject_id, created_by, title, rights_mode + ) + VALUES (%s, %s, %s, %s, 'explicit') + RETURNING * + """, + (scope_id, actor, actor, title), + ).fetchone() + else: + parent, _rights = require_case(conn, actor, parent_case_id, "edit") + if parent["parent_case_id"] is not None: + raise unprocessable("Im ersten Schnitt hat eine Unterakte keine weitere Unterakte.") + if rights_mode not in {"inherit_parent", "explicit"}: + raise unprocessable("Die Rechteart der Unterakte ist ungültig.") + row = conn.execute( + """ + INSERT INTO cases ( + home_scope_id, owner_subject_id, created_by, title, parent_case_id, rights_mode + ) + VALUES (%s, %s, %s, %s, %s, %s) + RETURNING * + """, + (parent["home_scope_id"], actor, actor, title, parent["id"], rights_mode), + ).fetchone() + audit(conn, actor, row["home_scope_id"], "case_created", "case", row["id"]) + return row + + +def patch_case(conn, actor: UUID, case_id: UUID, expected: int, title: str | None, status: str | None) -> dict: + case, rights = require_case(conn, actor, case_id, "edit") + if title is None and status is None: + raise unprocessable("Es fehlt eine Änderung.") + if not rights.edit: + raise forbidden() + version = bump_version(conn, "cases", case_id, expected) + if title is not None: + conn.execute("UPDATE cases SET title = %s WHERE id = %s", (title.strip(), case_id)) + if status is not None: + conn.execute("UPDATE cases SET record_status = %s WHERE id = %s", (status, case_id)) + updated = get_case(conn, case_id) + updated["version"] = version + return updated + + +def create_chapter(conn, actor: UUID, kind: str, container_id: UUID, title: str, position: int | None, context: Ctx | None) -> dict: + if kind == "case": + container, _rights = require_case(conn, actor, container_id, "edit") + else: + container, _rights = require_matter(conn, actor, container_id, context, "edit") + if position is None: + column = "case_id" if kind == "case" else "matter_id" + current = conn.execute( + f"SELECT COALESCE(MAX(position), -1) + 1 AS pos FROM chapters WHERE {column} = %s", + (container_id,), + ).fetchone() + position = int(current["pos"]) + if kind == "case": + row = conn.execute( + """ + INSERT INTO chapters (home_scope_id, case_id, title, position) + VALUES (%s, %s, %s, %s) RETURNING * + """, + (container["home_scope_id"], container_id, title.strip(), position), + ).fetchone() + else: + row = conn.execute( + """ + INSERT INTO chapters (home_scope_id, matter_id, title, position) + VALUES (%s, %s, %s, %s) RETURNING * + """, + (container["home_scope_id"], container_id, title.strip(), position), + ).fetchone() + audit(conn, actor, container["home_scope_id"], "chapter_created", kind, container_id, context) + return row + + +def create_matter(conn, actor: UUID, scope_id: UUID, title: str, parent_matter_id: UUID | None, context: Ctx | None) -> dict: + title = title.strip() + if parent_matter_id is None: + row = conn.execute( + """ + INSERT INTO matters (home_scope_id, owner_subject_id, created_by, title) + VALUES (%s, %s, %s, %s) RETURNING * + """, + (scope_id, actor, actor, title), + ).fetchone() + else: + parent, _rights = require_matter(conn, actor, parent_matter_id, context, "edit") + if parent["parent_matter_id"] is not None: + raise unprocessable("Im ersten Schnitt hat ein Teilvorgang keinen weiteren Teilvorgang.") + row = conn.execute( + """ + INSERT INTO matters ( + home_scope_id, owner_subject_id, created_by, title, parent_matter_id + ) + VALUES (%s, %s, %s, %s, %s) RETURNING * + """, + (parent["home_scope_id"], actor, actor, title, parent["id"]), + ).fetchone() + audit(conn, actor, row["home_scope_id"], "matter_created", "matter", row["id"], context) + return row + + +def patch_matter(conn, actor: UUID, matter_id: UUID, expected: int, title: str | None, status: str | None, context: Ctx | None) -> dict: + if title is None and status is None: + raise unprocessable("Es fehlt eine Änderung.") + _matter, _rights = require_matter(conn, actor, matter_id, context, "edit") + bump_version(conn, "matters", matter_id, expected) + if title is not None: + conn.execute("UPDATE matters SET title = %s WHERE id = %s", (title.strip(), matter_id)) + if status is not None: + conn.execute("UPDATE matters SET record_status = %s WHERE id = %s", (status, matter_id)) + return get_matter(conn, matter_id) + + +def link_matter_to_case(conn, actor: UUID, matter_id: UUID, case_id: UUID, matter_context: Ctx | None) -> dict: + matter, matter_right = require_matter(conn, actor, matter_id, matter_context, "share") + case, _case_right = require_case(conn, actor, case_id, "edit") + if not matter_right.share: + raise forbidden() + try: + link = conn.execute( + """ + INSERT INTO matter_case_links (matter_id, case_id, created_by) + VALUES (%s, %s, %s) RETURNING * + """, + (matter["id"], case["id"], actor), + ).fetchone() + except Exception as exc: + if exc.__class__.__name__ == "UniqueViolation": + raise unprocessable("Der Vorgang ist dieser Akte bereits zugeordnet.") from exc + raise + block_unsharable_matter_elements(conn, actor, link["id"], matter) + audit(conn, actor, case["home_scope_id"], "matter_linked", "matter", matter["id"], Ctx("case", case["id"])) + return link + + +def unlink_matter_case(conn, actor: UUID, link_id: UUID) -> None: + link = conn.execute("SELECT * FROM matter_case_links WHERE id = %s", (link_id,)).fetchone() + if link is None: + raise not_found() + matter_direct = matter_rights(conn, actor, get_matter(conn, link["matter_id"]), None) + case_right = case_rights(conn, actor, get_case(conn, link["case_id"])) + if not case_right.read and not matter_direct.read: + raise not_found() + if not case_right.edit and not matter_direct.share: + raise forbidden() + conn.execute("DELETE FROM matter_case_links WHERE id = %s", (link_id,)) + audit(conn, actor, None, "matter_unlinked", "matter", link["matter_id"], Ctx("case", link["case_id"])) + + +def create_cross_link(conn, actor: UUID, source_id: UUID, target_id: UUID, source_context: Ctx | None, target_context: Ctx) -> dict: + if source_id == target_id: + raise unprocessable("Ein Vorgang kann nicht auf sich selbst verweisen.") + source, _rights = require_matter(conn, actor, source_id, source_context, "edit") + target, target_rights = require_matter(conn, actor, target_id, target_context, "read") + if not target_rights.read: + raise not_found() + try: + row = conn.execute( + """ + INSERT INTO matter_cross_links (from_matter_id, to_matter_id, created_by) + VALUES (%s, %s, %s) RETURNING * + """, + (source["id"], target["id"], actor), + ).fetchone() + except Exception as exc: + if exc.__class__.__name__ == "UniqueViolation": + raise unprocessable("Dieser Querverweis besteht bereits.") from exc + raise + audit(conn, actor, source["home_scope_id"], "cross_linked", "matter", source["id"], source_context) + return row + + +def delete_cross_link(conn, actor: UUID, link_id: UUID, source_context: Ctx | None) -> None: + link = conn.execute("SELECT * FROM matter_cross_links WHERE id = %s", (link_id,)).fetchone() + if link is None: + raise not_found() + require_matter(conn, actor, link["from_matter_id"], source_context, "edit") + conn.execute("DELETE FROM matter_cross_links WHERE id = %s", (link_id,)) + + +def _actor_rights_for(conn, actor: UUID, kind: str, resource_id: UUID, context: Ctx | None) -> Rights: + if kind == "case": + _row, rights = require_case(conn, actor, resource_id, "read") + return rights + if kind == "matter": + _row, rights = require_matter(conn, actor, resource_id, context, "read") + return rights + if kind == "element": + _row, rights = require_element(conn, actor, resource_id, context, "read") + return rights + if kind == "task": + task = get_task(conn, resource_id) + if task is None: + raise not_found() + rights = task_rights(conn, actor, task, context) + if not rights.read: + raise not_found() + return rights + deadline = get_deadline(conn, resource_id) + if deadline is None: + raise not_found() + rights = deadline_rights(conn, actor, deadline, context) + if not rights.read: + raise not_found() + return rights + + +def grant_access(conn, actor: UUID, kind: str, resource_id: UUID, grantee_id: UUID, can_read: bool, can_edit: bool, can_share: bool, context: Ctx | None) -> dict: + if grantee_id == actor: + raise unprocessable("Die eigene Berechtigung wird nicht als Freigabe gespeichert.") + if not can_read: + raise unprocessable("Eine Freigabe braucht mindestens Lesen.") + if kind == "case": + resource = get_case(conn, resource_id) + rights = case_rights(conn, actor, resource) if resource else Rights() + elif kind == "matter": + resource = get_matter(conn, resource_id) + rights = matter_rights(conn, actor, resource, context) if resource else Rights() + else: + raise unprocessable("Freigaben werden an der Akte oder am Vorgang erteilt.") + if resource is None or not rights.read: + raise not_found() + owner = resource["owner_subject_id"] == actor + if not owner and not rights.share: + raise forbidden() + if can_edit and not (owner or rights.edit): + raise forbidden() + if can_share and not (owner or rights.share): + raise forbidden() + account = conn.execute( + "SELECT id FROM auth_accounts WHERE id = %s AND status = 'active'", + (grantee_id,), + ).fetchone() + if account is None: + raise not_found() + existing = conn.execute( + """ + SELECT id FROM access_grants + WHERE NOT is_exception AND grantee_subject_id = %s + AND resource_kind = %s AND resource_id = %s AND context_kind IS NULL + """, + (grantee_id, kind, resource_id), + ).fetchone() + if existing is None: + row = conn.execute( + """ + INSERT INTO access_grants ( + grantee_subject_id, resource_kind, resource_id, + can_read, can_edit, can_share, can_delete, is_exception, created_by + ) + VALUES (%s, %s, %s, %s, %s, %s, false, false, %s) + RETURNING * + """, + (grantee_id, kind, resource_id, can_read, can_edit, can_share, actor), + ).fetchone() + else: + row = conn.execute( + """ + UPDATE access_grants + SET can_read = %s, can_edit = %s, can_share = %s + WHERE id = %s + RETURNING * + """, + (can_read, can_edit, can_share, existing["id"]), + ).fetchone() + audit(conn, actor, resource["home_scope_id"], "grant_created", kind, resource_id, context) + return row + + +def revoke_grant(conn, actor: UUID, grant_id: UUID) -> None: + grant = conn.execute("SELECT * FROM access_grants WHERE id = %s AND NOT is_exception", (grant_id,)).fetchone() + if grant is None: + raise not_found() + kind = grant["resource_kind"] + if kind == "case": + resource = get_case(conn, grant["resource_id"]) + rights = case_rights(conn, actor, resource) if resource else Rights() + elif kind == "matter": + resource = get_matter(conn, grant["resource_id"]) + rights = matter_rights(conn, actor, resource, None) if resource else Rights() + elif kind == "task": + resource = get_task(conn, grant["resource_id"]) + rights = task_rights(conn, actor, resource, None) if resource else Rights() + elif kind == "deadline": + resource = get_deadline(conn, grant["resource_id"]) + rights = deadline_rights(conn, actor, resource, None) if resource else Rights() + else: + resource = get_element(conn, grant["resource_id"]) + rights = element_rights(conn, actor, resource, None) if resource else Rights() + if resource is None or not rights.read: + raise not_found() + if resource["owner_subject_id"] != actor and not rights.share: + raise forbidden() + conn.execute("DELETE FROM access_grants WHERE id = %s", (grant_id,)) + audit(conn, actor, resource["home_scope_id"], "grant_revoked", kind, grant["resource_id"]) + + +def set_exception(conn, actor: UUID, kind: str, resource_id: UUID, context: Ctx, remove_read: bool, remove_edit: bool, remove_share: bool) -> None: + if kind == "element": + resource = get_element(conn, resource_id) + elif kind == "matter": + resource = get_matter(conn, resource_id) + elif kind == "task": + resource = get_task(conn, resource_id) + else: + resource = get_deadline(conn, resource_id) + if resource is None: + raise not_found() + if resource["owner_subject_id"] != actor: + raise forbidden() + conn.execute( + """ + DELETE FROM access_grants + WHERE is_exception AND grantee_subject_id IS NULL + AND resource_kind = %s AND resource_id = %s + AND context_kind = %s AND context_id = %s + """, + (kind, resource_id, context.kind, context.id), + ) + if remove_read or remove_edit or remove_share: + conn.execute( + """ + INSERT INTO access_grants ( + grantee_subject_id, resource_kind, resource_id, context_kind, context_id, + can_read, can_edit, can_share, can_delete, is_exception, created_by + ) + VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, false, true, %s) + """, + (kind, resource_id, context.kind, context.id, remove_read, remove_edit, remove_share, actor), + ) + + +def _new_element(conn, actor: UUID, scope_id: UUID, title: str, kind: str) -> dict: + return conn.execute( + """ + INSERT INTO elements (home_scope_id, owner_subject_id, created_by, title, kind) + VALUES (%s, %s, %s, %s, %s) RETURNING * + """, + (scope_id, actor, actor, title.strip(), kind), + ).fetchone() + + +def record_dates(conn, actor: UUID, scope_id: UUID, element_id: UUID, context: Ctx, document_on: date | None, sent_on: date | None, received_on: date | None) -> None: + conn.execute( + """ + INSERT INTO correspondence_dates (element_id, document_on, sent_on, received_on) + VALUES (%s, %s, %s, %s) + ON CONFLICT (element_id) DO UPDATE + SET document_on = EXCLUDED.document_on, + sent_on = EXCLUDED.sent_on, + received_on = EXCLUDED.received_on + """, + (element_id, document_on, sent_on, received_on), + ) + if document_on is not None: + audit(conn, actor, scope_id, "correspondence_document", "element", element_id, context, document_on) + if sent_on is not None: + audit(conn, actor, scope_id, "correspondence_sent", "element", element_id, context, sent_on) + if received_on is not None: + audit(conn, actor, scope_id, "correspondence_received", "element", element_id, context, received_on) + audit(conn, actor, scope_id, "correspondence_recorded", "element", element_id, context) + + +def create_note(conn, actor: UUID, scope_id: UUID, title: str, document: dict, context: Ctx, placement: Ctx | None, chapter_id: UUID | None) -> dict: + document = clean_document(document) + target, rights_context = _placement(context, placement) + require_container_edit(conn, actor, target, rights_context) + element = _new_element(conn, actor, scope_id, title, "note") + conn.execute( + "INSERT INTO note_bodies (element_id, document_json, version) VALUES (%s, %s, 1)", + (element["id"], Json(document)), + ) + binding = insert_binding(conn, element["id"], target.kind, target.id, chapter_id, actor) + audit(conn, actor, scope_id, "note_created", "element", element["id"], rights_context or target) + return {"element": element, "binding": binding, "document": document} + + +def update_note(conn, actor: UUID, element_id: UUID, expected: int, document: dict, context: Ctx | None) -> dict: + document = clean_document(document) + element, rights = require_element(conn, actor, element_id, context, "edit") + if element["kind"] != "note": + raise not_found() + if not rights.edit: + raise forbidden() + version = bump_version(conn, "elements", element_id, expected) + conn.execute( + "UPDATE note_bodies SET document_json = %s, version = %s, updated_at = now() WHERE element_id = %s", + (Json(document), version, element_id), + ) + audit(conn, actor, element["home_scope_id"], "note_updated", "element", element_id, context) + element = get_element(conn, element_id) + return {"element": element, "document": document} + + +def bind_element(conn, actor: UUID, element_id: UUID, source: Ctx, target: Ctx, target_context: Ctx | None, chapter_id: UUID | None) -> dict: + _element, source_rights = require_element(conn, actor, element_id, source, "share") + if not source_rights.share: + raise forbidden() + require_container_edit(conn, actor, target, target_context) + binding = insert_binding(conn, element_id, target.kind, target.id, chapter_id, actor) + audit(conn, actor, None, "binding_created", "element", element_id, target_context or target) + return binding + + +def detach_binding(conn, actor: UUID, binding_id: UUID, context: Ctx | None) -> None: + binding = conn.execute("SELECT * FROM bindings WHERE id = %s", (binding_id,)).fetchone() + if binding is None: + raise not_found() + element = get_element(conn, binding["element_id"]) + if element is None: + raise not_found() + action_context = context or Ctx(binding["context_kind"], binding["context_id"]) + _element, rights = require_element(conn, actor, element["id"], action_context, "edit") + if binding["context_kind"] != action_context.kind and not ( + action_context.kind == "case" and binding["context_kind"] == "matter" + ): + raise not_found() + if not rights.edit: + raise forbidden() + conn.execute("DELETE FROM bindings WHERE id = %s", (binding_id,)) + audit(conn, actor, element["home_scope_id"], "binding_removed", "element", element["id"], action_context) + + +def add_annotation(conn, actor: UUID, binding_id: UUID, body: str, context: Ctx | None) -> dict: + binding = conn.execute("SELECT * FROM bindings WHERE id = %s", (binding_id,)).fetchone() + if binding is None: + raise not_found() + element = get_element(conn, binding["element_id"]) + if element is None: + raise not_found() + action_context = context or Ctx(binding["context_kind"], binding["context_id"]) + _element, rights = require_element(conn, actor, element["id"], action_context, "edit") + if not rights.edit: + raise forbidden() + if binding["context_id"] != action_context.id and not ( + action_context.kind == "case" and binding["context_kind"] == "matter" + ): + raise not_found() + row = conn.execute( + """ + INSERT INTO context_annotations (binding_id, body, author_subject_id) + VALUES (%s, %s, %s) RETURNING * + """, + (binding_id, body.strip(), actor), + ).fetchone() + audit(conn, actor, element["home_scope_id"], "annotation_created", "element", element["id"], action_context) + return row + + +def create_external(conn, actor: UUID, scope_id: UUID, title: str, source: str, external_id: str, context: Ctx, placement: Ctx | None, chapter_id: UUID | None, document_on, sent_on, received_on) -> dict: + target, rights_context = _placement(context, placement) + require_container_edit(conn, actor, target, rights_context) + element = _new_element(conn, actor, scope_id, title, "external_ref") + conn.execute( + "INSERT INTO external_references (element_id, source, external_id) VALUES (%s, %s, %s)", + (element["id"], source, external_id.strip()), + ) + binding = insert_binding(conn, element["id"], target.kind, target.id, chapter_id, actor) + record_dates(conn, actor, scope_id, element["id"], rights_context or target, document_on, sent_on, received_on) + audit(conn, actor, scope_id, "external_ref_added", "element", element["id"], rights_context or target) + return element | {"binding_id": binding["id"]} + + +def create_file(conn, actor: UUID, scope_id: UUID, title: str, filename: str, data: bytes, context: Ctx, placement: Ctx | None, chapter_id: UUID | None, document_on, sent_on, received_on, media_root: str, max_bytes: int, rollback_files: list[Path]) -> dict: + if not data or len(data) > max_bytes: + raise unprocessable("Die Datei ist leer oder zu groß.") + content_type = sniff(data) + target, rights_context = _placement(context, placement) + require_container_edit(conn, actor, target, rights_context) + element = _new_element(conn, actor, scope_id, title, "file") + asset_id = uuid4() + path = asset_path(media_root, asset_id) + write_bytes(path, data) + rollback_files.append(path) + conn.execute( + """ + INSERT INTO media_assets ( + id, element_id, owner_subject_id, home_scope_id, original_filename, + content_type, byte_size, sha256, status + ) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, 'active') + """, + ( + asset_id, + element["id"], + actor, + scope_id, + display_filename(filename), + content_type, + len(data), + sha256(data), + ), + ) + conn.execute( + """ + INSERT INTO media_operations (element_id, asset_id, phase, status) + VALUES (%s, %s, 'active', 'committed') + """, + (element["id"], asset_id), + ) + binding = insert_binding(conn, element["id"], target.kind, target.id, chapter_id, actor) + record_dates(conn, actor, scope_id, element["id"], rights_context or target, document_on, sent_on, received_on) + audit(conn, actor, scope_id, "file_added", "element", element["id"], rights_context or target) + return element | {"binding_id": binding["id"], "asset_id": asset_id} + + +def delete_element(conn, actor: UUID, element_id: UUID, expected: int, media_root: str, delete_after: list[Path]) -> None: + element = get_element(conn, element_id) + if element is None or element["owner_subject_id"] != actor: + raise not_found() + bump_version(conn, "elements", element_id, expected) + asset = conn.execute("SELECT * FROM media_assets WHERE element_id = %s", (element_id,)).fetchone() + conn.execute("DELETE FROM bindings WHERE element_id = %s", (element_id,)) + conn.execute( + "UPDATE elements SET deleted_at = now(), updated_at = now() WHERE id = %s", + (element_id,), + ) + if asset is not None and asset["status"] == "active": + conn.execute("UPDATE media_assets SET status = 'purging' WHERE id = %s", (asset["id"],)) + delete_after.append(asset_path(media_root, asset["id"])) + conn.execute("UPDATE media_assets SET status = 'purged' WHERE id = %s", (asset["id"],)) + audit(conn, actor, element["home_scope_id"], "element_deleted", "element", element_id) + + +def create_task(conn, actor: UUID, scope_id: UUID, title: str, due_on: date | None, matter_id: UUID | None, context: Ctx | None) -> dict: + if matter_id is not None: + require_matter(conn, actor, matter_id, context, "edit") + row = conn.execute( + """ + INSERT INTO tasks ( + home_scope_id, owner_subject_id, created_by, title, matter_id, due_on + ) + VALUES (%s, %s, %s, %s, %s, %s) RETURNING * + """, + (scope_id, actor, actor, title.strip(), matter_id, due_on), + ).fetchone() + audit(conn, actor, scope_id, "task_created", "task", row["id"], context) + return row + + +def patch_task(conn, actor: UUID, task_id: UUID, expected: int, title: str | None, due_on: date | None, clear_due: bool, status: str | None, context: Ctx | None) -> dict: + task = get_task(conn, task_id) + if task is None: + raise not_found() + rights = task_rights(conn, actor, task, context) + if not rights.read: + raise not_found() + structural = title is not None or due_on is not None or clear_due + if structural and not rights.edit: + raise forbidden() + if status is not None and not can_change_status(actor, task, rights): + raise forbidden() + if title is None and due_on is None and not clear_due and status is None: + raise unprocessable("Es fehlt eine Änderung.") + bump_version(conn, "tasks", task_id, expected) + if title is not None: + conn.execute("UPDATE tasks SET title = %s WHERE id = %s", (title.strip(), task_id)) + if clear_due: + conn.execute("UPDATE tasks SET due_on = NULL WHERE id = %s", (task_id,)) + elif due_on is not None: + conn.execute("UPDATE tasks SET due_on = %s WHERE id = %s", (due_on, task_id)) + if status is not None: + conn.execute("UPDATE tasks SET task_status = %s WHERE id = %s", (status, task_id)) + audit( + conn, + actor, + task["home_scope_id"], + "task_done" if status == "done" else "task_reopened", + "task", + task_id, + context, + ) + return get_task(conn, task_id) + + +def assign_task(conn, actor: UUID, task_id: UUID, assignee_id: UUID | None, context: Ctx | None) -> dict: + task = get_task(conn, task_id) + if task is None: + raise not_found() + rights = task_rights(conn, actor, task, context) + if not rights.read: + raise not_found() + if task["owner_subject_id"] != actor and not rights.share: + raise forbidden() + if assignee_id is not None: + account = conn.execute( + "SELECT id FROM auth_accounts WHERE id = %s AND status = 'active'", + (assignee_id,), + ).fetchone() + if account is None: + raise not_found() + existing = conn.execute( + """ + SELECT * FROM access_grants + WHERE NOT is_exception AND grantee_subject_id = %s + AND resource_kind = 'task' AND resource_id = %s AND context_kind IS NULL + """, + (assignee_id, task_id), + ).fetchone() + if existing is None: + conn.execute( + """ + INSERT INTO access_grants ( + grantee_subject_id, resource_kind, resource_id, + can_read, can_edit, can_share, can_delete, is_exception, created_by + ) + VALUES (%s, 'task', %s, true, false, false, false, false, %s) + """, + (assignee_id, task_id, actor), + ) + elif not existing["can_read"]: + conn.execute("UPDATE access_grants SET can_read = true WHERE id = %s", (existing["id"],)) + elif task["assignee_subject_id"] is not None: + conn.execute( + """ + DELETE FROM access_grants + WHERE NOT is_exception AND grantee_subject_id = %s + AND resource_kind = 'task' AND resource_id = %s + AND context_kind IS NULL AND can_read AND NOT can_edit AND NOT can_share AND NOT can_delete + """, + (task["assignee_subject_id"], task_id), + ) + conn.execute( + "UPDATE tasks SET assignee_subject_id = %s, updated_at = now() WHERE id = %s", + (assignee_id, task_id), + ) + return get_task(conn, task_id) + + +def create_deadline(conn, actor: UUID, scope_id: UUID, title: str, due_on: date, matter_id: UUID | None, context: Ctx | None) -> dict: + if matter_id is not None: + require_matter(conn, actor, matter_id, context, "edit") + row = conn.execute( + """ + INSERT INTO deadlines ( + home_scope_id, owner_subject_id, created_by, title, matter_id, due_on + ) + VALUES (%s, %s, %s, %s, %s, %s) RETURNING * + """, + (scope_id, actor, actor, title.strip(), matter_id, due_on), + ).fetchone() + audit(conn, actor, scope_id, "deadline_created", "deadline", row["id"], context) + return row + + +def patch_deadline(conn, actor: UUID, deadline_id: UUID, expected: int, title: str | None, due_on: date | None, context: Ctx | None) -> dict: + deadline = get_deadline(conn, deadline_id) + if deadline is None: + raise not_found() + rights = deadline_rights(conn, actor, deadline, context) + if not rights.read: + raise not_found() + if not rights.edit: + raise forbidden() + if title is None and due_on is None: + raise unprocessable("Es fehlt eine Änderung.") + bump_version(conn, "deadlines", deadline_id, expected) + if title is not None: + conn.execute("UPDATE deadlines SET title = %s WHERE id = %s", (title.strip(), deadline_id)) + if due_on is not None: + conn.execute("UPDATE deadlines SET due_on = %s WHERE id = %s", (due_on, deadline_id)) + return get_deadline(conn, deadline_id) + + +def fulfill_deadline(conn, actor: UUID, deadline_id: UUID, expected: int, context: Ctx | None) -> dict: + deadline = get_deadline(conn, deadline_id) + if deadline is None: + raise not_found() + rights = deadline_rights(conn, actor, deadline, context) + if not rights.read: + raise not_found() + if not can_change_status(actor, deadline, rights): + raise forbidden() + bump_version(conn, "deadlines", deadline_id, expected) + conn.execute( + """ + UPDATE deadlines + SET deadline_status = 'fulfilled', fulfilled_at = %s, updated_at = now() + WHERE id = %s + """, + (utcnow(), deadline_id), + ) + audit(conn, actor, deadline["home_scope_id"], "deadline_fulfilled", "deadline", deadline_id, context) + return get_deadline(conn, deadline_id) + + +def link_task_deadline(conn, actor: UUID, task_id: UUID, deadline_id: UUID, context: Ctx | None) -> None: + task = get_task(conn, task_id) + deadline = get_deadline(conn, deadline_id) + if task is None or deadline is None: + raise not_found() + task_right = task_rights(conn, actor, task, context) + deadline_right = deadline_rights(conn, actor, deadline, context) + if not task_right.read or not deadline_right.read: + raise not_found() + if not task_right.edit: + raise forbidden() + conn.execute( + """ + INSERT INTO task_deadline_links (task_id, deadline_id, created_by) + VALUES (%s, %s, %s) + ON CONFLICT DO NOTHING + """, + (task_id, deadline_id, actor), + ) diff --git a/backend/app/present.py b/backend/app/present.py new file mode 100644 index 0000000..23cff0a --- /dev/null +++ b/backend/app/present.py @@ -0,0 +1,490 @@ +"""Response shapes. Hidden objects are omitted, not counted and not titled.""" + +from __future__ import annotations + +from uuid import UUID + +from app.access.policy import ( + Ctx, + case_rights, + deadline_rights, + display_name, + element_rights, + get_case, + get_element, + get_matter, + matter_rights, + matter_title_if_readable, + readable_matter_contexts, + room_name, + task_rights, + visible_bindings_for_element, +) +from app.access.policy import SHARED_NOTICE +from app.core.timeutil import dump_date, dump_dt + + +def rights_dict(rights) -> dict: + return rights.as_dict() + + +def _chapters(conn, kind: str, container_id: UUID) -> list[dict]: + column = "case_id" if kind == "case" else "matter_id" + rows = conn.execute( + f"SELECT id, title, position FROM chapters WHERE {column} = %s ORDER BY position, created_at", + (container_id,), + ).fetchall() + return [{"id": str(row["id"]), "title": row["title"], "position": row["position"]} for row in rows] + + +def _annotations(conn, binding_id: UUID) -> list[dict]: + rows = conn.execute( + """ + SELECT a.id, a.body, a.created_at, p.display_name + FROM context_annotations a + JOIN auth_accounts p ON p.id = a.author_subject_id + WHERE a.binding_id = %s + ORDER BY a.created_at, a.id + """, + (binding_id,), + ).fetchall() + return [ + { + "id": str(row["id"]), + "body": row["body"], + "author_display_name": row["display_name"], + "created_at": dump_dt(row["created_at"]), + } + for row in rows + ] + + +def _dates(conn, element: dict) -> dict: + row = conn.execute( + "SELECT document_on, sent_on, received_on FROM correspondence_dates WHERE element_id = %s", + (element["id"],), + ).fetchone() + return { + "document_on": dump_date(row["document_on"]) if row else None, + "sent_on": dump_date(row["sent_on"]) if row else None, + "received_on": dump_date(row["received_on"]) if row else None, + "recorded_at": dump_dt(element["created_at"]), + } + + +def _element_body(conn, element: dict) -> dict: + payload = { + "id": str(element["id"]), + "kind": element["kind"], + "title": element["title"], + "version": element["version"], + "owner_subject_id": str(element["owner_subject_id"]), + "dates": _dates(conn, element), + } + if element["kind"] == "note": + body = conn.execute( + "SELECT document_json FROM note_bodies WHERE element_id = %s", + (element["id"],), + ).fetchone() + payload["document"] = body["document_json"] if body else {"version": 1, "blocks": []} + elif element["kind"] == "file": + asset = conn.execute( + """ + SELECT original_filename, content_type, byte_size, status + FROM media_assets WHERE element_id = %s + """, + (element["id"],), + ).fetchone() + if asset is not None: + payload["file"] = { + "filename": asset["original_filename"], + "content_type": asset["content_type"], + "byte_size": asset["byte_size"], + "status": asset["status"], + } + elif element["kind"] == "external_ref": + ref = conn.execute( + "SELECT source, external_id FROM external_references WHERE element_id = %s", + (element["id"],), + ).fetchone() + if ref is not None: + payload["external"] = {"source": ref["source"], "external_id": ref["external_id"]} + return payload + + +def _exception(conn, kind: str, resource_id: UUID, context: Ctx | None) -> dict | None: + if context is None: + return None + row = conn.execute( + """ + SELECT can_read, can_edit, can_share + FROM access_grants + WHERE is_exception AND grantee_subject_id IS NULL + AND resource_kind = %s AND resource_id = %s + AND context_kind = %s AND context_id = %s + """, + (kind, resource_id, context.kind, context.id), + ).fetchone() + if row is None: + return {"remove_read": False, "remove_edit": False, "remove_share": False} + return {"remove_read": row["can_read"], "remove_edit": row["can_edit"], "remove_share": row["can_share"]} + + +def binding_payload(conn, actor: UUID, binding: dict, context: Ctx) -> dict | None: + element = get_element(conn, binding["element_id"]) + if element is None: + return None + rights = element_rights(conn, actor, element, context) + if not rights.read: + return None + payload = { + "id": str(binding["id"]), + "position": binding["position"], + "chapter_id": str(binding["chapter_id"]) if binding["chapter_id"] else None, + "rights": rights.as_dict(), + "annotations": _annotations(conn, binding["id"]), + "element": _element_body(conn, element), + } + if element["owner_subject_id"] == actor: + payload["exception"] = _exception(conn, "element", element["id"], context) + return payload + + +def _grants(conn, kind: str, resource_id: UUID) -> list[dict]: + rows = conn.execute( + """ + SELECT g.id, g.grantee_subject_id, g.can_read, g.can_edit, g.can_share, a.email, a.display_name + FROM access_grants g + JOIN auth_accounts a ON a.id = g.grantee_subject_id + WHERE NOT g.is_exception AND g.resource_kind = %s AND g.resource_id = %s AND g.context_kind IS NULL + ORDER BY a.display_name, g.id + """, + (kind, resource_id), + ).fetchall() + return [ + { + "id": str(row["id"]), + "grantee_subject_id": str(row["grantee_subject_id"]), + "email": row["email"], + "display_name": row["display_name"], + "can_read": row["can_read"], + "can_edit": row["can_edit"], + "can_share": row["can_share"], + } + for row in rows + ] + + +def case_summary(case: dict, rights) -> dict: + return { + "id": str(case["id"]), + "title": case["title"], + "status": case["record_status"], + "version": case["version"], + "rights_mode": case["rights_mode"], + "parent_case_id": str(case["parent_case_id"]) if case["parent_case_id"] else None, + "home_scope_id": str(case["home_scope_id"]), + "rights": rights.as_dict(), + } + + +def case_detail(conn, actor: UUID, case: dict, rights) -> dict: + payload = case_summary(case, rights) + payload["home_scope_name"] = room_name(conn, case["home_scope_id"]) + payload["is_owner"] = case["owner_subject_id"] == actor + payload["chapters"] = _chapters(conn, "case", case["id"]) + subcases = [] + for row in conn.execute( + """ + SELECT * FROM cases + WHERE parent_case_id = %s AND deleted_at IS NULL + ORDER BY title, id + """, + (case["id"],), + ).fetchall(): + child_rights = case_rights(conn, actor, row) + if child_rights.read: + subcases.append(case_summary(row, child_rights)) + payload["subcases"] = subcases + matters = [] + for link in conn.execute( + """ + SELECT l.id AS link_id, m.* + FROM matter_case_links l + JOIN matters m ON m.id = l.matter_id + WHERE l.case_id = %s AND m.deleted_at IS NULL + ORDER BY m.title, m.id + """, + (case["id"],), + ).fetchall(): + matter_right = matter_rights(conn, actor, link, Ctx("case", case["id"])) + if not matter_right.read: + continue + matters.append( + { + "id": str(link["id"]), + "link_id": str(link["link_id"]), + "title": link["title"], + "status": link["record_status"], + } + ) + payload["matters"] = matters + context = Ctx("case", case["id"]) + bindings = [] + for binding in conn.execute( + """ + SELECT * FROM bindings + WHERE context_kind = 'case' AND context_id = %s + ORDER BY position, created_at + """, + (case["id"],), + ).fetchall(): + item = binding_payload(conn, actor, binding, context) + if item is not None: + bindings.append(item) + payload["bindings"] = bindings + if rights.share or case["owner_subject_id"] == actor: + payload["grants"] = _grants(conn, "case", case["id"]) + return payload + + +def matter_contexts(conn, actor: UUID, matter: dict) -> list[dict]: + contexts = [] + for item in readable_matter_contexts(conn, actor, matter): + kind = "direct" if item["kind"] == "matter" and item["id"] == str(matter["id"]) else item["kind"] + contexts.append({"kind": kind, "id": item["id"], "title": item["title"]}) + return contexts + + +def matter_summary(conn, actor: UUID, matter: dict) -> dict: + return { + "id": str(matter["id"]), + "title": matter["title"], + "status": matter["record_status"], + "version": matter["version"], + "parent_matter_id": str(matter["parent_matter_id"]) if matter["parent_matter_id"] else None, + "home_scope_id": str(matter["home_scope_id"]), + "contexts": matter_contexts(conn, actor, matter), + } + + +def _page_context(matter_id: UUID, context: Ctx | None) -> Ctx: + if context is None: + return Ctx("matter", matter_id) + return context + + +def matter_detail(conn, actor: UUID, matter: dict, rights, context: Ctx | None) -> dict: + page = _page_context(matter["id"], context) + payload = { + "id": str(matter["id"]), + "title": matter["title"], + "status": matter["record_status"], + "version": matter["version"], + "parent_matter_id": str(matter["parent_matter_id"]) if matter["parent_matter_id"] else None, + "home_scope_id": str(matter["home_scope_id"]), + "home_scope_name": room_name(conn, matter["home_scope_id"]), + "is_owner": matter["owner_subject_id"] == actor, + "rights": rights.as_dict(), + "context": None if context is None else context.as_dict(), + "chapters": _chapters(conn, "matter", matter["id"]), + } + submatters = [] + for child in conn.execute( + "SELECT * FROM matters WHERE parent_matter_id = %s AND deleted_at IS NULL ORDER BY title, id", + (matter["id"],), + ).fetchall(): + child_rights = matter_rights(conn, actor, child, page) + if child_rights.read: + submatters.append({"id": str(child["id"]), "title": child["title"], "status": child["record_status"]}) + payload["submatters"] = submatters + case_links = [] + for link in conn.execute( + """ + SELECT l.id, l.case_id, c.title + FROM matter_case_links l + JOIN cases c ON c.id = l.case_id AND c.deleted_at IS NULL + WHERE l.matter_id = %s + ORDER BY c.title, c.id + """, + (matter["id"],), + ).fetchall(): + linked_case = get_case(conn, link["case_id"]) + if linked_case is not None and case_rights(conn, actor, linked_case).read: + case_links.append({"id": str(link["id"]), "case_id": str(link["case_id"]), "title": link["title"]}) + payload["case_links"] = case_links + crosses = [] + for link in conn.execute( + """ + SELECT l.id, l.to_matter_id + FROM matter_cross_links l + WHERE l.from_matter_id = %s + """, + (matter["id"],), + ).fetchall(): + title = matter_title_if_readable(conn, actor, link["to_matter_id"]) + if title is not None: + crosses.append({"id": str(link["id"]), "matter_id": str(link["to_matter_id"]), "title": title}) + payload["cross_links"] = crosses + bindings = [] + for binding in conn.execute( + """ + SELECT * FROM bindings + WHERE context_kind = 'matter' AND context_id = %s + ORDER BY position, created_at + """, + (matter["id"],), + ).fetchall(): + item = binding_payload(conn, actor, binding, page) + if item is not None: + bindings.append(item) + payload["bindings"] = bindings + payload["tasks"] = [] + for task in conn.execute( + """ + SELECT * FROM tasks + WHERE matter_id = %s AND deleted_at IS NULL + ORDER BY due_on NULLS LAST, created_at + """, + (matter["id"],), + ).fetchall(): + task_right = task_rights(conn, actor, task, context) + if task_right.read: + payload["tasks"].append(task_payload(conn, actor, task, task_right)) + payload["deadlines"] = [] + visible_deadlines = set() + for deadline in conn.execute( + """ + SELECT * FROM deadlines + WHERE matter_id = %s AND deleted_at IS NULL + ORDER BY due_on, created_at + """, + (matter["id"],), + ).fetchall(): + deadline_right = deadline_rights(conn, actor, deadline, context) + if deadline_right.read: + payload["deadlines"].append(deadline_payload(conn, actor, deadline)) + visible_deadlines.add(deadline["id"]) + visible_tasks = {UUID(item["id"]) for item in payload["tasks"]} + links = [] + if visible_tasks and visible_deadlines: + for link in conn.execute( + "SELECT task_id, deadline_id FROM task_deadline_links WHERE task_id = ANY(%s::uuid[])", + (list(visible_tasks),), + ).fetchall(): + if link["deadline_id"] in visible_deadlines: + links.append({"task_id": str(link["task_id"]), "deadline_id": str(link["deadline_id"])}) + payload["task_deadline_links"] = links + if rights.share or matter["owner_subject_id"] == actor: + payload["grants"] = _grants(conn, "matter", matter["id"]) + if matter["owner_subject_id"] == actor: + payload["exception"] = _exception(conn, "matter", matter["id"], context) + return payload + + +def task_payload(conn, actor: UUID, task: dict, rights=None) -> dict: + payload = { + "id": str(task["id"]), + "title": task["title"], + "status": task["task_status"], + "version": task["version"], + "due_on": dump_date(task["due_on"]), + "assignee_display_name": display_name(conn, task["assignee_subject_id"]), + } + if rights is not None: + payload["rights"] = rights.as_dict() + title = matter_title_if_readable(conn, actor, task["matter_id"]) + if title is not None and task["matter_id"] is not None: + payload["matter_id"] = str(task["matter_id"]) + payload["matter_title"] = title + action = _task_action_context(conn, actor, task) + if action is not None: + payload["action_context"] = action + return payload + + +def _task_action_context(conn, actor: UUID, task: dict) -> dict | None: + direct = task_rights(conn, actor, task, None) + if direct.read and (direct.edit or task["owner_subject_id"] == actor or task["assignee_subject_id"] == actor): + return None + if task["matter_id"] is None: + return None + matter = get_matter(conn, task["matter_id"]) + if matter is None: + return None + for item in readable_matter_contexts(conn, actor, matter): + if item["kind"] != "case": + continue + rights = task_rights(conn, actor, task, Ctx("case", UUID(item["id"]))) + if rights.edit or (rights.read and task["assignee_subject_id"] == actor): + return {"kind": "case", "id": item["id"]} + return None + + +def deadline_payload(conn, actor: UUID, deadline: dict) -> dict: + payload = { + "id": str(deadline["id"]), + "title": deadline["title"], + "status": deadline["deadline_status"], + "version": deadline["version"], + "due_on": dump_date(deadline["due_on"]), + "fulfilled_at": dump_dt(deadline["fulfilled_at"]), + "assignee_display_name": display_name(conn, deadline["assignee_subject_id"]), + } + title = matter_title_if_readable(conn, actor, deadline["matter_id"]) + if title is not None and deadline["matter_id"] is not None: + payload["matter_id"] = str(deadline["matter_id"]) + payload["matter_title"] = title + direct = deadline_rights(conn, actor, deadline, None) + if not (direct.read and (direct.edit or deadline["owner_subject_id"] == actor or deadline["assignee_subject_id"] == actor)): + if deadline["matter_id"] is not None: + matter = get_matter(conn, deadline["matter_id"]) + if matter is not None: + for item in readable_matter_contexts(conn, actor, matter): + if item["kind"] != "case": + continue + rights = deadline_rights(conn, actor, deadline, Ctx("case", UUID(item["id"]))) + if rights.edit or (rights.read and deadline["assignee_subject_id"] == actor): + payload["action_context"] = {"kind": "case", "id": item["id"]} + break + return payload + + +def note_update_payload(conn, actor: UUID, element: dict, document: dict) -> dict: + return { + "id": str(element["id"]), + "title": element["title"], + "version": element["version"], + "document": document, + "visible_bindings": visible_bindings_for_element(conn, actor, element), + "notice": SHARED_NOTICE, + } + + +LABELS = { + "case_created": "Akte angelegt", + "matter_created": "Vorgang angelegt", + "matter_linked": "Vorgang einer Akte zugeordnet", + "matter_unlinked": "Aktenzuordnung gelöst", + "cross_linked": "Querverweis erfasst", + "note_created": "Notiz angelegt", + "note_updated": "Gemeinsamer Notizinhalt geändert", + "annotation_created": "Kontextbezogene Anmerkung erfasst", + "file_added": "Datei hinzugefügt", + "external_ref_added": "Externe Referenz erfasst", + "binding_created": "Einbindung ergänzt", + "binding_removed": "Einbindung entfernt", + "element_deleted": "Element gelöscht", + "task_created": "Aufgabe angelegt", + "task_done": "Aufgabe erledigt", + "task_reopened": "Aufgabe wieder geöffnet", + "deadline_created": "Frist erfasst", + "deadline_fulfilled": "Frist erfüllt", + "grant_created": "Freigabe erteilt", + "grant_revoked": "Freigabe entzogen", + "correspondence_document": "Dokumentdatum", + "correspondence_sent": "Versand", + "correspondence_received": "Zugang", + "correspondence_recorded": "Erfassung", + "chapter_created": "Kapitel angelegt", +} diff --git a/backend/app/seed.py b/backend/app/seed.py new file mode 100644 index 0000000..99b2fd7 --- /dev/null +++ b/backend/app/seed.py @@ -0,0 +1,211 @@ +"""Synthetic development accounts and a rental matter. Never runs in production.""" + +from __future__ import annotations + +from datetime import date +from pathlib import Path + +import psycopg +from psycopg.rows import dict_row + +from app.access.policy import Ctx +from app.auth.accounts import create_account +from app.core.errors import not_found +from app.core.settings import Settings, get_settings +from app.ops import ( + add_annotation, + assign_task, + bind_element, + create_case, + create_chapter, + create_deadline, + create_external, + create_file, + create_matter, + create_note, + create_task, + grant_access, + link_matter_to_case, + link_task_deadline, +) + +ADA_EMAIL = "ada@example.test" +BEN_EMAIL = "ben@example.test" +ADA_PASSWORD = "Beispiel-Ada-2026" +BEN_PASSWORD = "Beispiel-Ben-2026" + +SAMPLE_PDF = b"""%PDF-1.1 +1 0 obj<>endobj +2 0 obj<>endobj +3 0 obj<>endobj +4 0 obj<>stream +BT /F1 12 Tf 40 90 Td (Mietschreiben Beispiel) Tj ET +endstream +endobj +trailer<> +%%EOF +""" + + +def demo_public(settings: Settings) -> dict: + if settings.tsumugu_env != "development" or not settings.seed_demo: + raise not_found() + return { + "accounts": [ + {"email": ADA_EMAIL, "password": ADA_PASSWORD, "display_name": "Ada Beispiel"}, + {"email": BEN_EMAIL, "password": BEN_PASSWORD, "display_name": "Ben Beispiel"}, + ] + } + + +def seed_demo(settings: Settings | None = None) -> bool: + settings = settings or get_settings() + if settings.tsumugu_env != "development" or not settings.seed_demo: + return False + cleanup: list[Path] = [] + with psycopg.connect(settings.dsn(), row_factory=dict_row) as conn: + try: + if conn.execute("SELECT 1 FROM auth_accounts WHERE email = %s", (ADA_EMAIL,)).fetchone(): + return False + ada = create_account(conn, ADA_EMAIL, "Ada Beispiel", ADA_PASSWORD) + ben = create_account(conn, BEN_EMAIL, "Ben Beispiel", BEN_PASSWORD) + room = conn.execute( + """ + INSERT INTO data_rooms (id, kind, name, created_by) + VALUES (gen_random_uuid(), 'organization', 'Haushalt Musterstraße', %s) + RETURNING id + """, + (ada["id"],), + ).fetchone() + conn.execute( + "INSERT INTO room_memberships (room_id, subject_id, role) VALUES (%s, %s, 'manager'), (%s, %s, 'member')", + (room["id"], ada["id"], room["id"], ben["id"]), + ) + private_case = create_case(conn, ada["id"], ada["id"], "Persönliche Verhandlungsstrategie", None, "explicit") + shared_case = create_case(conn, ada["id"], ada["id"], "Mietstreit Musterstraße 12", None, "explicit") + grant_access(conn, ada["id"], "case", shared_case["id"], ben["id"], True, True, False, None) + strategy = create_matter(conn, ada["id"], ada["id"], "Interne Verhandlungsstrategie", None, None) + moisture = create_matter(conn, ada["id"], ada["id"], "Mängelanzeige Feuchtigkeit", None, None) + link_matter_to_case(conn, ada["id"], moisture["id"], shared_case["id"], None) + link_matter_to_case(conn, ada["id"], strategy["id"], private_case["id"], None) + note = create_note( + conn, + ada["id"], + ada["id"], + "Gespräch mit der Hausverwaltung", + { + "version": 1, + "blocks": [ + { + "type": "paragraph", + "text": ( + "Am 1. Oktober die Feuchtigkeit im Schlafzimmer angezeigt. " + "Die Verwaltung will bis Ende November antworten." + ), + } + ], + }, + Ctx("case", shared_case["id"]), + None, + None, + ) + matter_binding = bind_element( + conn, + ada["id"], + note["element"]["id"], + Ctx("case", shared_case["id"]), + Ctx("matter", moisture["id"]), + None, + None, + ) + add_annotation( + conn, + ada["id"], + note["binding"]["id"], + "Nur in der Akte: Original im blauen Ordner.", + Ctx("case", shared_case["id"]), + ) + add_annotation( + conn, + ada["id"], + matter_binding["id"], + "Nur in diesem Vorgang: Zeugin Frau Keller erinnern.", + Ctx("matter", moisture["id"]), + ) + create_note( + conn, + ada["id"], + ada["id"], + "Nicht weitergeben", + { + "version": 1, + "blocks": [ + { + "type": "paragraph", + "text": "Vergleich nur anbieten, wenn die Gegenseite zuerst einen Betrag nennt.", + } + ], + }, + Ctx("case", private_case["id"]), + None, + None, + ) + chapter = create_chapter(conn, ada["id"], "matter", moisture["id"], "Schriftwechsel", 0, None) + create_file( + conn, + ada["id"], + ada["id"], + "Schreiben an die Hausverwaltung", + "Schreiben-Hausverwaltung.pdf", + SAMPLE_PDF, + Ctx("matter", moisture["id"]), + None, + chapter["id"], + date(2026, 10, 1), + date(2026, 10, 2), + None, + settings.media_root, + settings.upload_max_bytes, + cleanup, + ) + create_external( + conn, + ada["id"], + ada["id"], + "Antwort der Hausverwaltung", + "paperless", + "4821", + Ctx("matter", moisture["id"]), + None, + chapter["id"], + date(2026, 10, 8), + None, + date(2026, 10, 10), + ) + task = create_task( + conn, + ada["id"], + ada["id"], + "Unterlagen für die Antwort zusammenstellen", + date(2026, 11, 25), + moisture["id"], + None, + ) + assign_task(conn, ada["id"], task["id"], ben["id"], None) + deadline = create_deadline( + conn, + ada["id"], + ada["id"], + "Antwort an die Gegenseite", + date(2026, 11, 30), + moisture["id"], + None, + ) + link_task_deadline(conn, ada["id"], task["id"], deadline["id"], None) + conn.commit() + return True + except Exception: + conn.rollback() + for path in cleanup: + path.unlink(missing_ok=True) + raise diff --git a/backend/main.py b/backend/main.py index bb188a6..ac4b385 100644 --- a/backend/main.py +++ b/backend/main.py @@ -1,42 +1,5 @@ -"""Tsumugu — schmales Startgerüst, damit der Pi-Deploy einen Health-Check hat.""" +"""Uvicorn entry: `uvicorn main:app`.""" -from __future__ import annotations +from app.main import app -import os - -import psycopg2 -from fastapi import FastAPI -from fastapi.responses import JSONResponse - -app = FastAPI(title="Tsumugu", docs_url=None, redoc_url=None) - - -def _database_status() -> str: - try: - connection = psycopg2.connect( - host=os.environ.get("DB_HOST", "postgres"), - port=os.environ.get("DB_PORT", "5432"), - dbname=os.environ.get("DB_NAME", "tsumugu"), - user=os.environ.get("DB_USER", "tsumugu"), - password=os.environ.get("DB_PASSWORD", ""), - connect_timeout=3, - ) - connection.close() - except Exception: - return "error" - return "ok" - - -@app.get("/api/health") -def api_health(): - database = _database_status() - status = "ok" if database == "ok" else "degraded" - return JSONResponse( - status_code=200 if database == "ok" else 503, - content={ - "status": status, - "app": "tsumugu", - "env": os.environ.get("TSUMUGU_ENV", "development"), - "db": database, - }, - ) +__all__ = ["app"] diff --git a/backend/migrations/20261016T210000Z_foundation.sql b/backend/migrations/20261016T210000Z_foundation.sql new file mode 100644 index 0000000..bbfe4a4 --- /dev/null +++ b/backend/migrations/20261016T210000Z_foundation.sql @@ -0,0 +1,356 @@ +-- Erster Fachschnitt: Identität, Struktur, Inhalte, Nachverfolgung, eigene Dateien. +-- Finanz-, Zusammenstellungs- und Paperless-Abgleichstabellen gehören nicht in diese Lieferung. + +CREATE TABLE auth_accounts ( + id uuid PRIMARY KEY, + email text NOT NULL UNIQUE, + display_name text NOT NULL, + password_hash text NOT NULL, + status text NOT NULL DEFAULT 'active', + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT auth_accounts_status CHECK (status IN ('active', 'disabled')), + CONSTRAINT auth_accounts_email_len CHECK (char_length(email) <= 320), + CONSTRAINT auth_accounts_name_len CHECK (char_length(display_name) BETWEEN 1 AND 120) +); + +CREATE TABLE data_rooms ( + id uuid PRIMARY KEY, + kind text NOT NULL, + name text NOT NULL, + status text NOT NULL DEFAULT 'active', + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT data_rooms_kind CHECK (kind IN ('personal', 'organization')), + CONSTRAINT data_rooms_status CHECK (status IN ('active', 'archived')), + CONSTRAINT data_rooms_name_len CHECK (char_length(name) BETWEEN 1 AND 160) +); + +CREATE TABLE auth_sessions ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + account_id uuid NOT NULL REFERENCES auth_accounts (id), + secret_hash text NOT NULL UNIQUE, + csrf_token text NOT NULL, + scope_kind text NOT NULL, + scope_id uuid NOT NULL REFERENCES data_rooms (id), + epoch integer NOT NULL DEFAULT 1, + expires_at timestamptz NOT NULL, + revoked_at timestamptz, + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT auth_sessions_scope_kind CHECK (scope_kind IN ('personal', 'organization')) +); + +CREATE INDEX auth_sessions_account ON auth_sessions (account_id); + +CREATE TABLE auth_invitations ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + email text NOT NULL, + room_id uuid NOT NULL REFERENCES data_rooms (id), + token_hash text NOT NULL UNIQUE, + invited_by uuid NOT NULL REFERENCES auth_accounts (id), + expires_at timestamptz NOT NULL, + accepted_at timestamptz, + created_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE room_memberships ( + room_id uuid NOT NULL REFERENCES data_rooms (id), + subject_id uuid NOT NULL REFERENCES auth_accounts (id), + role text NOT NULL, + status text NOT NULL DEFAULT 'active', + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (room_id, subject_id), + CONSTRAINT room_memberships_role CHECK (role IN ('member', 'manager')), + CONSTRAINT room_memberships_status CHECK (status IN ('active', 'removed')) +); + +CREATE TABLE cases ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + version integer NOT NULL DEFAULT 1, + title text NOT NULL, + parent_case_id uuid, + rights_mode text NOT NULL DEFAULT 'explicit', + record_status text NOT NULL DEFAULT 'open', + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + deleted_at timestamptz, + CONSTRAINT cases_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT cases_rights_mode CHECK (rights_mode IN ('inherit_parent', 'explicit')), + CONSTRAINT cases_status CHECK (record_status IN ('open', 'closed')), + CONSTRAINT cases_root_explicit CHECK ( + (parent_case_id IS NULL AND rights_mode = 'explicit') + OR parent_case_id IS NOT NULL + ), + UNIQUE (id, home_scope_id) +); + +ALTER TABLE cases + ADD CONSTRAINT cases_parent_same_scope + FOREIGN KEY (parent_case_id, home_scope_id) REFERENCES cases (id, home_scope_id); + +CREATE INDEX cases_owner ON cases (owner_subject_id) WHERE deleted_at IS NULL; +CREATE INDEX cases_home ON cases (home_scope_id) WHERE deleted_at IS NULL; + +CREATE TABLE matters ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + version integer NOT NULL DEFAULT 1, + title text NOT NULL, + parent_matter_id uuid, + record_status text NOT NULL DEFAULT 'open', + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + deleted_at timestamptz, + CONSTRAINT matters_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT matters_status CHECK (record_status IN ('open', 'closed')), + UNIQUE (id, home_scope_id) +); + +ALTER TABLE matters + ADD CONSTRAINT matters_parent_same_scope + FOREIGN KEY (parent_matter_id, home_scope_id) REFERENCES matters (id, home_scope_id); + +CREATE INDEX matters_owner ON matters (owner_subject_id) WHERE deleted_at IS NULL; + +CREATE TABLE chapters ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + case_id uuid, + matter_id uuid, + title text NOT NULL, + position integer NOT NULL DEFAULT 0, + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT chapters_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT chapters_one_container CHECK ((case_id IS NULL) <> (matter_id IS NULL)) +); + +ALTER TABLE chapters + ADD CONSTRAINT chapters_case_same_scope + FOREIGN KEY (case_id, home_scope_id) REFERENCES cases (id, home_scope_id); + +ALTER TABLE chapters + ADD CONSTRAINT chapters_matter_same_scope + FOREIGN KEY (matter_id, home_scope_id) REFERENCES matters (id, home_scope_id); + +CREATE TABLE matter_case_links ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + matter_id uuid NOT NULL REFERENCES matters (id), + case_id uuid NOT NULL REFERENCES cases (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + UNIQUE (matter_id, case_id) +); + +CREATE INDEX matter_case_links_case ON matter_case_links (case_id); + +CREATE TABLE case_link_blocks ( + link_id uuid NOT NULL REFERENCES matter_case_links (id) ON DELETE CASCADE, + element_id uuid NOT NULL, + PRIMARY KEY (link_id, element_id) +); + +CREATE TABLE matter_cross_links ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + from_matter_id uuid NOT NULL REFERENCES matters (id), + to_matter_id uuid NOT NULL REFERENCES matters (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + UNIQUE (from_matter_id, to_matter_id), + CONSTRAINT matter_cross_links_distinct CHECK (from_matter_id <> to_matter_id) +); + +CREATE TABLE elements ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + version integer NOT NULL DEFAULT 1, + title text NOT NULL, + kind text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + deleted_at timestamptz, + CONSTRAINT elements_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT elements_kind CHECK (kind IN ('note', 'file', 'external_ref')), + UNIQUE (id, home_scope_id) +); + +CREATE INDEX elements_owner ON elements (owner_subject_id) WHERE deleted_at IS NULL; + +CREATE TABLE note_bodies ( + element_id uuid PRIMARY KEY REFERENCES elements (id), + document_json jsonb NOT NULL, + version integer NOT NULL DEFAULT 1, + updated_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE correspondence_dates ( + element_id uuid PRIMARY KEY REFERENCES elements (id), + document_on date, + sent_on date, + received_on date +); + +CREATE TABLE external_references ( + element_id uuid PRIMARY KEY REFERENCES elements (id), + source text NOT NULL, + external_id text NOT NULL, + CONSTRAINT external_references_source CHECK (source IN ('paperless', 'url')), + CONSTRAINT external_references_id_len CHECK (char_length(external_id) BETWEEN 1 AND 200) +); + +CREATE TABLE bindings ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + element_id uuid NOT NULL REFERENCES elements (id), + context_kind text NOT NULL, + context_id uuid NOT NULL, + chapter_id uuid REFERENCES chapters (id), + position integer NOT NULL DEFAULT 0, + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + UNIQUE (element_id, context_kind, context_id), + CONSTRAINT bindings_context_kind CHECK (context_kind IN ('case', 'matter')) +); + +CREATE INDEX bindings_context ON bindings (context_kind, context_id); + +CREATE TABLE context_annotations ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + binding_id uuid NOT NULL REFERENCES bindings (id) ON DELETE CASCADE, + body text NOT NULL, + author_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT context_annotations_body CHECK (char_length(body) BETWEEN 1 AND 4000) +); + +CREATE TABLE access_grants ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + grantee_subject_id uuid REFERENCES auth_accounts (id), + resource_kind text NOT NULL, + resource_id uuid NOT NULL, + context_kind text, + context_id uuid, + can_read boolean NOT NULL DEFAULT false, + can_edit boolean NOT NULL DEFAULT false, + can_share boolean NOT NULL DEFAULT false, + can_delete boolean NOT NULL DEFAULT false, + is_exception boolean NOT NULL DEFAULT false, + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT access_grants_kind CHECK (resource_kind IN ('case', 'matter', 'element', 'task', 'deadline')), + CONSTRAINT access_grants_context_pair CHECK ((context_kind IS NULL) = (context_id IS NULL)), + CONSTRAINT access_grants_context_kind CHECK (context_kind IS NULL OR context_kind IN ('case', 'matter')), + CONSTRAINT access_grants_grantee CHECK (is_exception OR grantee_subject_id IS NOT NULL), + CONSTRAINT access_grants_exception_flag CHECK ( + NOT is_exception OR can_read OR can_edit OR can_share OR can_delete + ) +); + +CREATE UNIQUE INDEX access_grants_identity ON access_grants ( + resource_kind, + resource_id, + COALESCE(grantee_subject_id, '00000000-0000-0000-0000-000000000000'::uuid), + COALESCE(context_kind, ''), + COALESCE(context_id, '00000000-0000-0000-0000-000000000000'::uuid), + is_exception +); + +CREATE INDEX access_grants_grantee ON access_grants (grantee_subject_id); +CREATE INDEX access_grants_resource ON access_grants (resource_kind, resource_id); + +CREATE TABLE tasks ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + version integer NOT NULL DEFAULT 1, + title text NOT NULL, + matter_id uuid REFERENCES matters (id), + assignee_subject_id uuid REFERENCES auth_accounts (id), + due_on date, + task_status text NOT NULL DEFAULT 'open', + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + deleted_at timestamptz, + CONSTRAINT tasks_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT tasks_status CHECK (task_status IN ('open', 'done')) +); + +CREATE INDEX tasks_open ON tasks (task_status) WHERE deleted_at IS NULL; + +CREATE TABLE deadlines ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + version integer NOT NULL DEFAULT 1, + title text NOT NULL, + matter_id uuid REFERENCES matters (id), + element_id uuid REFERENCES elements (id), + assignee_subject_id uuid REFERENCES auth_accounts (id), + due_on date NOT NULL, + deadline_status text NOT NULL DEFAULT 'open', + fulfilled_at timestamptz, + created_at timestamptz NOT NULL DEFAULT now(), + updated_at timestamptz NOT NULL DEFAULT now(), + deleted_at timestamptz, + CONSTRAINT deadlines_title_len CHECK (char_length(title) BETWEEN 1 AND 200), + CONSTRAINT deadlines_status CHECK (deadline_status IN ('open', 'fulfilled')) +); + +CREATE INDEX deadlines_open ON deadlines (deadline_status) WHERE deleted_at IS NULL; + +CREATE TABLE task_deadline_links ( + task_id uuid NOT NULL REFERENCES tasks (id), + deadline_id uuid NOT NULL REFERENCES deadlines (id), + created_by uuid NOT NULL REFERENCES auth_accounts (id), + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (task_id, deadline_id) +); + +CREATE TABLE media_assets ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + element_id uuid NOT NULL UNIQUE REFERENCES elements (id), + owner_subject_id uuid NOT NULL REFERENCES auth_accounts (id), + home_scope_id uuid NOT NULL REFERENCES data_rooms (id), + original_filename text NOT NULL, + content_type text NOT NULL, + byte_size bigint NOT NULL, + sha256 text NOT NULL, + revision integer NOT NULL DEFAULT 1, + status text NOT NULL DEFAULT 'active', + created_at timestamptz NOT NULL DEFAULT now(), + CONSTRAINT media_assets_status CHECK (status IN ('active', 'purging', 'purged')), + CONSTRAINT media_assets_filename CHECK (char_length(original_filename) BETWEEN 1 AND 240) +); + +CREATE TABLE media_operations ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + element_id uuid, + asset_id uuid, + phase text NOT NULL, + status text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE domain_events ( + id uuid PRIMARY KEY DEFAULT gen_random_uuid(), + actor_subject_id uuid REFERENCES auth_accounts (id), + scope_id uuid, + action text NOT NULL, + resource_kind text NOT NULL, + resource_id uuid NOT NULL, + context_kind text, + context_id uuid, + occurred_on date, + occurred_at timestamptz NOT NULL DEFAULT now(), + result text NOT NULL DEFAULT 'ok' +); + +CREATE INDEX domain_events_resource ON domain_events (resource_kind, resource_id); +CREATE INDEX domain_events_context ON domain_events (context_kind, context_id); diff --git a/backend/requirements-dev.txt b/backend/requirements-dev.txt new file mode 100644 index 0000000..a575cbd --- /dev/null +++ b/backend/requirements-dev.txt @@ -0,0 +1,3 @@ +-r requirements.txt +pytest==8.3.4 +httpx==0.28.1 diff --git a/backend/requirements.txt b/backend/requirements.txt index 6a3f316..55637c5 100644 --- a/backend/requirements.txt +++ b/backend/requirements.txt @@ -1,3 +1,7 @@ fastapi==0.115.6 uvicorn[standard]==0.34.0 -psycopg2-binary==2.9.10 +psycopg[binary]==3.2.3 +psycopg-pool==3.2.4 +bcrypt==4.2.1 +pydantic-settings==2.6.1 +python-multipart==0.0.18 diff --git a/docker-compose.dev-env.yml b/docker-compose.dev-env.yml index 774f9e4..fe950ac 100644 --- a/docker-compose.dev-env.yml +++ b/docker-compose.dev-env.yml @@ -32,8 +32,12 @@ services: DB_PASSWORD: "${DB_PASSWORD:-dev_password_change_me}" APP_URL: "${APP_URL:-https://dev.tsumugu.jinkendo.de}" ALLOWED_ORIGINS: "${ALLOWED_ORIGINS:-https://dev.tsumugu.jinkendo.de,http://192.168.2.49:3094,http://localhost:3094}" + MEDIA_ROOT: /data/media + SEED_DEMO: "${SEED_DEMO:-true}" + volumes: + - dev-tsumugu-media:/data/media ports: - - "${TSUMUGU_BACKEND_PORT:-8094}:8000" + - "127.0.0.1:${TSUMUGU_BACKEND_PORT:-8094}:8000" depends_on: postgres: condition: service_healthy @@ -68,6 +72,7 @@ services: volumes: dev-tsumugu-db-data: + dev-tsumugu-media: networks: dev-tsumugu-network: diff --git a/docker-compose.yml b/docker-compose.yml index 5455b86..74492dd 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -34,8 +34,12 @@ services: DB_PASSWORD: "${DB_PASSWORD:?set DB_PASSWORD in .env}" APP_URL: "${APP_URL:-https://tsumugu.jinkendo.de}" ALLOWED_ORIGINS: "${ALLOWED_ORIGINS:-https://tsumugu.jinkendo.de}" + MEDIA_ROOT: /data/media + SEED_DEMO: "${SEED_DEMO:-false}" + volumes: + - tsumugu-media:/data/media ports: - - "${TSUMUGU_BACKEND_PORT:-8007}:8000" + - "127.0.0.1:${TSUMUGU_BACKEND_PORT:-8007}:8000" depends_on: postgres: condition: service_healthy @@ -71,6 +75,7 @@ services: volumes: tsumugu-db-data: + tsumugu-media: networks: tsumugu-network: diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 25cf61e..bd302f0 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -35,6 +35,8 @@ Gearbeitet wird auf `develop`. Production entsteht nur durch einen Merge-Commit Fehlt beim ersten Lauf die Host-`.env`, legt der Workflow sie an. Development bekommt die dokumentierten Dev-Defaults. Production bekommt ein zufälliges `DB_PASSWORD`, das nur in `/home/lars/docker/tsumugu/.env` steht und nicht ins Log geschrieben wird. Spätere Läufe überschreiben eine vorhandene `.env` nicht. `git reset --hard` lässt die Datei liegen, weil sie nicht im Repo ist. +Der Backend-Container migriert beim Start und bedient danach den API-Prozess. Der Host-Port des Backends bleibt an `127.0.0.1` gebunden; von außen ist nur das Frontend erreichbar, das `/api/` im Compose-Netz weiterreicht. Eigene Dateien liegen im Volume `dev-tsumugu-media` bzw. `tsumugu-media`. Development setzt `SEED_DEMO` standardmäßig und legt dabei nur synthetische Konten an. Production lässt das aus. Eine schon vorhandene Host-`.env` muss `SEED_DEMO` nicht enthalten. + --- ## Erreichbarkeit von außen diff --git a/docs/MVP_ANNAHMEN.md b/docs/MVP_ANNAHMEN.md new file mode 100644 index 0000000..697cb65 --- /dev/null +++ b/docs/MVP_ANNAHMEN.md @@ -0,0 +1,12 @@ +# Vorläufige MVP-Annahmen + +Diese Regeln sind die Arbeitsgrundlage der ersten Lieferung. Sie sind keine endgültigen Produktentscheidungen und lassen sich später ändern, ohne das Datenmodell umzubauen. + +1. **Widersprüchliche Rechte.** Es gilt nur der Kontext der Aktion. Ein Schreibschutz in Akte A sperrt die Bearbeitung in Kontext B nicht. Rechte werden nicht über unsichtbare Kontexte vereinigt. +2. **Neue Einbindung.** Weitere Sicht entsteht nur mit Weitergaberecht am Element und Bearbeitungsrecht am Ziel. Bearbeiten allein gibt niemandem neuen Zugriff. +3. **Einbindung und Löschen.** „Aus diesem Kontext entfernen“ löscht die Einbindung und ihre Anmerkungen. Das Element bleibt bei der Eigentümerin oder dem Eigentümer, auch ohne Einbindung. „Überall löschen“ darf nur diese Person. Paperless-Originale werden nicht gelöscht. +4. **Aktenvererbung.** Die Zuordnung eines Vorgangs gibt die Rechte dieser Akte an den Vorgang und an Inhalte ohne ausdrückliche Ausnahme weiter. Was die zuordnende Person nicht weitergeben darf, bleibt in diesem Aktenkontext unsichtbar, ohne Titel und ohne Anzahl. Querverweise vererben nichts. Die Ownership bleibt unverändert. + +Der gewählte Datenraum legt fest, wo neue Objekte entstehen. Er ist nicht selbst der Rechtepfad. Eine gültige Sitzung muss einen Datenraum gewählt haben; der Server prüft danach den mitgeschickten Handlungskontext. + +Technische Anpassung: Das Session-Cookie heißt in Production `__Host-jinkendo-session` und ist `Secure`. Development nutzt diesen Namen nur bei HTTPS. Über die dokumentierten HTTP-Adressen im LAN heißt es `jinkendo-session`, weil ein `__Host-`-Cookie dort nicht gespeichert werden kann. diff --git a/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md index c2abef0..bf8f052 100644 --- a/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md +++ b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md @@ -1,6 +1,6 @@ # Tsumugu – Technische MVP-Spezifikation -**Stand:** 16.10.2026 · **Fassung:** 0.3 · **Status:** Erster fachlicher Lieferumfang bestätigt; technische Ausgestaltung und offene Produktregeln bleiben Vorschläge. Keine Implementierung, keine Migration, kein Testnachweis. +**Stand:** 16.10.2026 · **Fassung:** 0.3 · **Status:** Erster fachlicher Lieferumfang ist als Anwendung umgesetzt. Offene Rechte- und Löschregeln bleiben vorläufig und stehen in [MVP_ANNAHMEN.md](../MVP_ANNAHMEN.md). Diese Datei bleibt der technische Entwurf, nicht der Nachweis eines Produktionstests. **Fachliche Grundlage:** [TSUMUGU_PRODUCT_SPEC.md](../product/TSUMUGU_PRODUCT_SPEC.md), Arbeitsstand 0.25 einschließlich Lieferentscheidung F-05a. Die historische [Recovery-Baseline](../product/Tsumugu_Product_Recovery_Baseline_v0.1.md) bleibt unverändert; wo das Interview eine Recovery-Aussage präzisiert hat, gilt die Fachspec. diff --git a/frontend/.dockerignore b/frontend/.dockerignore new file mode 100644 index 0000000..f06235c --- /dev/null +++ b/frontend/.dockerignore @@ -0,0 +1,2 @@ +node_modules +dist diff --git a/frontend/Dockerfile b/frontend/Dockerfile index 636b17a..984d96e 100644 --- a/frontend/Dockerfile +++ b/frontend/Dockerfile @@ -1,7 +1,18 @@ +FROM node:22-alpine AS build + +WORKDIR /src + +COPY package.json package-lock.json ./ +RUN npm ci + +COPY index.html vite.config.js ./ +COPY src ./src +RUN npm run build + FROM nginx:alpine COPY nginx.conf /etc/nginx/conf.d/default.conf -COPY index.html /usr/share/nginx/html/index.html +COPY --from=build /src/dist /usr/share/nginx/html EXPOSE 80 diff --git a/frontend/index.html b/frontend/index.html index 4ab495c..bd38bd2 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -4,29 +4,9 @@ Tsumugu - -
-

Tsumugu

-

Das Deploy-Gerüst der Jinkendo-Familie läuft. Die Anwendung selbst folgt.

-
+
+ diff --git a/frontend/nginx.conf b/frontend/nginx.conf index 3d05006..6a2bef8 100644 --- a/frontend/nginx.conf +++ b/frontend/nginx.conf @@ -3,6 +3,14 @@ server { server_name localhost; root /usr/share/nginx/html; index index.html; + server_tokens off; + client_max_body_size 21m; + + add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' blob:; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self'" always; + add_header X-Content-Type-Options "nosniff" always; + add_header X-Frame-Options "DENY" always; + add_header Referrer-Policy "no-referrer" always; + add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always; resolver 127.0.0.11 valid=10s ipv6=off; @@ -13,10 +21,21 @@ server { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; proxy_read_timeout 600s; } + location ^~ /health/ { + set $docker_backend_svc backend; + proxy_pass http://$docker_backend_svc:8000$request_uri; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; + proxy_read_timeout 30s; + } + location / { try_files $uri $uri/ /index.html; } diff --git a/frontend/package-lock.json b/frontend/package-lock.json new file mode 100644 index 0000000..aaf7d35 --- /dev/null +++ b/frontend/package-lock.json @@ -0,0 +1,1735 @@ +{ + "name": "tsumugu-frontend", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "tsumugu-frontend", + "dependencies": { + "react": "18.3.1", + "react-dom": "18.3.1", + "react-router-dom": "6.28.1" + }, + "devDependencies": { + "@vitejs/plugin-react": "4.3.4", + "vite": "5.4.11" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz", + "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.29.7", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz", + "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz", + "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/generator": "^7.29.7", + "@babel/helper-compilation-targets": "^7.29.7", + "@babel/helper-module-transforms": "^7.29.7", + "@babel/helpers": "^7.29.7", + "@babel/parser": "^7.29.7", + "@babel/template": "^7.29.7", + "@babel/traverse": "^7.29.7", + "@babel/types": "^7.29.7", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/generator": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.8.tgz", + "integrity": "sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.8", + "@babel/types": "^7.29.8", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz", + "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.29.7", + "@babel/helper-validator-option": "^7.29.7", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz", + "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz", + "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.29.7", + "@babel/types": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz", + "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7", + "@babel/traverse": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.29.7.tgz", + "integrity": "sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz", + "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.29.10", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.10.tgz", + "integrity": "sha512-EMCx3AGZ3WfAl6ht7AyQoPm2Lh+BGYEMdc4Q6Hf7uSCDOZFuLq44qNwL+iaim8VlyYhRAo4X43+weadK8ZB4Yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.29.7", + "@babel/types": "^7.29.8" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.9", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.9.tgz", + "integrity": "sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.8" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-self": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.29.7.tgz", + "integrity": "sha512-TL0hMc9xzy86VD31nUiwzd5otRAcyEPcsegCxolO0PvcXuH1v0kECe/UIznYFihpkvU5wg/jk4v0TTEFfm53fw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-source": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.29.7.tgz", + "integrity": "sha512-06IyK09H3wi4cGbhDBwp5gUGo0IKtnYa8tyTiephirPCK6fbobVGiXMMI5zLQ4aKEYP3wZ3ArU44o+8KMrSG/Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/template": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz", + "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/parser": "^7.29.7", + "@babel/types": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.29.10", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.10.tgz", + "integrity": "sha512-B3lYAs2nkKskbgQ1nfy8Ma9ao9Q1rntTAQHrzzyDuj+TSO+X3le6PfWwqDvodsb+OumE10eMFfuMCTQSQ5iuIQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/generator": "^7.29.8", + "@babel/helper-globals": "^7.29.7", + "@babel/parser": "^7.29.9", + "@babel/template": "^7.29.7", + "@babel/types": "^7.29.8", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz", + "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz", + "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz", + "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz", + "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz", + "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz", + "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz", + "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz", + "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz", + "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz", + "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz", + "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz", + "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz", + "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz", + "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz", + "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz", + "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz", + "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz", + "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz", + "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz", + "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz", + "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz", + "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz", + "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz", + "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@napi-rs/lzma-linux-x64-gnu": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz", + "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^22.20 || ^24.12 || >=25" + } + }, + "node_modules/@remix-run/router": { + "version": "1.21.0", + "resolved": "https://registry.npmjs.org/@remix-run/router/-/router-1.21.0.tgz", + "integrity": "sha512-xfSkCAchbdG5PnbrKqFWwia4Bi61nH+wm8wLEqfHDyp7Y3dZzgqS2itV8i4gAq9pC2HsTpwyBC6Ds8VHZ96JlA==", + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.64.7.tgz", + "integrity": "sha512-GFF2tHk0NqYVObrK0+/ps/LEXsV/v2q6Lyiy7mZr+Ej24fpQScvqK2ziz9NHeEQYnKWKym38Ml7dZbPtC9tuAw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.64.7.tgz", + "integrity": "sha512-BOymcXJFYYXqluDidj6sLelNjXruC3u1BqVxLn2OPCXH9xaPSOTH+MS4uychsGI1NU7tJoiv9KvqijDHFe+hhQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.64.7.tgz", + "integrity": "sha512-jgVpGweIbls2H5jfBB70tnX52abMd5pJr3xmtoDILx6JdmGl+Un+tMb9R+MbHPVB46tTBpY8emtn7M71SnQhEQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.64.7.tgz", + "integrity": "sha512-AVMpt94mrXH7WjyWKmd9nT4RC5yM0AN3Lt6A89xVIsuLDi3dDX6dxMytLbW36FlppY9JsoqUoS3LUUpUrYxiMQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.64.7.tgz", + "integrity": "sha512-Nje29c/MyajxRNFGU05oyeTDS6SWdMg/wWMSlZSBTBju5BKz2NVc0kFiFSQGzRELNiB+CBk/ZvAVsWsENgjGag==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.64.7.tgz", + "integrity": "sha512-xxgN5/kMzCNz/NYJ4t49B0/WS6InNlWv6xvgwUQqNnWM9WJMMwMUGWrAxdNEgYWdHL0sMnuh8I87StGrIMTA+w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.64.7.tgz", + "integrity": "sha512-5U/9gVn/X657I8+NHoHO9Wnfyd0lEXwqbslobRoB9TC8SwYzOitcIr6TLE7531Q/NWs3L4mb+YOGzlf3vHIeYw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.64.7.tgz", + "integrity": "sha512-hcDS0a/Y8ggM3dcOfzH7UpSaogCViWTtNDSl0EXpWIj8g8/r86ITqptjil2hayTXS0Umzb+Yt3mjgpQVFVf2+A==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.64.7.tgz", + "integrity": "sha512-awbAr4N7Qd/yjZAQBEEPzgcPveYG2Gi5L6gq1/Bp+3SMRjn5F68Wv1zKsntzvvoioBR6yKvhLtWqu11am1TsxA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.64.7.tgz", + "integrity": "sha512-Ut7xQJfeLhzu2yN3rHzVvL9ccyPJvN4aCdP1V7hJ5lGxX/eCzgB9SiMk/Md3J+rWWZgvoYsDW4BUFggJr32pBA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.64.7.tgz", + "integrity": "sha512-trqoni/vHkuM5oo5iQhoKPh6fjjD7E80pMgCXWgGxU8vSRPUlwvG8GeYvEEcB6eJAxNa99WH9iVHPHelgtKiHA==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.64.7.tgz", + "integrity": "sha512-gvlUy0XFIwtUWiQmhc+4GT2Knm3KosinpUVhr7CtTFA78gFDnE5NWwMPzHrJsYpKkh2LlY7yvBIboN1FAV6Xeg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.64.7.tgz", + "integrity": "sha512-8yS/kSXTJ/47Z62JW+C2AJ3vd/8zZw016vFjtNpZwmZlwJumLua4s1i78dkYuSSqQ+0aIMxJcBp/4uIwp2ehjA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.64.7.tgz", + "integrity": "sha512-mxVSKvvty0hOP1AFo/l4Kpv3i3HK0zx4rYUrirZDToYlWhS3xzmIkq3vUJ7rtrM2cPyXveDyDT6M1FfXZ9hTRA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.64.7.tgz", + "integrity": "sha512-lEse1zra1CagM+uHH2bl28GInDsZZ45NJzHei2OMaXQFzZWKBO1hFo07rS0xB6ayV4WU360UrSmPDSyCMpYsUQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.64.7.tgz", + "integrity": "sha512-d/cqCoiG9WMZ5VuJZ5Qdlv9g97QyoGwnmvHccvGhKSacTy7xFrAS+jMcJSBdMNOw1oacSkl6p7K6O/DRYTKL3g==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.64.7.tgz", + "integrity": "sha512-kVEA//CeDOZZP1XCH2JBgqXb9+ALlwuA/4civaazMVdgzaSQC9WM38w65zG/LLk0lA7F9Od19CSBZW7J9mCbNg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.64.7.tgz", + "integrity": "sha512-14oLfDsOSr0TSntT/34jRg/V8B2XW/Jomh9zX9CjIM9gwwNlI1OCymS/GVn0DV32h67eRf7U0GGem0rvfXgNwQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.64.7.tgz", + "integrity": "sha512-dFVtPfjZqAnUPpPY4Bfg+87yo1IBW9HiY8iCFtg49Pn46MfZTebSHZh8PL6SOsgyt9LQP8Nj/sE6jm3aWpySmQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.64.7.tgz", + "integrity": "sha512-Dm9CZ2SM3u2NgvBj4awW/gGqkOwzH8f6MSYIJE6+bKcKLI+T0+LhpD6vtetTfrIIx+rLXDf5RJqBP6v7V5O+wg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.64.7.tgz", + "integrity": "sha512-oaxsvS2mL6+78741CT2HCORBvy1USg3Wqpt5qvZwy3aMXRMl4zxyDo8maeFRWJkF3dp0Wbi71fKH5Gr9YI3vYA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.64.7.tgz", + "integrity": "sha512-UKZz1Y4mxUqkWh60uH7B1aZn6UcAimPk4ipRktpb3wfZq7JrzZYyAXTwiafkb3T+kd5P3Sf+vzcRdsDks4WtjQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.64.7.tgz", + "integrity": "sha512-WWkSuC1J+mZJnsDh0mRaCAFSWfQdl6y3fDjZeWElI6zHo8CcOSG5lY3yurKJjEq+FrX0WD60sFrVVpbHqzMmrw==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.64.7.tgz", + "integrity": "sha512-u9bp2yXCI3/BUjUxY6uWknAY32pfvvDCPysyUTySotx0dj3ydlFHrRQYfn/b/kZgnfjyEwySMtI7Ga054uiysQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.64.7.tgz", + "integrity": "sha512-EhX6N3XPMEnVU5cRfNgzPOKcSucsbu3nNNWuoAaEuKIqmddBKHN5b9d4rPe65T1I+FaOT176JKiZNsUBp3rqbA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.27.0", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.2" + } + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@vitejs/plugin-react": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-4.3.4.tgz", + "integrity": "sha512-SCCPBJtYLdE8PX/7ZQAs1QAZ8Jqwih+0VBLum1EGqmCCQal+MIUqLCzj3ZUy8ufbC0cAM4LRlSTm7IQJwWT4ug==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.26.0", + "@babel/plugin-transform-react-jsx-self": "^7.25.9", + "@babel/plugin-transform-react-jsx-source": "^7.25.9", + "@types/babel__core": "^7.20.5", + "react-refresh": "^0.14.2" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "peerDependencies": { + "vite": "^4.2.0 || ^5.0.0 || ^6.0.0" + } + }, + "node_modules/baseline-browser-mapping": { + "version": "2.11.29", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.29.tgz", + "integrity": "sha512-YeesxhUmR4h5y5V8KF8iBCqJb8YFrBJ++XBTeGcWIaQOYXGN19JM0FoiOjAhwuDoln8owMgXcWBmgHtYSkky2w==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.cjs" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/browserslist": { + "version": "4.29.3", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.29.3.tgz", + "integrity": "sha512-1R4kiYKXGViqEN0CnoDrXc1StD9niAwu+j2dukWzrD4bJgsD4lDmEp0CRbc6E/vYJIfTHwPmwyaKtVSudICdPA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "baseline-browser-mapping": "^2.11.26", + "caniuse-lite": "^1.0.30001813", + "electron-to-chromium": "^1.5.439", + "node-releases": "^2.0.57", + "update-browserslist-db": "^1.3.3" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001816", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001816.tgz", + "integrity": "sha512-+8Yx7BXCoqk6IF8yTicjfUR6D/ldJzdlsodlEOiOSPmhK844WIgk67/zIQaGAOxNkZyyvBlrRFnLvqKIoqbAFw==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.458", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.458.tgz", + "integrity": "sha512-/hIH2gRSmxrf4/X4Nw/t/Wc8PVS22l8/3HnWjWTWsTOM5dsnMUPZF/+u+yr3LqweNuTBJE1rq6qAQzKkZVwMfA==", + "dev": true, + "license": "ISC" + }, + "node_modules/esbuild": { + "version": "0.21.5", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz", + "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=12" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.21.5", + "@esbuild/android-arm": "0.21.5", + "@esbuild/android-arm64": "0.21.5", + "@esbuild/android-x64": "0.21.5", + "@esbuild/darwin-arm64": "0.21.5", + "@esbuild/darwin-x64": "0.21.5", + "@esbuild/freebsd-arm64": "0.21.5", + "@esbuild/freebsd-x64": "0.21.5", + "@esbuild/linux-arm": "0.21.5", + "@esbuild/linux-arm64": "0.21.5", + "@esbuild/linux-ia32": "0.21.5", + "@esbuild/linux-loong64": "0.21.5", + "@esbuild/linux-mips64el": "0.21.5", + "@esbuild/linux-ppc64": "0.21.5", + "@esbuild/linux-riscv64": "0.21.5", + "@esbuild/linux-s390x": "0.21.5", + "@esbuild/linux-x64": "0.21.5", + "@esbuild/netbsd-x64": "0.21.5", + "@esbuild/openbsd-x64": "0.21.5", + "@esbuild/sunos-x64": "0.21.5", + "@esbuild/win32-arm64": "0.21.5", + "@esbuild/win32-ia32": "0.21.5", + "@esbuild/win32-x64": "0.21.5" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/loose-envify": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", + "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", + "license": "MIT", + "dependencies": { + "js-tokens": "^3.0.0 || ^4.0.0" + }, + "bin": { + "loose-envify": "cli.js" + } + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.20", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.20.tgz", + "integrity": "sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/node-releases": { + "version": "2.0.59", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.59.tgz", + "integrity": "sha512-5qr2okC4ItAI0hG5SaV0HoYMpnM/Y6+Oqr7AmPYy/2uEoGvS+GbSKLeRxSS1uAdu59yz0ouzcuXievSgg///WA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/postcss": { + "version": "8.5.30", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.30.tgz", + "integrity": "sha512-zkd+e9S1AQHhmaBKye9zlFHWjOwVgqXl1q3ECYy8561K7qxR2cREf/STLskulBFd78k6AOFeA+ff1TtEzk9bAA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.20", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.2" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/react": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz", + "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "loose-envify": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dom": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz", + "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==", + "license": "MIT", + "peer": true, + "dependencies": { + "loose-envify": "^1.1.0", + "scheduler": "^0.23.2" + }, + "peerDependencies": { + "react": "^18.3.1" + } + }, + "node_modules/react-refresh": { + "version": "0.14.2", + "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.14.2.tgz", + "integrity": "sha512-jCvmsr+1IUSMUyzOkRcvnVbX3ZYC6g9TDrDbFuFmRDq7PD4yaGbLKNQL6k2jnArV8hjYxh7hVhAZB6s9HDGpZA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-router": { + "version": "6.28.1", + "resolved": "https://registry.npmjs.org/react-router/-/react-router-6.28.1.tgz", + "integrity": "sha512-2omQTA3rkMljmrvvo6WtewGdVh45SpL9hGiCI9uUrwGGfNFDIvGK4gYJsKlJoNVi6AQZcopSCballL+QGOm7fA==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.21.0" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8" + } + }, + "node_modules/react-router-dom": { + "version": "6.28.1", + "resolved": "https://registry.npmjs.org/react-router-dom/-/react-router-dom-6.28.1.tgz", + "integrity": "sha512-YraE27C/RdjcZwl5UCqF/ffXnZDxpJdk9Q6jw38SZHjXs7NNdpViq2l2c7fO7+4uWaEfcwfGCv3RSg4e1By/fQ==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.21.0", + "react-router": "6.28.1" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8", + "react-dom": ">=16.8" + } + }, + "node_modules/rollup": { + "version": "4.64.7", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.64.7.tgz", + "integrity": "sha512-aCiJONoZp0lNGJ6sYqspLkh6UXaWEey/7Ko2TZyXQ4kgzAhDUxAgbt/oulXKmD+zFHXw1k+RF6ZZWOrjp7DZnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@napi-rs/lzma-linux-x64-gnu": "1.5.1", + "@rollup/rollup-android-arm-eabi": "4.64.7", + "@rollup/rollup-android-arm64": "4.64.7", + "@rollup/rollup-darwin-arm64": "4.64.7", + "@rollup/rollup-darwin-x64": "4.64.7", + "@rollup/rollup-freebsd-arm64": "4.64.7", + "@rollup/rollup-freebsd-x64": "4.64.7", + "@rollup/rollup-linux-arm-gnueabihf": "4.64.7", + "@rollup/rollup-linux-arm-musleabihf": "4.64.7", + "@rollup/rollup-linux-arm64-gnu": "4.64.7", + "@rollup/rollup-linux-arm64-musl": "4.64.7", + "@rollup/rollup-linux-loong64-gnu": "4.64.7", + "@rollup/rollup-linux-loong64-musl": "4.64.7", + "@rollup/rollup-linux-ppc64-gnu": "4.64.7", + "@rollup/rollup-linux-ppc64-musl": "4.64.7", + "@rollup/rollup-linux-riscv64-gnu": "4.64.7", + "@rollup/rollup-linux-riscv64-musl": "4.64.7", + "@rollup/rollup-linux-s390x-gnu": "4.64.7", + "@rollup/rollup-linux-x64-gnu": "4.64.7", + "@rollup/rollup-linux-x64-musl": "4.64.7", + "@rollup/rollup-openbsd-x64": "4.64.7", + "@rollup/rollup-openharmony-arm64": "4.64.7", + "@rollup/rollup-win32-arm64-msvc": "4.64.7", + "@rollup/rollup-win32-ia32-msvc": "4.64.7", + "@rollup/rollup-win32-x64-gnu": "4.64.7", + "@rollup/rollup-win32-x64-msvc": "4.64.7", + "fsevents": "~2.3.2" + } + }, + "node_modules/scheduler": { + "version": "0.23.2", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz", + "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + } + }, + "node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/source-map-js": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz", + "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.3.4.tgz", + "integrity": "sha512-t8wonIOdQyOjtPd2VktlBu6QjTVTks6v8bSi7kd0r2Vll8TK1JYDZtRRdbmCHOAMphkZgrzK+L+vXK4pyZ8t4A==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/vite": { + "version": "5.4.11", + "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.11.tgz", + "integrity": "sha512-c7jFQRklXua0mTzneGW9QVyxFjUgwcihC4bXEtujIo2ouWCe1Ajt/amn2PCxYnhYfd5k09JX3SB7OYWFKYqj8Q==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "esbuild": "^0.21.3", + "postcss": "^8.4.43", + "rollup": "^4.20.0" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || >=20.0.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.4.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + } + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + } + } +} diff --git a/frontend/package.json b/frontend/package.json new file mode 100644 index 0000000..35a4ccb --- /dev/null +++ b/frontend/package.json @@ -0,0 +1,19 @@ +{ + "name": "tsumugu-frontend", + "private": true, + "type": "module", + "scripts": { + "dev": "vite", + "build": "vite build", + "preview": "vite preview" + }, + "dependencies": { + "react": "18.3.1", + "react-dom": "18.3.1", + "react-router-dom": "6.28.1" + }, + "devDependencies": { + "@vitejs/plugin-react": "4.3.4", + "vite": "5.4.11" + } +} diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx new file mode 100644 index 0000000..120a8c4 --- /dev/null +++ b/frontend/src/App.jsx @@ -0,0 +1,85 @@ +import { useEffect, useState } from "react"; +import { Navigate, Route, Routes, useNavigate } from "react-router-dom"; +import { api, applySession, clearSession, isDirty } from "./api.js"; +import { SessionContext } from "./session.js"; +import { Login } from "./pages/Login.jsx"; +import { Shell } from "./pages/Shell.jsx"; +import { Overview } from "./pages/Overview.jsx"; +import { CaseList, CaseDetail } from "./pages/Cases.jsx"; +import { MatterList, MatterDetail } from "./pages/Matters.jsx"; +import { Rooms } from "./pages/Rooms.jsx"; +import { Search } from "./pages/Search.jsx"; + +export function App() { + const [session, setSession] = useState(undefined); + const navigate = useNavigate(); + + useEffect(() => { + let active = true; + api("/api/v1/auth/session") + .then((data) => { + if (!active) return; + applySession(data); + setSession(data); + }) + .catch(() => { + if (!active) return; + clearSession(); + setSession(null); + }); + return () => { + active = false; + }; + }, []); + + async function refresh() { + const data = await api("/api/v1/auth/session"); + applySession(data); + setSession(data); + return data; + } + + async function changeScope(next) { + if (isDirty() && !window.confirm("Ungespeicherte Eingaben verwerfen und den Datenraum wechseln?")) { + return; + } + const data = await api("/api/v1/auth/session/scope", { method: "POST", body: { kind: next.kind, id: next.id } }); + applySession(data); + setSession(data); + navigate("/"); + } + + async function logout() { + try { + await api("/api/v1/auth/logout", { method: "POST" }); + } catch { + /* Die lokale Sitzung endet auch, wenn der Server schon abgemeldet hat. */ + } + clearSession(); + setSession(null); + navigate("/login"); + } + + if (session === undefined) { + return

Tsumugu wird geladen …

; + } + + const value = { session, setSession, refresh, changeScope, logout }; + + return ( + + + : } /> + : }> + } /> + } /> + } /> + } /> + } /> + } /> + } /> + + + + ); +} diff --git a/frontend/src/api.js b/frontend/src/api.js new file mode 100644 index 0000000..03fd3ad --- /dev/null +++ b/frontend/src/api.js @@ -0,0 +1,101 @@ +let csrf = ""; +let scope = null; +let epoch = 0; +let dirty = false; + +export function sessionState() { + return { csrf, scope, epoch }; +} + +export function applySession(data) { + csrf = data.csrf_token || ""; + scope = data.scope || null; + epoch = data.epoch || 0; + dirty = false; + return data; +} + +export function clearSession() { + csrf = ""; + scope = null; + epoch = 0; + dirty = false; +} + +export function markDirty(value) { + dirty = value; +} + +export function isDirty() { + return dirty; +} + +function scopeHeaders() { + if (!scope) return {}; + return { "X-Scope-Kind": scope.kind, "X-Scope-Id": scope.id }; +} + +export async function api(path, { method = "GET", body, form } = {}) { + const started = epoch; + const headers = { ...scopeHeaders() }; + if (csrf && method !== "GET" && method !== "HEAD") { + headers["X-CSRF-Token"] = csrf; + } + let payload; + if (form) { + payload = form; + } else if (body !== undefined) { + headers["Content-Type"] = "application/json"; + payload = JSON.stringify(body); + } + const response = await fetch(path, { method, headers, body: payload, credentials: "include" }); + if (started !== epoch) { + const error = new Error("Der Datenraum wurde gewechselt."); + error.status = 0; + throw error; + } + if (response.status === 204) return null; + const text = await response.text(); + const data = text ? JSON.parse(text) : null; + if (!response.ok) { + const error = new Error(data?.detail || "Die Anfrage ist fehlgeschlagen."); + error.status = response.status; + error.code = data?.code; + if (response.status === 401) clearSession(); + throw error; + } + return data; +} + +export async function downloadFile(elementId, context, filename) { + const params = new URLSearchParams(); + if (context?.kind && context?.id) { + params.set("context_kind", context.kind); + params.set("context_id", context.id); + } + const response = await fetch(`/api/v1/files/${elementId}/content?${params}`, { + credentials: "include", + headers: scopeHeaders(), + }); + if (!response.ok) { + throw new Error("Die Datei ist nicht verfügbar."); + } + const blob = await response.blob(); + const url = URL.createObjectURL(blob); + const link = document.createElement("a"); + link.href = url; + link.download = filename || "datei"; + document.body.appendChild(link); + link.click(); + link.remove(); + URL.revokeObjectURL(url); +} + +export function textToDocument(text) { + const blocks = text.split(/\n/).map((line) => ({ type: "paragraph", text: line })); + return { version: 1, blocks: blocks.length ? blocks : [{ type: "paragraph", text: "" }] }; +} + +export function documentToText(document) { + return (document?.blocks || []).map((block) => block.text || "").join("\n"); +} diff --git a/frontend/src/main.jsx b/frontend/src/main.jsx new file mode 100644 index 0000000..d81b9e6 --- /dev/null +++ b/frontend/src/main.jsx @@ -0,0 +1,13 @@ +import React from "react"; +import { createRoot } from "react-dom/client"; +import { BrowserRouter } from "react-router-dom"; +import { App } from "./App.jsx"; +import "./styles.css"; + +createRoot(document.getElementById("root")).render( + + + + + , +); diff --git a/frontend/src/pages/Cases.jsx b/frontend/src/pages/Cases.jsx new file mode 100644 index 0000000..8b8c7cf --- /dev/null +++ b/frontend/src/pages/Cases.jsx @@ -0,0 +1,395 @@ +import { useContext, useEffect, useState } from "react"; +import { Link, useParams } from "react-router-dom"; +import { api, markDirty, textToDocument } from "../api.js"; +import { SessionContext } from "../session.js"; +import { BindingList, Chronology, ErrorNote, ShareBox } from "./widgets.jsx"; + +export function CaseList() { + const { session } = useContext(SessionContext); + const [items, setItems] = useState([]); + const [title, setTitle] = useState(""); + const [error, setError] = useState(""); + + async function load() { + const data = await api("/api/v1/cases"); + setItems(data.items); + } + + useEffect(() => { + load().catch((err) => setError(err.message)); + }, [session.scope.id]); + + async function create(event) { + event.preventDefault(); + setError(""); + try { + await api("/api/v1/cases", { method: "POST", body: { title } }); + setTitle(""); + markDirty(false); + await load(); + } catch (err) { + setError(err.message); + } + } + + return ( +
+
+
+

Akten

+

Sichtbar ist, was du lesen darfst — auch aus anderen Datenräumen. Neue Akten entstehen in „{session.scope.name}“.

+
+
+
+ { + setTitle(event.target.value); + markDirty(true); + }} + placeholder="Neue Akte, zum Beispiel Mietstreit" + required + /> + +
+ +
    + {items.map((item) => ( +
  • + {item.title} + {item.status === "open" ? "Offen" : "Geschlossen"} +
  • + ))} +
+
+ ); +} + +export function CaseDetail() { + const { id } = useParams(); + const [record, setRecord] = useState(null); + const [events, setEvents] = useState([]); + const [error, setError] = useState(""); + const context = { kind: "case", id }; + + async function load() { + const [detail, chronology] = await Promise.all([ + api(`/api/v1/cases/${id}`), + api(`/api/v1/cases/${id}/chronology`), + ]); + setRecord(detail); + setEvents(chronology.items); + } + + useEffect(() => { + load().catch((err) => setError(err.message)); + }, [id]); + + if (error && !record) return
; + if (!record) return

Akte wird geladen …

; + + return ( +
+
+
+

{record.home_scope_name}

+

{record.title}

+

{rightsText(record.rights)} {record.status === "open" ? "Offen" : "Geschlossen"}.

+
+
+ +
+
+

Vorgänge

+
    + {record.matters.map((matter) => ( +
  • + {matter.title} +
  • + ))} +
+ {record.rights.edit ? : null} + {record.subcases?.length ? ( + <> +

Unterakten

+
    + {record.subcases.map((item) => ( +
  • {item.title}
  • + ))} +
+ + ) : null} + {record.rights.edit ? : null} +
+
+

Kapitel

+
    {record.chapters.map((chapter) =>
  • {chapter.title}
  • )}
+ {record.rights.edit ? : null} +
+
+
+

Inhalte

+ + {record.rights.edit ? : null} +
+ {record.grants || record.rights.share || record.is_owner ? ( + record.rights.share || record.is_owner ? ( + + ) : null + ) : null} +
+

Chronologie

+ +
+
+ ); +} + +function NewMatter({ caseId, onChange }) { + const [title, setTitle] = useState(""); + const [error, setError] = useState(""); + + async function submit(event) { + event.preventDefault(); + setError(""); + try { + const matter = await api("/api/v1/matters", { method: "POST", body: { title } }); + await api(`/api/v1/matters/${matter.id}/case-links`, { method: "POST", body: { case_id: caseId } }); + setTitle(""); + markDirty(false); + onChange(); + } catch (err) { + setError(err.message); + } + } + + return ( +
+

Vorgang anlegen und zuordnen

+ { setTitle(event.target.value); markDirty(true); }} placeholder="Zum Beispiel Mängelanzeige" required /> + + + + ); +} + +function NewSubcase({ parentId, onChange }) { + const [title, setTitle] = useState(""); + const [rightsMode, setRightsMode] = useState("inherit_parent"); + + async function submit(event) { + event.preventDefault(); + await api("/api/v1/cases", { method: "POST", body: { title, parent_case_id: parentId, rights_mode: rightsMode } }); + setTitle(""); + onChange(); + } + + return ( +
+

Unterakte

+ setTitle(event.target.value)} placeholder="Titel der Unterakte" required /> + + +
+ ); +} + +export function ChapterForm({ path, onChange }) { + const [title, setTitle] = useState(""); + + async function submit(event) { + event.preventDefault(); + await api(path, { method: "POST", body: { title } }); + setTitle(""); + onChange(); + } + + return ( +
+ setTitle(event.target.value)} placeholder="Kapitel" required /> + +
+ ); +} + +export function ContentForms({ context, placement, chapters, onChange }) { + return ( +
+ + + +
+ ); +} + +function chapterSelect(chapters, value, setValue) { + return ( + + ); +} + +function NoteForm({ context, placement, chapters, onChange }) { + const [title, setTitle] = useState(""); + const [text, setText] = useState(""); + const [chapterId, setChapterId] = useState(""); + const [error, setError] = useState(""); + + async function submit(event) { + event.preventDefault(); + setError(""); + try { + await api("/api/v1/notes", { + method: "POST", + body: { + title, + document: textToDocument(text), + context, + ...(placement ? { placement } : {}), + ...(chapterId ? { chapter_id: chapterId } : {}), + }, + }); + setTitle(""); + setText(""); + markDirty(false); + onChange(); + } catch (err) { + setError(err.message); + } + } + + return ( +
+

Notiz

+ { setTitle(event.target.value); markDirty(true); }} placeholder="Titel" required /> +