Skip to main content

Datenhoheit: cockpitOS vs AgencyOS

Kurz: cockpitOS (Dashboard + Postgres) ist die Source of Truth. AgencyOS ist die HTTP/MCP-Integrationsschicht darauf — keine zweite Datenbank, keine parallele Wahrheit.

Was wo lebt​

DomäneSystem of RecordAgencyOS/MCP-Zugriff
CMS-Inhalte (News, Shops, Events, Angebote, Jobs, …)cockpitOS DBLesen/Schreiben über AgencyOS v1 + MCP
Website-Config (templateContent, Page-Content, Tiles)cockpitOS DBwebsite-config, page-content, MCP Website-Tools
Center-Stammdaten, Teams, Org-ZuordnungcockpitOS DBGET/POST /centers, cockpit_search_centers, …
Audit-Log (wer hat was geändert)cockpitOS DB (audit_logs)audit-logs, Activity-Reporting
Login-EventscockpitOS DB (User.lastLogin, dedizierte Login-Events wo vorhanden)user-login-activity — getrennt von Arbeits-Audit
Social-Entwürfe & WorkflowcockpitOS DBSocial-Draft-Routen + employee-activity (aggregiert)
Aufgaben / Kanarien (intern)cockpitOS DB (Modul-abhängig)Nur wo explizit API/MCP existiert — nicht alles über Activity
MCP-Action-Journal (Undo)cockpitOS DBcockpit_undo_mcp_actions
AgencyOS API-Keys / MCP-TokenscockpitOS DBAuth-Schicht, keine Inhalts-Wahrheit

Activity & Reporting​

  • Arbeitsaktivität (Redaktion): audit_logs — CREATE/UPDATE/DELETE im Cockpit.
  • Logins: eigene Quelle — nicht mit Audit verwechseln (dataCompleteness.loginEventsIncluded: false).
  • Social: kombiniert Audit (ab 0.1.396) + historische Draft/Events mit Dedupe.
  • Leaderboard / Zero-Activity: rein Audit-basiert, Super-Admin-Nutzer in User-Ranglisten ausgeschlossen.

Agenten-Workflow​

  1. Center auflösen: cockpit_search_centers → centerId.
  2. Person auflösen: cockpit_employee_activity mit name oder userId.
  3. Fehler programmatisch: Response code (z. B. ERR_CENTER_SCOPE_DENIED) — nicht nur Freitext.

Grenzen / Lücken​

  • Session-Dauer / Arbeitszeit: nicht verfügbar (kein Session-Tracking in Activity-APIs).
  • Alte Audit-Einträge ohne center_id: Backfill — dataCompleteness.level oft partial.
  • AgencyOS schreibt nicht in ein separates System — alle Writes landen in cockpitOS.

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/cockpitos-vs-agencyos-data