v0.3.3-pre.004

crates/ksp-store-postgres-lib/README.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-store-postgres-lib/README.md -->
-<!-- version: 2 -->
+<!-- version: 3 -->
 
 # ksp-store-postgres-lib
 
@@ -83,7 +83,7 @@ ksp_store_schema_migrations
 
 Le moteur vérifie version, nom et checksum SHA-256, sérialise les runners par advisory transaction lock et refuse une history divergente ou plus récente que le runtime.
 
-Aucune migration métier RAW n'appartient à cette fondation.
+V001 possède désormais le schéma physique `RawTransaction` et son contrat de compatibilité ; les opérations métier restent introduites par tranches afin de préserver des gates courts et vérifiables.
 
 ## Health et erreurs
 
@@ -104,14 +104,29 @@ La politique de support de `0.3.2` fixe PostgreSQL 15 comme major minimal. Le te
 
 La preuve opérateur réelle et le major effectivement exercé sont conservés dans la matrice de validation, pas dans cette documentation durable.
 
+## Lectures RAW `0.3.3-pre.004`
+
+Le backend expose désormais quatre lectures étroites qui retournent uniquement des modèles `ksp-store-api` :
+
+```text
+get_raw_transaction
+get_raw_transaction_observation
+get_raw_transaction_retention_state
+get_raw_transaction_tombstone
+```
+
+Le SQL et les rows restent privés au backend. Le mapping PostgreSQL est fallible et couvre notamment `NUMERIC(20,0) -> u64`, `BIGINT -> u32/u64`, timestamps bornés, bytes de taille fixe et codes de provenance. Une ligne stockée incompatible produit uniquement `PostgresBackendErrorKind::DataInvalid`; un échec de SELECT produit `ReadFailed`. Les lectures portant un `RawTransactionReference` rejettent un réseau différent avant toute acquisition de pool.
+
+`Full` lit le payload chaud, `Archived` le reconstruit depuis la relation archive et `Purged` retourne `None`; le tombstone reste accessible séparément pour `Purged`.
+
 ## Hors périmètre actuel
 
 La crate ne contient encore :
 
-- aucune implémentation PostgreSQL des capabilities `RawTransaction*` ;
+- aucune écriture PostgreSQL `RawTransaction*` ;
+- aucune pagination/listing `RawTransaction` ;
+- aucune implémentation complète des traits `RawTransaction*` de `ksp-store-api` tant que `list_raw_transactions` manque ;
 - aucune implémentation PostgreSQL des capabilities `RawAccount*` ;
-- aucun repository métier RAW ;
-- aucune table/index métier ;
 - aucune orchestration worker/job ;
 - aucun transport d'acquisition ou decoder Program.