v0.3.7-pre.007
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/validation/024-V0_3_7_BACKFILL_DESK.md -->
|
||||
<!-- version: 8 -->
|
||||
<!-- version: 9 -->
|
||||
|
||||
# Validation v0.3.7 — Backfill Desk
|
||||
|
||||
@@ -61,10 +61,10 @@ Le journal opérateur fourni rapporte `cargo clean`, `cargo fmt`, audits Rust/Ma
|
||||
|
||||
- [X] Composite dédié `config/composite.ksp-app-backfill-desk.json` prévu.
|
||||
- [X] Profils `devnet`, `mainnet`, `testnet` prévus avec couples Transport/Store de même réseau.
|
||||
- [X] Default prévu : `devnet`.
|
||||
- [X] Default final : `mainnet` depuis `pre.006`; Devnet/Testnet restent disponibles par reconfiguration du composite.
|
||||
- [X] Aucun `std.job_backfill.json` en V1.
|
||||
- [X] Les rôles sont dérivés de Transport et validés pour `getSignaturesForAddress` + `getTransaction`.
|
||||
- [X] Aucun rôle `history_backfill` n'est hardcodé ; la base standard actuelle expose `default`.
|
||||
- [X] Aucun rôle `history_backfill` n'est hardcodé ; `pre.006` expose les rôles logiques `backfill_pool`, `backfill_solana_public` et `backfill_publicnode` depuis Transport.
|
||||
- [X] Une incohérence réseau est rejetée avant Start.
|
||||
- [X] Le Desk ouvre Store via `ksp-store-lib`, jamais via backend direct.
|
||||
|
||||
@@ -97,8 +97,8 @@ Le journal opérateur fourni rapporte `cargo clean`, `cargo fmt`, audits Rust/Ma
|
||||
- [X] Splash/main + tracing conformes.
|
||||
- [X] Composite Backfill Desk packagé et valide.
|
||||
- [X] Transport readiness et role inventory sûrs.
|
||||
- [ ] Store readiness et cohérence réseau.
|
||||
- [ ] Quatre scopes + commitments + bornes mappés.
|
||||
- [X] Store readiness et cohérence réseau.
|
||||
- [X] Quatre scopes + commitments + bornes mappés.
|
||||
- [ ] Single active run + Start.
|
||||
- [ ] Snapshot latest-value bridge.
|
||||
- [ ] Cancel + races terminales.
|
||||
@@ -207,7 +207,7 @@ cargo test -p ksp-app-backfill-desk FAIL — canari Ca
|
||||
|
||||
Backfill Desk dépend désormais directement de `ksp-onchain-transport-lib` au niveau backend uniquement. `initialize_transport()` résout le profil Transport déjà sélectionné par le composite, construit `HttpTransportPool`, dérive les clusters HTTP activés et déduplique les rôles logiques à partir des snapshots sûrs. Chaque rôle candidat doit réussir `select_for_method()` pour `getSignaturesForAddress` **et** `getTransaction` avant d'être exposé comme compatible.
|
||||
|
||||
Le sous-contrat `BackfillDeskOptionsDto` expose uniquement : réseaux configurés, rôles compatibles, readiness Transport et diagnostic applicatif sûr. Il ne contient ni provider, URL, endpoint physique, token, checkpoint, payload RAW ou objet Transport. La commande Tauri `backfill_options` est centralisée dans `tauri.rs`. Les scopes, commitments et bornes restent hors de cette tranche et seront ajoutés en `pre.006`.
|
||||
Le sous-contrat `BackfillDeskOptionsDto` expose uniquement : réseaux configurés, rôles compatibles, readiness Transport et diagnostic applicatif sûr. Il ne contient ni provider, URL, endpoint physique, token, checkpoint, payload RAW ou objet Transport. La commande Tauri `backfill_options` est centralisée dans `tauri.rs`. Les scopes, commitments et bornes restent hors de cette tranche et seront ajoutés en `pre.007` après la stabilisation du routage HTTP de `pre.006`.
|
||||
|
||||
Une seule network distincte et au moins un rôle compatible sont requis pour `transport_ready = true`. Une erreur Config/Transport n'empêche pas le shell de démarrer : elle produit une options projection non-ready avec `CommandErrorDto`, tandis que le pool n'est pas conservé. La cohérence avec le réseau Store reste explicitement réservée à `pre.005`.
|
||||
|
||||
@@ -287,7 +287,7 @@ Le support Yellowstone gRPC de `ksp-job-backfill-lib`/Backfill Desk est retiré
|
||||
- [X] le frontend charge/rend le sélecteur et trace son changement ;
|
||||
- [X] aucun Start ni dépendance `ksp-job-backfill-lib` n'est ouvert par la Desk ;
|
||||
- [X] audits statiques Rust/Markdown, JSON Schema et syntaxe TypeScript propres dans l'environnement d'assemblage ;
|
||||
- [ ] replay opérateur `cargo fmt/check/clippy/test` de `pre.006` à exécuter.
|
||||
- [X] replay opérateur `cargo fmt/check/clippy/test` de `pre.006` exécuté ; un fix Clippy strictement local a été requis puis traité.
|
||||
|
||||
## Correctif `pre.006-fix.001`
|
||||
|
||||
@@ -301,4 +301,30 @@ Le correctif reste strictement dans la responsabilité de `pre.006` : il ajoute
|
||||
- [X] aucun contenu fonctionnel de `pre.006` n'est modifié ;
|
||||
- [X] version Cargo synchronisée en `0.3.7-pre.6.fix.1` conformément à `VER-ID-007` et `VER-ID-010` ;
|
||||
- [X] audits statiques Rust/Markdown rejoués dans l'environnement d'assemblage ;
|
||||
- [ ] replay opérateur `cargo fmt/check/clippy/test` du fix à exécuter.
|
||||
- [X] replay opérateur `cargo fmt/check/clippy/test` du fix propre : audits, check, Clippy, Config et toutes les suites Backfill Desk passent.
|
||||
|
||||
## 15. `pre.007` — DTO et mapping de requête
|
||||
|
||||
Le replay opérateur de `pre.006-fix.001` est acquis : audits Rust/Markdown propres, `cargo check --workspace` et Clippy propres, `ksp-config-lib` intégralement vert, puis Backfill Desk vert sur ses 21 tests unitaires, 5 tests de composition, 10 desktop contract, 6 desktop security et 1 public API. Les arbres Cargo ont également été exécutés sans anomalie rapportée.
|
||||
|
||||
`pre.007` ouvre `ksp-job-api` et `ksp-job-backfill-lib` uniquement pour construire et valider le contrat de requête. `BackfillStartRequestDto` reste app-owned et ne transporte ni network, provider, endpoint, URL, credential, checkpoint ou JobId. Le backend dérive le réseau depuis le Store déjà composé et refuse tout `http_role` absent de l'inventaire sûr courant.
|
||||
|
||||
Le formulaire expose les quatre scopes HTTP V1 (`latest_address`, `before_address`, `after_address`, `explicit_signatures`), `finalized`/`confirmed`, les quatre bornes numériques et `min_context_slot`. Ce dernier traverse l'IPC comme texte décimal afin d'éviter toute perte de précision JavaScript avant parsing `u64` côté Rust. Les maxima proviennent exclusivement des constantes publiques de `ksp-job-backfill-lib`; les defaults de Desk restent strictement inférieurs ou égaux à ces maxima.
|
||||
|
||||
La commande `backfill_validate_request` construit un JobId interne uniquement pour satisfaire le contrat `BackfillRequest`, applique le même mapping qui sera réutilisé par Start, puis renvoie une `BackfillRequestPreviewDto` sûre. La preview contient le réseau, le rôle logique, commitment/scope, bornes et seulement présence/comptage pour les valeurs sensibles. Aucun Job n'est créé ni lancé dans cette tranche.
|
||||
|
||||
### Gate statique local `pre.007`
|
||||
|
||||
- [X] dépendances directes `ksp-job-api` et `ksp-job-backfill-lib` ajoutées à Backfill Desk ;
|
||||
- [X] aucune dépendance directe backend Store, `reqwest`, `tonic` ou Yellowstone ajoutée ;
|
||||
- [X] request DTO sans network/provider/endpoint/URL/JobId ;
|
||||
- [X] réseau dérivé du Store configuré et rôle HTTP revalidé contre l'inventaire courant ;
|
||||
- [X] quatre scopes et deux commitments mappés explicitement ;
|
||||
- [X] `min_context_slot` transporté comme texte puis parsé en `u64` côté Rust ;
|
||||
- [X] bornes maxima dérivées des constantes publiques Job et defaults applicatifs vérifiés ;
|
||||
- [X] preview sûre sans adresse ni signature ;
|
||||
- [X] formulaire frontend + validation backend disponibles, sans bouton Start ni `BackfillJobRuntime` ;
|
||||
- [X] instrumentation frontend limitée aux codes/rôle/scope et métadonnées de contrôle ;
|
||||
- [X] capabilities Tauri inchangées : `core:default + tracing:default` ;
|
||||
- [ ] `cargo fmt/check/clippy/test` de `pre.007` à rejouer par l'opérateur ; `cargo`/`rustfmt` restent absents du sandbox.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user