Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-P15.md
T

57 lines
4.8 KiB
Markdown

# 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) |
> **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):** `AK-P15a` (Telefonie / AirCall) — 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 = v2 (Notiz-Editor = Markdown-Tippen in v1).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **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 (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-/Deal-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, Whisper-Diktat-Aufnahme → v2.)*
## Features (muss abgedeckt sein)
- [ ] AirCall-Connect (OAuth, Status-Diagnose) als Connection-Card mit Klartext-Status
- [ ] User-Bindings mit Email-Auto-Match-Vorschlag + manuelle Zuordnung + „Verbindung testen"
- [ ] Click-to-Call aus Kontakt-/Lead-/Deal-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, „Verbindung testen", Trennen-Bestätigung); **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 Binding / keine Connection / API-Fehler / ungültige Nummer / `tel:`-Fallback); Empty-/Loading-/Permission-Denied-/Offline-States.
## 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 · `PHASE-SOURCES.md` → P15
- `_bmad-output/specs/M12-telefonie.md`
- 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: