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-P15abaut nach AD-28 bis zu Davids finalem Delta eine Interim-UI aus~/uimit 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 vonD-CHATbedient. - 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-08festgelegten 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-P15adie 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 12ticket-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.