{"ok":true,"generated_at":"2026-07-08T01:13:16+02:00","kpi_count":11,"families":{"gouvernance":2,"territoire":1,"appellation":2,"œnotourisme":1,"accueil":1,"accessibilité":1,"filière":1,"foncier":1,"data ops":1},"kpis":[{"key":"reference_score","label":"Score référence Winerix","family":"gouvernance","definition":"Score interne de maturité combinant confiance KPI, confiance source, part de sources actives, preuves disponibles et signaux spécialisés.","calculation":"Calculé dans le Reference Pack à partir du KPI Pack, du registre sources et du nombre de preuves spécialisées.","source_keys":["wine_reference_pack","kpi_pack","source_registry"],"persona":"direction, investisseur, publication","copy_hint":"À 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."},{"key":"confidence_score","label":"Confiance pack KPI","family":"gouvernance","definition":"Niveau de confiance du pack agrégé selon couverture locale, géolocalisation, sources et signaux disponibles.","calculation":"Agrégation interne pondérée entre confiance source et couverture exploitable.","source_keys":["kpi_pack","source_registry"],"persona":"data ops, publication, direction","copy_hint":"À 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."},{"key":"communes","label":"Communes viticoles couvertes","family":"territoire","definition":"Nombre de communes dans le périmètre Winerix après filtrage région, département, INSEE ou appellation.","calculation":"COUNT DISTINCT insee_code depuis le référentiel communes/appellations.","source_keys":["communes","appellations","inao_aoc_aop_commune_areas"],"persona":"territoire, appellation, direction","copy_hint":"À utiliser pour cadrer la taille territoriale d’un périmètre.","caveat":"Dépend du millésime administratif et des rattachements appellation importés."},{"key":"appellations","label":"Appellations suivies","family":"appellation","definition":"Nombre d’appellations distinctes rattachées au périmètre Winerix.","calculation":"COUNT DISTINCT appellation_name depuis la table appellations.","source_keys":["appellations","inao_siqo_products","inao_aoc_aop_commune_areas","eambrosia_gi"],"persona":"appellation, publication, réglementaire","copy_hint":"À citer avec le pack de preuve appellation complète.","caveat":"Les libellés doivent être relus si usage juridique ou réglementaire."},{"key":"appellation_evidence_coverage_rate","label":"Couverture preuve appellation complète","family":"appellation","definition":"Part des appellations qui disposent simultanément d’un produit SIQO, d’une aire communale INAO et d’une preuve eAmbrosia.","calculation":"complete_evidence / appellations dans le pack preuve appellation.","source_keys":["appellation_evidence_pack","inao_siqo_products","inao_aoc_aop_commune_areas","eambrosia_gi"],"persona":"publication, réglementaire, data ops","copy_hint":"À utiliser comme gate de publication forte sur les appellations.","caveat":"Matching normalisé mais textuel : relire les non-matchs avant usage juridique."},{"key":"datatourisme_oenotourism_offers","label":"Offres œnotouristiques DATAtourisme","family":"œnotourisme","definition":"Nombre d’offres DATAtourisme filtrées vin et dépassant le seuil de pertinence Winerix.","calculation":"COUNT rows oenotourism_offers avec wine_relevance_score >= seuil.","source_keys":["datatourisme_oenotourism"],"persona":"destination, agence, territoire","copy_hint":"À 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."},{"key":"classified_accommodations","label":"Hébergements touristiques classés","family":"accueil","definition":"Nombre d’hébergements classés Atout France présents dans le périmètre ou le snapshot national.","calculation":"COUNT rows classified_accommodations source Atout France.","source_keys":["atout_france_classified_accommodations"],"persona":"destination, investisseur, institutionnel","copy_hint":"À 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."},{"key":"tourism_handicap_establishments","label":"Établissements Tourisme & Handicap actifs","family":"accessibilité","definition":"Nombre d’établissements labellisés actifs dans le fichier Tourisme & Handicap.","calculation":"COUNT rows tourism_handicap_establishments avec droit d’utilisation actif.","source_keys":["tourisme_handicap_establishments"],"persona":"destination inclusive, institutionnel, qualité","copy_hint":"À utiliser pour qualifier l’offre accessible locale ou nationale.","caveat":"Label établissement : pas fréquentation, satisfaction ou exhaustivité de l’offre touristique."},{"key":"agreste_surface_vigne","label":"Surface vigne Agreste","family":"filière","definition":"Surface viticole statistique issue des indicateurs Agreste importés.","calculation":"Dernier indicateur surface_vigne depuis macro_wine_indicators source Agreste.","source_keys":["agreste_viticulture_territorial"],"persona":"territoire, filière, investisseur","copy_hint":"À citer comme cadrage statistique filière.","caveat":"Statistique territoriale : pas preuve parcellaire ni rattachement domaine."},{"key":"rpg_vineyard_surface_ha","label":"Surface viticole RPG","family":"foncier","definition":"Surface déclarative des parcelles viticoles RPG importées.","calculation":"SUM surface_ha depuis rpg_vineyard_parcels source RPG.","source_keys":["rpg_parcels"],"persona":"cartographie, foncier, territoire","copy_hint":"À utiliser pour une empreinte déclarative cartographique.","caveat":"Déclaratif PAC : pas propriété cadastrale ni exhaustivité vigne."},{"key":"source_activation_readiness","label":"Readiness activation sources","family":"data ops","definition":"État fichiers/config/fraîcheur indiquant quelles sources peuvent être importées et lesquelles sont stale ou critical.","calculation":"Statut DB + présence fichiers + âge fichier comparé à source-refresh-policy.csv.","source_keys":["source_activation_status","source_refresh_policy"],"persona":"data ops, publication, gouvernance","copy_hint":"À vérifier avant toute publication externe ou refresh de packs.","caveat":"Readiness ne prouve pas que l’import DB a réussi."}],"copy_markdown":"# Winerix KPI Dictionary\n\nDéfinitions canoniques des KPI copiables : définition, calcul, sources, usage et caveat.\n\n## Score référence Winerix\n\n- Clé : reference_score\n- Famille : gouvernance\n- Définition : Score interne de maturité combinant confiance KPI, confiance source, part de sources actives, preuves disponibles et signaux spécialisés.\n- Calcul : Calculé dans le Reference Pack à partir du KPI Pack, du registre sources et du nombre de preuves spécialisées.\n- Sources : wine_reference_pack, kpi_pack, source_registry\n- Persona : direction, investisseur, publication\n- Usage copie : À utiliser comme indicateur de maturité de la base Winerix, jamais comme mesure externe du marché.\n- Caveat : Score interne : doit être accompagné des preuves, gaps et sources citées.\n\n## Confiance pack KPI\n\n- Clé : confidence_score\n- Famille : gouvernance\n- Définition : Niveau de confiance du pack agrégé selon couverture locale, géolocalisation, sources et signaux disponibles.\n- Calcul : Agrégation interne pondérée entre confiance source et couverture exploitable.\n- Sources : kpi_pack, source_registry\n- Persona : data ops, publication, direction\n- Usage copie : À afficher à côté des KPI pour signaler le niveau de maturité du périmètre.\n- Caveat : Ne remplace pas un audit qualité source par source.\n\n## Communes viticoles couvertes\n\n- Clé : communes\n- Famille : territoire\n- Définition : Nombre de communes dans le périmètre Winerix après filtrage région, département, INSEE ou appellation.\n- Calcul : COUNT DISTINCT insee_code depuis le référentiel communes/appellations.\n- Sources : communes, appellations, inao_aoc_aop_commune_areas\n- Persona : territoire, appellation, direction\n- Usage copie : À utiliser pour cadrer la taille territoriale d’un périmètre.\n- Caveat : Dépend du millésime administratif et des rattachements appellation importés.\n\n## Appellations suivies\n\n- Clé : appellations\n- Famille : appellation\n- Définition : Nombre d’appellations distinctes rattachées au périmètre Winerix.\n- Calcul : COUNT DISTINCT appellation_name depuis la table appellations.\n- Sources : appellations, inao_siqo_products, inao_aoc_aop_commune_areas, eambrosia_gi\n- Persona : appellation, publication, réglementaire\n- Usage copie : À citer avec le pack de preuve appellation complète.\n- Caveat : Les libellés doivent être relus si usage juridique ou réglementaire.\n\n## Couverture preuve appellation complète\n\n- Clé : appellation_evidence_coverage_rate\n- Famille : appellation\n- Définition : Part des appellations qui disposent simultanément d’un produit SIQO, d’une aire communale INAO et d’une preuve eAmbrosia.\n- Calcul : complete_evidence / appellations dans le pack preuve appellation.\n- Sources : appellation_evidence_pack, inao_siqo_products, inao_aoc_aop_commune_areas, eambrosia_gi\n- Persona : publication, réglementaire, data ops\n- Usage copie : À utiliser comme gate de publication forte sur les appellations.\n- Caveat : Matching normalisé mais textuel : relire les non-matchs avant usage juridique.\n\n## Offres œnotouristiques DATAtourisme\n\n- Clé : datatourisme_oenotourism_offers\n- Famille : œnotourisme\n- Définition : Nombre d’offres DATAtourisme filtrées vin et dépassant le seuil de pertinence Winerix.\n- Calcul : COUNT rows oenotourism_offers avec wine_relevance_score >= seuil.\n- Sources : datatourisme_oenotourism\n- Persona : destination, agence, territoire\n- Usage copie : À utiliser pour mesurer l’épaisseur de l’offre publiée localement.\n- Caveat : Offre publiée par les territoires : pas fréquentation, pas exhaustivité réelle.\n\n## Hébergements touristiques classés\n\n- Clé : classified_accommodations\n- Famille : accueil\n- Définition : Nombre d’hébergements classés Atout France présents dans le périmètre ou le snapshot national.\n- Calcul : COUNT rows classified_accommodations source Atout France.\n- Sources : atout_france_classified_accommodations\n- Persona : destination, investisseur, institutionnel\n- Usage copie : À utiliser pour cadrer la capacité d’accueil officielle.\n- Caveat : Ne couvre pas toute l’offre d’hébergement et ne mesure pas la fréquentation.\n\n## Établissements Tourisme & Handicap actifs\n\n- Clé : tourism_handicap_establishments\n- Famille : accessibilité\n- Définition : Nombre d’établissements labellisés actifs dans le fichier Tourisme & Handicap.\n- Calcul : COUNT rows tourism_handicap_establishments avec droit d’utilisation actif.\n- Sources : tourisme_handicap_establishments\n- Persona : destination inclusive, institutionnel, qualité\n- Usage copie : À utiliser pour qualifier l’offre accessible locale ou nationale.\n- Caveat : Label établissement : pas fréquentation, satisfaction ou exhaustivité de l’offre touristique.\n\n## Surface vigne Agreste\n\n- Clé : agreste_surface_vigne\n- Famille : filière\n- Définition : Surface viticole statistique issue des indicateurs Agreste importés.\n- Calcul : Dernier indicateur surface_vigne depuis macro_wine_indicators source Agreste.\n- Sources : agreste_viticulture_territorial\n- Persona : territoire, filière, investisseur\n- Usage copie : À citer comme cadrage statistique filière.\n- Caveat : Statistique territoriale : pas preuve parcellaire ni rattachement domaine.\n\n## Surface viticole RPG\n\n- Clé : rpg_vineyard_surface_ha\n- Famille : foncier\n- Définition : Surface déclarative des parcelles viticoles RPG importées.\n- Calcul : SUM surface_ha depuis rpg_vineyard_parcels source RPG.\n- Sources : rpg_parcels\n- Persona : cartographie, foncier, territoire\n- Usage copie : À utiliser pour une empreinte déclarative cartographique.\n- Caveat : Déclaratif PAC : pas propriété cadastrale ni exhaustivité vigne.\n\n## Readiness activation sources\n\n- Clé : source_activation_readiness\n- Famille : data ops\n- Définition : État fichiers/config/fraîcheur indiquant quelles sources peuvent être importées et lesquelles sont stale ou critical.\n- Calcul : Statut DB + présence fichiers + âge fichier comparé à source-refresh-policy.csv.\n- Sources : source_activation_status, source_refresh_policy\n- Persona : data ops, publication, gouvernance\n- Usage copie : À vérifier avant toute publication externe ou refresh de packs.\n- Caveat : Readiness ne prouve pas que l’import DB a réussi.\n\n"}