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

SOP — Codification & Normalisation du Nommage des Fichiers 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_Codification_Nommage_Fichiers.md
Outil Opérationnel Associé : C:\ASSISTANT_IA\tools\codification_nommage.py
Architecture de Rattachement : SOP_Architecture_Classement_Produits.md (C:\ASSISTANT_IA\PRODUITS\<slug>\)


🎯 1. Contexte & Problématique Métier

Dans l'écosystème e-commerce autonome de Raphaël, des centaines de fichiers sont quotidiennement créés, scrapés, générés par IA ou déposés par l'utilisateur :
- Médias publicitaires (vidéos UGC, hooks, publicités statiques, visuels Lifestyle).
- Écrits persuasifs (avatars marketing, fiches produits, scripts UGC, prompts Fal.ai / Kling).
- Rapports et données (verdicts du Juge Produit, audits CRO, benchmarks concurrents, avis Loox).

Les 4 Échecs Classiques du Nommage Informel :

  1. Collisions de noms : Deux fichiers nommés video.mp4 ou script_v2.md s'écrasent ou sont mélangés par les scripts de synchronisation.
  2. Ambiguïté des produits génériques : Deux coussins ergonomiques sourcés indépendamment ou deux correcteurs de posture finissent avec les mêmes libellés (coussin-gel.mp4), rendant impossible l'attribution automatique au bon produit.
  3. Opacité fonctionnelle : Impossible de savoir, sans ouvrir le fichier, si comp_benefit1.jpg est une photo brute fournisseur, une créative validée ou un avis client.
  4. Fragilité des automatisations : Les scripts Python recourent à des heuristiques approximatives (regex lâches, devinettes) qui se brisent à la moindre variation typographique.

Objectif de la présente SOP : Instaurer une grammaire syntaxique déterministe à 5 segments, complétée par un moteur de désambiguïsation automatique et un système de métadonnées souverain, assurant un classement automatisé, infaillible et pérenne dans l'arborescence des 5 piliers de Raphaël.


🏛️ 2. La Grammaire Déterministe à 5 Segments

Chaque nom de fichier standardisé obéit strictement au schéma canonique suivant :

[ID_PRODUIT]__[PILIER_TYPE]__[DESCRIPTEUR]__[VERSION_VARIANTE]__[SPEC_FORMAT].[EXT]

Règles Syntactiques Strictes :

Exemple Décomposé :

prd01-revivecare__P03-VIDP__hook-douleur-dos__v01-h01__9x16.mp4
1. prd01-revivecare : Identifiant souverain du produit (ID Tracker + Slug original normalisé).
2. P03-VIDP : Pilier 03 (Médias) / Type Vidéo Publicitaire Finale Validée.
3. hook-douleur-dos : Descripteur sémantique fonctionnel.
4. v01-h01 : Version 01, Hook numéro 01.
5. 9x16 : Format vertical 9:16 (Stories/Reels/TikTok).
6. .mp4 : Extension vidéo standard.

2.2. Règles d'Or d'Originalité & Garde-Fous Souverains :


🏷️ 3. Tables de Référence des Codifications & Abréviations

3.1. Codes Piliers & Trigrammes de Sous-Dossiers (PILIER_TYPE)

Chaque code oriente immédiatement et mécaniquement le fichier vers son dossier et sous-dossier canonique dans C:\ASSISTANT_IA\PRODUITS\<slug>\ :

