Architecture Decision Records
Les ADRs tracent les décisions structurelles du projet : contexte, options considérées, choix retenu et conséquences. Ils permettent à un nouveau contributeur de comprendre pourquoi le code est organisé ainsi, sans avoir à reconstruire l'historique.
Format
Chaque ADR suit la structure :
- Contexte — situation qui impose une décision
- Options considérées — alternatives avec pour/contre
- Décision — choix retenu et justification
- Conséquences — impacts positifs, risques acceptés
- Révision — conditions qui remettraient la décision en question
Règle du projet
Toute décision structurelle (choix de lib, nouveau pattern, changement d'architecture, dérogation à une convention) doit faire l'objet d'un ADR avant toute ligne de code. Voir CLAUDE.md section « Après chaque décision technique significative ».
L'agent architect rédige les ADRs directement dans ce dossier.
Liste des ADRs
| ID | Titre | Statut | Date |
|---|---|---|---|
| ADR-001 | PostgreSQL vs MongoDB | Accepté | 2026-04-16 |
| ADR-002 | CSV-first, Nordigen repoussé en V2 | Accepté | 2026-04-16 |
| ADR-003 | Authentification single-user via variables d'environnement | Accepté | 2026-04-16 |
| ADR-004 | Outillage de documentation : Docusaurus v3 auto-hébergé | Accepté | 2026-04-23 |
| ADR-005 | Agent Claude dédié docs-specialist | Accepté | 2026-04-23 |
| ADR-006 | Migration vers Authentik OIDC et architecture multi-utilisateurs | Accepté | 2026-04-25 |