# Reference KPI Dependency Map

Carte de dependances KPI Winerix : relie scores territoire, composants, sources, outputs de normalisation et gates de publication.

## Synthese
- Scores : 7
- Dependances composants : 27
- Sources uniques : 23
- Outputs normalisation : 20

## Dependances

### Territory Reference Score
- `regulatory_proof` : inao_aoc_aop_communes, inao_siqo_products, eambrosia_gi
  - Outputs : sources/inao-aoc-aop-communes.csv, sources/inao-siqo-products.csv
  - Gate : Preuves INAO/eAmbrosia visibles et caveat juridique conserve.
- `source_fidelity` : reference_source_fidelity, source_refresh_policy
  - Outputs : sources/source-refresh-policy.csv
  - Gate : Source Fidelity Ledger et politique de fraicheur disponibles.
- `vineyard_footprint` : rpg_parcels, agreste_viticulture_territorial
  - Outputs : sources/rpg-vineyard-parcels.csv
  - Gate : RPG vigne filtre et surface territoriale relue.

### Oenotourism Readiness Score
- `wine_offer_density` : datatourisme_oenotourism
  - Outputs : sources/datatourisme-oenotourism.csv
  - Gate : Offres vin filtrees et faux positifs controles.
- `accommodation_capacity` : insee_tourism_capacity_communes, atout_france_classified_accommodations
  - Outputs : sources/insee-tourism-capacity-communes-2026.csv, sources/atout-france-classified-accommodations.csv
  - Gate : Capacite communale presente et rattachee au territoire.
- `tourism_demand_signal` : insee_tourism_occupancy, insee_tourism_capacity_communes
  - Outputs : sources/insee-tourism-occupancy-normalized.csv, sources/insee-tourism-capacity-communes-2026.csv
  - Gate : Frequentation Insee normalisee et interpretee comme demande touristique generale, pas frequentation vin.
- `quality_reception_signal` : qualite_tourisme_establishments, datatourisme_oenotourism, vignobles_decouvertes
  - Outputs : sources/qualite-tourisme-establishments-normalized.csv, sources/datatourisme-oenotourism.csv
  - Gate : Qualite Tourisme normalise et rapproche avec offres vin ou communes viticoles avant publication forte.
- `bike_access_signal` : bnsc_bike_parking, ban_address_reference
  - Outputs : sources/bnsc-bike-parking-normalized.csv, sources/ban-address-quality.csv
  - Gate : Stationnements cyclables normalises, agreges par commune et attribues OSM/ODbL.
- `accessibility_signal` : tourisme_handicap_establishments
  - Outputs : sources/tourisme-handicap-establishments.csv
  - Gate : Label accessibilite actif et caveat conserve.
- `address_quality` : ban_address_reference
  - Outputs : sources/ban-address-quality.csv
  - Gate : BAN Quality Gates au moins review/map_ready pour les lieux affiches.

### Wine Business Density Score
- `active_wine_establishment_density` : sirene_wine_establishments
  - Outputs : sources/sirene-wine-establishments-normalized.csv
  - Gate : Sirene normalise, actifs filtres et publication en agregat par defaut.
- `core_naf_share` : sirene_wine_establishments, wine_naf_codes
  - Outputs : sources/wine-naf-codes.csv, sources/sirene-wine-establishments-normalized.csv
  - Gate : Codes NAF coeur/adjacent relus avant score.
- `sustainability_signal` : hve_certified_estates, agencebio_organic_wine
  - Outputs : sources/hve-certified-estates-normalized.csv, sources/agencebio-organic-wine-operators-normalized.csv
  - Gate : HVE et Agence Bio normalises avec filtrage vin relu et publication en agregat.

### Sustainable Wine Signal
- `hve_wine_related_density` : hve_certified_estates
  - Outputs : sources/hve-certified-estates-normalized.csv
  - Gate : Annuaire HVE volontaire et signal vin textuel visibles dans le caveat.
- `organic_wine_operator_density` : agencebio_organic_wine
  - Outputs : sources/agencebio-organic-wine-operators-normalized.csv, sources/agencebio-organic-viticulture-surfaces-normalized.csv
  - Gate : Operateurs bio vin et surfaces VI normalises puis publies en agregat territoire.
- `siqo_product_signal` : inao_siqo_products
  - Outputs : sources/inao-siqo-products.csv
  - Gate : Produits SIQO vin filtres et statuts controles.
- `vineyard_surface_context` : rpg_parcels, agreste_viticulture_territorial
  - Outputs : sources/rpg-vineyard-parcels.csv
  - Gate : Surface viticole rattachee au bon perimetre.

### Organic Wine Sustainability Score
- `organic_operator_density` : agencebio_organic_wine
  - Outputs : sources/agencebio-organic-wine-operators-normalized.csv
  - Gate : Operateurs bio lies au vin normalises et agreges par territoire.
- `organic_viticulture_surface_context` : agencebio_organic_wine
  - Outputs : sources/agencebio-organic-viticulture-surfaces-normalized.csv
  - Gate : Surfaces bio viticoles communales filtrees code_groupe=VI et agregees au bon territoire.
- `certifier_diversity_signal` : agencebio_organic_wine
  - Outputs : sources/agencebio-organic-wine-operators-normalized.csv
  - Gate : Certificateurs presents et relus avant comparaison territoriale.
- `hve_complement_signal` : hve_certified_estates, agencebio_organic_wine
  - Outputs : sources/hve-certified-estates-normalized.csv, sources/agencebio-organic-wine-operators-normalized.csv, sources/agencebio-organic-viticulture-surfaces-normalized.csv
  - Gate : Ne pas confondre Bio et HVE ; afficher deux badges source distincts et agreger les surfaces VI.

### Supply & Market Context Score
- `production_context` : dgddi_vitivinicole_stocks_harvests
  - Outputs : sources/dgddi-vitivinicole-stocks-harvests.csv
  - Gate : DGDDI normalise et caveat DataDouane visible.
- `land_value_context` : agreste_vineyard_land_values
  - Outputs : sources/agreste-vineyard-land-values.csv
  - Gate : Prix vignes EUR/ha relus, caveat SAFER conserve.
- `bulk_price_context` : franceagrimer_bulk_prices
  - Outputs : sources/franceagrimer-prices.csv
  - Gate : FranceAgriMer normalise comme contexte marche, pas prix local.

### Map Publication Readiness
- `geocoded_rate` : ban_address_reference
  - Outputs : sources/ban-address-quality.csv
  - Gate : Coordonnees presentes et statut map_ready/review explicite.
- `source_type_clarity` : datatourisme_oenotourism, sirene_wine_establishments, atout_france_classified_accommodations
  - Outputs : sources/datatourisme-oenotourism.csv, sources/sirene-wine-establishments-normalized.csv
  - Gate : Famille de lieu explicite avant affichage public.
- `privacy_gate` : sirene_wine_establishments, hve_certified_estates
  - Outputs : sources/sirene-wine-establishments-normalized.csv, sources/hve-certified-estates-normalized.csv
  - Gate : Agregats avant nominatif et revue RGPD/metier.