73 KiB
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/healthantwortet weiterhin erfolgreich oder mit 503, nennt aber nur nochstatusundapp. Umgebung und Datenbankdetail gehören nicht in die öffentliche Health-Antwort./health/liveund/health/readykommen nach dem Foundation-Vertrag dazu.- OpenAPI bleibt in Produktion aus (
docs_url=None). - Psycopg 3 löst
psycopg2-binaryab, 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, ohneCAPABILITY_ENFORCE=0, ohnemin(club_ids). - Mitai-Kontobindung nur als persönlicher Scope.
X-Profile-Idund 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
- 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.
- Ein Teilvorgang hat genau einen Elternvorgang. Ein Querverweis setzt keinen zweiten.
- 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). - 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.
- Der gemeinsame Notiztext existiert einmal. Eine berechtigte Änderung ist in jeder Einbindung sichtbar, die der Leser sehen darf.
- Eine Anmerkung hängt an genau einer Einbindung.
- Eine Sicht speichert Kriterien und liefert zur Laufzeit nur Objekte, die derselbe Leseprädikat-Filter bereits zulässt.
- Eine Zusammenstellung speichert Verweise.
release_state = pendingist für Empfänger ohne eigenes Leserecht unsichtbar. - Detach löscht die Einbindung. Das Element bleibt. Globales Löschen ist eine zweite Aktion.
- 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.
notified_onnimmt die Bedeutung des bisherigenerstattet_amauf. Es ist kein Zahlungseingang. Ein Zahlungseingang ist eine Zahlung mitdirection = inbound.- 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.
- Wirksame Geldbeträge sind die Summe der gespeicherten vorzeichenbehafteten Zeilen.
kindbenennt 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.
- Identität, Session, Konto und gewählter Datenraum sind aktuell gültig. Sonst 401 oder 403.
- Der Behälter des Kontexts ist für den Akteur lesbar, oder der Akteur ist Owner des Elements und handelt im Heimtraum. Sonst 404.
release_state = pendingund kein eigenes Leserecht: 404, ohne Titel.- Explizite Elementausnahme in diesem Kontext entfernt Rechte. Ein Schreibschutz entfernt Bearbeiten. Eine Freigabesperre entfernt Freigeben. Eine Ausblendung entfernt Lesen.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.