Comment ça marche Documentation des outils · construction · fonctionnement Bibliothèque Dossier d'audit Guide

1 · Vue d'ensemble — la chaîne en 4 couches

Le dispositif relie des données publiques à des décisions de contrôle. Il ne remplace pas le jugement de l'inspecteur : il le prépare.

DONNÉES                    ->  RISK ENGINE             ->  OUTILS                     ->  LIVRABLE
UN Comtrade (flux)             détecteurs explicables     Mirror Trade Dashboard         Dossier d'audit
ResourceContracts (contrats)   bornes de plausibilité     Observatoire des Contrats      Cas à vigilance P1/P2/P3
ResourceProjects (paiements)   score 0-100                Corporate Registry (GLEIF)     Kit multi-dossiers (PDF)
World Bank (prix)              priorité P1/P2/P3          Fiscal Risk Graph              Bibliothèque documentaire
GLEIF (entreprises)                                       FiscalMine AI (doctrine)       Directives d'exploitation

Les modules du portail — outils et méthodes officielles

ModuleRôleQuestion à laquelle il répond
Mirror Trade DashboardDétection (flux)Où regarder ? Quel écart, quel prix, quel pays ?
Observatoire des ContratsContexte contractuelQuelles clauses encadrent l'opération ?
Corporate RegistryEntreprisesQui opère, dans quels pays, dans quel groupe ?
Fiche société & suivi du dossierContexte + instructionIndice de convergence, état des branches, cycle de vie du dossier
Genèse — pourquoi & pour quiFond & doctrineLe problème, les contraintes des administrations, BEPS/prix de transfert, pour qui, ce qui manque
Ce que l'outil apporte (offre)Présentation & usageBénéfices, ce qui existe déjà, méthode, contexte 2026, asymétrie Nord/Sud, trois offres, objections
Cadre officiel (SDG 16.4.1)Cadre de référenceDans quel cadre ce dispositif mesure-t-il ? Définitions concurrentes, catalogue des méthodes, vocabulaire officiel (dont la version française), et ce que nous ne faisons pas
PFM+ — le filtre de prix (méthode 2)Méthode officielle outilléeComment juger un prix quand il n'existe pas de référentiel ? Les 7 gestes, la bande de prix, un calculateur auto-testé, le sens du flux (entrant/sortant)
Remontée SDG 16.4.1Livrable de conformitéComment remonter l'indicateur ? Les 8 règles de déclaration, le gabarit en 5 feuilles, le générateur de métadonnées, la checklist
Groupe technique & cartographie des donnéesProcessus & institutionsQui détient quoi, à quelles conditions ? Agences, sources par méthode, six colonnes de disponibilité, générateur de plan d'action exportable
Mémoire de capitalisation (pays × minerai)Procédures & droitPar pays et par minerai : autorités compétentes, points d'entrée, délais de prescription (écrits vs réels), jurisprudence locale référencée, matrice de couverture, complétude honnête. Base validée par build_capitalisation.py (aucune valeur « vérifiée » sans source) ; ancrage national injecté automatiquement dans chaque procédure par resolution.js.
Registre des découvertesRésultats & rechercheTout ce que le moteur a trouvé dans les données (1 543 constats, seuil 20 %, gravités) regroupé en dossiers pays × partenaire × minerai, avec pour chacun : ce qui a été trouvé (chiffres des deux côtés), ce qu'on en tire (procédure + pièce décisive), ce qui a été décidé (cycle de vie, décision exportable vers le moteur) et ce qui manque. Plus : journal et empreinte, contexte contractuel (clauses à risque par pays), angles morts mesurés, et implications pour la recherche (statut des hypothèses H1–H4, mesures nouvelles, protocole à compléter).
Fiscal Risk GraphVue systèmeFlux, réseau, carte animée, propriété, contrats
Cas à vigilancePriorisationQuels dossiers traiter d'abord (P1/P2/P3) ?
Dossier d'auditAssemblageQue vérifier, quelles preuves, quelles questions ?
Audit de A à ZAutomatisationFaire exécuter tout le parcours par l'outil
Guide & BibliothèqueMode d'emploiComment utiliser, quels documents, comment les exploiter ?

2 · Comment c'est construit (le pipeline)

a) Collecte — scripts Python sur le VPS, déclenchés par cron

