Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P33-telefonie-hallopetra.md
T
2026-07-08 16:15:37 +02:00

3.5 KiB

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: