# Reference KPI Scorecard Winerix

Scorecard de coherence KPI : familles, KPI heros, niveau d aggregation, produits sources et caveats.

## Table copiable

| Famille | Niveau | KPI heros | Produits | Caveat |
|---|---|---|---|---|
| Autorite reference | plateforme | reference_score, confidence_score, source_count, publication_status | Reference Pack Winerix, Publication Gate, Data Product Index | Ne jamais publier le score sans le gate et les limites de source. |
| Territoire viticole | commune, departement, appellation | inao_aoc_aop_areas, inao_siqo_wine_products, rpg_vineyard_surface_ha, agreste_surface_vigne | Preuve appellation complète, Aires AOC/AOP INAO par commune, Produits SIQO INAO vin, Parcelles viticoles RPG, Cadrage Agreste viticulture | Les surfaces et les aires ne prouvent pas la propriete, la production exacte ni le droit juridique sans controle. |
| Capacite oenotouristique | commune, destination, departement | datatourisme_oenotourism_offers, insee_tourism_capacity_total, classified_accommodations, tourism_handicap_establishments | oenotourism_offers, Capacité touristique communale INSEE, Hébergements touristiques classés, Établissements Tourisme & Handicap, Destinations Vignobles & Découvertes | Offre, capacite et labels ne mesurent pas les nuitees, le chiffre d affaires local ni la motivation vin. |
| Contexte marche | France, campagne, semaine, segment | bulk_price_series, latest_bulk_price, macro_wine_indicators, trade_nc8_tracked_codes | Prix vrac FranceAgriMer, Dictionnaire KPI Winerix, Reference Pack Winerix | Prix France entiere VSIG/IGP, pas prix domaine, pas contrats prives, pas cotation appellation fine. |
| Densite economique vin | commune, departement, code NAF | sirene_wine_establishments, core_wine_establishments, naf_codes, business_presence_score | Établissements vin SIRENE, User Need Navigator, Source Opportunity Radar | Sirene est administratif ; les usages nominatifs et codes adjacents demandent controle RGPD/metier. |
| Operations sources | source, produit, release | source_activation_readiness, publication_action, freshness_status, opportunity_score | Statut activation sources, Board maintenance sources, Source Opportunity Radar, Publication Gate | Un statut fichier/config ne prouve pas l import DB ni la validation metier. |

## Autorite reference

**North star.** Prouver que Winerix peut etre cite comme source data vin.

**Phrase prete a coller.** Winerix est publiable comme reference quand le score, la confiance, les sources et le gate de publication convergent.

**KPI heros.** reference_score, confidence_score, source_count, publication_status

**Exports sources.**

- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md
- Publication Gate : /api/get_reference_publication_gate.php?format=md
- Data Product Index : /api/get_reference_data_product_index.php?format=md

**Direction visuelle.** score ring + preuve source + badge gate

**Caveat.** Ne jamais publier le score sans le gate et les limites de source.

## Territoire viticole

**North star.** Mesurer l empreinte vin d un territoire sans confondre surface, appellation et preuve reglementaire.

**Phrase prete a coller.** Le territoire viticole se lit par couches : SIQO, aire communale, parcelles RPG et cadrage Agreste.

**KPI heros.** inao_aoc_aop_areas, inao_siqo_wine_products, rpg_vineyard_surface_ha, agreste_surface_vigne

**Exports sources.**

- Preuve appellation complète : /api/reference_export.php?type=appellation_evidence_pack&format=md
- Aires AOC/AOP INAO par commune : /api/reference_export.php?type=inao_aoc_aop_communes&format=md
- Produits SIQO INAO vin : /api/reference_export.php?type=inao_siqo_products&format=md&wine_only=1
- Parcelles viticoles RPG : /api/reference_export.php?type=rpg_vineyard_parcels&format=md
- Cadrage Agreste viticulture : /api/reference_export.php?type=agreste_viticulture&format=md

**Direction visuelle.** carte stratifiee + jauge preuve + tags source

**Caveat.** Les surfaces et les aires ne prouvent pas la propriete, la production exacte ni le droit juridique sans controle.

## Capacite oenotouristique

**North star.** Qualifier l accueil et l offre sans assimiler capacite a frequentation.

**Phrase prete a coller.** La capacite oenotouristique combine offre publiee, capacite officielle, hebergements classes, accessibilite et labels.

**KPI heros.** datatourisme_oenotourism_offers, insee_tourism_capacity_total, classified_accommodations, tourism_handicap_establishments

**Exports sources.**

- oenotourism_offers : export n/a
- Capacité touristique communale INSEE : /api/reference_export.php?type=insee_tourism_capacity_communes&format=md
- Hébergements touristiques classés : /api/reference_export.php?type=classified_accommodations&format=md
- Établissements Tourisme & Handicap : /api/reference_export.php?type=tourism_handicap_establishments&format=md
- Destinations Vignobles & Découvertes : /api/reference_export.php?type=vignobles_decouvertes_destinations&format=md

**Direction visuelle.** cartes capacite + icones offre/accessibilite + caveat visible

**Caveat.** Offre, capacite et labels ne mesurent pas les nuitees, le chiffre d affaires local ni la motivation vin.

## Contexte marche

**North star.** Donner un contexte prix/macro sans le transformer en cotation commerciale.

**Phrase prete a coller.** Le marche se raconte avec des signaux macro et des prix vrac, pas avec une promesse de prix domaine.

**KPI heros.** bulk_price_series, latest_bulk_price, macro_wine_indicators, trade_nc8_tracked_codes

**Exports sources.**

- Prix vrac FranceAgriMer : /api/reference_export.php?type=bulk_wine_prices&format=md
- Dictionnaire KPI Winerix : /api/get_reference_kpi_dictionary.php?format=md
- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md

**Direction visuelle.** sparkline marche + badge segment + note de prudence

**Caveat.** Prix France entiere VSIG/IGP, pas prix domaine, pas contrats prives, pas cotation appellation fine.

## Densite economique vin

**North star.** Identifier le tissu economique vin et les zones d action commerciale.

**Phrase prete a coller.** La densite economique vin doit separer le coeur vin des codes adjacents boissons avant usage commercial.

**KPI heros.** sirene_wine_establishments, core_wine_establishments, naf_codes, business_presence_score

**Exports sources.**

- Établissements vin SIRENE : /api/reference_export.php?type=sirene_wine_establishments&format=md
- User Need Navigator : /api/get_reference_user_need_navigator.php?format=md
- Source Opportunity Radar : /api/get_source_opportunity_radar.php?format=md

**Direction visuelle.** heatmap NAF + split coeur/adjacent + alerte RGPD

**Caveat.** Sirene est administratif ; les usages nominatifs et codes adjacents demandent controle RGPD/metier.

## Operations sources

**North star.** Savoir quoi publier, quoi annoter, quoi bloquer et quelle source traiter ensuite.

**Phrase prete a coller.** Une source devient publiable quand le fichier, la fraicheur, l import, le caveat et la decision gate sont alignes.

**KPI heros.** source_activation_readiness, publication_action, freshness_status, opportunity_score

**Exports sources.**

- Statut activation sources : /api/get_source_activation_status.php?format=md
- Board maintenance sources : /api/get_source_maintenance_board.php?format=md
- Source Opportunity Radar : /api/get_source_opportunity_radar.php?format=md
- Publication Gate : /api/get_reference_publication_gate.php?format=md

**Direction visuelle.** kanban source + badges P1/P2 + gate publier/annoter/bloquer

**Caveat.** Un statut fichier/config ne prouve pas l import DB ni la validation metier.