Guide · 30

Classement des dépenses

Range un relevé bancaire en catégories par mots-clés, totalise par catégorie et par mois, et liste le non-classé.

En une ligne

node scripts/30-expense-categorizer.mjs releve.csv --rules regles.json

À 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é) et amount (négatif pour une dépense).
  • Un fichier de règles JSON : { "Transport": ["uber", "carburant"], "Logiciels": ["github", "notion"] }.

Pas à pas

  1. Lancez :
    node scripts/30-expense-categorizer.mjs samples/depenses.csv --rules samples/regles.json --out classe.csv
    
  2. Regardez les lignes « Non classé » et ajoutez des mots-clés dans le fichier de règles.
  3. 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.

Ce guide accompagne un script libre (licence MIT). Essayez-le d'abord sur une copie de vos données.