← Observatoire des MinesInitiatives AfricaPartenaire EPC Mineex
Initiatives AfricaMines · Architecture
Pièce 02 · Dossier d'architecture · 31 juillet 2026

Comment l'observatoire est construit, couche par couche

Ce dossier est le document de référence de l'ouvrage. Il fixe l'arborescence, les gabarits, le modèle de données, les formules des deux indices et la chaîne de production. Rien ne sera publié qui n'entre pas dans une structure décrite ici — c'est la seule garantie que 54 pays et 24 substances resteront comparables entre eux dans trois ans.

N1Surface

Ce que le visiteur voit

Accueil, fiches pays, fiches substances, observatoires spécialisés, corridors. Pages statiques, sourcées, exportables.

HTMLSourcéExportable
N2Outils

Ce que le visiteur manipule

Vingt outils qui ne consomment que des données publiées. Un outil ne peut pas afficher ce qu'une page n'affiche pas.

SimulateursComparateursCartes
N3Indices

Ce que l'observatoire calcule

IAVM et IGRS. Fonctions pures des observations vérifiées. Recalculables par un tiers à partir des sources citées.

IAVMIGRSMéthode publiée
N4Données

Le socle

Une table pivot observation, onze tables au total, trois statuts, un journal des révisions. Aucune valeur sans source ni date.

11 tables3 statutsJournal
N5Collecte

Le répertoire interne

Outils de moisson et de rapprochement. Jamais publié, protégé par authentification. Seul le statut « vérifié » remonte en surface.

/interne/Non publiable
N6Sources

Le socle rocheux

Quatre rangs, du cadastre national à la presse spécialisée. Le rang détermine ce que la source a le droit d'établir.

Rang 1 à 4Règle de conflit
01 — Destinataires

Cinq publics, cinq usages

Chaque page doit être utile à au moins deux d'entre eux, sinon elle ne se justifie pas. Le test est appliqué à la conception, pas après.

Public 01

États et administrations

Ministères des Mines, directions du Trésor, agences de promotion des investissements, parlementaires en commission budgétaire. Ce qu'ils y cherchent : se comparer à un voisin sur un régime fiscal, chiffrer une obligation de transformation locale, préparer une renégociation.

Public 02

Investisseurs et industriels

Majors, juniors, fonds, industriels aval cherchant une sécurisation d'approvisionnement. Ce qu'ils y cherchent : la stabilité d'un cadre, l'état d'un corridor, la capacité énergétique disponible, le pipeline de projets par stade réel.

Public 03

Banques et bailleurs

BAD, institutions de financement du développement, banques commerciales africaines. Ce qu'ils y cherchent : un dossier de crédit documenté, l'exposition d'un pays à une substance, la solidité d'un fonds de générations futures.

Public 04

Sociétés civiles et médias

Coalitions de transparence, ITIE nationales, rédactions économiques. Ce qu'ils y cherchent : l'écart déclaratif, la traçabilité d'une recette, l'état d'un contentieux, une donnée opposable.

Public 05

Recherche et formation

Universités, écoles des mines, centres de recherche. Ce qu'ils y cherchent : des séries longues, une méthode reproductible, une API. C'est le public qui valide la rigueur de l'ensemble.

Test de conception

La règle des deux publics

Une page qui ne sert qu'un seul public est soit un document interne, soit une plaquette. Dans les deux cas, elle ne rentre pas dans l'observatoire. Ce test a déjà écarté trois modules envisagés au cadrage : annuaire de contacts, agenda des conférences, revue de presse.

02 — Arborescence

Où chaque fichier se range

Codes pays en ISO3 minuscules, slugs de substances en français sans accent ni espace. Les liens internes sont relatifs et réécrits selon la profondeur au moment de la mise en archive.

