Skip to main content

Social-Strategie-Modul (Variante B)

StatusUmgesetzt (0.1.367–0.1.371) — Spec & Architektur-Referenz; Bedienung: Social-Strategie
EntscheidungVariante B: eigenes Objekt + UI, getrennt von Brand DNA
WerRedaktion, Center-Marketing, KAM, Agenten (MCP/AgencyOS)
WarumBrand 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​

BereichBrand DNA (heute)Social-Strategie (neu)
Tonalität, Zielgruppe, Tabusjanein (Verweis auf DNA)
Beispiel-Post / Visual-Hintsjanein
Posts pro Woche (Soll)neinja
Content-Säulen / Themen-Mixneinja
Format-Mix (Feed/Reel/…)neinja
Kanal-Ziele (IG vs FB)neinja (optional)
Ist-vs-Soll / Lückenneinja
Beste Posting-Zeiten (Hinweis)neinja (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) — analog brand_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 campaignLabel bleibt; Mapping-Regeln von linkedSources → 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 (scheduledAt in Periode) oder live (publishedAt in Periode)
  • Center: centerId bzw. 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
ModulSocial Cockpit (social-cockpit)
Center-BezugCenter-Switcher (wie Social-Kalender)

Abschnitte auf der Seite:

  1. Übersicht (Ist vs. Soll) — aktuelle Woche/Monat, KPI-Zeile, Lückenliste
  2. Frequenz — postsPerPeriod, planningPeriod
  3. Content-Säulen — Liste editierbar (Label, Soll, Keywords, Quellen)
  4. Format-Mix — Feed / Karussell / Story / Reel mit Soll-Zahlen
  5. Kanäle (optional) — Min/Max pro Netzwerk
  6. Posting-Hinweise — Wochentag + Uhrzeit (Empfehlung für Redaktion)
  7. 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)​

KanalVertrag
DashboardGET/PATCH /api/centers/{centerId}/social-strategy
AgencyOSGET/PUT /api/agencyos/v1/centers/{centerId} — Feld socialStrategy (Partial)
StatusGET /api/centers/{centerId}/social-strategy/status
VorschlägeGET /api/centers/{centerId}/social-strategy/suggest
LeistungskatalogGET /api/centers/{centerId}/social-strategy/leistung — Kanarien-Vertrag + Strategie + Playbook
CRM-SyncPOST /api/centers/{centerId}/social-strategy/sync-from-crm
KontextGET …/centers/{id}/context — center.socialStrategy + kompaktes strategyStatus
MCP cockpitOScockpit_get_center_social_leistung, cockpit_social_strategy_sync_from_crm, cockpit_social_strategy_status, cockpit_social_strategy_suggest, cockpit_update_center (socialStrategy)
MCP Kanarienget_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/Evaluate
  • apps/dashboard/src/lib/social-strategy-service.ts
  • apps/dashboard/src/app/api/centers/[centerId]/social-strategy/route.ts
  • apps/dashboard/src/app/api/centers/[centerId]/social-strategy/status/route.ts
  • apps/dashboard/src/lib/social-strategy-suggest.ts — Slot-Vorschläge + Digest
  • apps/dashboard/src/app/api/centers/[centerId]/social-strategy/suggest/route.ts
  • packages/mcp-cockpit-os/src/ — Tool + Hints in Center-Schema
  • exports/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.

LieferungVersionInhalt
Phase 10.1.367DB, Editor, Status-API, Kalender-KPI, MCP Lesen/Schreiben
Phase 20.1.368pillarId, Auto-Mapping, Pre-Flight, Säulen-Ist
Phase 30.1.369Vorschläge, Digest, MCP cockpit_social_strategy_suggest
Leistungskatalog0.1.370–371Kanarien ↔ Cockpit Sync, MCP beidseitig, cockpit_get_center_social_leistung
Org-Vorlage0.1.372Organization.socialStrategyTemplate, Vererbung, Apply auf Center, MCP
Reporting Phase 40.1.373Ist/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​

  1. Center wählen → Social Cockpit → Strategie → Soll 5/Woche, 2 Reels, 3 Säulen speichern (oder Aus CRM übernehmen).
  2. Social-Kalender: geplante Posts in aktueller KW → KPI „Ist/Soll“, Reel-Lücke sichtbar.
  3. Vorschläge laden auf der Strategie-Seite bei Lücken.
  4. MCP cockpit_get_center_social_leistung — Vertrag + Strategie + Playbook.
  5. MCP cockpit_social_strategy_status — gap, byFormat, byPillar.

Backlog (noch nicht umgesetzt)​

ThemaStand
Karma-MigrationStrategie manuell neu pflegen; kein Auto-Import
Säulen-Pflicht am PostOptional, nicht blockierend (wie spezifiziert)

Entschieden und live: Planungsperiode Woche (Monat optional), Multi-Center-Posts zählen pro Center in centerIds.


Referenzen (Ist-Stand)​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/plattform/social-strategie-modul