Files
tsumugu/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md
T
LarsandCursor 67d48378c9
Deploy Development / deploy (push) Successful in 23s
Test Suite / pytest-backend (push) Successful in 1m1s
Test Suite / smoke-dev (push) Successful in 1s
Test Suite / frontend-build (push) Successful in 5s
Lass E-Mails ueber die Faecher finden und halte Kapitel sowie das Menue in der Akte an ihrem Ort.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-17 10:59:03 +02:00

73 KiB
Raw Blame History

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. Diese Datei bleibt der technische Entwurf, nicht der Nachweis eines Produktionstests.

Fachliche Grundlage: TSUMUGU_PRODUCT_SPEC.md, Arbeitsstand 0.25 einschließlich Lieferentscheidung F-05a. Die historische Recovery-Baseline 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.

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.

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. 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.

4.3 Überblick

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 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.

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.