À quoi ça sert
Un relevé bancaire de 300 lignes ne dit rien tant qu'il n'est pas classé. Ce script range chaque ligne dans une catégorie à l'aide de mots-clés que vous définissez, puis totalise par catégorie et par mois, et vous montre ce qui reste non classé pour compléter vos règles.
Avant de commencer
- Un export CSV de votre banque avec
date,label(libellé) etamount(négatif pour une dépense). - Un fichier de règles JSON :
{ "Transport": ["uber", "carburant"], "Logiciels": ["github", "notion"] }.
Pas à pas
- Lancez :
node scripts/30-expense-categorizer.mjs samples/depenses.csv --rules samples/regles.json --out classe.csv - Regardez les lignes « Non classé » et ajoutez des mots-clés dans le fichier de règles.
- Relancez jusqu'à ce que le non-classé soit marginal.
Lire le résultat
Les totaux par catégorie (les plus grosses dépenses en premier), puis par mois. Les mots-clés ignorent la casse et les accents. L'ordre des règles compte : la première catégorie dont un mot-clé apparaît dans le libellé l'emporte.
L'automatiser
Chaque mois, déposez le nouvel export et relancez : vos règles s'enrichissent avec le temps. Le fichier --out se rouvre dans un tableur.
Pièges à éviter
- Un mot-clé trop court (« bar ») attrape beaucoup trop : préférez des fragments distinctifs.
- Vos relevés sont des données sensibles : gardez-les hors des dépôts publics.