Runbooks & opérationsCreative Media OS — exécution et frontière de dépôts

Creative Media OS — exécution et frontière de dépôts

Depuis le 8 octobre 2026, l'application ne contient plus de package Remotion creative/. Son moteur est versionné dans Ecosystem / projects/creative-runtime. Ne pas réintroduire de copie locale.

Depuis le 8 octobre 2026, l'application ne contient plus de package Remotion creative/. Son moteur est versionné dans Ecosystem / projects/creative-runtime. Ne pas réintroduire de copie locale.

Répartition

ResponsabilitéPropriétaire
Catalogue partagé src/services/creative/templates.json, données magasin, garde et créditsboostecom.app
Déclenchement GitHub src/services/creative/render-dispatch.ts, ticket cinéma et journal GenerationRequestboostecom.app
Callback /api/webhooks/creative-render, Vercel Blob, rétention et contrôle des permissionsboostecom.app
Compositions Remotion, creative/scenes, ciné/capture, tests du moteur, rendu et publication de l'artefactEcosystem/projects/creative-runtime
Brouillons Postiz et validation humaineWriter app existant, jamais deux writers simultanément

Le workflow applicatif creative-render.yml charge un commit SHA immuable d'Ecosystem via un token lecture seule STUDIO_SOURCE_TOKEN. Il prépare les quatre sources d'application src, public, content et .github/workflows ; l'ancien skill .claude/skills/boostecom-content n'est plus un prérequis.

Modifier ou rendre une composition en local

Dans un checkout séparé d'Ecosystem, depuis projects/creative-runtime/ :

node tools/app-context.mjs /chemin/absolu/vers/boostecom.app
pnpm creative:install
pnpm creative:check
pnpm creative:studio
pnpm creative:render -- --template stat-card --fields '{"value":"41"}' --formats square-1x1 --outputs png --label exemple

Pour publier un artefact volontairement, utiliser pnpm creative:publish dans ce même projet avec les autorisations requises. La création d'un fichier Blob ne publie pas de post Postiz. Les commandes creative:* n'existent plus dans le package.json racine de l'application.

Une nouvelle forme nécessite un changement synchronisé du catalogue boostecom.app/src/services/creative/templates.json et de la scène dans Ecosystem, puis un nouveau SHA épinglé dans le workflow applicatif. Les tests du catalogue et des scènes Remotion appartiennent désormais à Ecosystem/projects/creative-runtime/tests; les contrats d'appel, de permission et de journal restent testés dans l'application.

Secrets et pannes

  • GITHUB_TOKEN (application) autorise uniquement le déclenchement du workflow.
  • STUDIO_SOURCE_TOKEN (Actions) permet un checkout d'Ecosystem en lecture seule.
  • BLOB_READ_WRITE_TOKEN publie les fichiers générés et conserve le même préfixe Blob.
  • CREATIVE_RENDER_CALLBACK_SECRET et CREATIVE_RENDER_CALLBACK_URL permettent la réconciliation des demandes.

En cas d'échec du moteur, ne pas migrer ni effacer les GenerationRequest, les assets Blob, les crédits ou le writer Postiz. Revenir au SHA Studio précédent dans le workflow seulement après avoir vérifié sa compatibilité avec les contrats de l'application. Un revert de la PR de retrait restaure la copie Git historique si nécessaire.

Les écrans internes /ops/creative/* et l'ancien Plan A restent une transition distincte : ils peuvent encore utiliser les APIs et la DB de l'app. Leur suppression exige un vrai transfert fonctionnel et des tests de capture/ticket/publication, elle ne découle pas de la seule extraction Remotion.