# 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/`.

- **`stores`** (38 colonnes) : `builder_theme` (thème visuel), `template`, `logo`, `use_dropmagic_header/footer/drawer`, `header_tree`, `publish_selected_pages`, domaines.
- **`pages`** (25 colonnes, 3 pages par boutique : `product`, `home`, `reviews`) :
  - `persona` et `generated_personas` (4 personas : emoji, titre, genre, description) ;
  - `marketing_angle` et `generated_angles` (4 angles : emoji, accroche, cible) ;
  - **`first_generation_copywriting_structure`**, le cœur du système :
    - `brandVoice` : personnalité, style, tons, vocabulaire à utiliser, expressions interdites ;
    - `strategicPositioning` : accroche principale, douleur ciblée, angle de crédibilité, transformation promise, différenciateur ;
    - `sectionRoles` : pour chaque identifiant de section, son rôle et son message clé ;
  - `language`, `additional_prompt`, `strategy` ;
  - `builder_data` : arbre de page au format Craft.js, compressé ;
  - `shopify_template_suffix`.
- **`products`** : `title`, `images`, `main_image`, `options`, `variants` (id, prix, prix barré, options choisies), `original_url`, `original_provider`, `unwanted_image_ids`.
- **`brand_kit`** (53 kits, dont 45 publics et 8 à toi) : `name`, `niche`, `tagline`, `voice` (à faire / à éviter), `photography` (ce qu'il faut / ce qu'il ne faut pas), `theme` (couleurs en 11 nuances, polices, rayons, ombres, boutons, icônes).
- **`builder_theme`** : polices (titre et texte : taille, interlignage, espacement, casse), style de carte, d'icône, de média, de bouton, et palettes `primary/secondary/accent/neutral/danger` en 11 nuances (0 à 10).
- **`shop_discounts`** : `bar_items` (type `quantity-breaks`, quantité, titre, sous-titre, `priceType`, `discountValue`, badges, `isPreselected`), `ui_style`.
- **`builder_history`** : copie complète de chaque version, pour annuler.

