Chat (KI-Chat & Team-Chat)

Zweck

Das Chat-Modul liefert eine kombinierte Sicht auf:

• KI-Chats (/chat/ai) — Unterhaltungen mit dem aktiven AI-Provider (z. B. KIera, GPT, Claude).
• Team-Chats (/chat/chats) — interne Direkt- und Gruppen-Chats zwischen Mitarbeitern.
• Legacy (/chat/:chatId) — alter Direkt-Link ohne Kategorie, für Backwards-Compat erhalten.

Routen:

Pfad	Bedeutung
/chat	Standard-Eingang, redirected zu Default-Kategorie
/chat/:category	Liste aller Chats der Kategorie (chats oder ai)
/chat/:category/:chatId	Konkrete Konversation
/chat/:chatId	Legacy-Direkt-Link
/chat-popout, /chat-popout/:category, /chat-popout/:category/:chatId, /chat-popout/:chatId	Popout-Variante in eigenem Browser-Fenster, ohne HomeLayout

Voraussetzungen

- Berechtigung `view:Chat` und `create:Chat`. - Für KI-Chats: aktiver AI-Provider in den Mandanten-Einstellungen.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Chat, Chat	Modul aufrufbar	—
create	Chat	Neuen Chat starten	APP_SPEAMCORE_CREATE_CHAT
view/create	ChatMessage	Nachrichten lesen/schreiben	APP_SPEAMCORE_VIEW/CREATE_CHAT_MESSAGE

Schritt-für-Schritt-Anleitung

Mit KIera chatten

1. Chat (/chat) → Kategorie AI wählen.
2. + Neuer Chat klicken.
3. Frage in natuerlicher Sprache stellen — KIera nutzt die Doku als Wissensquelle (RAG).

Mit einem Kollegen chatten

1. Kategorie Chats wählen.
2. + Neuer Chat → Empfaenger wählen.
3. Nachricht schreiben.

Popout-Fenster

/chat-popout öffnet die Chat-Oberflaeche in eigenem Browserfenster ohne SpeamCore-HomeLayout — geeignet als zweiter Bildschirm.

UI-Elemente

Komponente: Chat (src/components/Chat)

Globale, wiederverwendbare Chat-Komponente. Wird auch im Permission-Editor als Assistent eingebunden.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• KI-Info — Aufklaerung zur Datenverarbeitung.
• Chat-Audit — Audit-Trail aller AI-Chats.
• Permission-Editor — Chat als AI-Assistent für Rollen.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/chat-rooms	Chats-Liste	view Chat
POST	/api/chat-rooms	Neuer Chat	create Chat
GET	/api/chat-messages?filter[chatRoomId]	Nachrichten	view ChatMessage
POST	/api/chat-messages	Nachricht senden	create ChatMessage

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.