7.6 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.)
Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.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)
TelephonyProviderInterfacemit 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/ROADMAP nachgezogen:
- Plane-Ticket (AK-P15a/b) aktualisiert: