Structural rewrite of useSnapshotEditor for N holdings per detailed account, and switch ALL simple/detailed dispatch from category_kind to the account's own kind. This is the state/plumbing layer; the full multi-security entry UI (SecurityPicker, rich sub-rows) lands in #214. Simple accounts behave identically. Reducer state shape: - values: Record<accountId, string> (simple accounts, scalar) - holdings: Record<accountId, HoldingDraft[]> (detailed accounts, one per title) HoldingDraft is a string-typed, editable mirror of SnapshotHoldingInput with a stable client-side rowId for React keys. Actions: ADD_HOLDING / REMOVE_HOLDING / SET_HOLDING_FIELD (plus existing SET_VALUE/PREFILL/RESET). The legacy priced scalar path (SET_PRICED_FIELD / pricedValues) is removed: after migration v16 (#211) every former-priced account is kind='detailed' with one holding, so those accounts flow through the holdings path. Dispatch: - LOADED hydrates detailed baskets via listHoldingsBySnapshotLine (edit) keeping the saved price, or getHoldingsForLatestSnapshot (new) dropping the price (qty-0 excluded server-side). Simple accounts keep the scalar value path. - SnapshotLineRow / SnapshotEditor / AccountForm now gate on account.kind, not category_kind. category.kind survives ONLY as the suggested seed default for a NEW account in AccountForm. Save: detailed accounts pass their holdings array into SnapshotLineInput.holdings (presence marks the line detailed; value = rounded-cent SUM); simple accounts pass a scalar value with no holdings. Blank holding rows are skipped; a partial row throws a typed error before any DB mutation. AccountForm: adds an entry-mode selector (defaulting to the category-mapped kind). New accounts persist as 'simple' (CreateBalanceAccountInput carries no kind, and the service is out of this issue's scope); converting a fresh account to detailed + pivot date is #215. Editing locks the selector for an already- detailed account (the detailed->simple downgrade is service-guarded). Tests: 19 new reducer/helper unit tests (pure exports; the project has no renderHook harness) covering ADD/REMOVE/SET_HOLDING_FIELD, LOADED-vs-PREFILL hydration (price drop, book_cost), qty-0 already excluded upstream, the build*Lines save builders, and the dispatch-on-account.kind regression (detailed account under a 'simple' category). Resolves #213. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .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-refonte-seed-categories-ipc.md | ||
| spec-issue-66-oauth-keychain.md | ||
| spec-monetisation.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 |