5.0 KiB
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.prismanur 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_dataauf 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-featuresROADMAP.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-P15baktualisiert