Files
khadhroony-solana-project/crates/ksp-app-config-desk/README.md
2026-08-16 10:40:23 +02:00

56 lines
2.2 KiB
Markdown

<!-- 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.