5.3 KiB
ksp-app-store-desk
ksp-app-store-desk est l’application desktop spécialisée d’inspection read-only du Store KSP.
Elle reste une couche de composition Tauri : Config sélectionne le profil Store et Logging, ksp-store-lib possède la façade backend-neutral et les contrats d’inspection, et le backend physique reste entièrement masqué à l’application comme au frontend.
Package
package : ksp-app-store-desk
lib : ksp_app_store_desk_lib
bin : ksp-app-store-desk
Le binaire est un launcher mince. La bibliothèque applicative possède le bootstrap, le lifecycle Store, les DTOs Tauri, les commands, les projections de détail bornées et le bridge de tracing frontend.
Composition
ksp-config-lib -> composite, profils, secrets et runtime packagé
ksp-core-lib -> erreurs et primitives communes
ksp-store-lib -> façade Store backend-neutral et contrats RAW/inspection
ksp-logging-lib -> logging/tracing applicatif
ksp-app-store-desk -> orchestration Tauri + projections sûres read-only
L’application ne dépend pas directement de ksp-store-api, ksp-store-postgres-lib, tokio-postgres ou d’un autre backend physique. Elle ne possède aucun SQL.
Vues
La surface utilisateur comprend :
- Overview : état du runtime Store, health portable, réseau, backend logique, migration et compteurs de pool sûrs ;
- RAW Transactions : inspection DataTables server-side, filtres de slot et direction, état de rétention et détail explicite ;
- RAW Accounts : inspection DataTables server-side, filtre pubkey exact, plage de slots, direction et détail explicite ;
- Diagnostics : projection sûre du shell, de Config et du runtime Store.
Les détails Transaction et Account contiennent également leurs observations dans des DataTables server-side dédiées lorsque ces observations existent.
Pagination et inspection
Store Desk utilise la surface d’inspection random-access de ksp-store-lib : offset + limit avec counts exacts. DataTables est l’unique propriétaire de la pagination visible et les tailles admises sont 25, 50 et 100.
Cette voie d’inspection humaine ne remplace pas la pagination cursor/keyset du Store. Les workers, jobs et autres consumers machine peuvent continuer à utiliser RawPageCursor / RawPageRequest; Store Desk ne consomme pas ces cursors.
Le frontend conserve draw localement et ne transmet ni search globale DataTables, ni ordre de colonnes arbitraire, ni cursor, ni réseau physique au Store.
Rows, détails et observations
Les rows de table ne transportent jamais les bytes RAW complets :
- Transaction : identité, slot, format, hash, taille éventuelle et état de rétention ;
- Account : pubkey, slot, state hash, owner, lamports, executable, rent epoch et longueur de data ;
- Observation : provenance d’acquisition sûre et metadata bornées, sans source payload bytes.
Un détail est chargé explicitement pour une seule entité. Les previews payload Transaction et data Account sont limitées à 512 bytes, rendues en hexadécimal et accompagnées de la taille exacte et d’un indicateur de troncature.
Pour une Transaction, les états Full, Archived et Purged restent distincts. Un état Purged est représenté via son tombstone ; Store Desk n’offre aucune action d’archive, purge ou force-rehydrate.
Valeurs longues et copie
Les signatures, hashes, pubkeys, owners et autres identifiants longs sont tronqués visuellement au centre tout en restant disponibles via tooltip et bouton de copie. La copie n’ajoute aucune capability Tauri : elle utilise le WebView et le tracing ne transporte que l’identifiant logique du champ, jamais la valeur copiée.
Config et réseaux
Le composite dédié est :
cfg.composite.ksp-app-store-desk
Les profils committed couvrent mainnet, devnet et testnet. Mainnet est le profil par défaut. Le composite contient uniquement Logging + Store ; aucun Transport n’est ouvert par l’application.
Le frontend ne reçoit jamais URI Store, credential, secret Config, SQL, handle pool ou type backend physique.
Sécurité et ownership
Store Desk est read-only par contrat applicatif : aucun command Tauri d’écriture Store n’est exposé. Les capabilities guest restent limitées à core:default et tracing:default.
Le frontend ne possède ni accès réseau navigateur direct, ni persistence navigateur des données RAW, ni accès filesystem, ni dialogue natif pour contourner les façades KSP.
Les comptes et counts u64 susceptibles d’excéder le domaine entier sûr JavaScript traversent IPC sous forme décimale et sont vérifiés avant conversion côté TypeScript.
Ports et développement
Vite HTTP : 1438
Vite WS : 1439
Lancement :
(cd crates/ksp-app-store-desk && cargo tauri dev)
Build production :
(cd crates/ksp-app-store-desk && cargo tauri build)
Voir également USAGE.md, ../ksp-store-lib/README.md, ../../docs/architecture/008-DATA_MATERIALIZATION_AND_STORE.md et ../../docs/validation/025-V0_3_8_STORE_DESK.md.