Speambox System-Typen (SpeamboxSystemTypes)

Zweck

SpeamboxSystemType ist eine Hardware-/System-Klassifikation für Speambox-Geraete. Pro System-Typ wird gepflegt:

• Hersteller und eindeutiger key.
• Status (active/inactive).
• Features (Multi-Select): dashboard, panel, mqtt, notifications — bestimmt, welche Funktionen im Speambox-Detail aktiv sind.
• Installations-Anleitung — Verweis auf SpeamboxInstallationGuide.
• Modul-Definitionen — Sub-Liste mit SpeamboxModuleDefinition-Einträgen.
• Wert-Mappings — pro System-Typ definiert, wie Rohwerte (z. B. Sensor-Werte) auf SpeamCore-Statuskennungen abgebildet werden.
• Payload-Mapping-Regeln — wie eingehende MQTT-Payloads in SpeamCore-Einträge transformiert werden.
• Payload-Simulator — Test-Sub-Route zum Ueberpruefen der Mapping-Regeln.

Voraussetzungen

- Berechtigung `view:SpeamboxSystemType` und `create:SpeamboxSystemType`. - [Hersteller](/manufacturers) als Zuordnung. - Optional: [SpeamboxInstallationGuide](/speambox-installation-guides) für Anleitungen.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_SpeamboxSystemType, SpeamboxSystemType	Liste/Detail aufrufbar	—
create/update/delete	SpeamboxSystemType	Pflegen	APP_SPEAMCORE_CREATE/UPDATE/DELETE_SPEAMBOX_SYSTEM_TYPE
view	Manufacturer	Hersteller-Auswahl	APP_SPEAMCORE_VIEW_MANUFACTURER
view	SpeamboxInstallationGuide	Anleitungs-Auswahl	APP_SPEAMCORE_VIEW_SPEAMBOX_INSTALLATION_GUIDE
view	SpeamboxModuleDefinition, SpeamboxSystemTypeValueMapping, SpeamboxSystemTypePayloadMappingRule	Sub-Listen	APP_SPEAMCORE_VIEW_SPEAMBOX_MODULE_DEFINITION, SPEAMBOX_SYSTEM_TYPE_VALUE_MAPPING, SPEAMBOX_SYSTEM_TYPE_PAYLOAD_MAPPING_RULE

Schritt-für-Schritt-Anleitung

1. System-Typen (/speambox-system-types) → + Neu.
2. manufacturerId wählen.
3. key (technischer Eindeutigkeits-Schlüssel) und name (Anzeigename) pflegen.
4. description ergaenzen.
5. status = active.
6. enabledFeatures wählen — nur diese werden im Speambox-Detail eingeblendet.
7. Optional installationGuideId und Branding-color zuordnen.

Sub-Routen

Sub-Route	Inhalt
/speambox-system-types/:id/module-definitions	Liste der vom System unterstuetzten Module-Typen
/speambox-system-types/:id/value-mappings	Wert-Mappings (Rohwert → SpeamCore-Status)
/speambox-system-types/:id/mapping-rules	Payload-Mapping-Regeln
/speambox-system-types/:id/payload-simulator	Test-Lauf der Mapping-Regeln mit fiktiver Payload

Toolbar (Detail-Seite)

Schlanke Toolbar oben rechts:

Icon	Aktion (aria-label)	CASL	Wirkung
←	Zurückgehen	—	Zurück zur Liste.
🏠	Zur Startseite gehen	—	Springt auf das Dashboard / /.
⏮/◀/▶/⏭	Pagination	—	Navigation durch die gefilterte Liste — Massen-Bearbeitung ohne Liste-Sprung.

Globale Floating-Drawer (links)

Wie auf jeder Detail-Seite verfuegbar — siehe Floating-Quickbar:

• KAL. (Mini-Kalender)
• ZEIT (Persoenliche Wochen-Arbeitszeit)
• ARBEIT (Eigene bevorstehende Aufträge)

Felder und Eingaben

Feldname	Pflicht	Datentyp	Wirkung beim Ausfuellen	Voraussetzung
manufacturerId	nein	UUID	Verweis auf Hersteller.	view:Manufacturer.
key	nein	String	Technischer Eindeutigkeits-Schlüssel.	—
name	nein	String	Anzeigename.	—
description	nein	TEXT	Erlaeuterung.	—
previewImageDocumentId	nein	UUID (Document)	Vorschaubild des Geraets.	view:Document.
status	ja	ENUM (active, inactive)	Steuert Sichtbarkeit.	—
enabledFeatures	nein	Array (dashboard/panel/mqtt/notifications)	Aktiviert die Feature-Bereiche im Speambox-Detail.	—
installationGuideId	nein	UUID	Verweis auf SpeamboxInstallationGuide.	view:SpeamboxInstallationGuide.
color	nein	String (Hex)	Branding-Farbe.	—

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Speamboxes — Geraete vom Typ SpeamboxSystemType.
• Hersteller — Zuordnung.
• SpeamboxInstallationGuides — Anleitungen.
• SpeamboxModuleDefinitions — vom Typ unterstuetzte Module.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/speambox-system-types	Liste	view SpeamboxSystemType
POST	/api/speambox-system-types	Anlegen	create SpeamboxSystemType
GET	/api/speambox-system-types/:id	Detail	view SpeamboxSystemType
PATCH	/api/speambox-system-types/:id	Ändern	update SpeamboxSystemType
DELETE	/api/speambox-system-types/:id	Soft-Delete	delete SpeamboxSystemType
GET	/api/speambox-module-definitions?filter[speamboxSystemTypeId]	Sub-Liste Module	view SpeamboxModuleDefinition
GET	/api/speambox-system-type-value-mappings?filter[...]	Wert-Mappings	view SpeamboxSystemTypeValueMapping
GET	/api/speambox-system-type-payload-mapping-rules?filter[...]	Payload-Regeln	view SpeamboxSystemTypePayloadMappingRule

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.