Files
2026-07-08 16:15:37 +02:00

7.7 KiB

Designer-Brief · P15 — Telefonie & Team-Chat

Phase: 15/21 · Module: M12 (Telefonie) / M13 (Team-Chat) · Owner-Dev: Akeshan (AK-P15a/b) · Designer: David (D-Chat Paket Mi 01.07., D-Telefonie Paket Mo 06.07.) Quellen: ROADMAP.md §Phase 15 · ENTITY-MODEL.md Domäne 8 (Kommunikation) · SCREEN-MAP.md §4 (Chat-UI) + §6 (AirCall-Setup/Anrufe) · _bmad-output/specs/M12-telefonie.md · _bmad-output/specs/M13-team-chat.md Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Connection). Chat-UI ist Bespoke.

🟡 v1-Grenze (Scope-Schnitt 11.06.): HalloPetra (M105) ist v2 (→ P33) — v1 baut nur den AirCall-Adapter hinter dem TelephonyProviderInterface (Referenz-Implementierung). Whisper-Notiz-Diktat ist v2 (Notiz-Editor = Markdown-Tippen in v1). 🔴 Chat ist Real-Time-Bespoke (AD-9): WebSocket-Messaging mit Presence/Typing/Read-Receipts/Redis-Pub-Sub, drei Channel-Typen (public/private/entity-linked). Mobile-First für Monteure. Admin-DM-Audit nur mit Begründungs-Pflicht + Banner.

Was dieses Modul tut (Kurzfassung)

