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>\)
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).
video.mp4 ou script_v2.md s'écrasent ou sont mélangés par les scripts de synchronisation.coussin-gel.mp4), rendant impossible l'attribution automatique au bon produit.comp_benefit1.jpg est une photo brute fournisseur, une créative validée ou un avis client.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.
Chaque nom de fichier standardisé obéit strictement au schéma canonique suivant :
[ID_PRODUIT]__[PILIER_TYPE]__[DESCRIPTEUR]__[VERSION_VARIANTE]__[SPEC_FORMAT].[EXT]
__ (permet un découpage split('__') ou regex sans aucune ambiguïté).- (kebab-case).P03-VIDP).é, à, è), caractères de ponctuation (!, ?, (, ), +, %, &), caractères spéciaux Windows/POSIX.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.
dentalpod, skovasken, auk, petpivot). Le produit doit porter un nom original souverain (ex: SONIVIBE au lieu de dentalpod).flux, stripe, kling, elevenlabs, gemini, claude, etc.).PRD-<CAT3>-<NUM3>-<NOM_ORIGINAL>, ex: PRD-HLT-002-SONIVIBE ou son slug prd02-sonivibe) garantit une identification pérenne et univoque même si le produit est désigné par un nom générique informel ("l'appareil dentaire", "le coussin").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 |
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 |
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).
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
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'"]
photo.jpg, l'empreinte id<hash6> garantit une clé unique empêchant tout écrasement accidentel."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)prd00-inconnu avec routage vers quarantaine..mp4 $\rightarrow$ Vidéo, .html $\rightarrow$ Rapport ou Page, .md $\rightarrow$ Script)."hook", "avatar", "juge", "avis", "hero")..meta.json) :codification_nommage.py)python tools/codification_nommage.py parse prd12-revivecare__P03-VIDP__hook-douleur-dos__v01-h01__9x16.mp4
python tools/codification_nommage.py generate \
--product prd12-revivecare \
--pillar P03-VIDP \
--desc hook-douleur-dos \
--version v01-h01 \
--spec 9x16 \
--ext mp4
python tools/codification_nommage.py disambiguate "ad_douleur_dos_9x16.mp4" --product revivecare
python tools/codification_nommage.py audit "C:\ASSISTANT_IA\PRODUITS\revivecare"
python tools/codification_nommage.py rename "C:\ASSISTANT_IA\PRODUITS\revivecare\03_Medias\03_Videos_Validees\benefit1_combo_v3.mp4" --apply --sidecar
python tools/codification_nommage.py test
v02, v03) ou l'empreinte id<hash6> s'incrémente automatiquement.__) : Tout automate Jarvis doit s'appuyer sur le séparateur __ pour parser les 5 composantes sans ambiguïté.P01 $\rightarrow$ 01_Rapports, P02 $\rightarrow$ 02_Scripts, etc.).