/observatoire-mines-ressources-strategiques/
├── index.html                          accueil — 45 indicateurs, barres de valeur captée
├── architecture.html                   ce dossier
│
├── pays/                               54 fiches · gabarit 10 onglets
│   ├── cod.html  civ.html  gin.html  gha.html  zaf.html
│   ├── zmb.html  mar.html  zwe.html  mli.html  ner.html   ← 10 pilotes phase 1
│   └── … 44 fiches phase 2
│
├── substances/                         24 fiches · gabarit 10 blocs
│   ├── or.html  cuivre.html  cobalt.html  lithium.html
│   ├── bauxite-alumine.html  fer.html  uranium.html  phosphates.html
│   └── … 16 autres
│
├── societes/                           fiches groupes et juniors
│   ├── index.html                        table de contrôle capitalistique
│   └── cmoc.html  glencore.html  ivanhoe.html  ocp.html  …
│
├── observatoires/                      16 bases thématiques
│   ├── cobalt-batteries.html             phase 1
│   ├── or-flux-illicites.html            phase 1
│   ├── corridors-logistique.html         phase 1
│   └── … 13 en phase 2
│
├── corridors/
│   ├── lobito.html  tazara.html  transguineen.html  nacala.html  walvis-bay.html
│
├── regions/                            8 tableaux de bord régionaux
│   └── uemoa.html  cedeao.html  cemac.html  sadc.html  eac.html
│       comesa.html  uma.html  zlecaf.html
│
├── outils/                             20 outils
│   └── simulateur-recettes.html  comparateur-codes.html  valeur-perdue.html  …
│
├── donnees/                            JSON servis aux pages et aux outils
│   ├── observations.json  pays.json  substances.json  societes.json
│   ├── sources.json  indices.json
│   └── geo/  GeoJSON — frontières, permis, corridors
│
├── styles/  polices/  images/
│
└── interne/                            NE JAMAIS TÉLÉVERSER SANS AUTHENTIFICATION
    ├── collecte-ecart-or.html            outil de moisson douanière
    ├── collecte-cadastres.html           outil de moisson des cadastres
    └── LISEZ-MOI.txt                     données non vérifiées — non publiables

Contrôle bloquant avant toute expédition

Le pied de page de toute production de la plateforme est © 2026 Initiatives Africa · initiativesafrica.com, sans exception et sans mention d'une autre entité. La vérification est mécanique et placée en tête du script de déploiement : grep -rn "Num""érium" --include="*.html" . | grep -v "<code>" && echo BLOQUÉ || echo OK. Le second filtre écarte les pages de documentation qui citent la commande elle-même : sans lui, ce dossier déclencherait son propre contrôle. Le répertoire /interne/ est exclu de l'archive de publication ou protégé par auth_basic.

03 — Gabarits

Trois formes, une seule discipline

Les onglets sont identiques d'une fiche à l'autre, y compris lorsqu'un onglet est vide. Un onglet vide porte la mention de son chantier ouvert ; il ne disparaît pas, sinon la comparaison entre pays devient impossible.

Gabarit A

Fiche pays — 10 onglets

  1. PanoramaSix statistiques hero, drapeau en médaillon, hero aux couleurs nationales
  2. Géologie et potentielFormations, couverture des levés, part du territoire cartographiée
  3. Histoire minièreCycles, ouvertures, fermetures, ruptures de régime
  4. Cadre juridique et fiscalCode en vigueur et date, révisions, stabilisation, participations d'État
  5. Cadastre, permis et titulairesAccessibilité, nombre de titres, superficies
  6. Mines en productionUne entrée par mine : opérateur, capital, substance, capacité, statut
  7. Artisanat et petite mineEstimation en fourchette, cadre de formalisation, sites
  8. Transformation et contenu localCapacités installées, obligations légales, exécution constatée
  9. Recettes et redistributionRedevances, ITIE, part du budget, fonds dédiés, contentieux
  10. Indices et sourcesScore IAVM détaillé pilier par pilier, IGRS, bibliographie complète
Gabarit B

