[GMartin-Data]

Contexte

Finalisation de la documentation projet (US10, tâches T10.1 à T10.7) — livrable
direct de la soutenance. Le README décrivait un périmètre périmé à 3 sources
alors que le pipeline en production en compte 7 (orchestration cross-Job,
monitoring, mart unifié). Cette PR aligne toute la doc livrable sur l'état réel
du code sur main.

Travail mené en inter-bloc. La doc préparatoire interne (datatalent_docs/)
reste hors repo ; seule la synthèse livrable est versionnée ici.

Décisions techniques

Sujet	Choix	Justification
Fidélité de la doc	État réel du code sur main (7 sources)	Le README à 3 sources sous-vendait le projet ; les 4 sources complémentaires résolvent un trou du use case (pivot D14-bis : SIRET absent des offres)
Schéma d'archi (T10.3)	Mermaid natif dans docs/architecture.md	GitHub rend le Mermaid nativement ; évite des binaires PNG/SVG versionnés qui dérivent du source. Écart assumé vs la lettre de T10.3
Catalogue (T10.4)	meta + tags sous bloc config:	Syntaxe dbt ≥ 1.10 (vérifiée sur la doc officielle), validée par dbt parse
Migration docs sources (T10.6)	Synthèse condensée, pas de migration intégrale	Le récit sources vit dans le README, le détail par modèle dans le catalogue dbt — pas de double source de vérité
Lignage (T10.5)	Section README « générer/consulter en local »	dbt docs serve est un serveur local ; target/ est gitignored — site régénérable, pas de binaire figé
Script de démo (T10.7)	Hors repo (datatalent_docs/demo/)	Artefact opérationnel de soutenance, pas un livrable repo

Changements

• README.md — réécriture complète : question centrale, récit 3→7 sources,
  architecture (flux + renvoi), stack par couche avec choix GCP justifiés,
  structure du repo, section déploiement Terraform (bootstrap state D30,
  image placeholder D73, terraform apply, garde-fou zéro diff D31), section
  catalogue & lignage dbt.
• docs/architecture.md (nouveau) — 3 vues Mermaid : acquisition, transformations
  dbt, infrastructure. Cohérentes avec infra/ et dbt/.
• dbt/models/**/_*__models.yml (9 fichiers, 14 modèles) — ajout config.meta
  (owner, update_frequency: hebdomadaire) + tags fonctionnels par couche, et
  tags: ['pii'] sur les 7 colonnes objectivement personnelles (identifiants/noms
  d'entreprise Sirene + entreprise_nom).

Validation

$ uv run dbt parse
Running with dbt=1.11.7 — Registered adapter: bigquery=1.11.1
(aucune erreur)

$ uv run dbt docs generate
Found 178 data tests, 14 models, 9 sources, 658 macros
Catalog written to target/catalog.json

# meta/tags propagés sur les 14 modèles (extrait manifest.json)
fct_offres                        owner=Greg     tags=['mart','analytique']
stg_sirene__etablissements        owner=Quentin  tags=['staging','sirene']
...
# 7 colonnes taguées pii : siret, siren, denomination_usuelle, enseigne,
# stg_france_travail.entreprise_nom, stg_adzuna.entreprise_nom,
# int_offres_enrichies.entreprise_nom

Les 3 blocs Mermaid de docs/architecture.md ont été validés syntaxiquement
(génération SVG via mermaid-cli, sans erreur).

Refs

T10.1, T10.2, T10.3, T10.4, T10.5, T10.6, T10.7, D28, D59

[ESNAULTQ]

Je te donne le droit!