ScriptSourceCe qu'il récupèreFréquence
comtrade_collector_multi.pyUN ComtradeFlux export Afrique vs import partenaire (valeur + quantité + prix unitaire), mode discoverquotidien 03:10
fetch_worldbank_prices.pyBanque mondiale (Pink Sheet)Prix mensuels et annuels de référencemensuel
fetch_resource_contracts.pyResourceContracts.org907 contrats (id, pays, année, type, ressources, URL)mensuel
scan_contract_redflags.pytextes des contratsDétection par mots-clés de 7 types de clausesmensuel
download_and_ocr_contracts.pyPDF sourcesExtraction texte (pdftotext/OCR) — téléchargements souvent bloqués côté sourcequotidien
fetch_gleif.pyGLEIF LEI (CC0)Sociétés + relations de propriété (parent direct/ultime)mensuel
fetch_resourceprojects.pyResourceProjects.org (NRGI)Paiements déclarés par projet/société/année (9 802 projets)mensuel
build_africa_borders.pyNatural Earth 110m (domaine public)Frontières africaines simplifiées (51 pays, 16 Ko) pour le fond de la vue cartemensuel

b) Moteur — fiscal_engine.py (quotidien 06:30)

  • Construit le graphe commun : trade_flows, contracts, price_benchmarks, companies, ownership_edges, payments_by_country, company_links.
  • Applique les détecteurs (§4) avec des bornes de plausibilité par minerai (sépare « erreur de donnée » de « signal fiscal »).
  • Écrit deux fichiers web : fiscal_graph.json et fiscal_signals.json.
  • Entity resolution : rapprochement GLEIF ↔ sociétés déclarantes (ResourceProjects) ↔ parties des contrats, par normalisation des noms (suffixes Ltd/PLC/SA/Group retirés).

c) Diffusion — pages HTML autonomes

Chaque module est une page unique (HTML/CSS/JS, thème clair/sombre) qui lit les JSON du moteur. Si une source n'est pas connectée, l'interface l'affiche comme telle.

Principe d'intégrité : aucune donnée n'est fabriquée ; chaque source porte son origine, sa licence et sa date. Aucun contournement anti-bot n'est utilisé.

3 · Comment ça fonctionne (par outil)

OutilDonnées luesTraitementComment le lire
Mirror Trade Dashboardtrade_gaps_multi.json (1 396 lignes)Agrégations par pays/partenaire/minerai/année, gaps, prix unitaires, score de risque v4Page Alertes = file d'audit par score · Table = détail + prix · Prix réf. = benchmark
Fiscal Risk Graphfiscal_graph.json + africa_borders.json5 vues : Sankey (flux), réseau (pays↔partenaires), carte animée (lon/lat, fond des frontières africaines Natural Earth), propriété (GLEIF), contratsChoisir un onglet, régler Top N / seuil / minerai ; case Fond Afrique ; export PNG ou PDF. Liens partageables : #mapflow, ?fond=off, ?theme=light
Cas à vigilancefiscal_signals.jsonRegroupe les signaux par pays×partenaire×minerai, score log-pondéré → P1/P2/P3Trier par priorité ; cliquer un dossier → signaux + pièces à demander
Dossier d'auditfiscal_signals.json + fiscal_graph.jsonAssemble 10 sections + evidence pack (source→donnée→calcul→hypothèse→limite→question)Sélectionner un dossier ; Imprimer/PDF ou Copier
Audit de A à Zidem + africa_borders.jsonExécute le parcours complet (12 étapes) sur critères ; 2 modes : dossier n°1 seul ou parcours multi-dossiers (Top N détaillés : synthèse k.0 + 10 sections numérotées par dossier) ; page de garde référencée, empreinte SHA-256 et fiche de traçabilité signableCritères + mode → Lancer → PDF signé (A4, un dossier par page, bandeau de référence) ; Copier pour le texte (réf. + empreinte) ; lien reproductible : ?auto=1&top=3&mode=parcours&th=20
Corporate RegistryGLEIF + ResourceProjects + contratsProfil société, graphe de propriété, pays d'opération (paiements), contrats liés, signaux des pays, et « Constituer le dossier de l'entreprise » : 10 sections (identité & appariement, couverture des sources, pays & paiements, signaux de contexte, contrats, groupe, questions, documents, ce que le dossier ne dit pas, traçabilité + empreinte SHA-256 + signature)Rechercher une société → bouton Constituer le dossier → Imprimer / PDF (A4) ou Copier ; lien partageable ?dos=<LEI> (ou ?dos=1) ; ajouter &lang=en pour l'anglais
Bibliothèque documentaireresource_contracts + redflags + paiementsListe des documents avec liens sources + directives d'exploitationFiltrer par pays/clause ; onglet Directives pour savoir quoi faire du document

