Aide et guide périmés : Budget (bouton de répartition, avertissement Annuel), Rapports (onglets, quatre cartes, zoom catégorie), Transactions (icône +) #431

New issue

Closed

opened 2026-10-12 23:23:20 +00:00 by maximus · 0 comments

maximus commented

2026-10-12 23:23:20 +00:00

Owner

Planifié le 2026-10-12 (/plan-run, jalon planned-2026-10-12-retours-onboarding-v0171), après /analyze et une revue /review-spec (sécurité, architecture, technique) dont les constats sont intégrés ci-dessous. Corps autosuffisant : la spec (spec-plan-retours-onboarding-v0171.md) est locale et ignorée par git.

Préalable : ce jalon s'exécute après le merge de planned-2026-10-10-fiabilite-tests (#408, #409, #395, #389). Les numéros de ligne cités sont lus sur main à 8b5b3b1 et ont pu bouger : se fier aux noms de fonctions, aux clés et aux textes cités.

Contexte

Le « bouton de répartition » du Budget a été retiré en v0.2.5 (ccdab1f) : la répartition passe par la saisie dans la cellule Annuel.
L'avertissement Annuel ne peut plus apparaître : l'annuel est toujours calculé comme la somme des mois (src/hooks/useBudget.ts:126-137). Le contrôle mort de BudgetTable.tsx:342-349 reste en place (hors de cette issue).
Le hub des Rapports a cinq cartes, dont « Analyse par catégorie » (reports.hub.categoryZoom), et plus d'onglets (ADR 0007).
Le bouton de mot-clé de la table des transactions est une icône étiquette, présente seulement sur une ligne déjà classée (src/components/transactions/TransactionTable.tsx:225-236).

Textes (FR | EN)

Clé	FR	EN
`budget.help.tips` (remplace le tableau, 5 entrées)	["Utilisez le navigateur d'année pour changer d'année", "Seules les catégories du dernier niveau, sans chevron, acceptent un montant ; une ligne à chevron additionne ses sous-catégories", "Cliquez sur une cellule de mois pour modifier le montant prévu — Entrée pour sauvegarder, Échap pour annuler, Tab pour passer au mois suivant", "Un montant saisi dans la colonne Annuel est réparti également sur les 12 mois et remplace les montants mensuels ; la colonne affiche ensuite leur total", "Sauvegardez votre budget comme modèle et appliquez-le à des mois spécifiques ou aux 12 mois d'un coup"]	["Use the year navigator to switch between years", "Only last-level categories, without a chevron, take an amount; a row with a chevron adds up its subcategories", "Click on any month cell to edit the planned amount — press Enter to save, Escape to cancel, Tab to move to next month", "An amount typed in the Annual column is split evenly over the 12 months and replaces the monthly amounts; the column then shows their total", "Save your budget as a template and apply it to specific months or all 12 at once"]
`docs.budget.steps[3]`	Saisissez un montant dans la colonne Annuel pour le répartir également sur les 12 mois ; il remplace les montants mensuels de la ligne	Type an amount in the Annual column to split it evenly over the 12 months; it replaces the row's monthly amounts
`docs.budget.tips[0]`	La colonne Annuel additionne automatiquement les 12 mois	The Annual column auto-sums all 12 months
`docs.budget.tips[2]`	Seules les catégories du dernier niveau acceptent un montant ; les catégories parentes affichent les sous-totaux de leurs enfants	Only last-level categories take an amount; parent categories show the subtotals of their children
`reports.help.tips[0]`	Les cartes du bas de la page ouvrent les cinq rapports : Faits saillants, Tendances, Comparables, Analyse par catégorie et Cartes	The cards at the bottom of the page open the five reports: Highlights, Trends, Compare, Category Analysis and Cards
`docs.reports.overview`	remplacer « quatre sous-rapports dédiés (Faits saillants, Tendances, Comparables, Zoom catégorie) » par « cinq sous-rapports dédiés (Faits saillants, Tendances, Comparables, Analyse par catégorie, Cartes) »	replace "four dedicated sub-reports (Highlights, Trends, Compare, Category Zoom)" with "five dedicated sub-reports (Highlights, Trends, Compare, Category Analysis, Cards)"
`docs.reports.features[0]`	« + 4 cartes de navigation » → « + 5 cartes de navigation »	"+ 4 navigation cards" → "+ 5 navigation cards"
`docs.reports.features[5]`	« Zoom catégorie : » → « Analyse par catégorie : »	"Category Zoom:" → "Category Analysis:"
`docs.reports.steps[0]`	Ouvrez /reports pour voir le panneau de faits saillants et les cinq cartes de navigation	Open /reports to see the highlights panel and five navigation cards
`docs.reports.steps[5]`	« dans le zoom catégorie » → « dans l'analyse par catégorie »	"in the category zoom" → "in the category analysis"
`docs.reports.tips[2]`	« Le Zoom catégorie est protégé » → « L'analyse par catégorie est protégée »	"The Category Zoom is protected" → "The Category Analysis is protected"
`docs.transactions.steps[4]`	Pour ajouter une règle de mot-clé depuis une transaction, faites un clic droit sur sa ligne, puis « Ajouter comme mot-clé » ; sur une transaction déjà classée, l'icône étiquette ajoute aussi un mot-clé à sa catégorie	To add a keyword rule from a transaction, right-click its row, then “Add as keyword”; on a transaction that already has a category, the tag icon also adds a keyword to that category

