Social-Strategie-Modul (Variante B)
| Status | Umgesetzt (0.1.367–0.1.371) — Spec & Architektur-Referenz; Bedienung: Social-Strategie |
| Entscheidung | Variante B: eigenes Objekt + UI, getrennt von Brand DNA |
| Wer | Redaktion, Center-Marketing, KAM, Agenten (MCP/AgencyOS) |
| Warum | Brand DNA beschreibt Markenidentität (Ton, Tabus, Stil). Social braucht zusätzlich Betriebsregeln: wie oft, welche Themen, welches Format — und ob der Plan eingehalten wird. |
Abgrenzung
| Bereich | Brand DNA (heute) | Social-Strategie (neu) |
|---|---|---|
| Tonalität, Zielgruppe, Tabus | ja | nein (Verweis auf DNA) |
| Beispiel-Post / Visual-Hints | ja | nein |
| Posts pro Woche (Soll) | nein | ja |
| Content-Säulen / Themen-Mix | nein | ja |
| Format-Mix (Feed/Reel/…) | nein | ja |
| Kanal-Ziele (IG vs FB) | nein | ja (optional) |
| Ist-vs-Soll / Lücken | nein | ja |
| Beste Posting-Zeiten (Hinweis) | nein | ja (weich, kein Auto-Schedule) |
Brand DNA und Social-Strategie werden gemeinsam in KI-Prompts und Agent-Kontext geladen, bleiben aber getrennt speicherbar und pflegbar.
Datenmodell
Speicher
- Tabelle:
ShoppingCenter - Neue Spalte:
social_strategy(JSONB, nullable) — analogbrand_dna - Migration: additiv, kein Datenverlust (
*_SAFE.sql+db_structure.md)
TypeScript (social-strategy.ts)
export type SocialStrategyContentPillar = {
/** Stabile ID (UUID oder slug), für Zuordnung an Posts */
id: string;
label: string;
description?: string;
/** Soll-Anzahl Posts pro Planungsperiode (typisch Woche) */
targetCount?: number;
/** Alternative zu targetCount: Gewichtung 1–10 für proportionale Verteilung */
weight?: number;
/** Stichworte für KI-Zuordnung / Suche */
keywords?: string;
/** Welche Cockpit-Quellen typischerweise diese Säule füllen */
linkedSources?: Array<
'news' | 'event' | 'offer' | 'shop' | 'review' | 'employer' | 'community' | 'other'
>;
};
export type SocialStrategyFormatTarget = {
postType: 'feed' | 'carousel' | 'story' | 'reel';
targetCount?: number;
weight?: number;
};
export type SocialStrategyChannelTarget = {
/** Outstand-Netzwerk-ID, z. B. instagram, facebook */
network: string;
minPosts?: number;
maxPosts?: number;
};
export type SocialStrategyPostingHint = {
/** 0 = Montag … 6 = Sonntag (ISO-Woche) */
weekday: number;
/** HH:MM, Europe/Berlin */
time: string;
};
export type SocialStrategy = {
/** Strategie aktiv — wenn false, keine Ist/Soll-Warnungen */
enabled?: boolean;
/** Planungsperiode für Soll-Werte */
planningPeriod?: 'week' | 'month';
/** Gesamt-Soll Posts pro Periode (über alle Kanäle) */
postsPerPeriod?: number;
contentPillars?: SocialStrategyContentPillar[];
formatMix?: SocialStrategyFormatTarget[];
channelTargets?: SocialStrategyChannelTarget[];
preferredPostingTimes?: SocialStrategyPostingHint[];
/** Freitext: saisonale Regeln, No-Go-Tage, Abstimmungen */
notes?: string;
};
Erweiterung Social-Post (Phase 2)
Optional am Entwurf:
pillarId?: string— manuelle oder auto gesetzte Säule- Bestehendes
campaignLabelbleibt; Mapping-Regeln vonlinkedSources→ Säule ergänzen automatische Vorschläge
Ist-vs-Soll-Logik
Zähler-Regeln
Posts zählen für die laufende Planungsperiode, wenn:
- Status: geplant (
scheduledAtin Periode) oder live (publishedAtin Periode) - Center:
centerIdbzw. Multi-Center-Post enthält Center - Optional Filter: nur Posts mit Freigabe-Workflow ab „zur Freigabe“ (konfigurierbar, Default: scheduled + live + review)
Nicht zählen: Entwürfe ohne Termin, abgelehnte, reine Kanal-Posts ohne Cockpit-Entwurf.
Auswertung (evaluateSocialStrategy)
Liefert u. a.:
{
period: { from, to, label: 'KW 39' },
totals: { target: 5, actual: 3, gap: 2 },
byFormat: [{ postType: 'reel', target: 2, actual: 0, gap: 2 }, …],
byPillar: [{ pillarId, label, target: 2, actual: 1, gap: 1 }, …],
byChannel: [{ network: 'instagram', min: 3, actual: 2, gap: 1 }, …],
hints: ['Reels: 2 fehlen', 'Säule „Shops & Mieter“: 1 fehlt'],
completeness: { scorePercent, missingFields: ['contentPillars'] }
}
UI-Darstellung
- Ampel: grün = Plan erfüllt, gelb = Lücke ≤ 1 oder Periode > 50 % vergangen, rot = deutliche Lücke
- Kein Hard-Block beim Speichern/Freigeben — nur Hinweise (wie Pre-Flight QA)
UI / Navigation
Hauptseite (neu)
| Pfad | /dashboard/social/strategy |
| Modul | Social Cockpit (social-cockpit) |
| Center-Bezug | Center-Switcher (wie Social-Kalender) |
Abschnitte auf der Seite:
- Übersicht (Ist vs. Soll) — aktuelle Woche/Monat, KPI-Zeile, Lückenliste
- Frequenz —
postsPerPeriod,planningPeriod - Content-Säulen — Liste editierbar (Label, Soll, Keywords, Quellen)
- Format-Mix — Feed / Karussell / Story / Reel mit Soll-Zahlen
- Kanäle (optional) — Min/Max pro Netzwerk
- Posting-Hinweise — Wochentag + Uhrzeit (Empfehlung für Redaktion)
- Notizen — Freitext
Querverweise:
- Von Brand DNA: Link „Social-Strategie bearbeiten“
- Von Social-Kalender / Content-Planner: KPI-Zeile „Plan: 3/5“ mit Link zur Strategie
Kalender-Integration
Bestehende Post-Mix-Anzeige im Social-Kalender (SocialCalendarStatsPanel) um Soll-Spalte erweitern:
- Ist: Feed 2, Reel 0
- Soll: Feed 2, Reel 2 → Warn-Badge „Reel −2“
Content-Planner: gleiche kompakte KPI-Zeile für Social-Chip.
API & Agenten (MCP-Parität)
| Kanal | Vertrag |
|---|---|
| Dashboard | GET/PATCH /api/centers/{centerId}/social-strategy |
| AgencyOS | GET/PUT /api/agencyos/v1/centers/{centerId} — Feld socialStrategy (Partial) |
| Status | GET /api/centers/{centerId}/social-strategy/status |
| Vorschläge | GET /api/centers/{centerId}/social-strategy/suggest |
| Leistungskatalog | GET /api/centers/{centerId}/social-strategy/leistung — Kanarien-Vertrag + Strategie + Playbook |
| CRM-Sync | POST /api/centers/{centerId}/social-strategy/sync-from-crm |
| Kontext | GET …/centers/{id}/context — center.socialStrategy + kompaktes strategyStatus |
| MCP cockpitOS | cockpit_get_center_social_leistung, cockpit_social_strategy_sync_from_crm, cockpit_social_strategy_status, cockpit_social_strategy_suggest, cockpit_update_center (socialStrategy) |
| MCP Kanarien | get_center_social_contract, list_social_leistung_centers, update_center_social_leistung, link_cockpit_center |
| MCP (QA) | cockpit_social_draft_quality_check — Strategy-Warnungen |
Dateien (Implementierung):
apps/dashboard/src/lib/social-strategy.ts— Parse/Merge/Evaluateapps/dashboard/src/lib/social-strategy-service.tsapps/dashboard/src/app/api/centers/[centerId]/social-strategy/route.tsapps/dashboard/src/app/api/centers/[centerId]/social-strategy/status/route.tsapps/dashboard/src/lib/social-strategy-suggest.ts— Slot-Vorschläge + Digestapps/dashboard/src/app/api/centers/[centerId]/social-strategy/suggest/route.tspackages/mcp-cockpit-os/src/— Tool + Hints in Center-Schemaexports/cockpitos-tools.json— Export aktualisieren
KI-Anbindung
Nach Brand-DNA-Block in Social-Caption-Prompts:
Social-Strategie dieses Centers:
- Soll: 5 Posts/Woche
- Säulen: Shops (2), Events (2), Community (1)
- Formate: mind. 2 Reels
- Hinweis: Di/Do 10:00 bevorzugt
cockpit_social_strategy_suggest — fehlende Slots mit Themenvorschlägen aus News/Events/Angeboten/Review-Analyse (0.1.369).
Lieferstatus (abgeschlossen)
Historischer Überblick — Details im Changelog. Für Redaktion und Agenten gilt die Nutzer-Doku.
| Lieferung | Version | Inhalt |
|---|---|---|
| Phase 1 | 0.1.367 | DB, Editor, Status-API, Kalender-KPI, MCP Lesen/Schreiben |
| Phase 2 | 0.1.368 | pillarId, Auto-Mapping, Pre-Flight, Säulen-Ist |
| Phase 3 | 0.1.369 | Vorschläge, Digest, MCP cockpit_social_strategy_suggest |
| Leistungskatalog | 0.1.370–371 | Kanarien ↔ Cockpit Sync, MCP beidseitig, cockpit_get_center_social_leistung |
| Org-Vorlage | 0.1.372 | Organization.socialStrategyTemplate, Vererbung, Apply auf Center, MCP |
| Reporting Phase 4 | 0.1.373 | Ist/Soll im Social-Reporting + Kundenbericht, Org-Rollup, Performance-PDF, MCP Rollup |
Agent-Playbook (heute): Kanarien Vertrag lesen/schreiben → link_cockpit_center → cockpit_get_center_social_leistung → cockpit_social_strategy_sync_from_crm → status → suggest → Entwürfe → Qualitätsprüfung.
So testen
- Center wählen → Social Cockpit → Strategie → Soll 5/Woche, 2 Reels, 3 Säulen speichern (oder Aus CRM übernehmen).
- Social-Kalender: geplante Posts in aktueller KW → KPI „Ist/Soll“, Reel-Lücke sichtbar.
- Vorschläge laden auf der Strategie-Seite bei Lücken.
- MCP
cockpit_get_center_social_leistung— Vertrag + Strategie + Playbook. - MCP
cockpit_social_strategy_status—gap,byFormat,byPillar.
Backlog (noch nicht umgesetzt)
| Thema | Stand |
|---|---|
| Karma-Migration | Strategie manuell neu pflegen; kein Auto-Import |
| Säulen-Pflicht am Post | Optional, nicht blockierend (wie spezifiziert) |
Entschieden und live: Planungsperiode Woche (Monat optional), Multi-Center-Posts zählen pro Center in centerIds.
Referenzen (Ist-Stand)
- Social-Strategie (Handbuch) — Bedienung, API-Kurz, MCP-Playbook
- Brand DNA
- Social Media Freigabe — Kalender, Post-Mix (Ist)
- Kanarien:
docs/cockpit-integration.md apps/dashboard/src/lib/brand-dna.tsapps/dashboard/src/lib/integration/social-post-types.tsapps/dashboard/src/components/social/social-calendar-parts.tsx— Post-Mix UI
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/social-strategie-modul