Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P28i.md
T

101 lines
5.2 KiB
Markdown

# VA-P28i · Admin GTM Connectors
| | |
|---|---|
| **Plane** | `HIVEGRID-197` · Parent `HIVEGRID-190` |
| **Typ** | Dev (Code + externe Providerverträge) |
| **Owner** | Raffael |
| **Phase** | P28 — Admin Sales Workspace |
| **Cycle/Fenster** | Backlog · nach CRM, E-Mail, Sequenzen und Booking |
| **Status** | geplant |
> **Owner-Änderung 2026-07-24:** Raffael übernimmt die Delivery. Working-ID, Scope, Status,
> Termine, DoD und Abhängigkeiten bleiben unverändert.
>
> **Dependency-Nachzug 2026-07-24:** Auch `VA-P28b` liegt jetzt bei Raffael; CRM-, Mail-,
> Sequenz- und Booking-Verträge sowie `blocked-by`/`blocks` bleiben unverändert.
## Abhängigkeiten & Parallelität
- **Blocked by:** `VA-P28b`, `VA-P28c`, `VA-P28e` und `VA-P28f`.
- **Blocks:** —
- **Extern:** LinkedIn-Zugriff nur mit offiziell freigegebenem API-/Partnervertrag; Meeting-Provider und
Team-Chat brauchen bestätigte App-/Webhook-Verträge. Diese Gates blockieren jeweils nur den Connector.
- **Design:** `VD-P28`, nach AD-28 kein Dev-Blocker.
- **Hardgrenze:** Connectoren lesen/schreiben AdminContact/AdminCompany/AdminDeal; kein Tenant-CRM.
## Was wir bauen
Einen gemeinsamen Admin-Integration-Hub für LinkedIn Sales Navigator, extern erzeugte Meeting-
Zusammenfassungen, Slack/Team-Chat-Ereignisse und segmentierte E-Mail-Marketing-Kampagnen.
## Story-Ownership — 4/117
- `GTM-01` LinkedIn Sales Navigator anbinden.
- `GTM-02` Nach einem Videocall eine automatische Zusammenfassung am Deal ablegen.
- `GTM-03` Wichtige CRM-Ereignisse in Team-Chat/Slack pushen.
- `GTM-04` E-Mail-Kampagnen mit Segmenten und A/B-Tests fahren.
`GTM-05` gehört zu `VA-P28g`.
## Benötigte Screens
| Screen [Admin-Host-Route] | Kern-Inhalt |
|---|---|
| Integrationen [`/sales/settings/integrations`] | Status, Scopes, Reconnect, Disconnect, Fehler |
| LinkedIn im Kontakt | verknüpfen/importieren/synchronisieren innerhalb genehmigter Rechte |
| Meeting-Artefakte im Thread | Anbieter, Call, Zusammenfassung, Quelle und Bestätigung |
| Chat-Regeln | Events, Zielkanal, Minimalpayload, Testzustellung |
| Kampagnen [`/sales/campaigns`] | Segmente, Varianten, Versand, Analytics |
## Definition of Done
- [ ] Jeder Connector verwendet `AdminDataConnection`, minimale Scopes, verschlüsselte Credentials,
CSRF-/State-Gates, Reconnect/Disconnect, signaturgeprüfte/idempotente Webhooks und Klartextfehler.
- [ ] LinkedIn-Funktionalität wird erst nach dokumentierter offizieller API-/Partnerfreigabe konkretisiert
und live gebaut; kein Scraping, Browser-Automation oder Credential-Sharing.
- [ ] Videocall-Zusammenfassungen werden als extern erzeugtes Artefakt über einen getrennt autorisierten
Admin-Connector/Webhook übernommen und im Deal-/Kontakt-Thread abgelegt. HiveGrid betreibt wegen AD-26
keine eigene Transkription oder LLM-Inferenz.
- [ ] Ein künftiger Admin-MCP-Write besitzt einen eigenen Admin-Auth-/Permission-Vertrag und verwendet nicht
den tenantgebundenen MCP-Tokenpfad.
- [ ] Slack/Team-Chat-Regeln verwenden eine Event-Allowlist, senden nur Minimaldaten und verlinken in den
Admin Space; Retry/Dedupe/Rate-Limit und Secret-Redaction sind getestet.
- [ ] Marketing-Segmente arbeiten auf AdminContact/AdminCompany; Kampagnen/Varianten delegieren Versand/
Tracking an `VA-P28c` und Experimente/Limits an `VA-P28e`, ohne dritte Mail-Engine.
- [ ] Legacy `MarketingIntegration`, Marketing-Funnel und Raw-Kampagnenflächen sind migriert oder entfernt;
es bleibt genau ein Admin-Integration-/Campaign-Vertrag.
- [ ] Admin-RBAC, Audit/Activity, i18n, VM-/Action-Layer sowie Unit-/Fixture-/Webhook-/DB-/RLS-/Smoke-/
Hot-Swap-/Visual- und je freigegebenem Provider kontrollierte Live-Proofs sind grün.
**Fortschritt:** **0/8 DoD = 0 % done**. Extern blockierte Provider-Proofs werden je Connector separat ausgewiesen.
## Technische Bausteine
- **Schema:** `prisma/schema/adminGtm.prisma`.
- **Modelle:** `AdminExternalContactLink`, `AdminExternalEventReceipt`, `AdminMeetingArtifact`,
`AdminMeetingSummary`, `AdminChatDestination`, `AdminChatNotificationRule`, `AdminMarketingSegment`,
`AdminCampaign`, `AdminCampaignVariant`, `AdminCampaignRun`.
- **Connection Registry:** providerneutrale Capability-/Scope-Registry auf `AdminDataConnection`.
- **Wiederverwendung:** Slack-/Marketing-Adapter und Segment-/Experiment-Helfer als Libraries; keine
tenantgebundenen Connection-/Campaign-Zeilen.
## Slices und Rollback
Integration Registry → Slack/Chat → LinkedIn → Meeting Artifacts → Segments/Campaigns.
Jeder Connector ist separat aktivierbar. Disconnect widerruft Credentials und stoppt neue Events, behält
auditierte Verknüpfungen/Artefakte gemäß Retention und erlaubt sicheren Reconnect.
## Quellen
- `.planning/ticket-docs/VA-P28b.md`, `VA-P28c.md`, `VA-P28e.md`, `VA-P28f.md`, `VD-P28.md`
- `docs/ARCHITECTURE-DECISIONS.md` — AD-26, AD-28
- AGENTS.md — EU-Stack, Secret- und Connector-Verträge
## Dev-Nachzug
- [ ] LinkedIn-API-/Partnerzugang als externes Gate dokumentieren.
- [ ] Meeting-Provider/Artefaktvertrag und Team-Chat-Ziele in der Block-Review bestätigen.
- [ ] Legacy-Migration dependency-aware in `AK-UI-18`/`AK-UI-19` dokumentieren.
- [ ] Davids `VD-P28`-Delta integrieren und Visual-Baselines erneuern.