Speambox Modul-Definitionen (SpeamboxModuleDefinitions)
Zweck
SpeamboxModuleDefinition ist die Vorlage für Module, die in einem Speambox-System-Typ verfuegbar sind. Sie wird typischerweise nicht direkt auf der globalen Liste gepflegt, sondern über die Sub-Route /speambox-system-types/:id/module-definitions im Kontext eines System-Typs.
Pro Definition wird key, name und description gepflegt. Konkrete Modul-Instanzen werden in einer Speambox als SpeamboxModule angelegt und referenzieren über moduleDefinitionId die hier hinterlegte Definition.
Voraussetzungen
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | FE_SpeamboxModuleDefinition, SpeamboxModuleDefinition | Liste/Detail aufrufbar | — |
create/update/delete | SpeamboxModuleDefinition | Pflegen | APP_SPEAMCORE_CREATE/UPDATE/DELETE_SPEAMBOX_MODULE_DEFINITION |
Schritt-für-Schritt-Anleitung
- System-Typen (
/speambox-system-types) → System-Typ öffnen → Tab Modul-Definitionen. - + Neu.
key(eindeutig pro System-Typ),name(Anzeigename) unddescriptionpflegen.- Modul-Definition wird beim Anlegen einer Speambox vom System-Typ als verfuegbares Modul angeboten.
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 |
|---|---|---|---|---|
key | nein | String | Eindeutiger technischer Schlüssel innerhalb des System-Typs. | — |
name | nein | String | Anzeigename. | — |
description | nein | TEXT | Erlaeuterung. | — |
Wiederverwendbare Konzepte
Verknuepfungen zu anderen Modulen
- SpeamboxSystemTypes — Eltern-Kontext, Sub-Route
/speambox-system-types/:id/module-definitions. - Speamboxes — Modul-Instanzen referenzieren
moduleDefinitionId.
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/speambox-module-definitions | Liste (mit filter[speamboxSystemTypeId]) | view SpeamboxModuleDefinition |
POST | /api/speambox-module-definitions | Anlegen | create SpeamboxModuleDefinition |
GET | /api/speambox-module-definitions/:id | Detail | view SpeamboxModuleDefinition |
PATCH | /api/speambox-module-definitions/:id | Ändern | update SpeamboxModuleDefinition |
DELETE | /api/speambox-module-definitions/:id | Soft-Delete | delete SpeamboxModuleDefinition |
Versionshinweise
- 2026-04-30: Initiale Veroeffentlichung.