ATLAS × UNDP Carbon Registry - Complete Integration Documentation

🌍 Open Source Documentation pour l'intégration du Knowledge Graph ATLAS CORTEX-KG au registre carbone national UNDP

📋 Vue d'ensemble

Ce dépôt documente l'intégration Phase 1 POC du framework ATLAS Knowledge Graph au registre carbone national UNDP, tel que proposé dans le Pull Request #352.

Contexte : Le PR #352 est ouvert depuis le 24 janvier 2026 sur le dépôt officiel UNDP. En attendant la revue et l'intégration par les mainteneurs, cette documentation open source préserve et partage le travail accompli.

🎯 Objectif de l'intégration

Automatiser le lien entre projets carbone et Objectifs de Développement Durable (ODD/SDG) via le Knowledge Graph ATLAS CORTEX-KG pour :

• ✅ Améliorer la transparence des crédits carbone
• ✅ Aligner automatiquement les projets sur les ODD de l'Agenda 2030
• ✅ Valider constitutionnellement via le protocole Quantum Eraser
• ✅ Renforcer la souveraineté des données climat pour les pays du Sud

📊 Statistiques du PR #352

Métrique	Valeur
Fichiers modifiés	1 216 fichiers
Lignes ajoutées	+6 825
Lignes supprimées	-1
Commits	11 commits
Auteur	@aguennoune
Statut	🟡 Open (en attente de revue)
Date de création	24 janvier 2026

📚 Contenu du dépôt

atlas-undp-complete/
├── README.md                           # Ce fichier - Vue d'ensemble
├── AWESOME_UNDP_ATLAS.md              # Liste curatée des ressources ATLAS × UNDP
├── docs/
│   ├── SYNTHESIS.md                   # Synthèse complète de l'analyse
│   ├── ARCHITECTURE.md                # Diagrammes et architecture technique
│   ├── API_REFERENCE.md               # Documentation des APIs
│   ├── DEPLOYMENT_GUIDE.md            # Guide de déploiement
│   └── ROADMAP.md                     # Feuille de route 2026-2027
├── analysis/
│   ├── PR_352_ANALYSIS.md             # Analyse détaillée du PR #352
│   └── KHC_CLI_CURATION.md            # Résultats de la curation khc-cli
└── LICENSE                            # AGPL-3.0

🚀 Démarrage rapide

Consulter la documentation

# Cloner ce dépôt
git clone https://github.com/aguennoune/atlas-undp-complete.git
cd atlas-undp-complete

# Lire la liste awesome
cat AWESOME_UNDP_ATLAS.md

# Consulter la synthèse
cat docs/SYNTHESIS.md

Référence au PR original

• PR #352 : undp/undp-national-carbon-registry#352
• Branche d'intégration : feature/atlas-integration
• Dépôt UNDP officiel : https://github.com/undp/undp-national-carbon-registry

🔍 Points clés de l'intégration

Phase 1 : Knowledge Graph ODD Linker ✅ COMPLÉTÉ

Livrables techniques :

• ✅ Bibliothèque TypeScript @atlas-undp/kg (libs/atlas-kg/)
• ✅ Service NestJS + contrôleur + tests (couverture >80%)
• ✅ Migration PostgreSQL (colonnes JSONB : odd_links, kg_relations)
• ✅ API REST : 3 endpoints (/link-project, /validate-odds, /health)
• ✅ Mode fallback (ODD 13.1 par défaut si KG indisponible)

Métriques de succès :

Métrique	Objectif	Statut
Couverture ODD	100%	🟡 À valider
Temps réponse	<200ms	🟡 À tester
Précision	>85%	🟡 À mesurer
Couverture tests	>80%	✅ 80%+

Architecture d'intégration

┌─────────────────────────────────────────┐
│   Projet UNDP (Carbon Registry)        │
│   NestJS Backend + React Frontend      │
└──────────────┬──────────────────────────┘
               │ POST /api/atlas/kg/link-project/:id
               ▼
┌─────────────────────────────────────────┐
│   @atlas-undp/kg Integration Layer      │
│   TypeScript Service + HTTP Client     │
└──────────────┬──────────────────────────┘
               │ HTTP Request
               ▼
