MABEA/arbeitskacheln/11_defects.md

# Epic 11 — Defects

Details zu DEFECT-001 … DEFECT-005 (vollständig).

---

## DEFECT-001 — Mangelmeldung + Foto

- **Ziel:** Schaden/Defekt an einer Ressource melden, inkl. Foto.
- **Beschreibung:** Meldung mit Beschreibung, Priorität, optionalem Foto-Anhang
  (DOC-001).
- **Benutzerwert:** Jeder Helfer kann sofort einen Schaden dokumentieren, kein separater
  Meldezettel.
- **Abhängigkeiten:** ASSET-003, DOC-001
- **Datenmodell:** `mangel` (id, asset_id, entitaet_typ, entitaet_id, beschreibung,
  prioritaet, status, gemeldet_von, gemeldet_am)
- **Backend:** POST melden
- **Frontend:** Meldeformular
- **Mobile:** zentraler mobiler Anwendungsfall (Foto direkt von Kamera)
- **QR-Code:** Scan Asset startet Mangelmeldung direkt
- **Seriennummer/Inventarnummer:** nein
- **Akte:** Mängelbereich
- **Rechte:** Mitarbeiter+ (jeder darf melden)
- **Audit:** Meldung geloggt
- **Akzeptanzkriterien:** Mangel melden inkl. Foto-Anhang funktioniert.
- **Tests:** Melde-Test, Foto-Anhang-Test.
- **DoD:** deckt sich mit MABEA Mangel-Modul (bereits umgesetzt, inkl.
  entitaet_typ/entitaet_id-Polymorphie für Teilressourcen und
  Dokumente-Panel-Integration für Fotos).

## DEFECT-002 — Priorität & Status-Workflow

- **Ziel:** Mängel nach Dringlichkeit einstufen, Bearbeitungsstand nachhalten.
- **Beschreibung:** Priorität (niedrig/normal/hoch), Status
  neu→in_bearbeitung→ersatzteil_bestellt/reparatur_geplant→erledigt.
- **Benutzerwert:** Materialwart kann priorisieren statt alles gleich zu behandeln.
- **Abhängigkeiten:** DEFECT-001
- **Datenmodell:** `mangel.prioritaet`, `mangel.status` (enum)
- **Backend:** Statuswechsel-Endpoint
- **Frontend:** Status-Dropdown
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Mängelbereich
- **Rechte:** Status ändern: Materialwart/Leitung/Administrator
- **Audit:** Statuswechsel geloggt
- **Akzeptanzkriterien:** alle Statuswerte durchlaufbar, Priorität beeinflusst
  Sortierung.
- **Tests:** Statuswechsel-Test.
- **DoD:** deckt sich mit MABEA (bereits umgesetzt, inkl. Historie-Logging).

## DEFECT-003 — Verantwortlicher & Reparaturzuordnung

- **Ziel:** Wer kümmert sich gerade um die Behebung.
- **Beschreibung:** Zuweisung an eine Person/Werkstatt, optional Verknüpfung zu einem
  Wartungsauftrag (MAINT-003).
- **Benutzerwert:** Klare Zuständigkeit statt „irgendwer wird sich schon kümmern".
- **Abhängigkeiten:** DEFECT-002, PERS-002
- **Datenmodell:** `mangel.zustaendiger_id` (optional), `mangel.wartungsauftrag_id`
  (optional, Kopplung)
- **Backend:** Zuweisen-Endpoint
- **Frontend:** Zuweisungsfeld
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Mängelbereich
- **Rechte:** Materialwart/Leitung/Administrator
- **Audit:** Zuweisung geloggt
- **Akzeptanzkriterien:** Zuweisung setzen/ändern.
- **Tests:** Zuweisungstest.
- **DoD:** Kopplung zu MAINT-003 optional, funktioniert auch ohne. **Lücke:** MABEA hat
  keine explizite Zuständigen-Zuweisung am Mangel selbst — nur `erledigt_von` NACH
  Abschluss ist bekannt, „wer bearbeitet es gerade" während offener Status fehlt.

## DEFECT-004 — Abschluss & Dokumentation

- **Ziel:** Mangel sauber abschließen mit Nachweis der Behebung.
- **Beschreibung:** Abschluss setzt Status=erledigt, erledigt_von/erledigt_am, optional
  Abschluss-Foto/-Dokument.
- **Benutzerwert:** Nachweis „wurde wirklich behoben", nicht nur Status umgeschaltet.
- **Abhängigkeiten:** DEFECT-003
- **Datenmodell:** `mangel.erledigt_von`/`erledigt_am` (bereits Teil des
  DEFECT-002-Datenmodells)
- **Backend:** Abschluss-Endpoint
- **Frontend:** Abschluss-Aktion inkl. optionalem Dokument
- **Mobile:** Abschluss im Feld
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Mängelbereich
- **Rechte:** Materialwart/Leitung/Administrator
- **Audit:** Abschluss geloggt
- **Akzeptanzkriterien:** Abschluss auch ohne Nachweis möglich (Dokument bleibt optional,
  keine Überregulierung), mit Nachweis nachvollziehbar besser.
- **Tests:** Abschlusstest.
- **DoD:** deckt sich mit MABEA (bereits umgesetzt: erledigt_von/erledigt_am +
  Historie-Eintrag) — Foto-Nachweis beim Abschluss ist keine erzwungene Pflicht, aber
  über das generische DokumentePanel bereits jetzt möglich.

## DEFECT-005 — Readiness-Einfluss (kritisch)

- **Ziel:** Ein offener kritischer Mangel macht die Ressource nicht einsatzbereit.
- **Beschreibung:** Nur `prioritaet=hoch` + Status offen fließt in die
  Readiness-Berechnung ein.
- **Benutzerwert:** Niedrige/normale Mängel sind Hinweise, kein Blocker — verhindert
  Alarmmüdigkeit.
- **Abhängigkeiten:** DEFECT-002, READY-001
- **Datenmodell:** keins neu
- **Backend:** Readiness-Regel liest offene kritische Mängel je Asset
- **Frontend:** Grund-Anzeige im Readiness-Dashboard
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Readiness-Anzeige
- **Rechte:** wie Lese-Recht
- **Audit:** nein zusätzlich
- **Akzeptanzkriterien:** nur hoch+offen blockiert, niedrig/normal nicht.
- **Tests:** Prioritäts-Filtertest.
- **DoD:** deckt sich 1:1 mit MABEA (`objekt_ids_mit_kritischem_offenem_mangel()`,
  bereits umgesetzt und getestet).

---

**MABEA-Ist-Stand-Abgleich:** Das Defects-Epic ist **fast vollständig in MABEA
umgesetzt** (Mangel-Modul wurde explizit in dieser Session gebaut und deckt
DEFECT-001/002/004/005 1:1 ab, inklusive Historie-Anbindung und Readiness-Kopplung).
Einzige offene Lücke: **DEFECT-003** — eine aktive „wer bearbeitet das gerade"-Zuweisung
während der Mangel noch offen ist, existiert nicht (nur `erledigt_von` nach Abschluss).
Kleinste Lücke aller bisher abgeglichenen Epics.