79 lines
2.6 KiB
Markdown
79 lines
2.6 KiB
Markdown
<!-- file: crates/ksp-app-solprices-desk/README.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# `ksp-app-solprices-desk`
|
|
|
|
`ksp-app-solprices-desk` est le Desk Tauri spécialisé destiné à visualiser les prix SOL/USD fournis par `ksp-offchain-transport-lib` sans exposer les détails propres aux providers au frontend.
|
|
|
|
`0.2.12-pre.002` crée uniquement le **scaffold desktop**. La composition Off-chain, les DTO prix, la table provider-neutral et les commandes de refresh appartiennent aux tranches suivantes.
|
|
|
|
## Package
|
|
|
|
```text
|
|
package : ksp-app-solprices-desk
|
|
lib : ksp_app_solprices_desk_lib
|
|
bin : ksp-app-solprices-desk
|
|
```
|
|
|
|
Le binaire reste un launcher mince. La bibliothèque applicative possède l'assemblage Tauri, l'état de bootstrap, le bridge Logging et le lifecycle des fenêtres.
|
|
|
|
## Surface du scaffold
|
|
|
|
```text
|
|
splash
|
|
-> Config standard + Logging
|
|
-> main
|
|
-> Prices placeholder non fonctionnel en pre.002
|
|
-> Diagnostics identité/runtime Logging sûre
|
|
```
|
|
|
|
Le scaffold ne possède encore aucun `MarketPriceService`, aucun fetch prix, aucun provider, aucun endpoint, aucun credential et aucun scheduler.
|
|
|
|
## Frontières desktop
|
|
|
|
Le frontend utilise uniquement les capabilities :
|
|
|
|
```text
|
|
core:default
|
|
tracing:default
|
|
```
|
|
|
|
Aucun plugin dialog, filesystem, HTTP ou shell n'est accordé au WebView. Le bridge frontend Logging passe par des commandes Rust centralisées dans `tauri.rs`.
|
|
|
|
Les ports réservés sont :
|
|
|
|
```text
|
|
Vite HTTP : 1434
|
|
Vite WS : 1435
|
|
```
|
|
|
|
Le port Vite est strict et le frontend build est isolé sous :
|
|
|
|
```text
|
|
builds/khadhroony-solana-project/ksp-app-solprices-desk/dist
|
|
```
|
|
|
|
## Config et packaging
|
|
|
|
Pendant `pre.002`, le Desk utilise le document Logging standard pour établir le gabarit commun. Le composite dédié `cfg.composite.ksp-app-solprices-desk` n'existe pas encore et reste réservé à `pre.003`.
|
|
|
|
Le bundle embarque les dix ressources correspondant au registry Config courant. `pre.003` ajoutera atomiquement le onzième document composite et synchronisera les resources des Desks concernés.
|
|
|
|
## Développement
|
|
|
|
Le cycle Tauri est crate-local :
|
|
|
|
```bash
|
|
(cd crates/ksp-app-solprices-desk && cargo tauri dev)
|
|
```
|
|
|
|
`-c/--config` n'est pas utilisé comme sélecteur d'application. En développement, le launcher normalise le current working directory vers la racine du workspace avant le bootstrap Config.
|
|
|
|
Le build production final sera exécuté dans le couloir de validation de la release :
|
|
|
|
```bash
|
|
(cd crates/ksp-app-solprices-desk && cargo tauri build)
|
|
```
|
|
|
|
`USAGE.md` sera finalisé lorsque l'application sera fonctionnellement complète, conformément au workflow de clôture des applications KSP.
|