5.2 KiB
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-P28bliegt jetzt bei Raffael; CRM-, Mail-, Sequenz- und Booking-Verträge sowieblocked-by/blocksbleiben unverändert.
Abhängigkeiten & Parallelität
- Blocked by:
VA-P28b,VA-P28c,VA-P28eundVA-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-01LinkedIn Sales Navigator anbinden.GTM-02Nach einem Videocall eine automatische Zusammenfassung am Deal ablegen.GTM-03Wichtige CRM-Ereignisse in Team-Chat/Slack pushen.GTM-04E-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-P28cund Experimente/Limits anVA-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.mddocs/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-19dokumentieren. - Davids
VD-P28-Delta integrieren und Visual-Baselines erneuern.