v0.1.0-pre.064-065

olddocs/archivekbot2/docs/APPLICATION_CRATES.md

@@ -0,0 +1,28 @@
+<!-- file: docs/APPLICATION_CRATES.md -->
+<!-- version: 1 -->
+
+# 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`.