Généré le 14/10/2026 21:31

SOP - Architecture de Classement & Centralisation des Dossiers Produits

Version : 1.0 (14/10/2026)
Statut : Officiel & Opérationnel
Auteur : Antigravity / Jarvis System
Emplacement : C:\Users\lisa\.gemini\antigravity\knowledge\SOP_Gestion_Dossiers_Produits\artifacts\SOP_Architecture_Classement_Produits.md
Outils associés : C:\ASSISTANT_IA\tools\automatiser_classement_produits.py & C:\ASSISTANT_IA\tools\gestion_produits_dossiers.py


🎯 1. Contexte & Objectifs

Dans l'écosystème e-commerce autonome de Raphaël, chaque produit passe par plusieurs phases séquentielles menées par différents agents et scripts :
1. Recherche & Validation : Chasse Minea, sourcing visuel AliExpress/1688, arbitrage par le Juge Produit.
2. Stratégie & Copywriting : Définition de l'Avatar Client, angles marketing, prompts d'images/vidéos, fiches produits.
3. Création Médias : Studio Pub (Porte A recycle / Porte B create), publicités statiques haute définition, voix off, contrôle qualité vidéo.
4. Intégration Boutique : Fiches produits Shopify (SteelFlex), pages HTML dédiées (produit.html), avis clients scrapés, formulaires de commande.
5. Acquisition & Analyse : Campagnes Meta Ads, audits CRO, métriques de rentabilité.

Sans structure stricte, les fichiers finissent dispersés entre artifacts/, scratch/, pipelines/, PROJET_STUDIO_PUB/ et des sous-dossiers disparates.

Objectif de la présente SOP : Établir une architecture standardisée, chronologique, souveraine et pérenne, centralisant 100 % des actifs d'un même produit dans C:\ASSISTANT_IA\PRODUITS\<slug-produit>\.


🏛️ 2. L'Arborescence Canonique des 5 Piliers

Chaque produit dispose obligatoirement de son dossier racine nommé selon son slug officiel (kebab-case).
L'arborescence est préfixée par des numéros d'ordre pour assurer un classement chronologique et alphabétique parfait :

C:\ASSISTANT_IA\PRODUITS\<slug-produit>\
│
├── 00_INDEX.md                           # Fiche d'identité synthétique du produit
│
├── 01_Rapports/                          # 📊 Audits, sourcing, validation et veille
│   ├── 01_Sourcing/                      # Fiches fournisseurs (AliExpress, 1688, Taobao), fiches techniques
│   ├── 02_Juge_Produit/                  # Verdicts du Juge Produit, scoring 7 filtres, rapports HTML
│   ├── 03_Concurrence/                   # Ads Library Facebook concurrentes, benchmarks Amazon/Google
│   └── 04_Analytics_CRO/                 # Audits CRO, métriques Business Manager & Shopify (post-lancement)
│
├── 02_Scripts/                           # ✍️ Copywriting, stratégie marketing et prompts IA
│   ├── 01_Strategie_Avatar/              # Persona/avatar client, douleurs, désirs profonds, angles marketing
│   ├── 02_Copywriting_Boutique/          # Titres SEO, bullet points bénéfices, description longue, FAQ
│   ├── 03_Publicites/                    # Scripts publicitaires (vidéos UGC, hooks 3s, scripts VO, briefs)
│   └── 04_Prompts_Generateurs/           # Prompts Fal.ai/NanoBanana, Kling, Seedance, ElevenLabs
│
├── 03_Medias/                            # 🎨 Actifs visuels et sonores (séparation stricte sources vs validés)
│   ├── 01_Sources_Brutes/                # Photos et vidéos brutes non retouchées (fournisseur, concurrents)
│   ├── 02_Photos_Validees/               # Visuels détourés, bannières Lifestyle, vue en coupe, galerie Hero
│   ├── 03_Videos_Validees/               # Publicités vidéo finales validées par QA (9:16 vertical, 1:1)
│   ├── 04_Publicites_Statiques/          # Créatives statiques finales capturées en haute résolution (HTML->PNG)
│   └── 05_Audio_Voix/                    # Voix off ElevenLabs/Edge-TTS, bandes sons, pistes isolées (Demucs)
│
├── 04_Boutique_Site/                     # 🛍️ Intégration web et éléments techniques
│   ├── 01_Code_Pages/                    # Landing pages autonomes HTML/CSS/JS (produit.html) ou templates Shopify
│   ├── 02_Avis_Clients/                  # Extractions d'avis réels (textes traduits + photos clients pour Loox)
│   └── 03_Donnees_Techniques/            # Scripts SQL Supabase, schémas de base de données, webhooks, tracking
│
└── 99_Archives_Brouillons/               # 🗄️ Chutes de montage, variantes rejetées, tests temporaires

