From c8b92517e80dd75a3cb888500f076e25fb1d551c Mon Sep 17 00:00:00 2001 From: le king fu Date: Sat, 7 Mar 2026 09:53:37 -0500 Subject: [PATCH] Update docs: dashboard revamp, version 0.6.3 - CLAUDE.md: bump version to 0.6.3 - architecture.md: update version, component counts, dashboard description - guide-utilisateur.md: rewrite dashboard section (budget table, chart, no recent transactions) - i18n docs: update dashboard help text in both FR and EN Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 2 +- docs/architecture.md | 8 ++++---- docs/guide-utilisateur.md | 11 +++++++---- src/i18n/locales/en.json | 11 +++++++---- src/i18n/locales/fr.json | 11 +++++++---- 5 files changed, 26 insertions(+), 17 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 7158887..e6f3283 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,7 +9,7 @@ **Stockage :** SQLite local (tauri-plugin-sql) **Langues supportées :** Français (FR) et Anglais (EN) **Plateformes :** Windows, Linux -**Version actuelle :** 0.5.0 +**Version actuelle :** 0.6.3 **Licence :** GPL-3.0-only --- diff --git a/docs/architecture.md b/docs/architecture.md index 2801bcb..f1d2ae8 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,6 +1,6 @@ # Architecture technique — Simpl'Résultat -> Document mis à jour le 2026-03-01 — Version 0.4.7 +> Document mis à jour le 2026-03-07 — Version 0.6.3 ## Stack technique @@ -30,11 +30,11 @@ simpl-resultat/ │ │ ├── adjustments/ # 3 composants │ │ ├── budget/ # 5 composants │ │ ├── categories/ # 5 composants -│ │ ├── dashboard/ # 3 composants +│ │ ├── dashboard/ # 2 composants │ │ ├── import/ # 13 composants (wizard d'import) │ │ ├── layout/ # AppShell, Sidebar │ │ ├── profile/ # 3 composants (PIN, formulaire, switcher) -│ │ ├── reports/ # 8 composants (graphiques + rapport dynamique) +│ │ ├── reports/ # 10 composants (graphiques + rapports tabulaires + rapport dynamique) │ │ ├── settings/ # 3 composants (+ LogViewerCard) │ │ ├── shared/ # 6 composants réutilisables │ │ └── transactions/ # 5 composants @@ -190,7 +190,7 @@ Le routing est défini dans `App.tsx`. Toutes les pages sont englobées par `App | Route | Page | Description | |-------|------|-------------| -| `/` | `DashboardPage` | Tableau de bord avec graphiques | +| `/` | `DashboardPage` | Tableau de bord (résumé, pie chart, budget vs réel, dépenses dans le temps) | | `/import` | `ImportPage` | Assistant d'import CSV | | `/transactions` | `TransactionsPage` | Liste avec filtres | | `/categories` | `CategoriesPage` | Gestion hiérarchique | diff --git a/docs/guide-utilisateur.md b/docs/guide-utilisateur.md index ed6d859..23463d0 100644 --- a/docs/guide-utilisateur.md +++ b/docs/guide-utilisateur.md @@ -71,8 +71,9 @@ Le tableau de bord vous donne un aperçu rapide de votre situation financière p - Cartes résumées du solde, des revenus et des dépenses - Répartition des dépenses par catégorie (graphique circulaire avec motifs SVG) -- Liste des transactions récentes -- Sélecteur de période ajustable +- Tableau Budget vs Réel du mois courant (écart en $ et %) +- Histogramme empilé des dépenses par catégorie et par mois +- Sélecteur de période ajustable (par défaut : année à ce jour) - Menu contextuel (clic droit) pour masquer une catégorie ou voir ses transactions ### Comment faire @@ -80,11 +81,13 @@ Le tableau de bord vous donne un aperçu rapide de votre situation financière p 1. Utilisez le sélecteur de période en haut à droite pour choisir une plage de temps (mois, 3 mois, année, etc.) 2. Consultez les cartes résumées pour votre solde, revenus totaux et dépenses totales 3. Vérifiez le graphique circulaire pour voir comment vos dépenses sont réparties par catégorie -4. Cliquez droit sur une catégorie dans le graphique pour la masquer ou voir le détail de ses transactions -5. Faites défiler vers le bas pour voir vos transactions les plus récentes +4. Consultez le tableau Budget vs Réel pour comparer vos dépenses au budget du mois courant +5. Analysez l'histogramme en bas de page pour voir l'évolution de vos dépenses par catégorie dans le temps +6. Cliquez droit sur une catégorie dans un graphique pour la masquer ou voir le détail de ses transactions ### Astuces +- La période par défaut est « année à ce jour » pour un aperçu annuel dès l'ouverture - Le solde est calculé comme les revenus moins les dépenses pour la période sélectionnée - Les catégories masquées apparaissent sous forme de pastilles au-dessus du graphique — cliquez sur Tout afficher pour les restaurer - Les motifs SVG (lignes, points, hachures) aident à distinguer les catégories au-delà des couleurs diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json index 38fb1da..73e5a3c 100644 --- a/src/i18n/locales/en.json +++ b/src/i18n/locales/en.json @@ -588,18 +588,21 @@ "features": [ "Balance, income, and expense summary cards", "Expense breakdown by category (pie chart with SVG patterns)", - "Recent transactions list", - "Adjustable time period selector", + "Budget vs Actual table for the current month (variance in $ and %)", + "Stacked bar chart of expenses by category and month", + "Adjustable time period selector (default: year to date)", "Context menu (right-click) to hide a category or view its transactions" ], "steps": [ "Use the period selector in the top-right to choose a time range (month, 3 months, year, etc.)", "Review the summary cards for your balance, total income, and total expenses", "Check the pie chart to see how your spending is distributed across categories", - "Right-click a category in the chart to hide it or view its transaction details", - "Scroll down to see your most recent transactions" + "Review the Budget vs Actual table to compare your spending against your plan for the current month", + "Analyze the stacked bar chart at the bottom to see expense trends by category over time", + "Right-click a category in a chart to hide it or view its transaction details" ], "tips": [ + "The default period is year to date for an annual overview when you open the app", "The balance is calculated as income minus expenses for the selected period", "Hidden categories appear as dismissible chips above the chart — click Show All to restore them", "SVG patterns (lines, dots, crosshatch) help distinguish categories beyond just color" diff --git a/src/i18n/locales/fr.json b/src/i18n/locales/fr.json index 94b5446..a5b5f13 100644 --- a/src/i18n/locales/fr.json +++ b/src/i18n/locales/fr.json @@ -588,18 +588,21 @@ "features": [ "Cartes résumées du solde, des revenus et des dépenses", "Répartition des dépenses par catégorie (graphique circulaire avec motifs SVG)", - "Liste des transactions récentes", - "Sélecteur de période ajustable", + "Tableau Budget vs Réel du mois courant (écart en $ et %)", + "Histogramme empilé des dépenses par catégorie et par mois", + "Sélecteur de période ajustable (par défaut : année à ce jour)", "Menu contextuel (clic droit) pour masquer une catégorie ou voir ses transactions" ], "steps": [ "Utilisez le sélecteur de période en haut à droite pour choisir une plage de temps (mois, 3 mois, année, etc.)", "Consultez les cartes résumées pour votre solde, revenus totaux et dépenses totales", "Vérifiez le graphique circulaire pour voir comment vos dépenses sont réparties par catégorie", - "Cliquez droit sur une catégorie dans le graphique pour la masquer ou voir le détail de ses transactions", - "Faites défiler vers le bas pour voir vos transactions les plus récentes" + "Consultez le tableau Budget vs Réel pour comparer vos dépenses au budget du mois courant", + "Analysez l'histogramme en bas de page pour voir l'évolution de vos dépenses par catégorie dans le temps", + "Cliquez droit sur une catégorie dans un graphique pour la masquer ou voir le détail de ses transactions" ], "tips": [ + "La période par défaut est « année à ce jour » pour un aperçu annuel dès l'ouverture", "Le solde est calculé comme les revenus moins les dépenses pour la période sélectionnée", "Les catégories masquées apparaissent sous forme de pastilles au-dessus du graphique — cliquez sur Tout afficher pour les restaurer", "Les motifs SVG (lignes, points, hachures) aident à distinguer les catégories au-delà des couleurs"