# Designer-Brief · P33 — Telefonie-Erweiterung (HalloPetra) **Phase:** 33/34 · **Modul:** M105 · **Owner-Dev:** Raffael (VR-P33) · **Designer:** David (D-Telefonie-Erw.) **Quellen:** `ROADMAP-V2.md` §v2-P11 (NUR Telefonie-Teil) · `ROADMAP.md` §Phase 33 · `_bmad-output/specs/M12-telefonie.md` (Provider-Pattern) **Subframe:** Pflicht je Route. Setup-/Binding-Flächen + Call-Session-Detail. > 🔴 **Block 2, Spec offen (⚠ Vorlauf VEXT-2):** HalloPetra kommt in **keiner Spec** vor — M12 ist eine reine AirCall-Spec. HalloPetra ist ein **zweiter Telefonie-Provider hinter dem vorhandenen `TelephonyProviderInterface`** (connect/triggerOutboundCall/subscribeToWebhooks/verifyWebhookSignature/parseWebhookEvent/getRecordingUrl) — mechanisch klar, inhaltlich unspezifiziert. **Vor Bau:** eigene Vorlauf-Spec (API-Vertrag: Auth/Webhook-Events/Recording/Call-Lifecycle) erheben. Agil vorziehbar, sobald spezifiziert. Voicemail-Transkription via Whisper entfällt nach AD-26. Der AirCall-Adapter (v1-P15) ist die Referenz. ## Was dieses Modul tut (Kurzfassung) Bindet HalloPetra als zusätzlichen Provider hinter dem bestehenden `TelephonyProviderInterface` an — ohne Kern-Umbau. Eingehende Webhooks werden auto-gematcht (auf Contact/Lead/Projekt), landen im Activity-Stream und triggern Automationen (`call.*`). Click-to-Call, Inbound und Logging bleiben providerunabhängig: E.164-Normalisierung, Match-Confidence, Notiz-Editor. Aus Tenant-Sicht ist HalloPetra einfach eine weitere wählbare Telefonie-Anbindung neben AirCall. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | Telefonie-Setup [`/settings/telephony`] | Provider-Connect (HalloPetra neben AirCall), Credential-/OAuth-Eingabe, Verbindungs-Test | A6 + Connect | | User-Bindings [`/settings/telephony/bindings`] | Zuordnung User ↔ Telefonie-Nummer/-Account, providerunabhängig | A2/A6 | | Call-Session-Detail [`/calls/:id`] | Anruf-Daten (Richtung, Dauer, Match auf Contact/Lead/Projekt, Match-Confidence), Aufnahme-Link, Notiz-Editor | A3 | *(Click-to-Call ist ein Quick-Action-Element auf Contact/Lead/Projekt-Detail-Views aus v1 — providerunabhängig, kein neuer Screen.)* ## Geplante Features (muss abgedeckt sein) - [ ] HalloPetra-Adapter implementiert `TelephonyProviderInterface` ohne Kern-Änderung - [ ] Webhook-Auto-Match auf Contact/Lead/Projekt → Activity + Automation-Trigger (`call.*`) - [ ] Click-to-Call + Inbound + Logging providerunabhängig (E.164-Normalisierung, Match-Confidence, Notiz-Editor) - [ ] Provider-Auswahl/-Wechsel im Setup (HalloPetra neben AirCall) - [ ] Recording-Abruf über `getRecordingUrl` (sofern HalloPetra-API liefert) - [ ] ⚠ Vorlauf-Spec (API-Vertrag) vor Bau erheben ## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Provider-Auswahl/-Connect-Karte (HalloPetra/AirCall), Credential-/OAuth-Eingabe (maskiert), Verbindungs-Test-Button mit Status, User↔Nummer-Binding-Liste, Call-Session-Detail (Richtung/Dauer/Status), Match-Anzeige mit Confidence-Indikator, Aufnahme-Player/-Link, Notiz-Editor, Click-to-Call-Quick-Action, Empty-/Loading-/Permission-Denied-States (Klartext). ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: ## Dev-Nachzug (wir nach Davids Delta) - [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst: - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen: - [ ] Plane-Ticket (VR-P33) aktualisiert: