khadhroony-solana-project/docs/architecture/000-README.md

Architecture KSP

Ce répertoire contient les documents d'architecture et de périmètre durable de Khadhroony Solana Project.

Les documents d'architecture distinguent explicitement :

• les décisions déjà retenues ;
• les directions fortes encore à valider par l'implémentation ;
• les hypothèses de travail ;
• les questions ouvertes ;
• les conséquences attendues sur les futurs composants.

Ils ne remplacent ni ROADMAP.md, ni les plans de version, ni les deltas.

Ordre initial

1. 001-PROJECT_OBJECTIVES.md — finalité, objectifs produits et non-objectifs architecturaux ;
2. 002-LAYERS_AND_DEPENDENCIES.md — couches conceptuelles, sens des dépendances et responsabilités des exécutables ;
3. 003-COMPONENT_CONTRACTS.md — frontières initiales des composants structurants et contrats déjà acquis ;
4. 004-COMPONENT_INVENTORY.md — inventaire courant des domaines, APIs, bibliothèques, workers, jobs, scénarios et applications candidates ;
5. 005-DEPENDENCY_GRAPH.md — graphe de dépendances retenu, dépendances interdites et frontières de conversion/composition ;
6. 006-WIRE_AND_PROGRAM.md — propriété des contrats wire, politique de dépendances codecs/interfaces, API Program ouverte, preparation d'exécution et extensibilité externe ;
7. 007-EXECUTION_AND_POLICY.md — policy multi-checkpoints, orchestration transactionnelle, wallet/transport, retry, approval externe et résultat d'exécution.

004-COMPONENT_INVENTORY.md et 005-DEPENDENCY_GRAPH.md sont maintenus ensemble : une évolution du graphe qui change le propriétaire d'une responsabilité doit corriger l'inventaire au lieu de laisser deux descriptions contradictoires.