Speambox — Module (Sub-Route)

Zweck

Sub-Route /speamboxes/:id/modules listet die konkreten Modul-Instanzen der Speambox — basierend auf den Modul-Definitionen des System-Typs. Pro Modul wird Status, Konfiguration und letzter Werte-Update gepflegt.

Detail-Sicht /speamboxes/:speamboxId/modules/:moduleId zeigt das einzelne Modul. Globale Detail unter /speambox-modules/:id (selten direkt aufgerufen).

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Speambox, Speambox	Detail aufrufbar	—
view/create/update	SpeamboxModule	Module pflegen	APP_SPEAMCORE_VIEW/CREATE/UPDATE_SPEAMBOX_MODULE

Schritt-für-Schritt-Anleitung

1. Speambox (/speamboxes/:id) → Tab Module.
2. + Modul wählt eine SpeamboxModuleDefinition des System-Typs und legt eine Modul-Instanz an.
3. Klick auf Modul → Detail mit konkreter Konfiguration.

Pattern (SpeamBox-spezifisch)

SpeamBoxes sind Hardware-Module im Brandschutz-Kontext (Sensoren, Kameras, ICs):

• SpeamboxModule — die installierten Modul-Typen einer Box (analog Slots im Server-Chassis).
• SpeamboxPanel — die Bedien-Oberflaeche der Box mit ihren physischen Tasten/Anzeigen.

Diese Sub-Routen sind read-mostly — die Hardware-Konfiguration kommt aus der Erstinstallation und wird selten geändert. Änderungen erfolgen meist via SpeamBox-Installations-Assistenten.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Speamboxes — Eltern-Modul.
• Speambox-System-Types — definiert verfuegbare Modul-Typen.
• Speambox-Module-Definitions — Vorlagen.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/speambox-modules?filter[speamboxId]	Liste	view SpeamboxModule
POST	/api/speambox-modules	Anlegen	create SpeamboxModule
PATCH	/api/speambox-modules/:id	Ändern	update SpeamboxModule

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.