52 lines
3.7 KiB
Markdown
52 lines
3.7 KiB
Markdown
<!-- file: docs/architecture/CRATE_MAP.md -->
|
||
<!-- version: 1 -->
|
||
|
||
# Carte des crates
|
||
|
||
## 1. Inventaire
|
||
|
||
| Crate | Type | Responsabilité principale | État documentaire |
|
||
|------------------------------|------------------------|--------------------------------------------------------------------|------------------------------------|
|
||
| `kb-core` | bibliothèque | erreurs, résultat et identité de module partagés | contrat par crate à créer |
|
||
| `kb-config` | bibliothèque | configuration JSON, environnement, validation et profils | contrat par crate à créer |
|
||
| `kb-lib` | bibliothèque | modèles, décodeurs, exécuteurs et matérialisateurs consolidés | contrat par crate à créer |
|
||
| `kb-logging` | bibliothèque | initialisation du logging et du tracing | contrat par crate à créer |
|
||
| `kb-program-ids` | bibliothèque | registre des programmes et comptes Solana connus | contrat par crate à créer |
|
||
| `kb-pipeline` | bibliothèque | backfill, extraction, replay, stateful, préflight et orchestration | contrat par crate à créer |
|
||
| `kb-pipeline-demo-scenarios` | bibliothèque + binaire | scénarios Devnet réutilisables et CLI | contrat par crate à créer |
|
||
| `kb-onchain-transport` | bibliothèque | transports RPC HTTP/WebSocket et pools d’endpoints | contrat par crate à créer |
|
||
| `kb-store` | bibliothèque | contrats de stockage et adaptateur PostgreSQL | contrat par crate à créer |
|
||
| `kb-wallet` | bibliothèque | wallet temporaire et frontière de signataire | ébauche à documenter explicitement |
|
||
| `kb-app-demo-desktop` | bibliothèque + binaire | application de démonstration Tauri | contrat par crate à créer |
|
||
|
||
## 2. Consolidations principales depuis bot2
|
||
|
||
La migration a regroupé de nombreuses anciennes crates dans des frontières plus larges :
|
||
|
||
- les modèles et APIs de décodage, matérialisation et exécution ont rejoint `kb-lib` ;
|
||
- les implémentations de stockage core et PostgreSQL ont rejoint `kb-store` ;
|
||
- les responsabilités de pipeline ont été réunies dans `kb-pipeline` ;
|
||
- les transports Solana sont réunis dans `kb-onchain-transport` ;
|
||
- l’application et sa bibliothèque sont réunies dans `kb-app-demo-desktop` ;
|
||
- les scénarios réutilisables ont été extraits dans `kb-pipeline-demo-scenarios`.
|
||
|
||
Cette carte n’est pas une table de compatibilité exhaustive des anciennes crates. Les correspondances historiques détaillées seront synthétisées dans la documentation de migration et l’audit d’alignement.
|
||
|
||
## 3. Crates mixtes
|
||
|
||
### 3.1 `kb-pipeline-demo-scenarios`
|
||
|
||
- bibliothèque Rust : `kb_pipeline_demo_scenarios` ;
|
||
- binaire : `kb-pipeline-demo-scenarios-cli` ;
|
||
- `autobins = false` évite une cible implicite concurrente.
|
||
|
||
### 3.2 `kb-app-demo-desktop`
|
||
|
||
- bibliothèque Rust : `kb_app_demo_desktop_lib` ;
|
||
- binaire : `kb-app-demo-desktop` ;
|
||
- le package reste volontairement unique.
|
||
|
||
## 4. Relations documentaires
|
||
|
||
Chaque crate devra disposer de `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`. Les documents transversaux présents dans `docs/architecture/` évitent de répéter l’architecture complète dans chaque README.
|