Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-P15.md
T

6.3 KiB

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.