Files
MABEA/arbeitskacheln/10_maintenance.md
T
patrickandClaude Sonnet 5 71dc679b57
CI / backend-tests (push) Failing after 1m55s
CI / frontend-build (push) Successful in 16s
docs: Maintenance-Epic komplettiert (MAINT-001..006)
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
2026-09-05 15:32:37 +02:00

5.8 KiB

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).