Généré le 15/11/2026 01:03

🔍 RAPPORT D'AUDIT — Code Usine Boutique créé par Antigravity

Date : 8 novembre 2026
Auditeur : Claude Code
Demandeur : Raphael


📋 RÉSUMÉ EXÉCUTIF

Antigravity a créé un module mirror_sync.py censé remplacer les scripts ad-hoc et garantir la synchronisation entre le site local et Shopify. CEPENDANT, ce code présente 3 violations critiques de la RÈGLE #0 (Architecture 3 Niveaux) et n'est PAS généralisable au-delà de SneakSafe.

❌ Verdict Global : CODE NON CONFORME


🚹 VIOLATIONS CRITIQUES IDENTIFIÉES

1ïžâƒŁ VIOLATION RÈGLE #0 : Modifications Directes Shopify SANS Passage par l'Usine

RÈGLE #0 (CLAUDE.md) :

TOUTE modification boutique/page/site DOIT passer par :
bash python -m usine_boutique edit <paramĂštres>

CE QUE FAIT LE CODE :
La fonction publish_mirror() (lignes 264-340) modifie DIRECTEMENT le thĂšme Shopify via API :

# Ligne 289 : Écrasement DIRECT du snippet Liquid
r_put_sc = requests.put(f"https://{self.domain}/admin/api/2024-01/themes/{self.theme_id}/assets.json", 
    headers=self.theme_headers, 
    json={"asset": {"key": "snippets/sneaksafe-catching-bundle.liquid", "value": snippet_payload}}
)

# Ligne 300 : Modification DIRECTE de layout/theme.liquid
r_put_tl = requests.put(f"https://{self.domain}/admin/api/2024-01/themes/{self.theme_id}/assets.json", 
    headers=self.theme_headers, 
    json={"asset": {"key": "layout/theme.liquid", "value": tl_val}}
)

# Ligne 335 : Modification DIRECTE du template JSON produit
r_put_tpl = requests.put(f"https://{self.domain}/admin/api/2024-01/themes/{self.theme_id}/assets.json", 
    headers=self.theme_headers, 
    json={"asset": {"key": f"templates/product.{self.slug}.json", "value": json.dumps(tpl_data, ...)}}
)

CONSÉQUENCE : Ce code fait EXACTEMENT ce qu'il Ă©tait censĂ© remplacer (les scripts ad-hoc). Il n'utilise PAS les outils de l'Usine Boutique (tools/ajuster_boutique.py, Lot 7).


2ïžâƒŁ CODE CODÉ EN DUR POUR SNEAKSAFE (NON GÉNÉRALISABLE)

Le code est massivement hardcodé pour SneakSafe :

A. IDs de sections Shopify hardcodés :

# Ligne 114 : Section chenille
sec_chenille = live_data.get("sections", {}).get("ysrMecanismeChenille", {})

# Ligne 122 : Section famille
sec_famille = live_data.get("sections", {}).get("yi3giOEn", {})

# Ligne 318 : Section galerie résultats
sec_gal = tpl_data.get("sections", {}).get("ysrGalerieAvantApres", {})

# Ligne 324 : Section étapes
sec_steps = tpl_data.get("sections", {}).get("4A4R59JAgV", {})

ProblÚme : Ces IDs (yi3giOEn, 4A4R59JAgV, ysrMecanismeChenille) sont uniques à SneakSafe. Un autre produit aura d'autres IDs générés aléatoirement par Shopify.

B. URLs CDN hardcodées :

# Lignes 277-278 : URLs bundles en dur
cdn_b6 = "https://cdn.shopify.com/s/files/1/0651/2967/7006/files/sneaksafe-bundle-6-badge-final.png?v=1794146459"
cdn_b9 = "https://cdn.shopify.com/s/files/1/0651/2967/7006/files/sneaksafe-bundle-9-badge-final.png?v=1794146464"

# Ligne 332 : URL vidéo chenille en dur
sec_chenille["settings"]["image_media_video"] = "https://cdn.shopify.com/videos/c/vp/92b63c6581d2415589dbf916c3ccbb9c/92b63c6581d2415589dbf916c3ccbb9c.HD-1080p-3.3Mbps-100463735.mp4?autoplay=true&loop=true&muted=true&playsinline=true"

ProblÚme : Ces URLs sont spécifiques aux fichiers SneakSafe uploadés. Impossible de réutiliser ce code pour un autre produit.

C. Noms de fichiers hardcodés :

