v0.1.4-pre.004

docs/plans/006-V0_1_4_CONFIG_DESKTOP_PLAN.md

@@ -1,5 +1,5 @@
 <!-- file: docs/plans/006-V0_1_4_CONFIG_DESKTOP_PLAN.md -->
-<!-- version: 4 -->
+<!-- version: 5 -->
 
 # Plan `0.1.4` — `ksp-app-config-desk`
 
@@ -220,6 +220,28 @@ Aucun framework React/Vue/Svelte n'est nécessaire pour ce manager spécialisé.
 
 Le premier éditeur raw utilisera un contrôle texte natif correctement stylé ; aucun éditeur de code lourd n'est ajouté tant qu'un besoin fonctionnel ne l'impose pas.
 
+### 3.4 Conventions frontend, artefacts et ports des applications desk
+
+Le layout frontend reprend la convention éprouvée de bot3 : les sources web sont contenues dans `frontend/`, les modules TypeScript dans `frontend/ts/`, les styles SCSS dans `frontend/sass/` et les bindings TS-RS générés sous `frontend/ts/bindings/`. Les DTO Rust restent propriétaires de leur contrat ; les fichiers TypeScript générés ne sont jamais édités manuellement et `bindings/` reste ignoré par Git.
+
+Les artefacts frontend construits doivent être séparés des sources. Pour `ksp-app-config-desk`, la destination contractuelle est fixée à :
+
+```text
+../../builds/khadhroony-solana-project/ksp-app-config-desk/dist
+```
+
+Cette valeur est utilisée par `build.frontendDist` dans `tauri.conf.json`. `vite.config.ts` utilisera la même destination comme `build.outDir` lors de son introduction. Elle remplace le `../dist`/`../../dist` historique du gabarit bot3.
+
+La gestion npm suit une règle simple : npm est utilisé directement pour installer ou mettre à jour les dépendances (`npm i -D ...`). Le cycle normal de développement et de build passe par Tauri ; `cargo tauri dev` et `cargo tauri build` déclenchent eux-mêmes `npm run dev` / `npm run build` au travers des hooks Tauri. Il n'est pas demandé à l'opérateur de lancer séparément le serveur Vite. Aucun lockfile npm n'est versionné.
+
+Chaque application Tauri desk KSP reçoit un couple de ports Vite/HMR propre. La première application réserve :
+
+| Application           | Port Vite HTTP | Port HMR |
+|-----------------------|---------------:|---------:|
+| `ksp-app-config-desk` |         `1430` |   `1431` |
+
+Les applications suivantes incrémentent le couple de deux ports (`1432/1433`, puis `1434/1435`, etc.). Vite doit utiliser un port strict afin qu'une collision soit signalée au lieu de provoquer un basculement silencieux vers un autre port. Cette allocation permet de faire fonctionner simultanément plusieurs applications desk en mode développement.
+
 ## 4. Audit des dépendances actuelles au 2026-08-16
 
 Aucune dépendance n'est ajoutée par `pre.001`. Les versions suivantes ont été revérifiées depuis les registres/documentations officiels afin de fixer la génération candidate à réévaluer **au moment exact de l'ajout** :
@@ -329,7 +351,7 @@ crates/ksp-app-config-desk/
 │   │   ├── frontend_log.ts
 │   │   ├── state.ts
 │   │   └── bindings/             # généré, ignoré
-│   └── scss/
+│   └── sass/
 │       ├── main.scss
 │       ├── splash.scss
 │       └── _shared.scss
@@ -1117,10 +1139,16 @@ pre.004  squelette Rust Tauri
          - main.rs/lib.rs/tauri.rs minimaux
          - builder Tauri configuré par étapes courtes/réassignées, sans chaîne monolithique
          - tauri.conf/capabilities/icône
+         - frontendDist externe contractuel
+         - réservation 1430/1431 et convention des couples de ports desk
+         - layout frontend/ts/bindings + frontend/sass fixé sans dépendances npm prématurées
          - single-instance
 
 pre.005  squelette frontend/gabarit
          - package.json + Vite/TypeScript
+         - npm utilisé pour la gestion des dépendances, cycle dev/build lancé par Tauri
+         - build.outDir identique au frontendDist externe
+         - port Vite 1430 strict + HMR 1431
          - SCSS/Bootstrap/Font Awesome
          - SimpleBar + resize-observer-polyfill comme socle du gabarit
          - @fltsci/tauri-plugin-tracing avec plugin Rust