Fiche substance — 10 blocs

  1. Barre de valeur captéeCinq maillons, part africaine, point de rupture
  2. RéservesAfricaines et mondiales, avec distinction prouvé / mesuré / annoncé
  3. Producteurs africains classésVolumes, part mondiale, évolution
  4. Prix et formation du prixPlace de cotation, indice de référence, décote africaine mesurée
  5. Demande finaleTechnologies, substitution, élasticité
  6. Capacités de raffinage sur le continentInstallées, en construction, annoncées — trois colonnes
  7. Contrôle capitalistiquePar nationalité d'actionnaire, en part de production
  8. Politiques d'interdiction d'export brutPays, date, périmètre, exécution réelle
  9. Recyclage et matière secondaireGisement urbain, filières existantes
  10. Risques et scénariosPubliés comme scénarios, jamais comme prévisions
Gabarit C

Fiche société — 8 blocs

Identité et pavillon du capital · Actifs africains, mine par mine, avec quote-part · Production consolidée sur le continent · Participations d'État dans chaque véhicule · Engagements de contenu local et exécution constatée · Contentieux, arbitrages, sanctions · Chaîne aval : où part le concentré et qui le raffine · Sources, toutes de rang 3 sauf mention contraire.

Règle de retenue. Les fiches sociétés ne portent aucune donnée sur des personnes physiques — pas de dirigeants nommés, pas de coordonnées, pas d'actionnaires individuels. C'est une règle de la plateforme, pas une prudence de circonstance : l'observatoire documente des flux et des institutions.

04 — Modèle de données

Onze tables, une table pivot

Tout chiffre affiché sur le site est une ligne de observation. Il n'existe aucune valeur codée en dur dans une page. C'est ce qui rend l'observatoire recalculable et auditable.

TableRôleCléChamps déterminants
observationPivot. Une ligne = un chiffre, un pays, une substance, une année, une sourceidpays_iso3, substance_slug, indicateur_code, valeur, unite, annee, source_id, statut, date_collecte
paysRéférentiel des 54iso3nom_fr, nom_en, region_ua, enclave (booléen), monnaie
substanceRéférentiel des 24slugnom_fr, famille, unite_par_defaut, maillons_chaine
indicateurDictionnaire des 45+ indicateurscodelibelle, famille, unite, sens (haut/bas = mieux), formule si dérivé
sourceRegistre des sourcesidnom, rang (1-4), url, date_publication, millesime_donnee, langue
mineSites en production ou en développementidnom, pays_iso3, substances[], operateur_id, capacite, statut_operationnel
societeOpérateurs et actionnaires personnes moralesidnom, pavillon_capital, cotation, mines[]
regimeCadres juridiques et fiscauxidpays_iso3, texte_reference, date_entree_vigueur, redevance, part_etat, stabilisation
corridorInfrastructures d'évacuationidnom, pays_traverses[], longueur, capacite, statut, port_terminal
contentieuxArbitrages, nationalisations, litiges fiscauxidpays_iso3, parties_morales, instance, objet, montant, statut, dates
revisionJournal. Toute modification d'une observationidobservation_id, valeur_avant, valeur_apres, motif, source_nouvelle, horodatage

Les trois statuts

À collecter

La cellule est identifiée, l'indicateur est défini, la donnée n'existe pas encore chez nous. Elle s'affiche publiquement comme telle. C'est une déclaration de chantier, pas un aveu de faiblesse.

À confirmer

Une valeur existe mais repose sur une seule source, ou sur une source de rang 4 seule, ou deux sources divergent. Visible en interne, jamais chiffrée en page publique.

Vérifié

Source de rang 1 à 3 identifiée, datée, millésimée. Seul statut qui alimente les pages publiques, les outils et le calcul des indices.

Règle de conflit entre sources

Lorsque deux sources recevables divergent, les deux valeurs sont conservées et publiées côte à côte, l'écart est signalé en clair, et l'arbitrage est différé et documenté dans le journal des révisions. Aucune moyenne n'est calculée pour faire disparaître un désaccord. Le cas d'école déjà rencontré au cadrage : la restitution d'uranium annoncée par Niamey, rapportée à 95 000 tonnes par les dépêches anglophones et à 95 tonnes par une source francophone — trois ordres de grandeur d'écart, publiés tels quels avec mention de l'incertitude.

05 — Formules

IAVM et IGRS, calculables par un tiers