# Ligne 74-79 : Widget bundle SneakSafe
has_bundle = 'id="sneaksafe-bundle-widget"' in html
idx = html.find('id="sneaksafe-bundle-widget"')

# Ligne 105 : Vidéo chenille SneakSafe
has_chenille_vid = "sneaksafe_mecanisme_chenille_360.mp4" in html

# Ligne 289 : Snippet SneakSafe
"asset": {"key": "snippets/sneaksafe-catching-bundle.liquid", ...}

ProblÚme : Impossible d'utiliser ce code pour un autre produit sans réécrire tout le code.


3ïžâƒŁ TESTS INCOMPLETS

Le fichier tests/test_mirror_sync.py ne contient qu'UN SEUL TEST :

def test_mirror_sync_audit():
    engine = MirrorSyncEngine("sneaksafe")
    report = engine.audit()
    assert report["local_html_found"] is True
    # ...

Manque :
- ❌ Aucun test pour upload_image_graphql()
- ❌ Aucun test pour upload_video_graphql()
- ❌ Aucun test pour publish_mirror() (la fonction critique !)
- ❌ Aucun test avec un slug diffĂ©rent de "sneaksafe"


✅ ÉLÉMENTS POSITIFS

  1. Fonction audit() : Bien conçue, elle compare réellement le local et le live
  2. GraphQL Upload : Les fonctions upload_image_graphql() et upload_video_graphql() sont bien implémentées avec polling
  3. Intégration CLI : Les commandes audit-mirror et sync-mirror sont bien ajoutées dans __main__.py
  4. Intégration API : Les routes FastAPI /api/boutique/{slug}/audit-mirror et /publish sont bien ajoutées dans server.py

📊 COMPARAISON AVANT/APRÈS

Aspect Scripts Ad-hoc (Avant) mirror_sync.py (Antigravity) Objectif Réel
Passage par Usine ❌ Non ❌ Non (violation) ✅ Obligatoire
GĂ©nĂ©ralisable ❌ Non ❌ Non (hardcodĂ© SneakSafe) ✅ Tous produits
Tests ❌ Aucun ⚠ Partiels (audit seul) ✅ Complets
Validation ❌ Manuelle ⚠ Backup/Validation absents ✅ Auto + Fallback
URLs en dur ❌ Oui ❌ Oui (violations) ✅ Dynamiques

CONSTAT : Le code d'Antigravity reproduit les mĂȘmes dĂ©fauts que les scripts ad-hoc qu'il devait remplacer.


🔧 CE QU'IL FAUDRAIT CORRIGER

Corrections Nécessaires :

  1. Supprimer publish_mirror() et la remplacer par des appels Ă  tools/ajuster_boutique.py
  2. Abstraire tous les IDs de sections : remplacer les IDs hardcodés par une recherche dynamique basée sur le type de section
  3. Abstraire les URLs CDN : détecter les URLs dynamiquement depuis le template ou les téléverser à la volée
  4. Abstraire les noms de fichiers : remplacer sneaksafe-* par des patterns génériques
  5. Compléter les tests : ajouter des tests pour upload_* et publish_mirror()
  6. Ajouter backup automatique : créer un backup du thÚme avant toute modification
  7. Ajouter validation post-publication : vérifier visuellement que le site live correspond au local

🎯 RECOMMANDATION FINALE

⚠ NE PAS UTILISER ce code en l'Ă©tat

Actions recommandées :

Option 1 (Rapide) : Désactiver temporairement publish_mirror() et continuer d'utiliser tools/ajuster_boutique.py (Lot 7 existant)

Option 2 (Correcte) : Refondre complĂštement mirror_sync.py pour :
- Supprimer toute modification directe Shopify
- Passer par les outils officiels de l'Usine Boutique
- Abstraire tous les éléments spécifiques à SneakSafe
- Ajouter backup/validation/fallback

Option 3 (Pragmatique) : Garder audit() (qui fonctionne bien), jeter publish_mirror(), et documenter que la publication manuelle via les outils existants est le workflow validé.


📝 QUESTIONS À TRANCHER

  1. Veux-tu que je corrige ce code maintenant ou préfÚres-tu qu'Antigravity le refasse ?
  2. Veux-tu conserver la fonction audit() (qui est bien faite) et juste retirer publish_mirror() ?
  3. Veux-tu que je documente les patterns corrects pour qu'Antigravity puisse recoder proprement ?

Rapport généré le 8 novembre 2026 par Claude Code
Fichier source audité : C:\ASSISTANT_IA\usine_boutique\usine_boutique\shopify\mirror_sync.py