# Winerix Reference Data Room

Sommaire des livrables reference par usage : publication, API, KPI, sources, destination, appellation et sales.

## Synthese

- Collections : 7
- Produits references : 31
- Exports Markdown references : 29

## Table copiable

| Collection | Audience | Objectif | Produits | Action |
|---|---|---|---|---|
| Publier Winerix comme reference | direction, publication, partenaires | Montrer la proposition de valeur, les preuves, les KPI et les limites avant exposition externe. | Reference Launch Readiness, Reference Dashboard Blueprint, Reference Narrative Deck, Reference Pack Winerix, Reference Citation Kit | Ouvrir la page statique puis verifier le Launch Readiness. |
| Integrer les API partenaire | developpeur, partenaire, data ops | Donner les endpoints, formats, exemples et regles de publication a un integrateur. | Reference API Manifest, Reference Integration Guide, Source-KPI Lineage Matrix, Publication Gate | Partager le manifeste API puis le guide integration. |
| Construire des KPI coherents | analyste, produit, design, direction | Choisir les bonnes familles KPI, leurs niveaux d aggregation, leurs cartes et leurs definitions. | Reference KPI Scorecard, Dictionnaire KPI Winerix, KPI Card Deck, KPI Cards hydratées | Lire la scorecard avant les cartes KPI et le dictionnaire. |
| Gouverner et fideliser les sources | data ops, publication, gouvernance | Savoir quelles sources sont pretes, en retard, candidates, a importer ou a bloquer. | Statut activation sources, Board maintenance sources, Source Opportunity Radar, Politique de fraîcheur sources, Source-KPI Lineage Matrix | Traiter les tickets source P1/P2 puis relancer le Publication Gate. |
| Qualifier une destination oenotouristique | destination, CRT, institutionnel, sales | Assembler offre, capacite, hebergements, accessibilite et labels sans confondre capacite et frequentation. | oenotourism_offers, Capacité touristique communale INSEE, Hébergements touristiques classés, Établissements Tourisme & Handicap, Destinations Vignobles & Découvertes | Ouvrir les packs destination puis garder le caveat frequentation. |
| Prouver une appellation | appellation, publication, legal, analyste | Relier les preuves INAO, SIQO, eAmbrosia et les gaps de rapprochement. | Preuve appellation complète, Produits SIQO INAO vin, Aires AOC/AOP INAO par commune, eambrosia_gis, appellation_regulatory_gaps | Copier l Evidence Pack et traiter les gaps avant usage juridique. |
| Pitcher marche et densite economique | sales, direction, analyste marche | Ajouter contexte marche, prix vrac et tissu economique sans surpromettre. | Reference Copy Studio, Prix vrac FranceAgriMer, Établissements vin SIRENE, Publishable Snippet Board | Utiliser le Copy Studio avec le pack marche ou Sirene selon le besoin. |

## Publier Winerix comme reference

**Audience.** direction, publication, partenaires

**Objectif.** Montrer la proposition de valeur, les preuves, les KPI et les limites avant exposition externe.

**Action.** Ouvrir la page statique puis verifier le Launch Readiness.

**Exports.**

- Reference Launch Readiness : /api/get_reference_launch_readiness.php?format=md
- Reference Dashboard Blueprint : /api/get_reference_dashboard_blueprint.php?format=md
- Reference Narrative Deck : /api/get_reference_narrative_deck.php?format=md
- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md
- Reference Citation Kit : /api/get_reference_citation_kit.php?format=md

**Caveat.** Ne pas partager publiquement sans Publication Gate et caveats visibles.

## Integrer les API partenaire

**Audience.** developpeur, partenaire, data ops

**Objectif.** Donner les endpoints, formats, exemples et regles de publication a un integrateur.

**Action.** Partager le manifeste API puis le guide integration.

**Exports.**

- Reference API Manifest : /api/get_reference_api_manifest.php?format=md
- Reference Integration Guide : /api/get_reference_integration_guide.php?format=md
- Source-KPI Lineage Matrix : /api/get_reference_source_lineage.php?format=md
- Publication Gate : /api/get_reference_publication_gate.php?format=md

**Caveat.** Les endpoints doivent conserver les caveats et gerer les fallbacks si la DB n est pas prete.

## Construire des KPI coherents

**Audience.** analyste, produit, design, direction

**Objectif.** Choisir les bonnes familles KPI, leurs niveaux d aggregation, leurs cartes et leurs definitions.

**Action.** Lire la scorecard avant les cartes KPI et le dictionnaire.

**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
- KPI Cards hydratées : /api/get_reference_kpi_cards.php?format=md

**Caveat.** Ne pas comparer des KPI de familles ou niveaux differents sans caveat.

## Gouverner et fideliser les sources

**Audience.** data ops, publication, gouvernance

**Objectif.** Savoir quelles sources sont pretes, en retard, candidates, a importer ou a bloquer.

**Action.** Traiter les tickets source P1/P2 puis relancer le Publication Gate.

**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
- Politique de fraîcheur sources : /api/reference_export.php?type=source_refresh_policy&format=md
- Source-KPI Lineage Matrix : /api/get_reference_source_lineage.php?format=md

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

## Qualifier une destination oenotouristique

**Audience.** destination, CRT, institutionnel, sales

**Objectif.** Assembler offre, capacite, hebergements, accessibilite et labels sans confondre capacite et frequentation.

**Action.** Ouvrir les packs destination puis garder le caveat frequentation.

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

**Caveat.** Offre et capacite ne prouvent pas les nuitees ni la motivation vin.

## Prouver une appellation

**Audience.** appellation, publication, legal, analyste

**Objectif.** Relier les preuves INAO, SIQO, eAmbrosia et les gaps de rapprochement.

**Action.** Copier l Evidence Pack et traiter les gaps avant usage juridique.

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

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

## Pitcher marche et densite economique

**Audience.** sales, direction, analyste marche

**Objectif.** Ajouter contexte marche, prix vrac et tissu economique sans surpromettre.

**Action.** Utiliser le Copy Studio avec le pack marche ou Sirene selon le besoin.

**Exports.**

- Reference Copy Studio : /api/get_reference_copy_studio.php?format=md
- 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
- Publishable Snippet Board : /api/get_reference_publishable_snippets.php?format=md

**Caveat.** Prix vrac et Sirene sont des signaux de contexte, pas une qualification commerciale finale.