0.5.1-pre.003

This commit is contained in:
2026-08-09 22:48:31 +02:00
parent 6a680767ae
commit 6151bb25e7
333 changed files with 2200 additions and 2158 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/guides/LOGGING.md -->
<!-- version: 3 -->
<!-- version: 4 -->
# Guide de logging et tracing
@@ -49,13 +49,13 @@ Les targets suivent les conventions du workspace, par exemple :
ks-pipeline.backfill
ks-pipeline.decode-replay
ks-onchain-transport.http
kb-lib.executor.spl.token-2022
kb-lib.materializer.compliance.audit
kb-lib.materializer.token.accounts
kb-lib.materializer.transaction.annotations
ks-lib-executor.spl.token-2022
ks-lib-materializer.compliance.audit
ks-lib-materializer.token.accounts
ks-lib-materializer.transaction.annotations
```
Pour un matérialisateur, la target de tracing est lidentité runtime `kb-lib.materializer.<domain>[.<subsystem>]`. Elle reste distincte du `processorName` persisté `materializer.<domain>[.<subsystem>]`, qui ne doit pas être utilisé comme target de logs.
Pour un matérialisateur, la target de tracing est lidentité runtime `ks-lib-materializer.<domain>[.<subsystem>]`. Elle reste distincte du `processorName` persisté `materializer.<domain>[.<subsystem>]`, qui ne doit pas être utilisé comme target de logs.
Une nouvelle target doit être ajoutée selon `docs/OPERATION_NAMING_CONVENTION.md` et les règles Khadhroony.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/guides/POSTGRES_STORAGE.md -->
<!-- version: 2 -->
<!-- version: 3 -->
# Guide PostgreSQL et contrats de stockage
@@ -39,6 +39,12 @@ Toujours utiliser `masked_dsn()` dans les diagnostics.
Les migrations sont idempotentes et ordonnées. Une nouvelle migration ne doit pas modifier rétroactivement une migration déjà publiée.
## Compatibilité des identités de processeurs
Depuis `0.5.1-pre.003`, les identités techniques produites par `ks-lib` utilisent `ks-lib-decoder.*`, `ks-lib-executor.*` et `ks-lib-materializer.*`. Une base alimentée avant cette migration peut encore contenir des valeurs `kb-lib.*` dans les contrats de provenance/replay.
Aucune migration SQL automatique de ces valeurs n'est ajoutée en `0.5.1` : avant `0.6.x`, une base conservée doit soit être reconstruite proprement, soit faire l'objet d'une migration de données explicitement contrôlée avant reprise du replay. Il ne faut pas exploiter durablement un même corpus avec les anciennes et nouvelles identités mélangées. Les noms de tables `kb_sol_*` restent inchangés jusqu'au chantier `0.5.3`.
## Repositories
Les traits publics séparent le contrat de limplémentation PostgreSQL. Les opérations de lecture utilisent des filtres et paginations bornés.