docs: Maintenance-Epic komplettiert (MAINT-001..006)
CI / backend-tests (push) Failing after 1m55s
CI / frontend-build (push) Successful in 16s

Komplettes Epic fehlt in MABEA - kein Wartungskonzept vorhanden, nur Prüfung
(Inspections). Zusammen mit Warehouse und Digital File eines der drei Epics
mit größtem Umsetzungsaufwand, bewusst P2 (nicht MVP-kritisch).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KC8HYvv6UkCVYheYiTw9DD
This commit is contained in:
2026-09-05 15:32:37 +02:00
co-authored by Claude Sonnet 5
parent 81a727151a
commit 71dc679b57
2 changed files with 141 additions and 2 deletions
+3 -2
View File
@@ -215,6 +215,7 @@ eigenes Modul (MAINT-\*, MABEA hat nur Prüfung, keine Wartung)**.
| `07_warehouse.md` | WH-001 … WH-007 (vollständig) | | `07_warehouse.md` | WH-001 … WH-007 (vollständig) |
| `08_loadout.md` | LOAD-001 … LOAD-006 (vollständig) | | `08_loadout.md` | LOAD-001 … LOAD-006 (vollständig) |
| `09_inspections.md` | INSP-001 … INSP-006 (vollständig) | | `09_inspections.md` | INSP-001 … INSP-006 (vollständig) |
| `10_maintenance.md` | MAINT-001 … MAINT-006 (vollständig) |
Restliche Kacheln (MAINT, DEFECT, PERS, READY, DOC, MOBILE, OPS): nur Zeile Restliche Kacheln (DEFECT, PERS, READY, DOC, MOBILE, OPS): nur Zeile in der Tabelle oben,
in der Tabelle oben, Details folgen nach Freigabe. Details folgen nach Freigabe.
+138
View File
@@ -0,0 +1,138 @@
# Epic 10 — Maintenance
Details zu MAINT-001 … MAINT-006 (vollständig).
---
## MAINT-001 — Wartungspläne
- **Ziel:** Definierte Wartungsvorgaben je AssetType/Asset.
- **Beschreibung:** Wartungsplan-Stammdaten mit Bezug zu AssetType, Liste vorgesehener
Wartungsarten (z.B. „Ölwechsel", „Filterwechsel").
- **Benutzerwert:** Standardisierte Wartungsvorgaben statt Herstellerhandbuch jedes Mal
nachschlagen.
- **Abhängigkeiten:** ASSET-002
- **Datenmodell:** `wartungsplan` (id, asset_type_id, name), `wartungsplan_position`
(plan_id, wartungsart, beschreibung)
- **Backend:** CRUD
- **Frontend:** Verwaltung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Wartungsbereich
- **Rechte:** Materialwart/Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Wartungsplan mit mehreren Positionen anlegen.
- **Tests:** CRUD-Test.
- **DoD:** mind. ein Plan für einen Fahrzeugtyp angelegt. **Lücke:** MABEA hat KEIN
Wartungs-Modul, nur Prüfung (Inspections-Epic) — dieses ganze Epic ist neu.
## MAINT-002 — Wartungsintervalle
- **Ziel:** Wann eine Wartungsposition fällig wird (zeit-, km- oder
betriebsstundenabhängig).
- **Beschreibung:** Intervall-Typ (Zeit/km/Betriebsstunden) + Wert, nutzt ASSET-009 für
den Zähler-Abgleich.
- **Benutzerwert:** Automatische Fälligkeitsberechnung statt Herstellervorgabe manuell im
Kopf behalten.
- **Abhängigkeiten:** MAINT-001, ASSET-009
- **Datenmodell:** `wartungsintervall` (wartungsplan_position_id, typ:
zeit/km/betriebsstunden, wert)
- **Backend:** Fälligkeitsberechnung, kombiniert ggf. mehrere Kriterien („je nachdem was
zuerst eintritt")
- **Frontend:** Intervall-Einstellung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Wartungsbereich
- **Rechte:** Materialwart/Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** alle drei Intervall-Typen einzeln und kombiniert korrekt
berechnet.
- **Tests:** Berechnungstest je Typ + Kombinationstest („je nachdem was zuerst
eintritt").
- **DoD:** funktioniert mit ASSET-009-Zählerstand verzahnt. Komplett neu in MABEA.
## MAINT-003 — Wartungsauftrag
- **Ziel:** Konkrete Durchführung einer fälligen Wartung beauftragen/nachverfolgen.
- **Beschreibung:** Auftrag mit Status (offen/in Arbeit/erledigt), zugeordnet zu
Wartungsplan-Position + Asset.
- **Benutzerwert:** Werkstattauftrag nachvollziehbar statt Zettelwirtschaft.
- **Abhängigkeiten:** MAINT-002
- **Datenmodell:** `wartungsauftrag` (id, asset_id, wartungsplan_position_id, status,
erstellt_am, erledigt_am, durchgefuehrt_von)
- **Backend:** CRUD + Statuswechsel
- **Frontend:** Auftragsliste/-formular
- **Mobile:** Statuswechsel im Feld
- **QR-Code:** Scan Asset zeigt offene Aufträge
- **Seriennummer/Inventarnummer:** nein
- **Akte:** Wartungsbereich
- **Rechte:** Materialwart/Administrator erstellt, Werkstatt/Fahrzeugwart erledigt
- **Audit:** Statuswechsel geloggt
- **Akzeptanzkriterien:** Auftrag anlegen, Status durchlaufen bis erledigt.
- **Tests:** Statuswechsel-Test.
- **DoD:** kompletter Auftragszyklus getestet. Komplett neu in MABEA.
## MAINT-004 — Wartungshistorie
- **Ziel:** Nachvollziehen, welche Wartungen wann durchgeführt wurden.
- **Beschreibung:** Liste erledigter Wartungsaufträge je Asset.
- **Benutzerwert:** Wartungsnachweis (auch für Garantie/Weiterverkauf relevant).
- **Abhängigkeiten:** MAINT-003, FOUND-006
- **Datenmodell:** keins neu (aus MAINT-003-Daten)
- **Backend:** Abfrage je Asset
- **Frontend:** Anzeige in der Akte
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Historien-/Wartungsbereich
- **Rechte:** wie Lese-Recht
- **Audit:** zeigt Audit-relevante Daten
- **Akzeptanzkriterien:** chronologische Liste korrekt.
- **Tests:** Anzeigetest.
- **DoD:** funktioniert mit mind. 2 erledigten Aufträgen. Komplett neu in MABEA.
## MAINT-005 — Ersatzteile/Kosten (P3)
- **Ziel:** Welche Teile/Kosten bei einer Wartung angefallen sind.
- **Beschreibung:** Ersatzteilliste + Kostenfeld je Wartungsauftrag.
- **Benutzerwert:** Kostenübersicht/Budgetplanung.
- **Abhängigkeiten:** MAINT-003
- **Datenmodell:** `wartungsauftrag_teil` (auftrag_id, bezeichnung, menge, kosten)
- **Backend:** CRUD
- **Frontend:** Positionsliste im Auftrag
- **Mobile:** Erfassung
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Wartungsbereich
- **Rechte:** Materialwart/Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Teile/Kosten erfassen, Summe korrekt.
- **Tests:** Summen-Test.
- **DoD:** **P3 — kann zurückgestellt werden**, kein MVP-Bestandteil.
## MAINT-006 — Wartungsdokument-Anbindung
- **Ziel:** Wartungsbericht/Rechnung an den Auftrag anhängen.
- **Beschreibung:** Nutzt DOC-001, `entitaet_typ=wartungsauftrag`.
- **Benutzerwert:** Beleg griffbereit.
- **Abhängigkeiten:** MAINT-003, DOC-001
- **Datenmodell:** keins neu
- **Backend:** keins zusätzlich
- **Frontend:** Dokumente-Panel am Auftrag
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Wartungsbereich
- **Rechte:** wie DOC-001
- **Audit:** wie DOC-001
- **Akzeptanzkriterien:** Dokument anhängen.
- **Tests:** Integrationstest.
- **DoD:** analog INSP-005 — kleine Whitelist-Erweiterung im Dokumente-Modul
(`entitaet_typ=wartungsauftrag` ergänzen), sonst nichts Neues.
---
**MABEA-Ist-Stand-Abgleich:** Das komplette Maintenance-Epic **fehlt in MABEA** — es gibt
keinerlei Wartungskonzept, nur Prüfung (Inspections). Anders als bei den meisten bisherigen
Epics ist hier praktisch nichts wiederverwendbar außer der generellen Berechnungsmechanik
aus Inspections (Intervall→Fälligkeit) und dem Dokumente-Modul (DOC-001, per
Whitelist-Erweiterung). Zusammen mit Warehouse und Digital File eines der drei Epics mit
dem größten Umsetzungsaufwand gegenüber dem MABEA-Ist-Stand — bewusst als P2 eingestuft
(nicht MVP-kritisch).