101 lines
5.2 KiB
Markdown
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.
|