Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P15b.md
T

5.0 KiB

AK-P15b · P15 Team-Chat (Realtime)

Typ Dev (Code)
Owner Akeshan
Phase P15 — Telefonie & Team-Chat
Cycle/Fenster W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-07-02 · Gate W3 (Demo 2)
Status geplant

Abhängigkeiten & Parallelität

  • Blocked by: AK-P15a (P15-Vorlauf), AK-P4a (Files — Chat-Anhänge via FileEntityLink)
  • Blocks: Demo 2 (Noah-Demo #2, Gate W3)
  • Läuft parallel zu: Raffaels Kern-Kette. Eigene prisma/schema/chat.prisma (AD-21); entity-linked Channels referenzieren Projekt/Deal aus dem CRM-Kern (R-P6/P8) read-only. Sync-Punkt: ProjektMitglied-Sync braucht den Projekt-Kern (P8/P9).
  • Konflikt-Risiko: keines auf Schema-Ebene; crm.prisma/files.prisma nur lesend.

Was wir bauen

Den Real-Time-Team-Chat (Bespoke, AD-9): WebSocket-Messaging mit Presence, Typing-Indicator, Read-Receipts über Redis-Pub/Sub (Scale-Out), drei Channel-Typen (public/private Group, DM, entity-linked Projekt/Deal mit ProjektMitglied-Sync), @Mentions (User/Projekt/Deal/Kontakt/Firma) mit Autocomplete, Threads, Reactions, Pins (max 50), File-Uploads (via Files), Link-Previews, Mark-as-Task und Cross-Channel-Suche. Mobile-First für Monteure (vereinfachte View, Foto-Direct-Upload, Push). Ein Admin-Audit-Modus (read_all_channels) erfordert Begründungs-Pflicht je Session + DM-Audit-Banner und wird audit-geloggt.

Benötigte Screens (Backend bedient — Design liefert D-CHAT + D-P15)

Screen [Route] Kern-Inhalt
Chat-Index [/chat] Channel-Liste (Snippet, Unread-Badge, Mention-Marker, Pin/Mute/Typ-Indikator, bei Projekt-Chat Stage), Filter, Suche, Channel-Browser (Discover), „Archivierte anzeigen" — BESPOKE
Channel-Detail [/chat/:id] Verlauf mit Date-Bucket-Separatoren, Nachricht (Markdown/Reactions/Thread-Indikator/Mentions/Anhänge), Read-Receipt, Composer (@-Autocomplete/Datei-Dropzone/Draft-Autosave), Typing-Indikator, Per-Message-Hover-Menü — BESPOKE
Thread-Detail [/chat/:id/thread/:thread_id] Eltern-Nachricht + Replies (Side-Panel oder Route), eigener Composer
Pinned-Übersicht [/chat/:id/pinned] · Mentions-Aggregat [/chat/mentions] · Cross-Channel-Suche [/chat/search] Pins (max 50), kanalübergreifende Mentions, Volltext-Suche über erlaubte Channels
Neuer Channel / DM [/chat/new] · Channel-Settings Group/DM-Modal; Members/Privacy/Archivieren/verlassen
Admin-Chat-Übersicht [/admin/chat] Alle Channels + Cleanup; DM-Audit mit Begründungs-Pflicht-Banner; Force-Member-Edit/Delete

Definition of Done

  • WebSocket-Real-Time: Presence, Typing, Read-Receipts, Redis-Pub/Sub (AD-9), Optimistic-UI, Reconnect
  • 3 Channel-Typen: public/private Group, DM, entity-linked (Projekt/Deal) mit ProjektMitglied-Sync
  • @Mentions mit Autocomplete + Threads + Reactions + Pins (max 50) + File-Uploads (Files) + Link-Previews + Mark-as-Task
  • Channel-Index (Filter/Suche/Pin/Mute/Archiv + Channel-Browser) + Cross-Channel-Suche + Mentions-Aggregat
  • Entity-linked Channel erscheint im Projekt-/Deal-Detail (P8/P9)
  • Admin-Audit (read_all_channels): Begründungs-Pflicht je Session + DM-Audit-Banner, audit-geloggt
  • Mobile-First-Variante für Monteure (vereinfachte View, Foto-Direct-Upload, Push)
  • Konnektor tenantHasModule('chat'); RLS auf allen Tenant-Tabellen

Technische Bausteine

  • Entities (eigene prisma/schema/chat.prisma): TeamChat (kind project/group/dm, projekt_id, archived_reason, last_message_at), TeamChatMember (role_in_chat, last_read_message_id, is_pinned), TeamChatMessage (author, body Markdown, parent_message_id, mentions[], attachments[]), TeamChatThread/PinnedMessage/Reaction/Read. crm.prisma (Projekt für entity-linked), files.prisma (Anhänge via FileEntityLink) nur lesend (AD-21).
  • Real-Time-Layer: WebSocket-Gateway + Redis-Pub/Sub für Presence/Typing/Fan-out (AD-9); Read-Receipt-Aggregation „X von Y gelesen".
  • RLS auf allen Tabellen; Channel-Permission je Typ; Admin-Audit-Read gegated + audit-geloggt (AuditEntry).
  • Mark-as-Task schreibt in das Tasks-Modul (AK-P4b, EntityLink).
  • Konnektor tenantHasModule('chat'); is_demo_data auf Demo-Channels/-Messages.

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 8: Kommunikation (TeamChat/Member/Message/Thread/PinnedMessage/Reaction/Read)
  • REQUIREMENTS.md → REQ-chat-datenmodell, REQ-chat-realtime, REQ-chat-features
  • ROADMAP.md → Phase 15 · PHASE-SOURCES.md → Phase 15 (M110-channel-permissions, M111-direkt-nachrichten, M112-anhaenge, M113-modul-verknuepfungen, M114-mentions-push — Chat bleibt VOLL)
  • designer-briefs/P15-telefonie-chat.md (Chat-UI BESPOKE, Admin-DM-Audit, Mobile-First)
  • _bmad-output/specs/M13-team-chat.md

Dev-Nachzug (nach Davids D-CHAT/D-P15-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket AK-P15b aktualisiert