# D-P15 · Screens P15 — Telefonie (ohne Chat-UI) | | | |---|---| | **Typ** | Screen (Design) | | **Owner** | David | | **Phase** | P15 — Telefonie & Team-Chat (bedient `AK-P15a`) | | **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → 2026-07-02 · Gate W3 | | **Status** | geplant (NEU — schließt P15-Telefonie-Screen-Lücke außerhalb der Chat-UI) | > 🎨 **design-nachzug: offen** · `AK-P15a` baut nach AD-28 bis zu Davids finalem Delta eine Interim-UI aus > `~/ui` mit VM als Prop. Dieses Screen-Ticket ist daher kein harter Dev-Blocker. > **Ergänzt das Bespoke-Ticket `D-CHAT`** (Real-Time-Chat-UI: Chat-Index, Channel-/Thread-Detail, Pinned/Mentions/Suche, Admin-Chat-Übersicht). **Dieses Ticket deckt den Telefonie-Teil von P15**: AirCall-Setup (Telefonie-Panel), Call-Log (Anruf-Liste), Click-to-Call und Anruf-Detail. Die Team-Chat-Screens sind **NICHT** Teil von D-P15 (→ D-CHAT). ## Abhängigkeiten & Parallelität - **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A5 Modal, A6 Connection), `D-P5` (Connection-Card-Stil für AirCall-Setup) - **Bedient (Dev):** finales Design für `AK-P15a` (Telefonie / AirCall); nach AD-28 kein Blocker für dessen Interim-UI. Der Team-Chat-Teil (`AK-P15b`) wird von `D-CHAT` bedient. - **Parallel/Geschwister:** `D-CHAT` (BESPOKE Chat-UI) — D-P15 liefert den Telefonie-Teil - **Subframe:** Pflicht je Route (A6 Connection für Setup, A2/A3 für Call-Log/Detail, A5 Modal für Nummer-Auswahl) ## Was wir bauen Die **Telefonie-Flächen von P15**: das AirCall-Setup (Connect-Card + User-Binding-Liste), die Anruf-Liste mit gematchtem Kontakt, Click-to-Call (inkl. Nummer-Auswahl-Modal + eingehender-Anruf-Notification) und das Anruf-Detail mit Match-Override + Markdown-Notiz. > 🟡 **v1-Grenze:** **HalloPetra (M105) ist v2** (→ P33) — v1 baut nur den AirCall-Adapter hinter dem `TelephonyProviderInterface`. Whisper-Notiz-Diktat entfällt nach AD-26 (Notiz-Editor = Markdown-Tippen in v1). ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | **AirCall-Setup** [`/settings/integrations/telephony`] | Technology-Partner-OAuth-Connect · klarer Vorabhinweis „Du musst HiveGrid-Tenant-Admin und Aircall-Company-Admin sein" · Connect-Card (connecting/active/error/revoked + Klartext) · **User-Binding-Liste** (AirCall-User ↔ HiveGrid-User mit Email-Auto-Match-Vorschlag + manuelle Korrektur) · „Verbindung testen" · Trennen/Reinstall mit Bestätigung; **keine** API-Key-, Refresh-Token- oder Ablaufzeit-Eingabe | A6 (Connection) | | 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 | **Eingebettet (kein eigener Screen, aber zu designen):** Click-to-Call-Buttons leben außerdem in Kontakt-/Lead-/Projekt-Detail (aus D-CRM/D-P7/D-P8) — Mehrfach-Nummern → Auswahl-Modal; `tel:`-Fallback ohne Connection. *(Chat-Index/Channel-/Thread-Detail/Pinned/Mentions/Suche/Neuer-Channel/Channel-Settings/Admin-Chat-Übersicht = **D-CHAT**. HalloPetra-Adapter-UI → v2; Whisper-Diktat entfällt nach AD-26.)* ## Features (muss abgedeckt sein) - [ ] AirCall-Connect als Technology-Partner-OAuth-Flow mit Company-Admin-Voraussetzung und Klartext-Status; permanenter Token wird nie angezeigt, kein Basic-Auth-/Refresh-Token-Formular - [ ] User-Bindings mit Email-Auto-Match-Vorschlag + manuelle Zuordnung + „Verbindung testen" - [ ] 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 - [ ] Inbound-Anruf-Notification beim Klingeln; Auto-Match-Anzeige (Hard/Soft mit Confidence), unbekannte Nummer → Auto-Lead-Hinweis - [ ] Anruf-Liste + -Detail (Richtung/Dauer/verpasst), Markdown-Notiz-Editor nach Anruf, Recording-Player-Link, Match-Override - [ ] Empty/Loading/Permission-Denied/Offline-States (Klartext) ## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Connection-Card (Status-Ampel connecting/active/error/revoked + Klartext, Company-Admin-Voraussetzung, „Verbindung testen", Reinstall/Trennen-Bestätigung, keine Credential-Eingabe); **User-Binding-Mapping-Liste** mit Auto-Match-Vorschlag + manueller Korrektur; **Click-to-Call-Button** + Nummer-Auswahl-Modal (Mehrfach-Nummern); eingehender-Anruf-Notification; Anruf-Liste (Nummer/Richtung/Dauer/Match-Confidence/verpasst-Marker/ Notiz-Snippet); **Match-Override-Picker**; Markdown-Notiz-Editor; Recording-Player-Link; Klartext-Edge-Case-Hinweise (kein Aircall-Company-Admin / keine Nummer ausgewählt / kein Binding / keine Connection / API-Fehler / ungültige Nummer / `tel:`-Fallback); Empty-/Loading-/Permission-Denied-/Offline-States. ## Contract- und Dependency-Nachzug (2026-07-15) - Der Connect-Screen bildet den in `AK-P15a`/`EXT-08` festgelegten Technology-Partner-OAuth-Vertrag ab. - Der Aircall-Admin wählt während der Installation die Aircall-Nummern aus, deren Events HiveGrid erhält; der Status-/Empty-State muss „keine Nummer ausgewählt" verständlich erklären. - Der permanente Access Token und der Webhook-Token sind reine Server-Credentials und dürfen in der UI weder angezeigt noch editierbar sein. - Bis Davids Delta vorliegt, ist die Interim-Baseline aus `AK-P15a` die gültige Visual-Regression-Baseline; beim Design-Nachzug wird sie bewusst re-baselined. ## Quellen (granular) - `designer-briefs/P15-telefonie-chat.md` (Telefonie-Teil; Chat-Teil → D-CHAT) - `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TelephonyConnection/UserBinding/CallSession/WebhookEvent) - `ROADMAP.md` → Phase 15 · `REQUIREMENTS.md` → Modul 12 - `ticket-docs/EXT-08.md` (Technology-Partner-OAuth, Live-Voraussetzungen und registrierte URLs) - Geschwister-Ticket (Chat): `D-CHAT` · Dev-Pendant: `ticket-docs/AK-P15a.md` ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: ## Umsetzungs-Notiz - **2026-07-15 · 0/6 Feature-DoD = 0 % done:** Aircall-Connect-Fläche an den verifizierten Technology-Partner-OAuth-Vertrag und AD-28 angepasst. Kein Screen-/Delta-Punkt als umgesetzt markiert.