Généré le 14/10/2026 22:43

SOP Déploiement et Validation des Templates Produits Steelflex

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).


📋 Prérequis & Fichiers Clés


🔄 Flux Opérationnel Automatisé en 4 Étapes

Étape 1 : Sourcing et Upload des Médias via GraphQL

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}.

Étape 2 : Déploiement du Template & Assignation

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 format shopify:// 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.

Étape 3 : Passage en Statut Actif Temporaire

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.

Étape 4 : Validation Visuelle Storefront

  1. Une fois le statut actif, le script navigue via Playwright vers la page produit publique.
  2. Une attente de 10 secondes est appliquée pour s'assurer que le script charge la totalité des images injectées.
  3. Une capture d'écran de vérification est enregistrée dans scratch/storefront_<handle>.png.
  4. Le produit est immédiatement rebasculé en statut draft.

☑️ CHECKLIST D'AUTO-VALIDATION — APRÈS LE REBASCULEMENT EN DRAFT (ajoutée 09/07/2026)

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.


⚠️ Règles de Sécurité et Bonnes Pratiques

[!IMPORTANT]
- Ne JAMAIS laisser un produit brouillon en statut active aprè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.