4 · Les détecteurs du moteur

SignalRègle appliquéeCe que ça veut dire
mirror_gap_confirmedLes deux côtés déclarent et |écart| ≥ seuil — scénario central d'un intervalle 15 / 20 / 25 % (triplet lower / preferred / upper prescrit par l'ONU : UNODC, Working Guidelines, fév. 2026 ; bornes basse et haute également déclarables dans le gabarit de remontée de l'indicateur 16.4.1)Asymétrie déclarative à expliquer (sous/sur-facturation possible, ou écart légitime). Méthode officielle : PCM+ — Partner Country Method augmentée (UNCTAD, 2021). La seconde méthode de la même paire, celle du prix, est documentée dans PFM+
mirror_missing_sideUn seul côté déclare (l'autre = 0), agrégé par pays×partenaire×mineraiDonnée manquante possible — PAS un écart confirmé
unit_value_divergencePrix unitaire (USD/kg) des deux côtés, ratio ≥ 2 (bornes respectées)Écart de prix (sous-évaluation possible), indépendamment du volume
unit_price_suspectPrix hors bornes de plausibilité du mineraiQualité de donnée (unité/quantité) — pas un signal fiscal
unit_value_persistentRatio ≥ 1,5 sur ≥ 3 années pour le même coupleSchéma répété → pratique structurelle plutôt qu'incident
price_below_benchmarkPrix déclaré < référence Banque mondiale (unités comparables, non-proxy)Prix sous le marché (à ajuster selon teneur/incoterm)
corporate_groupEntités partageant le même parent ultime (GLEIF)Concentration de groupe — à croiser avec les flux
Le score de risque (0-100) combine 40 % écart relatif · 20 % écart absolu · 15 % sens · 15 % fiabilité · 10 % récurrence. Il sert à prioriser, jamais à conclure.

5 · Sources & licences

SourceContenuLicence
UN ComtradeFlux commerciaux (valeur, quantité)CC BY 4.0
ResourceContracts.orgContrats extractifsCC (à vérifier avant revente)
ResourceProjects.org (NRGI)Paiements déclarés (divulgation obligatoire)Données publiques de divulgation
GLEIF LEIEntreprises + propriétéCC0
Banque mondiale — Pink SheetPrix de référenceOuvert
Méthodo contrats (Dr Lyla Latif)Typologie de clauses à risqueRecherche — à vérifier
Natural Earth (110m admin_0)Frontières africaines simplifiées (fond de carte)Domaine public
Pour une revente commerciale : vérifier les licences (surtout contrats et méthodologie) avec le juriste. Aucune source n'est utilisée en contournant ses protections.

6 · Limites & précautions

  • Signal ≠ preuve : un écart peut venir du FOB/CIF, du fret, du transit, de la classification douanière, de la teneur/qualité, de données manquantes ou d'intermédiaires.
  • Un « 0 » peut être un vrai zéro, une non-déclaration ou une donnée non collectée → statut dédié « non déclaré ».
  • Granularité HS : un code agrège des qualités différentes ; le prix moyen peut tromper sans le grade.
  • Prix de référence : certaines séries sont des proxies (ex. bauxite ≈ aluminium) — écart structurel normal.
  • Temporalité : données annuelles et historiques → utile en contrôle a posteriori, pas au cordon.
  • Non connecté : UBO, licences/production nationales, douanes transactionnelles, AIS, données fiscales — affichés comme tels, jamais simulés.

7 · Journal des lots (résumé)

  • v4.1 (S1) — URL partageable, score de risque, ©/CC BY, badge qualité.
  • v5.x — habillage HUD, thème clair/sombre, drapeaux, jauges, carte.
  • S2c — resynchronisation (1 396 lignes), libellés pays normalisés, statut « non déclaré », fiabilité honnête (n/a).
  • S3a — price-gap dans la table (prix Afrique vs partenaire, ratio, export CSV).
  • G1 — moteur fiscal_engine.py + graphe commun (1 396 flux → 1 423 signaux).
  • G2/G3 — Corporate Registry + GLEIF (28 entreprises, 10 relations, groupe détecté).
  • G5 — prix de référence Banque mondiale (167 signaux sous le marché).
  • Guides — Guide de l'inspecteur · Cas à vigilance (P1/P2/P3) · Dossier d'audit (10 sections).
  • Automatisation — Audit de A à Z (12 étapes) + kit multi-dossiers PDF.
  • Traçabilité — modes 1 dossier / parcours Top N (tous détaillés) · page de garde référencée · empreinte SHA-256 vérifiable · fiche de traçabilité et bloc de signature · PDF unique A4 (un dossier par page) · lien reproductible.
  • Navigation uniforme — une seule barre pour les 10 outils (navbar.js, injectée automatiquement par i18n_en.js) : même identité, 8 liens principaux, menu « Autres outils » (14 liens), bascule FR | EN, bouton de thème déplacé (gestionnaires préservés), page active surlignée. Fin des en-têtes hétérogènes.
  • Résolution — chaque signal est accompagné de sa procédure de résolution (étapes, acteur, délai, pièce décisive, test de clôture, issues possibles et conduite à tenir) et des aides : simulateur d'enjeu, courrier de demande de pièces pré-rédigé, plan d'instruction exportable (CSV). Base bilingue partagée resolution.js (7 détecteurs + procédure générique).
  • Version anglaise — moteur i18n partagé (i18n_en.js, 1 000+ entrées) : une seule source par outil, deux langues. Bouton FR | EN en bas à gauche (choix mémorisé), ?lang=en sur n'importe quelle page, contenu dynamique et rapports traduits aussi (observateur DOM). Vérifié page par page.
  • Vue système — Fiscal Risk Graph (5 vues dont carte animée) + export PNG/PDF.
  • Enrichissements — ResourceProjects (paiements) · liaison entreprise ↔ pays ↔ flux (19 sociétés liées).
  • Documentation — Bibliothèque documentaire + directives d'exploitation + cette page.
  • Fond de carte — vraies frontières africaines (Natural Earth 110m, domaine public) embarquées dans la vue carte ; interrupteur Fond Afrique, liens partageables #mapflow / ?fond=off / ?theme=light.

8 · Reste à faire

  • UBO / bénéficiaires effectifs : nécessite OpenOwnership/BODS ou un registre national (licence/accès).
  • Licences minières & production : cadastres nationaux / registres EITI (accès officiel).
  • Douanes transactionnelles, AIS, données fiscales : accord institutionnel ou licence payante.
  • Liens profonds PDF : les sources bloquent le téléchargement → hébergement à convenir avec les fournisseurs.
  • Fond de carte enrichi : relief / ombrage, massifs miniers, bassins de production (données à sourcer).
Cette page est la documentation vivante du dispositif : elle décrit ce qui est réellement construit, sans promesse au-delà des sources connectées.

9 · Le processus officiel en six étapes — et où se situe le dispositif

La mesure des flux financiers illicites n'est pas un calcul isolé : c'est un processus institutionnel décrit par le cours IDEP/UNECA (module 3) et piloté par les Nations Unies sous l'indicateur SDG 16.4.1. Situer le dispositif dans ce processus est la meilleure façon de dire ce qu'il fait — et ce qu'il ne fait pas.

#Étape officielleCe dispositif
1Auto-évaluation du risque d'IFFfournit des signaux documentés (1 543 constats au relevé du 06/10/2026) — pas une évaluation nationale
2Cartographie des agences nationalesoutille la cartographie → Groupe technique
3Revue de disponibilité et de qualité des donnéescouvre 2 colonnes sur 6 (sources ouvertes, fréquence documentée) — l'accès aux micro-données appartient à l'administration
4Choix de la méthode (un secteur pilote d'abord)documente PCM+ et PFM+ ainsi que leurs conditions de faisabilité
5Plan de mesure (méthodes, acteurs, délais, coûts)génère le plan exportable en CSV → §6 de la page « Groupe technique »
6Compilation et diffusion de l'indicateurprépare la remontée 16.4.1 → les 8 règles, le gabarit, la checklist
Les six colonnes de la revue de données (étape 3), telles que le cours les énonce : variables · sources · fréquence et actualité · accès (« le point le plus critique ») · granularité et interopérabilité · durabilité et usage. Ce dispositif en couvre deux ; les quatre autres supposent un mandat national et un protocole de confidentialité.

10 · Les deux briques qui manquaient — et ce qu'elles changeront

La comparaison du dispositif aux méthodes officielles de l'UNCTAD laisse apparaître deux absences, et elles sont nommées dans le cours. Elles sont désormais documentées et outillées :

BriqueCe qu'elle adresse chez nousÉtat
PFM+ — Price Filter Method (méthode 2)les constats sans référentiel de prix : sur les 1 543 constats du relevé du 06/10/2026, 70,1 % (≈ 1 082) n'ont pas de prix de comparaison. La PFM+ juge le prix unitaire transaction par transaction et ne dépend pas des données du partenairemodule publié : les 7 gestes, la bande de prix, le calculateur (auto-testé), le sens du flux
Remontée SDG 16.4.1l'étape 6 du processus officiel : compiler, valider, diffuser. Le cours énonce huit règles de déclaration — dont l'obligation de séparer entrant et sortant, les sous-types et les méthodes, et de publier un point milieu avec des bornesmodule publié : les 8 règles, le gabarit en 5 feuilles, le générateur de métadonnées, la checklist de conformité
Groupe de travail techniquel'étape 2 (cartographie des agences) et l'étape 3 (revue de disponibilité), qui ne se font pas depuis un outil : il faut un mandat, une règle de confidentialité et un plan chiffrémodule publié : agences et sources, six colonnes, générateur de plan d'action exportable
Ce que ces briques ne remplacent pas. Ni la PFM+ ni la remontée ne s'activent sans l'administration : la première exige des micro-données douanières brutes et un prix central validé par des experts ; la seconde est un acte souverain de transmission. Ces pages disent donc à quelle condition elles deviennent utiles — c'est ce qui les rend crédibles.
Et une doctrine désormais adossée. Notre seuil de 20 % n'est plus un « défaut de réglage » : c'est le point milieu d'un triplet 15 / 20 / 25 — format prescrit par l'ONU et déclarable tel quel dans le gabarit. De même, le nom PCM+ n'est pas une marque maison : c'est celui de la méthode UNCTAD, repris jusque dans les publications de la Commission européenne.

11 · La conformité du moteur à la PCM+ — dix étapes, verdicts nommés

La question posée à ce dispositif est toujours la même : « votre écart miroir, c'est sérieux ? ». Le cours IDEP/UNECA (module 3) donne le mode opératoire officiel de la méthode de référence — la PCM+, Partner Country Method augmentée — en dix étapes. Le tableau ci-dessous le met en regard de ce que le moteur fait réellement, lacunes comprises : un dispositif qui publie ses écarts de conformité ne se fait plus contester sur sa méthode, il se fait contester sur ses données, ce qui est un progrès.

#Étape officielle de la PCM+Notre moteurVerdict
1Collecter les exportations déclarées (déclarant = A, partenaire = tous)Comtrade, déclarant = pays du dossierconforme à l'étape
2Collecter les importations miroir (déclarant = tous, partenaire = A)Comtrade, partenaire = pays du dossierconforme à l'étape
3Écart EX - IM (avec la réserve de la valorisation CIF/FOB des importations)écart en valeur et en pourcentage, seuil publiéconforme, réserve du point 4
4Ajuster les importations de CIF à FOB par une marge par partenaire et par produit (base OCDE/ITIC)non fait : forfait de 6 % testé sur 1 396 flux ; les constats d'écart miroir passent de 738 à 735 (-0,4 %)écart documenté
5Calculer l'asymétrie résiduelle (RA)effectué après compensations de périmètreconsigné ici même
6Vérifier le système de commerce déclaré des deux pays et ajusternon faitécart nommé
7Vérifier l'attribution du partenaire (réexportations) et ajusternon faitécart nommé
8Vérifier les autres ajustements (calendrier) et ajusternon faitécart nommé
9L'asymétrie résiduelle est l'IFFnous publions un écart au-delà d'un seuil de 20 %, choix d'outil — l'UNCTAD ne prescrit aucun taux uniquechoix assumé et publié
10Calculer les exportations sur- et sous-évaluées, IFF entrants et sortantssens de l'écart conservéconforme à l'étape
Ce que ce tableau dit, en une phrase : nous appliquons la méthode de référence, avec les étapes 4 et 6 à 8 en moins, et l'étape 9 remplacée par un seuil explicite. Le test CIF de 6 % montre que l'étape 4 ne coûte que 0,4 % des constats sur ce corpus — une information à publier, pas une faiblesse à cacher : elle dit que la conclusion des dossiers ne dépend pas de cet ajustement.
Le détail — méthode, seuils, réserves — est dans l'onglet module 3 de la page du cours IDEP (son §6), et l'état d'exécution des six décisions qui en découlent y est tenu à jour.