UC05 – Fristen-Dashboard
Stand : 2026-08-01, 11:12:55
Branch: main
Status: Abgeschlossen
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 01.08.2026 11:12 |
1.0 |
Kopfbereich ergänzt |
David |
Spezifikationsdatei – Leitdokument für Entwicklung, Testing und Abnahme
Stand: Mai 2026 | Version: 0.1
Autor: David | Review: offen
Status-Übersicht
| Schritt |
Bezeichnung |
Status |
Kommentar |
| 1 |
Steckbrief |
✅ Erstellt |
fachlicher Rahmen für UC05 definiert |
| 2 |
Scope & Abgrenzung |
✅ Erstellt |
Dashboard, Fristenlogik und Eskalationen abgegrenzt |
| 3 |
Rollenmodell |
🟡 In Bearbeitung |
tenant_admin und mitarbeiter vorbereitet |
| 4 |
Fristenlogik |
🟡 In Bearbeitung |
Grundmodell für fällig, bald fällig, überfällig vorbereitet |
| 5 |
Statusmodell |
🟡 In Bearbeitung |
Ampel- und Prioritätslogik vorbereitet |
| 6 |
Datenmodell-Vorbereitung |
🟡 In Bearbeitung |
Datenquellen und mögliche Aggregation beschrieben |
| 7 |
Screen-Flow FR-01 bis FR-08 |
⬜ Offen |
Screen-Dokumente noch nicht erstellt |
| 8 |
Review / Quality Gate |
⬜ Offen |
nach Screen-Ausarbeitung durchführen |
Legende: ✅ Erstellt | 🟡 In Bearbeitung | 🔴 Blockiert | ⬜ Offen
1. Steckbrief
| Feld |
Inhalt |
| UC-ID |
UC05 |
| Name |
Fristen-Dashboard |
| Version |
V1 MVP |
| Zielgruppe |
Tauchschule |
| Primärakteur |
tenant_admin |
| Sekundärakteur |
mitarbeiter |
| Betroffener Akteur |
kunde |
| Systemakteur |
Fristenberechnung / Benachrichtigungsmodul |
| Reifegrad V1 |
fachliche Spezifikation gestartet |
| Priorität |
Hoch |
1.1 Ziel
UC05 stellt ein zentrales Dashboard bereit, das prüf-, service- und fristenrelevante Informationen sichtbar macht.
Das Fristen-Dashboard soll einem Tenant schnell zeigen, welche Equipment-Datensätze bald fällig, bereits überfällig, gesperrt oder in einem laufenden Prüf- oder Serviceprozess sind.
UC05 ist damit ein operatives Steuerungsinstrument für den Alltag der Tauchschule und zugleich Grundlage für UC07 Benachrichtigungen.
2. Scope & Abgrenzung
2.1 Gehört zu UC05 V1
| Bereich |
Enthalten |
| Fristenübersicht je Tenant |
Ja |
| TÜV-/Prüffristen für Flaschen |
Ja |
| Servicefristen für Equipment |
vorbereitet |
| bald fällige Fristen anzeigen |
Ja |
| überfällige Fristen anzeigen |
Ja |
| gesperrtes Equipment anzeigen |
Ja |
| laufende Prüf- oder Serviceprozesse anzeigen |
Ja |
| Filter nach Friststatus |
Ja |
| Filter nach Equipment-Typ |
Ja |
| Filter nach Kunde |
Ja |
| Filter nach Zeitraum |
Ja |
| Drilldown zu Equipment |
Ja |
| Drilldown zu Workflow / Prüfvorgang |
Ja |
| Kennzahlen-Kacheln |
Ja |
| Export vorbereiten |
Ja, Bezug zu UC09 |
| Benachrichtigungsvorschau |
vorbereitet, Bezug zu UC07 |
2.2 Gehört nicht zu UC05 V1
| Bereich |
Hinweis |
| Versand von Benachrichtigungen |
UC07 |
| vollständiger Reportgenerator |
UC09 / V2 |
| Änderung von Prüfergebnissen |
UC02 |
| Equipment-Erfassung |
UC01 |
| Kundenportal-Anzeige |
UC06 |
| direkte Rechnungsstellung |
nicht V1 |
| externe Prüfstellen-Integration |
spätere Vision |
| frei konfigurierbare Dashboard-Widgets |
später prüfen |
3. Bezug zu anderen Use Cases
| UC |
Bezug |
| UC01 – Equipment erfassen |
liefert Equipment-Stammdaten, Eigentümer, Typ und Fristfelder |
| UC02 – TÜV-Inspektion einreichen |
liefert Prüfstatus, Prüfhistorie und nächste Prüffrist |
| UC03 – Füll-Abo & Füllkarten-Verwaltung |
indirekter Bezug, aktuell keine Fristlogik im Füllkonto |
| UC04 – Inhouse-Service erfassen |
späterer Servicefristen-Bezug |
| UC06 – Kunden einladen & Portal |
Kunde kann später Fristen im Portal sehen |
| UC07 – Benachrichtigungen |
nutzt Fristen aus UC05 als Auslöser |
| UC09 – Berichte & Export |
exportiert Fristenlisten und Statusübersichten |
| UC08 – Benutzerverwaltung |
regelt Zugriff für tenant_admin und mitarbeiter |
4. Rollenmodell V1
| Rolle |
Bedeutung für UC05 |
tenant_admin |
sieht vollständiges Fristen-Dashboard des eigenen Tenants und kann Einstellungen prüfen |
mitarbeiter |
sieht operative Fristenlisten und kann Vorgänge öffnen |
kunde |
sieht in UC05 keine interne Ansicht; spätere Kundensicht über UC06 |
superadmin |
kein Zielnutzer des Tenant-Dashboards; Plattformansicht später in UC-SA |
4.1 Rollenrechte V1
| Aktion |
tenant_admin |
mitarbeiter |
kunde |
| Dashboard öffnen |
Ja |
Ja |
Nein |
| alle Fristen des Tenants sehen |
Ja |
Ja / abhängig von Tenant-Regel |
Nein |
| Equipment-Detail öffnen |
Ja |
Ja |
Nein |
| Workflow öffnen |
Ja |
Ja |
Nein |
| Fristenfilter speichern |
Ja |
optional |
Nein |
| Benachrichtigungsvorschau prüfen |
Ja |
optional |
Nein |
| Export starten |
Ja |
optional / offen |
Nein |
5. Fristenlogik
5.1 Grundbegriffe
| Begriff |
Bedeutung |
| nächste Frist |
Datum, an dem Prüfung oder Service spätestens fällig ist |
| bald fällig |
Frist liegt innerhalb eines definierten Warnzeitraums |
| überfällig |
Fristdatum liegt in der Vergangenheit |
| gesperrt |
Equipment darf fachlich nicht mehr genutzt werden |
| in Prüfung |
laufender Prüf- oder Serviceworkflow existiert |
| erledigt |
Prüfung / Service wurde abgeschlossen und neue Frist berechnet |
5.2 Standard-Warnzeiträume V1
| Zeitraum |
Bedeutung |
Vorschlag |
| 0 Tage |
heute fällig |
immer anzeigen |
| 30 Tage |
bald fällig |
V1-Standard |
| 60 Tage |
frühzeitige Planung |
optional vorbereitet |
| 90 Tage |
langfristige Planung |
optional vorbereitet |
5.3 Friststatus
| Status |
Bedingung |
Darstellung |
ok |
Frist liegt ausserhalb des Warnzeitraums |
grün / normal |
due_soon |
Frist liegt innerhalb des Warnzeitraums |
gelb |
due_today |
Frist ist heute fällig |
orange |
overdue |
Frist liegt in der Vergangenheit |
rot |
blocked |
Equipment ist gesperrt |
rot / kritisch |
in_progress |
Prüf- oder Serviceprozess läuft |
blau |
unknown |
Frist nicht berechenbar |
grau / prüfen |
6. Dashboard-Kennzahlen
| Kennzahl |
Beschreibung |
| Gesamtanzahl Equipment |
Anzahl relevanter Equipment-Datensätze im Tenant |
| bald fällig |
Anzahl Fristen innerhalb des Warnzeitraums |
| heute fällig |
Anzahl Fristen mit heutigem Datum |
| überfällig |
Anzahl Fristen in der Vergangenheit |
| gesperrt |
Anzahl gesperrter Equipment-Datensätze |
| in Prüfung / Service |
Anzahl laufender Workflows |
| unbekannte Fristen |
Datensätze mit fehlenden oder unklaren Fristdaten |
| Benachrichtigung offen |
vorbereiteter Bezug zu UC07 |
7. Filter und Sortierung
7.1 Filter
| Filter |
Beschreibung |
| Friststatus |
ok, due_soon, due_today, overdue, blocked, in_progress, unknown |
| Equipment-Typ |
Flasche, Regler, Jacket, sonstige Typen |
| Kunde |
Eigentümer / Kunde |
| Zeitraum |
heute, 30 Tage, 60 Tage, 90 Tage, frei |
| Workflowstatus |
kein Workflow, in Prüfung, abgeschlossen |
| Benachrichtigung |
offen, gesendet, nicht relevant |
7.2 Sortierung
| Sortierung |
Zweck |
| nächste Frist aufsteigend |
dringendste Fristen zuerst |
| Status-Priorität |
blocked / overdue zuerst |
| Kunde |
gruppierte Kundenansicht |
| Equipment-Typ |
operative Arbeitslisten |
| letzter Workflow |
Nachverfolgung laufender Vorgänge |
8. Datenmodell-Vorbereitung
8.1 Mögliche Datenquellen
| Quelle |
Bedeutung |
equipment |
Equipment-Stammdaten, Typ, Status, Kunde |
cylinder_details |
Flaschen- und Prüffristdaten |
regulator_details |
spätere Servicefristen für Regler |
usecase_workflows |
laufende Prüf- oder Serviceprozesse |
workflow_history |
Statusverlauf und Abschlussdaten |
notification_rules |
Warnzeiträume und Benachrichtigungslogik |
notification_log |
bereits ausgelöste Benachrichtigungen |
audit_log |
nachvollziehbare Änderungen |
8.2 Mögliche berechnete Felder
| Feld |
Beschreibung |
next_due_date |
nächste relevante Frist |
due_status |
berechneter Friststatus |
days_until_due |
Tage bis zur Frist |
is_overdue |
Frist überschritten |
is_blocked |
Equipment gesperrt |
has_active_workflow |
laufender Prüf- oder Serviceprozess existiert |
notification_state |
keine, offen, gesendet, blockiert |
9. Sicherheits- und Zugriffsregeln
| ID |
Regel |
| UC05-SEC-R01 |
Tenant-Isolation ist zwingend |
| UC05-SEC-R02 |
Ein Tenant sieht nur eigene Equipment- und Kundendaten |
| UC05-SEC-R03 |
Kunde sieht UC05 nicht direkt, sondern später eine reduzierte Portalansicht in UC06 |
| UC05-SEC-R04 |
Dashboard-Berechnungen dürfen keine fremden Tenant-Daten aggregieren |
| UC05-SEC-R05 |
Export darf nur berechtigten Rollen angeboten werden |
| UC05-SEC-R06 |
Änderungen an Fristgrundlagen müssen auditierbar sein, erfolgen aber nicht direkt in UC05 |
10. Screen-Flow FR-01 bis FR-08
| Screen |
Bezeichnung |
Zweck |
| FR-01 |
Fristen-Dashboard Übersicht |
Kennzahlen, Warnstatus und Einstieg in Fristenlisten |
| FR-02 |
Fristenliste / Arbeitsliste |
tabellarische Liste aller relevanten Fristen |
| FR-03 |
Fristdetail je Equipment |
Detailansicht einer Frist mit Equipment- und Workflowbezug |
| FR-04 |
Überfällige / gesperrte Fristen |
fokussierte Risikoansicht |
| FR-05 |
Bald fällige Fristen |
Planungsansicht für kommende Fristen |
| FR-06 |
Laufende Prüf- und Serviceprozesse |
Fristen mit aktivem Workflow |
| FR-07 |
Benachrichtigungsvorschau |
Vorbereitung für UC07, ohne Versandlogik |
| FR-08 |
Fristenexport vorbereiten |
Übergang zu UC09 / einfacher Export |
10.1 Empfohlener V1-Kern
| Screen |
Bewertung |
| FR-01 |
zwingend V1 |
| FR-02 |
zwingend V1 |
| FR-03 |
zwingend V1 |
| FR-04 |
zwingend V1 |
| FR-05 |
zwingend V1 |
| FR-06 |
sinnvoll V1 |
| FR-07 |
V1-light, wegen UC07 wichtig |
| FR-08 |
V1-light, wegen UC09 vorbereitet |
11. Akzeptanzkriterien UC05 V1
| ID |
Kriterium |
| UC05-AC01 |
tenant_admin kann Fristen-Dashboard öffnen |
| UC05-AC02 |
mitarbeiter kann operative Fristenübersicht öffnen |
| UC05-AC03 |
System zeigt bald fällige, heute fällige, überfällige und gesperrte Fristen |
| UC05-AC04 |
System berechnet Friststatus tenant-isoliert |
| UC05-AC05 |
System zeigt Kennzahlen zur Fristlage |
| UC05-AC06 |
Benutzer kann Fristen nach Status, Zeitraum, Equipment-Typ und Kunde filtern |
| UC05-AC07 |
Benutzer kann von einer Frist zum Equipment-Detail wechseln |
| UC05-AC08 |
Benutzer kann von einer Frist zu laufendem Workflow wechseln |
| UC05-AC09 |
UC05 löst in V1 keine Benachrichtigung direkt aus, sondern verweist auf UC07 |
| UC05-AC10 |
UC05 verändert Fristgrundlagen nicht direkt |
12. Offene Fragen / Restentscheidungen
| ID |
Frage |
Vorschlag / Status |
| UC05-O01 |
Standard-Warnzeitraum 30 Tage verbindlich? |
Vorschlag: Ja für V1 |
| UC05-O02 |
Sollen 60 / 90 Tage bereits auswählbar sein? |
Vorschlag: Ja als Filter, nicht als Regelkonfiguration |
| UC05-O03 |
Darf mitarbeiter alle Kundenfristen sehen? |
offen, wahrscheinlich Ja innerhalb Tenant |
| UC05-O04 |
Wird Regler-/Jacket-Service schon in V1 aktiv im Dashboard angezeigt? |
abhängig von UC04, vorbereiten |
| UC05-O05 |
Wird Export direkt in UC05 angeboten oder nur über UC09? |
Vorschlag: einfache Übergabe zu UC09 |
| UC05-O06 |
Wird unknown prominent angezeigt? |
Vorschlag: Ja, Datenqualität sichtbar machen |
| UC05-O07 |
Wird Kundensicht schon in UC05 vorbereitet? |
Nein, über UC06 |
| UC05-O08 |
Werden Benachrichtigungen direkt aus FR-07 ausgelöst? |
Nein, UC07 |
13. Nächster Schritt
Als nächstes sollten die Screen-Vorgaben unter folgendem Ordner angelegt werden:
docs/developer/uc05/screens/
Start mit:
FR-01 – Fristen-Dashboard Übersicht
Je Screen werden analog zu UC02, UC03 und UC08 drei Dateien erstellt: