DB-Schema-Detailprüfung UC-SA – Superadmin-Panel¶

Stand: 01.08.2026 14:55 Branch: docs/einheitliche-kopfbereiche Status: Abgeschlossen; Gegen vorhandene UC-SA-Spezifikation und Prisma-Zielschema v3 konzeptionell geprüft

Datum, Uhrzeit	Version	Änderung	Autor
01.08.2026 14:55	1.0	Kopfbereich vereinheitlicht	David Mittig
01.08.2026 11:12	1.0	Kopfbereich ergänzt	David Mittig

1. Prüfgrundlage¶

Geprüft wurde gegen:

docs/developer/uc-sa/uc-sa-spezifikation.md,
backend/prisma/schema.prisma v3,
docs/developer/uc00/db-schema-zielbild-uc-matrix.md,
docs/developer/db-schema.md v6,
docs/management/roadmap.md.

Korrekturhinweis:

Die frühere Fassung dieser Detailprüfung enthielt die falsche Aussage, dass keine eigene UC-SA-Spezifikation gefunden wurde. Die Spezifikation existiert und wurde in dieser Nachprüfung berücksichtigt.

2. Fachlicher UC-Zweck aus der Spezifikation¶

UC-SA stellt eine plattformweite Verwaltungs- und Support-Oberfläche bereit.

Das Superadmin-Panel dient zur Verwaltung von Tenants, Tenant-Status, Plattform-Grunddaten, Systemvorlagen, Standardregeln, Support-Diagnose und sicherheitsrelevanten Prüfungen. Es ist klar von der Tenant-Verwaltung innerhalb einer Tauchschule getrennt.

3. Spezifikationsanforderungen gegen Prisma-Zielschema¶

Anforderung UC-SA	Prisma-Zielschema v3	Bewertung
Tenant-Übersicht	`Tenant`	abbildbar
Tenant anlegen / bearbeiten	`Tenant`	abbildbar
Tenant aktivieren / sperren	`Tenant.status`	abbildbar, Statusmodell abweichend
Tenant-Konfiguration prüfen	`Tenant` plus Plan-/Limitfelder	teilweise abbildbar
systemweite Vorlagen UC07	`NotificationTemplate`	abbildbar, aber ohne Versionierung
Portal-Grundeinstellungen UC06	kein eigenes Settings-Modell	teilweise offen
Support-/Diagnoseübersicht	`SystemLog`, `AuthLog`, `AuditLog`, `AccessLog`	teilweise abbildbar
Audit-Ansicht	`AuditLog`, `DeletionLog`, `AccessLog`	abbildbar
Plattformstatus	`SystemLog`	teilweise abbildbar
Tenant-Module	kein `tenant_modules`	offen
Tenant-Settings	kein `tenant_settings`	offen
Supportzugriffe	kein `support_access_log`	offen

4. Feld-für-Feld-Bewertung¶

4.1 Tenant¶

Vorhandene Felder:

slug,
name,
country,
planType,
status,
trialEndsAt,
Trial-Limits,
Kontaktfelder,
createdById,
updatedById,
deletedAt,
vectorClock.

Bewertung:

Die grundlegende Tenant-Verwaltung ist abbildbar.
Die Spezifikation nennt Statuswerte draft, active, suspended, locked, archived, deleted_pending; Prisma v3 nutzt pending, active, suspended, deactivated.
Das Statusmodell muss angeglichen oder bewusst übersetzt werden.

4.2 User / Rollen¶

Vorhanden:

UserRole.superadmin,
User.tenantId optional,
UserStatus,
2FA-Felder,
Auth-/Refresh-Token-Struktur.

Bewertung:

Superadmin-Rolle ist abbildbar.
Superadmin ohne Tenant ist möglich.

4.3 Systemvorlagen und Standardregeln¶

Vorhanden:

NotificationTemplate,
NotificationRule.

Bewertung:

Systemweite Templates sind abbildbar.
NotificationRule ist aktuell tenantgebunden, nicht systemweit. Die UC-SA-Spezifikation nennt systemweite Standardregeln als vorbereitet.
Versionierung von Systemvorlagen ist nicht modelliert.

4.4 Support und Diagnose¶

Vorhanden:

SystemLog,
AuthLog,
AuditLog,
AccessLog,
DeletionLog.

Bewertung:

Grundlegende Diagnose ist möglich.
Ein eigenes support_access_log fehlt, obwohl die Spezifikation Supporteinsicht als streng protokolliert fordert.

5. Relevante Abweichungen / offene Designpunkte¶

Punkt	Bewertung	Empfehlung
TenantStatus weicht von Spezifikation ab	relevant	Statusmodell angleichen oder Mapping dokumentieren
kein `tenant_settings`	relevant für Portal-/Modulkonfiguration	V1-Minimalmodell prüfen
kein `tenant_modules`	relevant für Modulfreischaltung	V1-Minimalmodell prüfen
keine systemweiten `notification_rules`	Spezifikation vorbereitet	`tenantId` optional machen oder eigene Systemregeln V2
keine Template-Versionierung	Spezifikation fordert Nachvollziehbarkeit	Versionierung prüfen oder AuditLog verwenden
kein `support_access_log`	sicherheitsrelevant	eigenes Log-Modell prüfen
Billing ausserhalb V1	korrekt abgegrenzt	keine Aktion

6. Ergebnis¶

UC-SA ist im Prisma-Zielschema v3 für grundlegende V1-Superadmin-Funktionen konzeptionell abbildbar.

UC-SA ist nicht vollständig gemäss Spezifikation abgebildet, wenn Tenant-Settings, Tenant-Module, systemweite Regeln, Template-Versionierung und Supportzugriffsprotokoll als V1-Pflicht gelten.

Korrekte Statusformulierung:

UC-SA ist gegen die vorhandene Spezifikation geprüft. Das Prisma-Zielschema v3 deckt den V1-Kern für Tenantverwaltung, Superadmin-Rolle und Logs ab; offene Designpunkte bestehen bei Tenant-Settings, Tenant-Modulen, systemweiten Regeln, Template-Versionierung und Supportzugriffsprotokoll.

7. Offene Nacharbeit¶

[ ] TenantStatus mit UC-SA-Spezifikation abgleichen.
[ ] Entscheidung: tenant_settings in V1 ergänzen oder explizit V2.
[ ] Entscheidung: tenant_modules in V1 ergänzen oder explizit V2.
[ ] Entscheidung: systemweite notification_rules über nullable tenantId oder eigene Tabelle.
[ ] Entscheidung: Template-Versionierung über eigene Felder oder AuditLog.
[ ] Entscheidung: support_access_log ergänzen oder über AccessLog ausreichend abbilden.
[ ] Technische Prisma-Validierung bleibt offen.