# Reference Territory KPI Formula Book

Livre de formules pour rendre les KPI territoire Winerix coherents, ponderes, caveates et comparables.

## Formules

### Territory Reference Score
- Cle : `territory_reference_score`
- Question : Le territoire est-il assez prouve, source et caveate pour etre publie comme reference Winerix ?
- Echelle : 0-100
- Formule : `0.35 * regulatory_proof + 0.20 * source_fidelity + 0.15 * vineyard_footprint + 0.15 * data_freshness + 0.15 * publication_readiness`
- Sources : inao_aoc_aop_communes, inao_siqo_products, eambrosia_gi, rpg_parcels, reference_source_fidelity, reference_publication_gate
- Gate minimum : Publier seulement si les preuves INAO/eAmbrosia/SIQO sont visibles et si le caveat principal est present.
- Copy : Score reference : synthese ponderee des preuves officielles, de la fidelite source, de l empreinte viticole et du gate de publication.
- Famille visuelle : reference_authority
- Poids :
  - regulatory_proof : 35%
  - source_fidelity : 20%
  - vineyard_footprint : 15%
  - data_freshness : 15%
  - publication_readiness : 15%

### Oenotourism Readiness Score
- Cle : `oenotourism_readiness_score`
- Question : Le territoire a-t-il assez d offre, de capacite et de labels pour soutenir une promesse oenotouristique ?
- Echelle : 0-100
- Formule : `0.20 * wine_offer_density + 0.17 * accommodation_capacity + 0.14 * tourism_demand_signal + 0.12 * destination_label_signal + 0.11 * quality_reception_signal + 0.08 * bike_access_signal + 0.08 * accessibility_signal + 0.10 * address_quality`
- Sources : datatourisme_oenotourism, insee_tourism_capacity_communes, insee_tourism_occupancy, atout_france_classified_accommodations, vignobles_decouvertes, qualite_tourisme_establishments, bnsc_bike_parking, tourisme_handicap_establishments, ban_address_reference
- Gate minimum : Ne jamais decrire ce score comme frequentation oenotouristique : Insee mesure la demande hebergements generale, a croiser avec offre vin.
- Copy : Readiness oenotourisme : offres vin, capacite, demande touristique Insee, labels, Qualite Tourisme, mobilite douce, accessibilite et adresse dans un score caveate.
- Famille visuelle : oenotourism_capacity
- Poids :
  - wine_offer_density : 20%
  - accommodation_capacity : 17%
  - tourism_demand_signal : 14%
  - destination_label_signal : 12%
  - quality_reception_signal : 11%
  - bike_access_signal : 8%
  - accessibility_signal : 8%
  - address_quality : 10%

### Wine Business Density Score
- Cle : `wine_business_density_score`
- Question : Le territoire concentre-t-il assez d acteurs vin pour justifier une priorite produit, commerciale ou partenaire ?
- Echelle : 0-100
- Formule : `0.40 * active_wine_establishment_density + 0.20 * core_naf_share + 0.15 * geocoding_quality + 0.15 * sustainability_signal + 0.10 * source_activation_status`
- Sources : sirene_wine_establishments, wine_naf_codes, ban_address_reference, hve_certified_estates, source_activation_status
- Gate minimum : Publier en agrege si Sirene/HVE ne sont pas relus nominativement ; marquer pipeline si le stock Sirene manque.
- Copy : Densite business : volume d etablissements vin, part coeur filiere, qualite geocodage et signaux HVE.
- Famille visuelle : business_density
- Poids :
  - active_wine_establishment_density : 40%
  - core_naf_share : 20%
  - geocoding_quality : 15%
  - sustainability_signal : 15%
  - source_activation_status : 10%

### Sustainable Wine Signal
- Cle : `sustainable_wine_signal`
- Question : Le territoire possede-t-il des signaux environnementaux officiels exploitables sans surpromesse ?
- Echelle : 0-100
- Formule : `0.30 * hve_wine_related_density + 0.25 * organic_wine_operator_density + 0.15 * siqo_product_signal + 0.10 * vineyard_surface_context + 0.10 * source_fidelity + 0.10 * caveat_quality`
- Sources : hve_certified_estates, agencebio_organic_wine, inao_siqo_products, rpg_parcels, agreste_viticulture_territorial, reference_source_fidelity
- Gate minimum : Toujours distinguer HVE, Bio et SIQO ; publier les operateurs bio en agregat territoire avant listing nominatif.
- Copy : Signal durabilite : HVE, bio vin Agence Bio, produits SIQO et surface viticole, avec caveats distincts par source.
- Famille visuelle : wine_territory
- Poids :
  - hve_wine_related_density : 30%
  - organic_wine_operator_density : 25%
  - siqo_product_signal : 15%
  - vineyard_surface_context : 10%
  - source_fidelity : 10%
  - caveat_quality : 10%

