# Reference Normalization Runbook

Runbook central pour executer les normalisations sources Winerix dans le bon ordre, avec commandes copiables, fichiers cibles, gates et caveats.

## Phases

### Activer geographie + business
- Etapes : sirene_wine_establishments -> ban_address_reference -> qualite_tourisme_establishments -> hve_certified_estates -> agencebio_organic_wine -> agencebio_organic_viticulture_surfaces
- Pourquoi : Debloque les cartes, les scores business/durabilite bio et les rapprochements nominaux prudents.

### Ajouter contexte marche et offre
- Etapes : franceagrimer_bulk_prices -> dgddi_vitivinicole_stocks_harvests -> agreste_vineyard_land_values
- Pourquoi : Ajoute prix, production, stocks et foncier pour enrichir les pages territoire sans surpromesse.

### Passer Publication Gate
- Etapes : reference_territory_score_calculator -> reference_publication_gate -> territory_reference_page
- Pourquoi : Publier seulement les scores hydrates, caveates et traçables.

## Commandes

### P1 - Sirene etablissements vin
- Cle : `sirene_wine_establishments`
- Input : `sources/sirene-stock-etablissements.csv`
- Output : `sources/sirene-wine-establishments-normalized.csv`
- Schema : `sources/sirene-wine-establishments-normalized.schema.csv`
- Commande : `php scripts/normalize_sirene_wine_establishments.php`
- Debloque : Densite business vin, agregats par commune/NAF, rapprochements BAN/HVE.
- Gate : Stock Sirene present localement ; publier agregats avant tout nominatif.
- Caveat : Donnees nominatives : RGPD/metier avant listing public.

### P2 - BAN qualite adresse
- Cle : `ban_address_reference`
- Input : `sources/ban-address-quality-input.csv`
- Output : `sources/ban-address-quality.csv`
- Schema : `sources/ban-address-quality.schema.csv`
- Commande : `php scripts/normalize_ban_address_quality.php`
- Debloque : Cartes fiables, score adresse, isolation des lieux a relire.
- Gate : Export lieux Winerix rempli avec adresses, communes, coordonnees ou scores BAN.
- Caveat : Adresse geocodee ne prouve pas ouverture au public ni frequentation.

### P3 - Insee frequentation hebergements touristiques
- Cle : `insee_tourism_occupancy`
- Input : `sources/insee-tourism-occupancy.zip`
- Output : `sources/insee-tourism-occupancy-normalized.csv`
- Schema : `sources/insee-tourism-occupancy.schema.csv`
- Commande : `php scripts/normalize_insee_tourism_occupancy.php`
- Debloque : Demande touristique officielle, benchmarks offre/demande, contexte nuitees/arrivees/occupation.
- Gate : Archive Insee presente ; respecter niveaux geo, unites et confidentialite.
- Caveat : Demande hebergements generale, pas attribution oenotouristique directe.

### P3 - Qualite Tourisme etablissements
- Cle : `qualite_tourisme_establishments`
- Input : `sources/qualite-tourisme-establishments.csv`
- Output : `sources/qualite-tourisme-establishments-normalized.csv`
- Schema : `sources/qualite-tourisme-establishments.schema.csv`
- Commande : `php scripts/normalize_qualite_tourisme_establishments.php`
- Debloque : Signal qualite accueil, carte qualite, rapprochements DATAtourisme/V&D.
- Gate : CSV officiel present ; lien vin a relire ou a deduire par rapprochement source.
- Caveat : Label accueil/prestations, pas frequentation ni preuve oenotouristique directe.

### P3 - Exploitations certifiees HVE
- Cle : `hve_certified_estates`
- Input : `sources/hve-certified-estates.csv`
- Output : `sources/hve-certified-estates-normalized.csv`
- Schema : `sources/hve-certified-estates-normalized.schema.csv`
- Commande : `php scripts/normalize_hve_certified_estates.php`
- Debloque : Signal durabilite territorial, rapprochements domaines/Sirene/BAN.
- Gate : CSV officiel HVE present ; relire le filtrage vin textuel avant publication forte.
- Caveat : Annuaire volontaire : absence du fichier ne prouve pas absence de certification.

### P4 - BNSC stationnement cyclable
- Cle : `bnsc_bike_parking`
- Input : `sources/bnsc-bike-parking.zip`
- Output : `sources/bnsc-bike-parking-normalized.csv`
- Schema : `sources/bnsc-bike-parking.schema.csv`
- Commande : `php scripts/normalize_bnsc_bike_parking.php`
- Debloque : Mobilite douce par commune, capacite stationnement velo, carte accessibilite velo caveatee.
- Gate : ZIP BNSC present ; respecter attribution OSM/ODbL et signal non exhaustif.
- Caveat : Source OSM contributive : ne pas presenter comme label Accueil Velo ni frequentation.

