Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -1,6 +1,6 @@
|
||||
# VR-P33 · Telefonie-Erweiterung HalloPetra (M105)
|
||||
|
||||
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **Whisper-Voicemail-Transkriptions-Andock entfällt** (kein Whisper/LLM mehr — VR-P25 zurückgestellt, HiveGrid wird MCP-Server, [[VR-MCP]]). Der restliche Telefonie-Teil (HalloPetra-Provider hinter `TelephonyProviderInterface`) ist unberührt. Whisper-Stellen unten durchgestrichen.
|
||||
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **Whisper-Voicemail-Transkriptions-Andock entfällt** (kein Whisper/LLM mehr — alter VR-P25-Scope zurückgestellt, HiveGrid wird MCP-Server, [[VR-MCP]]). Der restliche Telefonie-Teil (HalloPetra-Provider hinter `TelephonyProviderInterface`) ist unberührt. Whisper-Stellen unten durchgestrichen.
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
@@ -19,20 +19,20 @@
|
||||
- **Konflikt-Risiko:** keines auf Schema-Ebene.
|
||||
|
||||
## Was wir bauen
|
||||
Bindet **HalloPetra als zusätzlichen Provider** hinter dem bestehenden `TelephonyProviderInterface` an — **ohne Kern-Umbau** (zweiter Adapter neben AirCall). Eingehende Webhooks werden auto-gematcht (auf Contact/Lead/Deal), 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.
|
||||
Bindet **HalloPetra als zusätzlichen Provider** hinter dem bestehenden `TelephonyProviderInterface` an — **ohne Kern-Umbau** (zweiter Adapter neben AirCall). 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 (Backend bedient — Design liefert `D-P33`/`D-Telefonie-Erw.`)
|
||||
| Screen [Route] | Kern-Inhalt |
|
||||
|---|---|
|
||||
| Telefonie-Setup [`/settings/telephony`] | Provider-Connect (HalloPetra **neben** AirCall), Credential-/OAuth-Eingabe (maskiert), Verbindungs-Test |
|
||||
| User-Bindings [`/settings/telephony/bindings`] | Zuordnung User ↔ Telefonie-Nummer/-Account, providerunabhängig |
|
||||
| Call-Session-Detail [`/calls/:id`] | Anruf-Daten (Richtung/Dauer/Match auf Contact/Lead/Deal + Match-Confidence), Aufnahme-Link, Notiz-Editor |
|
||||
| Call-Session-Detail [`/calls/:id`] | Anruf-Daten (Richtung/Dauer/Match auf Contact/Lead/Projekt + Match-Confidence), Aufnahme-Link, Notiz-Editor |
|
||||
|
||||
*(Click-to-Call ist ein Quick-Action-Element auf Contact/Lead/Deal-Detail aus v1 — providerunabhängig, kein neuer Screen.)*
|
||||
*(Click-to-Call ist ein Quick-Action-Element auf Contact/Lead/Projekt-Detail aus v1 — providerunabhängig, kein neuer Screen.)*
|
||||
|
||||
## Definition of Done
|
||||
- [ ] **HalloPetra-Adapter** implementiert `TelephonyProviderInterface` (`connect`/`triggerOutboundCall`/`subscribeToWebhooks`/`verifyWebhookSignature`/`parseWebhookEvent`/`getRecordingUrl`) **ohne Kern-Umbau**
|
||||
- [ ] **Webhook-Auto-Match** auf Contact/Lead/Deal → Activity + Automation-Trigger (`call.*`)
|
||||
- [ ] **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)
|
||||
@@ -41,9 +41,9 @@ Bindet **HalloPetra als zusätzlichen Provider** hinter dem bestehenden `Telepho
|
||||
## Technische Bausteine
|
||||
- **Entities** (v1-Telefonie-Domäne, AD-21 — kein neues Schema nötig): `TelephonyConnection` (v1: `provider` (aircall → **+hallopetra**), `oauth_token` (verschlüsselt), `webhook_secret`, max. 1 aktiv/Tenant, [RLS]), `TelephonyCallSession` (v1: `direction`, `status`, `from`/`to_number` (E.164), `matched_kontakt`/`lead`/`projekt_id`, `note`, `recording_url`, [RLS][Soft-Delete][polymorph match]), `TelephonyWebhookEvent` (v1: `event_type`, `signature_valid`, `processing_status`, [append-only][30d]).
|
||||
- **Provider-Pattern:** HalloPetra = neuer Adapter hinter dem v1-`TelephonyProviderInterface`; **kein Kern-Umbau** — nur Adapter-Implementierung + `provider`-Enum-Erweiterung.
|
||||
- **Auto-Match:** Webhook → E.164-Normalisierung → Match auf Contact/Lead/Deal (Match-Confidence) → Activity-Stream + Automation-Trigger (`call.*`).
|
||||
- **Auto-Match:** Webhook → E.164-Normalisierung → Match auf Contact/Lead/Projekt (Match-Confidence) → Activity-Stream + Automation-Trigger (`call.*`).
|
||||
- **Konnektor:** `tenantHasModule('telephony')`; Provider-Auswahl im Setup.
|
||||
- ~~**Whisper-Kopplung:** Voicemail-Transkription via VR-P25 (Whisper-EU), optional/später.~~ → **entfällt ([[AD-26]]: kein Whisper/LLM; VR-P25 zurückgestellt).**
|
||||
- ~~**Whisper-Kopplung:** Voicemail-Transkription via altem VR-P25-Scope (Whisper-EU), optional/später.~~ → **entfällt ([[AD-26]]: kein Whisper/LLM; alter VR-P25-Scope zurückgestellt).**
|
||||
- **`is_demo_data`:** Demo-Call-Sessions seedbar.
|
||||
|
||||
## Quellen (granular)
|
||||
|
||||
Reference in new issue
Block a user