v0.0.3-pre.003

docs/architecture/003-COMPONENT_CONTRACTS.md

@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/003-COMPONENT_CONTRACTS.md -->
-<!-- version: 4 -->
+<!-- version: 5 -->
 
 # Contrats initiaux des composants KSP
 
@@ -9,7 +9,7 @@ Ce document enregistre les frontières déjà suffisamment claires pour guider l
 
 Le principe commun est de définir tôt les contrats nécessaires entre composants, puis d'enrichir les implémentations lorsque le besoin réel apparaît.
 
-L'inventaire détaillé courant est maintenu dans [`004-COMPONENT_INVENTORY.md`](004-COMPONENT_INVENTORY.md).
+L'inventaire détaillé courant est maintenu dans [`004-COMPONENT_INVENTORY.md`](004-COMPONENT_INVENTORY.md) et le graphe autorisé/interdit dans [`005-DEPENDENCY_GRAPH.md`](005-DEPENDENCY_GRAPH.md).
 
 ## Convention API / implémentation
 
@@ -45,7 +45,7 @@ Aucune API commune worker+job n'est prévue.
 
 `ksp-program-lib` ne possède pas la politique de sécurité/autorisation d'un produit.
 
-La direction retenue pour étude est un contrat public séparé :
+Le contrat public séparé suivant est retenu :
 
 ```text
 ksp-execution-policy-api
@@ -57,7 +57,7 @@ Les applications UI sélectionnent/injectent une implémentation réutilisable a
 
 ## Execution orchestration
 
-`ksp-execution-lib` devient un candidat fort de pipeline/orchestrateur spécialisé pour relier :
+`ksp-execution-lib` est retenu comme pipeline/orchestrateur spécialisé pour relier :
 
 - la préparation/sémantique programme ;
 - une implémentation de `ksp-execution-policy-api` ;
@@ -66,7 +66,17 @@ Les applications UI sélectionnent/injectent une implémentation réutilisable a
 
 Le but est d'éviter que `ksp-program-lib` dépende directement du wallet/transport uniquement pour réaliser le cycle réseau/signature.
 
-Le graphe exact reste à valider dans `pre.003`.
+`ksp-execution-lib` dépend de `ksp-program-api` mais pas de `ksp-program-lib` ; il reçoit une opération préparée ou une implémentation conforme au contrat public. Le graphe détaillé est fixé dans `005-DEPENDENCY_GRAPH.md` et les types exacts seront définis en `pre.004`.
+
+## Frontière materializer / store
+
+`ksp-materializer-api` peut dépendre de `ksp-program-api` pour consommer des contrats de processing communs.
+
+`ksp-materializer-lib` reste une bibliothèque de transformation et ne dépend ni de `ksp-store-api` ni de `ksp-store-lib`.
+
+`ksp-store-api` possède les DTO/contrats persistants et reste indépendant des APIs Program/Materializer. Les workers de processing convertissent explicitement entre modèles runtime et modèles persistants.
+
+Cette règle évite d'introduire un `ksp-data-api` monolithique uniquement pour partager des modèles entre couches.
 
 ## Transport on-chain