┌─────────────────────────────────────────┐
│   ATLAS CORTEX-KG API v4.11.0          │
│   Knowledge Graph (17 ODD nodes)       │
└──────────────┬──────────────────────────┘
               │ ODD Mapping JSON
               ▼
┌─────────────────────────────────────────┐
│   PostgreSQL (odd_links JSONB)         │
│   Immutable ledger AWS QLDB            │
└──────────────┬──────────────────────────┘
               │ Visualize
               ▼
┌─────────────────────────────────────────┐
│   React Dashboard (ODD Graph)          │
└─────────────────────────────────────────┘

📖 Documentation complète

Awesome List

➡️ AWESOME_UNDP_ATLAS.md - Liste curatée de toutes les ressources, outils, APIs, et projets connexes

Analyses détaillées

• SYNTHESIS.md - Synthèse complète de l'intégration ATLAS × UNDP
• PR_352_ANALYSIS.md - Analyse ligne par ligne du Pull Request
• KHC_CLI_CURATION.md - Résultats de validation avec khc-cli

Guides techniques

• ARCHITECTURE.md - Diagrammes Mermaid et spécifications techniques
• API_REFERENCE.md - Documentation complète des endpoints REST
• DEPLOYMENT_GUIDE.md - Instructions de déploiement (Docker, Kubernetes, AWS)

Roadmap

• ROADMAP.md - Feuille de route 2026-2027 (Phases 2-4)

🤝 Contribution

Ce dépôt documente un travail open source proposé à la communauté UNDP. Les contributions sont les bienvenues pour :

• 📝 Améliorer la documentation
• 🐛 Signaler des incohérences
• 🌍 Traduire en d'autres langues (Arabe, Espagnol, etc.)
• 💡 Proposer des améliorations techniques
• ⭐ Partager et promouvoir le projet

Comment contribuer

1. Fork ce dépôt
2. Créez une branche : git checkout -b feature/ma-contribution
3. Commitez vos changements : git commit -m "docs: amélioration XYZ"
4. Poussez vers la branche : git push origin feature/ma-contribution
5. Ouvrez une Pull Request

👥 Maintainers

Lead Architect - ATLAS Integration

Abderrahim Guennoune

• GitHub: @aguennoune
• Email: aguennoune@outlook.com
• Rôle: Architecte Principal - Intégration ATLAS × UNDP Carbon Registry
• Co-Authoring: Anthropic Claude (Regenerative AI Co-Authoring)

📜 Licence

Ce projet est sous licence AGPL-3.0 - voir le fichier LICENSE pour plus de détails.

Cette licence garantit :

• ✅ Liberté d'utilisation, modification et distribution
• ✅ Code source ouvert pour toute dérivation
• ✅ Protection contre l'appropriation propriétaire
• ✅ Obligation de partage des améliorations

🔗 Liens utiles

Projets officiels

• UNDP Carbon Registry : https://github.com/undp/undp-national-carbon-registry
• UNDP Climate Promise : https://www.undp.org/climate-promise
• PR #352 : undp/undp-national-carbon-registry#352

Outils utilisés pour l'analyse

• khc-cli : https://github.com/aguennoune/khc-cli
• BioContinuum ATLAS : https://github.com/aguennoune/atlas-system (framework source)

Ressources connexes

• CAD Trust : https://github.com/cadtrust (Linux Foundation)
• Climate Warehouse : https://github.com/Chia-Network/climate-warehouse
• Article 6 Paris Agreement : https://unfccc.int/process-and-meetings/the-paris-agreement/article-6

🌍 Impact visé

Pilote Maroc (Phase 1)

• 50 projets d'agroforesterie (coopératives arganiers)
• 60 000 tCO2e séquestrés sur 10 ans
• 100% des projets liés automatiquement aux ODD 13, 15
• 1,2M $ de revenus carbone pour les coopératives locales

Vision 2027

• 100+ pays utilisant le registre UNDP enrichi par ATLAS
• Marché décentralisé de crédits carbone souverains
• Justice climatique : Priorité aux pays du Sud et communautés autochtones

---

Dernière mise à jour : 24 janvier 2026
Version : 1.0.0
Statut : 📖 Documentation complète disponible

🌍 Construire une infrastructure climatique souveraine pour un avenir durable