Un indice dont on ne peut pas refaire le calcul soi-même n'est pas un indice, c'est une opinion assortie d'un chiffre. Les deux formules ci-dessous sont donc publiées avant la première édition chiffrée, et non après.

IAVM — Indice africain de valorisation minière

IAVM(pays) = ( Σ Pi ) / n × 100 avec i = 1…10, Pi ∈ [0,1] Pi = centile continental de la valeur brute du pilier i, calculé sur les seuls pays notés n = nombre de piliers renseignés pour le pays Condition de notation n ≥ 8 → sinon : « non noté », jamais estimé Neutralisation pilier 07 « connexion logistique » recalculé sur la sous-population des 16 pays enclavés Bandes Champion ≥ 70 · Leader 55-69 · En transition 40-54 · Émergent < 40

Le choix du centile plutôt que d'une note absolue est délibéré : il mesure la position d'un pays parmi ses pairs africains, pas sa distance à un optimum théorique fixé ailleurs. Un pays ne perd donc pas de points parce que le continent entier transforme peu ; il en perd s'il transforme moins que ses voisins comparables. L'étalon haut de l'échelle est posé par la chaîne phosphatière marocaine, tenue jusqu'à l'engrais fini.

IGRS — Indice de gouvernance des ressources stratégiques

IGRS(pays) = Σ Cj avec j = 1…6, Cj ∈ {0, 1, 2} 0 = absent 1 = existant mais partiel ou non tenu à jour 2 = complet et à jour C1 Cadastre minier consultable en ligne C2 Publication effective des contrats et avenants C3 Statut ITIE et régularité des rapports C4 Registre des bénéficiaires effectifs C5 Traçabilité des recettes jusqu'au budget de l'État C6 Existence et audit d'un fonds dédié Échelle 0 à 12 — publiée en valeur brute, jamais convertie sur 100 Preuve chaque composante porte l'URL et la date de la vérification Contrôle toute composante doit être revérifiable en moins d'une heure par un tiers

Pourquoi l'IGRS n'est pas ramené sur 100

Une note sur 100 suggère une précision que six composantes ne portent pas. L'échelle brute de 0 à 12 dit exactement ce qu'elle mesure : six portes ouvertes, entrouvertes ou fermées. Les deux indices ne sont jamais additionnés ni combinés en score unique : valoriser et gouverner sont deux performances distinctes, et un pays peut être excellent sur l'une et défaillant sur l'autre. C'est précisément ce que le lecteur doit pouvoir voir.

06 — Socle technique

Deux temps, une seule contrainte de charge

La contrainte de tête n'est pas la richesse fonctionnelle : c'est qu'une fiche pays s'ouvre en moins de 1,5 seconde sur un réseau 3G à Kinshasa ou à Conakry. Toute fonctionnalité qui menace ce seuil est repoussée.

Temps 1 — phases 1 et 2

Statique

HTML autonome par page, données en JSON servis depuis /donnees/, cartographie Leaflet avec fonds GeoJSON locaux. Aucune base de données en production, aucune dépendance serveur au-delà de nginx. Compression gzip et brotli, cache HTML à 1 800 s, polices à un an.

Cible : moins de 400 Ko par page, moins de 1,5 s de premier affichage en 3G, fonctionnement intégral sans JavaScript pour le contenu textuel et les tables.

Temps 2 — phase 3

Dynamique

Next.js en rendu statique incrémental, PostgreSQL avec PostGIS pour les couches cadastrales et les corridors, API publique documentée exposant les seules observations en statut vérifié.

Condition de bascule : le passage n'a lieu que lorsque le volume d'observations rend la maintenance manuelle des JSON plus coûteuse que l'exploitation d'une base — pas avant, et pas pour des raisons d'affichage.

Accessibilité, posée comme plancher

Contraste conforme sur les deux thèmes, focus clavier visible, mouvement respectant prefers-reduced-motion, tables lisibles au lecteur d'écran avec en-têtes déclarés, hiérarchie de titres continue. Ces points ne sont pas une phase : ils font partie de la définition de « livré ».

07 — Charte éditoriale

Neuf règles, opposables à nous-mêmes

