Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
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)