Skip to main content

v0 / Vercel: Deploy ans Cockpit melden (Teil J)

Zielgruppe: Redaktion (v0), IT (Vercel einmalig)

Workflow (v0-first)​

Redaktion in v0 (Instructions A–I + D)
        │
        ├── Inhalte → MCP/content_push → Cockpit (SSOT)
        │
        └── Deploy auf Vercel
                 │
                 ▼
        POST /api/cockpit-register (Vercel)
                 │
                 ▼
        Cockpit speichert Staging/Live-URLs (Website) bzw. signage / companion
                 │
                 └── Publish (v0-Chat oder Cockpit) → Revalidate → Live

Live-Betrieb: Änderungen in v0-Chat oder Cockpit — beide schreiben ins Cockpit; Frontends lesen dieselbe API.

Für Redaktion (v0 Instruction „Cockpit J“)​

Nach erstem Vercel-Deploy im Chat:

„Melde diese Deploy-URL ans Cockpit (Teil J): cockpit_agencyos_register_frontend_deployment mit channel website.“

Oder IT richtet Deploy Hook ein — dann gar nichts manuell.

Instruction-Text zum Kopieren: center-website-v0-api-ready-to-go — Teil J

Für IT​

Empfohlen (Team-Setup): v0 Team-Template einrichten — Shared Env einmal, pro Center nur Token + Slug.

Klassisch / Detail: v0-Website A–Z — Abschnitt F3

Kurz (pro Center, wenn Template schon steht):

  1. Dashboard → Frontend-Kanäle (v0) → Register-Token erzeugen
  2. Vercel Projekt-Env: COCKPIT_REGISTER_TOKEN, COCKPIT_CENTER_SLUG, NEXT_PUBLIC_DASHBOARD_URL (wie API-Basis)
  3. Team Shared Env (jedes Projekt verlinken): COCKPIT_DASHBOARD_URL, REVALIDATION_SECRET, COCKPIT_FRONTEND_CHANNEL
  4. postbuild oder Deploy Hook → POST …/api/cockpit-register (im Template enthalten)

API (Entwickler)​

RouteAuthBody
POST /api/public/frontend-deployments/registerX-Cockpit-Register-Token: frt_… oder Bearer AgencyOS{ channel, origin, environment?, source? }
POST /api/agencyos/v1/centers/{centerId}/frontend-deployments/registerBearer AgencyOS{ channel, origin, environment?, source? }

environment: preview (Staging, *.vercel.app) oder production (Live). Default: aus origin bzw. Vercel VERCEL_ENV beim Hook. Go-Live/DNS nur für Custom Domains — nicht für Preview-URLs.

Sicherheit: Register-Token ist pro Center — kein Secret im Browser. Überschreibt nur die URL des gewählten Kanals; löscht keine anderen Daten.

MCP: cockpit_agencyos_register_frontend_deployment

Migration (Live-DB)​

Additiv, kein Datenverlust:

cd packages/database
npx prisma db execute --file migrations/20260521140000_add_frontend_deployment_register_SAFE.sql --schema schema.prisma
npx prisma generate

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/v0-deploy-cockpit-register