Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,100 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user