ADR 032 plattform scope vs tenant instanz - smart-village-solutions/sva-studio GitHub Wiki
Akzeptiert
Der Root-Host der Studio-Plattform steuert tenantübergreifende Funktionen wie Instanzverwaltung, Root-Host-Login und globale Readiness-/Diagnosepfade. Gleichzeitig ist das IAM-Datenmodell tenantzentriert; iam.instances repräsentiert nur echte Tenant-Instanzen. Die bisherige technische Vermischung über global, default und platform führte zu inkonsistenten Laufzeitkontexten, uneinheitlichem Logging und Audit-Schreibfehlern gegen iam.activity_logs.
- Die Runtime kennt genau zwei kanonische Scope-Arten:
instanceplatform
-
instanceIdbleibt exklusiv tenantgebunden. - Der Root-Host läuft fachlich immer im
platform-Scope. - Tenant-Audit bleibt in
iam.activity_logs. - Plattform-Audit wird separat in
iam.platform_activity_logspersistiert. - Operative Logs und Fehlerpfade verwenden
scope_kind,workspace_id,reason_code,error_typeund redigierte Diagnosefelder statt roher Fehlertexte.
- Root-Host-Aktionen sind fachlich explizit modelliert.
- Tenant-Audit bleibt sauber FK-gebunden an
iam.instances. - Plattform-Audit scheitert nicht mehr an tenantgebundenen Fremdschlüsseln.
- Logs und Fehlerantworten werden stabiler und betrieblich besser auswertbar.
- Bestehende Tests und Log-Erwartungen müssen auf
platform/instancemigriert werden. - Übergangsweise bleiben einzelne Altpfade mit
defaultals technischer Kompatibilitätswert bestehen.
Verworfen, weil sie Plattform- und Tenant-Modell künstlich vermischt und FK-gebundene Tenant-Tabellen fachlich unsauber erweitert hätte.