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 ;
8. 008-DATA_MATERIALIZATION_AND_STORE.md — niveaux durables D1–D4, Materialization, Store PostgreSQL de référence, provenance, idempotence, replay et notifications de données persistées ;
9. 009-ACQUISITION_WORKERS_AND_JOBS.md — pipelines spécialisés, workers live, jobs de backfill/replay, backlog, claim/lease, reprise, concurrence et mécanisme de notification de référence ;
10. 010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md — apps spécialisées, workers autonomes et need-driven, control plane, scenarios réutilisables, demos desktop et frontières IPC/orchestration.
11. 011-RAW_TRANSACTION_ACQUISITION.md — taxonomie durable d'acquisition RawTransaction, audits datés des voies Solana/providers, convergence Store et handoff Worker/Backfill.

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.