Date : 14 Octobre 2026 — 21:22 AST (Heure Locale Guadeloupe UTC-4)
Statut : Livré, Opérationnel & Validé à 100%
Auteur : Antigravity / Jarvis System
Rapport Interactif HTML : Ouvrir le Rapport HTML (Interface Jarvis)
SOP Officielle Référencée :SOP_Codification_Nommage_Fichiers.md
Outil Opérationnel Développé :tools/codification_nommage.py
Architecture Mère :SOP_Architecture_Classement_Produits.md
Dans le cadre de l'autonomisation complète du système e-commerce de Raphaël, la manipulation quotidienne de centaines de médias, scripts et rapports requiert une rigueur absolue de nommage.
L'audit direct des 17 dossiers sous C:\ASSISTANT_IA\PRODUITS\ (regroupant plus de 513 fichiers d'actifs réels) a mis en évidence trois vulnérabilités critiques :
1. Noms informels et orphelins : Des fichiers tels que benefit1_combo_v3.mp4, frame_hero_v2_start.jpg, clean_product_white_v1.png ou ad_briefs.md ne contiennent aucun identifiant produit. S'ils sont déplacés ou extraits de leur sous-dossier, ils deviennent totalement anonymes.
2. Ambiguïté fatale des noms génériques : Dans le dropshipping, de nombreux produits chassés n'ont pas de marque propre ("Coussin Ergonomique en Gel", "Correcteur de Posture", "Sac de lavage baskets"). Dès lors qu'un second produit similaire arrive, les noms génériques (coussin.jpg, ad1.mp4, script_v2.md) entrent en collision frontale et s'écrasent mutuellement.
3. Impossibilité de parsing déterministe : Les automates et démons résidents (classement_produits_daemon.py, jarvis_inbox_engine.py) étaient contraints de deviner le type de média ou la destination cible à travers des regex fragiles, causant des erreurs d'aiguillage.
Pour résoudre définitivement cette faille, nous avons conçu et déployé un système de codification souverain à 5 segments, un algorithme de désambiguïsation automatique en 4 échelons, une boîte à outils CLI complète (codification_nommage.py) et la documentation maîtresse associée.
Chaque fichier de l'écosystème obéit désormais à une syntaxe canonique modulaire, prévisible et 100% séparable sans ambiguïté par une expression régulière :
[ID_PRODUIT]__[PILIER_TYPE]__[DESCRIPTEUR]__[VERSION_VARIANTE]__[SPEC_FORMAT].[EXT]
flowchart LR
A["Segment 1<br/><b>ID_PRODUIT</b><br/><i>ex: prd12-revivecare</i>"] --> B["Segment 2<br/><b>PILIER_TYPE</b><br/><i>ex: P03-VIDP</i>"]
B --> C["Segment 3<br/><b>DESCRIPTEUR</b><br/><i>ex: hook-douleur-dos</i>"]
C --> D["Segment 4<br/><b>VERSION_VARIANTE</b><br/><i>ex: v01-h01</i>"]
D --> E["Segment 5<br/><b>SPEC_FORMAT</b><br/><i>ex: 9x16</i>"]
E --> F["Extension<br/><b>.EXT</b><br/><i>ex: .mp4</i>"]
ID_PRODUIT (Identifiant Unique Souverain) :prd<ID:02d>-<slug_normalise> (ex: prd12-revivecare, prd08-dentalpod, prd04-coussingel).PILIER_TYPE (Code Fonctionnel Pilier + Trigramme de Sous-Dossier) :P03-VIDP $\rightarrow$ 03_Medias/03_Videos_Validees).DESCRIPTEUR (Sémantique Kebab-Case) :banniere-hero-lifestyle, arbitrage-7filtres, avis-photo-marie-l).VERSION_VARIANTE (Numérotation Ordonnée) :v01, v02-var-b, v01-h02 pour le Hook 2, ou la date 20261014 pour les rapports).SPEC_FORMAT (Spécification Technique & Ratio) :9x16 (Stories/Reels), 1x1 (Feed), 16x9 (Bannière), 1920x1080, fr, ou l'empreinte anti-collision id<hash6>.| Code | Pilier Canonique | Sous-Dossier Dédié | Fonction & Contenu |
|---|---|---|---|
P01-SOUR |
01_Rapports |
01_Sourcing |
Fiches fournisseurs AliExpress, 1688, Taobao, délais et devis |
P01-JUGE |
01_Rapports |
02_Juge_Produit |
Rapports HTML du Juge Produit, scoring 7 filtres, arbitrage |
P01-CONC |
01_Rapports |
03_Concurrence |
Extractions Facebook Ads Library, veille concurrentielle |
P01-ACRO |
01_Rapports |
04_Analytics_CRO |
Audits de conversion CRO, métriques Business Manager & Shopify |
P02-AVAT |
02_Scripts |
01_Strategie_Avatar |
Fiche Avatar Client, persona, matrice douleurs et désirs profonds |
P02-COPY |
02_Scripts |
02_Copywriting_Boutique |
Titres SEO, bullet points bénéfices, description longue, FAQ |
P02-PUBS |
02_Scripts |
03_Publicites |
Scripts vidéo UGC, variations de hooks 3s, scripts voix off |
P02-PRMT |
02_Scripts |
04_Prompts_Generateurs |
Prompts d'images et vidéos optimisés Fal.ai, Kling, Seedance |
P03-RAWP |
03_Medias |
01_Sources_Brutes |
Photos brutes fournisseur non retouchées |
P03-RAWV |
03_Medias |
01_Sources_Brutes |
Vidéos brutes fournisseur ou concurrentes avant montage |
P03-PHOT |
03_Medias |
02_Photos_Validees |
Visuels finaux validés (Hero, Lifestyle, vue en coupe, galerie) |
P03-VIDP |
03_Medias |
03_Videos_Validees |
Publicités vidéo finales validées par QA (9:16 ou 1:1) |
P03-STAT |
03_Medias |
04_Publicites_Statiques |
Visuels statiques haute définition (HTML/CSS capturé en PNG) |
P03-AUDV |
03_Medias |
05_Audio_Voix |
Pistes voix off ElevenLabs, bandes sonores, stems Demucs |
P04-PAGE |
04_Boutique_Site |
01_Code_Pages |
Code source des landing pages (produit.html) ou sections Liquid |
P04-AVIS |
04_Boutique_Site |
02_Avis_Clients |
Extractions Loox/Judge.me, avis réels traduits et photos clients |
P04-DATA |
04_Boutique_Site |
03_Donnees_Techniques |
Schémas SQL Supabase, webhooks Stripe/Shopify, tracking |
P99-RJET |
99_Archives_Brouillons |
Racine 99_... |
Actifs rejetés, disqualifiés ou chutes de montage non retenues |
Permet de classifier et filtrer immédiatement le portefeuille de produits :
- SAN : Santé, Posture & Bien-être
- MAI : Maison, Nettoyage & Rangement
- BEA : Beauté, Soins dentaires & Cosmétique
- BEB : Petite Enfance & Éveil
- ANI : Animaux de Compagnie
- JAR : Jardin, Hydroponie & Plantes
- AUT : Automobile & Voyage
- SPO : Sport, Yoga & Fitness
- HIG : High-Tech & Accessoires
- CUI : Cuisine & Gastronomie
Face à un fichier informel déposé dans l'Inbox (INBOX_JARVIS) ou téléchargé depuis un scraper, l'algorithme procède en 4 échelons déterministes :
id<hash6>) fournissent une garantie mathématique de non-écrasement même si 50 fichiers s'appellent photo.jpg."coussin", "gel", "alveole" $\rightarrow$ prd04-coussingel"posture", "revive", "lombaire", "dos" $\rightarrow$ prd12-revivecare"dental", "pod", "ultrason", "dentier" $\rightarrow$ prd08-dentalpodPRODUITS/<slug>..mp4, .html, .md, .webp, .mp3).9x16, 1x1 ou 16x9.hook, brief, avatar, lifestyle, juge, avis)..meta.json) :Le script autonome tools/codification_nommage.py est d'ores et déjà opérationnel et testé :
# 1. Validation d'un nom de fichier
python tools/codification_nommage.py parse prd12-revivecare__P03-VIDP__hook-douleur-dos__v01-h01__9x16.mp4
# 2. Génération automatique
python tools/codification_nommage.py generate --product prd12-revivecare --pillar P03-VIDP --desc hook-douleur --version v01 --spec 9x16 --ext mp4
# 3. Désambiguïsation d'un fichier brut
python tools/codification_nommage.py disambiguate "ad_douleur_dos_9x16.mp4" --product revivecare
# 4. Audit complet d'un dossier produit
python tools/codification_nommage.py audit "C:\ASSISTANT_IA\PRODUITS\dental-pod"
# 5. Renommage effectif avec sidecar
python tools/codification_nommage.py rename "C:\chemin\fichier.mp4" --apply --sidecar
# 6. Exécution de la suite de tests unitaires
python tools/codification_nommage.py test
🧪 Démarrage de la suite de tests unitaires de codification...
✅ Test 1 : Parsing nom valide réussi
✅ Test 2 : Rejet nom invalide réussi
✅ Test 3 : Génération canonique stricte réussie
✅ Test 4 : Résolution d'alias produit réussie
✅ Test 5 : Désambiguïsation de fichier flou réussie
✅ Test 6 : Anti-collision par empreinte réussie
🎉 100% de succès : 6/6 tests unitaires validés avec succès.
SOP_Codification_Nommage_Fichiers.mdtools/codification_nommage.pyArchitecture_Antigravity.md (routeur + catalogue)RAPPORT_SYSTEME_CODIFICATION_NOMMAGE_20261014.html