Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,41 @@
|
||||
# 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`
|
||||
Reference in new issue
Block a user