Aide & Documentation

📖 Glossaire

Ce fichier Excel n'a pas d'onglet glossaire intégré — les termes sont donc expliqués ici.

BOM (nomenclature)	La "recette" de chaque produit fini : quels composants et en quelle quantité (ex. le produit A consomme 3×Z, 2×Y, 1×X) — mêmes valeurs que Prévision production-master.
Demande confirmée	Les commandes réellement confirmées par les clients (export CSV du Module 6 de CRM — CRM-master ou Pilotage commercial-master, même format) — pas une prévision statistique.
Stock de sécurité	Marge ajoutée à la demande confirmée (en %) pour absorber les aléas, avant de calculer la quantité réellement à produire/commander.
Sous-assemblage (X)	Composant fabriqué en interne (pas acheté), qui consomme lui-même d'autres composants (X consomme 2×W) — n'apparaît donc jamais dans les besoins fournisseurs.
Besoins fournisseurs	Quantités à commander des composants achetés (Z, Y, W), calculées par explosion BOM (formules Excel vivantes) — exportées en CSV pour être importées dans SRM-master.
Fournisseur assigné (info, SRM)	Colonne informative sur l'onglet Besoins fournisseurs, lue en best-effort depuis un `contrats_IN.csv` optionnel (export "🧮 Vers Excel" de SRM-master) — n'entre dans aucun calcul.
Python	Requis pour régénérer le fichier Excel (`build_planification_production.py`) et lancer les tests — pas nécessaire pour simplement consulter le fichier.
Claude / Claude Code	Claude = l'IA sur claude.ai. Claude Code = la version qui travaille directement sur vos fichiers depuis un terminal.

🚀 Installer et lancer

Consulter le fichier ne demande rien de particulier ; le modifier demande Python

① Consulter le fichier Excel (aucune installation)

☐ Double-cliquez sur Lancer-Application.bat (ou ouvrez directement plan_production_OUT.xlsx) avec Excel ou LibreOffice Calc (gratuit).

☐ Ou ouvrez plan-production-export.html dans un navigateur — snapshot en lecture seule, aucun logiciel requis. Le lien "📊 Télécharger le classeur Excel" en haut de page permet aussi de récupérer directement plan_production_OUT.xlsx.

② Mettre à jour la demande (avant de régénérer)

