Files
khadhroony-bot3/docs/architecture/CRATE_MAP.md

3.7 KiB
Raw Blame History

Carte des crates

1. Inventaire

Crate Type Responsabilité principale État documentaire
kb-core bibliothèque erreurs, résultat et identité de module partagés README/TODO/USAGE/CHANGELOG présents
kb-config bibliothèque configuration JSON, environnement, validation et profils documentée ; restructuration en 0.5.1
kb-lib bibliothèque modèles, décodeurs, exécuteurs et matérialisateurs consolidés README/TODO/USAGE/CHANGELOG présents
kb-logging bibliothèque initialisation du logging et du tracing README/TODO/USAGE/CHANGELOG présents
kb-program-ids bibliothèque registre des programmes et comptes Solana connus README/TODO/USAGE/CHANGELOG présents
kb-pipeline bibliothèque backfill, extraction, replay, stateful, préflight et orchestration README/TODO/USAGE/CHANGELOG présents
kb-pipeline-demo-scenarios bibliothèque + binaire scénarios Devnet réutilisables et CLI documentée ; réconciliation en 0.5.4
kb-onchain-transport bibliothèque transports RPC HTTP/WebSocket et pools dendpoints README/TODO/USAGE/CHANGELOG présents
kb-store bibliothèque contrats de stockage et adaptateur PostgreSQL documentée ; audit structurel en 0.5.3
kb-wallet bibliothèque wallet temporaire et frontière de signataire documentée ; restructuration en 0.5.2
kb-app-demo-desktop bibliothèque + binaire application de démonstration Tauri documentée ; réconciliation en 0.5.4

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 ;
  • lapplication 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 nest 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 laudit dalignement.

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 dispose de README.md, TODO.md, USAGE.md et CHANGELOG.md. Les documents transversaux présents dans docs/architecture/ évitent de répéter larchitecture complète dans chaque README.