v0.0.3-pre.001

docs/architecture/001-PROJECT_OBJECTIVES.md

@@ -0,0 +1,68 @@
+<!-- file: docs/architecture/001-PROJECT_OBJECTIVES.md -->
+<!-- version: 1 -->
+
+# Objectifs de Khadhroony Solana Project
+
+## Positionnement
+
+Khadhroony Solana Project est un umbrella project consacré à la blockchain Solana.
+
+Sa fonction n'est pas de construire une seule application monolithique, mais de fournir des bibliothèques KSP cohérentes, réutilisables, interconnectables et, lorsque leur contrat le permet, utilisables indépendamment.
+
+## Capacités générales visées
+
+KSP doit progressivement fournir des capacités permettant notamment de :
+
+- représenter les primitives et contrats KSP/Solana communs ;
+- posséder les interfaces wire nécessaires aux programmes on-chain pris en charge ;
+- acquérir des données Solana en temps réel ou historiquement ;
+- décoder transactions, instructions, comptes, événements et autres formats pertinents ;
+- construire des opérations compatibles avec les programmes supportés ;
+- signer, simuler, soumettre et suivre des opérations lorsque les frontières correspondantes auront été définies ;
+- gérer les wallets et signers nécessaires aux usages KSP ;
+- matérialiser les données décodées vers des faits canoniques ;
+- stocker, rejouer, reconstruire et interroger les données ;
+- composer ces capacités dans des applications, workers et demos spécialisés.
+
+## Objectif court terme
+
+L'objectif produit prioritaire est une application de trading Solana monoposte.
+
+Cette priorité ne transforme pas les bibliothèques fondamentales en bibliothèques spécifiques au trading. Les données, interfaces, transports, décodages et modèles généraux doivent rester réutilisables par les autres produits KSP.
+
+## Objectifs moyen et long terme
+
+KSP doit permettre de construire notamment :
+
+### Explorer Solana
+
+Une application générale comparable dans son domaine à `explorer.solana.com` ou Solscan, capable d'exploiter les données et contrats KSP sans créer une seconde pile de décodage/stockage.
+
+### Explorer et analyse DEX
+
+Une application comparable dans son principe à DexScreener, avec une couverture plus complète des DEX et des modèles de marché Solana lorsque les données KSP le permettent.
+
+## Non-objectifs architecturaux
+
+KSP ne doit pas :
+
+- devenir un monolithe centré sur une seule application ;
+- dupliquer la même connaissance Solana dans plusieurs produits ;
+- transformer les applications/demos en propriétaires de logique bas niveau ou protocolaire ;
+- utiliser automatiquement une crate externe de protocole simplement parce qu'elle fournit les structures wire nécessaires ;
+- forcer chaque application à dépendre de toutes les couches KSP ;
+- créer des bibliothèques spécifiques à un produit lorsque la responsabilité est générale à Solana ou à KSP.
+
+## Conséquence structurante
+
+Les produits finaux doivent partager les mêmes bibliothèques fondamentales :
+
+```text
+bibliothèques KSP
+    ├── application de trading
+    ├── explorer Solana
+    ├── explorer/analyse DEX
+    └── autres applications spécialisées
+```
+
+La première utilisation d'une capacité dans un produit ne détermine donc pas automatiquement son propriétaire architectural.