Code Pilier-Type Pilier Canonique Sous-Dossier Canonique Rôle & Contenu Autorisé Extensions Attendues
P01-SOUR 01_Rapports 01_Sourcing Fiches techniques fournisseurs, devis, fiches Ali/1688 .md, .json, .pdf, .jpg
P01-JUGE 01_Rapports 02_Juge_Produit Verdicts Juge Produit, scoring 7 filtres, rapports HTML .html, .md, .json
P01-CONC 01_Rapports 03_Concurrence Audits Facebook Ads Library, benchmarks Amazon/Google .md, .json, .png, .jpg
P01-ACRO 01_Rapports 04_Analytics_CRO Audits CRO, métriques Business Manager & Shopify (ROAS) .md, .html, .json, .csv
P02-AVAT 02_Scripts 01_Strategie_Avatar Fiche Avatar Client, douleurs, désirs, angles marketing .md, .json
P02-COPY 02_Scripts 02_Copywriting_Boutique Titres SEO, bullet points bénéfices, description, FAQ .md, .txt
P02-PUBS 02_Scripts 03_Publicites Scripts publicitaires UGC, variations hooks, voix off .md, .txt, .json
P02-PRMT 02_Scripts 04_Prompts_Generateurs Prompts optimisés Fal.ai, Kling, Seedance, ElevenLabs .md, .txt, .json
P03-RAWP 03_Medias 01_Sources_Brutes Photos brutes non retouchées (fournisseurs/scraping) .jpg, .jpeg, .png, .webp
P03-RAWV 03_Medias 01_Sources_Brutes Vidéos brutes non retouchées (fournisseurs/concurrents) .mp4, .mov, .mkv
P03-PHOT 03_Medias 02_Photos_Validees Visuels finaux validés (Hero, Lifestyle, coupe, packshot) .webp, .png, .jpg
P03-VIDP 03_Medias 03_Videos_Validees Vidéos publicitaires finales prêtes à diffuser (QA OK) .mp4, .mov
P03-STAT 03_Medias 04_Publicites_Statiques Créatives statiques haute définition (HTML->PNG) .png, .webp, .jpg
P03-AUDV 03_Medias 05_Audio_Voix Voix off ElevenLabs/Edge-TTS, musiques, stems Demucs .mp3, .wav, .m4a
P04-PAGE 04_Boutique_Site 01_Code_Pages Landing pages autonomes HTML/CSS/JS, Liquid Shopify .html, .css, .js, .liquid
P04-AVIS 04_Boutique_Site 02_Avis_Clients Extractions d'avis réels (textes traduits + photos Loox) .csv, .json, .jpg, .png
P04-DATA 04_Boutique_Site 03_Donnees_Techniques Scripts SQL Supabase, webhooks, tracking pixels .sql, .json, .yaml
P99-RJET 99_Archives_Brouillons Racine 99_... Actifs disqualifiés ou abandonnés Tous formats
P99-CHUT 99_Archives_Brouillons Racine 99_... Chutes de montage, rushes non retenus Tous formats
P99-TEST 99_Archives_Brouillons Racine 99_... Brouillons et tests temporaires Tous formats

3.2. Trigrammes des Catégories E-commerce

Pour faciliter l'agrégation statistique et le tri par univers de marché :

Trigramme Catégorie Marché Exemples de Produits Souverains
SAN Santé, Posture & Bien-être Correcteur de posture REVIVE CARE (PRD-HLT-001), coussin ORTOFLEX (PRD-HOM-001)
MAI Maison, Nettoyage & Rangement Sac de lavage MESHVAPOR (PRD-CLN-001), brosses silicone, organisateurs
BEA Beauté & Soins Personnels Nettoyeur ultrasonique SONIVIBE (PRD-HLT-002), soins capillaires, épilateurs
BEB Petite Enfance & Puériculture Livre d'éveil sensoriel SENSOPAL (PRD-KID-001), jouets Montessori
ANI Animaux de Compagnie Litière chat hygiénique PURASCOOP (PRD-PET-001), brosses poils
JAR Jardinage & Plantes Potager d'intérieur AEROVERDE (PRD-GAR-001), lampes horticoles
AUT Automobile & Mobilité Coussins lombaires voiture, supports téléphone, compresseurs
SPO Sport, Fitness & Yoga Sangles Pilates, élastiques de résistance, rouleaux massage
HIG High-Tech & Accessoires Sangle de serrage TENSALOCK (PRD-TEC-001), chargeurs magnétiques
CUI Cuisine & Gastronomie Éplucheurs multifonctions, mandolines, scelleuses sous vide

3.3. Spécifications Techniques & Ratios d'Affichage (SPEC_FORMAT)

