UC18 – Equipment-Verleih
Stand: 01.08.2026 14:55
Branch: docs/einheitliche-kopfbereiche
Status: Spezifikation
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 01.08.2026 14:55 |
0.1 |
Kopfbereich vereinheitlicht |
David Mittig |
| Mai 2026 |
0.1 |
Initiale Spezifikation für UC18 Equipment-Verleih erstellt |
David Mittig |
Spezifikationsdatei – Leitdokument für Entwicklung, Testing und Abnahme
Review: offen
Status-Übersicht
| Schritt |
Bezeichnung |
Status |
Kommentar |
| 1 |
Steckbrief |
✅ Abgeschlossen |
Fachlicher Rahmen definiert |
| 2 |
Scope & Abgrenzung |
✅ Abgeschlossen |
Eigenes V2-Zusatzmodul auf Basis UC01 |
| 3 |
Ablaufbeschreibung |
🟡 In Bearbeitung |
Erster Entwurf vorhanden |
| 4 |
Datenmodell |
🟡 In Bearbeitung |
Tabellen und Regeln als Vorbereitung beschrieben |
| 5 |
Backend |
⬜ Offen |
Nach V2-Priorisierung |
| 6 |
Frontend |
⬜ Offen |
Nach Screen-Ausarbeitung RL-01 bis RL-10 |
| 7 |
Testing |
⬜ Offen |
Nach API- und UI-Entscheid |
Legende: ✅ Abgeschlossen | 🟡 In Bearbeitung | 🔴 Blockiert | ⬜ Offen
1. Steckbrief
| Feld |
Inhalt |
| UC-ID |
UC18 |
| Name |
Equipment-Verleih |
| Version |
V2 |
| Zielgruppe |
Tauchschule |
| Primärakteur |
mitarbeiter |
| Sekundärakteur |
tenant_admin |
| Reifegrad |
V2-Erweiterung |
| Modulart |
Optionales Zusatzmodul |
| Priorität |
Mittel – praxisnahes Folge-Modul auf Basis des Equipment-Core |
1.1 Ziel
UC18 ermöglicht Tauchschulen, Equipment an Kunden, Kursteilnehmer oder interne Mitarbeiter auszugeben, Rückgaben zu dokumentieren und Zustand, Verfügbarkeit sowie Historie nachvollziehbar zu führen.
Der Use Case setzt auf UC01 Equipment erfassen auf. UC18 verändert den Equipment-Core nicht, sondern ergänzt Verleihvorgänge, Verleihpositionen, Zustandsprotokolle und spätere Berichte.
2. Scope & Abgrenzung
2.1 Gehört zu UC18
| Bereich |
Enthalten |
| Verleihvorgang erstellen |
Ja |
| Kunde / Empfänger zuordnen |
Ja |
| Equipment per Suche oder QR-Code hinzufügen |
Ja |
| Verfügbarkeit prüfen |
Ja |
| Ausgabezustand erfassen |
Ja |
| Rückgabezustand erfassen |
Ja |
| Schäden / fehlende Teile dokumentieren |
Ja |
| Überfällige Rückgaben anzeigen |
Ja |
| Verleihhistorie je Equipment |
Ja |
| Verleihhistorie je Kunde |
Ja |
| Verleihbericht / Export vorbereiten |
Ja |
| Offline-Ausgabe / Offline-Rückgabe vorbereiten |
Ja |
2.2 Gehört nicht zu UC18
| Bereich |
Zuständigkeit / Hinweis |
| Equipment-Stammdaten erfassen |
UC01 |
| Equipment-TÜV / externe Prüfung |
UC02 |
| Füll-Abo / Füllkarten |
UC03 |
| Inhouse-Service |
UC04 |
| Fristen-Dashboard |
UC05 |
| Kundenportal |
UC06 |
| Preisabrechnung / Rechnung |
Späterer eigener Umfang, nicht Kern von UC18 V2 |
| Kaution / Zahlung |
Später prüfen |
| Digitale Unterschrift |
Später prüfen |
3. Fachliche Grundregeln
| ID |
Regel |
| G1 |
Nur Equipment des eigenen Tenants darf verliehen werden |
| G2 |
Nur erfasstes Equipment aus UC01 kann verliehen werden |
| G3 |
Equipment muss equipment_status = active haben |
| G4 |
Equipment muss data_quality_status = complete haben, sofern der Typ für Verleih relevante Pflichtdaten besitzt |
| G5 |
Equipment mit unknown darf nicht verliehen werden |
| G6 |
Equipment mit inactive, retired, archived oder deleted_at darf nicht verliehen werden |
| G7 |
Equipment mit sync_status = conflict darf nicht verliehen werden |
| G8 |
Ein Equipment darf nicht gleichzeitig in zwei aktiven Verleihvorgängen sein |
| G9 |
Zustand bei Ausgabe und Rückgabe wird separat protokolliert |
| G10 |
Der Stammdaten-Zustand wird nicht durch Rückgabezustand überschrieben, ohne explizite Entscheidung |
| G11 |
QR-Code ist der bevorzugte Scan-Weg für Equipment-Auswahl |
| G12 |
Historie bleibt erhalten, auch wenn Equipment später archiviert wird |
| G13 |
Änderungen werden auditierbar protokolliert |
| G14 |
Offline-Ausgabe und Offline-Rückgabe sollen vorbereitet werden |
4. Akteure und Rollen
| Rolle |
Rechte in UC18 |
tenant_admin |
Verleihvorgänge erstellen, bearbeiten, abschliessen, stornieren, Berichte abrufen |
mitarbeiter |
Verleih ausgeben, Rückgabe erfassen, Zustand dokumentieren |
kunde |
In V2 optional nur indirekt betroffen; Kundenportal-Anzeige später prüfen |
| System |
Verfügbarkeit prüfen, Rückgaben als überfällig markieren, Sync-Konflikte erkennen |
5. Ablaufbeschreibung
5.1 Happy Path – Equipment verleihen
1. Benutzer öffnet Verleih-Übersicht.
2. Benutzer erstellt neuen Verleihvorgang.
3. Benutzer wählt Kunde oder internen Empfänger.
4. Benutzer setzt Ausgabe- und geplantes Rückgabedatum.
5. Benutzer scannt oder sucht Equipment.
6. System prüft Verfügbarkeit und Workflow-Fähigkeit.
7. Benutzer dokumentiert Ausgabezustand je Equipment.
8. Benutzer speichert Ausgabe.
9. System markiert Verleihvorgang als aktiv.
10. Equipment ist während des Verleihs nicht erneut verleihbar.
5.2 Happy Path – Equipment zurücknehmen
1. Benutzer öffnet aktiven Verleihvorgang.
2. Benutzer startet Rückgabe.
3. Benutzer scannt oder bestätigt zurückgegebenes Equipment.
4. Benutzer dokumentiert Rückgabezustand.
5. System prüft fehlende Teile oder Schäden.
6. Benutzer erfasst Notiz oder Schaden.
7. Benutzer schliesst Rückgabe ab.
8. System markiert Equipment wieder als verfügbar, sofern keine Sperre nötig ist.
9. Verleihhistorie wird aktualisiert.
6. Statusmodell Verleih
| Status |
Bedeutung |
draft |
Verleih ist vorbereitet, aber noch nicht ausgegeben |
active |
Equipment ist ausgegeben |
overdue |
Geplante Rückgabe ist überschritten |
returned |
Alles zurückgegeben und abgeschlossen |
partially_returned |
Ein Teil wurde zurückgegeben |
damaged |
Schaden oder Problem dokumentiert |
cancelled |
Verleih wurde storniert |
7. Verfügbarkeit und Sperren
7.1 Equipment ist verleihbar, wenn
| Bedingung |
Muss erfüllt sein? |
| Tenant stimmt überein |
Ja |
| Equipment existiert |
Ja |
equipment_status = active |
Ja |
data_quality_status = complete |
Ja, sofern für Verleih relevant |
equipment_type != unknown |
Ja |
| Kein aktiver Verleih vorhanden |
Ja |
| Kein Sync-Konflikt |
Ja |
| Keine harte Sperre durch Service / Prüfung |
Ja, falls entsprechender Workflow aktiv ist |
7.2 Equipment ist nicht verleihbar bei
| Zustand |
Wirkung |
unknown |
Blockieren |
incomplete |
Blockieren oder nur nach tenant-spezifischer Regel erlauben |
needs_review |
Standard: blockieren |
inactive |
Blockieren |
retired |
Blockieren |
archived |
Blockieren |
deleted_at gesetzt |
Blockieren |
sync_status = conflict |
Blockieren |
| aktiver Verleih |
Blockieren |
8. Zustandsdokumentation
Der Zustand wird pro Verleihvorgang getrennt erfasst.
| Zeitpunkt |
Inhalt |
| Ausgabe |
Zustand, Foto optional, Notiz, Benutzer, Datum/Zeit |
| Rückgabe |
Zustand, Foto optional, Notiz, Benutzer, Datum/Zeit |
| Schaden |
Beschreibung, Foto optional, fehlende Teile, Folgeaktion |
Beispiel:
| Zeitpunkt |
Beispiel |
| Ausgabe |
Zustand: gut, Notiz: kleine Gebrauchsspuren, Foto vor Ausgabe |
| Rückgabe |
Zustand: beschädigt, Notiz: Schnalle defekt, Foto nach Rückgabe |
9. Datenmodell-Vorbereitung
| Tabelle |
Zweck |
rental_transactions |
Kopfdatensatz eines Verleihvorgangs |
rental_items |
Equipment-Positionen innerhalb eines Verleihvorgangs |
rental_condition_logs |
Ausgabe- und Rückgabezustand je Position |
equipment |
Bestehender Equipment-Core aus UC01 |
customers |
Kunde / Empfänger |
equipment_notes |
Ergänzende Notizen |
audit_log |
Auditierbare Änderungen |
sync_queue |
Offline-Synchronisierung |
9.1 Beispielhafte Felder rental_transactions
| Feld |
Bedeutung |
id |
UUID |
tenant_id |
Tenant-Isolation |
customer_id |
Kunde oder Mitarbeiter-Kundendatensatz |
rental_status |
draft, active, overdue, returned, ... |
issued_at |
Ausgabezeitpunkt |
planned_return_at |
Geplante Rückgabe |
returned_at |
Tatsächliche Rückgabe |
created_by |
Benutzer |
notes |
Allgemeine Notiz |
9.2 Beispielhafte Felder rental_items
| Feld |
Bedeutung |
id |
UUID |
rental_transaction_id |
Bezug zum Verleihvorgang |
equipment_id |
Bezug zum Equipment |
item_status |
ausgegeben, zurückgegeben, beschädigt, verloren |
added_by |
Benutzer |
added_at |
Zeitpunkt |
9.3 Beispielhafte Felder rental_condition_logs
| Feld |
Bedeutung |
id |
UUID |
rental_item_id |
Bezug zur Verleihposition |
event_type |
issue, return, damage |
condition |
Zustand |
photo_id |
Optionales Foto |
note |
Fachliche Notiz |
created_by |
Benutzer |
created_at |
Zeitpunkt |
10. Screen-Flow & Wireframes
| Screen |
Bezeichnung |
Zweck |
Status |
| RL-01 |
Verleih-Übersicht |
Offene, geplante, überfällige und abgeschlossene Verleihe anzeigen |
Offen |
| RL-02 |
Neuen Verleih erstellen |
Kunde, Zeitraum und Grunddaten erfassen |
Offen |
| RL-03 |
Equipment per QR-Code hinzufügen |
Equipment per QR-Code oder Suche zum Verleih hinzufügen |
Offen |
| RL-04 |
Ausgabezustand erfassen |
Zustand, Foto und Notiz bei Ausgabe dokumentieren |
Offen |
| RL-05 |
Rückgabe erfassen |
Rückgabezeitpunkt und zurückgegebenes Equipment erfassen |
Offen |
| RL-06 |
Schäden / fehlende Teile dokumentieren |
Abweichungen, Schäden, Verlust oder fehlendes Zubehör erfassen |
Offen |
| RL-07 |
Überfällige Rückgaben |
Überfällige Verleihe prüfen und nachverfolgen |
Offen |
| RL-08 |
Verleihhistorie je Equipment |
Historie eines einzelnen Equipments anzeigen |
Offen |
| RL-09 |
Verleihhistorie je Kunde |
Historie eines Kunden anzeigen |
Offen |
| RL-10 |
Verleihbericht / Export |
Verleihdaten auswerten und exportieren |
Offen |
11. Beziehungen zu bestehenden Use Cases
| Use Case |
Beziehung |
| UC01 Equipment erfassen |
Grundlage: Equipment-Core, QR-Code, Status, Datenqualität |
| UC05 Fristen-Dashboard |
Fristen können Verleihfähigkeit beeinflussen |
| UC06 Kunden einladen & Portal |
Spätere Anzeige ausgeliehener Ausrüstung im Kundenportal möglich |
| UC07 Benachrichtigungen |
Rückgabe-Erinnerungen und überfällige Rückgaben möglich |
| UC09 Berichte & Export |
Verleihberichte und Auslastungsauswertungen möglich |
| UC16 Eigene Equipment-Typen verwalten |
Verleihregeln je Equipment-Typ später möglich |
12. Offline-Anforderungen
| Aktion |
Offline sinnvoll? |
Bemerkung |
| Neuen Verleih vorbereiten |
Ja |
Kunde und Equipment müssen lokal verfügbar sein |
| Equipment per QR-Code hinzufügen |
Ja |
QR-Code muss lokal auflösbar sein |
| Ausgabezustand erfassen |
Ja |
Foto / Notiz lokal speichern |
| Rückgabe erfassen |
Ja |
Rückgabe vor Ort muss möglich sein |
| Sync-Konflikt lösen |
Nein / eingeschränkt |
Besser online |
| Berichte exportieren |
Nein / optional |
Nicht Kern der Offline-Funktion |
Empfohlene Sync-Werte:
| Wert |
Bedeutung |
local_only |
Nur lokal angelegt |
pending_sync |
Synchronisierung ausstehend |
synced |
Synchronisiert |
conflict |
Konflikt muss geprüft werden |
13. Offene Fragen / Entscheide
| ID |
Frage |
Empfehlung / Status |
| OE1 |
Wird Preislogik in UC18 V2 aufgenommen? |
Offen; Kern-Verleih zunächst ohne Abrechnung |
| OE2 |
Wird Kaution erfasst? |
Später prüfen |
| OE3 |
Wird eine digitale Unterschrift benötigt? |
Später prüfen |
| OE4 |
Wird Kundenportal-Anzeige in V2 umgesetzt? |
Mit UC06 abstimmen |
| OE5 |
Welche Equipment-Typen sind verleihbar? |
Tenant-Regeln oder Typ-Konfiguration vorbereiten |
| OE6 |
Dürfen needs_review-Datensätze verliehen werden? |
Standard: Nein |
| OE7 |
Wie wird Zustand nach Rückgabe auf Equipment-Stammdaten übertragen? |
Nur explizit, nicht automatisch |
| OE8 |
Werden Fotos bei Ausgabe/Rückgabe Pflicht? |
Optional in V2, später konfigurierbar |
| OE9 |
Wird Etiketten- / QR-Druck mit UC18 gekoppelt? |
UC01 / EQ-09 liefert Grundlage |
| OE10 |
Gibt es Batch-Ausgabe für Kurse? |
Später prüfen |
14. Änderungshistorie