Mitarbeiter — Mail-Konten (Sub-Route)

Zweck

Sub-Route /employees/:id/mail-accounts zeigt alle Mailbox-Verknuepfungen des Mitarbeiters — der MailboxEmployee-Eintrag verbindet einen Mitarbeiter mit einer Mail-Konfiguration und steuert, welche Mails er im Mail-Modul sieht und welcher Kalender im Calendar eingeblendet wird.

Voraussetzungen

- Berechtigung `view:Employee` und `view:MailboxEmployee`. - Für Verknuepfung: `create:MailboxEmployee` und `view:Mailbox`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Employee, Employee	Detail aufrufbar	—
view/create/delete	MailboxEmployee	Verknuepfung pflegen	APP_SPEAMCORE_VIEW/CREATE/DELETE_MAILBOX_EMPLOYEE
view	Mailbox	Mailbox-Auswahl	APP_SPEAMCORE_VIEW_MAILBOX

Schritt-für-Schritt-Anleitung

1. Mitarbeiter (/employees/:id) → Tab Mail-Konten.
2. + Mailbox wählt ein bestehendes Mail-Konto.
3. Mailbox erscheint danach im Mail-Modul des Mitarbeiters und im Calendar-Sidebar.

Anlege-Pattern (Code-Lookup-basiert)

Beim Klick auf den + Hinzufügen-Button erscheint kein Modal mit Eingabemaske, sondern ein Auswahl-Workflow (customAddButton-Pattern):

1. Modal mit Suche im Stamm der zu verknüpfenden Entität (z. B. Rolle, Fahrzeug, Kurs).
2. Anwender wählt einen oder mehrere Einträge.
3. Pro Auswahl wird ein Assignment-Datensatz erzeugt, der die N:M-Verknüpfung Mitarbeiter ↔ Stamm hält — nicht der Stamm selbst.
4. Klick auf eine Zeile führt zum Detail des Assignment (Pflege z. B. von Gültigkeitszeitraum, prozentuale Aufteilung).

**Stamm vs Assignment:** Das Löschen einer Verknüpfung (Assignment) entfernt nur die Beziehung zum Mitarbeiter, **nicht** den Stamm. Stamm-Änderungen wirken auf alle Mitarbeiter mit aktiver Verknüpfung — Anpassung etwa der Rolle hat sofort Auswirkung auf alle Mitarbeiter mit dieser Rolle.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Mitarbeiter — Eltern-Modul.
• Mail-Konten — Mailbox-Stamm.
• Mail — verbraucht die Verknuepfung für die Posteingang-Sicht.
• Calendar — verbraucht die Verknuepfung für die Outlook-Kalender-Sidebar.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/mailbox-employees?filter[employeeId]	Liste	view MailboxEmployee
POST	/api/mailbox-employees	Verknuepfen	create MailboxEmployee
DELETE	/api/mailbox-employees/:id	Aufheben	delete MailboxEmployee

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.