# Lot « Registre des découvertes » — ce qui a été trouvé, tiré, décidé + implications recherche

**Demande** : une page qui donne **tous les cas découverts** — ce qui a été trouvé dans les données,
ce qu'on en a tiré, ce qui a été décidé — et, à côté, **les implications pour la recherche**.

**Livré** : `decouvertes.html` + `decouvertes_app.js` (lien « Découvertes » dans la barre),
5 vues, export CSV du registre et export JSON des décisions, liens profonds
(`?vue=`, `?pays=`, `?min=`, `?ouvre=N`).

## Vue 1 — Ce qui a été trouvé (synthèse)
**1 543 constats** / 1 396 flux examinés, seuil d'écart miroir **20 %** ;
répartition par type de constat (**738** écart miroir confirmé, **343** un seul côté déclare,
**287** prix sous la référence, **115** divergence de prix, **44** hors bornes, **15** divergence persistante,
**1** groupe détecté) et par gravité (**524 haute** / **663 moyenne** / **356 basse**) ;
concentration par pays, minerai, partenaire et année ; les 10 dossiers les plus lourds.

> **Mise à jour du lot « couverture prix »** : les constats passent de 1 423 à **1 543** et les
> « prix sous la référence » de 167 à **287** — effet direct du branchement de la source USGS
> (`usgs_mcs`), qui porte la couverture prix de 4 à **9 minerais sur 10**.

## Vue 2 — Dossiers : trouvé → tiré → décidé
Regroupement en **dossiers pays × partenaire × minerai** (jamais une entreprise nommée).
Pour chaque dossier, 4 volets :
1. **Trouvé** — les constats année par année avec les valeurs des deux côtés et l'écart en %.
2. **Tiré** — la **procédure de résolution** par type de signal (étapes, qui, délai, **pièce décisive**,
   test de clôture) + l'**ancrage national** (autorité, délai, référence de prix) + liens vers
   le dossier d'instruction et la fiche pays × minerai.
3. **Décidé** — cycle de vie : à instruire / en cours / clôturé-écarté / clôturé-établi / prescrit,
   avec auteur, motif et horodatage ; **export JSON** au format attendu par le moteur
   (`_data/cases.json`). Aujourd'hui : **0 constat rattaché à un dossier décidé** — l'outil le dit.
4. **Ce qui manque** — le verrou de chaque dossier (déclaration du partenaire absente, contrat/teneur
   à obtenir, source non connectée, absence de référence de prix, délai non vérifié).

## Vue 3 — Contexte contractuel
Ce que révèlent les contrats publiés (ResourceContracts.org) : contrats par pays et clauses à risque
(confidentialité, arbitrage, exclusivité, immunité souveraine, stabilisation, take-or-pay, garanties).
Exemple mesuré : RDC 345 contrats dont 184 confidentiels ; Guinée 114 dont 44 ; Sénégal 101 dont 70.

## Vue 4 — Journal, méthode et angles morts
Date et seuil du moteur, **empreinte FNV-1a** du jeu de constats (`3A74D05F` aujourd'hui),
**sources chargées (9)** vs **non connectées (4)**, et les angles morts chiffrés :
**26 flux sans prix de référence** (contre 928 avant le branchement USGS) et
**1 minerai sur 10 sans benchmark** (contre 6 sur 10),
et les 3 limites à recopier dans tout rapport (écart déclaratif ≠ écart de prix ; source non connectée
≠ source vérifiée ; l'outil ne nomme aucune entreprise).

Sources **chargées** : `comtrade`, `resource_contracts`, `contract_redflags`, `worldbank_prices`,
`corporate_registry`, `resourceprojects`, `usgs_mcs`, `production`, `company_flow_link`.
Sources **non connectées** : `beneficial_ownership`, `mining_licenses`, `shipping_ais`, `case_registry`
— affichées comme telles, jamais simulées.

## Vue 5 — Implications pour la recherche
- **Statut des hypothèses** : H1 (écarts plus larges hors minerais cotés) *testable maintenant*,
  H2 (amplification post-2013) *donnée manquante* — fenêtre 2018-2025, H3 (concentration acheteur)
  *exploratoire*, H4 (ITIE) *à documenter*. Les hypothèses elles-mêmes ne sont pas publiées :
  la vue ne dit que ce que les données portent.
- **Mesure n°1** : écart moyen par **zone de prix** (verte / orange / rouge), calculé sur les constats.
- **Mesure n°2** : **HHI acheteur** par pays × minerai croisé avec l'écart moyen (exploratoire).
- **Trois dimensions rendues mesurables** : la transparence miroir (24,6 % des flux sans déclaration
  du partenaire), la zone de prix chiffrée, le contrat comme variable d'accessibilité.
- **Protocole à compléter** : fenêtre pré-2013, panel à effets fixes, contrôles FOB/CIF-hub-HS,
  teneur, délais de prescription réels.

## Vérifications
| Contrôle | Résultat |
|---|---|
| `node --check` | `decouvertes_app.js`, `navbar.js`, `i18n_en.js` → **0** |
| HTTP | `decouvertes.html`, `decouvertes_app.js` → **200** |
| Vue 1 | 28 177 car., KPI et répartitions présents, navbar injectée |
| Vue 2 (+`?ouvre=0`) | 80 549 car., ouverture du dossier → **« Ce qu'on en tire », « Ce qui manque », « Décider »** rendus |
| Vue 3 | 24 437 car., clauses de confidentialité et tableau par pays |
| Vue 4 | 20 334 car., journal, empreinte, angles morts |
| Vue 5 | 22 334 car., hypothèses, mesures, protocole |
| `?lang=en` | « Discovery register », « Implications for research » |
| Filtre `?pays=drc` | 50 195 car., dossiers filtrés |

**Bug corrigé en cours de route** : `fmtN` n'avait pas été défini dans l'application — les vues 3, 4 et 5
levaient une erreur et rendaient vide. Corrigé et re-testé vue par vue.