Kunden — Anlagen (Sub-Route)

Zweck

Sub-Route /customers/:id/systems zeigt alle Anlagen, die einem Kunden gehören — typischerweise als Aggregation über alle Standorte des Kunden. Es gibt keine globale /systems-Route — Anlagen sind immer im Eltern-Kontext erreichbar (Kunde, Standort oder Workorder). Konzeptioneller Hintergrund: Anlagen-Konzept.

Verfuegbare Sub-Routen

Pfad	Inhalt
/customers/:id/systems	Liste der Anlagen des Kunden (aggregiert über Standorte)
/customers/:id/systems/:sysId	Detail-Sicht einer Anlage
/customers/:id/systems/:sysId/checklists	Checklisten an der Anlage
/customers/:id/systems/:sysId/components	Komponenten der Anlage
/customers/:id/systems/:sysId/components/:compId	Detail einer Komponente
/customers/:id/systems/:sysId/components/:compId/checklists	Komponenten-Checklisten

Voraussetzungen

- Berechtigung `view:Customer`, `view:System`, `view:SystemChecklist`, `view:Component`. - Anlagen sind ueblicherweise an einen Standort gebunden, der wiederum dem Kunden gehört.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Customer, Customer, FE_System, System	Liste/Detail aufrufbar	—
view	SystemChecklist, Component	Checklisten/Komponenten anzeigen	APP_SPEAMCORE_VIEW_SYSTEM_CHECKLIST, COMPONENT

Schritt-für-Schritt-Anleitung

1. Kunde (/customers/:id) → Tab Anlagen.
2. Aggregierte Sicht über alle Standorte: zeigt jede System-Entitaet, deren locationId zu einem Standort des Kunden gehört. Counter-Spalten (Komponenten, Checklisten) per DisplayCountModel.
3. Klick auf eine Anlage → eingebetteter Detail-Container /customers/:id/locations/:locId/systems/:sysId/general-data (mit Sub-Tabs Komponenten, Checklisten — siehe Anlagen-Konzept).
4. Neue Anlagen werden NICHT hier angelegt, sondern am jeweiligen Standort: Kunden — Standorte → Standort wählen → Tab Anlagen.

Die Anlagen-Sub-Route am Kunden ist eine **read-mostly** Aggregations-Sicht über alle Standorte. Änderungen wie Anlage anlegen/zuordnen erfolgen am Standort, nicht am Kunden.

Wiederverwendbare Konzepte

• Anlagen-Konzept — vollstaendiges Anlagen-/System-Modell.
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Kunden — Eltern-Modul.
• Standorte — Anlagen liegen typischerweise an einem Standort.
• Workorders — Aufträge werden gegen Anlagen ausgeführt.
• Komponenten — globale Komponenten-Sicht.
• Checklisten — Vorlagen, die an Anlagen ausgerollt werden.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/systems?filter[customerId]	Anlagen-Liste	view System
GET	/api/system-checklists?filter[systemId]	Checklisten	view SystemChecklist
GET	/api/components?filter[systemId]	Komponenten	view Component

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.