projet de comptabilité personnel simplifié et 100% local
7a604e0e0d
All checks were successful
PR Check — Frontend / frontend (pull_request) Successful in 1m48s
The root bug of this chantier. `import_sources` carried no `amount_mode` and no `sign_convention` until v17, so restoring a configured source re-inferred the mode from `mapping.debitAmount !== undefined` and wrote `signConvention: "negative_expense"` outright (useImportWizard.ts:321-323). A credit-card statement configured for positive expenses came back on the default convention at its second import and `parseFilesInternal` negated every amount: expenses landed as income, with no error shown anywhere. The format is a read value now, not a guessed one. Two types and a codec, not one composed type. The four carriers are structurally incompatible -- `ImportSource.has_header` is declared boolean, `ImportConfigTemplate.has_header` is a number, `SourceConfig` is camelCase on a parsed mapping -- so the guarantee cannot come from a shared shape. It comes from `src/utils/importFormat.ts` being the single conversion point between `ImportFormatRow` (persisted: snake_case, mapping as JSON, `has_header` normalized to 0/1) and `ImportFormat` (domain), and from its completeness test. That test is enforced on two levels, and both were mutation-checked: `FORMAT_FIELD_PAIRS` is typed `Record<keyof ImportFormat, keyof ImportFormatRow>`, so a field added to the format fails to BUILD until it is listed; the test then compares each codec's real output keys against that table, so a field listed but not wired fails the TEST. Dropping `sign_convention` from `formatToRow` -- the shape of the original bug -- fails 14 tests. `formatFromRow` validates rather than falls back. The v17 CHECK admits `absolute_indicator` so the third amount mode ships without another migration, but the app cannot map one: falling through to the `single` branch would read the wrong column for every row, and anything other than `positive_expense` would silently mean `negative_expense`. It raises an `ImportFormatError` carrying an i18n key, and the wizard opens on a fresh configuration so "reconfigure this source" stays an action the user can actually take. Also here: - The config write moves from `checkDuplicatesInternal` to `executeImport`, so an import abandoned at the duplicate step leaves no configuration behind. It is the only write point in the hook and a guard test holds that. - Switching amount mode prunes the abandoned mode's columns, so the mode owns the mapping rather than the reverse. The column the `<select>` merely displays is deliberately not materialized -- #325 turns an unmapped amount column into an explicit row error, and writing a 0 here would make it unreachable. The mode and the pruned mapping land in ONE state update: the panel's handlers each spread the same `config` prop, so two calls would see the same stale value. - `template_id` is recorded and restored as provenance only, never re-read as format. `selectedTemplateId` is no longer blanked on every source selection. An acceptance test rewrites a template end to end and asserts the linked source reads identically, plus a non-vacuity check that the template really changed. - Both template writers go through the codec too, so a new format field cannot reach one table and miss the other. `parseFilesInternal` is untouched: link 1's static guard on its five pinned expressions still passes. 39 new tests (963 vitest total, was 924), build clean, `cargo check` clean, no migration. Resolves #324 |
||
|---|---|---|
| .cargo | ||
| .claude | ||
| .forgejo/workflows | ||
| .github/workflows | ||
| config | ||
| docs | ||
| public | ||
| src | ||
| src-tauri | ||
| tasks | ||
| tests/smoke | ||
| .gitignore | ||
| CHANGELOG.fr.md | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| index.html | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| spec-decisions-collapse-multi-niveaux.md | ||
| spec-decisions-feature-gating.md | ||
| spec-decisions-import-csv-format.md | ||
| spec-decisions-refonte-seed-categories-ipc.md | ||
| spec-issue-66-oauth-keychain.md | ||
| spec-monetisation.md | ||
| spec-plan-collapse-multi-niveaux.md | ||
| spec-plan-feature-gating.md | ||
| spec-plan-import-csv-format.md | ||
| spec-plan-refonte-seed-categories-ipc.md | ||
| spec-refonte-rapports.md | ||
| spec-simpl-resultat-web.md | ||
| STATE.md | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Simpl'Résultat
Application de bureau 100 % locale pour importer, catégoriser et analyser vos transactions financières personnelles ou d'entreprise. Aucune donnée ne quitte votre ordinateur.
Fonctionnalités
- Import CSV — Importez vos relevés bancaires depuis plusieurs sources avec auto-détection des colonnes et modèles d'import réutilisables
- Tableau de bord — Vue d'ensemble avec KPIs, répartition par catégorie et dernières transactions
- Transactions — Parcourez, recherchez et filtrez avec sélection rapide de période
- Catégorisation automatique — Attribution automatique par mots-clés, avec ajustement manuel
- Split de transactions — Répartissez une transaction sur plusieurs catégories
- Budgets — Grille budgétaire 12 mois par catégorie avec modèles et rapport Budget vs Réel
- Ajustements — Ajustements ponctuels ou récurrents par catégorie
- Rapports — Tendances mensuelles, répartition par catégorie, évolution dans le temps, budget vs réel
- Graphiques interactifs — Motifs SVG, menu contextuel (clic droit), détail des transactions par catégorie
- Profils multiples — Bases de données séparées avec protection PIN optionnelle
- Export / Import de données — Sauvegarde complète avec chiffrement AES-256-GCM optionnel
- Mode sombre — Thème sombre avec palette gris chaud
- Bilingue — Interface disponible en français et en anglais
- Guide utilisateur intégré — Documentation complète accessible depuis les paramètres, imprimable en PDF
- Mise à jour automatique — Notifications et installation des nouvelles versions depuis l'application
Installation
Windows
- Rendez-vous sur la page Releases
- Téléchargez le fichier
.exe(installateur NSIS) - Lancez le fichier téléchargé
Note : Windows SmartScreen peut afficher un avertissement car l'application n'est pas signée numériquement. Cliquez sur « Informations complémentaires » puis « Exécuter quand même » pour continuer.
Linux
- Rendez-vous sur la page Releases
- Téléchargez le format adapté à votre distribution :
.debpour Debian / Ubuntu.rpmpour Fedora / openSUSE.AppImagepour toute distribution (exécutable universel)
- Installez le paquet ou lancez l'AppImage directement
Démarrage rapide
1. Choisir ou créer un profil
Au premier lancement, un profil par défaut est créé. Vous pouvez ajouter d'autres profils (chacun avec sa propre base de données) et les protéger par un PIN.
2. Configurer le dossier d'import
Organisez vos fichiers CSV dans un dossier avec un sous-dossier par source :
Documents/
Comptabilité/
Desjardins/
releve-2024-01.csv
releve-2024-02.csv
Autre banque/
export.csv
3. Importer des transactions
- Allez dans Import
- Sélectionnez le dossier source et les fichiers CSV
- Configurez le mappage des colonnes (ou utilisez un modèle d'import sauvegardé)
- Vérifiez les doublons puis lancez l'import
4. Consulter le tableau de bord
Le tableau de bord affiche automatiquement :
- Les KPIs du mois (revenus, dépenses, solde)
- La répartition des dépenses par catégorie
- Les dernières transactions
5. Parcourir et catégoriser les transactions
- Utilisez la recherche et les filtres (date, catégorie, source, période rapide)
- Modifiez la catégorie d'une transaction en cliquant dessus
- Ajoutez des mots-clés pour automatiser les futures catégorisations
- Scindez une transaction sur plusieurs catégories si nécessaire
6. Gérer les budgets
- Définissez un budget mensuel par catégorie sur une grille 12 mois
- Créez des modèles budgétaires réutilisables
- Consultez le rapport Budget vs Réel pour suivre vos écarts
7. Analyser les rapports
- Tendances — Évolution mensuelle des revenus et dépenses
- Catégories — Répartition détaillée par catégorie (clic droit pour masquer ou voir le détail)
- Évolution — Suivi dans le temps par catégorie
- Budget vs Réel — Comparaison mensuelle et cumul annuel
8. Guide utilisateur
Un guide complet est accessible via Paramètres → Guide utilisateur. Il couvre toutes les fonctionnalités et peut être imprimé ou exporté en PDF.
Développement
Prérequis
Lancer en mode développement
npm install
npm run tauri dev
Compiler l'application
npm run tauri build
Les installateurs sont générés dans src-tauri/target/release/bundle/.
Publier une nouvelle version
- Mettez à jour la version dans
src-tauri/tauri.conf.jsonetpackage.json - Committez les changements
- Créez et poussez un tag :
git tag v0.3.7
git push origin v0.3.7
Le workflow GitHub Actions compile automatiquement l'application pour Windows et Linux, puis publie les installateurs dans une nouvelle Release.
Technologies
| Technologie | Rôle |
|---|---|
| Tauri v2 | Framework desktop (Rust backend) |
| React 19 | Interface utilisateur |
| SQLite | Base de données locale |
| Tailwind CSS v4 | Styles |
| Recharts | Graphiques |
| react-i18next | Internationalisation |
| PapaParse | Parsing CSV |