# bfev

> Pipeline GES (bilan carbone) en 4 étapes — collecte, simulation, calcul,
> rapports — orchestré par 5 agents Claude Code communiquant uniquement par
> artefacts fichiers. Documentation rangée selon les 4 modes Diátaxis.
> Doc dev en français ; les livrables client (chaîne séparée) sont bilingues.

## Tutorials
- [Getting started](tutorials/getting-started.md): installer, configurer $BFEV_HOME, premier audit.

## How-to
- [Packaging & sharing](how-to/packaging.md): distribuer bfev (wheel Python, image Docker).
- [Automatiser le build de la doc](how-to/automatiser-la-doc.md): règles Git → rebuild (trigger×match×action, first_match_only).
- [Héberger le portail (Dokploy)](how-to/heberger-la-doc.md): servir _site/ statique derrière Traefik (image autosuffisante, aucun volume).

## Reference
- [Cheatsheet](reference/cheatsheet.md): référence d'une page, commandes.
- [Agent contracts](reference/contracts.md): I/O exact (Inputs/Outputs/postconditions) des 5 agents.
- [Testing & meta-testing](reference/testing.md): unit, contract, golden (replay + live).
- [Invariants de déterminisme](reference/invariants-determinisme.md): I1/I2/I3, état du câblage des upgrades, commande d'audit.

## Explanation
- [Architecture](explanation/architecture.md): orchestrateur + 4 sous-agents, hand-off par artefacts, single source of truth.
- [Stratégie du résidu FE — (b)+(c)](explanation/strategie-residu-FE-bc.md): récupérer-puis-gater vs estimer un nombre ; provenance vs conversion (D′-6).

## Optional
- [Contribuer à la doc](CONTRIBUTING-docs.md): règles de rédaction (un document = un mode, source unique).
- [Inventaire](_inventory.md): recensement et classement Diátaxis de la doc.