Documentation active de Khadhroony Bot3
1. Statut
Ce répertoire contient la documentation active, normative ou opérationnelle de khadhroony-bot3.
La documentation historique de khadhroony-bot2 est conservée sous olddocs/archivekbot2/. Elle ne doit être ni déplacée vers docs/, ni considérée comme normative. Tout nouveau document bot3 est réécrit après lecture du code, des tests, des matrices et des sources historiques pertinentes.
2. Architecture
architecture/PROJECT_OBJECTIVES.md: objectifs et limites du projet ;architecture/ARCHITECTURE.md: couches et flux principaux ;architecture/CRATE_MAP.md: responsabilités des 11 crates ;architecture/PIPELINE_ARCHITECTURE.md: orchestration, replay et exécution ;architecture/STORAGE_ARCHITECTURE.md: contrats de stockage et PostgreSQL ;architecture/SURFACE_CRATE_MATRIX.md: répartition des responsabilités par surface.
3. Règles
Le point d’entrée normatif unique est ../RULES.md.
Règles spécialisées :
rules/RULES_GENERAL.md;rules/RULES_RUST.md;rules/RULES_SPECIFIC_KHADHROONY.md;rules/CRATE_DOCUMENTATION_RULES.md.
Modèles documentaires non génératifs :
templates/CRATE_README_TEMPLATE.md;templates/CRATE_TODO_TEMPLATE.md;templates/CRATE_USAGE_TEMPLATE.md;templates/CRATE_CHANGELOG_TEMPLATE.md.
4. Audits et décisions actifs
audits/V0_4_7_PRE_016_DOCUMENTATION_AND_HEADERS_AUDIT.md;audits/V0_4_8_PRE_002_METADATA_CONTRACT_AUDIT.md;audits/V0_4_8_PRE_007_METAPLEX_MATERIALIZER_STRUCTURE_AUDIT.md;audits/V0_4_8_PRE_007_MATERIALIZER_CONVENTION_AUDIT.md;audits/V0_4_8_PRE_008_METADATA_SOLANA_PROGRAM_PIPELINE_AUDIT.md;audits/V0_4_8_PRE_008_METADATA_AND_PIPELINE_NOMENCLATURE_AUDIT.md;audits/V0_4_8_PRE_008_SOLANA_PROGRAM_METADATA_HISTORICAL_REPLAY_FIX.md;audits/V0_4_8_PRE_009_METADATA_SOLANA_PROGRAM_DEVNET_SCENARIOS_AUDIT.md;decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md;decisions/WINCODE_COMPATIBILITY_POLICY.md.
Ces audits seront archivés sous olddocs/archivekbot3/ lorsqu’ils auront été remplacés par des documents normatifs ou des rapports de clôture.
5. Documents techniques actifs
DEVNET_EXECUTION_GUIDE.md;IDL_AUDIT.md;IDL_TO_KB_LIB_NOMENCLATURE.md;MISSING_PROGRAM_IDLS.md;OPERATION_NAMING_CONVENTION.md;IDEA_REMINDERS.md.
Les idées ne rejoignent un TODO.md qu’après confirmation, attribution et reformulation en tâche vérifiable.
6. Matrices contractuelles
Les matrices canoniques sont conservées sous :
test-fixtures/contract-matrices/
Elles peuvent être chargées directement par les tests unitaires ou d’intégration. Elles ne doivent pas être dupliquées sous docs/. Les documents actifs peuvent les référencer et expliquer leur rôle.
7. Documentation par crate
Les onze crates possèdent désormais README.md, TODO.md, USAGE.md et CHANGELOG.md :
kb-core;kb-config;kb-lib;kb-logging;kb-program-ids;kb-pipeline;kb-pipeline-demo-scenarios;kb-onchain-transport;kb-store;kb-wallet;kb-app-demo-desktop.
Guides
- Configuration
- Logging et tracing
- RPC, backfill et WebSocket
- Extraction Core, replay et matérialisation
- PostgreSQL et stockage
- Validation Devnet
- Validation Metaplex Token Metadata 0.4.7
validation/WEBSOCKET_MAINNET_RESEARCH_VALIDATION_REPORT.md;validation/MAINNET_RESEARCH_BACKFILL_VALIDATION_SCENARIO.md;validation/V0_4_8_PRE_008_SOLANA_PROGRAM_METADATA_MAINNET_REPLAY_REPORT.md;validation/V0_4_8_PRE_010_SOLANA_PROGRAM_METADATA_DEVNET_VALIDATION_REPORT.md— preuve de deux campagnes Devnet complètes couvrant les neuf opérations Solana Program Metadata ;
Audits actifs
Audit contractuel 0.4.8-pre.002 — metadata;Audit 0.4.8-pre.005 — instructions et historique Solana Program Metadata;Audit 0.4.8-pre.007 — structure du matérialiseur Metaplex Token Metadata;Audit 0.4.8-pre.007 — conventions et structure de tous les matérialisateurs;Audit 0.4.8-pre.008 — pipeline Solana Program Metadata.Correctif 0.4.8-pre.008 — replay historique Solana Program Metadata;Audit 0.4.8-pre.009 — scénarios Devnet Solana Program Metadata;Audit 0.4.8-pre.011 — complétude Token-2022 Token Metadata.