> 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`)
- 32 sections : `dm-announcement-banner-1/2`, `dm-faq-1/2`, `dm-features-1`, `dm-features-icons-1/2`, `dm-features-images-1`, `dm-gallery-1`, `dm-header-1`, `dm-footer-2`, `dm-home-hero-1/6`, `dm-how-to-1/1-with-number/2/3`, `dm-icons-banner-1`, `dm-image-text`, `dm-image-text-2`, `dm-product-hero-1/2` (22 types de blocs : variantes, boutons d'achat, Trustpilot, etc.), `dm-product-preview-1`, `dm-reviews-2`, `dm-sticky-atc-1`, `dm-text-banner-1`, `dm-timer-banner-1`, `dm-versus-1`, `dm-cart-drawer`, `dm-cart-icon-bubble`, `dropmagic-style`.
- 14 extraits Liquid réutilisés par ces sections (`snippets/dm-*`) et 13 fichiers JS/CSS (`dm-core.js`, `dm-cart.js`, `dm-product-form.js`, `dm-variant-selects.js`, `dm-swiper.js`, `dropmagic.css`, etc.).
- **Dépendances vers les serveurs DropMagic** :
  - liens d'aide dans les réglages : aucun effet sur la boutique ;
  - 5 images hébergées sur `cdn.dropmagic.ai` (Trustpilot, logos) et quelques vidéos à rapatrier chez nous ;
  - `dm-core.js` : vérification d'abonnement, badge et suivi PostHog, **à neutraliser**.
- Copie locale complète (100 fichiers, 4,5 Mo) : `artifacts/DROPMAGIC_CLONE/theme_ysenra_dm/`. Catalogue des réglages : `theme_ysenra_dm/CATALOGUE_SECTIONS_DM.json`.

---

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

- **`Produit`** : `titre`, `description_source`, `images[] {url, id, gardee: bool, role: principale|galerie|lifestyle|detail}`, `options[] {nom, valeurs[]}`, `variantes[] {id_source, titre, prix, prix_barre, options}`, `prix`, `prix_barre`, `devise`, `url_source`, `fournisseur_source` (aliexpress|shopify|amazon), `caracteristiques[]` (faits vérifiables uniquement).
- **`AnalyseConcurrent`** : `url`, `captures {desktop, mobile}`, `sections[] {ordre, type_detecte, type_catalogue (section dm-* la plus proche), role, resume_contenu, elements_style}`, `style {couleurs_hex[], polices {titre, texte}, boutons {forme, couleur, casse}, densite}`, `ton {registre, exemples_titres[]}`, `offres {quantites[], remises[]}`, `preuves_affichees[] {type, verifiable: bool}`.
- **`Avis`** : `verbatims[] {texte, note, pays, photo_url, source}`, `irritants[]`, `benefices_cites[]`, `questions_frequentes[]`. Vide accepté : on n'invente rien.
- **`Persona`** (×4) : `id`, `emoji`, `titre`, `genre`, `description`. **`Angle`** (×4) : `id`, `emoji`, `accroche`, `cible`.
- **`BrandKit`** : `nom`, `slogan`, `niche`, `voix {a_faire, a_eviter}`, `photographie {est, nest_pas}`, `theme {couleurs {primary, secondary, accent, neutral, danger} chacune {principale, palette[0..10]}, polices {titre, texte, tailles, interlignages, casse_titres}, boutons {style, rayon, casse}, cartes {style}, icones {famille}}`.
- **`StrategieCopy`** (= `first_generation_copywriting_structure`) : `voix_de_marque {personnalite, style, tons[], vocabulaire[], expressions_interdites[]}`, `positionnement {accroche_principale, douleur_cible, angle_credibilite, transformation, differenciateur}`, `roles_sections {id_section: {objectif, message_cle}}`.
- **`PlanPage`** : `page` (product|home), `sections[] {id (10 caractères), type (clé du catalogue), role, raison}`. Contraintes : 6 à 14 sections, `dm-product-hero-*` en premier sur la page produit, `dm-sticky-atc-*` en dernier.
- **`ContenuSection`** : `id`, `type`, `settings {…}` et `blocks {…}`, conformes au schéma de la section dans `catalogue/sections.json` (clés existantes uniquement, types respectés, longueurs maximales), `images_requises[] {cle_setting, brief_visuel}`.
- **`Offres`** : `paliers[] {quantite, titre, sous_titre, type_prix (plein|pourcentage|fixe), valeur, badge, preselectionne}`.
- **`RapportQA`** : `captures`, `defauts[] {gravite, section, description}`, `score_visuel`, `parcours_achat_ok`, `faux_texte_restant`, `images_cassees`, `liens_morts`.

---

## 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
- **T01 Squelette et CLI.** → `usine_boutique/` (arborescence 3.1), `python -m usine_boutique status --slug X`. Test : `pytest tests/test_cli.py`. Terminé quand `run`, `resume`, `status` et `step <id>` répondent, même si les étapes sont vides.
- **T02 `state.py` + `graph.py`.** Entrées : définition du graphe en JSON. Sorties : `pipelines/<slug>/state.json` au même format que les pipelines existants (`phases[].statut`: a_faire|en_cours|fait|echec|attente_porte, `journal[]` horodaté en UTC-4). Reprise après interruption. Verrou fichier pour éviter deux exécutions en même temps. Test : interrompre au milieu d'une étape, relancer `resume`, l'étape repart seule et les étapes déjà faites ne sont pas rejouées.
- **T03 `llm.py`.** Fournisseurs gemini / claude / openrouter, sortie JSON validée par Pydantic, 2 nouvelles tentatives avec l'erreur, journal du coût et de la durée par appel dans `artefacts/llm_log.jsonl` (sans les secrets). Test : un schéma volontairement impossible déclenche les 2 tentatives puis passe l'étape en `echec`.
- **T04 Portes.** Branchement sur `pipelines/pipeline_gate.py` avec 3 portes (`gate-persona-angle`, `gate-plan-page`, `gate-prelaunch`). Modes `supervise`, `autonome` (le pipeline choisit seul persona et angle, et note sa raison), `autonome_total`. `gate-prelaunch` est toujours bloquante. Test : en mode `autonome`, le pipeline s'arrête quand même à `gate-prelaunch`.
- **T05 `config.yaml` + lecture des secrets.** Boutique, thème de staging (`138374709454` « Staging - bemsv (CRO) », ou un nouveau thème dédié créé par T50), langue, modèles par étape, plafonds de coût. Test : un secret manquant donne un message clair, pas une erreur Python illisible.

### LOT 3 — Rendu Shopify (PRIORITÉ : page produit). À faire juste après le lot 0.
- **T30 Catalogue des sections.** `shopify/catalogue.py` lit chaque `sections/*.liquid` (local, ou depuis le thème par API) et extrait le `{% schema %}`. Sortie : `catalogue/sections.json` avec, pour chaque section : type, nom, réglages (id, type, valeur par défaut, options, limite), blocs (type, réglages, nombre maximal), emplacements d'image, de vidéo, de texte riche et de bouton. Base de départ : `artifacts/DROPMAGIC_CLONE/theme_ysenra_dm/CATALOGUE_SECTIONS_DM.json` (32 sections). Test : 32 sections lues, aucune erreur de lecture du JSON.
- **T30b Annotation des rôles.** Fichier `catalogue/roles.yaml` écrit **à la main ou par IA, puis relu une fois** : rôle (`hero_produit`, `reassurance`, `benefices`, `mode_emploi`, `comparaison`, `preuve_sociale`, `faq`, `urgence`, `galerie`, `bandeau`, `cta_fixe`), longueur conseillée des textes, nombre d'images, et à quel élément de la `StrategieCopy` la section sert. C'est ce que lira l'IA pour composer le plan de page. Terminé quand chaque section du catalogue a un rôle.
- **T31 Compositeur.** `shopify/composer.py` : `PlanPage` + `ContenuSection[]` + images envoyées → `templates/product.<slug>.json` au format JSON des templates Shopify (`sections {id: {type, settings, blocks, block_order}}`, `order[]`). Les réglages absents prennent la valeur par défaut du catalogue. Les clés inconnues **font échouer** l'étape, elles ne sont jamais ignorées. Test : reconstruire `product.sneaksafe.json` à partir de ses propres données donne un JSON identique (test aller-retour).
- **T32 Envoi et versionnement.** `shopify/admin.py` : avant tout envoi, sauvegarde de l'ancienne version (`theme_backups/<theme>/<horodatage>/<clé>`), puis `PUT` de l'asset sur le **thème de staging uniquement** (refus en dur si `role == main`). Validation par le MCP `shopify-dev` si disponible. Test : un envoi suivi d'une restauration redonne l'état d'origine.
- **T33 Rattacher le produit et l'aperçu.** Produit en brouillon : `templateSuffix = <slug>` (GraphQL `productUpdate`), lien d'aperçu du thème de staging écrit en colonne V du Tracker (règle existante). Test : l'URL d'aperçu renvoie HTTP 200 et contient le titre généré.
- **T34 Style global depuis le kit de marque.** `BrandKit.theme` → réglages du thème et **réécriture des variables CSS de `sections/dropmagic-style.liquid`** (les 11 nuances y sont codées en dur, bug trouvé le 22/10). Palette 0..10 calculée par code à partir de la couleur principale (mélange en espace OKLCH). Test : après envoi, la couleur calculée d'un bouton de l'aperçu correspond à la couleur `primary`.
- **T35 Accueil.** Même mécanique que T31 pour `templates/index.<slug>.json` (hero d'accueil, aperçu produit, bandeaux, FAQ), puis rebranding des menus avec `SOP_Rebranding_Boutique_Shopify` (réutilisé). Test : capture de l'accueil sans faux texte ni nom de l'ancien produit.
- **T36 Page d'avis.** Créée **seulement** si `Avis.verbatims` est non vide (vrais avis sourcés). Sinon l'étape est sautée et le motif noté dans le journal.
- **T37 Neutraliser `dm-core.js`.** Version propre : retirer la vérification d'abonnement, le badge, PostHog et le suivi de provenance ; garder ce qui sert vraiment (si le fichier ne sert qu'au badge, le retirer de `theme.liquid`). Rapatrier les images et vidéos `cdn.dropmagic.ai` dans Shopify Files et remplacer les URL. Test : aucune requête vers un domaine `dropmagic` sur l'aperçu (vérifié dans le journal réseau Playwright).
- **Validation du lot 3 (premier jalon visible pour Raphael)** : à partir du texte SneakSafe déjà rédigé, un plan de page écrit à la main en JSON génère, envoie et affiche la page sur le staging, en une seule commande. Captures envoyées sur Telegram.

### LOT 2 — Stratégie et rédaction
- **T20 Personas.** Entrées : `produit.json`, `avis.json`, `analyse_concurrent.json`. Prompt : `prompts/e10_personas.md`, qui reprend les phases 1 à 3 de `SOP_Copywriting_Avatar` (lire le SOP et en extraire les règles, ne pas l'inventer). Sortie : 4 `Persona`. Test : 4 personas distincts (pas deux fois la même cible).
- **T21 Angles** : 4 `Angle`, chacun rattaché au persona retenu, puis la porte `gate-persona-angle` (Telegram : 4 + 4 propositions numérotées, réponse « P2 A3 »).
- **T22 Nom de marque et disponibilité** : 5 noms (SOP Avatar phase 4), puis **vérification réelle** par code (DNS / WHOIS du `.com` et du `.fr`, recherche de marque déposée en base publique quand elle est accessible), puis classement. C'est une brique manquante déjà identifiée le 21/10.
- **T23 Kit de marque** : voix (à faire / à éviter), direction photo (ce qu'il faut / ce qu'il ne faut pas), polices (liste fermée de Google Fonts compatibles avec le thème), couleur principale. La palette est calculée par code (T34). Les 45 kits publics de DropMagic (`data/brand_kit.json`) servent d'**exemples de format** dans le prompt, jamais copiés tels quels.
- **T24 Stratégie de rédaction** → `StrategieCopy` (voix de marque, positionnement, et rôle de chaque section rempli après T25).
- **T25 Plan de page** : l'IA choisit 6 à 14 sections dans `catalogue/sections.json` + `roles.yaml`, en s'appuyant sur la structure du concurrent (`AnalyseConcurrent.sections[].type_catalogue`) et sur la stratégie. Validation par code (sections existantes, ordre obligatoire, pas deux fois la même section sauf bandeau). Porte `gate-plan-page` en mode supervisé (capture des vignettes dans l'ordre).
- **T26 Rédaction par section** : une requête IA **par section**, avec en contexte uniquement la stratégie, le rôle de la section, son schéma de réglages, les faits produit et les avis. Sortie : `ContenuSection` validé (longueurs, clés). Les règles de copywriting en mémoire s'appliquent : un bénéfice ou une solution par section, pas le problème présenté négativement ; honnêteté avant persuasion.
- **T27 Garde-fou d'honnêteté (code fixe)** : rejette les notes, nombres d'avis, « +1500 clients », Trustpilot, « vu à la TV », certifications et pourcentages chiffrés dont la source ne figure pas dans `produit.json` ou `avis.json`. Exemple réel : la page Eveil Secret générée par DropMagic affichait « 4.8/5 sur +1500 avis Trustpilot » sans source. Test : une section contenant « 4.8/5 » sans avis est rejetée.

### LOT 1 — Lecture du produit et du concurrent
- **T10 Lecture produit** : URL Shopify, via `products/<handle>.js` (code fixe) ; URL AliExpress, via les outils existants et Playwright (profil Chrome dédié, **jamais de taskkill global de Chrome**) ; URL Amazon, en option. → `produit.json`. Test : la fixture Eveil Secret renvoie les variantes, prix et images corrects.
- **T11 Tri des images** : Gemini vision classe chaque image (principale, galerie, à jeter : logo vendeur, texte chinois illisible, autre produit). Règles mémoire : **ne pas** jeter pour un filigrane, la langue ou la couleur ; **jeter** les images d'un autre produit (contamination).
- **T12 Récupération du concurrent** : `.js` + HTML + captures pleine page (ordinateur et mobile), et styles calculés (couleurs, polices, boutons) lus dans la page → `artefacts/concurrent/`. Doit refuser proprement une URL non Shopify, comme DropMagic.
- **T13 Analyse visuelle du concurrent** : Gemini découpe les captures en sections ordonnées et associe chacune à la section du catalogue la plus proche (`type_catalogue`), en indiquant si la correspondance est exacte ou approximative. Sert d'**inspiration de structure et de style uniquement** : aucun texte ni image du concurrent n'est repris (règle déjà actée le 21/10).
- **T14 Avis structurés** : script de la méthode validée (Gemini vision sur les captures d'avis AliExpress) → `avis.json`. C'est la brique C du plan du 20/10.

### LOT 4 — Visuels
- **T40 Liste des visuels** : pour chaque `ContenuSection.images_requises`, une fiche (rôle, cadrage, décor) qui respecte `BrandKit.photographie`.
- **T41 Génération** : appel des **skills existants**, sans les réécrire :
  - `construire-galerie-hero-produit` (galerie du haut) ;
  - `creer-scene-lifestyle-produit` (lifestyle) ;
  - `creer-image-comparaison-texte` (sections comparaison et versus) ;
  - `creer-vue-coupe-animation-produit` (infographie, mécanisme) ;
  - photo produit de référence obligatoire, sinon le produit dérive.
- **T42 Fonction « Inspiration »** (équivalent du Studio DropMagic) : image modèle + photo produit → nano-banana/edit, puis contrôle par Gemini (fidélité au produit, max 3 essais, grille de jugement visuel existante).
- **T43 Envoi des images** dans Shopify Files (GraphQL `fileCreate`), puis injection des `shopify://shop_images/...` dans les réglages des sections.

### LOT 5 — Offres et panier
- **T50 Offres par quantité** : `Offres` (par défaut 1 / 2 / 3 avec les remises définies dans `config.yaml`) → **réutiliser** `deploy_kaching_sneaksafe_offers.py` / `shopify_create_bundles_sneaksafe.py` en les **généralisant** (paramètre `--slug`, pas de copie). Vérifier si le bloc d'offres de `dm-product-hero` dépend de l'app DropMagic. Si oui, rester sur Kaching. Test : panier à 2 unités, remise appliquée au paiement.
- **T51 Panier** : `dm-cart-drawer` (s'il fonctionne sans l'app) ou le panier natif du thème. Test : ajout au panier, tiroir panier, passage au paiement sans erreur JS.
- **T52 Cohérence des prix** : un prix change à un seul endroit (`produit.json`), puis la variante Shopify, le texte de prix, les offres et le panier fixe se recalculent. C'est l'équivalent de « Prix, offres et panier restent liés » chez DropMagic.

### LOT 6 — Contrôle qualité et publication
- **T60 Captures du staging** : ordinateur et mobile, pleine page, plus le journal réseau (erreurs JS, 404, domaines `dropmagic`).
- **T61 Contrôle automatique** : faux texte restant (`Lorem`, `ipsum`, `[Benefits]`), images vides (`image_media: ""`), nom de l'ancien produit, liens morts, plus le skill `audit-prelancement-site`.
- **T62 Test du parcours d'achat (Playwright)** : accueil, page produit, choix d'une variante, offre, ajout au panier, paiement (s'arrêter à la page de paiement Shopify). C'est la brique « à construire » du 21/10.
- **T63 Juge visuel Gemini** : notre capture comparée à celle du concurrent (structure, finition), défauts classés par gravité dans `RapportQA`. Un défaut critique bloque la porte.
- **T64 `gate-prelaunch`** : Telegram avec les captures, le lien d'aperçu et le rapport QA. Publication (rattachement du template sur le thème publié, produit ACTIVE) **seulement** après réponse explicite de Raphael. Rapport final sur Telegram.

### LOT 7 — Édition après génération (équivalent du MCP DropMagic)
- **T70 Outil MCP `usine_boutique`**, enregistré dans `tools/registry.py` (procédure existante `creer_outil_mcp.py`), avec les opérations : `statut`, `regenerer_section(slug, id, consigne)`, `changer_prix(slug, prix)` (propagation T52), `remplacer_image(slug, id, brief)`, `changer_angle(slug, angle)` (relance E14 à E16), `ajouter_section(slug, type, position)`, `annuler(slug, version)`. Chaque opération passe par le staging, puis le QA, puis une porte. Permet à Jarvis de dire « Réécris la FAQ de SneakSafe » en langage naturel.

### LOT 8 — Bibliothèque complète (26 sections manquantes) et indépendance
- **T80 Sections manquantes** (vignettes de référence dans `captures/bibliotheque_sections/`) : `compare-table-1/2`, `before-after-1/2/3`, `versus-2`, `testimonials-1/2/3`, `reviews-1`, `reviews-inline`, `about-us-review-1`, `stats-medias-2/3`, `as-seen-on-1/2` (**uniquement avec de vraies retombées presse**), `gallery-2`, `faq-3/4`, `features-2/3`, `features-card-1`, `features-number-1`, `features-icons-3`, `home-hero-2/3/4`, `product-hero` (variante 3), `announcement-banner-3/4`, `sticky-add-to-cart-2/3`, `product-preview-2`, `how-to-2/3` (sans numéro).
  - Chaque section est écrite en Liquid **selon nos propres conventions** : préfixe `ub-` pour « usine boutique », mêmes variables CSS que `dropmagic-style` pour rester compatible, `{% schema %}` complet, rendu mobile en premier.
  - Chaque section est validée par `shopify-dev`.
  - Elle est ajoutée au catalogue (T30) automatiquement.
- **T81 Réécriture progressive des sections `dm-*` en `ub-*`** pour ne plus dépendre du code DropMagic (licence) : une section par ticket, en gardant les mêmes clés de réglages pour que les templates déjà générés restent valides.
- **T82 Thème de base propre** (« Usine Base ») : à partir du thème Ysenra, débarrassé des templates d'anciens produits et des fichiers `-axia` / `-claude-overlay`. Il devient le thème de départ de chaque nouvelle boutique (envoyé par Shopify CLI sur une nouvelle boutique créée à la main ; la création de boutique, la facturation et le domaine restent manuels).

### Branchements de bout en bout
- **T90** : `boutique_orchestrateur.py` (prévu depuis le 20/10) appelle `usine_boutique run` pour chaque produit validé par le Juge, puis enchaîne vers le skill `creer-campagne`.
- **T91** : skill `.claude/skills/creer-page-produit/SKILL.md` **mis à jour** pour déléguer l'étape 6 à `usine_boutique` (autorisation permanente sur la mécanique d'orchestration).
- **T92** : surveillance. Le pipeline est un programme lancé à la demande, pas un processus permanent. Reprise par le `pipeline_watch_pulse.py` existant. Si un mode « file d'attente » permanent est ajouté plus tard, appliquer la règle 16 (sentinelle, heartbeat, disjoncteur, lanceur VBS, `fast_check_daemons.py`, alerte Telegram).

---

## 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)
- Création de boutique Shopify, abonnement, facturation, domaine : manuel (risque financier et juridique).
- Colonnes T/U du Tracker : réservées à Raphael.
- Toute publication ou tout lancement : porte humaine obligatoire.
- Copie de textes ou d'images d'un concurrent : interdit. Structure et style seulement.

## 9. Sources (tout est sur disque)
- `artifacts/DROPMAGIC_CLONE/captures/` : captures du tableau de bord, de la page MCP, de l'éditeur, des panneaux Stratégie et Studio, de la bibliothèque (57 vignettes + `sections_index.json`), du flux de création de juin 2026 et du paiement.
- `artifacts/DROPMAGIC_CLONE/data/` : `stores.json` (sans jetons Shopify), `pages.json` (24 pages : personas, angles, stratégies), `products.json`, `brand_kit.json`, `shop_discounts.json`, `builder_history_index.json`.
- `artifacts/DROPMAGIC_CLONE/theme_ysenra_dm/` : 32 sections, snippets, assets, 19 templates `magic`, `CATALOGUE_SECTIONS_DM.json`.
- `tools/dropmagic_recon/` : scripts de relevé (lecture seule). Le jeton de session temporaire a été supprimé ; `creds.py` le régénère au besoin (Chrome dédié connecté).
- Travaux antérieurs repris : `ANALYSE_FAISABILITE_AUTOMATISATION_COMPLETE_CREATION_BOUTIQUES_20261020.md`, `PROJET_AUTOMATISATION_CREATION_SITES_WEB/` (inventaire des 36 outils, journal de méthode SneakSafe 21-22/10), `DOSSIER_PLAN_AUTOMATISATION_BOUTIQUE/`.