Exportez la demande depuis le Module 6 de CRM ("📤 Exporter la demande (CSV)" dans CRM-master, ou "🧮 Vers Excel" dans m6-commandes.html de Pilotage commercial-master — même format, au choix), puis remplacez demande_production_IN.csv de ce dossier par le fichier téléchargé (renommez-le à l'identique). Optionnel : copiez aussi contrats_IN.csv (export "🧮 Vers Excel" de SRM-master) pour renseigner la colonne informative "Fournisseur assigné". Aucune copie automatique — c'est une étape manuelle volontaire, voir "Sécurité" plus bas.

③ Régénérer le plan (après avoir mis à jour la demande)

☐ Double-cliquez sur Relancer-le-Build.bat — aucune ligne de commande à taper. Le script vérifie que Python est installé et que demande_production_IN.csv existe, régénère plan_production_OUT.xlsx et besoins_fournisseurs_OUT.csv, puis affiche un résumé avant de se fermer.

☐ Si Python n'est pas installé, le message affiché indique où le télécharger — aucune autre action requise que suivre les instructions à l'écran.

④ Pouvoir le modifier avec Claude Code

Nécessite Node.js (pour Claude Code) et Python + la librairie openpyxl.

Installer Node.js

https://nodejs.org — version LTS, installation par défaut.

Installer Claude Code

npm install -g @anthropic/claude-code

Installer Python + dépendance

pip install openpyxl

Ouvrir PowerShell dans le dossier du projet, puis lancer Claude Code

claude

🗺️ Comment c'est construit

Le minimum à savoir avant de demander une modification

💡 Un lot confirmé, pas un forecast glissant

Contrairement à Prévision production-master (plan MRP sur 15 mois glissants), ce projet calcule "de combien ai-je besoin pour honorer les commandes actuellement confirmées" — un calcul en un seul lot, plus simple, adapté à une demande CRM qui arrive au fil de l'eau plutôt qu'à un forecast mensuel.

🔒 Projet autonome

Le référentiel BOM/délais/stock de sécurité est réécrit dans ce dossier (mêmes valeurs que Prévision production-master, pas de lecture de son fichier). L'entrée (demande CRM) et la sortie (besoins SRM) sont des fichiers CSV échangés manuellement — aucune lecture de fichier situé dans un autre dossier *-master.

📁 Les fichiers du dossier

demande_production_IN.csv	Entrée — export CSV du Module 6 de CRM (produit, quantité, date, client), à remplacer manuellement.
contrats_IN.csv	Entrée optionnelle — export "🧮 Vers Excel" de SRM-master (Module 3), lu en best-effort pour la colonne informative "Fournisseur assigné". Absent = colonne vide, aucune erreur.
build_planification_production.py	Script source unique — lit la demande, explose la nomenclature, génère le plan et les besoins en formules Excel vivantes, puis recalcule le classeur via Excel (COM) pour que les valeurs soient à jour dès l'ouverture.
Relancer-le-Build.bat	Lance `build_planification_production.py` en double-cliquant — aucune commande à taper. Vérifie Python et le fichier d'entrée avant de lancer, affiche le résultat, se ferme sur une touche.
plan_production_OUT.xlsx	Fichier Excel généré (4 onglets, formules vivantes) — ne jamais éditer les onglets calculés à la main.
besoins_fournisseurs_OUT.csv	Sortie — quantités à commander (Z, Y, W), à importer dans SRM-master (Module 3 — Contrats).
export_html.py	Génère `plan-production-export.html`, un snapshot HTML en lecture seule.
test_planification_production.py	Suite de tests de non-régression.

📊 Les 4 onglets du fichier Excel

Demande	Commandes confirmées lues depuis le CSV d'entrée + total par produit.
Nomenclature	Référentiel BOM, stock de sécurité et délais — copié de Prévision production-master.
Plan production	Quantité à produire par produit fini (A-D) + sous-assemblage X, avec délai — formule vivante référençant l'onglet Demande.
Besoins fournisseurs	Quantités à commander des composants achetés (Z, Y, W), avec délai — formule vivante référençant l'onglet Plan production, + colonne informative "Fournisseur assigné (info, SRM)".

✏️ Demander une modification à Claude Code

1️⃣ Précisez si le changement porte sur la nomenclature (BOM), les délais, le stock de sécurité, ou le calcul lui-même.

2️⃣ Décrivez le comportement actuel puis voulu.

3️⃣ Une demande à la fois.

4️⃣ Demandez toujours python3 build_planification_production.py puis python3 test_planification_production.py après coup.

✅ Tests de non-régression

⚠️ Ne considérez jamais une modification terminée juste parce que Claude Code dit "c'est fait" — vérifiez vous-même.

Lancez :

python3 test_planification_production.py

Vérifie : présence des fichiers, exécution réelle du calcul (pas de réimplémentation séparée), exactitude de l'explosion BOM recalculée indépendamment pour un scénario connu (agrégation multi-produits, propagation de la marge de sécurité de X vers W), génération correcte des fichiers de sortie (xlsx, CSV, HTML), recalcul Excel réel via COM (zéro erreur de formule sur tous les onglets), confirmation que les colonnes calculées sont des formules vivantes et que leur valeur en cache correspond au recalcul Python indépendant, autonomie (aucune référence à un autre dossier *-master, aucune ressource externe), absence de secret codé en dur.

🖱️ Vérification visuelle

☐ Ouvrir plan_production_OUT.xlsx — vérifier les 4 onglets, aucune cellule d'erreur

☐ Comparer besoins_fournisseurs_OUT.csv aux totaux visibles dans l'onglet "Besoins fournisseurs"

☐ Console (F12) sans message rouge sur plan-production-export.html

🛠️ Dépannage

Situation	Solution
"ERREUR : fichier d'entrée introuvable"	Copiez l'export CSV du Module 6 de CRM dans ce dossier, renommé `demande_production_IN.csv`.
"Produit inconnu dans le CSV d'entrée"	Le CSV contient un produit hors A-D — vérifiez qu'aucune ligne du Module 6 CRM n'a été modifiée manuellement avec un code produit invalide.
Le fichier Excel n'est pas à jour après un changement de demande	Double-cliquez sur `Relancer-le-Build.bat` (ou lancez `python3 build_planification_production.py` en ligne de commande) — le fichier n'est jamais recalculé tout seul.

🔒 Sécurité

🎯 Pourquoi la surface de risque est limitée ici

Script Python local sans serveur, sans interface web interactive, sans donnée personnelle propre (le CSV d'entrée contient des noms de clients, mais uniquement en tant que copie ponctuelle d'un export déjà fictif en démonstration). Le fichier Excel généré ne contient que des formules et valeurs, pas de macro ni de script embarqué.

✅ Vérifié par test_planification_production.py

OK Aucun secret codé en dur

OK Aucune ressource chargée depuis un domaine externe

OK Aucune référence à un autre dossier *-master (garde-fou anti-régression dédié)

OK Exactitude de l'explosion BOM vérifiée par recalcul indépendant

OK Zéro erreur de formule sur tous les onglets (recalcul Excel réel via COM)

L'export CSV/Excel de ce projet contient les noms de clients issus de la demande CRM — à ne pas laisser dans un dossier partagé non maîtrisé, au même titre que le CSV d'entrée.

🔐 Charte d'utilisation de l'IA

L'usage des outils d'IA sur ce projet est encadré par une charte commune aux projets de TWIN agents IA — usages/outils autorisés, données interdites, validation humaine avant action, contact référent : Charte_IA.md.