Workorder — Anlagen (Sub-Route)

Zweck

Sub-Route /workorders/:id/systems listet alle Anlagen, die im aktuellen Auftrag bearbeitet werden. Pro Anlage am Workorder gibt es weiter unten Detail-Sub-Routen für Checklisten und Komponenten:

Pfad	Inhalt
/workorders/:id/systems	Anlagen-Liste am Workorder
/workorders/:id/systems/:sysId	Detail einer Workorder-Anlage
/workorders/:id/systems/:sysId/checklists	Checklisten an dieser Anlage
/workorders/:id/systems/:sysId/components	Komponenten an dieser Anlage
/workorders/:id/systems/:sysId/components/:compId/checklists	Komponenten-Checklisten

Voraussetzungen

- Berechtigung `view:Workorder`, `view:WorkorderSystem`, `view:System`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Workorder, Workorder	Detail aufrufbar	—
view/create/delete	WorkorderSystem	Anlagen am Workorder	APP_SPEAMCORE_VIEW/CREATE/DELETE_WORKORDER_SYSTEM
view	System	Anlagen-Stamm	APP_SPEAMCORE_VIEW_SYSTEM

Schritt-für-Schritt-Anleitung

1. Auftrag (/workorders/:id) → Tab Anlagen.
2. + Anlage hinzufügen bietet zwei Wege (Code-Lookup WorkorderSystemListPage.tsx):
   • Bestehende Anlage wählen (häufiger Fall): Modal mit Suche in den Anlagen des am Auftrag verknuepften Standorts (Workorder.locationId). Anlage anklicken → WorkorderSystem-Eintrag wird angelegt mit workorderId = :id, systemId = ausgewaehlte.
   • Neue Anlage anlegen (selten): direktes Anlegen einer neuen System-Entitaet am Standort + sofortige Verknuepfung als WorkorderSystem. Nuetzlich, wenn Vor-Ort-Mitarbeiter eine bisher unerfasste Anlage entdeckt.
3. Pro WorkorderSystem werden die zugehörigen Prüf-Checklisten instanziiert — d. h. eine Kopie der Master-Checkliste(n) wird mit parentId = WorkorderSystem.id angelegt und steht auf dem Tablet zur Vor-Ort-Prüfung bereit.
4. Detail-Klick auf eine Zeile fuehrt zu eingebetteten Sub-Routen:
   • /workorders/:id/systems/:wsysId/components — Anlagen-Komponenten
   • /workorders/:id/systems/:wsysId/checklists — Prüf-Checklisten

**Sperre nach Anlage-Verknuepfung:** Sobald mindestens ein `WorkorderSystem` existiert, wird `Workorder.locationId` **disabled**. Die Standort-Beziehung ist dann fixiert — für Wechsel des Standorts muessten erst alle Anlagen-Verknuepfungen gelöscht werden. Schutz gegen versehentliche Inkonsistenzen.

Wiederverwendbare Konzepte

• Anlagen-Konzept
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Workorders — Eltern-Modul.
• Komponenten — globale Komponenten-Sicht.
• Checklisten — Vorlagen.
• Defekte — werden oft an Workorder-Anlagen erfasst.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/workorder-systems?filter[workorderId]	Liste	view WorkorderSystem
POST	/api/workorder-systems	Anlage hinzufuegen	create WorkorderSystem
DELETE	/api/workorder-systems/:id	Entfernen	delete WorkorderSystem

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.