Telefonie: Click-to-Call und Inbound-Anrufe laufen über den AirCall-Adapter (Apps-Engine-Connection, verschlüsselte OAuth-Tokens). Unbekannte Nummern legen automatisch einen Lead an, Anruf-Events stehen als Automation-Trigger bereit (verpasster Anruf → Rückruf-Aufgabe). Team-Chat: Real-Time-Messaging für public/private/entity-linked Channels mit @Mentions, Threads, Reactions, Pins, File-Uploads, Link-Previews, Read-Receipts und Cross-Channel-Suche. Entity-linked Channels erscheinen im Deal-/Projekt-Detail.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Chat-Index [/chat] Channel-Liste: Name (DM: anderer User), Avatar/Typ-Indikator (Projekt/Gruppe/DM), Snippet (max. 80 Z., Mentions hervorgehoben), Zeitstempel, Unread-Badge, Mention-Marker (separat), Pin-/Mute-Indikator, bei Projekt-Chat Stage · Filter (Typ/ungelesen/Mentions/Projekt-Status/Tag) · Suche · „Archivierte anzeigen" · Channel-Browser (Discover) öffentlicher Groups · „Meine Mentions"-Link · pro Eintrag Pin/Mute/Mark-as-read/Archiv BESPOKE
Channel-Detail [/chat/:id] Header (Name, Typ, Member-Anzahl, Projekt-Link) · Pinned-Sektion (max. 3 inline) · Verlauf mit Date-Bucket-Separatoren, Nachricht = Avatar+Name+Zeit, Markdown-Body, Reactions (Emoji+Count), Thread-Indikator, Mentions, Anhänge inline (Bild-Thumb/Datei-Icon/Link-Preview), Edited-/Lösch-Marker, System-Messages, Read-Receipt „X von Y gelesen" · Composer (Markdown, Emoji, @-Mention-Autocomplete, Datei-Dropzone, Draft-Autosave) · Typing-Indikator · Per-Message-Hover-Menü (Reagieren/Thread/Pin/Mark-as-Task/Permalink/Edit/Löschen) · Channel-Info-Sektion (Members/Pinned/Files/Settings) BESPOKE
Thread-Detail [/chat/:id/thread/:thread_id] Eltern-Nachricht + Replies in Side-Panel oder eigener Route · eigener Composer Bespoke-Teil
Pinned-Übersicht [/chat/:id/pinned] Alle gepinnten Nachrichten (max. 50) je Channel A2
Mentions-Aggregat [/chat/mentions] Alle @-Mentions auf den User kanalübergreifend A2
Cross-Channel-Suche [/chat/search] Volltext-Suche über erlaubte Channels mit Treffer-Kontext A2
Neuer Channel / DM [/chat/new] Modal: Group (Name, Privacy public/private, Member-Wahl) oder DM A5
Channel-Settings Members verwalten, Privacy, Archivieren, verlassen A6
Admin-Chat-Übersicht [/admin/chat] Alle Channels, Cleanup-Tools · DM-Audit mit Begründungs-Pflicht-Banner („Diese DM wird im Audit-Modus angezeigt") · Force-Member-Edit / Force-Delete A2/A3
AirCall-Setup [/settings/integrations/telephony] Connect-Card (Status-Ampel connecting/active/error/revoked + Klartext) · User-Binding-Liste (AirCall-User ↔ HiveGrid-User mit Email-Auto-Match-Vorschlag + manuelle Korrektur) · „Verbindung testen" · Trennen mit Bestätigung A6
Anruf-Liste + -Detail [/calls] Liste: Nummer, Richtung, Dauer, gematchter Kontakt (mit Confidence-Hinweis bei Soft-Match), Notiz-Snippet, verpasst-Marker · Detail: Match-Override, Markdown-Notiz-Editor, Aufnahme-Link · Click-to-Call-Button + eingehender-Anruf-Notification A6 + A2/A3

(HalloPetra-Adapter-UI → v2; Whisper-Diktat entfällt nach AD-26. Click-to-Call-Buttons leben außerdem in Kontakt-/Lead-/Projekt-Detail aus P6/P7/P8.)

Geplante Features (muss abgedeckt sein)

  • AirCall-Connect (OAuth, verschlüsselte Tokens, Webhook-Secret) mit Klartext-Status-Diagnose
  • User-Bindings mit Email-Auto-Match-Vorschlag + manuelle Zuordnung
  • Click-to-Call aus Kontakt-/Lead-/Projekt-Detail; Mehrfach-Nummern → Auswahl-Modal; Klartext-Edge-Cases (kein Binding / keine Connection / API-Fehler / ungültige Nummer); tel:-Fallback ohne Connection
  • Inbound-Anrufe: Auto-Match auf Kontakt/Lead/Deal (Hard/Soft-Match mit Confidence), unbekannte Nummer → Auto-Lead, Push-Notification beim Klingeln
  • Anruf-Logging in Activity-Stream (in/out, verpasst), Markdown-Notiz-Editor nach Anruf, Recording-Anzeige, Match-Override
  • Anruf-Events als Automation-Trigger (verpasster Anruf → Rückruf-Aufgabe — P12)
  • TelephonyProviderInterface mit AirCall als Referenz-Adapter (HalloPetra dockt v2 an)
  • Chat-Real-Time: WebSocket, Presence, Typing, Read-Receipts, Redis-Pub/Sub, Optimistic-UI, Reconnect
  • Drei Channel-Typen: public/private Group, DM, entity-linked (Projekt) mit ProjectMember-Sync
  • @Mentions (User/Projekt/Contact/Firma) mit Autocomplete, Threads, Reactions, Pinned (max 50), File-Uploads (via Files), Link-Previews, Mark-as-Task
  • Channel-Index mit Filter/Suche/Pin/Mute/Archiv + Channel-Browser; Cross-Channel-Suche; Mentions-Aggregat
  • Entity-linked Channel erscheint im Deal-/Projekt-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 Chat-View, Foto-Direct-Upload, Push)
  • Datenmodell persistiert: TelephonyConnection/UserBinding/CallSession/WebhookEvent · TeamChat/Member/Message/Thread/PinnedMessage/Reaction/Read (Domäne 8)

Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Channel-Listen-Einträge (Snippet, Unread-Badge, Mention-Marker, Pin-/Mute-/Typ-Indikator), Filter-Bar, Channel-Browser/Discover, Chat-Verlauf mit Date-Bucket-Separatoren, Nachrichten-Bubble (Avatar+Name+Zeit, Markdown-Renderer, Edited-/Lösch-Marker, System-Message-Stil), Reactions-Leiste (Emoji+Count), Thread-Indikator + Thread-Side-Panel, Mention-Highlight, Inline-Anhang-Renderer (Bild-Thumb/Datei-Icon/Link-Preview), Read-Receipt-Aggregat, Composer mit Markdown/Emoji-Picker/@-Mention-Autocomplete/Datei-Dropzone/Draft-Autosave, Typing-Indikator, Scroll-to-Bottom + New-Messages-Indikator, Per-Message-Hover-/Tap-Menü, Neuer-Channel-/DM-Modal, Channel-Settings-Sektion, Admin-DM-Audit-Banner mit Begründungs-Eingabe, Connection-Card (Status-Ampel + Klartext), User-Binding-Mapping-Liste mit Auto-Match-Vorschlag, Click-to-Call-Button + Nummer-Auswahl-Modal, eingehender-Anruf-Notification, Anruf-Liste (Richtung/Dauer/Match-Confidence), Match-Override-Picker, Markdown-Notiz-Editor, Recording-Player-Link, Mobile-vereinfachte-Chat-Variante 📱, Empty-/Loading-/Permission-Denied-/Offline-States (Klartext).

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev:

Dev-Nachzug (wir nach Davids Delta)

  • Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
  • REQUIREMENTS/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (AK-P15a/b) aktualisiert: