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

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