docs(balance): ADR 0014 + reject 0012 + guide + changelog #209

Merged

maximus merged 1 commit from issue-205-adr-0014-guide-changelog into main

2026-06-02 01:18:47 +00:00

maximus commented

2026-06-02 01:15:39 +00:00

Owner

Fixes #205

Final, docs-only issue of overnight-2026-06-01-bilan-axe-vehicule. Documents what shipped in #202/#203/#204 (already merged into main).

Livrables

ADR 0014 (docs/adr/0014-balance-vehicule-attribut.md, Accepted 2026-06-01) — le véhicule fiscal est un attribut du compte (vehicle_type), la catégorie est une pure classe d'actif. Contexte = racine du modèle plat de l'audit + trajectoire additive (Étape 1). Conséquences = migrations v12/v13, 5 classes d'actif, renommage via custom_label, deux axes de lecture. Étape 2 (détail par titre / balance_securities / book cost) explicitement hors scope.
ADR 0012 → Rejected (jamais accepté — pas Superseded), daté 2026-06-01, pointeur vers 0014 + raison (trajectoire additive vs modèle deux-tables surdimensionné). Corps inchangé.
Guide utilisateur (markdown + clés i18n docs.balance.* FR/EN) — enveloppe fiscale optionnelle, deux axes du graphique (classe par défaut / enveloppe), renommage de type, et la note historique : l'axe « par classe d'actif » recalcule sur la catégorie courante, donc un snapshot pré-migration d'un compte ex-CELI/REER apparaît sous « Autres » (comportement attendu).
CHANGELOG.md + CHANGELOG.fr.md sous [Unreleased], parité EN/FR (Added 4/4, Changed 4/4) : enveloppe fiscale, axe enveloppe, rendements repliables, catégorie = classe d'actif pure, reclass CELI/REER → Autres, renommage ne casse plus la traduction (bug I), note de reclass historique.

Vérif

npm run build vert (tsc + vite + syncChangelogs() → public/ synced, CHANGELOGs bien formés).
ADR 0014 présent ; 0012 = Rejected + pointeur 0014 ; parité EN/FR des entrées [Unreleased].

🤖 Generated with Claude Code

Fixes #205 Final, docs-only issue of `overnight-2026-06-01-bilan-axe-vehicule`. Documents what shipped in #202/#203/#204 (already merged into main). ## Livrables - **ADR 0014** (`docs/adr/0014-balance-vehicule-attribut.md`, *Accepted* 2026-06-01) — le véhicule fiscal est un attribut du compte (`vehicle_type`), la catégorie est une pure classe d'actif. Contexte = racine du modèle plat de l'audit + trajectoire additive (Étape 1). Conséquences = migrations v12/v13, 5 classes d'actif, renommage via `custom_label`, deux axes de lecture. **Étape 2 (détail par titre / `balance_securities` / book cost) explicitement hors scope.** - **ADR 0012** → **Rejected** (jamais accepté — *pas* Superseded), daté 2026-06-01, pointeur vers 0014 + raison (trajectoire additive vs modèle deux-tables surdimensionné). Corps inchangé. - **Guide utilisateur** (markdown + clés i18n `docs.balance.*` FR/EN) — enveloppe fiscale optionnelle, deux axes du graphique (classe par défaut / enveloppe), renommage de type, et la **note historique** : l'axe « par classe d'actif » recalcule sur la catégorie courante, donc un snapshot pré-migration d'un compte ex-CELI/REER apparaît sous « Autres » (comportement attendu). - **CHANGELOG.md + CHANGELOG.fr.md** sous `[Unreleased]`, parité EN/FR (Added 4/4, Changed 4/4) : enveloppe fiscale, axe enveloppe, rendements repliables, catégorie = classe d'actif pure, reclass CELI/REER → Autres, renommage ne casse plus la traduction (bug I), note de reclass historique. ## Vérif - `npm run build` vert (tsc + vite + `syncChangelogs()` → public/ synced, CHANGELOGs bien formés). - ADR 0014 présent ; 0012 = Rejected + pointeur 0014 ; parité EN/FR des entrées [Unreleased]. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

maximus added 1 commit 2026-06-02 01:15:40 +00:00

