123 lines
3.8 KiB
Markdown
123 lines
3.8 KiB
Markdown
<!-- file: deltas/0.3.8/pre.007.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.8-pre.007` — RAW Transactions DataTables server-side + détail
|
|
|
|
## Base requise
|
|
|
|
Base directe attendue : `0.3.8-pre.006-fix.001` (`workspace.package.version = 0.3.8-pre.6.fix.1`).
|
|
|
|
## Objet
|
|
|
|
Brancher la vue `RAW Transactions` de `ksp-app-store-desk` sur la capability d'inspection Store introduite en `pre.003`/`pre.004`, sans modifier Store API, PostgreSQL ou les queries keyset machine.
|
|
|
|
## Backend applicatif
|
|
|
|
Store Desk ajoute des DTO app-owned et deux commands Tauri :
|
|
|
|
```text
|
|
store_query_transactions
|
|
store_get_transaction_detail
|
|
```
|
|
|
|
`store_query_transactions` reçoit uniquement :
|
|
|
|
```text
|
|
offset decimal
|
|
limit = 25 | 50 | 100
|
|
slot_min optionnel
|
|
slot_max optionnel
|
|
direction = ascending | descending
|
|
```
|
|
|
|
Le network n'est jamais fourni par le frontend : il est dérivé du `ksp-store-lib::Store` déjà ouvert. Le runtime construit `RawInspectionPageRequest` + `RawTransactionInspectionQuery` puis appelle `RawTransactionInspectionRead`.
|
|
|
|
La réponse app-owned contient :
|
|
|
|
```text
|
|
rows payload-free
|
|
records_total_decimal
|
|
records_filtered_decimal
|
|
```
|
|
|
|
Tous les `u64` qui peuvent dépasser le domaine JS-safe restent encodés en texte décimal.
|
|
|
|
## Table Transactions
|
|
|
|
La table passe à :
|
|
|
|
```text
|
|
serverSide: true
|
|
searching: false
|
|
ordering: false
|
|
pageLength: 25
|
|
lengthMenu: [25, 50, 100]
|
|
ajax: fonction custom -> invoke Tauri
|
|
```
|
|
|
|
Le mapping visible est :
|
|
|
|
```text
|
|
DataTables start -> offset
|
|
DataTables length -> limit
|
|
Store total -> recordsTotal
|
|
Store filtered -> recordsFiltered
|
|
Store summaries -> data
|
|
DataTables draw -> frontend uniquement
|
|
```
|
|
|
|
Les filtres Store explicites sont `slot min`, `slot max` et `direction`. Tout changement de filtre redessine depuis la première page. Aucun pager Store ou cursor n'est rendu.
|
|
|
|
## Rows et détail
|
|
|
|
Les rows exposent uniquement signature encodée, slot, block time, format ID/version, payload size, content hash et retention state. Aucun payload byte n'est présent dans la table.
|
|
|
|
Le bouton `Détail` charge une seule identité :
|
|
|
|
- `Full` / `Archived` : `RawTransactionRead` fournit le payload logique ; Store Desk n'en expose qu'un preview hex des 512 premiers bytes maximum ;
|
|
- `Purged` : `RawTransactionRetentionRead` fournit le tombstone ; aucun block time/payload n'est inventé ;
|
|
- la taille exacte et le flag de troncature sont séparés du preview ;
|
|
- aucun export exact 16 MiB n'est ajouté.
|
|
|
|
## Sécurité / instrumentation
|
|
|
|
- rejet Rust de `length=-1` et de toute taille autre que 25/50/100 ;
|
|
- offset, slots et signature parsés sans écho de valeur dans les erreurs ;
|
|
- counts décimaux convertis côté TypeScript seulement après contrôle `Number.MAX_SAFE_INTEGER` ;
|
|
- aucune search/order DataTables arbitraire dans le contrat IPC ;
|
|
- aucune URI, credential, SQL, handle PostgreSQL ou payload dans les logs ;
|
|
- tracing query/page/page-length/redraw/refresh/detail sans valeurs de filtres ni identité ;
|
|
- nouveaux items `pub(crate)` réexportés par `lib.rs` et consommés via `crate::Item` conformément à `RUST-IMPORT-009/012` et `RUST-API-004`.
|
|
|
|
## Hors scope
|
|
|
|
`RAW Accounts` reste local et `serverSide:false` jusqu'à `pre.008`. Aucun changement de Store API, Store façade, PostgreSQL, migration, index, capability ou Config composite.
|
|
|
|
## Version
|
|
|
|
```text
|
|
delivery = 0.3.8-pre.007
|
|
workspace.package.version = 0.3.8-pre.7
|
|
commit = v0.3.8-pre.007
|
|
tag = aucun
|
|
```
|
|
|
|
## Gate requis
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-app-store-desk
|
|
cargo test -p ksp-store-lib
|
|
cargo check -p ksp-store-lib --no-default-features
|
|
```
|
|
|
|
Smoke runtime recommandé :
|
|
|
|
```bash
|
|
(cd crates/ksp-app-store-desk && cargo tauri dev)
|
|
```
|