Guide Markdown (docs/guide-utilisateur.md), lignes repérées par leur texte :

Budget : « 4. Utilisez le bouton de répartition (sur la colonne Annuel)… » reprend docs.budget.steps[3] ; « - La colonne Annuel additionne automatiquement les 12 mois — un avertissement apparaît… » reprend docs.budget.tips[0] ; la puce des catégories parentes reprend docs.budget.tips[2].
Rapports : « … En bas, quatre cartes mènent aux quatre sous-rapports dédiés. » finit par « En bas, cinq cartes mènent aux cinq sous-rapports dédiés. » ; le titre « ### Rapport Zoom catégorie (/reports/category) » devient « ### Rapport Analyse par catégorie (/reports/category) » ; « (dans le zoom catégorie, la liste des faits saillants… » devient « (dans l'analyse par catégorie, la liste des faits saillants… » ; « - Le zoom catégorie est protégé » devient « - L'analyse par catégorie est protégée ».
Transactions : « 5. Pour ajouter une règle de mot-clé depuis une transaction, cliquez sur l'icône + et entrez le mot-clé » reprend docs.transactions.steps[4].
Restent tels quels : « Les 4 cartes KPI et leurs formules », « il bascule les 4 cartes » (page Cartes), « flipper les 4 cartes » et l'avertissement « solde périmé » du Bilan.

Fichiers concernés

src/i18n/locales/fr.json, src/i18n/locales/en.json
docs/guide-utilisateur.md
CHANGELOG.md, CHANGELOG.fr.md

Depends on

#430

Lien d'ordre : mêmes fichiers (fr.json, en.json, guide, CHANGELOG) que les issues précédentes de la pile.

Tests

