Speambox Installations-Anleitungen (SpeamboxInstallationGuides)

Zweck

SpeamboxInstallationGuide modelliert eine multi-step Installations-Anleitung für Speambox-Geraete. Pro Anleitung werden über /speambox-installation-guides/:id/steps Schritte gepflegt — jeder Schritt hat einen name und einen type (text, html, image, video), der bestimmt, wie der Inhalt für Techniker angezeigt wird.

Anleitungen werden über installationGuideId an SpeamboxSystemType gebunden — beim Anlegen einer neuen Speambox sieht der Techniker direkt die richtige Anleitung.

Voraussetzungen

- Berechtigung `view:SpeamboxInstallationGuide` und `create:SpeamboxInstallationGuide`. - Für Schritte: `view:SpeamboxInstallationGuideStep`/`create:SpeamboxInstallationGuideStep`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_SpeamboxInstallationGuide, SpeamboxInstallationGuide	Liste/Detail aufrufbar	—
create/update/delete	SpeamboxInstallationGuide	Pflegen	APP_SPEAMCORE_CREATE/UPDATE/DELETE_SPEAMBOX_INSTALLATION_GUIDE
view/create/update/delete	SpeamboxInstallationGuideStep	Schritt-Sub-Liste	APP_SPEAMCORE_VIEW/CREATE/UPDATE/DELETE_SPEAMBOX_INSTALLATION_GUIDE_STEP

Schritt-für-Schritt-Anleitung

1. Anleitungen (/speambox-installation-guides) → + Neu.
2. Stammdaten pflegen (Name, Beschreibung).
3. Sub-Route /speambox-installation-guides/:id/steps öffnen.
4. Schritte anlegen — pro Schritt type wählen:
   • text — einfacher Text.
   • html — Rich-Text via HTML-Editor.
   • image — Bild-Upload.
   • video — Video-Verweis.
5. Anleitung an SpeamboxSystemType über installationGuideId binden.

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

Step-Felder

Feldname	Pflicht	Datentyp	Wirkung beim Ausfuellen	Voraussetzung
name	nein	String	Schritt-Name.	—
type	ja	ENUM (text, html, image, video)	Bestimmt das Inhalts-Render.	—

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• SpeamboxSystemTypes — referenzieren Anleitungen über installationGuideId.
• Speamboxes — Techniker sehen die Anleitung beim Geraete-Setup.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/speambox-installation-guides	Liste	view SpeamboxInstallationGuide
POST	/api/speambox-installation-guides	Anlegen	create SpeamboxInstallationGuide
GET	/api/speambox-installation-guides/:id	Detail	view SpeamboxInstallationGuide
PATCH	/api/speambox-installation-guides/:id	Ändern	update SpeamboxInstallationGuide
DELETE	/api/speambox-installation-guides/:id	Soft-Delete	delete SpeamboxInstallationGuide
GET	/api/speambox-installation-guide-steps?filter[guideId]	Schritt-Sub-Liste	view SpeamboxInstallationGuideStep

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.