Workorder — Defekte (Sub-Route)

Zweck

Sub-Route /workorders/:id/defects listet alle Defekte, die im Auftrag festgestellt oder bearbeitet wurden. Pro Defekt werden Defekt-Kategorie, Defekt-Operator und Status erfasst — die Einträge werden über die Workorder-Anlage mit der zentralen Defekt-Liste verknuepft.

Voraussetzungen

- Berechtigung `view:Workorder` und `view:Defect`. - Für Erfassung: `create:Defect`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Workorder, Workorder, FE_Defect, Defect	Liste aufrufbar	—
create/update	Defect	Defekte erfassen/ändern	APP_SPEAMCORE_CREATE/UPDATE_DEFECT

Schritt-für-Schritt-Anleitung

1. Auftrag (/workorders/:id) → Tab Mängel.
2. + Mangel hinzufügen öffnet eines von zwei Modalen (Code-Lookup WorkorderDefectListPage.tsx):
   • Such-Modal (searchModalOpen) — sucht in den vordefinierten DefectType-Stammdaten und legt einen Defect mit dieser Klassifizierung an. Schneller Workflow für häufige Mängel ("Sirene defekt", "Glas zerschlagen").
   • Manuelles Anlegen-Modal (workorderDefectModalOpen) — wird über den "Neu anlegen"-Pfad geöffnet, wenn der gesuchte Mangel-Typ nicht im Stamm vorhanden ist. Erfordert Anlage und Pflege via /defect-lists.
3. Im Modal: Anlage oder Komponente wählen, Mangel-Typ aus Defect-Liste → Beschreibung, ggf. Foto, Frist (deadline).
4. Speichern. Defect wird mit workorderDefectId = aktueller Auftrag und parentType = 'Workorder' angelegt.
5. Mangel erscheint danach im Tab Mängel des Auftrags und in der globalen Mängel-Liste.

**Zwei Wege zum gleichen Modal:** Der **DEFECT-Quick-Button rechts** (siehe [Auftrags-Quick-Buttons](/workorders#schnellaktions-leiste-quick-buttons)) öffnet **dasselbe Such-Modal** wie der **+ Mangel hinzufuegen**-Button hier. Beide Wege erzeugen denselben `Defect`-Datensatz mit identischer Verknuepfung.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Workorders — Eltern-Modul.
• Defekte — globale Liste.
• Defekt-Listen — Defekt-Typ-Vorlagen.
• Defekt-Kategorien — Klassifikation.
• Defekt-Operatoren — Bewertung.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/defects?filter[workorderId]	Liste	view Defect
POST	/api/defects	Erfassen	create Defect

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.