Le dernier segment spécifie le format physique ou la langue de l'actif :
- Ratios Vidéos : 9x16 (Stories/Reels/TikTok 1080x1920), 1x1 (Feed carré 1080x1080), 16x9 (Paysage YouTube).
- Résolutions Images : 1920x1080 (Hero Desktop), 1080x1920 (Hero Mobile), 1080x1080 (Galerie standard).
- Langues / Marchés : fr (Français), en (Anglais), de (Allemand), es (Espagnol).
- Voix / Modèles : elevenlabs-adam, edge-fr-henri, fal-nanobanana, kling3-pro.
- Empreinte Anti-Collision : id<hash6> (ex: ida1e6e4, attribué par hash SHA-256 du contenu en l'absence de spécification explicite).


🧩 4. Résolution d'Ambiguïté pour les Noms Génériques

Le Problème

Quand un utilisateur ou un agent dépose un fichier informel :
- coussin.jpg
- ad_1.mp4
- video_final_v2_ok.mp4
- script_posture.md
- review(2).jpg

L'Algorithme de Résolution en 4 Échelons (Implémenté dans codification_nommage.py) :

flowchart TD
    A["Fichier Brut Déposé<br/>(ex: 'coussin_gel.mp4')"] --> B["Échelon 1 : Empreinte SHA-256<br/>Calcul du hash court (ex: 'a1e6e4') -> Anti-collision absolue"]
    B --> C["Échelon 2 : Entity Matching (Produit)<br/>Dictionnaire d'alias contextuels -> 'prd01-ortoflex'"]
    C --> D["Échelon 3 : Inférence Pilier & Type<br/>Analyse extension + mots-clés + ratio image PIL -> 'P03-RAWV'"]
    D --> E["Échelon 4 : Normalisation Canonique<br/>'prd01-ortoflex__P03-RAWV__coussin-gel__v01__ida1e6e4.mp4'"]
    E --> F["Classement Automatique<br/>'PRODUITS/prd01-ortoflex/03_Medias/01_Sources_Brutes/'"]
    E -. "Optionnel" .-> G["Génération Sidecar<br/>'fichier.meta.json'"]
  1. Échelon 1 : Empreinte Unique SHA-256 :
    Le fichier est immédiatement haché. Même si 100 fichiers s'appellent photo.jpg, l'empreinte id<hash6> garantit une clé unique empêchant tout écrasement accidentel.
  2. Échelon 2 : Entity Matcher (Registre Souverain d'Alias) :
    Le nom est comparé au dictionnaire de synonymes e-commerce :
    - "coussin", "coussin-gel", "alveole" $\rightarrow$ prd01-ortoflex (Code Souverain : PRD-HOM-001-ORTOFLEX)
    - "posture", "revivecare", "lombaire" $\rightarrow$ prd01-revivecare (Code Souverain : PRD-HLT-001-REVIVECARE)
    - "dental", "ultrason", "gouttiere" $\rightarrow$ prd02-sonivibe (Code Souverain : PRD-HLT-002-SONIVIBE — ancien nom 'dentalpod' banni du nommage actif)
    - Si ambiguïté non résoluble : attribution prd00-inconnu avec routage vers quarantaine.
  3. Échelon 3 : Inférence Multimodale Pilier & Type :
    - Par extension (.mp4 $\rightarrow$ Vidéo, .html $\rightarrow$ Rapport ou Page, .md $\rightarrow$ Script).
    - Par inspection PIL des dimensions (détection native du ratio 9:16 vs 1:1 vs 16:9).
    - Par mots-clés sémantiques ("hook", "avatar", "juge", "avis", "hero").
  4. Échelon 4 : Sidecar de Métadonnées (.meta.json) :
    Permet d'immortaliser l'origine, l'URL source, l'auteur, l'empreinte exacte et l'horodatage en Guadeloupe UTC-4.

🛠️ 5. Mode d'Emploi de la Boîte à Outils (codification_nommage.py)

1. Tester la Validité 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érer un Nom Canonique Conforme

python tools/codification_nommage.py generate \
  --product prd12-revivecare \
  --pillar P03-VIDP \
  --desc hook-douleur-dos \
  --version v01-h01 \
  --spec 9x16 \
  --ext mp4

3. Désambiguïser un Fichier Brut ou Flou

python tools/codification_nommage.py disambiguate "ad_douleur_dos_9x16.mp4" --product revivecare

4. Auditer la Conformité d'un Dossier Produit Entier

python tools/codification_nommage.py audit "C:\ASSISTANT_IA\PRODUITS\revivecare"

5. Renommer un Fichier Invalide avec Génération du Sidecar JSON

python tools/codification_nommage.py rename "C:\ASSISTANT_IA\PRODUITS\revivecare\03_Medias\03_Videos_Validees\benefit1_combo_v3.mp4" --apply --sidecar

6. Lancer la Suite de Tests Unitaires

python tools/codification_nommage.py test

🛡️ 6. Garde-Fous & Règles d'Or Systèmes

  1. Aucun écrasement aveugle : Un fichier existant ne doit JAMAIS être remplacé sans vérification du hash SHA-256. Si le hash diffère, le compteur de version (v02, v03) ou l'empreinte id<hash6> s'incrémente automatiquement.
  2. Double tiret du bas souverain (__) : Tout automate Jarvis doit s'appuyer sur le séparateur __ pour parser les 5 composantes sans ambiguïté.
  3. Respect de l'arborescence des 5 Piliers : Tout fichier renommé doit être déplacé ou synchronisé vers le sous-dossier correspondant à son code (P01 $\rightarrow$ 01_Rapports, P02 $\rightarrow$ 02_Scripts, etc.).
  4. Horodatage Local Guadeloupe (UTC-4) : Tout rapport, fichier d'audit ou sidecar généré doit obligatoirement être horodaté sur le fuseau horaire permanent de Raphaël (UTC-4 / AST).