124 lines
5.2 KiB
Markdown
124 lines
5.2 KiB
Markdown
<!-- file: deltas/0.1.4/pre.010.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# `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
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
ConfigProfileDocumentDto
|
|
ConfigProfileValueOriginDto
|
|
ConfigProfileEnvironmentProvenanceDto
|
|
ConfigProfileDetailDto
|
|
```
|
|
|
|
Commandes Tauri centralisées dans `tauri.rs` :
|
|
|
|
```text
|
|
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
|
|
|
|
```bash
|
|
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é |
|