khadhroony-solana-project/deltas/0.1.4/pre.010.md

0.1.4-pre.010 — Profils + provenance

1. Base validée

Cette tranche part de 0.1.4-pre.9, validée localement avec :

• cargo fmt --all ;
• cargo check --workspace ;
• cargo clippy --workspace --all-targets ;
• 20 tests ksp-app-config-desk ;
• 87 tests unitaires + 4 tests ownership + 12 tests public API ksp-config-lib ;
• lancement réel cargo tauri dev -c crates/ksp-app-config-desk/tauri.conf.json ;
• tri/recherche DataTables vérifiés ;
• candidat JSON invalide refusé sans destruction du document valide ;
• sauvegarde valide sans changement puis avec changement réel vérifiées ;
• reload final valide.

2. Version technique

workspace.package.version = "0.1.4-pre.10"

3. Surface Profils backend

La nouvelle unité src/profiles.rs projette les contrats publics de ksp-config-lib sans réimplémenter la validation ni la résolution :

• inventaire des documents Config validés qui exposent default_profile / profiles ;
• ConfigDocumentEngine::load_resolved_profile() pour la sélection par défaut ou explicite ;
• vues globals, profile et effective ;
• ResolvedConfigProfile::origin() pour la provenance top-level global / profile ;
• resolve_effective_environment_detailed() pour la résolution environnementale sûre ;
• provenance environnementale limitée au JSON Pointer, nom de variable, source et sensibilité.

Aucune valeur réelle issue d'une variable Secret n'est sérialisée vers le frontend. L'effective affichée provient exclusivement de ResolvedConfigJson::safe_value().

4. DTO et commandes Tauri

DTO TS-RS introduits :

ConfigProfileDocumentDto
ConfigProfileValueOriginDto
ConfigProfileEnvironmentProvenanceDto
ConfigProfileDetailDto

Commandes Tauri centralisées dans tauri.rs :

get_config_profile_documents
get_config_profile_detail

Le backend journalise uniquement file_id, profile_id, source de sélection, sensibilité globale et nombre de segments de provenance environnementale. Les arbres JSON et les valeurs résolues ne sont pas journalisés.

5. Surface frontend

Le module frontend/ts/profiles.ts fournit :

• sélection du document Config profilé ;
• inspection initiale via default_profile ;
• sélection explicite d'un profile_id ;
• retour explicite au profil par défaut ;
• reload ;
• affichage côte à côte Globals source, Profil source, Effective sûre ;
• table de provenance top-level ;
• table de provenance environnementale ;
• instrumentation debug / trace des sélections, clics, chargements et remplacements DOM.

Aucune dépendance npm supplémentaire n'est ajoutée dans cette tranche.

6. Dépendance Rust

ksp-app-config-desk consomme désormais directement serde_json.workspace = true pour sérialiser les projections JSON destinées à l'affichage. La version reste centralisée dans le Cargo.toml racine.

7. Validation demandée

cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-app-config-desk
cargo test -p ksp-config-lib
cargo tree -p ksp-app-config-desk
cargo tauri dev -c crates/ksp-app-config-desk/tauri.conf.json

Test manuel minimum :

1. ouvrir Profils ;
2. vérifier cfg.std.logging, default_profile=local_dev et le profil sélectionné ;
3. vérifier que l'inspection initiale indique source de sélection = default_profile ;
4. sélectionner explicitement local_dev dans la liste et vérifier source de sélection = sélection explicite ;
5. cliquer Profil par défaut et vérifier le retour à default_profile ;
6. vérifier les trois vues globals/profil/effective ;
7. avec KSP_LOGS_DIRECTORY dans .env, vérifier /logs_directory -> KSP_LOGS_DIRECTORY -> dotenv -> Internal dans la provenance environnement ;
8. vérifier que les logs décrivent l'inspection sans recopier les JSON ni les valeurs d'environnement.

8. Fichiers modifiés/ajoutés

Fichier	Action
Cargo.toml	modifié
crates/ksp-app-config-desk/Cargo.toml	modifié
crates/ksp-app-config-desk/README.md	modifié
crates/ksp-app-config-desk/TODO.md	modifié
crates/ksp-app-config-desk/USAGE.md	modifié
crates/ksp-app-config-desk/frontend/main.html	modifié
crates/ksp-app-config-desk/frontend/sass/_app.scss	modifié
crates/ksp-app-config-desk/frontend/ts/main.ts	modifié
crates/ksp-app-config-desk/frontend/ts/profiles.ts	ajouté
crates/ksp-app-config-desk/src/constants.rs	modifié
crates/ksp-app-config-desk/src/errors.rs	modifié
crates/ksp-app-config-desk/src/lib.rs	modifié
crates/ksp-app-config-desk/src/profiles.rs	ajouté
crates/ksp-app-config-desk/src/tauri.rs	modifié
crates/ksp-app-config-desk/unit_tests/profiles.rs	ajouté
docs/plans/006-V0_1_4_CONFIG_DESKTOP_PLAN.md	modifié
deltas/0.1.4/pre.010.md	ajouté