### Organic Wine Sustainability Score
- Cle : `organic_wine_sustainability_score`
- Question : Le territoire dispose-t-il d un signal bio vin officiel assez robuste pour enrichir la lecture durabilite ?
- Echelle : 0-100
- Formule : `0.45 * organic_operator_density + 0.25 * organic_viticulture_surface_context + 0.15 * certifier_diversity_signal + 0.15 * hve_complement_signal`
- Sources : agencebio_organic_wine, agencebio_organic_viticulture_surfaces, hve_certified_estates, sirene_wine_establishments, ban_address_reference
- Gate minimum : Publier comme signal bio officiel uniquement avec agregats territoire, source Agence Bio citee, output surfaces VI normalise ou badge partiel explicite.
- Copy : Bio vin : operateurs engages, certificateurs et prochain jalon surfaces viticoles bio/conversion pour qualifier la durabilite d un territoire.
- Famille visuelle : sustainability_badge
- Poids :
  - organic_operator_density : 45%
  - organic_viticulture_surface_context : 25%
  - certifier_diversity_signal : 15%
  - hve_complement_signal : 15%

### Supply & Market Context Score
- Cle : `supply_market_context_score`
- Question : Le territoire dispose-t-il d un contexte offre, foncier et marche assez robuste pour enrichir l analyse ?
- Echelle : 0-100
- Formule : `0.25 * production_context + 0.20 * stock_context + 0.20 * land_value_context + 0.20 * bulk_price_context + 0.15 * freshness_gate`
- Sources : dgddi_vitivinicole_stocks_harvests, agreste_vineyard_land_values, franceagrimer_bulk_prices, agreste_viticulture_territorial, source_refresh_policy
- Gate minimum : Score a utiliser comme contexte secondaire tant que DGDDI/FranceAgriMer/Agreste ne sont pas normalises et frais.
- Copy : Contexte offre/marche : production, stocks, foncier et prix servent de cadrage, pas de promesse principale.
- Famille visuelle : market_context
- Poids :
  - production_context : 25%
  - stock_context : 20%
  - land_value_context : 20%
  - bulk_price_context : 20%
  - freshness_gate : 15%

### Map Publication Readiness
- Cle : `map_publication_readiness`
- Question : Les lieux peuvent-ils etre affiches sur une carte publique avec un niveau de confiance suffisant ?
- Echelle : 0-100
- Formule : `0.35 * geocoded_rate + 0.25 * address_score + 0.15 * source_type_clarity + 0.15 * public_opening_confidence + 0.10 * privacy_gate`
- Sources : ban_address_reference, datatourisme_oenotourism, sirene_wine_establishments, atout_france_classified_accommodations, tourisme_handicap_establishments
- Gate minimum : Ne pas afficher de lieux nominatifs si adresse, ouverture au public ou statut RGPD ne sont pas clarifies.
- Copy : Readiness carte : mieux vaut moins de points, mais geocodes, sources et caveates.
- Famille visuelle : source_operations
- Poids :
  - geocoded_rate : 35%
  - address_score : 25%
  - source_type_clarity : 15%
  - public_opening_confidence : 15%
  - privacy_gate : 10%

## Regles de normalisation
- **Min-max territorial** : Normaliser les volumes par famille de territoire comparable avant pondération.
- **Penalite de couverture** : Appliquer une penalite si la source couvre un perimetre plus large que le territoire affiche.
- **Plafond pipeline** : Un score alimente majoritairement par sources metadata_only ou pipeline ne peut pas depasser 59/100.
- **Publication Gate prioritaire** : Le Publication Gate peut bloquer un score meme si la formule numerique est elevee.
- **Caveat obligatoire** : Aucun score ne sort sans caveat source et perimetre.