### P4 - Agence Bio operateurs bio vin
- Cle : `agencebio_organic_wine`
- Input : `sources/agencebio-professionnels-bio.csv`
- Output : `sources/agencebio-organic-wine-operators-normalized.csv`
- Schema : `sources/agencebio-organic-wine.schema.csv`
- Commande : `php scripts/normalize_agencebio_organic_wine.php`
- Debloque : Signal bio vin officiel, agregats par territoire, rapprochements SIRET/Sirene/BAN.
- Gate : CSV operateurs bio present ; filtrage vin textuel et publication en agregat avant nominatif.
- Caveat : Annuaire declaratif valide par certificateurs ; groupe culture VI requis pour les surfaces bio viticoles.

### P5 - Agence Bio surfaces viticoles bio communales
- Cle : `agencebio_organic_viticulture_surfaces`
- Input : `https://www.data.gouv.fr/api/1/datasets/r/801d6a5a-bca8-4048-a559-e052e8f288aa`
- Output : `sources/agencebio-organic-viticulture-surfaces-normalized.csv`
- Schema : `sources/agencebio-organic-viticulture-surfaces.schema.csv`
- Commande : `php scripts/normalize_agencebio_organic_viticulture_surfaces.php`
- Debloque : Surfaces viticoles bio/conversion par commune, agregats territoire, score bio vin plus robuste.
- Gate : Flux CSV Agence Bio surfaces production accessible ; filtrer code_groupe=VI et publier en agregat.
- Caveat : VI correspond a la viticulture et inclut une faible part de raisin de table.

### P6 - FranceAgriMer prix vrac
- Cle : `franceagrimer_bulk_prices`
- Input : `sources/franceagrimer-prices-input.csv`
- Output : `sources/franceagrimer-prices.csv`
- Schema : `sources/franceagrimer-prices.schema.csv`
- Commande : `php scripts/normalize_franceagrimer_bulk_prices.php`
- Debloque : Contexte prix marche, mini tendances, cartes marche caveatees.
- Gate : Export manuel Visionet rempli et prix controles.
- Caveat : Prix France/segment large, pas prix appellation/local par defaut.

### P7 - DGDDI recoltes et stocks
- Cle : `dgddi_vitivinicole_stocks_harvests`
- Input : `sources/dgddi-vitivinicole-stocks-harvests-input.csv`
- Output : `sources/dgddi-vitivinicole-stocks-harvests.csv`
- Schema : `sources/dgddi-vitivinicole-stocks-harvests.schema.csv`
- Commande : `php scripts/normalize_dgddi_vitivinicole_supply.php`
- Debloque : Contexte offre vitivinicole, surfaces, recoltes, stocks, declarations.
- Gate : XLS historiques convertis/remplis dans le template ; verifier DataDouane pour donnees recentes.
- Caveat : Jeu historique : ne pas publier comme conjoncture recente sans controle.

### P8 - Agreste valeur venale vignes
- Cle : `agreste_vineyard_land_values`
- Input : `sources/agreste-vineyard-land-values-input.csv`
- Output : `sources/agreste-vineyard-land-values.csv`
- Schema : `sources/agreste-vineyard-land-values.schema.csv`
- Commande : `php scripts/normalize_agreste_vineyard_land_values.php`
- Debloque : Contexte foncier, rarete, attractivite, slide investisseur.
- Gate : Lignes vignes isolees et prix moyen/min/max EUR/ha relus.
- Caveat : Valeurs SAFER lissees : pas transaction brute ni expertise fonciere.

## Script batch manuel

```bash
# Sirene etablissements vin
php scripts/normalize_sirene_wine_establishments.php

# BAN qualite adresse
php scripts/normalize_ban_address_quality.php

# Insee frequentation hebergements touristiques
php scripts/normalize_insee_tourism_occupancy.php

# Qualite Tourisme etablissements
php scripts/normalize_qualite_tourisme_establishments.php

# Exploitations certifiees HVE
php scripts/normalize_hve_certified_estates.php

# BNSC stationnement cyclable
php scripts/normalize_bnsc_bike_parking.php

# Agence Bio operateurs bio vin
php scripts/normalize_agencebio_organic_wine.php

# Agence Bio surfaces viticoles bio communales
php scripts/normalize_agencebio_organic_viticulture_surfaces.php

# FranceAgriMer prix vrac
php scripts/normalize_franceagrimer_bulk_prices.php

# DGDDI recoltes et stocks
php scripts/normalize_dgddi_vitivinicole_supply.php

# Agreste valeur venale vignes
php scripts/normalize_agreste_vineyard_land_values.php

```