Aide & Documentation · Prévision production

📖 Glossaire — MRP & outils

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

MRP	Material Requirements Planning — méthode qui calcule, mois par mois, ce qu'il faut produire et acheter pour couvrir les ventes prévues, en tenant compte des stocks et des délais.
BOM (nomenclature)	Bill of Materials — la "recette" de chaque produit : quels composants et en quelle quantité (ex. le produit A consomme 3 unités de Z, 2 de Y, 1 de X).
Besoin brut / net	Besoin brut = quantité nécessaire pour couvrir les ventes. Besoin net = besoin brut moins le stock déjà disponible.
Offset (délai M-N)	Nombre de mois d'avance nécessaires entre le lancement d'une production/commande et le moment où le besoin apparaît (ex. "M-1" = 1 mois d'avance).
Stock de sécurité	Quantité conservée en réserve (en % du besoin) pour absorber les aléas de délai ou de demande.
ETP	Équivalent Temps Plein — unité utilisée dans le graphique "Ressources" pour convertir des heures de production en nombre de personnes nécessaires.
Python	Requis pour régénérer le fichier Excel (`build_supply_chain.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_supply_chain_A_2027_OUT.xlsx) avec Excel ou LibreOffice Calc (gratuit).

☐ Ou ouvrez plan-supply-chain-export.html dans un navigateur — snapshot en lecture seule, aucun logiciel requis.

② Régénérer après une mise à jour de la prévision de ventes

☐ Copiez prevision_ventes_OUT.csv (généré dans Prévision des ventes) dans ce dossier, renommé prevision_ventes_IN.csv.

☐ Double-cliquez sur Relancer-le-Build.bat — aucune ligne de commande à taper. Vérifie Python, régénère plan_supply_chain_A_2027_OUT.xlsx, affiche un résumé avant de se fermer.

③ Pouvoir le modifier avec Claude Code

Nécessite Node.js (pour Claude Code) et Python + Microsoft Excel installés (pour régénérer et tester le fichier).

Installer Node.js

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

Installer Claude Code

npm install -g @anthropic/claude-code

Installer Python + dépendances

pip install openpyxl pywin32

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

claude

Décrivez ensuite votre modification (voir "Exemples de prompts").

Erreurs fréquentes

Message	Solution
'node' n'est pas reconnu	Node.js pas installé, ou terminal pas rouvert après l'installation.
ModuleNotFoundError: win32com	`pip install pywin32` — Microsoft Excel doit être installé (le test pilote un vrai recalcul, pas une simulation).
Excel reste ouvert en arrière-plan après un test	Fermez tout processus EXCEL.EXE résiduel dans le Gestionnaire des tâches avant de relancer.

🗺️ Comment c'est construit

Le minimum à savoir avant de demander une modification

💡 Une seule source de vérité : le script Python

build_supply_chain.py reconstruit entièrement le Plan MRP, la Charge de Production, le Récap Actions et les Graphiques à chaque exécution, à partir de l'onglet "Prevision Ventes" (alimenté par prevision_ventes_IN.csv s'il existe, sinon à éditer manuellement) et de l'onglet "Paramètres" (BOM, délais, stock sécurité). Ne jamais modifier les onglets calculés directement — tout est en formules Excel, régénérées à chaque run.

🔒 Projet autonome

Contrairement à une version antérieure, ce projet ne lit plus aucun fichier situé dans un autre dossier (notamment le projet "Prévision des ventes") — prevision_ventes_IN.csv est un fichier local à ce projet, pas une lecture d'un autre dossier. Pour charger une nouvelle prévision, éditez ce CSV (colonnes produit,mois,ventes) et relancez le script ; sans CSV, le dernier snapshot présent dans l'onglet "Prevision Ventes" est conservé.

📁 Les fichiers du dossier

build_supply_chain.py	Script source unique — reconstruit Plan MRP, Charge de Production, Récap Actions, Graphiques.
prevision_ventes_IN.csv	CSV d'entrée optionnel (produit,mois,ventes) pour actualiser l'onglet "Prevision Ventes" sans éditer les cellules à la main.
plan_supply_chain_A_2027_OUT.xlsx	Fichier Excel généré — ne jamais éditer les onglets calculés à la main.
plan_supply_chain_A_2027_OUT_BACKUP_*.xlsx	Backups automatiques créés par le script avant chaque écrasement.
export_html.py	Génère `plan-supply-chain-export.html`, un snapshot HTML en lecture seule.
test_supply_chain.py	Suite de tests de non-régression.
CONTEXTE.md	Détail des 6 onglets, de la logique BOM/délais/stock sécurité et des choix de conception.

📊 Les 6 onglets

Prevision Ventes	Ventes mensuelles des 4 produits — chargé depuis `prevision_ventes_IN.csv` si présent, sinon snapshot conservé tel quel.
Paramètres	Référentiel : BOM, délais, stock sécurité, paramètres de production — lu comme source de vérité.
Plan MRP 2027	Besoins bruts/nets, plan de production/commande — reconstruit entièrement.
Récap Actions Chronologique	Vue "actions à déclencher" dérivée du Plan MRP.
Charge de Production	Heures clock / heures-opérateurs / contrôle qualité.
Graphiques	Plan de vente, ressources de production, achats.

🤖 Comment l'IA est utilisée

Comme pour tous les projets de TWIN agents IA : le fichier Excel généré n'appelle jamais Claude. C'est vous qui utilisez Claude Code, en dehors du fichier, pour faire évoluer build_supply_chain.py.

✏️ Demander une modification à Claude Code

Vous n'avez pas besoin de savoir coder — juste de décrire précisément ce que vous voulez

1️⃣ Précisez l'onglet et la ligne concernés (ex. BOM lignes 4-14, délais lignes 17-24, stock sécurité lignes 27-31 de l'onglet Paramètres) — évite que Claude Code cherche au mauvais endroit.

2️⃣ Décrivez le comportement actuel puis voulu : "Actuellement X vaut Y, je voudrais Z."

3️⃣ Une demande à la fois — plus facile à vérifier et à annuler si besoin.

4️⃣ Pour les stocks de sécurité des composants achetés (Z/Y/W), rappelez que ces valeurs sont codées en dur dans SS_PCT_COMPONENT (pas dans l'onglet Paramètres).

5️⃣ Demandez toujours python3 build_supply_chain.py puis python3 test_supply_chain.py après coup.

💡 Exemples de prompts

À copier-coller dans Claude Code, pas dans claude.ai

🧩 Modifier la nomenclature (BOM)

Dans build_supply_chain.py, le produit A consomme actuellement 3 unités de Z. Je voudrais passer à 4 unités. Régénère le fichier Excel et vérifie avec test_supply_chain.py que l'agrégation des besoins reste cohérente sur tous les composants partagés.

⏱️ Changer un délai

Dans l'onglet Paramètres, le délai du composant X est actuellement "M-1". Je voudrais le passer à "M-2" (2 mois d'avance au lieu d'1). Régénère le Plan MRP et vérifie que le décalage se répercute bien dans le Récap Actions Chronologique.

📦 Ajouter un produit

Ajoute un 5e produit fini "E" dans build_supply_chain.py, avec sa propre prévision de ventes, sa nomenclature (BOM) et son stock de sécurité. Vérifie qu'il apparaît correctement dans le Plan MRP, la Charge de Production et les Graphiques, sans casser les 4 produits existants.

✅ Tests de non-régression

Deux niveaux complémentaires : vérification automatisée, et vérification visuelle par vous

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

🤖 Niveau 1 — Suite automatisée (recalcul Excel réel)

Demandez à Claude Code de lancer, ou lancez vous-même :

python3 test_supply_chain.py

Vérifie 28 points : recalcul Excel réel (via Excel COM sur tous les onglets, pas une simulation) et absence d'erreur de formule, hygiène du fichier (pas de macro VBA, pas de lien externe, pas d'élément caché), agrégation multi-produits des composants partagés, cohérence du stock de sécurité et des décalages de délai, réconciliation bout-en-bout, garde-fou anti-régression sur l'autonomie du projet (aucun lien cross-dossier), validité syntaxique des scripts, absence de secret codé en dur.

🖱️ Niveau 2 — Vérification visuelle dans Excel/LibreOffice

☐ Ouvrir plan_supply_chain_A_2027_OUT.xlsx après régénération — vérifier qu'aucune cellule n'affiche #REF!, #VALUE! ou #DIV/0!

☐ Vérifier l'onglet modifié + Récap Actions Chronologique (dérivé du Plan MRP — une erreur s'y répercute)

☐ Si un composant partagé a changé (BOM), vérifier qu'aucun produit qui ne le consomme pas ne l'affiche par erreur (ex. Z n'est pas consommé par B)

🏁 Validation de la version finale

Une fois toutes vos modifications terminées

☐ python3 build_supply_chain.py exécuté sans erreur

☐ python3 test_supply_chain.py → 32/32 tests passés

☐ Si l'export HTML doit refléter les changements : relancer python3 export_html.py

☐ Un nouveau backup *_BACKUP_*.xlsx a bien été créé automatiquement avant l'écrasement

☐ Ouverture manuelle du fichier (pas juste via Claude Code) pour confirmer un usage réel normal

🛠️ Dépannage

Situation	Solution
Le fichier Excel affiche des erreurs de formule	Double-cliquez sur `Relancer-le-Build.bat` (ou lancez `python3 build_supply_chain.py` en ligne de commande) — ne jamais corriger une cellule à la main.
test_supply_chain.py échoue sur "recalcul Excel"	Excel doit être installé et fermé (pas d'instance ouverte) avant de lancer le test.
Un besoin semble compter deux fois un composant	Signe possible de sur-comptage dans l'agrégation multi-produits — vérifiez la BOM (un composant ne doit apparaître qu'une fois par produit qui le consomme réellement).
Je veux une copie de secours avant un gros changement	Le script en crée déjà une automatiquement (`_BACKUP_.xlsx`) — vous pouvez aussi copier `build_supply_chain.py` par précaution.

🔒 Sécurité

Vérifications automatisées le 2026-07-19 — pas d'audit manuel ponctuel comme sur le projet "Pilotage commercial"

🎯 Pourquoi la surface de risque est limitée ici

Script Python local sans serveur, sans interface web, sans donnée personnelle (produits génériques A/B/C/D et composants W/X/Y/Z — voir la revue RGPD du 2026-07-21 dans le README racine). Le fichier Excel généré ne contient que des formules et valeurs, pas de macro ni de script embarqué.

✅ Vérifié par test_supply_chain.py (32 tests, à chaque modification)

OK Aucun secret codé en dur (clé API, mot de passe, clé privée)

OK Aucune macro VBA dans le fichier Excel généré

OK Aucun lien externe ni élément caché dans le classeur

OK Aucun lien cross-dossier vers un autre projet TWIN (garde-fou anti-régression dédié)

OK Syntaxe Python valide (py_compile) sur tous les scripts du projet

Si une future évolution ajoute des données fournisseurs réelles (au lieu des composants génériques actuels), appliquez le même principe que le projet "Pilotage commercial" : ne stocker/traiter ces données que localement, et documenter les précautions RGPD correspondantes.

🔐 Charte d'utilisation de l'IA

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