DB-Schema-Detailprüfung UC05 – Fristen-Dashboard¶
Stand: 01.08.2026 14:55 Branch: docs/einheitliche-kopfbereiche Status: Abgeschlossen; Gegen vorhandene UC05-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/uc05/uc05-spezifikation.md,backend/prisma/schema.prismav3,docs/developer/uc00/db-schema-zielbild-uc-matrix.md,docs/developer/db-schema.mdv6,docs/management/roadmap.md.
Korrekturhinweis:
Die frühere Fassung dieser Detailprüfung enthielt die falsche Aussage, dass keine eigene UC05-Spezifikation gefunden wurde. Die Spezifikation existiert und wurde in dieser Nachprüfung berücksichtigt.
2. Fachlicher UC-Zweck aus der Spezifikation¶
UC05 stellt ein zentrales Dashboard bereit, das prüf-, service- und fristenrelevante Informationen sichtbar macht.
Das Dashboard zeigt insbesondere bald fällige, heute fällige, überfällige, gesperrte oder in einem laufenden Prüf- oder Serviceprozess befindliche Equipment-Datensätze.
3. Spezifikationsanforderungen gegen Prisma-Zielschema¶
| Anforderung UC05 | Prisma-Zielschema v3 | Bewertung |
|---|---|---|
| Fristenübersicht je Tenant | tenantId in Fachobjekten |
abbildbar |
| TÜV-Fristen Flaschen | CylinderDetails.tuvNext |
abbildbar |
| Servicefristen Regler | RegulatorDetails.nextService |
abbildbar |
| gesperrtes Equipment | Equipment.status, isArchived, deletedAt |
abbildbar |
| laufende Prüf-/Serviceprozesse | UsecaseWorkflow.status, usecaseType |
abbildbar |
| Filter nach Equipment-Typ | Equipment.equipmentType |
abbildbar |
| Filter nach Kunde | Equipment.customerId, Customer |
abbildbar |
| Filter nach Zeitraum | über Fristfelder berechenbar | abbildbar |
| Benachrichtigungsvorschau | NotificationRule, NotificationLog, NotificationTemplate |
teilweise abbildbar |
| Exportvorbereitung | kein eigenes Exportmodell | für V1 akzeptabel |
berechnete Felder next_due_date, due_status |
nicht gespeichert | bewusst berechenbar |
4. Feld-für-Feld-Bewertung¶
4.1 Fristenquellen¶
Abbildbar über:
CylinderDetails.tuvNext,CylinderDetails.tuvLast,RegulatorDetails.nextService,RegulatorDetails.lastService,RegulatorDetails.serviceIntervalMonths.
Bewertung:
- Die wichtigsten Fristenquellen der Spezifikation sind vorhanden.
4.2 Status- und Filterlogik¶
Abbildbar über:
Equipment.status,Equipment.dataQualityStatus,Equipment.assignmentType,Equipment.isArchived,Equipment.deletedAt,UsecaseWorkflow.status,UsecaseWorkflow.usecaseType.
Bewertung:
- UC05 ist für V1 konzeptionell abbildbar.
- Die spezifizierten Dashboard-Statuswerte
ok,due_soon,due_today,overdue,blocked,in_progress,unknownsind berechnete Werte und nicht als Enum gespeichert.
4.3 Benachrichtigungsvorschau¶
Abbildbar über:
NotificationRule,NotificationLog,NotificationTemplate.
Bewertung:
- Für V1 vorbereitet.
- Eine echte Queue oder Vorschlagstabelle ist im Prisma-Zielschema nicht enthalten.
5. Relevante Abweichungen / offene Designpunkte¶
| Punkt | Bewertung | Empfehlung |
|---|---|---|
| Dashboard-Statuswerte nicht als DB-Enum | akzeptabel, wenn berechnet | im Backend klar definieren |
| keine gespeicherten Views / Filter | V1 nicht zwingend | später prüfen |
| keine Notification-Queue | UC07-Spezifikation prüfen | ggf. V1-light bewusst ohne Queue |
| Servicefristen für weitere Equipment-Typen | nur Regler explizit | für Jacket/sonstige Typen über customData oder späteres Modell klären |
6. Ergebnis¶
UC05 ist im Prisma-Zielschema v3 gemäss vorhandener Spezifikation für V1 konzeptionell abbildbar.
Es bestehen keine harten Schema-Blocker für UC05. Die wichtigsten offenen Punkte liegen in Backend-Berechnung, UI-Logik, Benachrichtigungsvorschau und späterer Spezifikation von gespeicherten Filtern oder Views.
Korrekte Statusformulierung:
UC05 ist gegen die vorhandene Spezifikation geprüft. Das Prisma-Zielschema v3 deckt die V1-Datenbasis für das Fristen-Dashboard konzeptionell ab; technische Validierung und Backend-Berechnungslogik sind offen.
7. Offene Nacharbeit¶
- [ ] Backend-Berechnungslogik für
due_status,days_until_due,is_overdue,has_active_workflowdefinieren. - [ ] Entscheidung: Benachrichtigungsvorschläge nur berechnen oder persistieren.
- [ ] UC07-Abgleich zu Queue / Versandvorschlägen berücksichtigen.
- [ ] Technische Prisma-Validierung bleibt offen.