🏷️ 3. Système Souverain de Codification & Nommage

3.1. Le Code Produit Souverain (Master SKU)

Chaque produit se voit attribuer un identifiant unique, souverain et immuable respectant le standard :
PRD-<CAT3>-<NUM3>-<NOM_ORIGINAL>
- PRD : Préfixe produit universel.
- <CAT3> : Trigramme de catégorie normalisé :
- HLT : Santé, Posture, Sommeil, Soin (Health & Wellness)
- HOM : Maison, Ergonomie, Confort (Home & Comfort)
- GAR : Potager, Hydroponie, Jardin (Garden & Nature)
- PET : Animaux, Litière, Toilettage (Pet Care)
- BEA : Beauté, Cosmétique, Anti-âge (Beauty & Care)
- KID : Enfants, Éveil, Montessori (Kids & Toys)
- KIT : Cuisine, Ustensiles, Conservation (Kitchen)
- TEC : Gadgets, Électronique, Accessoires (Tech & Smart)
- CLN : Nettoyage, Entretien, Buanderie (Cleaning)
- SPT : Sport, Fitness, Mobilité (Sport & Fitness)
- <NUM3> : Numéro d'ordre séquentiel (001, 002, 003...) évitant toute collision entre deux produits d'une même catégorie.
- <NOM_ORIGINAL> : Nom de marque ou néologisme inventé (4 à 10 lettres majuscules), 100% original.

