# Winerix Reference Narrative Deck

Trame de deck prete a copier pour pitcher Winerix comme reference data vin/oenotourisme.

## Sommaire

| Slide | Titre | KPI slots | Produits sources | Caveat |
|---:|---|---|---|---|
| 1 | Winerix devient la couche reference data du vin | reference_score, source_count, product_count, confidence_score | Reference Pack Winerix, KPI Cards hydratées, Publication Gate | Les valeurs dynamiques doivent venir des exports runtime et rester accompagnees des caveats. |
| 2 | Chaque utilisateur part d une decision, pas d une table | route_count, persona, hero_kpis, product_keys | User Need Navigator, Publishable Snippet Board, Data Product Index | Le navigator route les produits ; il ne valide pas la fraicheur des imports. |
| 3 | Les KPI sont organises en familles coherentes | family_count, aggregation_level, hero_kpis, visual_treatment | Reference KPI Scorecard, Dictionnaire KPI Winerix, KPI Card Deck | La scorecard structure la lecture mais ne remplace pas les calculs dynamiques. |
| 4 | La preuve appellation devient explicite | inao_siqo_wine_products, inao_aoc_aop_areas, eambrosia_gi_count, appellation_evidence_coverage_rate | Preuve appellation complète, Produits SIQO INAO vin, Aires AOC/AOP INAO par commune, eambrosia_gis, appellation_regulatory_gaps | Les rapprochements textuels doivent etre relus avant usage juridique. |
| 5 | L oenotourisme est lu en couches | 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 | Ces signaux ne prouvent pas les nuitees ni la motivation vin. |
| 6 | Le marche et le tissu economique contextualisent l action | bulk_price_series, latest_bulk_price, sirene_wine_establishments, core_wine_establishments | Prix vrac FranceAgriMer, Établissements vin SIRENE, Source Opportunity Radar | Prix vrac et Sirene ne remplacent pas prix domaine, contrats prives ou qualification nominative. |
| 7 | La publication est gouvernee | source_activation_readiness, publication_action, freshness_status, publishability_status | Statut activation sources, Board maintenance sources, Source Opportunity Radar, Publication Gate | Readiness fichier/config ne prouve pas l import DB ni la validation metier. |
| 8 | Prochaine etape : rendre la reference vivante | import_ready_sources, hydrated_cards, publishable_products, blocked_gates | Reference Dashboard Blueprint, Data Product Index, Publication Gate | Ne pas declarer la reference complete tant que les imports critiques et le gate ne sont pas verifies. |

## Slide 1 - Winerix devient la couche reference data du vin

**Sous-titre.** Sources publiques, preuves, KPI et exports copiables dans un seul systeme.

**Message.** Le probleme n est pas le manque de donnees vin : c est leur dispersion. Winerix transforme des sources heterogenes en produits data lisibles, caveates et actionnables.

**KPI a injecter.** reference_score, source_count, product_count, confidence_score

**Visuel.** Hero score ring + pile de sources + badge Publication Gate.

**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

**Note orateur.** Installer la promesse : Winerix ne vend pas une base brute, mais une couche de reference gouvernee.

**Caveat.** Les valeurs dynamiques doivent venir des exports runtime et rester accompagnees des caveats.

## Slide 2 - Chaque utilisateur part d une decision, pas d une table

**Sous-titre.** Direction, destination, appellation, sales, data ops et analyste ont des parcours differents.

**Message.** Le meme chiffre peut etre utile ou dangereux selon le contexte. Winerix route les utilisateurs vers les bons KPI, les bons exports et les limites a conserver.

**KPI a injecter.** route_count, persona, hero_kpis, product_keys

**Visuel.** Six cartes persona avec decision, KPI heros et export principal.

**Exports.**

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

**Note orateur.** Montrer que la valeur produit vient de la comprehension des besoins, pas seulement du volume de sources.

**Caveat.** Le navigator route les produits ; il ne valide pas la fraicheur des imports.

## Slide 3 - Les KPI sont organises en familles coherentes

**Sous-titre.** Reference, territoire, accueil, marche, economie et operations sources.

**Message.** Winerix evite les comparaisons bancales en separant les niveaux d aggregation : plateforme, commune, appellation, campagne, code NAF et source.

**KPI a injecter.** family_count, aggregation_level, hero_kpis, visual_treatment

**Visuel.** Rail de scorecards KPI par famille, avec couleurs et caveats.

**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

