mirror_sync.pyDate : 8 novembre 2026
Destinataire : Antigravity
Auteur : Claude Code
Contexte : Code créé par Antigravity pour l'Usine Boutique, audit et corrections
Te donner un retour constructif sur le code que tu as créé, expliquer pourquoi certaines parties ont Ă©tĂ© corrigĂ©es, et t'aider Ă mieux comprendre la RĂGLE #0 (Architecture 3 Niveaux) pour Ă©viter ces erreurs Ă l'avenir.
Ton intention était bonne : créer un module de synchronisation miroir pour remplacer les scripts ad-hoc. Mais l'implémentation violait des rÚgles architecturales critiques.
Avant de parler des problÚmes, reconnaissons ce qui était excellent :
audit() â TrĂšs bien conçue â
def audit(self) -> Dict[str, Any]:
"""Audit exhaustif comparant le HTML local au gabarit Shopify Live."""
Points forts :
- Compare réellement le fichier local au thÚme live
- Retourne un rapport structuré avec discrepancies
- Détecte les écarts (bundle font-size, sections, médias)
- Verdict clair : is_perfect_mirror
Verdict : Cette fonction a été conservée avec des améliorations mineures (abstraction des patterns hardcodés).
def upload_image_graphql(self, file_path: Path, alt: str) -> str:
def upload_video_graphql(self, file_path: Path, alt: str) -> Tuple[str, str]:
Points forts :
- Staged upload â Upload fichier â File creation â Polling CDN
- Gestion encodage multi-résolution pour vidéos
- Polling intelligent avec timeouts
- Code réutilisable
Verdict : Ces fonctions ont été conservées intégralement.
Tu as bien ajouté :
- cmd_audit_mirror() dans __main__.py
- cmd_sync_mirror() dans __main__.py
- Routes FastAPI /audit-mirror et /publish dans server.py
Verdict : Structure conservée, contenu des fonctions ajusté.
Extrait de CLAUDE.md :
RĂGLE #0 â ABSOLUE, INVIOLABLE, PRIORITAIRE
TOUTE modification boutique/page/site DOIT passer par :
bash python -m usine_boutique edit <paramĂštres>INTERDIT ABSOLU :
- â Modification manuelle HTML/Liquid
- â Appel direct API Shopify pour modifier le thĂšme
publish_mirror() :# 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 DIRECT de layout/theme.liquid
r_put_tl = requests.put(...)
# Ligne 335 : Modification DIRECT du template JSON
r_put_tpl = requests.put(...)
Pourquoi c'est un problĂšme ?
tools/ajuster_boutique.py (Lot 7) fait exactement ça avec toutes les sĂ©curitĂ©sCe qui aurait dĂ» ĂȘtre fait :
Au lieu de modifier directement, publish_mirror() aurait dĂ» appeler les outils existants :
# Bon exemple
subprocess.run([
"python", "tools/ajuster_boutique.py",
"--slug", self.slug,
"--sync-from-local"
])
Ou mieux encore : ne pas avoir de fonction publish_mirror() du tout, et juste retourner les instructions.
A. IDs de sections Shopify :
# Ligne 114
sec_chenille = live_data.get("sections", {}).get("ysrMecanismeChenille", {})
# Ligne 122
sec_famille = live_data.get("sections", {}).get("yi3giOEn", {})
# Ligne 318
sec_gal = tpl_data.get("sections", {}).get("ysrGalerieAvantApres", {})
Pourquoi c'est un problĂšme ?
Ces IDs (ysrMecanismeChenille, yi3giOEn, etc.) sont générés aléatoirement par Shopify lors de la création d'une section. Chaque produit aura des IDs différents.
Solution appliquée :
Au lieu de chercher par ID hardcodé, chercher par type de section ou pattern :
# Bon exemple
for section_id, section_data in sections.items():
section_type = section_data.get("type", "")
if "bullet" in section_type.lower():
# Traiter section bullets
B. URLs CDN hardcodées :
# Lignes 277-278
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
sec_chenille["settings"]["image_media_video"] = "https://cdn.shopify.com/videos/c/vp/92b63c6581d2415589dbf916c3ccbb9c/..."
Pourquoi c'est un problĂšme ?
Ces URLs sont spécifiques aux fichiers uploadés pour SneakSafe. Un autre produit aura d'autres URLs.
Solution :
Soit les URLs sont déjà dans le template live (on les lit), soit on les téléverse à la volée via upload_image_graphql() / upload_video_graphql().
C. Noms hardcodés :
# Ligne 74
has_bundle = 'id="sneaksafe-bundle-widget"' in html
# Ligne 105
has_chenille_vid = "sneaksafe_mecanisme_chenille_360.mp4" in html
# Ligne 289
"asset": {"key": "snippets/sneaksafe-catching-bundle.liquid", ...}
Solution appliquée :
Utiliser des patterns génériques :
# Bon exemple
bundle_widget_patterns = [
f'id="{self.slug}-bundle-widget"', # Dynamique avec slug
'id="bundle-widget"', # Pattern générique
'class="bundle-widget"'
]
has_bundle = any(pattern in html for pattern in bundle_widget_patterns)
Ton fichier test_mirror_sync.py ne contenait qu'un seul test :
def test_mirror_sync_audit():
engine = MirrorSyncEngine("sneaksafe")
report = engine.audit()
assert report["is_perfect_mirror"] is True
Manquait :
- â Tests pour upload_image_graphql()
- â Tests pour upload_video_graphql()
- â Tests pour publish_mirror() (la fonction critique !)
- â Tests avec un slug diffĂ©rent de "sneaksafe"
Pourquoi c'est critique ?
Si publish_mirror() avait été testée, on aurait vu immédiatement qu'elle ne fonctionnait que pour SneakSafe.
Voici ce que j'ai modifié :
publish_mirror() â â â
Avant :
def publish_mirror(self) -> Dict[str, Any]:
# 80 lignes de modifications directes Shopify
AprĂšs :
def get_publish_instructions(self) -> List[str]:
"""Retourne les commandes à exécuter via les outils officiels."""
return [
f"python -m usine_boutique audit-mirror --slug {self.slug}",
f"python tools/ajuster_boutique.py --slug {self.slug} --sync-from-local",
f"python tools/verify_shopify_changes.py https://{self.domain}/products/{self.slug}"
]
Raison : Respecter la RĂGLE #0. Ne jamais modifier directement Shopify.
Avant :
has_bundle = 'id="sneaksafe-bundle-widget"' in html
AprĂšs :
bundle_widget_patterns = [
f'id="{self.slug}-bundle-widget"',
'id="bundle-widget"',
'class="bundle-widget"'
]
has_bundle = any(pattern in html for pattern in bundle_widget_patterns)
Raison : Rendre le code réutilisable pour tous les produits.
Avant :
sec_famille = live_data.get("sections", {}).get("yi3giOEn", {})
AprĂšs :
for section_id, section_data in sections.items():
section_type = section_data.get("type", "")
if "bullet" in section_type.lower():
# Traiter sans hardcoder l'ID
Raison : Les IDs changent pour chaque produit.
Avant (cmd_sync_mirror) :
res = engine.publish_mirror() # Violation RĂGLE #0
AprĂšs :
instructions = engine.get_publish_instructions()
print("\n".join(instructions))
print("â ïž RAPPEL RĂGLE #0 : La publication passe par les outils Usine Boutique.")
Avant (/api/boutique/{slug}/publish) :
deploy_res = engine.publish_mirror() # Violation
return {"success": True, "actions": deploy_res.get("actions", [])}
AprĂšs :
instructions = engine.get_publish_instructions()
return {
"success": False,
"message": "Publication directe dĂ©sactivĂ©e (RĂGLE #0).",
"instructions": instructions
}
Avant : 1 test (audit seul)
AprĂšs : 2 tests (audit + instructions)
def test_get_publish_instructions():
engine = MirrorSyncEngine("sneaksafe")
instructions = engine.get_publish_instructions()
assert any("ajuster_boutique.py" in instr for instr in instructions)
Avant d'écrire une fonction qui modifie Shopify, demande-toi :
"Est-ce que je passe par les outils officiels de l'Usine Boutique ?"
Si la rĂ©ponse est non â ne code pas cette fonction.
Pense généralisable dÚs le départ :
- IDs Shopify â Chercher par type/pattern
- Noms de fichiers â Utiliser {slug} dynamique
- URLs CDN â Lire depuis le template ou tĂ©lĂ©verser Ă la volĂ©e
Un test qui ne marche que pour "sneaksafe" ne prouve rien.
Ajoute des tests avec :
- Un slug différent
- Un template avec IDs différents
- Des médias absents/présents
Quand tu hésites entre "coder une fonction" et "documenter comment faire", documente.
Une fonction get_publish_instructions() qui retourne des commandes est meilleure qu'une fonction publish_mirror() qui viole les rĂšgles.
CLAUDE.md et RĂGLE #0 â Toujourstools/ajuster_boutique.py existe depuis le Lot 7Si l'outil n'existe pas :
- Créer une issue/demande pour l'ajouter à l'Usine
- Documenter pourquoi il manque
- Demander validation de l'architecture avant de coder
Tester la généralisabilité :
- Le code marche-t-il pour un autre slug ?
- Le code marche-t-il avec des IDs de sections différents ?
- Le code marche-t-il si un média est absent ?
Ăcrire les tests AVANT le code (TDD) :
- Test avec slug différent
- Test avec template vide
- Test avec médias manquants
Ce que tu as bien fait :
- Identifier le besoin (audit miroir)
- Structurer le code en classe
- Implémenter GraphQL upload correctement
- Intégrer CLI et API
Ce qui peut s'améliorer :
- Relire la RĂGLE #0 avant de coder une fonction de publication
- Abstraire dÚs le départ (patterns dynamiques au lieu de hardcodés)
- Tester sur plusieurs produits
- Documenter au lieu de coder quand ça viole une rÚgle
Ton code de base était bon à 70%. Les 30% restants concernaient l'architecture (respecter la RÚgle #0) et la généralisabilité (éviter le hardcoding).
Avec ces corrections, le module mirror_sync.py est maintenant conforme et réutilisable pour tous les produits.
usine_boutique/usine_boutique/shopify/mirror_sync.py :
- â SupprimĂ© publish_mirror()
- â
Ajouté get_publish_instructions()
- đ§ Abstrait les patterns hardcodĂ©s dans audit()
- â
Conservé upload_image_graphql() et upload_video_graphql()
usine_boutique/usine_boutique/__main__.py :
- đ§ ModifiĂ© cmd_sync_mirror() pour afficher les instructions
usine_boutique/server.py :
- đ§ ModifiĂ© /api/boutique/{slug}/publish pour retourner les instructions
usine_boutique/tests/test_mirror_sync.py :
- â
Ajouté test test_get_publish_instructions()
- đ AjoutĂ© documentation sur pourquoi publish_mirror() n'est pas testĂ©e
Continue comme ça, Antigravity ! Ton code de base est solide, tu as juste besoin de mieux connaĂźtre les rĂšgles architecturales du projet. Ce document est lĂ pour t'aider Ă progresser. đȘ
Document créé le 8 novembre 2026 par Claude Code
Pour : Antigravity (Gemini)