# Tsumugu – Technische MVP-Spezifikation **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. **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. ### Hinweis zum Ist-Stand (Code-Review 18.10.2026) Diese Fassung ist der Entwurf vom 16.10.2026 mit späteren punktuellen Ergänzungen (Ordnung, Richtung, Unterkapitel). Abschnitt 1.3 („keine Fachanwendung“) und der Satz in Abschnitt 8, der erste Auftrag solle nur P0 umfassen, beschreiben den damaligen Ausgangspunkt. Die Anwendung umfasst inzwischen P0–P3, P4a und P5a sowie die Folgeaufträge F-06 bis F-08. P7 fehlt. Den tatsächlichen Stand beschreiben [API_REFERENZ.md](API_REFERENZ.md), [DATENMODELL_IST.md](DATENMODELL_IST.md) und [RECHTEMODELL_IST.md](RECHTEMODELL_IST.md). Abweichungen zwischen dieser Spezifikation und dem Code stehen im [Code-Review](../review/04_TECHNISCHE_SPEZIFIKATION.md). ### Ä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. Kapitel können innerhalb desselben Objekts verschachtelt sein (F-08a); eine technische Schutzgrenze von 32 Ebenen ist keine fachliche Tiefengrenze. Die eine Unterakten- und Teilvorgangsebene bleibt davon unberührt. - 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. | | Kapitel und Elternkapitel | n:0..1 | Dasselbe Akten- oder Vorgangsobjekt, kein Zyklus. Unterkapitel bleiben Gliederung. Bestätigt F-08a. Technische Schutzgrenze: 32 Ebenen. | | 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`, `communication_direction` null, `direction_explicit` | Kontext ist Akte, Vorgang oder Zusammenstellung. `release_state` `visible` oder `pending` für noch nicht freigegebene neue Zusammenstellungsinhalte. `communication_direction` ist `in`, `out`, `local` oder leer und gilt nur für diese Einbindung. `local` ist eine bewusste lokale Unterlage ohne Ein- oder Ausgang. `direction_explicit` wahr hält eine bewusste Wahl oder ein bewusstes Leeren; sonst darf nur eine übernommene IMAP-Richtung `in` oder `out` vorgefüllt werden. Versand- und Zugangsdatum sind keine Richtung. | | `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. Akten und Vorgänge speichern `content_order` (`date` oder `position`) und `content_order_dir` (`asc` oder `desc`). Bestehende Zeilen bleiben auf `position`, damit eine schon gesetzte Einbindungsreihenfolge nicht ersetzt wird. Neue Akten und Vorgänge beginnen mit fachlichem Datum aufsteigend. `bindings.position` gehört zur Einbindung. Die Datumssortierung schreibt sie nicht um. `PATCH /api/v1/cases/{id}/content-order` und `POST /api/v1/cases/{id}/bindings/order` sowie die gleichen Pfade unter `matters` prüfen das Bearbeitungsrecht im Handlungskontext und `expected_version`. Der fachliche Verlauf liest die Datumsfelder der sichtbaren Unterlagen einmal je Element. Das Änderungsprotokoll bleibt `GET .../chronology`, seitenweise über `cursor`. `content_view` ist `structure` oder `chronology` und nur eine Darstellung. Sie schreibt Kapitel, Positionen und Datumssortierung nicht um. Der Breadcrumb eines Vorgangs ist der Objektpfad `Vorgänge` und gegebenenfalls der lesbare Elternvorgang; lesbare Aktenzuordnungen stehen separat in `placements` und wechseln den Handlungskontext nur bei bewusster Auswahl. `elements.summary` ist eine optionale gemeinsame Kurzbeschreibung. Ein Textauszug entsteht nur aus vorhandenem Notiztext. Bild- und PDF-Vorschauen verwenden denselben berechtigten Dateiabruf wie das Öffnen. Anlagen, Versand und Nachweise sind eigene Verwendungen im Behälter der Einbindung, nicht im geerbten Aktenkontext. `attachment_uses` ordnet ein vorhandenes Element einem Hauptschriftstück zu, mit eigener Reihenfolge je Behälter und ohne Dateikopie. `bindings.list_fold` blendet nur dieses Vorkommen als Anlage oder Nachweis aus; andere Einbindungen bleiben. `dispatches` hält Weg, Versanddatum, Gegenüber, Vollständigkeit und Herkunft (`captured` oder `reconstructed`). `dispatch_items` ist das Manifest. Eine sicherbare Fassung liegt als Bytes unter `MEDIA_ROOT/dispatch/` in `dispatch_snapshots`, bei Notizen zusätzlich als JSON im Manifest. Eine fehlende historische Fassung bleibt `gap` und wird nicht durch die aktuelle Arbeitsdatei ersetzt. `dispatch_evidence` verknüpft einen vorhandenen Beleg in der Rolle E-Mail, Einlieferung, Zustellung oder sonstiger Nachweis. Am Schriftstück liegt dafür ein eigenes Ablagefeld; mehrere Belege eines Versands bleiben nebeneinander. Ziehen aus der Liste ordnet zu, Ziehen zurück in die Liste löst nur diese Verwendung. Einlieferung setzt keinen Zustellstatus. Berichtigungen stehen in `dispatch_corrections` und ändern die gesicherten Bytes nicht. Löschen eines Elements entfernt die Bytes seiner Versandfassungen über denselben Löschpfad wie die Arbeitsdatei. Lesen des Hauptschriftstücks öffnet keine gesperrte Anlage. Exportknoten `attachment`, `dispatch_item` und `evidence` unterscheiden Arbeitsstand, gesicherte Fassung und Nachweis. Eine unvollständige Auswahl ist ein Auszug. Eine ausgewählte E-Mail bleibt das vollständige Original. ### 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 Ein registriertes Konto mit Leserecht an Akte oder Vorgang kann verknüpfte Paperless-Dokumente und E-Mails über die serverseitigen Zugänge des Owners lesen, wenn der Owner das an der Freigabe ausdrücklich einschaltet (`use_owner_sources`) oder es der Person in einem Datenraum, mit dem der Eintrag geteilt ist, ausdrücklich freigibt (`room_source_access`, seit 04.11.2026). Der Empfänger richtet dafür keine eigenen Quellen ein, erhält keine Secrets und kann das Archiv oder Postfach nicht durchsuchen. Ein Gastzugang ohne Konto bleibt offen und ist nicht Teil dieses Schnitts. Das Übergabepaket bleibt ein eigener Stand und nutzt weiter die Zugänge der exportierenden Person. 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 ein vollständiger E-Mail-Import sind nicht im MVP. Ein verbundenes IMAP-Konto wird über seine Fächer geblättert; die Suche ist nur ein Zusatz im geöffneten Fach. Der Verweis speichert Betreff, Absender und Datum, nicht die Nachricht. 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. **Stand 19.10.2026, Implementierung der Grundlage:** Eigene Dateien und Versandfassungen laufen über einen kleinen Storage-Port mit lokalem Adapter. Die Speicherreferenz trägt Instanz, Generation, Objektkennung und Inhaltsrevision. Das Schutzprofil und die Schlüsselzuständigkeit liegen daneben; geheime Schlüssel stehen nicht in der Referenz. Der vorhandene Bestand ist `legacy-plaintext`. Profile `managed-encrypted` und `client-encrypted` werden geschlossen abgelehnt und nicht entschlüsselt. Paperless und IMAP sind registrierte Source-Adapter. Die Art prüft die Registrierung, nicht eine Datenbankliste. Ein dritter Testadapter belegt, dass Fachseiten, Reader und Export dafür nicht erweitert werden. Eine Referenz bindet eine konkrete Instanz. Dieselbe externe Nummer in zwei Instanzen bleibt getrennt. Mehrdeutiger Altbestand wird nicht auf den zuletzt angelegten Zugang gelegt. F-02b und F-02c bleiben offen und werden durch diesen lesenden Schnitt nicht ersetzt. Zugangsdaten liegen weiterhin im Adapter, derzeit als Klartext in `connectors.secret`. Das ist kein Nachweis von Verschlüsselung oder SaaS-Reife. 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.