{ "ok": true, "generated_at": "2026-07-07T22:11:31+00:00", "summary": "Constructeur de recits KPI pour convertir les sources vin et oenotourisme en angles utilisateurs, cartes copiables et preuves publiables.", "segment_count": 5, "storyline_count": 5, "segments": [ { "key": "destination_marketer", "label": "Destination marketer", "need": "Prouver rapidement pourquoi un territoire viticole merite une campagne ou une page dediee.", "decision": "Prioriser les territoires a mettre en avant.", "preferred_format": "card, landing page, social proof snippet" }, { "key": "wine_region_operator", "label": "Interprofession / route des vins", "need": "Defendre une lecture commune des appellations, capacites touristiques et preuves officielles.", "decision": "Aligner les partenaires autour d une priorite d animation.", "preferred_format": "brief, observatoire, slide direction" }, { "key": "journalist_researcher", "label": "Journaliste / chercheur", "need": "Recuperer une synthese sourcee, caveatee et directement citable.", "decision": "Verifier si le territoire est credible pour un sujet ou une analyse.", "preferred_format": "markdown, citation kit, source lineage" }, { "key": "investor_public_actor", "label": "Investisseur / acteur public", "need": "Comparer le potentiel oenotouristique, economique et foncier sans melanger faits et inference.", "decision": "Identifier les territoires a analyser plus finement.", "preferred_format": "scorecard, data room, executive deck" }, { "key": "product_builder", "label": "Product builder", "need": "Brancher les bons endpoints pour creer des pages ou widgets KPI sans repartir de zero.", "decision": "Choisir les API, formats et composants a integrer.", "preferred_format": "JSON, CSV, embed kit, API manifest" } ], "storylines": [ { "key": "territory_reference_snapshot", "title": "Ce territoire est-il une reference viticole publiable ?", "persona_keys": [ "destination_marketer", "journalist_researcher", "wine_region_operator" ], "user_question": "Puis-je publier une fiche territoire fiable, belle et sourcee en moins de 10 minutes ?", "core_kpis": [ "reference_score", "official_source_count", "freshness_status", "publication_gate" ], "required_sources": [ "eambrosia_gi", "inao_aoc_aop_communes", "inao_siqo_products", "rpg_parcels", "source_activation_status" ], "visual_family": "reference_authority", "copy_angle": "Un score lisible, une pile de preuves officielles, puis un caveat court.", "markdown_snippet": "### Territoire reference\n**Score Winerix** : `{{reference_score}}/100`\n\nCe territoire dispose de preuves officielles solides : appellations, produits SIQO et parcelles viticoles rapprochees.\n\n_Source : INAO, eAmbrosia, RPG. Caveat : verifier la fraicheur avant publication._", "csv_fields": [ "territory", "reference_score", "official_source_count", "publication_gate", "source_caveat" ], "next_action": "Afficher en hero card puis lier vers la matrice de preuves." }, { "key": "oenotourism_capacity_pitch", "title": "Le territoire peut-il accueillir une demande oenotouristique ?", "persona_keys": [ "destination_marketer", "investor_public_actor", "wine_region_operator" ], "user_question": "Quelle capacite touristique peut etre rapprochee des zones viticoles ?", "core_kpis": [ "classified_beds", "hotel_camping_capacity", "accessible_establishment_count", "capacity_per_wine_area" ], "required_sources": [ "insee_tourism_capacity_communes", "atout_france_accommodations", "tourisme_handicap", "datatourisme_oenotourism" ], "visual_family": "oenotourism_capacity", "copy_angle": "Montrer l accueil disponible, puis separer capacite brute et offre qualifiee.", "markdown_snippet": "### Capacite oenotouristique\n`{{classified_beds}}` lits classes et `{{accessible_establishment_count}}` etablissements accessibles rapproches du territoire viticole.\n\n_Source : Insee, Atout France, Tourisme & Handicap. Caveat : capacite communale, pas frequentation reelle._", "csv_fields": [ "territory", "classified_beds", "accessible_establishment_count", "datatourisme_offer_count", "capacity_caveat" ], "next_action": "Combiner avec une carte capacite et un badge accessibilite." }, { "key": "market_density_context", "title": "Y a-t-il un tissu economique vin exploitable ?", "persona_keys": [ "investor_public_actor", "product_builder", "journalist_researcher" ], "user_question": "Le territoire a-t-il assez d etablissements vin pour justifier un focus produit ou commercial ?", "core_kpis": [ "wine_establishment_count", "core_wine_naf_share", "adjacent_activity_count", "activation_status" ], "required_sources": [ "sirene_wine_establishments", "wine_naf_codes", "source_activation_status" ], "visual_family": "business_density", "copy_angle": "Presenter la densite comme un signal de potentiel, jamais comme une preuve de performance.", "markdown_snippet": "### Densite economique vin\n`{{wine_establishment_count}}` etablissements rattaches aux codes NAF vin, dont `{{core_wine_naf_share}}%` coeur de filiere.\n\n_Source : Sirene. Caveat : source pipeline tant que le stock normalise n est pas importe._", "csv_fields": [ "territory", "wine_establishment_count", "core_wine_naf_share", "adjacent_activity_count", "activation_status" ], "next_action": "Garder en mode pipeline tant que Sirene n est pas importe." }, { "key": "wine_market_price_brief", "title": "Quel contexte marche ajouter sans surpromettre ?", "persona_keys": [ "journalist_researcher", "investor_public_actor", "wine_region_operator" ], "user_question": "Puis-je enrichir une fiche territoire avec un signal prix/marche fiable ?", "core_kpis": [ "bulk_price_trend", "segment_label", "latest_available_period", "normalization_status" ], "required_sources": [ "franceagrimer_bulk_prices", "source_activation_status", "reference_publication_gate" ], "visual_family": "market_context", "copy_angle": "Utiliser le marche comme contexte secondaire tant que la normalisation n est pas industrialisee.", "markdown_snippet": "### Contexte marche\nTendance prix vrac : `{{bulk_price_trend}}` sur `{{latest_available_period}}`.\n\n_Source : FranceAgriMer. Caveat : a publier uniquement apres normalisation et controle du Publication Gate._", "csv_fields": [ "segment", "bulk_price_trend", "latest_available_period", "normalization_status", "publication_gate" ], "next_action": "Ne pas afficher en KPI principal avant import normalise." }, { "key": "source_trust_receipt", "title": "Pourquoi peut-on faire confiance a ce KPI ?", "persona_keys": [ "journalist_researcher", "product_builder", "investor_public_actor" ], "user_question": "Quelle preuve donner pour expliquer la fiabilite du chiffre ?", "core_kpis": [ "source_lineage", "refresh_policy", "citation_text", "publication_status" ], "required_sources": [ "source_refresh_policy", "reference_source_lineage", "reference_citation_kit", "reference_launch_readiness" ], "visual_family": "source_operations", "copy_angle": "Donner un recu de confiance : origine, fraicheur, transformation, limite.", "markdown_snippet": "### Recu de confiance\n- Origine : `{{source_origin}}`\n- Fraicheur : `{{refresh_status}}`\n- Transformation : `{{transformation_note}}`\n- Limite : `{{source_caveat}}`", "csv_fields": [ "kpi_key", "source_origin", "refresh_status", "transformation_note", "source_caveat" ], "next_action": "Afficher sous chaque KPI public en format compact." } ], "playbooks": [ { "key": "public_page", "label": "Page publique territoire", "sequence": [ "Hero Reference Score", "Territory Proof Stack", "Oenotourism Capacity Card", "Source Trust Receipt" ], "success_metric": "Un lecteur comprend le potentiel et les limites en moins de 30 secondes." }, { "key": "executive_deck", "label": "Deck direction / investisseur", "sequence": [ "Reference snapshot", "Capacity pitch", "Business density context", "Market caveat slide" ], "success_metric": "Les decisions possibles sont separees des donnees encore pipeline." }, { "key": "data_room", "label": "Data room reference", "sequence": [ "API manifest", "Data contracts", "Source lineage", "Launch readiness", "Citation kit" ], "success_metric": "Un partenaire peut auditer les sources sans demander une explication orale." } ], "copy_markdown": "# Reference Story Builder\n\nConstructeur de recits KPI pour convertir les sources vin et oenotourisme en angles utilisateurs, cartes copiables et preuves publiables.\n\n## Segments utilisateurs\n\n### Destination marketer\n- Besoin : Prouver rapidement pourquoi un territoire viticole merite une campagne ou une page dediee.\n- Decision : Prioriser les territoires a mettre en avant.\n- Format prefere : card, landing page, social proof snippet\n\n### Interprofession / route des vins\n- Besoin : Defendre une lecture commune des appellations, capacites touristiques et preuves officielles.\n- Decision : Aligner les partenaires autour d une priorite d animation.\n- Format prefere : brief, observatoire, slide direction\n\n### Journaliste / chercheur\n- Besoin : Recuperer une synthese sourcee, caveatee et directement citable.\n- Decision : Verifier si le territoire est credible pour un sujet ou une analyse.\n- Format prefere : markdown, citation kit, source lineage\n\n### Investisseur / acteur public\n- Besoin : Comparer le potentiel oenotouristique, economique et foncier sans melanger faits et inference.\n- Decision : Identifier les territoires a analyser plus finement.\n- Format prefere : scorecard, data room, executive deck\n\n### Product builder\n- Besoin : Brancher les bons endpoints pour creer des pages ou widgets KPI sans repartir de zero.\n- Decision : Choisir les API, formats et composants a integrer.\n- Format prefere : JSON, CSV, embed kit, API manifest\n\n## Storylines KPI\n\n### Ce territoire est-il une reference viticole publiable ?\n- Question utilisateur : Puis-je publier une fiche territoire fiable, belle et sourcee en moins de 10 minutes ?\n- Famille visuelle : reference_authority\n- KPI : reference_score, official_source_count, freshness_status, publication_gate\n- Sources : eambrosia_gi, inao_aoc_aop_communes, inao_siqo_products, rpg_parcels, source_activation_status\n- Angle copy : Un score lisible, une pile de preuves officielles, puis un caveat court.\n- Action : Afficher en hero card puis lier vers la matrice de preuves.\n\n```markdown\n### Territoire reference\n**Score Winerix** : `{{reference_score}}/100`\n\nCe territoire dispose de preuves officielles solides : appellations, produits SIQO et parcelles viticoles rapprochees.\n\n_Source : INAO, eAmbrosia, RPG. Caveat : verifier la fraicheur avant publication._\n```\n\n### Le territoire peut-il accueillir une demande oenotouristique ?\n- Question utilisateur : Quelle capacite touristique peut etre rapprochee des zones viticoles ?\n- Famille visuelle : oenotourism_capacity\n- KPI : classified_beds, hotel_camping_capacity, accessible_establishment_count, capacity_per_wine_area\n- Sources : insee_tourism_capacity_communes, atout_france_accommodations, tourisme_handicap, datatourisme_oenotourism\n- Angle copy : Montrer l accueil disponible, puis separer capacite brute et offre qualifiee.\n- Action : Combiner avec une carte capacite et un badge accessibilite.\n\n```markdown\n### Capacite oenotouristique\n`{{classified_beds}}` lits classes et `{{accessible_establishment_count}}` etablissements accessibles rapproches du territoire viticole.\n\n_Source : Insee, Atout France, Tourisme & Handicap. Caveat : capacite communale, pas frequentation reelle._\n```\n\n### Y a-t-il un tissu economique vin exploitable ?\n- Question utilisateur : Le territoire a-t-il assez d etablissements vin pour justifier un focus produit ou commercial ?\n- Famille visuelle : business_density\n- KPI : wine_establishment_count, core_wine_naf_share, adjacent_activity_count, activation_status\n- Sources : sirene_wine_establishments, wine_naf_codes, source_activation_status\n- Angle copy : Presenter la densite comme un signal de potentiel, jamais comme une preuve de performance.\n- Action : Garder en mode pipeline tant que Sirene n est pas importe.\n\n```markdown\n### Densite economique vin\n`{{wine_establishment_count}}` etablissements rattaches aux codes NAF vin, dont `{{core_wine_naf_share}}%` coeur de filiere.\n\n_Source : Sirene. Caveat : source pipeline tant que le stock normalise n est pas importe._\n```\n\n### Quel contexte marche ajouter sans surpromettre ?\n- Question utilisateur : Puis-je enrichir une fiche territoire avec un signal prix/marche fiable ?\n- Famille visuelle : market_context\n- KPI : bulk_price_trend, segment_label, latest_available_period, normalization_status\n- Sources : franceagrimer_bulk_prices, source_activation_status, reference_publication_gate\n- Angle copy : Utiliser le marche comme contexte secondaire tant que la normalisation n est pas industrialisee.\n- Action : Ne pas afficher en KPI principal avant import normalise.\n\n```markdown\n### Contexte marche\nTendance prix vrac : `{{bulk_price_trend}}` sur `{{latest_available_period}}`.\n\n_Source : FranceAgriMer. Caveat : a publier uniquement apres normalisation et controle du Publication Gate._\n```\n\n### Pourquoi peut-on faire confiance a ce KPI ?\n- Question utilisateur : Quelle preuve donner pour expliquer la fiabilite du chiffre ?\n- Famille visuelle : source_operations\n- KPI : source_lineage, refresh_policy, citation_text, publication_status\n- Sources : source_refresh_policy, reference_source_lineage, reference_citation_kit, reference_launch_readiness\n- Angle copy : Donner un recu de confiance : origine, fraicheur, transformation, limite.\n- Action : Afficher sous chaque KPI public en format compact.\n\n```markdown\n### Recu de confiance\n- Origine : `{{source_origin}}`\n- Fraicheur : `{{refresh_status}}`\n- Transformation : `{{transformation_note}}`\n- Limite : `{{source_caveat}}`\n```\n\n## Playbooks\n\n### Page publique territoire\n- Sequence : Hero Reference Score -> Territory Proof Stack -> Oenotourism Capacity Card -> Source Trust Receipt\n- Succes : Un lecteur comprend le potentiel et les limites en moins de 30 secondes.\n\n### Deck direction / investisseur\n- Sequence : Reference snapshot -> Capacity pitch -> Business density context -> Market caveat slide\n- Succes : Les decisions possibles sont separees des donnees encore pipeline.\n\n### Data room reference\n- Sequence : API manifest -> Data contracts -> Source lineage -> Launch readiness -> Citation kit\n- Succes : Un partenaire peut auditer les sources sans demander une explication orale.\n" }