Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/_bmad-output/specs/M13-team-chat.md
T

888 lines
45 KiB
Markdown

---
module: 13
title: Team-Chat (intern)
phase: 1
status: detail-spec-draft
last_updated: 2026-05-08
session_source: brainstorming-session-2026-05-07-2206.md
related_lps: [LP-2, LP-3, LP-4, LP-7, LP-9, LP-10, LP-13]
spec_style: 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_id`
- `kind` (Enum: `project | group | dm`)
- `name` (Pflicht für `group`, optional für `project` — Default = Project-Title, NULL bei `dm` — wird aus Members generiert)
- `description` (Markdown-Freitext, optional)
- `project_id` (FK auf Project — NUR bei `kind=project`, sonst NULL)
- `is_private` (Boolean — `group` kann öffentlich/sichtbar im Channel-Browser oder privat/nur per Einladung sein; `project`/`dm` immer 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`, `name` darf leer bleiben (UI fällt auf Project-Title zurück)
- `kind=dm` → genau 2 TeamChatMember-Einträge, `name` und `description` werden ignoriert
- `kind=group` → mind. 1 Member, `name` Pflicht
- Pro Project max. 1 aktiver Projekt-Chat (Unique-Constraint auf `project_id` WHERE `archived_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 DESC` für Index-Sortierung
- `project_id` fü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` — `admin` darf 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_at`
- `is_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 `admin` pro `group`-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_at` für *„meine Channels"*-Listen
- `chat_id, user_id` für Membership-Lookups
### TeamChatMessage
Einzelne Nachricht im Channel oder Thread.
- `id`, `tenant_id`, `chat_id`, `created_at`, `updated_at`, `author_user_id`
- `body` (Markdown, max. 8000 Zeichen)
- `body_format` (Enum: `markdown | system` — `system` fü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:**
- `body` darf bei `attachments != []` leer sein (Reine-Datei-Nachricht)
- `body_format=system` darf NICHT von Usern erstellt werden (nur Backend)
- Editier-Fenster: 24h nach `created_at` (außer `tenant.admin`); danach Hard-Edit verboten
**Indizes:**
- `chat_id, parent_message_id, created_at DESC` für Channel-Verlauf-Pagination (Thread-Posts werden ausgefiltert mit `parent_message_id IS NULL`)
- `chat_id, parent_message_id, created_at ASC` für Thread-Verlauf
- GIN-Index auf `mentions` für *„meine Mentions"*-Query
- Trigram-Index auf `body` für In-Channel-Suche
### TeamChatPinnedMessage
Eine Nachricht kann pro Channel angeheftet werden.
- `id`, `tenant_id`, `chat_id`, `message_id`, `pinned_by_user_id`, `pinned_at`
- `note` (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.admin` ODER 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_id`
- `last_reply_at`
- `reply_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 DESC` fü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_id` fü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 Project
- `TeamChatMessage.author_user_id` → User
- `TeamChatMessage.attachments` → M23 File-Records
- `TeamChatMessage.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=project` und `project_id=Project.id` erstellt
- 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_at` gesetzt + 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 `completed` ODER `cancelled` (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 mit `chat.read_own_channels` kann 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.admin` fü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:**
- `@channel` in Channels mit > 25 Members triggert Klartext-Confirm: *„Damit benachrichtigst du 47 Personen. Trotzdem?"*
- `@here` zeigt 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.write` Pflicht
- 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.start` beim ersten Tastendruck im Compose
- Throttle: Re-Senden alle 3 Sekunden, solange weiter getippt wird
- `typing.stop` nach 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 connected
- `away` = WebSocket connected, kein Tab-Focus seit 5 Min
- `offline` = 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 benachrichtigt
- `mentions_only` — nur bei eigenen Mentions / DMs / @here / @channel
- `muted` — 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):**
1. Channel-Mute → unterdrückt alles außer DMs und @-Mentions
2. Quiet-Hours → unterdrückt alles außer expliziter Override
3. User-Default-Notification-Pref → System-Default `mentions_only`
4. 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 NUR `summary_text` (Sender + Channel + Snippet 80 Zeichen) + `metadata` mit 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.admin` global zu brauchen
- `chat.admin` sticht 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) oder `chat.create_dm` (DM)
- `/{tenant}/chat/:id` → Membership-Check (User muss TeamChatMember sein) ODER `chat.read_all_channels`
- `/{tenant}/chat/:id/info` → Channel-Member oder `chat.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.admin` ODER `chat.admin`
### L.5 — Action-Buttons / Operationen
- Senden / Reagieren / Thread-Reply / Mention: `chat.write` + Membership
- Pinnen / Entfernen-Pin: `chat.admin` global 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.admin` ODER (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 mit `chat.read_own_channels` sehen 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)