Aide & Documentation · Prévision finance

📖 Glossaire — Business plan

Termes financiers utilisés dans "The Plan"

TS / TC	Total Sales (ventes) / Total Costs (coûts) — notations utilisées dans les libellés du fichier (colonne D).
CAGR	Compound Annual Growth Rate — taux de croissance annuel composé appliqué aux ventes 2027-2030 (ligne 8, une hypothèse par année, modifiable directement dans Excel).
EBITDA	Earnings Before Interest, Taxes, Depreciation and Amortization — ici simplifié à Sales − Coûts (TS−TC), affiché seulement quand positif.
ASP	Average Selling Price — prix de vente unitaire par produit (colonne D des lignes Produit A-D), utilisé pour convertir un volume en chiffre d'affaires.
The Ask	Section "Valorisation" du fichier — calcule la valorisation de sortie visée et la part demandée aux investisseurs à partir d'un multiple EBITDA cible.
Forecast Y	Prévision de l'année en cours, produite par le projet `Prévision des ventes-master` — c'est la source des ventes 2026 de ce fichier (voir "Architecture").
Python	Requis pour régénérer le classeur (`build_finance_pl.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 + Excel

① Consulter le fichier Excel (aucune installation)

☐ Double-cliquez sur Ouvrir-Excel.bat (ou ouvrez directement BizPlan_ExecSummary.xlsx) avec Excel ou LibreOffice Calc (gratuit).

☐ Ou ouvrez finance-pl-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 BizPlan_ExecSummary.xlsx (recalcul Excel inclus), affiche un résumé avant de se fermer.

③ Pouvoir le modifier avec Claude Code

Nécessite Node.js (pour Claude Code), Python et Excel installé (le recalcul passe par l'automatisation Excel/COM — Windows uniquement).

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.
'python' n'est pas reconnu	Python pas installé, ou pas ajouté au PATH lors de l'installation.
ModuleNotFoundError: openpyxl / win32com	`pip install openpyxl pywin32` — Excel doit être installé pour `win32com`.

🗺️ Comment c'est construit

Le minimum à savoir avant de demander une modification

💡 Un classeur existant édité en place, pas régénéré de zéro

Contrairement aux autres générateurs Excel de la suite, BizPlan_ExecSummary.xlsx est le business plan réel de l'utilisateur — build_finance_pl.py ne recrée pas le fichier, il corrige uniquement 'The Plan'!E10:E13 (ventes 2026, 4 produits) et régénère l'onglet Ventes mensuelles (IN). Tout le reste du classeur (coûts, EBITDA, cash, scénarios, valorisation) est laissé tel quel, y compris si vous le modifiez vous-même directement dans Excel (le script ne touche jamais ces zones).

📁 Les fichiers du dossier

BizPlan_ExecSummary.xlsx	Le business plan — fichier de travail principal.
build_finance_pl.py	Corrige les ventes 2026 (E10:E13) + régénère l'onglet Ventes mensuelles (IN). Backup automatique avant chaque écriture.
prevision_ventes_IN.csv	CSV d'entrée optionnel (produit,mois,ventes) — généré par `Prévision des ventes-master/build_clean.py`. Absent = repli sur un forecast figé.
export_html.py	Génère `finance-pl-export.html`, un snapshot HTML en lecture seule (avec graphique).
test_finance_pl.py	Suite de tests de non-régression.
CONTEXTE.md	Détail du modèle, ce qui a changé vs l'original, résultat d'audit.

📊 Les 2 onglets

The Plan — le compte de résultat complet (2026-2030) : demande, ventes, coûts, P&L, EBITDA, scénarios, valorisation. Ventes mensuelles (IN) — détail des 12 mois du forecast par produit (source des ventes 2026 de "The Plan"). Le détail complet est dans CONTEXTE.md, pas dupliqué ici.

🤖 Comment l'IA est utilisée

Comme pour tous les projets de TWIN agents IA : le fichier Excel n'appelle jamais Claude. C'est vous qui utilisez Claude Code, en dehors du fichier, pour faire évoluer build_finance_pl.py ou modifier directement le classeur dans Excel.

✏️ 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 la cellule ou la section concernée (ex. hypothèse CAGR ligne 8, coûts lignes 17-24) — é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️⃣ Si vous éditez directement dans Excel (coûts, scénarios...), pas besoin de Claude Code — seul 'The Plan'!E10:E13 et l'onglet "Ventes mensuelles (IN)" sont gérés par le script.

5️⃣ Après une modification du script, demandez python3 build_finance_pl.py puis python3 test_finance_pl.py (voir "Tests de non-régression").

💡 Exemples de prompts

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

🔄 Mettre à jour le forecast des ventes

Le fichier prevision_ventes_IN.csv a été régénéré par Prévision des ventes-master (nouveau forecast). Copie-le dans ce dossier, relance build_finance_pl.py puis test_finance_pl.py pour confirmer que les ventes 2026 sont bien recalculées.

📤 Régénérer l'export HTML après une modification

J'ai modifié directement les coûts (lignes 17-24) dans Excel. Relance export_html.py pour que finance-pl-export.html reflète les nouvelles valeurs, et vérifie qu'il n'y a aucune erreur de formule dans le classeur.

🎚️ Changer l'hypothèse CAGR

Dans 'The Plan', la ligne CAGR (ligne 8) a des hypothèses différentes par année. Je voudrais les passer à [nouvelles valeurs]. Ce n'est qu'une valeur d'entrée Excel (pas gérée par build_finance_pl.py) : modifie-la directement dans le classeur avec Excel COM, puis vérifie 0 erreur de formule.

✅ 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_finance_pl.py

Vérifie 21 points : recalcul Excel réel (via Excel COM, pas une simulation) et absence d'erreur de formule sur tout le classeur, formules vivantes sur E10:E13 (pas de valeur figée), F10:I13 (CAGR) non modifiées, comparaison croisée avec le CSV IN, hygiène du fichier (pas de macro, pas de lien externe), export HTML présent et cohérent, absence de secret codé en dur.

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

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

☐ Vérifier que E10:E13 ('The Plan') correspondent bien à la somme des 12 mois de l'onglet "Ventes mensuelles (IN)" × le prix unitaire (colonne D)

☐ Vérifier que le graphique (Sales/Cost/Cash) reste cohérent après un recalcul

🏁 Validation de la version finale

Une fois toutes vos modifications terminées

☐ python3 build_finance_pl.py exécuté sans erreur (recalcul Excel COM inclus)

☐ python3 test_finance_pl.py → 21/21 tests passés

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

☐ 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_finance_pl.py` en ligne de commande) — ne jamais corriger E10:E13 ou l'onglet Ventes mensuelles (IN) à la main (le script les régénère).
test_finance_pl.py échoue sur "recalcul Excel"	Excel doit être installé et fermé (pas d'instance ouverte) avant de lancer le test.
Les valeurs en cache semblent périmées après une édition manuelle dans Excel	Enregistrez le fichier dans Excel (Ctrl+S) — `openpyxl` ne recalcule jamais lui-même, seul un vrai Excel (ou le recalcul COM du script) met les valeurs à jour.
Je veux une copie de secours avant un gros changement	Copiez `BizPlan_ExecSummary.xlsx` avant de demander la modification (le script en fait déjà une automatiquement, mais une copie manuelle ne fait pas de mal).

🔒 Sécurité

Vérifications automatisées le 2026-07-31

🎯 Pourquoi la surface de risque est limitée ici

Script Python local sans serveur, sans interface web, sans donnée personnelle réelle (chiffres agrégés d'entreprise, pas de données individuelles). Le fichier Excel ne contient que des formules et valeurs, pas de macro ni de script embarqué.

✅ Vérifié par test_finance_pl.py (21 tests, à chaque modification)

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

OK Aucune macro VBA dans le classeur

OK Aucun onglet caché, aucune référence à un autre dossier du projet

Ce fichier contient des chiffres de business plan (hypothèses financières, coûts, valorisation) — confidentiel par nature. Aucun mécanisme d'export ou de partage automatique n'existe dans ce projet ; la diffusion reste entièrement sous votre contrôle.

🔐 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.