docs(balance): ADR 0014 + reject 0012 + guide + changelog (#205 )

PR Check / rust (pull_request) Successful in 22m24s

Details

PR Check / frontend (pull_request) Successful in 2m22s

Details

ebc709a277

Document Étape 1 of the balance audit (vehicle_type axis), already shipped
in #202/#203/#204:
- ADR 0014 (Accepted): fiscal envelope is an account attribute, the category
  is a pure asset class; Étape 2 (per-security detail) explicitly out of scope.
- ADR 0012 marked Rejected (never accepted, not Superseded) + pointer to 0014.
- User guide (markdown + in-app docs.balance i18n FR/EN): optional fiscal
  envelope, the two chart axes, type renaming, and the historical-reclass note.
- CHANGELOG.md + CHANGELOG.fr.md [Unreleased]: Added (envelope field, envelope
  axis, collapsible returns) + Changed (asset-class category, CELI/REER reclass,
  rename no longer alters translation, historical-reclass note).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

maximus commented

2026-06-02 01:17:56 +00:00

Author

Owner

Review — APPROVE ✅

Revue indépendante (orchestrateur /sprint). Docs vérifiées sur la branche.

Vérifications

✅ ADR 0014 créé (Accepted, 2026-06-01) : « le véhicule fiscal est un attribut du compte, la classe d'actif est la catégorie ». Contexte = findings de l'audit ; section « Pourquoi additif » vs le modèle deux-tables de 0012 ; Étape 2 (balance_securities / book_cost / détail par titre) explicitement hors scope ; conséquence « historique re-affiché sous Autres » documentée.
✅ ADR 0012 → Rejected (pas Superseded — caveat LOW respecté : 0012 n'a jamais quitté Proposed), pointeur vers 0014 + raison (trajectoire additive). Corps non réécrit.
✅ Guide : markdown + clés in-app docs.balance.* (FR/EN) mises à jour — le worker a corrigé le contenu périmé (« 7 types » incl. CELI/REER → 5 classes d'actif ; CELI/REER désormais présentés comme enveloppes). Note historique présente. Parité FR/EN : title/overview/features(14)/steps(9)/tips(7).
✅ CHANGELOG EN + FR sous [Unreleased], parité (3 Added + 3 Changed) : enveloppe fiscale, axe enveloppe du graphique, rendements repliables ; reclass type→classe d'actif, note historique, fix bug I (renommage). npm run build ok (syncChangelogs + parse OK).

Bonus : catch hors-périmètre strict mais conforme CLAUDE.md — les clés docs.balance.* de l'app (DocsContent.tsx) étaient périmées et ont été synchronisées avec le markdown.

Verdict : APPROVE.

## Review — APPROVE ✅ Revue indépendante (orchestrateur `/sprint`). Docs vérifiées sur la branche. **Vérifications** - ✅ **ADR 0014** créé (`Accepted`, 2026-06-01) : « le véhicule fiscal est un attribut du compte, la classe d'actif est la catégorie ». Contexte = findings de l'audit ; section « Pourquoi additif » vs le modèle deux-tables de 0012 ; **Étape 2 (`balance_securities` / `book_cost` / détail par titre) explicitement hors scope** ; conséquence « historique re-affiché sous Autres » documentée. - ✅ **ADR 0012 → Rejected** (pas *Superseded* — caveat LOW respecté : 0012 n'a jamais quitté `Proposed`), pointeur vers 0014 + raison (trajectoire additive). Corps non réécrit. - ✅ **Guide** : markdown + **clés in-app `docs.balance.*`** (FR/EN) mises à jour — le worker a corrigé le contenu périmé (« 7 types » incl. CELI/REER → 5 classes d'actif ; CELI/REER désormais présentés comme enveloppes). Note historique présente. Parité FR/EN : title/overview/features(14)/steps(9)/tips(7). - ✅ **CHANGELOG** EN + FR sous `[Unreleased]`, parité (3 Added + 3 Changed) : enveloppe fiscale, axe enveloppe du graphique, rendements repliables ; reclass type→classe d'actif, note historique, fix bug I (renommage). `npm run build` ok (syncChangelogs + parse OK). **Bonus** : catch hors-périmètre strict mais conforme CLAUDE.md — les clés `docs.balance.*` de l'app (`DocsContent.tsx`) étaient périmées et ont été synchronisées avec le markdown. Verdict : **APPROVE**.