v0.4.6

olddocs/archivekbot3/docs/validation/WEBSOCKET_LIFECYCLE_VALIDATION_SCENARIO.md

@@ -0,0 +1,116 @@
+<!-- file: docs/validation/WEBSOCKET_LIFECYCLE_VALIDATION_SCENARIO.md -->
+<!-- version: 2 -->
+
+# Validation du cycle de vie WebSocket desktop
+
+## Objectif
+
+Prouver qu’une session WebSocket appartient à l’application et non à la fenêtre `demo_ws`.
+
+## Préparation
+
+1. Configurer un endpoint WebSocket Devnet dans le profil utilisé.
+2. Activer une route de logs contenant au minimum `kb-app-demo-desktop` et `kb-onchain-transport` au niveau `debug`.
+3. Lancer :
+
+```bash
+cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json 2>&1 | tee /tmp/kbot3-pre075-ws.log
+```
+
+4. Ouvrir la fenêtre **WebSocket standard**.
+5. Rafraîchir les endpoints et vérifier qu’un rôle compatible est disponible.
+
+## Souscription principale recommandée
+
+Utiliser `logsSubscribe`, car elle permet de filtrer les transactions mentionnant un Program ID.
+
+| Champ       | Valeur                                                         |
+|-------------|----------------------------------------------------------------|
+| Rôle        | rôle WebSocket standard Devnet disponible                      |
+| Méthode     | `logsSubscribe`                                                |
+| Target      | vide                                                           |
+| Filter JSON | `{"mentions":["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]}` |
+| Config JSON | `{"commitment":"confirmed"}`                                   |
+
+Le Program ID choisi est SPL Token classique. Il peut être remplacé par Token-2022 :
+
+```text
+TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
+```
+
+## Scénario A — fermeture et réouverture de la fenêtre
+
+1. Cliquer **Souscrire**.
+2. Noter l’identifiant de subscription et vérifier :
+   - statut connecté ;
+   - `subscriptionCount = 1` ;
+   - méthode `logsSubscribe`.
+3. Attendre au moins une notification ou, à défaut, conserver la réponse de subscription.
+4. Fermer uniquement la fenêtre `demo_ws` avec le bouton de la fenêtre.
+5. Ne pas cliquer sur **Unsubscribe** ni **Déconnecter socket**.
+6. Attendre 15 à 30 secondes.
+7. Rouvrir **WebSocket standard** depuis le menu principal.
+8. Vérifier immédiatement :
+   - statut connecté ;
+   - même endpoint ;
+   - subscription toujours présente ;
+   - même identifiant distant ou identifiant remappé explicitement après reconnexion ;
+   - nouveaux messages reçus si le réseau en produit.
+
+### Critère de réussite
+
+La fenêtre restaurée affiche l’état réel de la session persistante. Aucun événement `Disconnected` ne doit être provoqué par la fermeture de `demo_ws`.
+
+## Scénario B — unsubscribe explicite
+
+1. Sélectionner la subscription active.
+2. Cliquer **Unsubscribe sélectionnée**.
+3. Vérifier :
+   - `subscriptionCount = 0` ;
+   - socket encore connectée ;
+   - message de désinscription ;
+   - absence de nouvelles notifications pour cette subscription.
+
+## Scénario C — nouvelle subscription puis déconnexion explicite
+
+1. Souscrire de nouveau avec le même filtre.
+2. Vérifier `subscriptionCount = 1`.
+3. Cliquer **Déconnecter socket**.
+4. Vérifier :
+   - statut déconnecté ;
+   - aucune subscription active ;
+   - événement ou diagnostic de déconnexion dans les logs.
+
+## Scénario D — arrêt global de l’application
+
+1. Souscrire de nouveau.
+2. Fermer la fenêtre `demo_ws`.
+3. Fermer ensuite la fenêtre principale de l’application.
+4. Vérifier dans `/tmp/kbot3-pre075-ws.log` que la déconnexion globale est exécutée.
+5. Vérifier que le processus Tauri se termine sans rester en arrière-plan.
+
+## Scénario optionnel — `programSubscribe`
+
+Pour observer les changements de comptes appartenant à Token-2022 :
+
+| Champ       | Valeur                                           |
+|-------------|--------------------------------------------------|
+| Méthode     | `programSubscribe`                               |
+| Target      | `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb`    |
+| Filter JSON | vide                                             |
+| Config JSON | `{"commitment":"confirmed","encoding":"base64"}` |
+
+Cette souscription peut être très active. Les limites de débit et de taille de l’interface doivent rester fonctionnelles.
+
+## Preuves à archiver
+
+Fournir une archive contenant :
+
+- `/tmp/kbot3-pre075-ws.log` ;
+- copie du statut avant fermeture ;
+- copie du statut après réouverture ;
+- identifiants de subscription ;
+- résultat unsubscribe ;
+- résultat disconnect ;
+- heure approximative de chaque étape ;
+- anomalie éventuelle et reproduction minimale.