# Reference Territory KPI Crosswalk

Matrice de rapprochement inter-sources pour transformer INAO, BAN, Insee, DATAtourisme, Sirene, HVE, DGDDI, Agreste et FranceAgriMer en KPI territoire publiables.

## Cles de rapprochement

### Code commune INSEE
- Cle : `commune_code`
- Role : Cle geographique principale pour relier INAO, BAN, Insee capacite touristique, HVE, DATAtourisme et Sirene.
- Sources : inao_aoc_aop_communes, ban_address_reference, insee_tourism_capacity_communes, hve_certified_estates, datatourisme_oenotourism, sirene_wine_establishments
- Gate : Code commune present, normalise sur 5 caracteres et coherent avec le libelle commune.

### Libelle appellation normalise
- Cle : `appellation_name_normalized`
- Role : Relier les preuves reglementaires, produits SIQO, aires communales et recits appellation.
- Sources : inao_siqo_products, inao_aoc_aop_communes, eambrosia_gi, appellation_evidence_pack
- Gate : Normalisation accents/casse/ponctuation, puis revue manuelle des non-matchs.

### SIRET ou identifiant etablissement
- Cle : `siret_or_establishment_id`
- Role : Relier etablissement, activite economique, geocodage, certification et offre ouverte au public.
- Sources : sirene_wine_establishments, ban_address_reference, hve_certified_estates, tourisme_handicap_establishments
- Gate : SIRET privilegie ; sinon rapprochement nom/adresse/commune avec score et caveat.

### Empreinte adresse
- Cle : `address_fingerprint`
- Role : Controle de qualite avant carte et avant rapprochement nominatif entre lieux.
- Sources : ban_address_reference, datatourisme_oenotourism, atout_france_classified_accommodations, hve_certified_estates
- Gate : Adresse nettoyee, score BAN suffisant, longitude/latitude presentes et statut faible isole.

### Perimetre territoire
- Cle : `territory_scope`
- Role : Composer commune, departement, region, destination et appellation pour publier un KPI agregable.
- Sources : vignobles_decouvertes, insee_tourism_capacity_communes, rpg_parcels, agreste_viticulture_territorial, dgddi_vitivinicole_stocks_harvests
- Gate : Perimetre annonce explicitement : commune, departement, region, appellation ou destination.

## Recettes KPI territoire

### Score reference territoire
- Question : Ce territoire viticole est-il assez prouve pour etre publie comme reference ?
- Cles : commune_code, appellation_name_normalized, territory_scope
- Sources : inao_aoc_aop_communes, inao_siqo_products, eambrosia_gi, rpg_parcels, source_fidelity_ledger
- KPI slots : official_appellation_count, commune_coverage, vineyard_surface_ha, source_fidelity_score, publication_gate
- Famille visuelle : reference_authority
- Copy : Un territoire reference combine preuves appellation, surface viticole, sources citees et gate de publication explicite.
- Caveat : Ne pas publier comme preuve juridique sans revue des libelles et cahiers des charges.

### Score readiness oenotourisme
- Question : Le territoire a-t-il une offre et une capacite d accueil coherentes avec une promesse oenotouristique ?
- Cles : commune_code, address_fingerprint, territory_scope
- Sources : datatourisme_oenotourism, vignobles_decouvertes, insee_tourism_capacity_communes, atout_france_classified_accommodations, tourisme_handicap_establishments
- KPI slots : wine_relevant_offer_count, classified_beds, accessible_establishment_count, labeled_destination_count, offer_density_per_commune
- Famille visuelle : oenotourism_capacity
- Copy : Le potentiel oenotouristique devient publiable quand offres, capacite, labels et accessibilite racontent la meme histoire.
- Caveat : Ces KPI mesurent offre et capacite, pas frequentation reelle ni satisfaction visiteur.

### Densite economique vin
- Question : Y a-t-il assez d acteurs vin pour justifier une priorite produit, commerciale ou territoriale ?
- Cles : commune_code, siret_or_establishment_id, address_fingerprint
- Sources : sirene_wine_establishments, ban_address_reference, hve_certified_estates, tourisme_handicap_establishments
- KPI slots : active_wine_establishment_count, core_naf_share, geocoded_rate, hve_wine_related_count, address_quality_score
- Famille visuelle : business_density
- Copy : La densite business vin doit separer volume economique, qualite adresse, certification et statut pipeline.
- Caveat : Sirene et HVE peuvent contenir des donnees nominatives : usage public a cadrer, agregats a privilegier.

### Signal durabilite territoire
- Question : Le territoire dispose-t-il de preuves environnementales et qualite suffisamment visibles ?
- Cles : commune_code, siret_or_establishment_id, territory_scope
- Sources : hve_certified_estates, rpg_parcels, agreste_viticulture_territorial, inao_siqo_products
- KPI slots : hve_estate_count, hve_wine_related_rate, vineyard_surface_ha, siqo_product_count, sustainability_caveat
- Famille visuelle : wine_territory
- Copy : La durabilite devient un angle fiable seulement si HVE est rattachee au bon territoire et aux preuves viticoles.
- Caveat : HVE est un annuaire volontaire ; ne pas assimiler absence dans l annuaire a absence de certification.

### Contexte offre et marche
- Question : Quel contexte production, stocks, foncier et prix ajouter autour d un territoire ?
- Cles : territory_scope, commune_code
- Sources : dgddi_vitivinicole_stocks_harvests, agreste_vineyard_land_values, franceagrimer_bulk_prices, agreste_viticulture_territorial
- KPI slots : production_hl_total, stock_to_production_ratio, vineyard_land_value_eur_ha, bulk_price_trend, market_publication_status
- Famille visuelle : market_context
- Copy : Le contexte marche doit rester secondaire tant que les donnees prix et stocks ne sont pas normalisees et fraiches.
- Caveat : DGDDI data.gouv est historique et FranceAgriMer reste a normaliser : ne pas publier de tendance recente sans controle.

### Readiness carte publique
- Question : Les lieux peuvent-ils etre affiches sur une carte publique sans degrader la confiance ?
- Cles : address_fingerprint, commune_code, siret_or_establishment_id
- Sources : ban_address_reference, datatourisme_oenotourism, sirene_wine_establishments, atout_france_classified_accommodations, tourisme_handicap_establishments
- KPI slots : geocoded_rate, low_quality_address_count, public_place_count, accessibility_badge_count, map_gate
- Famille visuelle : source_operations
- Copy : Une carte publique doit afficher moins de lieux mais mieux sourcer adresse, statut et caveat.
- Caveat : Adresse geocodee ne prouve pas ouverture au public ; verifier chaque famille de lieux avant affichage nominatif.

## Gates qualite
- **Perimetre explicite** : Chaque KPI doit annoncer s il porte sur commune, departement, region, appellation, destination ou France entiere.
- **Agregats avant nominatif** : Publier d abord les volumes et scores agreges ; exposer les noms seulement apres revue RGPD/metier.
- **Actif vs pipeline** : Les sources metadata_only ou non importees doivent rester visibles comme contexte, pas comme KPI affirme.
- **Recu de confiance** : Chaque carte KPI doit embarquer source, date/metadonnée, transformation et caveat.