diff --git a/arbeitskacheln/00_index.md b/arbeitskacheln/00_index.md index 589cdee..6e79ef7 100644 --- a/arbeitskacheln/00_index.md +++ b/arbeitskacheln/00_index.md @@ -215,6 +215,7 @@ eigenes Modul (MAINT-\*, MABEA hat nur Prüfung, keine Wartung)**. | `07_warehouse.md` | WH-001 … WH-007 (vollständig) | | `08_loadout.md` | LOAD-001 … LOAD-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 -in der Tabelle oben, Details folgen nach Freigabe. +Restliche Kacheln (DEFECT, PERS, READY, DOC, MOBILE, OPS): nur Zeile in der Tabelle oben, +Details folgen nach Freigabe. diff --git a/arbeitskacheln/10_maintenance.md b/arbeitskacheln/10_maintenance.md new file mode 100644 index 0000000..cec5ea5 --- /dev/null +++ b/arbeitskacheln/10_maintenance.md @@ -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).