Elles ont valeur de contrainte de production. Un texte qui en enfreint une ne part pas en ligne, quel que soit son intérêt.

  1. Source, date, millésimeTrois éléments, pas deux. La date de publication n'est pas le millésime de la donnée.
  2. Aucune personne physiqueNi dirigeants, ni coordonnées, ni actionnaires individuels. On documente des institutions.
  3. Trois statuts, un seul publié« Vérifié » seul alimente les pages, les outils et les indices.
  4. Annoncé n'est pas installéUn projet annoncé n'entre jamais dans une capacité. Trois colonnes distinctes.
  5. Toute conversion porte son tauxTaux et date de conversion affichés à côté du montant converti.
  6. L'artisanat en fourchetteJamais de point unique sur une production non déclarée.
  7. Les versions divergentes coexistentPosition officielle et contestation publiées ensemble, sans arbitrage.
  8. Pas de classement sans méthodeLa formule précède le palmarès, jamais l'inverse.
  9. Pas de page sans ses sourcesLa bibliographie est un bloc obligatoire du gabarit.

Neutralité géopolitique, posée comme règle et non comme précaution

Les positions américaine, européenne, chinoise, des pays du Golfe et des États africains concernés sont exposées côte à côte, avec leurs sources respectives. L'observatoire ne qualifie pas un partenariat de « prédateur » ni de « gagnant-gagnant » : il publie les termes, les montants, les contreparties et les contestations juridiques quand elles existent. Le lecteur arbitre.

08 — Chaîne de production

Une semaine type

Le rythme est hebdomadaire pour l'actualité et trimestriel pour les séries. Les rapports institutionnels ont leur calendrier propre : bulletins statistiques miniers en janvier, rapports ITIE à dates variables, publications d'exploration en mars.

Lundi

Moisson

Régulateurs, cellules statistiques, publications de sociétés. Extraction vers le répertoire interne, statut « à confirmer ».

Mardi

Rapprochement

Croisement des sources, détection des divergences, passage en statut « vérifié » ou signalement de l'écart.

Mercredi

Écriture

Mise à jour des fiches concernées, rédaction des blocs d'analyse, mise à jour du fil des faits datés.

Jeudi

Contrôle

Relecture des sources citées, vérification du pied de page, test de charge, contrôle d'accessibilité.

Vendredi

Publication

Mise en ligne, journal des révisions renseigné, exclusion vérifiée du répertoire interne.

Le contrôle du jeudi, dans l'ordre

1. Le contrôle d'entité (section 02) doit revenir OK. 2. Aucun nom de personne physique dans les fichiers publiés. 3. Chaque nouveau chiffre porte source, date et millésime. 4. Le répertoire /interne/ est absent de l'archive ou protégé. 5. Aucun lien interne cassé après réécriture des chemins relatifs. 6. Pages sous 400 Ko. Un seul échec bloque la publication du vendredi.

09 — Modèle économique

Ce qui reste gratuit, ce qui ne l'est pas

Le principe est celui déjà retenu pour les autres observatoires de la plateforme : la donnée publique reste publique, l'outillage et l'antériorité se financent.

Ouvert

Accès libre

Les 54 fiches pays, les 24 fiches substances, le tableau de bord continental, les observatoires spécialisés et l'intégralité des sources citées. Aucune donnée vérifiée n'est mise derrière un mur.

Abonnement

Séries et outils

Séries longues exportables, comparateurs multi-pays, alertes réglementaires, accès API, générateur de fiches projet au format bailleur, exports Excel structurés.

Adossement

Sponsors fondateurs

Le programme des Sponsors fondateurs et le Club des Bâtisseurs financent la phase 1, comme pour l'Observatoire de l'Environnement et du Climat. La contrepartie est une visibilité institutionnelle, jamais une influence éditoriale — règle écrite dans la charte.

Ligne de séparation

Un sponsor ne peut jamais : figurer dans un classement autrement que par ses chiffres vérifiés, obtenir le retrait d'une donnée sourcée, ni relire un contenu avant publication. Cette ligne est publiée sur le site, précisément parce qu'elle sera testée.