Guide · 34

Feuille de temps

Totalise heures et montants à facturer par projet et par semaine ISO depuis un CSV de saisies.

En une ligne

node scripts/34-timesheet-summary.mjs temps.csv --rate 20000

À quoi ça sert

Savoir combien d'heures vous avez passées sur chaque client, et ce que cela représente à facturer. Ce script totalise une feuille de temps (CSV) par projet et par semaine, avec un taux horaire par ligne ou par défaut.

Avant de commencer

  • Un CSV : date, project, hours (heures décimales : 1,5 = 1 h 30), rate (taux horaire, facultatif), note.

Pas à pas

  1. Notez vos heures au fil de l'eau dans le CSV (une ligne par session).
  2. Récapitulez le mois :
    node scripts/34-timesheet-summary.mjs samples/temps.csv --from 2026-10-01 --to 2026-10-31 --rate 20000
    
  3. Servez-vous des totaux par projet pour préparer vos factures, et du total par semaine pour repérer les semaines surchargées.

Lire le résultat

Heures et montant par projet, trié par volume d'heures, puis le total et les heures par semaine ISO (2026-S43, le lundi est le premier jour). Les lignes sans taux utilisent --rate ; sans --rate, elles comptent 0 à facturer (utile pour le temps interne).

L'automatiser

Un récapitulatif hebdomadaire le vendredi, un export mensuel pour la facturation.

Pièges à éviter

  • Notez le temps le jour même : reconstituer de mémoire sous-estime presque toujours.
  • Une date illisible est signalée avec le numéro de ligne : le script préfère s'arrêter plutôt que de fausser un total.

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