# Reference Dashboard Blueprint Winerix

Spec UI pour une page ou un deck reference data vin/oenotourisme.

## Table copiable

| Section | Layout | KPI slots | Produits | Action principale |
|---|---|---|---|---|
| Winerix Reference Data | full-width hero with score ring and proof stack | reference_score, confidence_score, source_count, publication_status | Reference Pack Winerix, KPI Cards hydratées, Publication Gate | Copier le Reference Pack |
| Choisir par besoin utilisateur | six persona tiles with decision-first labels | route_count, hero_kpis, product_keys | User Need Navigator, Publishable Snippet Board | Ouvrir le parcours persona |
| Familles KPI cohérentes | horizontal scorecard rail plus detail panel | family_count, aggregation_level, hero_kpis, visual_treatment | Reference KPI Scorecard, Dictionnaire KPI Winerix, KPI Card Deck | Voir la scorecard |
| Potentiel destination | map-and-cards panel | 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 | Copier le brief destination |
| Preuve appellation | three-column evidence stack with gap queue | inao_aoc_aop_areas, inao_siqo_wine_products, eambrosia_gi_count, appellation_evidence_coverage_rate | Preuve appellation complète, Aires AOC/AOP INAO par commune, Produits SIQO INAO vin, eambrosia_gis, appellation_regulatory_gaps | Copier le pack preuve |
| Marché et densité économique | split panel market signal / business density | bulk_price_series, latest_bulk_price, sirene_wine_establishments, core_wine_establishments | Prix vrac FranceAgriMer, Établissements vin SIRENE, Source Opportunity Radar | Copier le signal marché |
| Gouvernance et activation sources | kanban source health with publish gate | source_activation_readiness, publication_action, freshness_status, opportunity_score | Statut activation sources, Board maintenance sources, Source Opportunity Radar, Publication Gate | Traiter les tickets P1 |

## Winerix Reference Data

**Intent.** Installer Winerix comme point d entree reference sur vin, oenotourisme et territoires.

**Direction visuelle.** Fond ivoire texture papier, anneau score bleu nuit, accents lie-de-vin et or pale.

**Copy.** Des KPI vin et oenotourisme sourcés, caveatés et prêts à copier.

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

**Exports.**

- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md
- KPI Cards hydratées : /api/get_reference_kpi_cards.php?format=md
- Publication Gate : /api/get_reference_publication_gate.php?format=md

**Actions.** Copier le Reference Pack / Verifier le Publication Gate

## Choisir par besoin utilisateur

**Intent.** Eviter que l utilisateur parte d une source brute au lieu de sa decision.

**Direction visuelle.** Tuiles compactes, pictogrammes sobres, hover reveal des KPI heros.

**Copy.** Direction, destination, appellation, sales, data ops ou analyste : chaque parcours ouvre les bons exports.

**KPI slots.** route_count, hero_kpis, product_keys

**Exports.**

- User Need Navigator : /api/get_reference_user_need_navigator.php?format=md
- Publishable Snippet Board : /api/get_reference_publishable_snippets.php?format=md

**Actions.** Ouvrir le parcours persona / Copier un snippet

## Familles KPI cohérentes

**Intent.** Regrouper les KPI par familles pour eviter les comparaisons incoherentes.

**Direction visuelle.** Rail de cartes colorees par famille : reference, territoire, accueil, marche, economie, sources.

**Copy.** Chaque famille a sa north star, son niveau d agrégation, ses KPI héros et son caveat.

**KPI slots.** family_count, aggregation_level, hero_kpis, visual_treatment

**Exports.**

- Reference KPI Scorecard : /api/get_reference_kpi_scorecard.php?format=md
- Dictionnaire KPI Winerix : /api/get_reference_kpi_dictionary.php?format=md
- KPI Card Deck : /api/get_reference_kpi_card_deck.php?format=md

**Actions.** Voir la scorecard / Exporter le dictionnaire KPI

## Potentiel destination

**Intent.** Rendre lisible l oenotourisme en séparant offre, capacité, hébergement, accessibilité et label.

**Direction visuelle.** Carte claire, cartes cyan/vert, badges caveat frequentation visibles.

**Copy.** Le potentiel destination se lit en couches, pas avec un chiffre unique.

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

**Exports.**

- 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

**Actions.** Copier le brief destination / Comparer les exports accueil

## Preuve appellation

**Intent.** Montrer les preuves réglementaires et les zones à revoir au lieu de cacher les incertitudes.

**Direction visuelle.** Colonnes INAO/SIQO/eAmbrosia, file de gaps ambre, badge confiance.

**Copy.** La preuve appellation est solide quand les sources convergent et que les gaps restent visibles.

**KPI slots.** inao_aoc_aop_areas, inao_siqo_wine_products, eambrosia_gi_count, appellation_evidence_coverage_rate

**Exports.**

- 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
- eambrosia_gis : export n/a
- appellation_regulatory_gaps : export n/a

**Actions.** Copier le pack preuve / Traiter les gaps

## Marché et densité économique

**Intent.** Connecter contexte marché et tissu économique sans surpromettre les données.

**Direction visuelle.** Graphique ligne sobre pour marché, heatmap NAF pour densité, caveat RGPD visible.

**Copy.** Le marché donne le contexte, Sirene donne la densité économique ; aucun des deux ne remplace une validation métier.

**KPI slots.** bulk_price_series, latest_bulk_price, sirene_wine_establishments, core_wine_establishments

**Exports.**

- Prix vrac FranceAgriMer : /api/reference_export.php?type=bulk_wine_prices&format=md
- Établissements vin SIRENE : /api/reference_export.php?type=sirene_wine_establishments&format=md
- Source Opportunity Radar : /api/get_source_opportunity_radar.php?format=md

**Actions.** Copier le signal marché / Ouvrir le pack Sirene

## Gouvernance et activation sources

**Intent.** Transformer la maintenance des sources en rituel visible et actionnable.

**Direction visuelle.** Kanban P1/P2/P3, badges fresh/stale/critical, bandeau publier/annoter/bloquer.

**Copy.** Une donnée devient publiable quand source, fraîcheur, import, caveat et gate sont alignés.

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

**Exports.**

- 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

**Actions.** Traiter les tickets P1 / Relancer le gate