SpeamBoards

Zweck

SpeamBoard modelliert ein Ideen- und Feedback-Board. Pro Board werden Branding-Farben, Sichtbarkeit (isPublic) und Interaktions-Optionen (Voting, Kommentare, Ideen, Genehmigungsworkflow) gesteuert. Boards koennen über die Sub-Route /speamboards/:id/categories strukturiert werden.

Voraussetzungen

- Berechtigung `view:SpeamBoard` und `create:SpeamBoard`. - Für Kategorien-Sub-Liste: `view:SpeamBoardCategory`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_SpeamBoard, SpeamBoard	Liste/Detail aufrufbar	—
create/update/delete	SpeamBoard	Pflegen	APP_SPEAMCORE_CREATE/UPDATE/DELETE_SPEAM_BOARD
view/create/update/delete	SpeamBoardCategory	Kategorien-Sub-Liste	APP_SPEAMCORE_VIEW/CREATE/UPDATE/DELETE_SPEAM_BOARD_CATEGORY

Schritt-für-Schritt-Anleitung

1. SpeamBoards (/speamboards) → + Neu.
2. name und description (HTML-Editor) pflegen.
3. Branding: primaryColor und secondaryColor (Hex) — werden im Board-Layout verwendet.
4. Optionen:
   • isPublic — öffentlich sichtbar oder nur intern.
   • allowVoting — Voting auf Einträge.
   • allowComments — Kommentar-Funktion.
   • allowIdeas — Anwender koennen eigene Ideen einreichen.
   • requireApproval — neue Einträge brauchen Freigabe.
5. Sub-Route /speamboards/:id/categories — Kategorien für Strukturierung anlegen.

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
name	nein	String	Anzeigename des Boards.	—
description	nein	HTML	Vorstellungstext.	—
primaryColor	nein	String (Hex)	Primaerfarbe des Boards.	—
secondaryColor	nein	String (Hex)	Sekundaerfarbe.	—
isPublic	nein	Boolean	true: öffentlich.	—
allowVoting	nein	Boolean	Voting aktivieren.	—
allowComments	nein	Boolean	Kommentare aktivieren.	—
allowIdeas	nein	Boolean	Ideen-Einreichung aktivieren.	—
requireApproval	nein	Boolean	Genehmigungsworkflow aktivieren.	—

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• SpeamBoardCategory — Sub-Liste zur Strukturierung.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/speamboards	Liste	view SpeamBoard
POST	/api/speamboards	Anlegen	create SpeamBoard
GET	/api/speamboards/:id	Detail	view SpeamBoard
PATCH	/api/speamboards/:id	Ändern	update SpeamBoard
DELETE	/api/speamboards/:id	Soft-Delete	delete SpeamBoard
GET	/api/speamboard-categories?filter[speamBoardId]	Kategorien-Sub-Liste	view SpeamBoardCategory

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.