Généré le 31/10/2026 15:22

PLAN D'IMPLÉMENTATION — « Usine Boutique » (clone interne de DropMagic)

Date : 31/10/2026, rédigé par Claude Code. Toutes les observations viennent de captures réelles faites le jour même.
Destinataire : n'importe quelle IA qui code (Claude Code, Antigravity, autre). Ce document se suffit à lui-même : chaque ticket indique ses entrées, ses sorties, les fichiers à créer, les tests à lancer et les critères qui disent quand il est terminé.
Verdict d'architecture (outil MCP workflow_architect, 90 %) : pipeline en étapes (graphe) avec state.json persistant et portes de validation Telegram. Navigation automatique uniquement en appoint. Ne jamais dupliquer la logique des outils existants (tools/registry.py).


0. Résumé en 6 points

  1. DropMagic ne fait rien de magique. Il enchaîne 5 étapes : lecture du produit → kit de marque → page produit → page d'accueil → panier, chacune pilotée par l'IA. Il les affiche lui-même dans sa page MCP. Ses données internes, récupérées depuis ton compte, montrent exactement ce que l'IA produit à chaque étape : personas, angles, voix de marque, rôle de chaque section.
  2. Le moteur d'affichage existe déjà chez nous. Le thème en ligne de Ysenra contient 32 sections Liquid DropMagic (dm-*) et 19 modèles de page produit générés par DropMagic. Tout est téléchargé en local avec le catalogue de leurs réglages. Notre outil n'a pas besoin de reconstruire un éditeur visuel : il génère des fichiers JSON de template Shopify qui assemblent ces sections et remplissent leurs réglages.
  3. Ce qui manque surtout, c'est le chaînage IA entre la lecture produit, la stratégie, le texte et la composition, et l'assemblage automatique du template. Nos SOP couvrent déjà le fond (avatar, copywriting, visuels, audit), mais en manuel ou par morceaux.
  4. Répartition des modèles :
    - Gemini pour tout ce qui est visuel : analyser les captures du site concurrent, les photos produit et le contrôle qualité visuel.
    - Claude pour la stratégie et le texte en français.
    - fal.ai (nano-banana) pour les images.
    - Du code fixe, sans IA, pour la récupération des données (scraping) et l'assemblage.
  5. Ordre de construction recommandé (la page produit est la priorité de Raphael) : Lot 0 (fondations), puis Lot 3 (génération du template à partir d'un texte existant, testé sur SneakSafe), puis Lot 2 (stratégie et texte), Lot 1 (lecture produit et concurrent), et seulement ensuite visuels, offres, contrôle qualité et outils d'édition.
  6. Risques à connaître :
    - Code DropMagic du thème : assets/dm-core.js vérifie l'abonnement en ligne. Si l'abonnement est inactif, il affiche un badge DropMagic et envoie les visiteurs à leur outil de statistiques (PostHog). Notre version doit retirer ce code.
    - Licence : les sections dm-* ont été générées par DropMagic. À moyen terme, il faut les réécrire comme les nôtres (Lot 8).

1. Ce que fait DropMagic (relevé réel du 31/10/2026)

1.1 Parcours utilisateur

Étape Ce que DropMagic demande ou fait Preuve
Création Tableau de bord : « Nouvelle boutique ». Abonnement Pro à 79 €/mois obligatoire pour créer ou publier. captures/01_dashboard.*, 40_nouvelle_boutique_etape1.png
Entrée 1 URL du produit (AliExpress, etc.). Produit importé : titre, images, options, variantes, prix, prix barré. table products (original_url, original_provider: aliexpress)
Entrée 2 « Colle le lien produit de ton concurrent » (doit être une boutique Shopify), « à utiliser comme source d'inspiration, pas pour copier ». captures/flux_creation_juin2026/dropmagic_step_concurrent.png
Génération Écran « Génération… » section par section, sur des maquettes en faux texte (lorem ipsum). flux_creation_juin2026/dropmagic_building_*.png
Panneau Stratégie Produit, langue (6), 4 personas générés (au choix ou personnalisés), 4 angles marketing générés, instructions supplémentaires, puis « Sauvegarder » qui régénère. captures/20_panel_1.png
Panneau Studio Génération d'images (texte libre, choix Produit/Format/Style, crédits), plus « Inspiration » : on choisit une image modèle et elle est reproduite avec notre produit. captures/21_ajout_section.png, 25_studio_inspiration.png
Bibliothèque de sections 13 catégories, 58 sections : Hero 5, Produit 2, Caractéristiques 11, Comment faire 4, Galerie 2, Bannières 6, FAQ 4, Comparaison 7, Logos 2, Compte à rebours 3, Avis 7, Ajout au panier fixe en bas d'écran 3, Statistiques 2. Plus « Demander une section ». captures/27_ajout_section.png, captures/bibliotheque_sections/ (57 vignettes)
Éditeur Vue ordinateur/mobile, réglages, aperçu, historique des versions, « Publier ». Bouton « Ajouter un bloc » dans chaque section. captures/10_builder_desktop.png
Offres Remises par quantité (« BUY MORE & SAVE » : Single / Duo -50 % / Pack de 3 -60 %), badges, variables @saved_total et @saved_percentage. table shop_discounts
Publication Pousse les modèles product.magic-product-<theme>-<page>.json sur le thème Shopify, plus des pages d'avis (page.reviews-…). thème Ysenra, 19 modèles magic
Abonnement Pro Publication Shopify, pages illimitées, app de packs et de panier, 30 crédits Studio/mois, rédaction IA et « agent d'annotation », kit de marque et système de style. écran de paiement, 40_*.png
MCP https://dropmagic.ai/mcp (connexion OAuth). Permet de modifier sections, prix, offres, photos et kit de marque, ou de créer pages et boutiques. Un prix modifié se propage à la page, à l'offre et au panier. Aucun avis, statistique ou certification inventé. Ne publie que sur ordre explicite. captures/02_mcp.*

1.2 Modèle de données réel

Données lues sur la base Supabase de DropMagic avec ta session, en lecture seule. Elles sont dans data/.

Note : la table templates de DropMagic renvoyait aussi des modèles appartenant à d'autres utilisateurs, ce qui est une fuite de données de leur côté. Ces données ont été supprimées de notre disque et ne doivent jamais être utilisées.

1.3 Ce que DropMagic exporte sur Shopify (thème Ysenra 134782386382)


2. Correspondance entre DropMagic et nos briques

Légende : ✅ on l'a, scripté · 🟡 on l'a en partie, ou en SOP manuelle · ❌ manque.

Fonction DropMagic Notre brique existante Statut Ticket
Recherche du produit gagnant (hors DropMagic, via Minea) chasse_orchestrateur.py, product_judge.py, juge_produit_orchestrateur.py ✅ — (point d'entrée amont)
Import produit depuis une URL (AliExpress / Shopify / Amazon) media_downloader.py, searchbyimage_sourcing.py, competitive_researcher.py (morceaux) 🟡 T10
Tri des images du fournisseur (unwanted_image_ids) règle mémoire « contamination images », filtre visuel 🟡 T11
Analyse du concurrent Shopify (structure, style, ton) analyse_concurrent_browser.py, SOP_Analyse_Concurrent_Visuel, journal SneakSafe du 21-22/10 🟡 manuel T12, T13
Avis clients structurés méthode d'extraction des avis AliExpress validée, non scriptée 🟡 T14 (= brique C du plan du 20/10)
4 personas + choix SOP_Copywriting_Avatar (phases 1 à 3) 🟡 manuel T20
4 angles + choix SOP Avatar phase 0.4, porte gate-angle du pipeline page produit 🟡 T21
Nom de marque et disponibilité SOP Avatar phase 4 (noms), vérification de disponibilité absente 🟡 / ❌ T22
Kit de marque (palette 11 nuances, polices, voix, direction photo) aucun objet structuré, réglages faits à la main dans le thème ❌ T23
Structure de rédaction (voix, positionnement, rôle des sections) SOP_Creation_Fiche_Produit, phase 2 du pipeline 🟡 texte libre, pas de JSON T24
Plan de page (choix et ordre des sections) méthode « bibliothèque de sections » du 17/10, non figée 🟡 T25
Rédaction section par section dans les réglages des sections fait à la main (scripts deploy_*sneaksafe*.py, propres à un seul produit) 🟡 T26
Studio d'images (packshot, lifestyle, infographie, « inspiration ») skills lifestyle, vue en coupe, comparaison, galerie Hero ; catalogue des modèles fal.ai ✅ (à brancher) T40-T42
Bibliothèque de sections (58) 32 sections dm-* déjà dans le thème 🟡 32 sur 58 T30, T80-T8x
Composition du template Shopify JSON upload_sneaksafe_templates.py, deploy_draft_product_page.py (propres à un seul produit) 🟡 T31-T33
Thème visuel global (couleurs, polices, boutons) correction manuelle de dropmagic-style.liquid le 22/10 ❌ automatisé T34
Offres par quantité et panier deploy_kaching_sneaksafe_offers.py, shopify_create_bundles_sneaksafe.py (Kaching) 🟡 T50, T51
Page d'accueil générée index.sneaksafe.json fait à la main, SOP_Rebranding_Boutique_Shopify 🟡 T35
Page d'avis absente (règle d'honnêteté : aucun faux avis) ❌ volontairement T36 (seulement avec de vrais avis)
Aperçu et prévisualisation lien de preview en colonne V du Tracker ✅ T33
Contrôle qualité avant publication skill audit-prelancement-site ; test du parcours d'achat absent 🟡 T60, T61, T62
Publication portes gate-prelaunch (Telegram), Shopify CLI ou Admin API ✅ T63
Historique des versions et annulation sauvegardes de thème au cas par cas 🟡 T32 (versionnement automatique)
MCP d'édition en langage naturel serveur MCP Jarvis (tools/registry.py, jarvis_mcp_server.py) 🟡 socle prêt T70
Orchestration de bout en bout orchestrateur/orchestrator.py (graphe), pipelines/pipeline_gate.py, boutique_orchestrateur.py (prévu, pas construit) 🟡 T01-T03
Campagne publicitaire (hors DropMagic, bonus de notre côté) skill creer-campagne, Studio Pub ✅ branchement en aval

Conclusion :
- On a déjà les briques de contenu : chasse, Juge, sourcing, visuels, publicité, audit.
- Il manque deux choses :
- les objets intermédiaires structurés en JSON, qui rendent le chaînage déterministe : personas, angles, kit de marque, structure de rédaction, plan de page ;
- le compositeur de template : sections + réglages, puis génération du JSON Shopify, puis envoi sur le thème.

C'est exactement là que l'étape 6 (construction du site) a bloqué les 21-22/10 : on modifiait des fichiers JSON à la main, produit par produit.


3. Architecture cible

3.1 Arborescence

C:\ASSISTANT_IA\usine_boutique\
  README.md                      # comment lancer, comment reprendre
  config.yaml                    # modèles par étape, boutique cible, thème staging, langue, mode
  usine_boutique\
    __main__.py                  # CLI : run / resume / status / step / edit
    state.py                     # lecture/écriture pipelines/<slug>/state.json (verrou fichier)
    graph.py                     # graphe des étapes (dépendances), exécution étape par étape, reprise
    llm.py                       # couche unique d'appel IA (Gemini / Claude / OpenRouter) + validation JSON
    schemas\                     # schémas Pydantic = contrats entre étapes (section 4)
    steps\
      e01_lecture_produit.py
      e02_tri_images.py
      e03_analyse_concurrent_scrape.py
      e04_analyse_concurrent_vision.py
      e05_avis.py
      e10_personas.py
      e11_angles.py
      e12_nom_marque.py
      e13_brand_kit.py
      e14_strategie_copy.py
      e15_plan_page.py
      e16_redaction_sections.py
      e20_visuels.py
      e30_offres.py
      e40_composition_template.py
      e41_theme_style.py
      e42_accueil.py
      e50_push_staging.py
      e60_qa.py
      e70_publication.py
    shopify\
      admin.py                   # REST/GraphQL : assets de thème, produits, fichiers, remises
      catalogue.py               # lit le schéma de chaque section Liquid et produit catalogue/sections.json
      composer.py                # plan de page + textes + images → templates/product.<slug>.json
    prompts\                     # un fichier .md par étape IA (versionné, jamais en dur dans le code)
    catalogue\
      sections.json              # généré (T30) + annotations de rôle (T30b)
      roles.yaml                 # rôles de section : hook, preuve, mode d'emploi, objection, comparaison…
  tests\                         # pytest : un test par étape avec des fixtures (SneakSafe, Eveil Secret)
pipelines\<slug>\state.json      # convention existante, inchangée
pipelines\<slug>\artefacts\      # sorties JSON de chaque étape (produit.json, personas.json, …)

3.2 Règles d'architecture (non négociables)

  1. Une étape lit des JSON et écrit un JSON. Aucune étape n'appelle directement une autre étape. Le graphe (graph.py) décide de l'ordre. Une étape terminée n'est pas rejouée, sauf avec --force.
  2. Chaque sortie d'IA est validée par un schéma Pydantic. En cas d'échec : 2 nouvelles tentatives en renvoyant l'erreur à l'IA, puis l'étape passe en echec dans state.json avec le message. Jamais de sortie partielle acceptée en silence.
  3. Code fixe d'abord. Tout ce qui peut se calculer sans IA est codé : récupération des pages, palette de couleurs, assemblage JSON, envoi sur Shopify, captures d'écran. L'IA n'intervient que pour juger ou écrire.
  4. Réutiliser, ne pas recopier. Les outils existants (tools/*.py, skills) sont appelés comme sous-processus ou importés tels quels. Interdit d'en dupliquer la logique (consigne du workflow_architect).
  5. Portes humaines (pipelines/pipeline_gate.py, Telegram) : gate-persona-angle, gate-plan-page (mode supervise seulement), gate-prelaunch (toujours, quel que soit le mode, règle absolue).
  6. Honnêteté : interdit d'inventer avis, notes, nombre de clients, statistiques, certifications ou presse (« as seen on »), comme DropMagic lui-même. Un validateur fixe (T27) rejette toute section de ce type qui n'a pas de source dans avis.json ou produit.json.
  7. Jamais d'écriture sur le thème publié. On envoie toujours sur un thème non publié (staging), puis une porte humaine décide de la publication.
  8. Secrets : lus dans C:\ASSISTANT_IA\.env ou PROJET_STUDIO_PUB\studio\.env_fal, jamais écrits dans le code, les logs ou les fichiers d'état.
  9. Langue : contenus, commentaires et logs en français.

3.3 Choix des modèles par tâche

Tous sont configurables dans config.yaml. Le code n'écrit jamais un nom de modèle en dur.

Tâche Outil ou modèle Pourquoi
Récupérer la page produit Shopify concurrente Code fixe : GET https://<boutique>/products/<handle>.js et /products.json (JSON public de toute boutique Shopify), plus le HTML de la page Exact, gratuit, sans IA
Récupérer la page AliExpress Outils existants (media_downloader.py, Playwright avec le profil Chrome dédié) Contenu chargé en JavaScript, protection anti-robot
Captures pleine page du concurrent (ordinateur 1440 px et mobile 390 px) Playwright (sans fenêtre, ou via le Chrome CDP dédié en secours) Entrée pour l'analyse visuelle
Découper la page concurrente en sections (type, ordre, rôle, style) Gemini (multimodal), modèle Flash pour l'extraction, modèle supérieur (Pro/Argon) pour arbitrer en cas de doute Lit les captures, pas seulement le HTML. 7 clés en rotation. Coût faible
Extraire la palette, les polices et le style des boutons Code fixe (styles calculés lus via Playwright : getComputedStyle), Gemini seulement pour nommer le style Valeurs exactes plutôt que devinées
Analyse des photos fournisseur (garder, jeter, image principale) Gemini vision Multimodal
Avis : lecture des captures d'avis AliExpress (photo + texte) Gemini vision (méthode déjà validée) Multimodal
Personas, angles, nom de marque, voix, positionnement Claude (Opus 5.5 / Sonnet via CLI sans interface ou OpenRouter), secours Gemini Meilleure qualité de raisonnement marketing en français
Rédaction de chaque section Claude, secours Gemini Ton, précision, respect de la voix
Plan de page (choix des sections parmi le catalogue) Claude propose, code fixe valide (sections existantes, ordre obligatoire : hero produit d'abord, panier fixe en bas en dernier) La structure est un raisonnement ; la validité est un calcul
Images (packshot, lifestyle, infographie, « inspiration ») fal.ai nano-banana/edit avec la photo produit de référence obligatoire (skills existants), autres modèles selon Catalogue_Modeles_Generation_Visuelle.md Méthode déjà validée en interne
Contrôle visuel final (rendu par rapport au concurrent, défauts, faux texte restant, image cassée) Gemini vision sur les captures du staging Multimodal, peu coûteux
Validation Liquid et JSON MCP shopify-dev validate_theme_codeblocks + validation du schéma par code Officiel

llm.py expose une seule fonction : appeler(etape, prompt_md, variables, schema, images=None) -> objet validé. Le fournisseur est choisi par config.yaml (etapes.e14_strategie_copy.fournisseur: claude) avec une liste de secours. Il réutilise la rotation des clés Gemini déjà en place (GEMINI_KEY_1..7) et ne recrée pas de pool.


4. Contrats de données (schémas Pydantic, dans usine_boutique/schemas/)

Les champs reprennent ceux de DropMagic (section 1.2), pour que les sorties soient comparables.


5. Étapes du pipeline (graphe)

E01 lecture produit ─┬─> E02 tri images ───────────────────────────────┐
                     │                                                 │
E03 scrape concurrent ─> E04 vision concurrent ──┐                     │
E05 avis ────────────────────────────────────────┤                     │
                                                 v                     │
                      E10 personas ─> E11 angles ─> [gate-persona-angle]
                                                 │
                         E12 nom ─> E13 brand kit ─> E14 stratégie copy ─> E15 plan page ─> [gate-plan-page]
                                                                                   │
                                                  E16 rédaction sections <─────────┘
                                                  │            │
                                    E20 visuels <─┘            │
                                    E30 offres                 │
                                         └──> E40 composition template + E41 style + E42 accueil
                                                          │
                                         E50 envoi staging ─> E60 QA ─> [gate-prelaunch] ─> E70 publication

Peuvent tourner en parallèle : E01/E03/E05, puis E20/E30. graph.py utilise le format de orchestrateur/graph_page_produit.json, à étendre, pas à remplacer.


6. Tickets (par lot, dans l'ordre de construction recommandé)

Format de chaque ticket : Entrées → Sorties · Fichiers · Test · Terminé quand.
Une IA qui code prend les tickets dans l'ordre, coche dans usine_boutique/AVANCEMENT.md, et ne passe jamais au suivant si le test du précédent échoue.

LOT 0 — Fondations

LOT 3 — Rendu Shopify (PRIORITÉ : page produit). À faire juste après le lot 0.

LOT 2 — Stratégie et rédaction

LOT 1 — Lecture du produit et du concurrent

LOT 4 — Visuels → DÉLÉGUÉ À L'USINE STUDIO (31/10/2026)

Décision du 31/10 : tout le travail sur les images se fait dans usine_studio/ (débranding, packshots, lifestyle, infographies, animations). L'étape E20 de la boutique lance python -m usine_studio run --slug <slug> --lots 8,1,2 puis lit pipelines/<slug>/medias/manifest.json. Aucun module du studio n'est importé ici. Les tickets T40 à T42 ci-dessous sont remplacés par les lots 8, 1 et 2 du studio et ne sont gardés que comme référence. T43 (envoi dans Shopify Files) reste ici et lit le manifest. Voir la section 6 bis du plan du studio.

LOT 5 — Offres et panier

LOT 6 — Contrôle qualité et publication

LOT 7 — Édition après génération (équivalent du MCP DropMagic)

LOT 8 — Bibliothèque complète (26 sections manquantes) et indépendance

Branchements de bout en bout


7. Critères de réussite globaux

  1. python -m usine_boutique run --produit-url <aliexpress> --concurrent-url <shopify> --mode supervise aboutit à une page produit et une page d'accueil sur le thème de staging, avec 2 portes Telegram en chemin et une porte finale, sans aucune modification JSON à la main.
  2. Le rapport QA ne relève aucun faux texte, aucune image vide, aucune donnée inventée, aucune requête vers dropmagic.
  3. Interrompre puis relancer resume reprend à l'étape exacte.
  4. Remplacer Claude par Gemini dans config.yaml fait toujours tourner le pipeline : aucune dépendance à un seul fournisseur.
  5. Validation visuelle humaine de Raphael sur 2 produits réels (SneakSafe et un produit neuf) avant de considérer l'étape 6 comme figée.

8. Hors périmètre (volontairement)

9. Sources (tout est sur disque)