Files
tsumugu/docs/architecture/ARCHITECTURE_DISCOVERY.md
LarsandCursor 27cde035e8
Deploy Development / deploy (push) Successful in 27s
Test Suite / pytest-backend (push) Successful in 1m27s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 9s
Gib ein Uebergabepaket aus der bestaetigten Auswahl aus.
Die Dev-Umgebung soll die hierarchische Auswahl und das Paket pruefen koennen. Vorhandene Symbolaktionen der Inhaltszeilen bleiben im selben Stand.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-17 19:23:50 +02:00

267 lines
21 KiB
Markdown

# Architecture Discovery — Tsumugu und Jinkendo-Familie
**Stand:** 15. Oktober 2026
**Art:** Read-only-Analyse. Keine Implementierung, keine Migration, keine Änderung an laufenden Systemen.
**Gegenstand:** Vorbereitung eines universellen Vorgangs- und Aktenmanagers (Tsumugu) auf Basis des bestehenden Jinkendo-Ökosystems.
**Quellen:** Code und Spezifikationen in `tsumugu`, `shinkan-jinkendo`, `kairo-jinkendo`, `mitai-jinkendo`.
## Einordnung
Dieses Dokument ist der Discovery-Bericht. Es beschreibt den Ist-Stand und die daraus folgenden Architekturvorschläge für Tsumugu.
Daraus soll eine **universelle Architekturleitlinie der Jinkendo-Familie** entstehen. Die Leitlinie hält fest, was für jede Anwendung gilt: Identität, Mandant, Berechtigung, Daten, Audit, Deploy, Integrationsgrenzen. Aus dieser Leitlinie wird anschließend die **Zielarchitektur des konkreten Programms** abgeleitet. Tsumugu ist das erste Programm, für das diese Ableitung vorgesehen ist. Shinkan, Kairo und Mitai bleiben eigene Produkte mit eigenen Zielarchitekturen.
Parallel dazu entsteht eine **universelle Designrichtlinie für das Frontend**. Sie ist ein eigenes Dokument. Farben, Layout, Komponenten und Interaktion gehören dorthin. Dieser Bericht behandelt sie nicht.
Die Vorschläge in den Abschnitten 5 bis 8 sind keine Beschlüsse. Verbindlich werden sie erst durch eine Freigabe.
## Annahmen und Grenzen
- Die Host-`.env` auf dem Raspberry Pi und der Reverse Proxy auf der Synology wurden nicht inspiziert. Aussagen über Produktionswerte, die nur dort stehen, sind ungeprüft.
- Tests wurden nicht ausgeführt. „Implementiert und getestet“ bedeutet, dass Testdateien im Repository liegen.
- Paperless-ngx kommt in den durchsuchten Repositories nicht vor.
- Die fachliche Spezifikation des Vorgangsmanagers lag nicht vor. Fehlende Produktanforderungen werden hier nicht als verbindlich gesetzt.
- Das Root-`README.md` von Mitai beschreibt noch BodyTrack. Maßgeblich für das Produkt ist `CLAUDE.md` in `mitai-jinkendo`.
- Der Abschnitt „Startzustand“ in `kairo-jinkendo/README.md` ist älter als der Code.
## Reife-Legende
| Stufe | Bedeutung |
|---|---|
| Implementiert und getestet | Code und zugehörige Tests liegen im Repository |
| Implementiert, Validierung offen | Code vorhanden, Produktion oder fachliche Wirkung nicht belegt |
| In Entwicklung | Laufende Umsetzung, Docs und Code weichen voneinander ab |
| Spezifiziert | Beschrieben, im Code dieses Gegenstands nicht vorhanden |
| Nicht vorhanden | Weder Code noch wirksame Spezifikation |
| Ungeprüft | Liegt außerhalb der gelesenen Repositories, zum Beispiel Host-Konfiguration |
---
## 1. Ist-Architektur
### Gemeinsamer Betriebsrahmen
Mitai, Shinkan, Kairo, Kanshō und Tsumugu laufen als getrennte Compose-Projekte auf demselben Raspberry Pi (`192.168.2.49`). TLS endet auf dem Synology-NAS `192.168.2.63`. Der Gitea-Runner deployed `develop` nach Development und `main` nach Produktion. Jede Anwendung hat eine eigene PostgreSQL-Datenbank im Compose-Netz.
| | Development | Production |
|---|---|---|
| Tsumugu | `3094` / `8094`, dev.tsumugu.jinkendo.de | `3007` / `8007`, tsumugu.jinkendo.de |
| Shinkan | Frontend `3098` | Frontend `3003`, Backend nur `127.0.0.1:8003` |
| Kairo | Frontend `3097`, Backend `8097` | Frontend `3004`, Backend `8004` |
Quellen: `tsumugu/docs/DEPLOYMENT.md`, `shinkan-jinkendo/docker-compose.yml`, `kairo-jinkendo/docs/DEPLOYMENT.md`, `kairo-jinkendo/docker-compose.yml`.
Technologie, soweit eine Anwendung über das Gerüst hinaus ist: Python 3.12, FastAPI, psycopg2, bcrypt, React 18, Vite, PostgreSQL 16, Nginx im Frontend-Image, nummerierte SQL-Migrationen beim Backend-Start. Ein gemeinsames Python-Paket oder eine gemeinsame Datenbank gibt es nicht.
### Tsumugu
Deploy-Gerüst ohne Domäne. `backend/main.py` stellt `GET /api/health` bereit und schaltet OpenAPI ab (`docs_url=None`). Der Health-Check prüft Postgres und gibt `status`, `app`, `env` und `db` zurück. `frontend/nginx.conf` leitet `/api/` an das Backend weiter und setzt keine Security-Header.
Postgres veröffentlicht keinen Host-Port (`docker-compose.yml`). Das Backend hängt an allen Interfaces (`${TSUMUGU_BACKEND_PORT:-8007}:8000`). Das Frontend hängt an `${TSUMUGU_FRONTEND_PORT:-3007}:80`.
| Funktion | Stufe |
|---|---|
| Health, Compose, Gitea-Deploy | Implementiert |
| Auth, Mandant, Fachdomäne, Audit, Tests | Nicht vorhanden |
### Shinkan
Trainer- und Vereinsplattform. Stand im Repo: `APP_VERSION` 0.8.238, `DB_SCHEMA_VERSION` 20260607095 (`backend/version.py`). Vertrieblich gilt Gate V0: bekannte Vereine, keine öffentliche Vermarktung (`docs/product-readiness/PRODUCT_READINESS.md`).
Identität: Tabelle `profiles`, opaque Session-Token in `sessions`, Header `X-Auth-Token`. Passwörter bcrypt, Legacy-SHA256 wird beim Login angehoben (`backend/auth.py`). Das Frontend legt den Token unter `localStorage.authToken` ab (`frontend/src/api/client.js`).
Mandant: der Verein. `TenantContext` löst `profile_id`, Plattformrolle, `effective_club_id` und Mitgliedschaften pro Request auf (`backend/tenant_context.py`). Der Client sendet `X-Active-Club-Id`. Inhalte der Bibliothek tragen `visibility` mit den Werten `private`, `club` und `official`. Listen filtern über `library_content_visibility_sql()`.
Autorisierung liegt auf mehreren Ebenen parallel:
| Ebene | Ort | Durchsetzung im Repo |
|---|---|---|
| Plattformrolle `profiles.role` | `backend/club_tenancy.py` | Wirksam für Admin-Pfade |
| Vereinsrollen | `club_member_roles` | Wirksam in Legacy-Helfern, parallel zur Capability-Matrix |
| Capability | `backend/capabilities.py` | Hard-Block nur bei `CAPABILITY_ENFORCE=1`. Code-Fallback `"0"`. Variable fehlt in `docker-compose.yml` |
| Vereinskontingent | `backend/club_features.py` | Hard-Block bei `CLUB_FEATURE_ENFORCE=1`. Code-Fallback `"0"`. Compose-Default `1` |
| Objektsichtbarkeit | Access Layer | Für Bibliothek und Medien mit Integrationstests |
`CAPABILITY_ENFORCE` und der tatsächliche Prod-Wert von `CLUB_FEATURE_ENFORCE` sind auf dem Host ungeprüft. Die Entscheidungsnotiz vom Juni 2026 und Compose widersprechen sich; das ist in `docs/product-readiness/README.md` als Dokumentdrift vermerkt.
### Kairo
Operativer Program Director. Der Code ist eine laufende Anwendung, kein reines Spec-Paket. `backend/version.py` nennt `0.20.2-ap2.2d`. Die Migrationen reichen bis `backend/migrations/033_unified_schedules.sql`. `docs/MIGRATIONS.md` und mehrere Architecture-Maps beschreiben einen älteren Stand. Verlässlicher sind der Code und `docs/product/Kairo_Implementation_Truth_Table_v0.1.md`.
Identität: `users` und Sessions, Header `X-Auth-Token`. Mandant: `tenants` und `tenant_memberships` mit Rollen owner, admin, member. Der Actor (Mensch, Agent, Arbeitsgruppe, externes System) ist vom User getrennt. `TenantContext` liefert `user_id`, `tenant_id` und Capabilities (`backend/tenant_context.py`).
`require_capability` blockt bei Modus `enforce` und protokolliert bei Modus `probe`. Der Code-Default ist `probe` (`backend/capabilities.py`). Compose setzt `CAPABILITY_ENFORCE` nicht. Actor-Service-Tokens erzwingen die Prüfung immer (`backend/operational_auth.py`).
Fachlich vorhanden und mit pytest hinterlegt: Initiativen, Maßnahmen, Zuweisungen, Roadmap, Projekte, Tasks, Schedules, Steering-Kernel, Operational API. LLM-Ausführung, MCP, Billing und SSO sind spezifiziert und im Code nicht ausgeführt. Prompt-Rendering existiert ohne Modellaufruf.
### Mitai
Persönliche Tracking-PWA der Familie. Daten hängen an `profile_id`. Ein Mandant, ein Verein oder ein geteilter Datenraum ist nicht modelliert (`backend/schema.sql`, Designprinzip `AUTH_SESSION_DESIGN_PRINCIPLES.md`).
Die Session-Schicht entspricht der Familie: opaque Token, bcrypt, `require_auth`, Rate-Limits auf Login, Registrierung und Passwort-Reset (`backend/auth.py`, `backend/routers/auth.py`). Kontingente hängen am Account über `check_feature_access`.
Daneben besteht Legacy: `get_pid()` in `backend/routers/profiles.py` übernimmt den Header `X-Profile-Id` und fällt sonst auf das erste Profil der Datenbank zurück. `GET /api/profiles` listet nach `require_auth` alle Profile. Dedizierte Auth-Tests sind kaum vorhanden. Dieses Legacy ist der Grund, Mitai als Strukturidee zu lesen und den Zugriffscode für Tsumugu neu zu schreiben.
---
## 2. Architekturstandards, die sich aus dem Ist-Stand ergeben
Diese Punkte sind heute über die Produkte verteilt. Sie sind Kandidaten für die spätere Familienleitlinie, noch nicht die Leitlinie selbst.
1. **Vier getrennte Prüfungen.** Identität, Capability, Kontingent, Objekt-Governance. Quelle: `shinkan-jinkendo/docs/jinkendo-family/FAMILY_ENTITLEMENT_MODEL.md`. Eine Anwendung lässt eine Schicht weg, wenn sie sie nicht braucht, und dokumentiert das.
2. **Subjekt der Identität kommt aus der Session.** Der Client wählt keine fremde Profil- oder User-ID als Autorität.
3. **Mandanten-ID kommt aus dem Kontext.** Request-Body und beliebige Header werden gegen die Mitgliedschaft geprüft. Fremde Objekt-IDs antworten mit 404. Quelle: `kairo-jinkendo/docs/architecture/Kairo_Tenant_Invariants_v0.1.md`.
4. **Capability und Kontingent sind verschiedene Fragen.** Ein Plan schaltet keine Rolle um. Quelle: Shinkan E-02 in `docs/product-readiness/PRODUCT_READINESS.md`.
5. **Objektsichtbarkeit ist eine eigene Achse**, sobald in einem Mandanten private und gemeinsame Daten nebeneinander liegen. Shinkan modelliert das als `private` / `club` / `official`. Kairo hat diese Achse nicht.
6. **Schemaänderungen sind nummerierte SQL-Dateien**, angewandt beim Start, gebucht in `schema_migrations`.
7. **Eigene Datenbank und eigenes Compose-Projekt pro Anwendung.** Integration über API, nicht über gemeinsame Tabellen.
8. **Deploy-Linie:** Branch `develop` und `main`, Health-Check, Secrets nur in der Host-`.env`, TLS am äußeren Proxy.
Was die Leitlinie zusätzlich festlegen muss, weil es heute driftet:
- Ob Capability-Prüfung in neuen Anwendungen im Modus `enforce` startet. Shinkan fällt auf `"0"` zurück, Kairo auf `probe`.
- Ob das Backend nur an `127.0.0.1` gebunden wird. Shinkan tut das. Kairo und Tsumugu veröffentlichen den API-Port auf allen Interfaces.
- Welche Audit-Felder jede Anwendung mindestens schreibt. Kairo schreibt `action`, `user_id`, `tenant_id`, `details` (`backend/services/audit.py`) und bietet keine Lese-API.
---
## 3. Sicherheitsstatus und offene Risiken
Shinkan ist der relevante Maßstab für Zugriff von außen, weil dort die Produktionsreife gerade hergestellt wird. Der Befund: der Rand ist im Repository gehärtet, die fachliche Durchsetzung von Rollen ist im Default ein Protokoll, und mehrere V1-Nachweise liegen außerhalb des Codes.
### Shinkan, äußerer Rand
Im Repository umgesetzt:
- Backend `127.0.0.1:8003`, Postgres `127.0.0.1:5434`. Öffentlich auf dem Host ist der Frontend-Port `3003` (`docker-compose.yml`).
- OpenAPI in Produktion aus, abgesichert durch `backend/tests/test_security_release.py`.
- Medien-Static default aus. Auslieferung über berechtigte API-Pfade und kurzlebige Media-Grants.
- Nginx setzt CSP, `X-Content-Type-Options`, `X-Frame-Options`, `Referrer-Policy`, `Permissions-Policy` (`frontend/nginx.conf`). HSTS steht in dieser Datei nicht.
- Login-Limit, Sperre nach Fehlversuchen, optionales TOTP. Admin-TOTP ist default aus (`REQUIRE_ADMIN_TOTP`).
- Onboarding-Gate sperrt die Fach-API, bis E-Mail und Verein stehen.
- Cross-Tenant-Tests für den Access Layer liegen in `backend/tests/test_access_layer_integration.py`.
Offen:
| ID | Thema | Stufe | Beleg |
|---|---|---|---|
| L-09 | Security-Intake ohne Befunde | Ungeprüft, Lauf laut Doku offen | `docs/product-readiness/06-security-intake.md` |
| L-11 | Capability-Hard-Block default aus | Implementiert, Validierung in Produktion offen | `backend/capabilities.py` |
| L-10 | Kontingent-Hard-Block abhängig von Env | Implementiert, Host-Wert ungeprüft | Compose-Default `1`, Code-Fallback `0` |
| L-04 / P-08 | HSTS am öffentlichen Proxy | Ungeprüft | Nicht im Repo |
| L-14 | `POST /api/auth/register` offen, Limit 3/Stunde | Implementiert und getestet | `backend/routers/auth.py` |
| P-18 | Token im `localStorage` | Implementiert. HttpOnly-Cookie nur eingeordnet | `frontend/src/api/client.js` |
| L-07 / P-09 | Kein durchgängiges Admin-Audit | Nicht vorhanden | Product-Readiness-Matrix |
| — | `GET /api/version` ohne Auth, inkl. Schemaversion | Implementiert, Validierung offen | `backend/main.py` |
| L-01, L-02, L-03, L-05, L-06 | Rechtstexte, Personenbilder, Löschung, AV, VVT | Teilweise oder offen | `02-compliance-und-betrieb.md` |
Ein Outsider ohne Konto erreicht Health, Version, Registrierung, Passwort-Reset und die statische SPA. Fachdaten der Bibliothek verlangen eine Session und den Access Layer. Ein gestohlener Token aus dem `localStorage` trägt die Rechte dieser Session. Die CSP mit `script-src 'self'` verkleinert die Fläche dafür.
### Kairo und Mitai, soweit für Tsumugu relevant
Kairo isoliert Mandanten in Services und Tests und lässt Rollen im Default passieren, solange `CAPABILITY_ENFORCE` auf `probe` steht. Das Backend ist auf allen Interfaces veröffentlicht.
Mitai bindet neue Fachrouter an `session['profile_id']` und hält gleichzeitig den ungebundenen Profil-Header. Wer dieses Muster kopiert, öffnet fremde Profildaten für jeden eingeloggten Benutzer.
### Tsumugu heute
Es gibt keine Authentifizierung. Health ist unauthentifiziert und nennt Umgebung und Datenbankstatus. Der API-Port ist auf dem Host veröffentlicht. Security-Header fehlen. Das ist für ein Gerüst erwartbar und wird zum Risiko, sobald Fachendpunkte an dieselbe Compose-Datei anschließen, ohne die Bindung und die Header vorher zu ändern.
---
## 4. Wiederverwendbare Bausteine
Übernahme bedeutet: das Muster im Tsumugu-Repository neu implementieren. Eine gemeinsame Bibliothek oder Datenbank koppelt die Anwendungen und ist für den Start ungeeignet.
| Baustein | Herkunft | Umgang |
|---|---|---|
| Compose, Workflows `develop`/`main`, Health-Deploy | Tsumugu, Mechanik aus Kanshō (`docs/DEPLOYMENT.md`) | Direkte Wiederverwendung des Gerüsts |
| Nummerierte SQL-Migrationen beim Start | Shinkan, Kairo, Mitai | Muster, eigener Runner |
| Opaque Session, `X-Auth-Token`, bcrypt, Logout durch Löschen der Session | Familie | Muster. Subjekt-ID nur aus der Session |
| Tenant, Membership, Capability-Registry, `require_capability` | Kairo | Muster. Eigener Namespace `tsumugu.*` |
| Objektsichtbarkeit privat und gemeinsam, zentraler Filter, Governance-Übergänge | Shinkan Access Layer | Anpassung. Datenraum statt Verein, Wert `official` entfällt |
| Audit-Schreiben mit JSON-Details | `kairo-jinkendo/backend/services/audit.py` | Anpassung. `resource_type` und `resource_id` von Anfang an. Lese-API für die Chronologie |
| Prompt- und Config-Registry ohne Modellaufruf | Kairo | Muster für spätere KI. Eigene Keys |
| Actor-Service-Token für Agents | `kairo-jinkendo/backend/operational_auth.py` | Muster für die spätere Integration. Tokens bleiben an den Tsumugu-Datenraum gebunden |
| `X-Profile-Id`, offene Profil-CRUD, `get_pid` | Mitai `backend/routers/profiles.py` | Eigenständige Neuimplementierung. Dieses Muster wird nicht übernommen |
| Vereinsrollen, Sparten, Abo-Pläne, Sportkatalog | Shinkan | Bleiben in Shinkan |
---
## 5. Architekturvorschläge für den Vorgangsmanager
Diese Vorschläge leiten sich aus dem Ist-Stand ab. Sie werden zur Zielarchitektur von Tsumugu, sobald die Familienleitlinie und die fachliche Spezifikation sie tragen.
**Identität.** User und Session nach Familienmuster. Die wirksame User-ID kommt aus der Session.
**Mandant.** Ein Datenraum mit Mitgliedschaft und Rollen, nach dem Kairo-Muster `tenant` plus `tenant_memberships`. Der Verein ist kein Subjekt von Tsumugu.
**Objekt-Governance.** Akten, Unterakten und andere Fachobjekte tragen eine Sichtbarkeit innerhalb des Datenraums: privat für den Ersteller, gemeinsam für Mitglieder des Raums. Virtuelle Zusammenstellungen speichern Referenzen auf Objekte, keine Kopien. Die konkrete Stufenliste legt die Leitlinie fest; Shinkans Dreierwert `private` / `club` / `official` ist die Vorlage, nicht das Schema.
**Externe Quellen.** Paperless-ngx und spätere Quellen sind Referenzen (Quelle, externe ID, Anzeige-Metadaten). Das Dokument bleibt im Quellsystem. Eine Paperless-Integration existiert in den gelesenen Repositories nicht.
**Chronologie, Aufgaben, Fristen.** Chronologie ist ein Lesemodell über Audit und Fachereignisse. Aufgaben und Fristen sind eigene Objekte. Sie werden nicht aus Kairo-Tabellen importiert.
**Finanzen.** Manuelle Zuordnung von Finanz- und Erstattungsvorgängen zu Akten, sobald die Fachspec die Felder festlegt. Kein Zahlungsdienst im ersten Schnitt. Shinkan hat Stripe bewusst zurückgestellt (E-06).
**Audit.** Append-only, mit Akteur, Datenraum, Aktion, Ressourcentyp, Ressourcen-ID und Zeit. Kairo zeigt das Schreiben. Das Schema von Kairo reicht für eine Aktenchronologie nicht aus, weil Ressource und Actor dort fehlen.
**Berechtigung.** Capability-Registry mit Modus `enforce` ab dem ersten fachlichen Endpoint. Kontingente (Schicht C des Familienmodells) bleiben aus, bis ein Billing-Subjekt beschlossen ist.
**Deploy.** Das bestehende Tsumugu-Gerüst bleibt. Vor Fachendpunkten: Backend nur an `127.0.0.1`, Security-Header wie in `shinkan-jinkendo/frontend/nginx.conf`, HSTS-Nachweis am Synology-Proxy für `tsumugu.jinkendo.de` und `dev.tsumugu.jinkendo.de`.
**Spätere Kairo- und KI-Anbindung.** HTTP-API. Ein Agent handelt mit einem an den Datenraum gebundenen Token, analog zu Kairos Actor-Service-Tokens. Prompt-Registry kann vor dem ersten Modellaufruf existieren.
---
## 6. Abweichungen und Zielkonflikte
**Shinkan-Verein und Tsumugu-Datenraum.** Shinkan löst Mehrbenutzerfähigkeit über Verein, Vereinsrollen, Plattformrollen, Kontingente und Sichtbarkeit. Das passt zur Vereinsplattform und ist für einen universellen Vorgangsmanager zu eng an Bibliothek, Abo und Sport gekoppelt. Die vier Prüfungen bleiben brauchbar. Das Subjekt „Verein“ bleibt in Shinkan.
**Mitai-Profil und gemeinsame Räume.** Mitai ist das schlankere Identitätsmodell: ein Account, Entitlements am Account, keine zweite Organisationsachse. Gemeinsame Datenräume trägt dieses Modell nicht. Der Profil-Header ist für jede Anwendung mit mehreren Personen ungeeignet.
**Kairo-Tenant und private Objekte.** Kairo trennt Mandanten und antwortet auf fremde IDs mit 404. Innerhalb eines Mandanten gibt es keine Achse „privat neben gemeinsam“. Für Akten und virtuelle Zusammenstellungen braucht Tsumugu beide Achsen: Datenraumgrenze und Objektsichtbarkeit.
**Probe-Default.** Shinkan und Kairo lassen fehlende Capabilities im Standard zu und protokollieren sie. Ein Vorgangsmanager, der private und gemeinsame Daten von Beginn an hält, übernimmt diesen Default nur nach ausdrücklicher Freigabe.
**Dokumentdrift.** Product-Readiness, Entscheidungsnotizen und Compose nennen für dieselben Schalter verschiedene Defaults. Eine Familienleitlinie braucht eine Stelle, die den wirksamen Default nennt, und einen Verweis auf den Code, der ihn liest.
**Designrichtlinie.** Frontend-Muster der drei Anwendungen (API-Clients, Auth-Context, Navigation) sind heute produktlokal. Sie gehören in die parallele Designrichtlinie, sobald dort Komponenten und Interaktion festgelegt werden. Dieser Bericht setzt keine UI fest.
---
## 7. Offene Entscheidungen
Freigabe nötig, bevor die technische Spezifikation von Tsumugu diese Punkte als verbindlich übernimmt.
| ID | Frage | Vorschlag aus dem Ist-Stand |
|---|---|---|
| E-01 | Subjekt für gemeinsame Daten | Datenraum mit Mitgliedschaft. Private Objekte darin. Der Verein ist kein Subjekt |
| E-02 | Registrierung zum Start | Geschlossen oder nur per Einladung. Eine offene Register-Route wie in Shinkan braucht einen eigenen Beschluss |
| E-03 | Capability-Modus | `enforce` ab dem ersten fachlichen Endpoint |
| E-04 | Paperless | Referenz auf Quelle und externe ID. Kein Dokumentenspeicher in Tsumugu, solange die Fachspec keinen verlangt |
| E-05 | Kontingente und Abo | Schicht C erst spezifizieren, wenn es ein Billing-Subjekt gibt |
| E-06 | Backend-Port | Nur `127.0.0.1`, wie Shinkan. Heute veröffentlicht Tsumugu `8007` auf allen Interfaces |
| E-07 | Spätere Kairo-Kopplung | HTTP und datenraumgebundene Tokens. Keine gemeinsame Datenbank, keine gemeinsamen Capability-Keys |
| E-08 | Ort der Familienleitlinie | Eigenes Dokument, aus dem Programm-Zielarchitekturen abgeleitet werden. Dieser Bericht bleibt die Ist-Aufnahme |
E-08 ist eine Arbeitsentscheidung für die Dokumentenstruktur. Sie ändert keinen Code.
---
## 8. Empfehlungen für die spätere technische Spezifikation
Reihenfolge für die Tsumugu-Spezifikation, nachdem die Leitlinie die Familienregeln festgezogen hat:
1. Datenraum, Mitgliedschaft, Objektsichtbarkeit, Audit-Schema mit Ressource und Akteur.
2. Deploy-Härtung des bestehenden Gerüsts: localhost-Backend, Security-Header, HSTS-Nachweis.
3. Akten, Unterakten, virtuelle Zusammenstellungen als Referenzen.
4. Externe Quellen, zuerst Paperless-ngx als Referenz.
5. Chronologie als Lesemodell, danach Aufgaben und Fristen.
6. Manuelle Finanz- und Erstattungszuordnung gemäß Fachspec.
7. Integrationspunkte für Kairo und KI, ohne Implementierung des Modellaufrufs.
Die fachlichen Regeln zu Zuordnungsvorschlägen, Fristen und Erstattung bleiben der separaten Produktspezifikation vorbehalten.
Die Familienleitlinie selbst sollte die acht Standards aus Abschnitt 2 in normative Sätze überführen, die Drift der Defaults auflösen und pro Anwendung nur noch die Abweichung dokumentieren. Die Designrichtlinie entsteht daneben und referenziert die Leitlinie dort, wo eine UI eine Berechtigung oder einen Datenraum sichtbar macht.