{"ok":true,"generated_at":"2026-07-08T00:12:59+02:00","family_count":6,"families":[{"key":"reference_authority","family":"Autorite reference","north_star":"Prouver que Winerix peut etre cite comme source data vin.","aggregation_level":"plateforme","hero_kpis":["reference_score","confidence_score","source_count","publication_status"],"secondary_kpis":["product_count","stage_counts","evidence_count"],"source_products":["wine_reference_pack","reference_publication_gate","reference_data_product_index"],"products":[{"key":"wine_reference_pack","label":"Reference Pack Winerix","markdown_export":"/api/reference_export.php?type=wine_reference_pack&format=md","caveat":"Synthèse de maturité : dépend des imports locaux et des caveats de chaque source."},{"key":"reference_publication_gate","label":"Publication Gate","markdown_export":"/api/get_reference_publication_gate.php?format=md","caveat":"Gate de readiness : ne remplace pas les tests d’import DB ni la validation métier finale."},{"key":"reference_data_product_index","label":"Data Product Index","markdown_export":"/api/get_reference_data_product_index.php?format=md","caveat":"Index de navigation : il reflète le catalogue produit configuré, pas la fraîcheur réelle des données importées."}],"copy_sentence":"Winerix est publiable comme reference quand le score, la confiance, les sources et le gate de publication convergent.","caveat":"Ne jamais publier le score sans le gate et les limites de source.","visual_treatment":"score ring + preuve source + badge gate"},{"key":"wine_territory","family":"Territoire viticole","north_star":"Mesurer l empreinte vin d un territoire sans confondre surface, appellation et preuve reglementaire.","aggregation_level":"commune, departement, appellation","hero_kpis":["inao_aoc_aop_areas","inao_siqo_wine_products","rpg_vineyard_surface_ha","agreste_surface_vigne"],"secondary_kpis":["rpg_vineyard_communes","agreste_production_vin","eambrosia_gi_count"],"source_products":["appellation_evidence_pack","inao_aoc_aop_communes","inao_siqo_products","rpg_vineyard_parcels","agreste_viticulture"],"products":[{"key":"appellation_evidence_pack","label":"Preuve appellation complète","markdown_export":"/api/reference_export.php?type=appellation_evidence_pack&format=md","caveat":"Matching normalisé accents/casse/ponctuation, mais encore textuel : relire les libellés avant usage juridique ou publication forte."},{"key":"inao_aoc_aop_communes","label":"Aires AOC/AOP INAO par commune","markdown_export":"/api/reference_export.php?type=inao_aoc_aop_communes&format=md","caveat":"AOC/AOP toutes familles : filtrer/croiser avec les appellations vin Winerix, COMAGRI ou eAmbrosia avant usage juridique."},{"key":"inao_siqo_products","label":"Produits SIQO INAO vin","markdown_export":"/api/reference_export.php?type=inao_siqo_products&format=md&wine_only=1","caveat":"Source produit officielle : ne remplace pas les aires communales INAO ni les cahiers des charges eAmbrosia."},{"key":"rpg_vineyard_parcels","label":"Parcelles viticoles RPG","markdown_export":"/api/reference_export.php?type=rpg_vineyard_parcels&format=md","caveat":"Déclaratif PAC : pas propriété cadastrale ni exhaustivité vigne."},{"key":"agreste_viticulture","label":"Cadrage Agreste viticulture","markdown_export":"/api/reference_export.php?type=agreste_viticulture&format=md","caveat":"Statistique territoriale, pas preuve parcellaire ni domaine."}],"copy_sentence":"Le territoire viticole se lit par couches : SIQO, aire communale, parcelles RPG et cadrage Agreste.","caveat":"Les surfaces et les aires ne prouvent pas la propriete, la production exacte ni le droit juridique sans controle.","visual_treatment":"carte stratifiee + jauge preuve + tags source"},{"key":"oenotourism_capacity","family":"Capacite oenotouristique","north_star":"Qualifier l accueil et l offre sans assimiler capacite a frequentation.","aggregation_level":"commune, destination, departement","hero_kpis":["datatourisme_oenotourism_offers","insee_tourism_capacity_total","classified_accommodations","tourism_handicap_establishments"],"secondary_kpis":["vignobles_decouvertes_listed_destinations","tourism_handicap_all_four_disabilities","classified_accommodation_rooms"],"source_products":["oenotourism_offers","insee_tourism_capacity_communes","classified_accommodations","tourism_handicap_establishments","vignobles_decouvertes"],"products":[{"key":"oenotourism_offers","label":"oenotourism_offers","markdown_export":"","caveat":""},{"key":"insee_tourism_capacity_communes","label":"Capacité touristique communale INSEE","markdown_export":"/api/reference_export.php?type=insee_tourism_capacity_communes&format=md","caveat":"Capacité officielle au 1er janvier : pas fréquentation réelle, pas nuitées, pas motivation vin."},{"key":"classified_accommodations","label":"Hébergements touristiques classés","markdown_export":"/api/reference_export.php?type=classified_accommodations&format=md","caveat":"Hébergements classés uniquement : pas toute l’offre, pas fréquentation réelle."},{"key":"tourism_handicap_establishments","label":"Établissements Tourisme & Handicap","markdown_export":"/api/reference_export.php?type=tourism_handicap_establishments&format=md","caveat":"Label accessibilité : ne mesure pas fréquentation, satisfaction ni exhaustivité de toute l’offre touristique."},{"key":"vignobles_decouvertes","label":"Destinations Vignobles & Découvertes","markdown_export":"/api/reference_export.php?type=vignobles_decouvertes_destinations&format=md","caveat":"Label destination : pas fréquentation, pas performance de chaque prestataire."}],"copy_sentence":"La capacite oenotouristique combine offre publiee, capacite officielle, hebergements classes, accessibilite et labels.","caveat":"Offre, capacite et labels ne mesurent pas les nuitees, le chiffre d affaires local ni la motivation vin.","visual_treatment":"cartes capacite + icones offre/accessibilite + caveat visible"},{"key":"market_context","family":"Contexte marche","north_star":"Donner un contexte prix/macro sans le transformer en cotation commerciale.","aggregation_level":"France, campagne, semaine, segment","hero_kpis":["bulk_price_series","latest_bulk_price","macro_wine_indicators","trade_nc8_tracked_codes"],"secondary_kpis":["avg_price","campaigns","macro_wine_latest_year"],"source_products":["bulk_wine_prices","reference_kpi_dictionary","wine_reference_pack"],"products":[{"key":"bulk_wine_prices","label":"Prix vrac FranceAgriMer","markdown_export":"/api/reference_export.php?type=bulk_wine_prices&format=md","caveat":"Prix vrac France entière VSIG/IGP : pas prix domaine, pas contrats privés, pas cotation appellation fine."},{"key":"reference_kpi_dictionary","label":"Dictionnaire KPI Winerix","markdown_export":"/api/get_reference_kpi_dictionary.php?format=md","caveat":"Dictionnaire sémantique : ne remplace pas les valeurs dynamiques ni les contrôles d’import."},{"key":"wine_reference_pack","label":"Reference Pack Winerix","markdown_export":"/api/reference_export.php?type=wine_reference_pack&format=md","caveat":"Synthèse de maturité : dépend des imports locaux et des caveats de chaque source."}],"copy_sentence":"Le marche se raconte avec des signaux macro et des prix vrac, pas avec une promesse de prix domaine.","caveat":"Prix France entiere VSIG/IGP, pas prix domaine, pas contrats prives, pas cotation appellation fine.","visual_treatment":"sparkline marche + badge segment + note de prudence"},{"key":"wine_business_density","family":"Densite economique vin","north_star":"Identifier le tissu economique vin et les zones d action commerciale.","aggregation_level":"commune, departement, code NAF","hero_kpis":["sirene_wine_establishments","core_wine_establishments","naf_codes","business_presence_score"],"secondary_kpis":["sirens","communes","department_count"],"source_products":["sirene_wine_establishments","reference_user_need_navigator","source_opportunity_radar"],"products":[{"key":"sirene_wine_establishments","label":"Établissements vin SIRENE","markdown_export":"/api/reference_export.php?type=sirene_wine_establishments&format=md","caveat":"Activité administrative déclarée : codes adjacents non exclusivement vin et obligations RGPD pour usages nominatifs."},{"key":"reference_user_need_navigator","label":"User Need Navigator","markdown_export":"/api/get_reference_user_need_navigator.php?format=md","caveat":"Navigator éditorial : il route vers les produits, mais ne prouve pas la fraîcheur ni l’import effectif de chaque source."},{"key":"source_opportunity_radar","label":"Source Opportunity Radar","markdown_export":"/api/get_source_opportunity_radar.php?format=md","caveat":"Radar de priorisation : les sources listées ne sont pas toutes encore importées ni validées métier."}],"copy_sentence":"La densite economique vin doit separer le coeur vin des codes adjacents boissons avant usage commercial.","caveat":"Sirene est administratif ; les usages nominatifs et codes adjacents demandent controle RGPD/metier.","visual_treatment":"heatmap NAF + split coeur/adjacent + alerte RGPD"},{"key":"source_operations","family":"Operations sources","north_star":"Savoir quoi publier, quoi annoter, quoi bloquer et quelle source traiter ensuite.","aggregation_level":"source, produit, release","hero_kpis":["source_activation_readiness","publication_action","freshness_status","opportunity_score"],"secondary_kpis":["missing_required_files","stale_sources","p1_tickets"],"source_products":["source_activation_status","source_maintenance_board","source_opportunity_radar","reference_publication_gate"],"products":[{"key":"source_activation_status","label":"Statut activation sources","markdown_export":"/api/get_source_activation_status.php?format=md","caveat":"Statut fichiers/config uniquement : ne prouve pas que l’import DB a réussi."},{"key":"source_maintenance_board","label":"Board maintenance sources","markdown_export":"/api/get_source_maintenance_board.php?format=md","caveat":"Board opérationnel : ne prouve pas l’import DB ni la validité métier des données."},{"key":"source_opportunity_radar","label":"Source Opportunity Radar","markdown_export":"/api/get_source_opportunity_radar.php?format=md","caveat":"Radar de priorisation : les sources listées ne sont pas toutes encore importées ni validées métier."},{"key":"reference_publication_gate","label":"Publication Gate","markdown_export":"/api/get_reference_publication_gate.php?format=md","caveat":"Gate de readiness : ne remplace pas les tests d’import DB ni la validation métier finale."}],"copy_sentence":"Une source devient publiable quand le fichier, la fraicheur, l import, le caveat et la decision gate sont alignes.","caveat":"Un statut fichier/config ne prouve pas l import DB ni la validation metier.","visual_treatment":"kanban source + badges P1/P2 + gate publier/annoter/bloquer"}],"copy_markdown":"# Reference KPI Scorecard Winerix\n\nScorecard de coherence KPI : familles, KPI heros, niveau d aggregation, produits sources et caveats.\n\n## Table copiable\n\n| Famille | Niveau | KPI heros | Produits | Caveat |\n|---|---|---|---|---|\n| Autorite reference | plateforme | reference_score, confidence_score, source_count, publication_status | Reference Pack Winerix, Publication Gate, Data Product Index | Ne jamais publier le score sans le gate et les limites de source. |\n| Territoire viticole | commune, departement, appellation | inao_aoc_aop_areas, inao_siqo_wine_products, rpg_vineyard_surface_ha, agreste_surface_vigne | Preuve appellation complète, Aires AOC/AOP INAO par commune, Produits SIQO INAO vin, Parcelles viticoles RPG, Cadrage Agreste viticulture | Les surfaces et les aires ne prouvent pas la propriete, la production exacte ni le droit juridique sans controle. |\n| Capacite oenotouristique | commune, destination, departement | 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 | Offre, capacite et labels ne mesurent pas les nuitees, le chiffre d affaires local ni la motivation vin. |\n| Contexte marche | France, campagne, semaine, segment | bulk_price_series, latest_bulk_price, macro_wine_indicators, trade_nc8_tracked_codes | Prix vrac FranceAgriMer, Dictionnaire KPI Winerix, Reference Pack Winerix | Prix France entiere VSIG/IGP, pas prix domaine, pas contrats prives, pas cotation appellation fine. |\n| Densite economique vin | commune, departement, code NAF | sirene_wine_establishments, core_wine_establishments, naf_codes, business_presence_score | Établissements vin SIRENE, User Need Navigator, Source Opportunity Radar | Sirene est administratif ; les usages nominatifs et codes adjacents demandent controle RGPD/metier. |\n| Operations sources | source, produit, release | source_activation_readiness, publication_action, freshness_status, opportunity_score | Statut activation sources, Board maintenance sources, Source Opportunity Radar, Publication Gate | Un statut fichier/config ne prouve pas l import DB ni la validation metier. |\n\n## Autorite reference\n\n**North star.** Prouver que Winerix peut etre cite comme source data vin.\n\n**Phrase prete a coller.** Winerix est publiable comme reference quand le score, la confiance, les sources et le gate de publication convergent.\n\n**KPI heros.** reference_score, confidence_score, source_count, publication_status\n\n**Exports sources.**\n\n- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md\n- Publication Gate : /api/get_reference_publication_gate.php?format=md\n- Data Product Index : /api/get_reference_data_product_index.php?format=md\n\n**Direction visuelle.** score ring + preuve source + badge gate\n\n**Caveat.** Ne jamais publier le score sans le gate et les limites de source.\n\n## Territoire viticole\n\n**North star.** Mesurer l empreinte vin d un territoire sans confondre surface, appellation et preuve reglementaire.\n\n**Phrase prete a coller.** Le territoire viticole se lit par couches : SIQO, aire communale, parcelles RPG et cadrage Agreste.\n\n**KPI heros.** inao_aoc_aop_areas, inao_siqo_wine_products, rpg_vineyard_surface_ha, agreste_surface_vigne\n\n**Exports sources.**\n\n- Preuve appellation complète : /api/reference_export.php?type=appellation_evidence_pack&format=md\n- Aires AOC/AOP INAO par commune : /api/reference_export.php?type=inao_aoc_aop_communes&format=md\n- Produits SIQO INAO vin : /api/reference_export.php?type=inao_siqo_products&format=md&wine_only=1\n- Parcelles viticoles RPG : /api/reference_export.php?type=rpg_vineyard_parcels&format=md\n- Cadrage Agreste viticulture : /api/reference_export.php?type=agreste_viticulture&format=md\n\n**Direction visuelle.** carte stratifiee + jauge preuve + tags source\n\n**Caveat.** Les surfaces et les aires ne prouvent pas la propriete, la production exacte ni le droit juridique sans controle.\n\n## Capacite oenotouristique\n\n**North star.** Qualifier l accueil et l offre sans assimiler capacite a frequentation.\n\n**Phrase prete a coller.** La capacite oenotouristique combine offre publiee, capacite officielle, hebergements classes, accessibilite et labels.\n\n**KPI heros.** datatourisme_oenotourism_offers, insee_tourism_capacity_total, classified_accommodations, tourism_handicap_establishments\n\n**Exports sources.**\n\n- oenotourism_offers : export n/a\n- Capacité touristique communale INSEE : /api/reference_export.php?type=insee_tourism_capacity_communes&format=md\n- Hébergements touristiques classés : /api/reference_export.php?type=classified_accommodations&format=md\n- Établissements Tourisme & Handicap : /api/reference_export.php?type=tourism_handicap_establishments&format=md\n- Destinations Vignobles & Découvertes : /api/reference_export.php?type=vignobles_decouvertes_destinations&format=md\n\n**Direction visuelle.** cartes capacite + icones offre/accessibilite + caveat visible\n\n**Caveat.** Offre, capacite et labels ne mesurent pas les nuitees, le chiffre d affaires local ni la motivation vin.\n\n## Contexte marche\n\n**North star.** Donner un contexte prix/macro sans le transformer en cotation commerciale.\n\n**Phrase prete a coller.** Le marche se raconte avec des signaux macro et des prix vrac, pas avec une promesse de prix domaine.\n\n**KPI heros.** bulk_price_series, latest_bulk_price, macro_wine_indicators, trade_nc8_tracked_codes\n\n**Exports sources.**\n\n- Prix vrac FranceAgriMer : /api/reference_export.php?type=bulk_wine_prices&format=md\n- Dictionnaire KPI Winerix : /api/get_reference_kpi_dictionary.php?format=md\n- Reference Pack Winerix : /api/reference_export.php?type=wine_reference_pack&format=md\n\n**Direction visuelle.** sparkline marche + badge segment + note de prudence\n\n**Caveat.** Prix France entiere VSIG/IGP, pas prix domaine, pas contrats prives, pas cotation appellation fine.\n\n## Densite economique vin\n\n**North star.** Identifier le tissu economique vin et les zones d action commerciale.\n\n**Phrase prete a coller.** La densite economique vin doit separer le coeur vin des codes adjacents boissons avant usage commercial.\n\n**KPI heros.** sirene_wine_establishments, core_wine_establishments, naf_codes, business_presence_score\n\n**Exports sources.**\n\n- Établissements vin SIRENE : /api/reference_export.php?type=sirene_wine_establishments&format=md\n- User Need Navigator : /api/get_reference_user_need_navigator.php?format=md\n- Source Opportunity Radar : /api/get_source_opportunity_radar.php?format=md\n\n**Direction visuelle.** heatmap NAF + split coeur/adjacent + alerte RGPD\n\n**Caveat.** Sirene est administratif ; les usages nominatifs et codes adjacents demandent controle RGPD/metier.\n\n## Operations sources\n\n**North star.** Savoir quoi publier, quoi annoter, quoi bloquer et quelle source traiter ensuite.\n\n**Phrase prete a coller.** Une source devient publiable quand le fichier, la fraicheur, l import, le caveat et la decision gate sont alignes.\n\n**KPI heros.** source_activation_readiness, publication_action, freshness_status, opportunity_score\n\n**Exports sources.**\n\n- Statut activation sources : /api/get_source_activation_status.php?format=md\n- Board maintenance sources : /api/get_source_maintenance_board.php?format=md\n- Source Opportunity Radar : /api/get_source_opportunity_radar.php?format=md\n- Publication Gate : /api/get_reference_publication_gate.php?format=md\n\n**Direction visuelle.** kanban source + badges P1/P2 + gate publier/annoter/bloquer\n\n**Caveat.** Un statut fichier/config ne prouve pas l import DB ni la validation metier.\n"}