From 11a62db3bd8d10412699b8d37b812f3b4af695dd Mon Sep 17 00:00:00 2001 From: patrick Date: Sat, 5 Sep 2026 15:33:51 +0200 Subject: [PATCH] docs: Defects-Epic komplettiert (DEFECT-001..005) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fast vollständig in MABEA umgesetzt (Mangel-Modul deckt 4 von 5 Kacheln 1:1 ab). Kleinste Lücke aller bisher abgeglichenen Epics: DEFECT-003, eine aktive Zuständigkeits-Zuweisung während der Mangel noch offen ist, fehlt (nur erledigt_von nach Abschluss vorhanden). Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01KC8HYvv6UkCVYheYiTw9DD --- arbeitskacheln/00_index.md | 3 +- arbeitskacheln/11_defects.md | 124 +++++++++++++++++++++++++++++++++++ 2 files changed, 126 insertions(+), 1 deletion(-) create mode 100644 arbeitskacheln/11_defects.md diff --git a/arbeitskacheln/00_index.md b/arbeitskacheln/00_index.md index 6e79ef7..33a8979 100644 --- a/arbeitskacheln/00_index.md +++ b/arbeitskacheln/00_index.md @@ -216,6 +216,7 @@ eigenes Modul (MAINT-\*, MABEA hat nur Prüfung, keine Wartung)**. | `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) | +| `11_defects.md` | DEFECT-001 … DEFECT-005 (vollständig) | -Restliche Kacheln (DEFECT, PERS, READY, DOC, MOBILE, OPS): nur Zeile in der Tabelle oben, +Restliche Kacheln (PERS, READY, DOC, MOBILE, OPS): nur Zeile in der Tabelle oben, Details folgen nach Freigabe. diff --git a/arbeitskacheln/11_defects.md b/arbeitskacheln/11_defects.md new file mode 100644 index 0000000..c878dff --- /dev/null +++ b/arbeitskacheln/11_defects.md @@ -0,0 +1,124 @@ +# 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.