42 lines
2.8 KiB
Markdown
42 lines
2.8 KiB
Markdown
# VEXT-2 · HalloPetra-Spec erheben (API-Vertrag)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Setup (Externals — `typ:external`) |
|
|
| **Owner** | Raffael |
|
|
| **Phase** | Phase 33 (v2-P11) — Telefonie-Erweiterung (Vorlauf) |
|
|
| **Cycle/Fenster** | Backlog/agil (Trigger, Ziel 2026-07-29) |
|
|
| **Status** | geplant · 🟠 **block-2 (Partner-API offen, agil — Spec offen)** |
|
|
|
|
> 🟠 **block-2 — Partner-API offen, agil (Spec offen):** Dies ist der Vorlauf-Task, der den Spec-Gap von HalloPetra schließt. HalloPetra kommt in **keiner Spec** vor — M12 ist eine reine AirCall-Spec. Mechanisch ist HalloPetra ein zweiter Telefonie-Provider hinter dem v1-`TelephonyProviderInterface`, inhaltlich aber unspezifiziert. Agil vorziehbar, sobald der API-Vertrag steht.
|
|
|
|
## Was zu tun
|
|
Den **HalloPetra-API-Vertrag erheben** und auf das vorhandene `TelephonyProviderInterface` mappen. Konkret klären:
|
|
- **Auth** (API-Key / OAuth2 / Webhook-Secret?) → für `connect`
|
|
- **Webhook-Events** (welche Call-Lifecycle-Events: ringing/answered/ended/missed/voicemail?) → für `subscribeToWebhooks`/`parseWebhookEvent`
|
|
- **Recording** (liefert HalloPetra eine Aufnahme-URL? Auth-Modus?) → für `getRecordingUrl`
|
|
- **Call-Lifecycle** (Outbound-Trigger-Endpoint, Status-Übergänge) → für `triggerOutboundCall`
|
|
- **Signaturprüfung** (Webhook-Signatur-Schema) → für `verifyWebhookSignature`
|
|
|
|
Das Ergebnis ist eine kurze Vorlauf-Spec, die VR-P33 baufähig macht. Der AirCall-Adapter (v1-P15) ist die Referenz für Aufbau und Methodensatz.
|
|
|
|
## Warum / blockt
|
|
Ohne den erhobenen API-Vertrag ist der HalloPetra-Adapter (VR-P33) nicht baubar — die Interface-Methoden lassen sich nicht implementieren, solange Auth/Webhook-Events/Recording/Lifecycle offen sind. Schließt einen der beiden in ROADMAP-V2 explizit benannten Specs-Gaps (neben Memberspot/Boobora).
|
|
|
|
## Abhängigkeiten
|
|
- **Blocked by:** — (extern: HalloPetra-Hersteller/Vertrag)
|
|
- **Blocks:** `VR-P33` (HalloPetra-Adapter — braucht den erhobenen Vertrag)
|
|
- **Parallel:** v1-`TelephonyProviderInterface` + AirCall-Adapter (AK-P15a) stehen als Referenz bereit.
|
|
|
|
## Definition of Done
|
|
- [ ] **HalloPetra-API-Vertrag erhoben** (Auth/Webhook-Events/Recording/Call-Lifecycle)
|
|
- [ ] **auf `TelephonyProviderInterface` gemappt** (connect/triggerOutboundCall/subscribeToWebhooks/verifyWebhookSignature/parseWebhookEvent/getRecordingUrl)
|
|
- [ ] Vorlauf-Spec abgelegt, VR-P33 baufähig markiert
|
|
|
|
## Quellen (granular)
|
|
- `ROADMAP-V2.md` → §v2-P11 (Telefonie-Teil) + §Zwei Gaps (HalloPetra M105) + §Offene Vorlauf-Tasks #2
|
|
- `ROADMAP.md` → Phase 33 · `PHASE-SOURCES.md` → Phase 33 (M105, Block-2)
|
|
- `designer-briefs/P33-telefonie-hallopetra.md` (Provider-Interface-Methodensatz, Vorlauf-Hinweis)
|
|
- `_bmad-output/specs/M12-telefonie.md` (AirCall als Referenz, Provider-Pattern)
|
|
- abhängig-für: `ticket-docs/VR-P33.md`
|