# Winerix KPI Dictionary

Définitions canoniques des KPI copiables : définition, calcul, sources, usage et caveat.

## Score référence Winerix

- Clé : reference_score
- Famille : gouvernance
- Définition : Score interne de maturité combinant confiance KPI, confiance source, part de sources actives, preuves disponibles et signaux spécialisés.
- Calcul : Calculé dans le Reference Pack à partir du KPI Pack, du registre sources et du nombre de preuves spécialisées.
- Sources : wine_reference_pack, kpi_pack, source_registry
- Persona : direction, investisseur, publication
- Usage copie : À utiliser comme indicateur de maturité de la base Winerix, jamais comme mesure externe du marché.
- Caveat : Score interne : doit être accompagné des preuves, gaps et sources citées.

## Confiance pack KPI

- Clé : confidence_score
- Famille : gouvernance
- Définition : Niveau de confiance du pack agrégé selon couverture locale, géolocalisation, sources et signaux disponibles.
- Calcul : Agrégation interne pondérée entre confiance source et couverture exploitable.
- Sources : kpi_pack, source_registry
- Persona : data ops, publication, direction
- Usage copie : À afficher à côté des KPI pour signaler le niveau de maturité du périmètre.
- Caveat : Ne remplace pas un audit qualité source par source.

## Communes viticoles couvertes

- Clé : communes
- Famille : territoire
- Définition : Nombre de communes dans le périmètre Winerix après filtrage région, département, INSEE ou appellation.
- Calcul : COUNT DISTINCT insee_code depuis le référentiel communes/appellations.
- Sources : communes, appellations, inao_aoc_aop_commune_areas
- Persona : territoire, appellation, direction
- Usage copie : À utiliser pour cadrer la taille territoriale d’un périmètre.
- Caveat : Dépend du millésime administratif et des rattachements appellation importés.

## Appellations suivies

- Clé : appellations
- Famille : appellation
- Définition : Nombre d’appellations distinctes rattachées au périmètre Winerix.
- Calcul : COUNT DISTINCT appellation_name depuis la table appellations.
- Sources : appellations, inao_siqo_products, inao_aoc_aop_commune_areas, eambrosia_gi
- Persona : appellation, publication, réglementaire
- Usage copie : À citer avec le pack de preuve appellation complète.
- Caveat : Les libellés doivent être relus si usage juridique ou réglementaire.

## Couverture preuve appellation complète

- Clé : appellation_evidence_coverage_rate
- Famille : appellation
- Définition : Part des appellations qui disposent simultanément d’un produit SIQO, d’une aire communale INAO et d’une preuve eAmbrosia.
- Calcul : complete_evidence / appellations dans le pack preuve appellation.
- Sources : appellation_evidence_pack, inao_siqo_products, inao_aoc_aop_commune_areas, eambrosia_gi
- Persona : publication, réglementaire, data ops
- Usage copie : À utiliser comme gate de publication forte sur les appellations.
- Caveat : Matching normalisé mais textuel : relire les non-matchs avant usage juridique.

## Offres œnotouristiques DATAtourisme

- Clé : datatourisme_oenotourism_offers
- Famille : œnotourisme
- Définition : Nombre d’offres DATAtourisme filtrées vin et dépassant le seuil de pertinence Winerix.
- Calcul : COUNT rows oenotourism_offers avec wine_relevance_score >= seuil.
- Sources : datatourisme_oenotourism
- Persona : destination, agence, territoire
- Usage copie : À utiliser pour mesurer l’épaisseur de l’offre publiée localement.
- Caveat : Offre publiée par les territoires : pas fréquentation, pas exhaustivité réelle.

## Hébergements touristiques classés

- Clé : classified_accommodations
- Famille : accueil
- Définition : Nombre d’hébergements classés Atout France présents dans le périmètre ou le snapshot national.
- Calcul : COUNT rows classified_accommodations source Atout France.
- Sources : atout_france_classified_accommodations
- Persona : destination, investisseur, institutionnel
- Usage copie : À utiliser pour cadrer la capacité d’accueil officielle.
- Caveat : Ne couvre pas toute l’offre d’hébergement et ne mesure pas la fréquentation.

## Établissements Tourisme & Handicap actifs

- Clé : tourism_handicap_establishments
- Famille : accessibilité
- Définition : Nombre d’établissements labellisés actifs dans le fichier Tourisme & Handicap.
- Calcul : COUNT rows tourism_handicap_establishments avec droit d’utilisation actif.
- Sources : tourisme_handicap_establishments
- Persona : destination inclusive, institutionnel, qualité
- Usage copie : À utiliser pour qualifier l’offre accessible locale ou nationale.
- Caveat : Label établissement : pas fréquentation, satisfaction ou exhaustivité de l’offre touristique.

## Surface vigne Agreste

- Clé : agreste_surface_vigne
- Famille : filière
- Définition : Surface viticole statistique issue des indicateurs Agreste importés.
- Calcul : Dernier indicateur surface_vigne depuis macro_wine_indicators source Agreste.
- Sources : agreste_viticulture_territorial
- Persona : territoire, filière, investisseur
- Usage copie : À citer comme cadrage statistique filière.
- Caveat : Statistique territoriale : pas preuve parcellaire ni rattachement domaine.

## Surface viticole RPG

- Clé : rpg_vineyard_surface_ha
- Famille : foncier
- Définition : Surface déclarative des parcelles viticoles RPG importées.
- Calcul : SUM surface_ha depuis rpg_vineyard_parcels source RPG.
- Sources : rpg_parcels
- Persona : cartographie, foncier, territoire
- Usage copie : À utiliser pour une empreinte déclarative cartographique.
- Caveat : Déclaratif PAC : pas propriété cadastrale ni exhaustivité vigne.

## Readiness activation sources

- Clé : source_activation_readiness
- Famille : data ops
- Définition : État fichiers/config/fraîcheur indiquant quelles sources peuvent être importées et lesquelles sont stale ou critical.
- Calcul : Statut DB + présence fichiers + âge fichier comparé à source-refresh-policy.csv.
- Sources : source_activation_status, source_refresh_policy
- Persona : data ops, publication, gouvernance
- Usage copie : À vérifier avant toute publication externe ou refresh de packs.
- Caveat : Readiness ne prouve pas que l’import DB a réussi.