45 KiB
module, title, phase, status, last_updated, session_source, related_lps, spec_style
| module | title | phase | status | last_updated | session_source | related_lps | spec_style | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 13 | Team-Chat (intern) | 1 | detail-spec-draft | 2026-05-08 | brainstorming-session-2026-05-07-2206.md |
|
requirements-pur |
Modul 13 — Team-Chat (intern)
Detail-Spec gemäß LP-9. Interner Team-Chat als Quiply-Komplett-Ablösung. WebSocket-basierte Echtzeit-Kommunikation über drei Ebenen (Projekt-Channels, Gruppen-Channels, Direkt-Nachrichten) mit tiefer Verzahnung in CRM/Projekte/Tasks/Files. Kein Customer-Chat — Endkunden laufen über Customer-Portal (M15) bzw. WhatsApp (M11).
Themenblöcke
A. Datenmodell (TeamChat, Member, Message, Pinned, Reaction, Thread, Read)
B. Menü-Struktur und Routes
C. Channel-Typen und Lifecycle (Projekt-Auto / Gruppen / DM)
D. Listen-View (Channel-Index)
E. Detail-View (Chat-Verlauf)
F. Threads, Reactions, Pinned, Mentions
G. Datei-Uploads, Link-Previews, Mark-as-Task
H. WebSocket-Server / Echtzeit-Übermittlung
I. Read-Receipts und Notifications
J. Mobile-First für Monteur (LP-2)
K. Activity-Stream-Integration
L. Permissions-Anwendung
M. Klartext-Hinweise/-Fehler
N. Phase 2 / spätere Features
Block A — Datenmodell
TeamChat
Repräsentiert einen Channel (Projekt-Chat, Gruppen-Chat oder DM).
id,tenant_id,created_at,updated_at,created_by_user_idkind(Enum:project | group | dm)name(Pflicht fürgroup, optional fürproject— Default = Project-Title, NULL beidm— wird aus Members generiert)description(Markdown-Freitext, optional)project_id(FK auf Project — NUR beikind=project, sonst NULL)is_private(Boolean —groupkann öffentlich/sichtbar im Channel-Browser oder privat/nur per Einladung sein;project/dmimmer privat)archived_at(Soft-Delete; bei Project-Abschluss automatisch gesetzt)archived_reason(Enum:manual | project_completed | project_cancelled, NULL solange aktiv)last_message_at(für Default-Sortierung im Channel-Index)notification_default(Enum:all_messages | mentions_only | muted— Default für neue Members)
Constraints:
kind=project→project_id NOT NULL,namedarf leer bleiben (UI fällt auf Project-Title zurück)kind=dm→ genau 2 TeamChatMember-Einträge,nameunddescriptionwerden ignoriertkind=group→ mind. 1 Member,namePflicht- Pro Project max. 1 aktiver Projekt-Chat (Unique-Constraint auf
project_idWHEREarchived_at IS NULL) - Pro Tenant + Member-Paar max. 1 aktiver DM-Chat (Auto-Reuse statt Duplikat-Anlage)
Indizes:
tenant_id, kind, archived_at, last_message_at DESCfür Index-Sortierungproject_idfür Project-Verknüpfung- Partial Unique Index auf
(project_id) WHERE archived_at IS NULL AND kind='project'
TeamChatMember (M:N)
Mitgliedschaft eines Users in einem Channel.
id,tenant_id,chat_id,user_id,joined_at,joined_via_user_id(wer hat eingeladen, NULL bei Auto-Add)role_in_chat(Enum:admin | member—admindarf Members ändern, Channel umbenennen, archivieren)notification_pref(Enum:all_messages | mentions_only | muted— Override des Channel-Defaults)last_read_message_id(FK auf TeamChatMessage — bestimmt Unread-Counter)last_read_atis_pinned(Boolean — User hat Channel im Index angeheftet)left_at(Soft-Leave; User kann re-joined werden)
Constraints:
- Unique
(chat_id, user_id) WHERE left_at IS NULL - Mind. 1
adminprogroup-Channel; bei Last-Admin-Leave: Klartext-Block oder Auto-Promote eines anderen Members - DM hat kein
admin-Konzept (beide gleichberechtigt)
Indizes:
user_id, tenant_id, left_atfür „meine Channels"-Listenchat_id, user_idfür Membership-Lookups
TeamChatMessage
Einzelne Nachricht im Channel oder Thread.
id,tenant_id,chat_id,created_at,updated_at,author_user_idbody(Markdown, max. 8000 Zeichen)body_format(Enum:markdown | system—systemfür automatische Nachrichten wie „Max wurde hinzugefügt")parent_message_id(FK — wenn gesetzt, ist Nachricht Teil eines Threads; siehe Block F)mentions[](JSON-Array aufgelöster Mentions, siehe Block F.4)attachments[](FK-Liste auf File-Records aus M23)link_previews[](JSON — siehe Block G.2)edited_at(NULL bis editiert)deleted_at(Soft-Delete; UI zeigt „Nachricht gelöscht"-Platzhalter)deleted_by_user_id(Author selbst oder Channel-Admin/Tenant-Admin)system_event_kind(NULL oder Enum:member_added | member_removed | channel_renamed | channel_archived | project_stage_changed | acceptance_completed | ...)system_event_metadata(JSON für strukturierte System-Nachrichten)
Constraints:
bodydarf beiattachments != []leer sein (Reine-Datei-Nachricht)body_format=systemdarf NICHT von Usern erstellt werden (nur Backend)- Editier-Fenster: 24h nach
created_at(außertenant.admin); danach Hard-Edit verboten
Indizes:
chat_id, parent_message_id, created_at DESCfür Channel-Verlauf-Pagination (Thread-Posts werden ausgefiltert mitparent_message_id IS NULL)chat_id, parent_message_id, created_at ASCfür Thread-Verlauf- GIN-Index auf
mentionsfür „meine Mentions"-Query - Trigram-Index auf
bodyfür In-Channel-Suche
TeamChatPinnedMessage
Eine Nachricht kann pro Channel angeheftet werden.
id,tenant_id,chat_id,message_id,pinned_by_user_id,pinned_atnote(optional Freitext, warum angeheftet)
Constraints:
- Unique
(chat_id, message_id)(eine Nachricht max. einmal pro Channel angeheftet) - Max. 50 Pinned pro Channel (Soft-Limit, Klartext bei Erreichen)
- Pinning erfordert
chat.adminODER Author-eigene Nachricht
TeamChatReaction
Emoji-Reaktion auf eine Nachricht.
id,tenant_id,message_id,user_id,emoji(String, max. 16 Zeichen — Unicode-Emoji oder Tenant-Custom-Shortcode),reacted_at
Constraints:
- Unique
(message_id, user_id, emoji)(gleiche Reaktion nicht doppelt — Toggle entfernt sie) - Max. 20 verschiedene Emojis pro Nachricht (Anti-Spam)
- Max. 8 Reaktionen pro User pro Nachricht (Anti-Spam)
- Custom-Emoji-Shortcodes: Phase 2 — in Phase 1 nur Standard-Unicode
TeamChatThread
Eine Sub-Konversation, die an eine Eltern-Nachricht angehängt ist.
id,tenant_id,chat_id,parent_message_id(Unique — eine Nachricht hat max. 1 Thread)created_at,created_by_user_idlast_reply_atreply_count(denormalisiert für UI-Badge)participant_user_ids[](denormalisiert)
Begründung: Threads sind eigene Entität (statt nur parent_message_id auf Messages), weil Aggregat-Daten (reply_count, last_reply_at, participant_user_ids) sonst pro Render aggregiert werden müssten — performance-kritisch bei Channel mit vielen Threads.
Constraints:
- Thread-Erstellung legt automatisch TeamChatThread-Record an, wenn erste Reply unter Eltern-Nachricht entsteht
- Thread-Replies sind TeamChatMessages mit
parent_message_id != NULL
Indizes:
chat_id, last_reply_at DESCfür „aktive Threads in diesem Channel"
TeamChatRead (Read-Receipts)
Pro-User-Pro-Nachricht-Read-Marker. Wird nur für gelesene Markierungen geschrieben (kein Eintrag = ungelesen). Aggregat-Sicht „X von Y haben gelesen".
id,tenant_id,message_id,user_id,read_at
Constraints:
- Unique
(message_id, user_id) - Wird automatisch geschrieben, wenn Client meldet „Nachricht in View sichtbar mind. 1 Sekunde"
- Bei DMs: gelesen-Status sofort sichtbar
- Bei Group/Project: Aggregat „X von Y gelesen"
Performance:
- Index auf
message_id, user_idfür Aggregat-Counts - Bei sehr aktiven Channels (>100 Members): Read-Receipts werden pro Channel-Member-Setting deaktivierbar (Phase 2)
Verknüpfung mit anderen Modulen
TeamChat.project_id→ M4 ProjectTeamChatMessage.author_user_id→ UserTeamChatMessage.attachments→ M23 File-RecordsTeamChatMessage.mentions→ Auflösung auf Contacts/Companies/Deals/Projects/Users (siehe F.4)- „Mark as Task" erzeugt Task in M26 mit Backlink auf Source-Message
Block B — Menü-Struktur und Routes
Sidebar-Hauptpunkt: Chat mit Unread-Badge (Summe Unread-Counter aller eigenen Channels).
Routen (Tenant-scoped):
/{tenant}/chat → Channel-Index (Default-Landing)
/{tenant}/chat/new → Neuer Channel anlegen (Group oder DM)
/{tenant}/chat/:id → Channel-Detail (Verlauf + Compose)
/{tenant}/chat/:id/info → Channel-Settings (Members, Notifications, Archivieren)
/{tenant}/chat/:id/thread/:thread_id → Thread-Detail
/{tenant}/chat/:id/pinned → Übersicht aller Pinned Messages des Channels
/{tenant}/chat/:id/files → Übersicht aller Dateien aus diesem Channel
/{tenant}/chat/search → Cross-Channel-Suche (alle eigenen Channels)
/{tenant}/chat/mentions → *„Meine Mentions"*-Aggregat über alle Channels
/{tenant}/chat/archived → Archivierte Channels (auf die User Zugriff hat)
/{tenant}/admin/chat/ → Tenant-Admin-Übersicht (alle Channels, Audit, Cleanup-Tools)
/{tenant}/admin/chat/:id → Admin-Channel-Detail (Audit, Force-Member-Edit, Force-Delete)
Mobile-Sichtbarkeit (LP-2 Baustellen-Modus):
- Index, Channel-Detail, Mention-Aggregat sind mobile-first
- Cross-Channel-Suche eingeschränkt auf Volltext-Modus (kein Power-Filter)
- Thread-View vereinfacht (Eltern-Message + Replies linear, kein Side-by-Side)
Block C — Channel-Typen und Lifecycle
C.1 — Projekt-Chat (kind=project)
Auto-Anlage:
- Bei Project-Anlage in M4 (Block F — alle Anlage-Quellen) wird automatisch ein TeamChat mit
kind=projectundproject_id=Project.iderstellt - Default-Members: alle ProjectMembers + assigned PL aus Project (M4)
- Default-Name: Project-Title (in UI, nicht persistiert; bleibt synchron)
- Beschreibung-Default: „Projekt-Chat für [Project-Title], P-2026-XXXX"
- Erste System-Nachricht: „Projekt angelegt von [User] am [Datum]. PL: [Name]. Members: [Liste]."
Member-Sync:
- ProjectMember-Add in M4 → Chat-Member-Add (mit System-Message)
- ProjectMember-Remove in M4 → Chat-Member auf
left_atgesetzt + System-Message - PL-Wechsel in M4 → System-Message im Chat
- Manuelles Member-Edit im Chat erlaubt: zusätzliche User können ohne ProjectMember-Status zum Chat eingeladen werden (z.B. Backoffice für Klärungs-Frage). Diese erscheinen NICHT als ProjectMember in M4.
Auto-Archive:
- Bei Stage-Wechsel auf
completedODERcancelled(M4 Block F) wird Chat 7 Tage später automatisch archiviert (Cron) - Tenant-Admin-Setting pro Pipeline: Auto-Archive-Verzögerung in Tagen (Default 7, Range 0-90, oder „nie")
- Bei Project-Reaktivierung (M4): Chat wird automatisch reaktiviert
- Beim Auto-Archive-Schritt: Chat read-only, Members behalten Lese-Zugriff, System-Message „Chat archiviert — Projekt abgeschlossen am [Datum]"
Hard-Delete:
- Project-Hard-Delete (M4) → blockiert wenn aktive Acceptance-Protokolle existieren; sonst kaskadiert auch Chat-Hard-Delete (Audit-Trail bleibt im Activity-Stream)
C.2 — Gruppen-Chat (kind=group)
Anlage: Manuell unter /{tenant}/chat/new durch User mit chat.create_channel.
Konfiguration beim Anlegen:
- Name (Pflicht)
- Description (optional)
- Privacy (
is_private): privat (nur Members sehen) oder öffentlich (im Channel-Browser sichtbar, jeder mitchat.read_own_channelskann beitreten) - Initial-Members: Multi-Select (Users + Groups aus M27 Block C.4 — Group-Auswahl löst alle Member ein)
- Notification-Default für neue Members
- Optional: aus Group-Definition (M27 C.4) auto-syncen → bei Group-Mitglieder-Änderung wird Chat-Member-Liste angeglichen (Toggle, Phase 1 ja)
Use-Cases (Geerkens-Beispiele): „Team Süd", „Außendienst-Allgemein", „Lehrlinge", „Notfall-Pikett".
Member-Verwaltung:
- Channel-Admins können einladen/entfernen
- „Channel verlassen" möglich für jeden Member (Last-Admin-Block)
- Bulk-Add aus Group oder via Multi-Select
Archivierung:
- Manuell durch Channel-Admin oder Tenant-Admin
- System-Message: „Channel archiviert von [User] am [Datum]"
- Read-only ab Archivierung; Reaktivierung möglich
C.3 — Direkt-Nachricht (kind=dm)
Anlage:
- User klickt „Neue DM" → User-Picker → System sucht existierenden DM zwischen den beiden Usern
- Falls existiert: Reuse + Navigation
- Falls nicht: Anlage mit beiden Members + erste leere Konversation
Eigenschaften:
- Genau 2 Members, immer
- Privat (nicht im Channel-Browser sichtbar)
- Read-Receipts immer aktiv und sichtbar pro Nachricht
- Tenant-Admin sieht DMs nicht standardmäßig (Privacy); nur bei explizitem Audit-Antrag mit Begründung (Audit-Log)
- Keine Pinned Messages, keine Member-Verwaltung
- Threads erlaubt
- Reactions erlaubt
Group-DMs (3+ User): Phase 2. In Phase 1 wird empfohlen, Group-Channel anzulegen.
Lebenszyklus:
- DMs werden NICHT auto-archiviert
- Manuelle Archivierung durch einen der beiden Member möglich (beim anderen wird Chat dann auch archiviert)
- Bei User-Deaktivierung (M27 D.2): DM wird auf der Seite des verbleibenden Users sichtbar als „DM mit ehemaligem Mitarbeiter" (read-only)
Block D — Listen-View (Channel-Index)
/{tenant}/chat
Zu zeigende Daten pro Channel-Eintrag:
- Channel-Name (bei DM: Name des anderen Users)
- Avatar/Initialen (bei DM: anderer User; bei Group: Channel-Icon; bei Project: Project-spezifischer Indikator)
- Letzter Nachrichten-Auszug (Body-Preview, max. 80 Zeichen, Mentions hervorgehoben)
- Letzter Nachrichten-Zeitstempel (relativ wenn < 7 Tage)
- Unread-Counter (Badge mit Zahl)
- Mention-Indikator (separat von Unread, falls in den ungelesenen Nachrichten Mentions auf den User existieren)
- Pin-Indikator (User-Pin, siehe TeamChatMember.is_pinned)
- Channel-Typ (visuell unterscheidbar: Projekt / Gruppe / DM)
- Bei Projekt-Chats: Project-Stage als zusätzlicher Hinweis
- Mute-Indikator (wenn
notification_pref=muted)
Benötigte UI-Elemente:
- Listen-Anzeige aller Channels des Users (default sortiert nach
last_message_at DESC, gepinnte zuerst) - Such-Funktion (Channel-Namen + Member-Namen + Volltext über letzte Nachrichten)
- Filter-Funktionen:
- Channel-Typ (Projekt / Gruppe / DM / Alle)
- Nur ungelesene
- Nur mit Mentions
- Verknüpfter Project-Status (aktiv / archiviert / abgeschlossen)
- Tag (über Project-Tags bei Projekt-Chats)
- Toggle „Archivierte anzeigen"
- Aktions-Funktionen pro Eintrag: Anpinnen/Lösen, Mute/Unmute, Mark-as-read, Archivieren (mit Permission)
- Quick-Action-Funktion „Neuer Channel" / „Neue DM"
- Cross-Channel-Suche-Funktion (führt nach
/{tenant}/chat/search) - Sektion „Meine Mentions" als Direkt-Link
- Channel-Browser-Funktion für öffentliche Group-Channels (Discover)
Operationen:
- Klick öffnet Channel-Detail
- Pin / Unpin (User-spezifisch)
- Mute (per Channel)
- Mark all as read
- Archivieren (mit Permission)
Performance:
- Server-side gefiltert nach Member-Sichtbarkeit (User sieht nur eigene Channels + sichtbare öffentliche Groups)
- Index auf
(user_id, tenant_id, left_at, is_pinned, last_message_at DESC)über TeamChatMember + JOIN - Pagination: 50 Channels pro Page, „Mehr laden"
- WebSocket-Push bei neuer Nachricht aktualisiert Index in Echtzeit
Block E — Detail-View (Chat-Verlauf)
/{tenant}/chat/:id
Zu zeigende Daten:
- Channel-Header: Name, Typ-Indikator, Member-Anzahl, bei Projekt-Chat Link auf Project-Detail (M4)
- Pinned-Messages-Sektion (max. 3 sichtbar inline + Link auf Pinned-Übersicht)
- Chat-Verlauf (chronologisch absteigend von neu nach alt beim Scrollen, neuste unten)
- Pro Nachricht: Author-Avatar + Name, Zeitstempel, Body (Markdown gerendert), Reactions, Thread-Indikator (Anzahl Replies + letzter Reply-Zeitpunkt), Mentions hervorgehoben, Attachments inline gerendert (Bild-Thumbnails, Dateinamen mit Icon, Link-Previews)
- Edited-Marker bei
edited_at != NULL - Lösch-Platzhalter bei
deleted_at != NULL - System-Messages visuell anders dargestellt (z.B. zentriert, neutraler Stil — Designer)
- Read-Receipts-Aggregat unter eigener Nachricht (z.B. „3 von 5 gelesen"; bei DM einfach gelesen/ungelesen)
- Date-Bucket-Separatoren (heute / gestern / Montag, 5. Mai / ...)
- Compose-Bereich am unteren Rand des Verlaufs
- Markdown-Eingabe
- Datei-Anhang-Funktion (M23-Upload)
- Emoji-Picker
- @-Mention-Auto-Complete (siehe F.4)
- Send-Funktion (Tastatur-Shortcut Enter, Shift+Enter für Zeilenumbruch — aber mobile-friendly Variante)
- Draft-Auto-Save (lokal pro Channel; bleibt erhalten bei Tab-Wechsel)
- Sidebar/Sektion mit Channel-Info: Members-Liste, Pinned, Files, Settings-Funktion (für Channel-Admins)
- Typing-Indikator („Max tippt...") — siehe Block H
Benötigte UI-Elemente:
- Sektionierte Anzeige des Verlaufs mit Date-Bucketing
- Inline-Compose mit Markdown-Editor
- Emoji-Picker mit Suchfunktion
- @-Mention-Auto-Complete (Such-Funktion über User/Project/Deal/Contact)
- Datei-Drop-Zone (Drag-&-Drop)
- Per-Message-Aktions-Funktionen (Hover/Tap-Menü):
- Reagieren (Emoji-Picker)
- Antworten im Thread
- Anpinnen (mit Permission)
- Mark as Task
- Kopieren / Permalink
- Editieren (nur eigene + innerhalb 24h)
- Löschen (nur eigene + Channel-/Tenant-Admin)
- Scroll-to-Bottom-Funktion bei aktiver Lese-Position weit oben
- New-Messages-Indikator wenn unten weiter Nachrichten ankommen
- Thread-Side-Panel oder eigene Route für Thread-Detail
Operationen:
- Nachricht senden
- Datei anhängen
- Emoji einfügen
- @-Mention setzen (User / Projekt / Deal / Contact / Firma)
- Reagieren
- In Thread antworten
- Pinnen / Lösen (mit Permission)
- Mark as Task
- Editieren (mit Author + 24h-Fenster ODER
tenant.admin) - Löschen (Author / Channel-Admin / Tenant-Admin)
- Permalink kopieren
- Member hinzufügen / entfernen (Channel-Admin)
- Channel-Settings öffnen
- Channel verlassen
- Mark all as read
Performance-Anforderungen:
- Initial-Load: 50 letzte Nachrichten
- Infinite-Scroll nach oben mit Cursor-basierter Pagination (50er-Batches)
- WebSocket für neue Nachrichten / Edits / Deletes / Reactions / Read-Receipts (Block H)
- Optimistic-UI: Nachricht sofort gerendert nach Send, Server-Bestätigung aktualisiert ID
- Attachments lazy-geladen bei Eintritt in Viewport
- Read-Receipt-Schreiben gebatcht (alle 2 Sekunden, max. 50 Messages pro Batch)
Block F — Threads, Reactions, Pinned, Mentions
F.1 — Threads
Verhalten:
- Klick auf „Antworten im Thread" an einer Nachricht öffnet Thread-Side-Panel oder eigene Route
/{tenant}/chat/:id/thread/:thread_id - Thread enthält: Eltern-Nachricht + Replies in chronologischer Reihenfolge (älteste zuerst)
- Thread-Reply ist eine TeamChatMessage mit
parent_message_id = parent.id; ergänzt die TeamChatThread-Aggregate (reply_count,last_reply_at,participant_user_ids) - Im Channel-Verlauf zeigt die Eltern-Nachricht einen Thread-Indikator: „X Replies" + Avatare der Participants + letzter Reply-Zeitpunkt
- Replies erscheinen NICHT im Haupt-Verlauf (Default), außer User aktiviert „Auch im Hauptverlauf zeigen" per Reply (Slack-Pattern, Toggle pro Reply)
- Thread-Notifications: Reply benachrichtigt nur Thread-Participants + bei Mentions
- Mentions in Thread-Replies funktionieren wie im Hauptverlauf
Operationen:
- Reply schreiben
- Thread folgen / nicht folgen (für Notifications)
- Thread-Permalink kopieren
- Eigene Reply editieren / löschen
F.2 — Reactions
Verhalten:
- Klick auf Reagieren-Funktion an einer Nachricht öffnet Emoji-Picker
- Reaktion wird sofort übermittelt (Optimistic-UI)
- Anzeige als Badge unterhalb der Nachricht: Emoji + Counter (Klick zeigt Liste der reagierenden User)
- Klick auf eigene Reaktion entfernt sie (Toggle)
- Eigene + andere Reaktionen sichtbar; eigene visuell hervorgehoben
Anti-Spam-Konstraints:
- Max. 20 verschiedene Emojis pro Nachricht
- Max. 8 eigene Reaktionen pro Nachricht
- Bei Erreichen: Klartext-Hinweis
F.3 — Pinned Messages
Verhalten:
- Per-Message-Aktion „Anpinnen"
- Permission:
chat.adminfür den Channel ODER Author der Nachricht (eigene Notiz pinnen) - Anzeige: Pinned-Sektion oben im Verlauf (max. 3 inline) + Übersicht unter
/{tenant}/chat/:id/pinned - „Lösen"-Funktion an gepinnter Nachricht
- Optional: Note/Begründung beim Pinnen
Use-Cases (SHK): Wichtige Telefonnummern, Adresshinweise, Material-Bestelllisten, Zugangsdaten Baustelle, kritische Termine.
F.4 — Mentions mit Auto-Verknüpfung
Mention-Typen:
| Trigger | Picker zeigt | Auflösung-Ziel | Effekt |
|---|---|---|---|
@username |
Channel-Members + alle aktiven Tenant-User (mit Permission-Filter) | User | Notification für gementen User |
@projekt: oder #P-... |
Aktive Projekte mit read_* |
M4 Project | Klickbarer Link, Auto-Activity im Project-Stream |
@deal: oder #D-... |
Aktive Deals mit read_* |
M3 Deal | Klickbarer Link, Auto-Activity im Deal-Stream |
@kontakt: |
Sichtbare Contacts | M1 Contact | Klickbarer Link, Auto-Activity im Contact-Stream |
@firma: |
Sichtbare Companies | M1 Company | Klickbarer Link, Auto-Activity |
@channel |
(Spezial-Trigger) | alle Channel-Members | Notification an alle (mit Confirm bei großen Channels) |
@here |
(Spezial-Trigger) | alle aktuell online Members | Notification an Online-Members |
Auto-Complete-Verhalten:
- Tipp-Trigger ist
@ - Debounced Such-Lookup (200ms)
- Vorschläge gruppiert nach Typ (User zuerst, dann Projekte/Deals/Kontakte/Firmen)
- Top-10-Treffer
- Permission-aware: nicht-sichtbare Entities erscheinen nicht
- Bei keinem Treffer: Klartext „Keine Treffer für '[query]'" — KEIN Auto-Anlegen aus Mentions
Auto-Verknüpfung:
- Mention auf Project/Deal/Contact/Company in einer Nachricht erzeugt eine Activity im jeweiligen Stream (
subject = mentionTarget,summary = „[User] hat im Chat [Channel] über dich gesprochen: [Snippet]") - Klick auf Mention im gerenderten Body navigiert zur jeweiligen Detail-View
- Bei Projekt-Chat-Mention auf den eigenen Project: keine Duplikat-Activity (Verlinkung implizit)
Speicherung:
TeamChatMessage.mentions[]ist ein JSON-Array von Resolved-Mentions:[{kind: 'user', id, label}, {kind: 'project', id, label, project_number}, ...]- Body enthält Mention als spezielle Markdown-Syntax (z.B.
<@user:abc>,<@project:xyz>); UI rendert daraus klickbare Chips
Mass-Mentions:
@channelin Channels mit > 25 Members triggert Klartext-Confirm: „Damit benachrichtigst du 47 Personen. Trotzdem?"@herezeigt aktuell-online-Anzahl im Confirm
Block G — Datei-Uploads, Link-Previews, Mark-as-Task
G.1 — Datei-Uploads
Integration mit M23 (Files):
- Dateien aus dem Compose-Bereich werden in den File-Namespace des Channels hochgeladen (Storage-Pfad
tenants/{tenantId}/chat/{chatId}/...) - Bei Projekt-Chat: zusätzlich Verknüpfung mit Project-File-Namespace (Datei taucht in M4 Files-Tab auf)
- File-Record mit Backlink auf Source-Message
- Multi-File-Upload (Drag-&-Drop oder File-Picker)
- Foto-Direct-Upload aus Mobile (Kamera) — siehe Block J
- Größen-/Typ-Limits aus M23 (Tenant-Setting)
- Anti-Virus-Scan aus M23
Anzeige im Verlauf:
- Bilder als Thumbnail inline (Klick öffnet Lightbox)
- Videos als Thumbnail mit Play-Button (Inline-Player oder externer Open)
- PDFs / Office-Dateien als File-Card mit Vorschau-Link
- Andere Datei-Typen: generisches File-Icon + Name + Größe
- Download-Funktion pro Datei
- Im Files-Tab des Channels: aggregierte Liste aller Dateien
Operationen:
- Hochladen, Herunterladen
- Löschen (nur Author + 24h-Fenster ODER Channel-/Tenant-Admin) — entfernt File und Backlink
- „In Project-Files speichern" (bei Nicht-Projekt-Chats: Funktion kopiert Datei in einen Ziel-Project-Namespace)
G.2 — Link-Previews
Verhalten:
- Beim Senden einer Nachricht erkennt Backend URLs im Body (Regex)
- Asynchroner Job zieht OG-Tags / oEmbed (Title, Description, Bild, Site-Name)
- Preview wird in
link_previews[]gespeichert (max. 3 Previews pro Message; weitere ignoriert) - WebSocket-Update an Channel: Preview erscheint nach kurzem Delay
- Bei Fehler: kein Preview (Klartext im Hover „Vorschau nicht verfügbar")
Privacy-Einstellungen (Tenant-Admin):
- Toggle „Link-Previews aktivieren" (Default an)
- Whitelist/Blacklist von Domains (Phase 2)
- EU-Provider für Link-Preview-Service (LP-13): Eigener Microservice statt Drittanbieter
Klartext-Hinweise:
- Preview-Service down: „Vorschau wird später nachgeladen"
- Geblockte Domain: kein Preview, keine UI-Erwähnung
G.3 — Mark as Task
Verhalten:
- Per-Message-Aktion „Mark as Task" öffnet Task-Anlage-Modal mit:
- Task-Titel (Default: erste Zeile der Message bzw. erste 80 Zeichen)
- Beschreibung (Default: Message-Body komplett)
- Zugewiesener User (Default: Author falls Mention vorhanden — sonst leer)
- Deadline (optional)
- Verknüpftes Subject: Auto-übernommen aus Channel (Projekt-Chat → linkt auf Project; sonst leer / manuell wählbar)
- Bestätigen → Task wird in M26 angelegt mit:
- Backlink-Field auf Source-Message (TeamChatMessage-ID)
- Activity „Task erstellt aus Chat" im verknüpften Subject-Stream
- System-Reply unter der Source-Message: „[User] hat aus dieser Nachricht eine Aufgabe erstellt: [Task-Titel] → [Link]"
Permissions:
tasks.writePflicht- Wenn fehlend: Funktion ausgeblendet; Tooltip „Aufgaben erstellen erfordert erweiterte Berechtigungen"
Block H — WebSocket-Server / Echtzeit-Übermittlung
H.1 — Architektur
Server-Komponente:
- Eigener WebSocket-Endpoint
/ws/chat(separat von HTTP-API, gleicher Auth-Mechanismus über Session-Cookie + Tenant-Context) - Ein WebSocket-Connection pro Browser-Tab pro User
- Connection-Auth bei Handshake: Session-Cookie + Tenant-ID validiert
- Rooms-Modell: pro Channel ein Room; User joined Room beim Öffnen des Channels und beim Hintergrund-Subscribe für eigene Channels (für Index-Updates)
Skalierung:
- Redis-Pub/Sub als Message-Broker zwischen Server-Instanzen (Multi-Pod-Setup)
- Sticky-Sessions am Load-Balancer (oder Token-basiertes Re-Connect)
- Backpressure: Bei langsamen Clients verwirft Server alte Events; Client lädt bei Reconnect verpasste Nachrichten via REST-Cursor
H.2 — Übermittelte Events
| Event | Trigger | Empfänger |
|---|---|---|
message.new |
Neue Nachricht | Alle Channel-Members |
message.edited |
Nachricht editiert | Alle Channel-Members |
message.deleted |
Nachricht gelöscht | Alle Channel-Members |
reaction.added / reaction.removed |
Reaktion-Toggle | Alle Channel-Members |
thread.reply |
Thread-Reply | Channel-Members + Thread-Participants |
read.receipt |
Lese-Marker | Channel-Members |
typing.start / typing.stop |
Tipp-Indikator | Channel-Members (außer Sender) |
channel.member_added / member_removed |
Membership-Änderung | Alle Channel-Members |
channel.archived |
Archivierung | Alle Channel-Members |
channel.pinned_changed |
Pin/Unpin | Alle Channel-Members |
presence.online / presence.offline |
User wechselt Status | Alle User mit gemeinsamem Channel |
link_preview.ready |
Preview asynchron fertig | Alle Channel-Members |
H.3 — Reconnect-Strategie
- Client speichert letzten gesehenen Event-Cursor pro Channel
- Bei Reconnect: REST-Call holt verpasste Nachrichten/Events seit Cursor
- WebSocket-Verbindungs-Verlust > 30 Sekunden → Banner „Verbindung unterbrochen — versuche Neuaufbau..."
- Connection-Pooling pro Tab (Single-Connection für alle Channels)
H.4 — Typing-Indikator
- Client sendet
typing.startbeim ersten Tastendruck im Compose - Throttle: Re-Senden alle 3 Sekunden, solange weiter getippt wird
typing.stopnach 5 Sekunden Inaktivität ODER Send- UI zeigt „X tippt..." / „X und Y tippen..." / „Mehrere tippen..."
H.5 — Presence
- Pro User Online-Status:
online | away | offline online= aktiver Tab + WebSocket connectedaway= WebSocket connected, kein Tab-Focus seit 5 Minoffline= keine Connection- Channel-Members-Liste zeigt Status-Indikator
H.6 — Architektur-Vorschriften
- LP-13: WebSocket-Server im EU-Hosting (kein Pusher.com / kein Drittanbieter)
- AV: Auth-Validation auch pro Event (nicht nur bei Handshake) — Permission-Änderung wirkt sofort
- Audit-relevante Events (member_added, channel_archived) gehen zusätzlich in Activity-Stream + Audit-Log
Block I — Read-Receipts und Notifications
I.1 — Read-Receipts
- Client beobachtet Viewport: Nachricht > 1 Sekunde sichtbar → in Read-Batch sammeln
- Batch alle 2 Sekunden an Server (oder beim Verlassen des Channels)
- Server schreibt TeamChatRead-Records + emittiert
read.receipt-Event - UI-Anzeige:
- DM: Pro-Message „gelesen um [Zeit]" unterhalb eigener Nachricht
- Group/Project: „X von Y gelesen" unterhalb eigener Nachricht; Klick zeigt Liste der Gelesen/Ungelesen-User
- TeamChatMember.last_read_message_id wird auf den höchsten gelesenen Message-Cursor gesetzt → bestimmt Unread-Counter im Index
I.2 — Notifications (M22)
Trigger:
| Event | Default-Notification | Konfigurierbar pro Channel |
|---|---|---|
| Neue Message in Channel | abhängig von notification_pref |
ja |
| @-Mention auf User | immer | nein (immer aktiv außer muted) |
| @here / @channel mit Online-Status | bei notification_pref != muted |
ja |
| Neue DM | immer (außer muted) |
nein |
| Thread-Reply (User folgt Thread) | immer | nein (per-Thread-Toggle) |
| Channel-Member-Add (Self) | immer | nein |
| Channel-Archive | nicht notifiziert | nein (System-Message reicht) |
Channel-Notification-Modi:
all_messages— jede Message benachrichtigtmentions_only— nur bei eigenen Mentions / DMs / @here / @channelmuted— keine Notifications, nur visueller Unread-Counter
Channels:
- In-App Notification (Modul 22): Bell-Center mit Mention-Aggregat
- Push-Notification (Web-Push + Mobile-App): siehe Block J
- Email-Digest (Phase 2): tägliche Zusammenfassung verpasster Mentions/DMs
Anti-Spam-Bündelung (M22):
- Bei > 5 Nachrichten in < 1 Minute aus demselben Channel: Bündeln zu „X neue Nachrichten in [Channel]"
- Pro User pro Stunde max. 10 Push-Notifications (Rest gebündelt)
- Mentions umgehen Bündelung (immer einzeln zugestellt)
Quiet-Hours:
- Pro User unter
/{tenant}/settings/notifications/: Stille-Zeiten (z.B. 20:00-7:00, Sa+So) - Während Stille-Zeit: nur DMs + Mentions kommen durch (konfigurierbar)
- Manueller Override „Auch in Stille-Zeit benachrichtigen" pro Channel
Override-Hierarchie (höchste Priorität zuerst):
- Channel-Mute → unterdrückt alles außer DMs und @-Mentions
- Quiet-Hours → unterdrückt alles außer expliziter Override
- User-Default-Notification-Pref → System-Default
mentions_only - Channel-Default → bei neuen Channel-Beitritten
Block J — Mobile-First für Monteur (LP-2)
J.1 — Vereinfachte Chat-View
Ziel: Monteur auf Baustelle nutzt Smartphone, oft mit Handschuhen, schlechtes Licht, schnelle Bedienung.
Anforderungen:
- Compose-Funktion prominent erreichbar (Daumen-Zone)
- One-Tap „Foto senden"-Funktion (öffnet Kamera direkt; nach Aufnahme Vorschau + Send-Funktion ohne Modal-Verkettung)
- Voice-Note-Funktion (Halten zum Aufnehmen, Loslassen zum Senden) — Audio-File als Attachment + optionaler Whisper-EU-Transkript (M18) im Body
- Reduzierte Channel-Liste: Default-Filter „Aktive Projekt-Chats + DMs mit Mentions"
- Vereinfachte Mention-Auto-Complete (User-Liste prominent, Project/Deal/Contact unter „Mehr")
- Pinned Messages prominent im Header (für Adressen, Material-Listen, Notrufnummern)
- Read-Receipts vorhanden, aber dezenter dargestellt
- Threads vereinfacht (lineare Reply-Liste statt Side-by-Side)
- Push-Notifications mit Quick-Reply-Funktion (direkt aus Notification antworten)
J.2 — Push-Notifications
Konfiguration:
- Pro User pro Gerät registriertes Push-Token (Web-Push API + native Mobile-App in Phase 2)
- Push für eigene Channels mit
notification_pref != muted - Mention-Push immer (unabhängig von Stille-Zeit konfigurierbar)
- Click auf Push-Notification öffnet direkt Channel-Detail an gemeinter Message-Position
Datenschutz:
- Push-Payload enthält NUR: Channel-Name (Projekt-Title generisch „P-2026-XXXX"), Message-Sender-Name, Snippet (max. 100 Zeichen)
- Keine Adressen, keine PII außer Sender-Vorname
- Tenant-Setting „Push-Vorschau im Lock-Screen" (Default an, Off = nur „Neue Nachricht")
J.3 — Foto-Direct-Upload
- Kamera-Zugriff aus PWA / Mobile-App
- Foto wird komprimiert (max. 2048px lange Kante, JPEG-Qualität 85)
- Optional: Auto-Caption mit Datum/Uhrzeit/GPS-Koordinaten als Footer-Text (Tenant-Toggle, Default aus, GPS nur mit User-Permission)
- Multi-Foto-Upload möglich (Galerie-Auswahl)
- Bei Projekt-Chat: Foto landet zusätzlich im Project-File-Namespace (M4/M23)
Block K — Activity-Stream-Integration
K.1 — Erzeugte Activities
| Activity-Typ | Bedingung | Subject |
|---|---|---|
chat.message |
Neue Nachricht in Channel mit Bezug | linkt auf zugeordnetes Subject (Project/Deal/Contact bei Projekt-Chat / bei Mentions) |
chat.mention |
@-Mention auf Project/Deal/Contact/Company | Mention-Target |
chat.channel_created |
Channel angelegt | Channel selbst (oder verknüpftes Project) |
chat.channel_archived |
Channel archiviert | Channel / Project |
chat.task_created_from_message |
Mark-as-Task | Source-Message + Task |
chat.member_added / chat.member_removed |
Membership-Änderung | Channel |
K.2 — Aggregat-Wirkung
- Projekt-Detail (M4): Activity-Stream zeigt
chat.message-Aktivitäten des Projekt-Chats unter Filter „Chat" (Auto-Filter aktiv); Default ausgeblendet, da hohes Volumen — User kann „Chat-Nachrichten einblenden" togglen - Deal-Detail (M3): Mentions auf Deal aus Chat erscheinen im Stream (selten, niedrigere Volumen)
- Contact-Detail (M1): Mentions auf Contact erscheinen
- Globale Aggregate (Dashboard): Summary-Kacheln zeigen „X Mentions / Tag", „Y aktive Chats"
K.3 — Datenschutz
chat.message-Activities tragen NURsummary_text(Sender + Channel + Snippet 80 Zeichen) +metadatamit Message-ID- Klick auf Activity navigiert in den Channel — Permission-aware (User ohne Channel-Zugang sieht Activity-Eintrag, aber Klick führt zu „Du bist kein Mitglied dieses Channels"-Hinweis)
- Activities respektieren Channel-Privacy: bei privaten Channels wird Activity NUR Channel-Members angezeigt (nicht z.B. allen mit
crm.read_all)
Block L — Permissions-Anwendung
L.1 — Permission-IDs
| Permission | Erlaubt |
|---|---|
chat.read_own_channels |
Eigene Channels (Member-Status) sehen |
chat.write |
Nachrichten senden, reagieren, Threads, Datei-Uploads, Mark-as-Task in eigenen Channels |
chat.create_channel |
Group-Channels anlegen |
chat.create_dm |
Direkt-Nachrichten starten |
chat.admin |
Channel-Settings (alle Channels), Force-Member-Edit, Force-Archive, Force-Delete-Message |
chat.read_all_channels |
Tenant-Admin-Sicht: alle Channels lesen (Audit) — Nutzung wird audit-loggt |
Permission-Verhalten innerhalb Channel:
- Channel-Admin (TeamChatMember.role_in_chat=admin) hat Channel-Local-Admin-Rechte ohne
chat.adminglobal zu brauchen chat.adminsticht Channel-Admin-Status aus
L.2 — Bundle-Mapping (Variante 2)
| Bundle | Atomare Permissions |
|---|---|
chat.none |
(keine — User sieht Sidebar-Punkt nicht) |
chat.read_own |
chat.read_own_channels |
chat.write |
obigen + chat.write + chat.create_dm |
chat.member |
obigen + chat.create_channel |
chat.admin |
obigen + chat.admin + chat.read_all_channels |
L.3 — SHK-Template-Default-Rollen
| Rolle | Chat-Bundle |
|---|---|
| GF | chat.admin |
| Vertriebsleiter | chat.member |
| Vertriebler | chat.write |
| Projektleiter / Bauleiter | chat.member |
| Büro / Backoffice | chat.member |
| Marketing | chat.write |
| Monteur | chat.write (kein Group-Channel-Anlage; DM aktiv; Projekt-Chats werden auto-zugeordnet) |
L.4 — Anwendung in Routes
/{tenant}/chat→chat.read_own_channels/{tenant}/chat/new→chat.create_channel(Group) oderchat.create_dm(DM)/{tenant}/chat/:id→ Membership-Check (User muss TeamChatMember sein) ODERchat.read_all_channels/{tenant}/chat/:id/info→ Channel-Member oderchat.admin/{tenant}/chat/:id/thread/:thread_id→ Membership-Check/{tenant}/chat/mentions→chat.read_own_channels/{tenant}/chat/archived→chat.read_own_channels(zeigt nur archivierte Channels, in denen User Member war)/{tenant}/admin/chat/→tenant.adminODERchat.admin
L.5 — Action-Buttons / Operationen
- Senden / Reagieren / Thread-Reply / Mention:
chat.write+ Membership - Pinnen / Entfernen-Pin:
chat.adminglobal ODER Channel-Admin ODER (eigene Message) - Editieren: Author + 24h-Fenster ODER
tenant.admin - Löschen: Author + 24h-Fenster ODER Channel-Admin ODER
chat.admin - Member hinzufügen: Channel-Admin ODER
chat.admin - Channel umbenennen / Description ändern: Channel-Admin ODER
chat.admin - Channel archivieren: Channel-Admin ODER
chat.adminODER (bei Projekt-Chat) PL über Cascading aus M4 - Channel hard-löschen: nur
chat.admin(mit Klartext-Confirm + Audit-Log) - Mark as Task: zusätzlich
tasks.write
L.6 — Owner-Check-Logik
chat.read_own_channels: User darf Channels sehen, in denen er aktiver TeamChatMember ist (left_at IS NULL)- DMs: nur die zwei Members
- Projekt-Chats: ProjectMember-Sync (Member-Add in M4 = Member-Add in Chat); wer kein ProjectMember mehr ist, behält Lese-Zugriff bis Auto-Archive (Audit), aber kann nicht mehr schreiben
- Öffentliche Group-Channels (
is_private=false): User mitchat.read_own_channelssehen Channel im Browser und können beitreten
L.7 — read_all_channels (Tenant-Admin-Audit)
- Sicht auf alle Channels inkl. DMs
- Jede Lese-Aktion mit dieser Permission wird zusätzlich audit-loggt (Audit-Trail-Modul) mit Klartext-Begründungs-Pflicht (User muss bei erstmaligem Zugriff pro Session Begründung eingeben)
- Admin kann nicht im fremden Namen schreiben, nur lesen
- DMs werden mit Banner „Diese DM wird im Audit-Modus angezeigt" markiert
Block M — Klartext-Hinweise / -Fehler
- Leerer Channel-Index: „Du bist noch in keinem Channel. Lege einen neuen an oder warte auf eine Einladung."
- Leerer Channel: „Noch keine Nachrichten. Schreib die erste!"
- Keine Permission auf Channel: „Du bist kein Mitglied dieses Channels." (404 statt 403, um Existenz nicht zu offenbaren — außer bei öffentlichen Group-Channels)
- Channel archiviert: Banner „Dieser Channel ist archiviert. Du kannst lesen, aber nicht mehr schreiben. [Reaktivieren]" (Reaktivieren mit Permission)
- Verbindung verloren: „Verbindung unterbrochen — versuche Neuaufbau..."
- Reconnect erfolgreich: kurzer Hinweis „Wieder verbunden" + Auto-Sync verpasster Nachrichten
- Mass-Mention-Confirm: „Damit benachrichtigst du 47 Personen. Trotzdem?"
- Editieren nach 24h: „Editieren ist nur innerhalb 24 Stunden möglich."
- Datei zu groß: „Datei [Name] ist zu groß ([X] MB von max. [Y] MB)."
- Datei-Typ blockiert: „Dateityp [.exe] ist nicht erlaubt."
- Last-Admin-Leave: „Du bist der einzige Admin in diesem Channel. Bitte einen anderen Member zum Admin ernennen oder den Channel archivieren, bevor du gehst."
- Last-Admin-Member entfernen: analog
- Mark-as-Task ohne Permission: „Aufgaben erstellen erfordert erweiterte Berechtigungen." (Funktion ausgeblendet im Default; nur on-Hover/-Tap-Hinweis)
- Tenant-Admin-DM-Audit-Begründung-Pflicht: Modal mit Pflicht-Textfeld „Bitte begründe den Audit-Zugriff (z.B. Compliance-Anfrage, Vorfall-Untersuchung)"
- Push-Notification-Berechtigung verweigert: „Browser-Benachrichtigungen sind deaktiviert. In den Browser-Einstellungen aktivieren um wichtige Mentions zu erhalten."
- Quiet-Hours aktiv: kleine Anzeige im Settings-Bereich „Stille-Zeit bis [Zeit] — nur DMs und Mentions kommen durch."
- Reaktion-Limit erreicht: „Du hast bereits 8 Reaktionen auf diese Nachricht. Entferne eine, um eine neue hinzuzufügen."
- Pinned-Limit: „Maximal 50 Nachrichten pro Channel können angeheftet werden. Bitte ältere Pins lösen."
- Auto-Archive-Vorwarnung: System-Message 24h vor Auto-Archive „Dieser Projekt-Chat wird morgen automatisch archiviert (Projekt abgeschlossen am [Datum]). [Archivierung verschieben]"
Block N — Phase 2 / spätere Features
Bewusst NICHT in Phase 1:
- Group-DMs (3+ User ohne Group-Channel): in Phase 1 stattdessen Group-Channel anlegen
- Custom-Emojis: nur Standard-Unicode in Phase 1
- Email-Digest: tägliche Zusammenfassung verpasster Mentions/DMs
- Voice-/Video-Calls im Chat (Phase 2 oder später; bleibt bei AirCall/Externe)
- Slack-/Teams-Bridge: keine Phase-1-Integration
- Bots / Slash-Commands: kein /-Command-Framework in Phase 1; nur Mark-as-Task als Direkt-Aktion
- End-to-End-Verschlüsselung: Phase 1 nutzt Server-side-Verschlüsselung at rest, kein E2EE
- Search-Power-Filter: Cross-Channel-Suche in Phase 1 nur Volltext + Channel-Filter; erweiterte Filter (nach Author, Date-Range, Mention-Type) Phase 2
- Message-Scheduling: „Später senden"-Funktion Phase 2
- Pinned-Reorder: Drag-Reorder von Pinned-Messages Phase 2 (in Phase 1 Sortierung nach Pin-Datum DESC)
- Tenant-übergreifende Channels (Inter-Tenant-Chat): nicht angedacht
- KI-Auto-Übersetzung (M18): Phase 2 — automatische DE↔PL/EN/UA-Übersetzung von Chat-Messages für mehrsprachige Teams (PL-Monteur schreibt PL, Büro liest DE). Toggle pro User pro Channel; Übersetzung als Hover/Tap-Layer unter Original-Body. Sprach-Detect mit Fallback auf User-
Contact.language - KI-Chat-Summarizer: „Was war heute wichtig?"-Zusammenfassung über alle eigenen Channels (M18, Phase 2)
- KI-Smart-Reply-Vorschläge: Phase 2
- Voice-Note-Auto-Transcript-Search: Phase 1 hat Voice-Notes als Audio + optional Transcript; Volltext-Suche in Transcripts erst Phase 2
- Native Mobile-Apps: Phase 1 = PWA mit Web-Push; Native iOS/Android Phase 2
- Push-Notification-Quick-Reply native: in PWA nur Click-to-Open; native Quick-Reply Phase 2
Architektur-Vorschriften (Querschnitt)
- LP-2: Mobile-First für Chat-Detail, Foto-Upload, Voice-Note, Push-Quick-Reply (Phase 2)
- LP-3, AV #3: Chat-Notifications-Defaults und Auto-Archive-Verzögerung sind Branchen-Template-konfigurierbar (SHK-Default 7 Tage)
- LP-7: Quiply komplett abgelöst (Mitarbeiter-App, HR + Chat → HiveGrid)
- LP-9 + Stil-Vorgabe: UI-Element-Anforderungen als Liste, kein Layout
- LP-10, AV #1: Klartext-Diagnostik in jedem Block
- LP-13: WebSocket-Server EU-Hosting, Link-Preview-Service EU-self-hosted; Whisper-EU-Transkription für Voice-Notes; KI-Übersetzung Phase 2 über EU-Provider
- AV #5: Permissions-aware-Default in Channel-Listen (server-side gefiltert), Mention-Auto-Complete (nur sichtbare Entities), Activity-Anzeige (Permissions-respektierend)
- AV #6: Audit-Trail-Default für alle schreibenden Aktionen (Member-Edits, Channel-Archive, Force-Delete, Tenant-Admin-DM-Audit)
- AV #20: Action-Boundary für KI — KI-Übersetzung (Phase 2) ist passive Render-Layer, kein Auto-Send. KI-Smart-Reply-Vorschläge nur als Vorschlag, niemals automatisch versendet
Detail-Spec-Status: DRAFT
Erste vollständige Detail-Spec für Modul 13. Vor Bau: Verifizierung mit Noah (zusammen mit Pflichtenheft-Sweep, speziell Notification-Defaults und Auto-Archive-Verzögerung pro Pipeline). Bei Implementierung dann konkrete WebSocket-Event-Schemata, Markdown-Renderer-Spec und Mention-Resolver-API ergänzen.
Offene Detail-Punkte (nicht-blockierend, beim Bau zu klären):
- Konkrete Auto-Archive-Verzögerungs-Defaults pro SHK-Pipeline (Anlagen-Installation 14d? Wartung 7d? Notfall 3d?)
- Voice-Note: Maximum-Aufnahme-Dauer (Vorschlag 5 Min) und Storage-Limit pro Tenant
- Anti-Spam-Bündelung-Schwellen mit M22 abstimmen (5 Messages/Min vs. 3 vs. 10)
- Tenant-Admin-DM-Audit-Begründungs-UI: dropdown-vorgegeben oder Freitext?
- WebSocket-Reconnect-Backoff-Strategie (Exponential vs. linear) — Implementierungs-Detail
- Read-Receipt-Disable-Pro-User: ob Phase 1 oder Phase 2 (User möchte ggf. nicht zeigen, dass er gelesen hat)
- Group-DM-Konvertierung in Group-Channel: ob User-Workflow Phase 1 oder Phase 2
- Concrete File-Type-Whitelist für Chat-Uploads (überlappt mit M23)
- Subframe-UI-Designs (separat)
- Konkrete Migrations-Skripte für Quiply-Daten-Import (separates Migrations-Modul)