83 lines
6.3 KiB
Markdown
83 lines
6.3 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) |
|
|
|
|
> 🎨 **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.
|