# Décisions d'architecture (ADR)

Chaque décision structurante est consignée dans un **ADR** (_Architecture Decision Record_) : le contexte, la décision, ses conséquences, et son statut. Une décision remplacée reste lisible : savoir pourquoi on a changé d'avis vaut autant que la décision elle-même.

---

## 📜 Les décisions

| ADR                                                                          | Statut                                             | En une phrase                                                                                       |
| ---------------------------------------------------------------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [001 · Source de vérité](/decisions/source-de-verite)                        | <Status tone="warn">Révisé par 008</Status>        | CRISalid reste la source maître visée ; corriger dans la source, jamais localement                  |
| [002 · Rendu et cache](/decisions/rendu-et-cache)                            | <Status tone="muted">Proposé</Status>              | Stratégie de rendu et de cache des pages                                                            |
| [003 · Base locale](/decisions/base-locale)                                  | <Status tone="muted">Proposé</Status>              | Base locale de curation et de synchronisation                                                       |
| [004 · Recherche serveur](/decisions/recherche)                              | <Status tone="warn">Remplacé par 009</Status>      | Première stratégie de recherche, côté serveur                                                       |
| [005 · Internationalisation](/decisions/i18n)                                | <Status tone="muted">Proposé</Status>              | Stratégie d'internationalisation                                                                    |
| [006 · Mesure d'audience](/decisions/analytics)                              | <Status tone="muted">Proposé</Status>              | Mesure d'audience sans données personnelles                                                         |
| [007 · Marque blanche](/decisions/instances-marque-blanche)                  | <Status tone="ok">Accepté 24/10/2026</Status>      | Une instance = un fichier de configuration et deux logos                                            |
| [008 · Sources ouvertes](/decisions/chaine-de-donnees-ouvertes)              | <Status tone="ok">Accepté 24/10/2026</Status>      | Sources ouvertes moissonnées, brut conservé                                                         |
| [009 · Recherche Pagefind](/decisions/recherche-pagefind)                    | <Status tone="ok">Accepté 24/10/2026</Status>      | Pagefind en version 1 ; deux comportements mesurés et contournés                                    |
| [010 · Personnes publiées](/decisions/publication-des-personnes)             | <Status tone="warn">Provisoire</Status>            | Quelles personnes publier, en attendant la DPO et un annuaire des personnels                        |
| [011 · Domaines HAL](/decisions/rattachement-par-domaines)                   | <Status tone="warn">Provisoire</Status>            | Rattachement aux Graduate Schools calculé depuis les domaines HAL, en attendant la liste officielle |
| [012 · Version anglaise](/decisions/version-anglaise)                        | <Status tone="ok">Accepté 25/10/2026</Status>      | Anglais sous `/en`, français sans préfixe                                                           |
| [013 · Annuaire officiel](/decisions/liste-officielle-et-annuaire-generique) | <Status tone="ok">Accepté 25/10/2026</Status>      | L'annuaire de l'établissement comme liste officielle, lu par un parseur générique                   |
| [014 · Licence MIT](/decisions/licence)                                      | <Status tone="muted">Proposé, à confirmer</Status> | MIT pour le socle, titulaire des droits à confirmer                                                 |

---

## 🔗 Comment les décisions s'enchaînent

<Mermaid
  title="Filiation des décisions"
  chart={`flowchart LR
  A001["001 Source de vérité"] -->|révisé par| A008["008 Chaîne de données ouvertes"]
  A004["004 Recherche"] -->|remplacé par| A009["009 Recherche Pagefind"]
  A005["005 i18n"] -->|précisé par| A012["012 Version anglaise"]
  A007["007 Marque blanche"] --> A013["013 Liste officielle et annuaire"]
  A008 --> A010["010 Publication des personnes"]
  A008 --> A011["011 Rattachement par domaines"]
  A006["006 Analytics"] -.-> OBS["Observabilité, POC analytics"]
  A014["014 Licence MIT"]`}
/>

---

## ✍️ Écrire une décision

Un ADR tient en quatre parties : **Statut** (proposé, accepté, provisoire, remplacé, avec la date), **Contexte** (le problème, les contraintes, ce qu'on a mesuré), **Décision** (ce qu'on fait, et ce qu'on ne fait pas), **Conséquences** (ce que ça coûte, ce que ça interdit, ce qui ferait changer d'avis). Le fichier est numéroté à la suite dans `docs/08-decisions/`, et le statut de la décision qu'il remplace est mis à jour.