Speambox — Panel (Sub-Route)
Zweck
Sub-Route /speamboxes/:id/panel rendert eine Live-Panel-Sicht der Speambox — aktuelle Modul-Werte, Status-Lichter und ggf. eingebettete Visualisierungen. Werte kommen über MQTT vom Geraet und werden im Backend über Sync-Jobs verarbeitet.
Aktiv nur, wenn der zugewiesene System-Typ das Feature panel aktiviert hat.
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | FE_Speambox, Speambox, SpeamboxModule | Panel sichtbar | — |
Schritt-für-Schritt-Anleitung
- Speambox (
/speamboxes/:id) → Tab Panel. - Aktuelle Werte werden live angezeigt — Updates über WebSocket/SSE oder Polling.
- Konfiguration des Layouts erfolgt typischerweise nicht hier, sondern beim System-Typ.
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
Verknuepfungen zu anderen Modulen
- Speamboxes — Eltern-Modul.
- Speambox-System-Types —
enabledFeatures: ["panel"]muss aktiv sein. - Speamboxes — Module — Datenbasis.
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/speamboxes/:id | Stamm | view Speambox |
GET | /api/speambox-modules?filter[speamboxId] | Modul-Werte | view SpeamboxModule |
Versionshinweise
- 2026-04-30: Initiale Veroeffentlichung.