khadhroony-bot3/migration/khadhroony-bot2-reference/docs/APPLICATION_CRATES.md

Crates applicatifs

Les crates applicatifs sont les points d'entrée exécutables ou Tauri du workspace. Ils orchestrent les crates internes mais ne portent pas la logique métier profonde.

Nomenclature

• Les applications ponctuelles ou interactives utilisent le préfixe kb_app_.
• kb_app_cli contient les commandes de contrôle, import, replay et diagnostic.
• kb_app_demo contient la démonstration Tauri.
• kb_worker est l'exception autorisée, car il représente un processus de travail long-running.

Responsabilités autorisées

• Lire la configuration.
• Initialiser kb_logging.
• Appeler les APIs publiques de kb_pipeline.
• Afficher ou exposer les résultats.
• Retourner des codes de sortie ou événements UI.

Responsabilités interdites

• Décoder directement une instruction DEX.
• Écrire directement dans PostgreSQL sans passer par les traits de stockage.
• Réimplémenter les règles de matérialisation.
• Charger ou manipuler des secrets wallet hors kb_wallet.