Ce document définit le protocole standardisé pour générer, déployer, associer et valider visuellement un template personnalisé sur le thème SteelFlex de Shopify, applicable à n'importe quel produit existant ou futur (brouillon ou actif).
scratch/integrate_from_sheet.py (Script unifié gérant l'intégration de bout en bout depuis Google Sheets, l'import d'images, le copywriting, la création et le déploiement du template).scratch/downloaded_templates/86408fec960f.json (Template parent original du thème).lance_chrome_debug.bat (Lance Chrome officiel sur le port 9222).Toutes les images externes (provenant d'AliExpress ou d'autres plateformes) doivent impérativement être importées de manière native dans Shopify pour éviter les erreurs 422 lors du déploiement :
1. Envoyer le fichier binaire sur le bucket GCS fourni par la mutation stagedUploadsCreate.
2. Créer l'entité de fichier avec la mutation fileCreate.
3. Interroger dynamiquement l'état du fichier jusqu'à ce qu'il soit READY.
4. Récupérer le nom de fichier final pour structurer le lien au format interne requis : shopify://shop_images/{filename}.
Exécuter le script d'intégration en ciblant la ligne du produit dans le Google Sheet :
python scratch/integrate_from_sheet.py --row-index <index> --deploy --screenshot
[!NOTE]
Le script intègre automatiquement le copywriting généré par IA, crée les fichiers au formatshopify://pour remplacer les URLs externes dans les sections, téléverse le template unique (templates/product.magic-{handle}.json) dans les fichiers du thème, associe le template au produit et effectue le nettoyage.
Si le produit cible est configuré en brouillon (draft), l'aperçu storefront renverra un code d'erreur 404. Le script bascule le produit en statut active de manière temporaire uniquement pour permettre le rendu côté client.
scratch/storefront_<handle>.png.draft.Avant de clore la mission, réponds explicitement à chaque question :
1. Le statut draft a-t-il été confirmé par une relecture GET réelle du produit, pas seulement supposé suite à l'appel du script ?
2. Si le script a échoué ou a été interrompu entre la capture d'écran et le rebasculement : le statut a-t-il été vérifié et corrigé manuellement avant de considérer la mission terminée ?
Si une seule réponse est Non : ne clos pas la mission — relis le statut réel du produit et corrige-le en draft si nécessaire avant de continuer.
[!IMPORTANT]
- Ne JAMAIS laisser un produit brouillon en statutactiveaprès la phase de capture d'écran pour éviter toute indexation ou achat prématuré.
- Assurer une sanitisation stricte sur le handle (suppression des caractères non-ASCII ou de ponctuation comme™) pour que Shopify accepte la création de l'asset.
- Toujours vérifier la bonne exécution du pipeline d'attente d'upload d'images GraphQL afin d'éviter d'associer des identifiants vides ou non traitées par Shopify.