Aller au contenu

Comprendre Budget Familial OS

Extrait de CLAUDE.md :

CLAUDE.md — Budget Familial OS (project-internal)

Compressé 2026-05-08 (cf. 00_PILOTAGE/P22_CLAUDE_CODE_METHODOLOGY_REVIEW.md). Ce fichier est l'unique CLAUDE.md du projet (racine git = racine projet depuis l'aplatissement Bloc C, 2026-05-30).

Source canonique globale : WORKSPACE\40_REGLES_ET_METHODE\ — en cas de divergence avec une copie locale, GLOBAL prime.

Mission

Système local : ingestion → Firefly → Metabase + Excel. Exploitable par utilisateur non technique.

Doctrine produit

  • Firefly III moteur, Metabase cockpit, Portail Flask point d'entrée, Excel MASTER export secondaire.
  • Python pour ingestion / parsing / normalisation / export. n8n hors V1. Pas de dashboard React, pas de Firefly UI comme interface principale, pas de moteur financier maison.

Doctrine data-first (Phase 2.0+)

  • Source primaire = PDF natif téléchargé depuis le portail bancaire officiel.
  • Voie active : parsers/parser_boursorama_native.py (extract_words pdfplumber + classement coordonnée x). Extension progressive aux autres banques.
  • ZIP-OCR P16 déprécié depuis 2026-05-06 (cf. P21.8-D verdict H5). Archive seule sous budget_os/source_of_truth/zipped_ocr_legacy/.
  • Quality Gates Phase 2.0 zéro tolérance : G_DIR + G1..G7 + G6bis. Aucun push avant tous gates verts (G2 = 0,00 € strict).
  • Aucune correction métier manuelle, aucun fallback Vision, aucun bypass G2 / G_DIR.

Classification source_of_truth (P21.9-ter)

Détail : 00_PILOTAGE/P21_9_TER_FT_CAF_VERDICT.md. - transaction_sources : relevés bancaires PDF natifs (balance + mouvements). Génèrent des ExtractedTx typés. Soumis aux Quality Gates. - proof_documents : justificatifs (paie, CAF, avis d'imposition, factures). Marker _PROOF_DOCUMENT.md dans le dossier source. Aucun parser transactionnel. Peuvent enrichir un tag mais jamais créer une transaction (sinon G5 anti-synthétique cassé).

Ce que contient cette rubrique

  • Une synthèse (page d'accueil du projet).
  • Les décisions, livrables, prompts, références détectés.
  • Un index archives techniques vers les autres fichiers, sans dump ni secret.