# Reference Embed Kit

Kit de blocs copiables pour publier les KPI Winerix en cartes HTML, extraits Markdown, badges de source et recettes copy-to-clipboard.

## Blocs copiables

### Hero Reference Score
- Usage : Page publique, pitch deck, fiche territoire
- Format : html
- Cible : Bloc hero KPI avec score, preuve et caveat
- Dependances : reference_visual_system, reference_kpi_scorecard, reference_citation_kit

```html
<section class="wx-kpi wx-kpi--authority"><p class="wx-kpi__eyebrow">Reference Winerix</p><h2>Score reference : 86/100</h2><p>Couverture officielle forte, sources citees et activation suivie.</p><small>Sources : INAO, Insee, Atout France. Caveat : donnees selon disponibilite locale.</small></section>
```

### Territory Proof Stack
- Usage : Fiche appellation, page region, module SEO
- Format : markdown
- Cible : Pile de preuves sourcees pour un territoire
- Dependances : appellation_evidence_pack, source_lineage_matrix, publication_gate

```markdown
### Preuves territoire
- **Appellation** : AOC/AOP confirmee via INAO.
- **Surface** : parcelles viticoles consolidees avec RPG.
- **Tourisme** : capacite d'accueil rapprochee via Insee.
- **A publier si** : sources fraiches, caveat explicite, export reproductible.
```

### Oenotourism Capacity Card
- Usage : Dashboard destination, observatoire, dossier investisseur
- Format : html
- Cible : Carte capacite oenotouristique avec accessibilite et hebergements
- Dependances : insee_tourism_capacity_communes, atout_france_accommodations, tourisme_handicap

```html
<article class="wx-card wx-card--capacity"><span>Oenotourisme</span><strong>1 240 lits classes</strong><p>Hotels, campings et residences consolides par commune viticole.</p><small>Ajouter le badge accessibilite si Tourisme & Handicap est present.</small></article>
```

### Market Context Sparkline
- Usage : Note marche, slide prix, briefing direction
- Format : html
- Cible : Mini tendance marche avec prudence source
- Dependances : bulk_wine_price_pack, reference_publishable_snippets

```html
<div class="wx-spark wx-spark--market"><b>Prix vrac</b><span>tendance a normaliser</span><p>Utiliser seulement apres integration FranceAgriMer normalisee.</p></div>
```

### Source Gate Badges
- Usage : Back-office, data room, page methodologie
- Format : html
- Cible : Badges de statut pour ne pas surpromettre les sources
- Dependances : source_activation_status, source_maintenance_board, launch_readiness

```html
<p class="wx-gates"><span data-status="ready">publier</span><span data-status="watch">surveiller</span><span data-status="blocked">pipeline</span></p>
```

### Copy Button Recipe
- Usage : Portail reference, page KPI, outil commercial
- Format : javascript
- Cible : Bouton copier neutre, reutilisable sur les exports
- Dependances : reference_api_manifest, reference_visual_system

```javascript
document.querySelectorAll('[data-copy]').forEach((button) => {
  button.addEventListener('click', async () => {
    const target = document.querySelector(button.dataset.copy);
    await navigator.clipboard.writeText(target ? target.textContent.trim() : '');
    button.textContent = 'Copie';
  });
});
```

## Tokens CSS
- `font_title` : Canela / Fraunces / Georgia
- `font_body` : Satoshi / Manrope / system sans fallback
- `radius_card` : 22px
- `shadow_card` : 0 18px 45px rgba(29, 39, 48, 0.14)
- `border_proof` : 1px solid rgba(125, 31, 45, 0.18)
- `color_authority` : #7d1f2d
- `color_territory` : #52724f
- `color_capacity` : #2b8f99
- `color_market` : #b15a32
- `color_operations` : #315c7a

## Regles de publication
- **Toujours tripler nombre + source + caveat** : Aucun KPI public ne doit sortir sans source primaire et limite de lecture.
- **Distinguer fait officiel et lecture Winerix** : Les donnees INAO/Insee/Atout France sont des faits ; les scores, priorites et segments sont des interpretations Winerix.
- **Preferer les blocs copiables** : Chaque KPI majeur doit exister en JSON, Markdown, CSV et snippet presentable.
- **Ne pas publier les sources pipeline comme des donnees actives** : FranceAgriMer et Sirene restent clairement marques tant que le fichier normalise/import n est pas disponible.

## Exemple HTML complet

```html
<style>
  .wx-kpi {
    --wx-accent: #7d1f2d;
    background: linear-gradient(135deg, #fff8ea 0%, #f4efe3 100%);
    border: 1px solid rgba(125, 31, 45, .18);
    border-radius: 22px;
    box-shadow: 0 18px 45px rgba(29, 39, 48, .14);
    color: #14231d;
    max-width: 560px;
    padding: 28px;
  }
  .wx-kpi__eyebrow {
    color: var(--wx-accent);
    font-size: 12px;
    font-weight: 800;
    letter-spacing: .14em;
    text-transform: uppercase;
  }
  .wx-kpi h2 {
    font-family: Georgia, serif;
    font-size: clamp(34px, 6vw, 62px);
    line-height: .95;
    margin: 10px 0;
  }
  .wx-kpi small {
    display: block;
    margin-top: 18px;
    opacity: .74;
  }
</style>
<section class="wx-kpi">
  <p class="wx-kpi__eyebrow">Reference Winerix</p>
  <h2>86/100</h2>
  <p>Un territoire lisible, source et pret a publier.</p>
  <small>Sources : INAO, Insee, Atout France. Caveat : verification fraicheur requise avant publication.</small>
</section>
```