DB-Schema-Detailprüfung UC04 – Inhouse-Service erfassen¶

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 UC04-Spezifikationsdatei wurde im Repository nicht gefunden. Die Prüfung basiert deshalb auf Roadmap, Zielmatrix und Prisma-Zielschema.

2. Fachlicher UC-Zweck¶

UC04 bildet intern durchgeführte Servicearbeiten ab, insbesondere an Atemreglern und weiteren Equipment-Typen.

Kernobjekte:

Equipment,
Reglerdetails,
Workflow,
Workflow-Historie,
Service-Ergebnis,
Kosten und Notizen,
Auditierbarkeit.

3. Benötigte Schemaobjekte¶

Bedarf	Prisma-Objekt	Status
Equipment-Stammdatensatz	`Equipment`	vorhanden
Reglerdetails	`RegulatorDetails`	vorhanden
Workflow	`UsecaseWorkflow`	vorhanden
Workflow-Typ Regler-Service	`UsecaseType.regulator_service`	vorhanden
Workflow-Typ Inhouse-Service	`UsecaseType.inhouse_service`	vorhanden
Workflow-Historie	`WorkflowHistory`	vorhanden
ausführender Mitarbeiter	`User` über `assignedToId`	vorhanden
Ergebnisnotiz	`UsecaseWorkflow.resultNotes`	vorhanden
Kosten	`costAmount`, `costCurrency`	vorhanden
Sperr-/Korrekturlogik	`isLocked`, `correctionOfId`, `correctionNote`	vorhanden
Audit	`AuditLog`	vorhanden

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

4.1 Equipment¶

UC04 kann auf Equipment mit relevanten Typen angewendet werden, zum Beispiel:

regulator,
bcd,
jacket,
computer,
other.

Bewertung:

Equipment-Basis ist konzeptionell ausreichend.
Spezifische Detailtabellen gibt es nur für Regler, nicht für alle Equipment-Typen.
Für V1 ist das akzeptabel, sofern weitere Typdetails über customData abgebildet werden.

4.2 RegulatorDetails¶

Abbildbare Felder:

stages,
dinOrYoke,
firstStageSerial,
secondStageSerial,
hasOctopus,
lastService,
nextService,
serviceIntervalMonths.

Bewertung:

Regler-Service ist konzeptionell abbildbar.
Die vorher identifizierten UC01-Lücken zu Seriennummern der Stufen und Oktopus sind im Prisma-Zielschema v3 ergänzt.

4.3 UsecaseWorkflow¶

Abbildbare Felder:

usecaseType = regulator_service oder inhouse_service,
equipmentId,
customerId,
assignedToId,
status,
resultDate,
resultNotes,
costAmount,
costCurrency,
openedAt,
completedAt,
isLocked,
correctionOfId,
correctionNote.

Bewertung:

Der Serviceworkflow ist konzeptionell ausreichend abbildbar.
Für detaillierte Service-Checklisten gibt es noch keine eigene Tabelle.

5. Offene Punkte¶

Punkt	Bewertung
Eigene UC04-Spezifikation fehlt	sollte später ergänzt werden
Service-Checklisten	nicht als eigene Tabelle vorhanden
Ersatzteile / Arbeitspositionen	nicht V1-abgebildet
Dokumente / Fotos	bewusst V2 über `documents`
RLS-Policy je Workflow-Tabelle	technisch noch offen
Migration / SQL-Script	noch nicht nachgezogen
Technische Prisma-Validierung	offen

6. Ergebnis¶

UC04 ist im Prisma-Zielschema v3 konzeptionell abbildbar.

Die V1-Abdeckung ist ausreichend für einfache Inhouse-Service-Erfassung. Komplexe Service-Checklisten, Ersatzteile und Dokumente bleiben späteren Erweiterungen vorbehalten.

Korrekte Statusformulierung:

UC04 ist gegen das Prisma-Zielschema v3 konzeptionell geprüft und für V1-Minimalumfang abbildbar; technische Validierung und detaillierte UC04-Spezifikation sind offen.