v0.1.4-pre.010
This commit is contained in:
123
deltas/0.1.4/pre.010.md
Normal file
123
deltas/0.1.4/pre.010.md
Normal file
@@ -0,0 +1,123 @@
|
||||
<!-- 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é |
|
||||
Reference in New Issue
Block a user