Sasedev/khadhroony-solana-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.0.3-pre.006

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-08-14 12:07:18 +02:00
parent 63bb90a46d
commit 2cb9f809b7
14 changed files with 1126 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
docs/plans/001-V0_0_3_PLAN.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/001-V0_0_3_PLAN.md -->
<!-- version: 9 -->
<!-- version: 10 -->
# Plan KSP 0.0.3
@@ -13,7 +13,7 @@ Transformer le brainstorming KSP en architecture, règles, inventaire et plan su
- `pre.002` — inventaire initial des composants ;
- `pre.003` — graphe de dépendances, correction de l'inventaire et stabilisation des frontières de composition.
Les tranches `pre.004` (Wire/Program) et `pre.005` (Execution/Policy) sont maintenant cadrées/livrées séparément afin de conserver des prereleases de planification bornées.
Les tranches `pre.004` (Wire/Program), `pre.005` (Execution/Policy) et `pre.006` (Data/Materialization/Store) sont maintenant livrées séparément afin de conserver des prereleases de planification bornées.
## Décisions structurantes actuelles
@@ -82,17 +82,36 @@ Livré :
- résultat d'exécution indépendant du Store ;
- `ksp-logging-lib` confirmé comme façade unique tracing du runtime KSP, avec dépendance possible vers Core pour `Error`/`Result`.
### `pre.006` — Données, store et acquisitions
### `pre.006` — Data, Materialization et Store
- détailler `ksp-materializer-api` / `ksp-materializer-lib` ;
- détailler `ksp-store-api` / `ksp-store-lib` ;
- finaliser modèles raw/Core/generic/domain ;
- détailler notifications et mécanismes de diffusion possibles ;
- détailler W1 et backfill ;
- cadrer les workers de processing ;
- revisiter niveaux durables, replay, provenance et idempotence.
Livré :
### `pre.007` — Applications, workers, jobs, scenarios et pipelines spécialisés
- nomenclature durable D1 Raw / D2 Core / D3 journal générique / D4 projections spécialisées ;
- D1/D2/D3 fortement stabilisables et D4 plus évolutif ;
- D3 confirmé comme journal durable obligatoire ;
- frontière `ksp-materializer-api` / `ksp-materializer-lib` sans dépendance Store ;
- capacités conceptuelles de matérialisation générique et projection de domaine ;
- `ksp-store-api` backend-agnostic et `ksp-store-lib` PostgreSQL de référence ;
- provenance et temporalités par niveau ;
- idempotence/versionnement processors ;
- replays indépendants D1 -> D2, D2 -> D3, D3 -> D4 ;
- notifications après commit comme wake-up uniquement, Store comme source de vérité ;
- même contrat D1 pour acquisition live et backfill ;
- D4 par faits canoniques plutôt que tables par protocole.
### `pre.007` — Acquisition, workers de processing et jobs
- détailler `ksp-worker-raw-retriever` ;
- détailler `ksp-worker-core-processor` ;
- détailler `ksp-worker-generic-materializer` ;
- détailler `ksp-worker-domain-projector` et réévaluer son nom ;
- détailler `ksp-job-backfill` ;
- définir les jobs de replay D1 -> D2, D2 -> D3, D3 -> D4 ;
- définir backlog/checkpoints/cursors ;
- traiter batching, concurrence, reprise et hot reconfiguration ;
- choisir le mécanisme de notification de référence sans en faire la source de vérité.
### `pre.008` — Applications, managers, scenarios et orchestration
- formaliser les apps spécialisées ;
- détailler `ksp-worker-control-lib` ;
@@ -101,14 +120,14 @@ Livré :
- cadrer l'orchestrateur futur ;
- inventorier les pipelines spécialisés réellement nécessaires.
### `pre.008` — Plan des premières releases fonctionnelles
### `pre.009` — Plan des premières releases fonctionnelles
- transformer les séries `0.1.x+` en premières releases concrètes ;
- dimensionner chaque release concrète ;
- choisir la première release `0.1.N` ;
- transformer le brouillon de prompt en prompt quasi-final de cette release concrète.
### `pre.009` — Clôture fondatrice
### `pre.010` — Clôture fondatrice
- validations finales de cohérence ;
- documentation/nettoyage/archivage ;