# Delta `0.3.7-pre.007` — DTO et mapping de requête Backfill ## 1. Base requise ```text 0.3.7-pre.006-fix.001 workspace.package.version = 0.3.7-pre.6.fix.1 ``` ## 2. Objectif Ouvrir le contrat Job Backfill dans la Desk uniquement pour construire, valider et prévisualiser une requête de campagne HTTP, sans créer ni démarrer de `BackfillJobRuntime`. ## 3. Contrat applicatif Backfill Desk dépend désormais directement de `ksp-job-api` et `ksp-job-backfill-lib`. Le frontend reçoit les quatre scopes HTTP V1, les deux commitments, les maxima publics Job et des defaults applicatifs bornés. `BackfillStartRequestDto` reste possédé par l'application et ne contient ni réseau, provider, endpoint, URL, credential, checkpoint ou JobId. Le réseau est dérivé du Store composé ; `http_role` est revalidé contre l'inventaire sûr `BackfillDeskOptionsDto::http_routes` avant construction du contrat Job. `min_context_slot` traverse IPC sous forme de texte décimal et est parsé en `u64` côté Rust afin d'éviter toute perte de précision JavaScript. ## 4. Mapping autoritaire Le mapping Rust : - valide la readiness Transport + Store et leur cohérence réseau ; - mappe explicitement `finalized` / `confirmed` ; - mappe explicitement `latest_address`, `before_address`, `after_address` et `explicit_signatures` ; - parse l'adresse et les signatures dans les types propriétaires ; - convertit les bornes `u32` vers `usize` ; - délègue la validation finale à `ksp-job-backfill-lib::BackfillRequest::new` ; - n'ouvre aucun runtime Job. La commande Tauri `backfill_validate_request` utilise exactement ce mapping avec un JobId interne réservé à la validation, puis renvoie une `BackfillRequestPreviewDto` sûre. La preview expose réseau/rôle/commitment/scope/bornes, mais réduit adresse, ancre, `min_context_slot` et signatures à des booléens ou comptages. ## 5. Frontend Le formulaire Backfill expose : - route HTTP logique ; - scope ; - commitment ; - adresse et ancre selon le scope ; - signatures explicites ; - page size ; - max pages ; - max candidates ; - hydration concurrency ; - `min_context_slot`. Le bouton reste **Valider la requête**. Aucun Start, Cancel, Resume ou checkpoint n'est ouvert dans cette tranche. Les logs frontend ne contiennent aucune adresse, signature, ancre ou valeur de `min_context_slot`. ## 6. Version ```text workspace.package.version = 0.3.7-pre.7 label = 0.3.7-pre.007 ``` ## 7. Fichiers ajoutés ```text crates/ksp-app-backfill-desk/src/backfill_request.rs crates/ksp-app-backfill-desk/src/dto_backfill.rs crates/ksp-app-backfill-desk/unit_tests/backfill_request.rs crates/ksp-app-backfill-desk/unit_tests/dto_backfill.rs deltas/0.3.7/pre.007.md ``` ## 8. Fichiers modifiés ```text Cargo.toml crates/ksp-app-backfill-desk/Cargo.toml crates/ksp-app-backfill-desk/frontend/main.html crates/ksp-app-backfill-desk/frontend/ts/main.ts crates/ksp-app-backfill-desk/src/app_state.rs crates/ksp-app-backfill-desk/src/constants.rs crates/ksp-app-backfill-desk/src/dto_common.rs crates/ksp-app-backfill-desk/src/errors.rs crates/ksp-app-backfill-desk/src/lib.rs crates/ksp-app-backfill-desk/src/tauri.rs crates/ksp-app-backfill-desk/src/transport_runtime.rs crates/ksp-app-backfill-desk/tests/desktop_contract.rs crates/ksp-app-backfill-desk/tests/desktop_security.rs crates/ksp-app-backfill-desk/unit_tests/dto_common.rs docs/plans/028-V0_3_7_BACKFILL_DESK_PLAN.md docs/validation/024-V0_3_7_BACKFILL_DESK.md ``` ## 9. Fichiers supprimés Aucun. ## 10. Gate précédent acquis Le replay opérateur de `0.3.7-pre.006-fix.001` est propre : audits Rust/Markdown, `cargo check --workspace`, Clippy, `ksp-config-lib`, Backfill Desk et arbres Cargo passent sans anomalie rapportée. ## 11. Validations exécutées dans l'environnement d'assemblage ```text 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/0.3.7 ``` Contrôles ciblés : - syntaxe TypeScript par transpilation locale ; - cohérence des headers/version des fichiers modifiés ; - présence des quatre scopes et deux commitments à partir des contrats Job publics ; - absence de réseau/provider/URL/endpoint/JobId dans le DTO frontend ; - absence de `BackfillJobRuntime`, Start, Cancel, Resume et checkpoint dans le runtime de cette tranche ; - absence de valeur d'adresse/signature/ancre/`min_context_slot` dans la preview et les logs frontend ; - dépendances directes limitées aux façades/API prévues ; - contrôle différentiel et reconstruction par application du delta. ## 12. Validations non exécutées dans l'environnement d'assemblage `cargo` et `rustfmt` ne sont pas disponibles dans l'environnement d'assemblage. Gate opérateur obligatoire avant `pre.008` : ```text 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/0.3.7 cargo check --workspace cargo clippy --workspace --all-targets cargo test -p ksp-job-backfill-lib cargo test -p ksp-app-backfill-desk cargo tree -p ksp-app-backfill-desk --edges normal cargo tree -p ksp-app-backfill-desk -e features ``` ## 13. Suite `pre.008` ouvrira le runtime et Start : état single-active-run, construction `BackfillJobRuntime`, admission atomique, spawn non bloquant et handle installé avant exécution. Le choix HTTP pool/provider et le mapping `BackfillRequest` de `pre.007` restent les entrées autoritaires.