Zum Inhalt

DB-Schema-Detailprüfung UC09 – Berichte & Export

Stand: 01.08.2026 14:55 Branch: docs/einheitliche-kopfbereiche Status: Abgeschlossen; Konzeptionell gegen Prisma-Zielschema v3 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:

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

Eine eigene UC09-Spezifikationsdatei wurde im Repository nicht gefunden. Die Prüfung basiert deshalb auf Roadmap, Zielmatrix und Prisma-Zielschema.

2. Fachlicher UC-Zweck

UC09 bildet einfache Berichte und Exporte für V1 ab.

Kernobjekte:

  • Kunden,
  • Equipment,
  • Workflows,
  • Fristen,
  • Füllkarten / Füll-Abos,
  • Audit- und Systemlogs,
  • Export ohne eigenes Report-Designer-Modul.

3. Benötigte Schemaobjekte

Bedarf Prisma-Objekt Status
Kundendaten Customer vorhanden
Equipmentdaten Equipment, Detailtabellen vorhanden
TÜV-/Service-Workflows UsecaseWorkflow, WorkflowHistory vorhanden
Fristen CylinderDetails, RegulatorDetails vorhanden
Benachrichtigungen NotificationLog vorhanden
Füll-Abo/Füllkarten FillSubscription, FillCard, FillCardTransaction vorhanden
Audit AuditLog vorhanden
Zugriffsnachweise AccessLog vorhanden
Löschprotokolle DeletionLog vorhanden
Auth-Ereignisse AuthLog vorhanden
Systemereignisse SystemLog vorhanden

4. Feld-für-Feld-Bewertung

4.1 Stammdatenexporte

Abbildbar über:

  • Customer,
  • Equipment,
  • CylinderDetails,
  • RegulatorDetails,
  • EquipmentIdentifier,
  • EquipmentNote.

Bewertung:

  • V1-Stammdatenexporte sind konzeptionell abbildbar.

4.2 Workflow- und Fristenberichte

Abbildbar über:

  • UsecaseWorkflow,
  • WorkflowHistory,
  • CylinderDetails.tuvNext,
  • RegulatorDetails.nextService,
  • NotificationLog.

Bewertung:

  • Einfache Berichte zu offenen, abgeschlossenen und fälligen Vorgängen sind konzeptionell abbildbar.

4.3 Compliance- und Auditberichte

Abbildbar über:

  • AuditLog,
  • AccessLog,
  • DeletionLog,
  • AuthLog,
  • SystemLog.

Bewertung:

  • Nachweise sind grundsätzlich vorhanden.
  • Ein eigener Reporting-Snapshot oder Export-Job ist nicht modelliert, für V1 aber nicht zwingend.

5. Offene Punkte

Punkt Bewertung
Eigene UC09-Spezifikation fehlt sollte später ergänzt werden
Report-Templates / gespeicherte Berichte nicht V1
Export-Jobs / Export-Historie nicht modelliert
PDF-Erzeugung Backend-/Service-Thema, nicht DB-Kern
CSV/XLSX-Export Backend-/Service-Thema, nicht DB-Kern
RLS bei Exporten technisch kritisch, noch umzusetzen
Migration / SQL-Script noch nicht nachgezogen
Technische Prisma-Validierung offen

6. Ergebnis

UC09 ist im Prisma-Zielschema v3 konzeptionell abbildbar.

Die V1-Abdeckung ist ausreichend für einfache Berichte und Exporte. Ein konfigurierbarer Reportgenerator bleibt V2/V3.

Korrekte Statusformulierung:

UC09 ist gegen das Prisma-Zielschema v3 konzeptionell geprüft und für einfache V1-Berichte/Exporte abbildbar; technische Validierung und detaillierte UC09-Spezifikation sind offen.