Médias Shopify — fonctionnement actuel et périmètres

CURRENT au 8 octobre 2026. Ce runbook concerne les capacités de génération de la boutique Shopify depuis Chat Atlas et Workflow. Le Drop par jeton, les écrans créatifs internes /ops/creative/*, l'agence et l'ancien plan de production opérateur sont retirés du runtime applicatif. Leurs anciennes procédures ne doivent plus être exécutées à partir de BoostEcom.

Ce qui fonctionne côté boutique

• Chat Atlas : les tools generateImage, composeProductImage, generateVideo, generateVector et saveStudioAsset utilisent le contexte et les permissions de la boutique du tour. Un tool non autorisé ou un mode média non activé ne doit pas être promis au modèle.
• Workflow V2 : les nœuds de génération d'image et de vidéo passent par src/features/shopify/media/generation-actions.ts. L'exécuteur src/features/ai/workflow/v2/server/execute.ts ne dépend plus des actions de l'ancienne interface Studio.
• Prix de Workflow : la formule commune est dans src/features/shopify/media/quote-pricing.ts, pas dans les composants d'interface. Le prix affiché doit suivre la durée réellement facturée.
• Livraison : les gardes magasin, journal GenerationRequest, compteur de crédits et Vercel Blob restent dans la plateforme BoostEcom. Une génération lancée pour une boutique ne doit jamais utiliser les droits ou références d'une autre.
• Interface marchand historique : ?mode=studio existe encore dans le cockpit Shopify à la date de ce contrôle. Son retrait est un chantier de nettoyage distinct ; ce n'est pas une raison pour supprimer les moteurs utilisés par Chat ou Workflow.

Préconditions de génération

1. Résoudre la boutique autorisée du lecteur ou de l'agent, et vérifier le droit studio.asset.create via src/lib/security/store-creative-actor.ts.
2. Ne rendre appelable que le tool activé dans le contexte du tour. Un cas sans moteur disponible n'affiche pas de prix trompeur.
3. Écrire la demande dans le journal avant la génération ; débiter selon le résultat et le contrat de facturation, en conservant les remboursements et traces d'échec.
4. Livrer l'asset sous le préfixe Blob de la boutique et exposer seulement son URL autorisée au Chat, au Workflow et au lecteur concerné.

Services supplémentaires

Les variables HIGGSFIELDS_MCP_URL et HIGGSFIELDS_MCP_TOKEN ont une sévérité optional dans src/services/env-audit.ts : elles ne doivent pas être présentées comme une condition générale de fonctionnement de la génération média. Leur présence n'autorise pas à promettre une capacité non démontrée par le catalogue et le runtime du moment.

La production interne de films et de compositions a son code canonique dans BoostEcom/Ecosystem, branche Private/Studio/@BoostEcom/Development, projet projects/creative-runtime/. Les instructions de moteur sont dans Creative Studio — frontière des dépôts. Ne pas copier ce runtime dans BoostEcom, ni dans Orbit Studio.

Ce qui n'est plus une procédure applicable

Ne pas lancer /ops/creative/studio, /ops/creative/qc, /ops/creative/cinema ou /drop/<token> : ces anciens chemins de l'interface opérateur ne sont plus des entrées actives. Ne pas rétablir le vieux writer Growth/Postiz, un cron de Drop, un second ledger ou une deuxième base de données au seul motif qu'un ancien ADR ou backlog cite ces composants.

Pour les actions actuellement accessibles à un développeur mandaté, /ops redirige vers /ops/dev avec la permission platform.dev.operate. Pour les opérations créatives internes, utiliser le projet Ecosystem approprié et son propre contrôle d'accès.

Critère de nettoyage : retirer les anciens écrans et fichiers non référencés, mais conserver les capabilities Shopify tant qu'elles sont utilisées, et ne toucher ni à BoostEcom/orbit.easyconnector.app ni aux mécanismes déjà reconstruits dans Orbit Studio.