Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
+14
-7
@@ -1,10 +1,14 @@
|
||||
# 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)
|
||||
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.md`.
|
||||
**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.
|
||||
> ✅ **VEXT-2 geschlossen (01.08.2026):** HalloPetra wird per API-Key verbunden; ein manueller
|
||||
> `post_call`-Webhook liefert abgeschlossene Inbound-Anrufe. Es gibt im erhobenen Vertrag keinen belegten
|
||||
> Outbound-Trigger, keine Provider-User-Ressource und keine garantierte Recording-URL. AirCall bleibt daher
|
||||
> der Cold-Calling-Provider; HalloPetra nutzt Click-to-Call als `tel:`-Fallback. Voicemail-Transkription
|
||||
> entfällt nach AD-26.
|
||||
|
||||
## Was dieses Modul tut (Kurzfassung)
|
||||
|
||||
@@ -14,9 +18,9 @@ Bindet HalloPetra als zusätzlichen Provider hinter dem bestehenden `TelephonyPr
|
||||
|
||||
| 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 |
|
||||
| Telefonie-Setup [`/:tenant/settings/integrations/telephony`] | Provider-Connect (HalloPetra API-Key neben AirCall OAuth), Verbindungs-Test, einmalige HalloPetra-Webhook-Konfiguration | A6 + Connect |
|
||||
| User-Bindings [im Telefonie-Setup] | AirCall-User ↔ Telefonie-Nummer/-Account; für HalloPetra mangels Provider-User-Ressource ausgeblendet | A2/A6 |
|
||||
| Call-Session-Detail [`/:tenant/calls/:id`] | Anruf-Daten (Richtung, Dauer, Provider, Match auf Contact/Lead/Projekt, Match-Confidence), optionaler 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.)*
|
||||
|
||||
@@ -31,7 +35,10 @@ Bindet HalloPetra als zusätzlichen Provider hinter dem bestehenden `TelephonyPr
|
||||
|
||||
## 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).
|
||||
Provider-Auswahl/-Connect-Karte (HalloPetra inbound/AirCall Cold Calling), maskierte API-Key-/OAuth-Eingabe,
|
||||
Verbindungs-Test mit Status, einmalig sichtbare Webhook-URL + `Authorization`-Header, AirCall-Binding-Liste,
|
||||
Call-Session-Detail (Richtung/Dauer/Status/Provider), Match-Anzeige mit Confidence-Indikator, optionaler
|
||||
Aufnahme-Link, Notiz-Editor, Click-to-Call-Quick-Action und Klartext-States.
|
||||
|
||||
## Davids Delta (David füllt aus)
|
||||
|
||||
@@ -43,5 +50,5 @@ Provider-Auswahl/-Connect-Karte (HalloPetra/AirCall), Credential-/OAuth-Eingabe
|
||||
## Dev-Nachzug (wir nach Davids Delta)
|
||||
|
||||
- [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen:
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen:
|
||||
- [ ] Plane-Ticket (VR-P33) aktualisiert:
|
||||
Reference in new issue
Block a user