Aucun test de comportement. src/components/settings/DocsContent.locales.test.ts contrôle la forme des clés docs.* en FR et en EN : il reste vert (mêmes longueurs de tableaux dans les deux langues).
Contrôle : grep -n -P 'bouton de répartition|split button|avertissement apparaît si les totaux|warning appears if monthly|via les onglets|using the tabs|quatre (sous-rapports|cartes de navigation|cartes mènent)|four (dedicated|navigation cards)|\+ 4 (cartes de navigation|navigation cards)|icône \+|the \+ icon|[Zz]oom catégorie|[Cc]ategory [Zz]oom' src/i18n/locales/*.json docs/guide-utilisateur.md ne rend rien.

Critères d'acceptation

Les défauts listés au contexte ont disparu de l'aide (bouton ? des pages) et du guide (Markdown et intégré), en FR et en EN.
Le grep de contrôle ne rend rien, et les phrases à garder sont intactes.
npm run build et npm test verts.

Review caveats

🔴 Technique, résolu : le contrôle grep d'origine attrapait des phrases justes (« Les 4 cartes KPI », « il bascule les 4 cartes », l'avertissement du Bilan) ; il est ciblé et les phrases à garder sont listées.
🟡 Technique, résolu : la table oubliait docs.reports.steps[0] et trois mentions de « zoom catégorie » sous un titre renommé ; elles sont ajoutées.

Décisions prises en planification

Remplacements validés par Max le 2026-10-12 ; l'aide et le guide nomment les rapports par leur titre affiché (« Analyse par catégorie »).
Le contrôle mort de la colonne Annuel (BudgetTable.tsx:342-349) reste en place.

Conventions

Toute chaîne en FR et en EN (src/i18n/locales/fr.json, en.json) ; les textes de ce corps s'écrivent mot pour mot (FR validé par Max le 2026-10-12, EN rédigé sur le même contenu).
Phrase de carte : un contrôle cité passe par StepCardText.labels (src/utils/onboardingPath.ts), traduit par StepCard ; jamais recopié dans la phrase. Guillemets « » en FR et “ ” en EN autour de chaque libellé de contrôle interpolé ; {{filter, lowercase}} sans guillemets.
CHANGELOG : une entrée sous ## [Unreleased] dans CHANGELOG.md et CHANGELOG.fr.md.
Tests de rendu : renderToStaticMarkup (pas de jsdom) et le faux t partagé livré par #389.
Aucune migration ; npm run build (il vérifie aussi les types des fichiers de test) et npm test verts.
Guide Markdown (docs/guide-utilisateur.md) : repérer une ligne par son texte cité, pas par son numéro.

CHANGELOG

Fixed / Corrigé : FR « Aide et guide : le Budget décrit la saisie dans la colonne Annuel (plus de bouton de répartition) et la saisie limitée aux catégories du dernier niveau ; les Rapports ont cinq cartes et plus d'onglets ; l'ajout d'un mot-clé depuis une transaction passe par le clic droit. » EN "Help and guide: Budget describes typing in the Annual column (no more split button) and that only last-level categories take an amount; Reports have five cards and no tabs; adding a keyword from a transaction goes through the right-click menu."

Spec source

spec-plan-retours-onboarding-v0171.md (local, ignoré par git) ; décisions dans spec-decisions-retours-onboarding-v0171.md.

L'aide des pages (bouton ?) et le guide (Markdown et intégré) décrivent des contrôles qui n'existent plus ou se trompent de nombre. Constat de l'analyse de #422, inclus dans le jalon sur décision de Max (2026-10-12) ; remplacements validés par Max. > Planifié le 2026-10-12 (`/plan-run`, jalon `planned-2026-10-12-retours-onboarding-v0171`), après `/analyze` et une revue `/review-spec` (sécurité, architecture, technique) dont les constats sont intégrés ci-dessous. Corps autosuffisant : la spec (`spec-plan-retours-onboarding-v0171.md`) est locale et ignorée par git. > > **Préalable :** ce jalon s'exécute après le merge de `planned-2026-10-10-fiabilite-tests` (#408, #409, #395, #389). Les numéros de ligne cités sont lus sur `main` à `8b5b3b1` et ont pu bouger : se fier aux noms de fonctions, aux clés et aux textes cités. ## Contexte - Le « bouton de répartition » du Budget a été retiré en v0.2.5 (`ccdab1f`) : la répartition passe par la saisie dans la cellule Annuel. - L'avertissement Annuel ne peut plus apparaître : l'annuel est toujours calculé comme la somme des mois (`src/hooks/useBudget.ts:126-137`). Le contrôle mort de `BudgetTable.tsx:342-349` reste en place (hors de cette issue). - Le hub des Rapports a cinq cartes, dont « Analyse par catégorie » (`reports.hub.categoryZoom`), et plus d'onglets (ADR 0007). - Le bouton de mot-clé de la table des transactions est une icône étiquette, présente seulement sur une ligne déjà classée (`src/components/transactions/TransactionTable.tsx:225-236`). ## Textes (FR | EN) | Clé | FR | EN | |---|---|---| | `budget.help.tips` (remplace le tableau, 5 entrées) | ["Utilisez le navigateur d'année pour changer d'année", "Seules les catégories du dernier niveau, sans chevron, acceptent un montant ; une ligne à chevron additionne ses sous-catégories", "Cliquez sur une cellule de mois pour modifier le montant prévu — Entrée pour sauvegarder, Échap pour annuler, Tab pour passer au mois suivant", "Un montant saisi dans la colonne Annuel est réparti également sur les 12 mois et remplace les montants mensuels ; la colonne affiche ensuite leur total", "Sauvegardez votre budget comme modèle et appliquez-le à des mois spécifiques ou aux 12 mois d'un coup"] | ["Use the year navigator to switch between years", "Only last-level categories, without a chevron, take an amount; a row with a chevron adds up its subcategories", "Click on any month cell to edit the planned amount — press Enter to save, Escape to cancel, Tab to move to next month", "An amount typed in the Annual column is split evenly over the 12 months and replaces the monthly amounts; the column then shows their total", "Save your budget as a template and apply it to specific months or all 12 at once"] | | `docs.budget.steps[3]` | Saisissez un montant dans la colonne Annuel pour le répartir également sur les 12 mois ; il remplace les montants mensuels de la ligne | Type an amount in the Annual column to split it evenly over the 12 months; it replaces the row's monthly amounts | | `docs.budget.tips[0]` | La colonne Annuel additionne automatiquement les 12 mois | The Annual column auto-sums all 12 months | | `docs.budget.tips[2]` | Seules les catégories du dernier niveau acceptent un montant ; les catégories parentes affichent les sous-totaux de leurs enfants | Only last-level categories take an amount; parent categories show the subtotals of their children | | `reports.help.tips[0]` | Les cartes du bas de la page ouvrent les cinq rapports : Faits saillants, Tendances, Comparables, Analyse par catégorie et Cartes | The cards at the bottom of the page open the five reports: Highlights, Trends, Compare, Category Analysis and Cards | | `docs.reports.overview` | remplacer « quatre sous-rapports dédiés (Faits saillants, Tendances, Comparables, Zoom catégorie) » par « cinq sous-rapports dédiés (Faits saillants, Tendances, Comparables, Analyse par catégorie, Cartes) » | replace "four dedicated sub-reports (Highlights, Trends, Compare, Category Zoom)" with "five dedicated sub-reports (Highlights, Trends, Compare, Category Analysis, Cards)" | | `docs.reports.features[0]` | « + 4 cartes de navigation » → « + 5 cartes de navigation » | "+ 4 navigation cards" → "+ 5 navigation cards" | | `docs.reports.features[5]` | « Zoom catégorie : » → « Analyse par catégorie : » | "Category Zoom:" → "Category Analysis:" | | `docs.reports.steps[0]` | Ouvrez /reports pour voir le panneau de faits saillants et les cinq cartes de navigation | Open /reports to see the highlights panel and five navigation cards | | `docs.reports.steps[5]` | « dans le zoom catégorie » → « dans l'analyse par catégorie » | "in the category zoom" → "in the category analysis" | | `docs.reports.tips[2]` | « Le Zoom catégorie est protégé » → « L'analyse par catégorie est protégée » | "The Category Zoom is protected" → "The Category Analysis is protected" | | `docs.transactions.steps[4]` | Pour ajouter une règle de mot-clé depuis une transaction, faites un clic droit sur sa ligne, puis « Ajouter comme mot-clé » ; sur une transaction déjà classée, l'icône étiquette ajoute aussi un mot-clé à sa catégorie | To add a keyword rule from a transaction, right-click its row, then “Add as keyword”; on a transaction that already has a category, the tag icon also adds a keyword to that category | **Guide Markdown** (`docs/guide-utilisateur.md`), lignes repérées par leur texte : - Budget : « 4. Utilisez le bouton de répartition (sur la colonne Annuel)… » reprend `docs.budget.steps[3]` ; « - La colonne Annuel additionne automatiquement les 12 mois — un avertissement apparaît… » reprend `docs.budget.tips[0]` ; la puce des catégories parentes reprend `docs.budget.tips[2]`. - Rapports : « … En bas, quatre cartes mènent aux quatre sous-rapports dédiés. » finit par « En bas, cinq cartes mènent aux cinq sous-rapports dédiés. » ; le titre « ### Rapport Zoom catégorie (`/reports/category`) » devient « ### Rapport Analyse par catégorie (`/reports/category`) » ; « (dans le zoom catégorie, la liste des faits saillants… » devient « (dans l'analyse par catégorie, la liste des faits saillants… » ; « - Le zoom catégorie est **protégé** » devient « - L'analyse par catégorie est **protégée** ». - Transactions : « 5. Pour ajouter une règle de mot-clé depuis une transaction, cliquez sur l'icône + et entrez le mot-clé » reprend `docs.transactions.steps[4]`. - Restent tels quels : « Les 4 cartes KPI et leurs formules », « il bascule les 4 cartes » (page Cartes), « flipper les 4 cartes » et l'avertissement « solde périmé » du Bilan. ## Fichiers concernés - `src/i18n/locales/fr.json`, `src/i18n/locales/en.json` - `docs/guide-utilisateur.md` - `CHANGELOG.md`, `CHANGELOG.fr.md` ## Depends on - #430 > Lien d'ordre : mêmes fichiers (`fr.json`, `en.json`, guide, CHANGELOG) que les issues précédentes de la pile. ## Tests - Aucun test de comportement. `src/components/settings/DocsContent.locales.test.ts` contrôle la forme des clés `docs.*` en FR et en EN : il reste vert (mêmes longueurs de tableaux dans les deux langues). - Contrôle : `grep -n -P 'bouton de répartition|split button|avertissement apparaît si les totaux|warning appears if monthly|via les onglets|using the tabs|quatre (sous-rapports|cartes de navigation|cartes mènent)|four (dedicated|navigation cards)|\+ 4 (cartes de navigation|navigation cards)|icône \+|the \+ icon|[Zz]oom catégorie|[Cc]ategory [Zz]oom' src/i18n/locales/*.json docs/guide-utilisateur.md` ne rend rien. ## Critères d'acceptation - [ ] Les défauts listés au contexte ont disparu de l'aide (bouton ? des pages) et du guide (Markdown et intégré), en FR et en EN. - [ ] Le `grep` de contrôle ne rend rien, et les phrases à garder sont intactes. - [ ] `npm run build` et `npm test` verts. ## Review caveats - 🔴 Technique, résolu : le contrôle `grep` d'origine attrapait des phrases justes (« Les 4 cartes KPI », « il bascule les 4 cartes », l'avertissement du Bilan) ; il est ciblé et les phrases à garder sont listées. - 🟡 Technique, résolu : la table oubliait `docs.reports.steps[0]` et trois mentions de « zoom catégorie » sous un titre renommé ; elles sont ajoutées. ## Décisions prises en planification - Remplacements validés par Max le 2026-10-12 ; l'aide et le guide nomment les rapports par leur titre affiché (« Analyse par catégorie »). - Le contrôle mort de la colonne Annuel (`BudgetTable.tsx:342-349`) reste en place. ## Conventions - Toute chaîne en FR et en EN (`src/i18n/locales/fr.json`, `en.json`) ; les textes de ce corps s'écrivent mot pour mot (FR validé par Max le 2026-10-12, EN rédigé sur le même contenu). - Phrase de carte : un contrôle cité passe par `StepCardText.labels` (`src/utils/onboardingPath.ts`), traduit par `StepCard` ; jamais recopié dans la phrase. Guillemets « » en FR et “ ” en EN autour de chaque libellé de contrôle interpolé ; `{{filter, lowercase}}` sans guillemets. - CHANGELOG : une entrée sous `## [Unreleased]` dans `CHANGELOG.md` et `CHANGELOG.fr.md`. - Tests de rendu : `renderToStaticMarkup` (pas de jsdom) et le faux `t` partagé livré par #389. - Aucune migration ; `npm run build` (il vérifie aussi les types des fichiers de test) et `npm test` verts. - Guide Markdown (`docs/guide-utilisateur.md`) : repérer une ligne par son texte cité, pas par son numéro. ## CHANGELOG Fixed / Corrigé : FR « Aide et guide : le Budget décrit la saisie dans la colonne Annuel (plus de bouton de répartition) et la saisie limitée aux catégories du dernier niveau ; les Rapports ont cinq cartes et plus d'onglets ; l'ajout d'un mot-clé depuis une transaction passe par le clic droit. » EN "Help and guide: Budget describes typing in the Annual column (no more split button) and that only last-level categories take an amount; Reports have five cards and no tabs; adding a keyword from a transaction goes through the right-click menu." ## Spec source `spec-plan-retours-onboarding-v0171.md` (local, ignoré par git) ; décisions dans `spec-decisions-retours-onboarding-v0171.md`.