3.2. Garde-Fous & Interdictions Formelles (Règles d'Or)

  1. 🚫 Interdiction Formelle des Anciens Noms :
    Il est strictement interdit d'utiliser ou de réutiliser l'ancien nom du produit concurrent ou d'origine (ex: interdiction absolue de dentalpod, dental-pod, skovasken, auk, petpivot, tystrap).
  2. 🚫 Interdiction Formelle des Noms d'Outils & Technologies :
    Il est strictement interdit de nommer un produit ou un dossier avec un nom d'outil, de modèle IA, de librairie ou de technologie existante (ex: interdiction absolue de flux, stripe, kling, elevenlabs, gemini, claude, antigravity, shopify, meta, vmake, etc.).
  3. 🚫 Interdiction des Termes Purement Génériques :
    Les termes isolés ambigus (coussin, sac, livre, lampe, collier) sont proscrits. Tout produit doit posséder une identité souveraine distinctive et unique (ex: PRD-HOM-001-ORTOFLEX au lieu de coussin-gel).

3.3. Codification Univoque des Fichiers par Pilier

Tous les fichiers produits doivent permettre une identification sans ambiguïté :
- Fichiers Médias (03_Medias) :
<slug_court>_<type>_<variante>[_<format>].<ext>
Exemples :
- hlt001revivecare_pub-vid_v01-hook-douleur_9x16.mp4
- hom001ortoflex_hero-ls_banniere_1920x1080.webp
- hlt002sonivibe_pub-vid_v01-demo-gouttiere_9x16.mp4
- hlt001revivecare_voixoff_ad01_elevenlabs.mp3
- Documents & Scripts Datés (02_Scripts) :
YYYYMMDD_<slug_court>_<sous_type>_<variante>.md
Exemples :
- 20261014_hlt001revivecare_avatar_femme-active-teletravail.md
- 20261014_hlt001revivecare_script-pub_v01-hook-douleur-cou.md
- Rapports & Audits (01_Rapports) :
YYYYMMDD_<slug_court>_<sous_type>_<variante>.[html|md]
Exemples :
- 20261014_hlt001revivecare_juge-produit_verdict-7filtres.html
- 20261014_hom001ortoflex_sourcing_comparatif-fournisseurs.md
- Registre Central des Produits :
L'intégralité des codes, métadonnées, statuts et alias de réconciliation est conservée dans C:\ASSISTANT_IA\PRODUITS\00_REGISTRE_MASTER.json et pilotée par tools/systeme_nommage_produits.py.


🔄 4. Synchronisation avec l'Écosystème Jarvis

flowchart TD
    subgraph "Sourcing & Chasse"
        A["Minea / AliExpress / 1688"] --> B["Juge Produit (Tribunal)"]
    end

    subgraph "Hub Temps Réel Jarvis"
        B --> C["C:\\ASSISTANT_IA\\artifacts\\<br/>(Servi en HTTP /artifacts pour Jarvis UI)"]
        C -. "Synchronisation automatique" .-> D
    end

    subgraph "Coffre-Fort Produit Souverain"
        D["C:\\ASSISTANT_IA\\PRODUITS\\<slug>\\"]
        D --> D1["01_Rapports/02_Juge_Produit/"]
        D --> D2["02_Scripts/ (Avatar, Copy, Pubs)"]
        D --> D3["03_Medias/ (Photos, Vidéos, Audio)"]
        D --> D4["04_Boutique_Site/ (HTML, Avis, SQL)"]
        D --> D5["99_Archives_Brouillons/"]
    end

    subgraph "Production Créative"
        E["PROJET_STUDIO_PUB"] -->|Livrables validés| D3
        F["Générateurs Fal.ai / Kling"] -->|Livrables validés| D3
    end

Règle d'Or de Coexistence artifacts/ vs PRODUITS/ :

  1. L'affichage dans l'interface Jarvis exige artifacts/ : Tout script ou mission qui génère un rapport de fin de mission destiné à être cliqué par Raphaël dans la carte Jarvis doit écrire le fichier HTML dans C:\ASSISTANT_IA\artifacts\.
  2. La persistance patrimoniale exige PRODUITS/ : Le dossier PRODUITS/<slug>/ est le coffre-fort complet. La commande python tools/gestion_produits_dossiers.py sync-rapports --apply veille à dupliquer ou lier les rapports pertinents vers 01_Rapports/02_Juge_Produit/.

🛠️ 5. Mode d'Emploi de la Boîte à Outils CLI

5.1. Moteur de Nommage & Codification (tools/systeme_nommage_produits.py)

# 1. Générer et enregistrer un nouveau code produit souverain (100% original)
python tools/systeme_nommage_produits.py generer-code --cat HOM --nom ORTOFLEX --desc "Coussin ergonomique gel nid d abeille"

# 2. Tester l'originalité d'un nom (rejet formel de 'dentalpod', 'flux', 'stripe', 'coussin')
python tools/systeme_nommage_produits.py valider-nom --nom SONIVIBE

# 3. Résoudre un terme ambigu ou ancien nom vers son code officiel
python tools/systeme_nommage_produits.py resoudre --terme "coussin"

# 4. Obtenir le nom de fichier canonique normalisé
python tools/systeme_nommage_produits.py codifier-fichier --code PRD-HOM-001-ORTOFLEX --pilier medias --type pub-vid --variante hook-douleur --format 9x16 --ext mp4

5.2. Gestionnaire Opérationnel des Dossiers (tools/gestion_produits_dossiers.py)

# 1. Créer l'arborescence d'un nouveau produit validé
python tools/gestion_produits_dossiers.py init prd-hom001-ortoflex --nom "ORTOFLEX (Coussin Ergonomique en Gel)" --statut "Validé" --prix-achat "9.80" --prix-vente "34.90"

# 2. Auditer la conformité de l'ensemble des dossiers
python tools/gestion_produits_dossiers.py audit

# 3. Standardiser un dossier existant avec jonctions NTFS
python tools/gestion_produits_dossiers.py standardiser prd-hom001-ortoflex --apply

# 4. Synchroniser tous les rapports d'audit orphelins vers les dossiers produits
python tools/gestion_produits_dossiers.py sync-rapports --apply

🛡️ 6. Rétrocompatibilité & Garde-Fous

Pour éviter de rompre d'anciens scripts (tools/, PROJET_STUDIO_PUB/) ou des fichiers d'état historiques (pipelines/<slug>/state.json) qui référencent encore des chemins de type images-validees/ ou docs/, l'outil de standardisation crée automatiquement des jonctions de répertoires NTFS Windows (mklink /J).
Ainsi, l'ancien chemin pointe de manière transparente et sans surcoût disque vers le nouveau dossier standardisé (03_Medias/02_Photos_Validees/).