# Reference Story Builder

Constructeur de recits KPI pour convertir les sources vin et oenotourisme en angles utilisateurs, cartes copiables et preuves publiables.

## Segments utilisateurs

### Destination marketer
- Besoin : Prouver rapidement pourquoi un territoire viticole merite une campagne ou une page dediee.
- Decision : Prioriser les territoires a mettre en avant.
- Format prefere : card, landing page, social proof snippet

### Interprofession / route des vins
- Besoin : Defendre une lecture commune des appellations, capacites touristiques et preuves officielles.
- Decision : Aligner les partenaires autour d une priorite d animation.
- Format prefere : brief, observatoire, slide direction

### Journaliste / chercheur
- Besoin : Recuperer une synthese sourcee, caveatee et directement citable.
- Decision : Verifier si le territoire est credible pour un sujet ou une analyse.
- Format prefere : markdown, citation kit, source lineage

### Investisseur / acteur public
- Besoin : Comparer le potentiel oenotouristique, economique et foncier sans melanger faits et inference.
- Decision : Identifier les territoires a analyser plus finement.
- Format prefere : scorecard, data room, executive deck

### Product builder
- Besoin : Brancher les bons endpoints pour creer des pages ou widgets KPI sans repartir de zero.
- Decision : Choisir les API, formats et composants a integrer.
- Format prefere : JSON, CSV, embed kit, API manifest

## Storylines KPI

### Ce territoire est-il une reference viticole publiable ?
- Question utilisateur : Puis-je publier une fiche territoire fiable, belle et sourcee en moins de 10 minutes ?
- Famille visuelle : reference_authority
- KPI : reference_score, official_source_count, freshness_status, publication_gate
- Sources : eambrosia_gi, inao_aoc_aop_communes, inao_siqo_products, rpg_parcels, source_activation_status
- Angle copy : Un score lisible, une pile de preuves officielles, puis un caveat court.
- Action : Afficher en hero card puis lier vers la matrice de preuves.

```markdown
### Territoire reference
**Score Winerix** : `{{reference_score}}/100`

Ce territoire dispose de preuves officielles solides : appellations, produits SIQO et parcelles viticoles rapprochees.

_Source : INAO, eAmbrosia, RPG. Caveat : verifier la fraicheur avant publication._
```

### Le territoire peut-il accueillir une demande oenotouristique ?
- Question utilisateur : Quelle capacite touristique peut etre rapprochee des zones viticoles ?
- Famille visuelle : oenotourism_capacity
- KPI : classified_beds, hotel_camping_capacity, accessible_establishment_count, capacity_per_wine_area
- Sources : insee_tourism_capacity_communes, atout_france_accommodations, tourisme_handicap, datatourisme_oenotourism
- Angle copy : Montrer l accueil disponible, puis separer capacite brute et offre qualifiee.
- Action : Combiner avec une carte capacite et un badge accessibilite.

```markdown
### Capacite oenotouristique
`{{classified_beds}}` lits classes et `{{accessible_establishment_count}}` etablissements accessibles rapproches du territoire viticole.

_Source : Insee, Atout France, Tourisme & Handicap. Caveat : capacite communale, pas frequentation reelle._
```

### Y a-t-il un tissu economique vin exploitable ?
- Question utilisateur : Le territoire a-t-il assez d etablissements vin pour justifier un focus produit ou commercial ?
- Famille visuelle : business_density
- KPI : wine_establishment_count, core_wine_naf_share, adjacent_activity_count, activation_status
- Sources : sirene_wine_establishments, wine_naf_codes, source_activation_status
- Angle copy : Presenter la densite comme un signal de potentiel, jamais comme une preuve de performance.
- Action : Garder en mode pipeline tant que Sirene n est pas importe.

```markdown
### Densite economique vin
`{{wine_establishment_count}}` etablissements rattaches aux codes NAF vin, dont `{{core_wine_naf_share}}%` coeur de filiere.

_Source : Sirene. Caveat : source pipeline tant que le stock normalise n est pas importe._
```

### Quel contexte marche ajouter sans surpromettre ?
- Question utilisateur : Puis-je enrichir une fiche territoire avec un signal prix/marche fiable ?
- Famille visuelle : market_context
- KPI : bulk_price_trend, segment_label, latest_available_period, normalization_status
- Sources : franceagrimer_bulk_prices, source_activation_status, reference_publication_gate
- Angle copy : Utiliser le marche comme contexte secondaire tant que la normalisation n est pas industrialisee.
- Action : Ne pas afficher en KPI principal avant import normalise.

```markdown
### Contexte marche
Tendance prix vrac : `{{bulk_price_trend}}` sur `{{latest_available_period}}`.

_Source : FranceAgriMer. Caveat : a publier uniquement apres normalisation et controle du Publication Gate._
```

### Pourquoi peut-on faire confiance a ce KPI ?
- Question utilisateur : Quelle preuve donner pour expliquer la fiabilite du chiffre ?
- Famille visuelle : source_operations
- KPI : source_lineage, refresh_policy, citation_text, publication_status
- Sources : source_refresh_policy, reference_source_lineage, reference_citation_kit, reference_launch_readiness
- Angle copy : Donner un recu de confiance : origine, fraicheur, transformation, limite.
- Action : Afficher sous chaque KPI public en format compact.

```markdown
### Recu de confiance
- Origine : `{{source_origin}}`
- Fraicheur : `{{refresh_status}}`
- Transformation : `{{transformation_note}}`
- Limite : `{{source_caveat}}`
```

## Playbooks

### Page publique territoire
- Sequence : Hero Reference Score -> Territory Proof Stack -> Oenotourism Capacity Card -> Source Trust Receipt
- Succes : Un lecteur comprend le potentiel et les limites en moins de 30 secondes.

### Deck direction / investisseur
- Sequence : Reference snapshot -> Capacity pitch -> Business density context -> Market caveat slide
- Succes : Les decisions possibles sont separees des donnees encore pipeline.

### Data room reference
- Sequence : API manifest -> Data contracts -> Source lineage -> Launch readiness -> Citation kit
- Succes : Un partenaire peut auditer les sources sans demander une explication orale.