**Note orateur.** Insister sur la discipline : un bon KPI est autant une definition qu une valeur.

**Caveat.** La scorecard structure la lecture mais ne remplace pas les calculs dynamiques.

## Slide 4 - La preuve appellation devient explicite

**Sous-titre.** INAO, SIQO, eAmbrosia, communes et gaps dans un meme pack.

**Message.** Pour devenir reference, Winerix doit montrer les preuves et les incertitudes. Les gaps ne sont pas caches : ils deviennent une file de qualite.

**KPI a injecter.** inao_siqo_wine_products, inao_aoc_aop_areas, eambrosia_gi_count, appellation_evidence_coverage_rate

**Visuel.** Trois colonnes preuve + file de gaps ambre + badge confiance.

**Exports.**

- Preuve appellation complète : /api/reference_export.php?type=appellation_evidence_pack&format=md
- Produits SIQO INAO vin : /api/reference_export.php?type=inao_siqo_products&format=md&wine_only=1
- Aires AOC/AOP INAO par commune : /api/reference_export.php?type=inao_aoc_aop_communes&format=md
- eambrosia_gis : export n/a
- appellation_regulatory_gaps : export n/a

**Note orateur.** Positionner Winerix comme fiable parce qu il expose ses limites.

**Caveat.** Les rapprochements textuels doivent etre relus avant usage juridique.

## Slide 5 - L oenotourisme est lu en couches

**Sous-titre.** Offre, capacite, hebergements, accessibilite et labels ne mesurent pas la meme chose.

**Message.** Un territoire ne se resume pas a une offre DATAtourisme ou a des lits. Winerix separe offre publiee, capacite officielle, qualite d hebergement, accessibilite et labels.

**KPI a injecter.** datatourisme_oenotourism_offers, insee_tourism_capacity_total, classified_accommodations, tourism_handicap_establishments

**Visuel.** Carte destination + quatre cartes capacite/offre/accessibilite/label.

**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

**Note orateur.** Eviter la confusion capacite = frequentation ; c est une force methodologique.

**Caveat.** Ces signaux ne prouvent pas les nuitees ni la motivation vin.

## Slide 6 - Le marche et le tissu economique contextualisent l action

**Sous-titre.** FranceAgriMer, macro vin et Sirene donnent le contexte sans surpromesse.

**Message.** Les signaux marche et Sirene aident a prioriser et raconter un territoire, mais Winerix garde la distinction entre contexte, densite economique et preuve commerciale.

**KPI a injecter.** bulk_price_series, latest_bulk_price, sirene_wine_establishments, core_wine_establishments

**Visuel.** Split panel : sparkline marche / heatmap NAF.

**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

**Note orateur.** Montrer que ces sources rendent Winerix utile aux sales et analystes, avec prudence.

**Caveat.** Prix vrac et Sirene ne remplacent pas prix domaine, contrats prives ou qualification nominative.

## Slide 7 - La publication est gouvernee

**Sous-titre.** Chaque source a une fraicheur, une action, un fallback et une decision gate.

**Message.** Le systeme ne se contente pas d afficher des chiffres : il dit quoi publier, quoi annoter, quoi bloquer et quelle source traiter ensuite.

**KPI a injecter.** source_activation_readiness, publication_action, freshness_status, publishability_status

**Visuel.** Kanban sources + bandeau Publier / Annoter / Bloquer.

**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

**Note orateur.** Faire comprendre que la gouvernance est un avantage produit, pas une contrainte.

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

## Slide 8 - Prochaine etape : rendre la reference vivante

**Sous-titre.** Brancher les imports, hydrater les cartes et publier la page reference.

**Message.** Le socle est pret : sources, produits, scorecards, snippets, dashboard blueprint et deck. La suite consiste a alimenter les valeurs dynamiques et exposer la page publique.

**KPI a injecter.** import_ready_sources, hydrated_cards, publishable_products, blocked_gates

**Visuel.** Roadmap en trois colonnes : activer, hydrater, publier.

**Exports.**

- Reference Dashboard Blueprint : /api/get_reference_dashboard_blueprint.php?format=md
- Data Product Index : /api/get_reference_data_product_index.php?format=md
- Publication Gate : /api/get_reference_publication_gate.php?format=md

**Note orateur.** Clore avec une roadmap concrete : DB, imports, page, instrumentation.

**Caveat.** Ne pas declarer la reference complete tant que les imports critiques et le gate ne sont pas verifies.