# 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.