Start hier — Entwicklung & Integration
Zielgruppe: Entwicklerinnen, IT, Agenturen, Cursor / Claude / MCP — nicht die Redaktions-Anleitung (die liegt unter Navbar Redaktion).
Doku-Leitplan: Doku-Zielgruppen.
Architektur in 30 Sekunden
| Schicht | Pfad | Rolle |
|---|---|---|
| Daten | packages/database (Prisma) | Schema, Migrationen — nur über Dashboard schreiben |
| Kern | apps/dashboard | APIs, Auth, Geschäftslogik, einziger direkter DB-Zugriff |
| Kanäle | apps/center-website, apps/digital-signage, apps/center-manager | API-Clients zum Dashboard |
| Shared | packages/ui, packages/ai-context, packages/wayfinding, … | Wiederverwendung |
| MCP | packages/mcp-cockpit-os, packages/mcp-cockpit-remote | Claude/Cursor-Tools gegen APIs |
| Doku | cockpit-docs/ | Diese Site |
Vertiefung: Plattform-Überblick · Reife & Betrieb.
Repo-Start
# Monorepo-Root — Node >= 22.13, pnpm
pnpm install
pnpm --filter dashboard dev # Dashboard lokal
| Datei | Zweck |
|---|---|
README.md | Root-Überblick |
db_structure.md | Schema-Referenz (nach DB-Änderung pflegen) |
render.yaml | Deployment-Services |
.cursor/rules/ | Cursor-Regeln (Doku-Pflicht, DB-Safety, Next-Routes, …) |
scripts/check-next-dynamic-route-slugs.mjs | Pflicht vor neuen API-Routen |
APIs & Verträge (maßgeblich)
| Vertrag | Wann |
|---|---|
| Public Center-Website API | v0, externe Frontends, öffentliche Reads |
| AgencyOS Integration | Partner, Magic Link, Content-Push, Audit |
| WordPress Push | Plugin-Sync |
| Dashboard API Center-Scoping | Session, Rollen, centerId |
| OpenAPI | /openapi/agencyos-integration.yaml, /openapi/public-wayfinding-read.yaml |
| JSON | /ai-integration/cockpit-api-capabilities.json |
Gap-Analysen (intern): Public API Gap · Center-Website Bundle.
MCP & AI-Coding-Tools
| Paket | Transport | Doku |
|---|---|---|
packages/mcp-cockpit-os | Stdio (Claude Desktop, Cursor) | README |
packages/mcp-cockpit-remote | HTTP (Claude Connector) | Paket-README |
packages/mcp-cockpit-os/V0_CUSTOM_INSTRUCTIONS.md | — | v0-Instruction-Quellen (Repo) |
Env (Namen, keine Werte in Doku): COCKPIT_DASHBOARD_BASE_URL, COCKPIT_AGENCYOS_API_KEY, COCKPIT_ALLOW_CONTENT_PUSH, COCKPIT_MCP_HTTP_BEARER (Remote).
MCP-Server-Instructions verweisen auf den Public-API-Vertrag — bei Tool-Änderungen Vertrag und MCP synchron halten.
Redaktion (Claude ohne Code): Claude & MCP — andere Zielgruppe.
System erweitern — typische Einstiegspunkte
| Änderung | Wo anfangen |
|---|---|
| Neues Dashboard-Menü / Modul | apps/dashboard/src/config/navigation.ts, lib/modules.ts → Navigation-Doku |
| Neue öffentliche API-Route | apps/dashboard/src/app/api/... — ein Dynamic-Slug pro Ebene |
| Center-Website-Feature | apps/center-website + ggf. Public API |
| Neues MCP-Tool | packages/mcp-cockpit-os/src/register-cockpit-tools.ts |
| Prisma-Schema | packages/database — additive Migration, db_structure.md |
| Website-Template | apps/center-website + Templates |
| WordPress | Theme Development |
Tutorial: Getting Started · Plugins: Plugin-Übersicht.
MEC / Legacy (nur bei Migration)
Eingeklappt in der Sidebar: CSS-Checklisten, mec-import, mec-shared-bausteine — nicht der Einstieg für neue Features.
Nächste Schritte
Kontakt: sb@schickma.de
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/start-hier