v0.3.6-pre.012

This commit is contained in:
2026-09-01 17:42:24 +02:00
parent 9506df9487
commit 42374115c7
18 changed files with 869 additions and 88 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/architecture/010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md -->
<!-- version: 7 -->
<!-- version: 8 -->
# Applications, services, scenarios et control plane
@@ -356,15 +356,13 @@ Le choix du mécanisme exact est reporté à la release fonctionnelle concernée
## Jobs
Les jobs restent distincts des workers.
Les jobs restent distincts des workers. `ksp-job-api` fournit les contrats runtime-neutral communs ; le premier job concret `ksp-job-backfill-lib` est une bibliothèque single-run, pas un service worker autonome.
Une app spécialisée peut déclencher/suivre un job concret via `ksp-job-api` et la composition adaptée.
Une app spécialisée peut construire les ressources Config/Transport/Store, créer un `BackfillJobRuntime`, conserver son `BackfillJobHandle`, observer les snapshots latest-value et demander une annulation coopérative. Elle ne réimplémente ni découverte/hydratation, ni frontier/checkpoint, ni persistance RAW.
Aucune `ksp-job-control-lib` générique n'est introduite.
Aucune `ksp-job-control-lib` générique n'est introduite. Le handle concret suffit tant qu'aucune duplication entre plusieurs jobs ne justifie une couche de gouvernance commune.
Le fait qu'un worker soit un process/service indépendant ne force pas les jobs à adopter exactement le même modèle de déploiement.
Le packaging/exécution des jobs sera déterminé avec les premiers jobs réels.
Le fait qu'un worker soit un process/service indépendant ne force pas les jobs à adopter exactement le même modèle de déploiement. Le packaging des futurs jobs reste décidé par leur besoin réel ; le premier backfill prouve qu'un runtime de bibliothèque composable est suffisant pour un job déclenché par une application.
## Scenarios : logique dans la bibliothèque
@@ -547,7 +545,7 @@ control/application adapters
|
+--> ksp-worker-control-lib --> ksp-worker-api --> worker service
|
+--> ksp-job-api -----------> concrete job
+--> ksp-job-api -----------> ksp-job-backfill-lib / concrete jobs
|
+--> ksp-scenario-<domain>-lib
```