v0.1.4-pre.004

crates/ksp-app-config-desk/README.md

@@ -0,0 +1,55 @@
+<!-- file: crates/ksp-app-config-desk/README.md -->
+<!-- version: 1 -->
+
+# `ksp-app-config-desk`
+
+`ksp-app-config-desk` est l'application desktop spécialisée de management et de validation de la configuration KSP.
+
+La crate est un package Tauri mixte :
+
+```text
+package : ksp-app-config-desk
+lib     : ksp_app_config_desk_lib
+bin     : ksp-app-config-desk
+```
+
+## Responsabilités
+
+L'application restera une couche d'interface/composition. Les responsabilités de parsing, validation, profils, environnement, `.env`, secrets et persistence restent dans `ksp-config-lib`; le runtime Logging restera possédé par `ksp-logging-lib`.
+
+La première tranche de squelette établit uniquement :
+
+- le membre workspace Rust ;
+- le couple `lib` + `bin` ;
+- le verrou single-instance ;
+- l'assemblage Tauri minimal dans `src/tauri.rs` ;
+- les fenêtres `splash` et `main` ;
+- les capabilities initiales ;
+- l'icône de référence reprise du gabarit desktop éprouvé ;
+- le port de développement réservé `1430`, avec `1431` réservé au HMR Vite ;
+- le répertoire frontend cible `frontend/`, dont `frontend/ts/` et `frontend/ts/bindings/`.
+
+Le frontend Vite/TypeScript/SCSS et les dépendances npm sont introduits dans la tranche suivante. Tant que cette tranche n'est pas appliquée, `cargo tauri dev` n'est pas un scénario de validation attendu de ce squelette.
+
+## Artefacts frontend
+
+Les artefacts frontend construits ne doivent pas être versionnés. `tauri.conf.json` fixe dès maintenant la destination contractuelle :
+
+```text
+../../builds/khadhroony-solana-project/ksp-app-config-desk/dist
+```
+
+`vite.config.ts` utilisera la même destination lors de son introduction.
+
+Les commandes npm servent uniquement à installer/mettre à jour les dépendances. Le cycle normal de développement/build de l'application passe par Tauri, qui déclenche les scripts frontend déclarés dans sa configuration.
+
+## Ports desktop
+
+KSP réserve des couples de ports distincts par application desk. `ksp-app-config-desk`, première application, utilise :
+
+```text
+Vite HTTP : 1430
+Vite HMR  : 1431
+```
+
+Les applications desk suivantes incrémentent le couple de deux ports afin de pouvoir fonctionner simultanément sans collision.