v0.1.0-pre.075

docs/guides/DEVNET_0_4_6_OPERATOR_GUIDE.md

@@ -0,0 +1,99 @@
+<!-- file: docs/guides/DEVNET_0_4_6_OPERATOR_GUIDE.md -->
+<!-- version: 1 -->
+
+# Guide opérateur Devnet pour l’alignement `0.4.6`
+
+## 1. Objectif
+
+Ce guide regroupe les opérations minimales à valider avant le passage officiel de bot3 à `0.4.6`.
+
+## 2. Préparer le profil
+
+- sélectionner un profil Devnet valide ;
+- vérifier le RPC HTTP, le WebSocket et PostgreSQL ;
+- vérifier que `auto_initialize_schema` correspond à l’intention de la campagne ;
+- utiliser un wallet de démonstration persistant et financé par faucet Web.
+
+La clé privée ne doit jamais être copiée dans les logs ou l’interface.
+
+## 3. Vérifier PostgreSQL
+
+Depuis les fenêtres SQL :
+
+1. charger le diagnostic général ;
+2. vérifier les tables raw ;
+3. vérifier les tables Core ;
+4. vérifier les tables decode/materialization ;
+5. noter la version de migration et les anomalies d’index ou contraintes.
+
+## 4. Campagne raw → Core → Decode → Materialize
+
+1. Exécuter un backfill borné sur un Program ID ou une adresse connue.
+2. Vérifier l’insertion raw et les observations.
+3. Exécuter Core extraction sur les nouvelles lignes.
+4. Exécuter Decode replay avec les décodeurs adaptés.
+5. Activer la matérialisation.
+6. Vérifier les diagnostics et projections.
+7. Rejouer la même sélection.
+8. Confirmer l’idempotence et l’absence de duplications.
+
+## 5. Exécution Solana Core
+
+Pour System Transfer :
+
+- vérifier le wallet et la balance ;
+- générer ou saisir un destinataire ;
+- utiliser un montant minimal ;
+- exécuter d’abord la simulation ;
+- confirmer explicitement l’envoi ;
+- vérifier la signature finalisée ;
+- effectuer backfill, Core extraction et replay ;
+- vérifier les observations et projections attendues.
+
+## 6. Exécution SPL
+
+Valider séparément :
+
+- Memo v4 ;
+- ATA classique ;
+- ATA Token-2022 ;
+- SPL Token classique `TransferChecked` ;
+- opérations Token-2022 documentées comme supportées.
+
+Pour chaque scénario :
+
+1. vérifier les préconditions et comptes ;
+2. vérifier les signers ;
+3. simuler ;
+4. confirmer l’envoi ;
+5. vérifier la confirmation réseau ;
+6. effectuer le backfill ;
+7. effectuer Core extraction ;
+8. effectuer Decode replay et matérialisation ;
+9. rejouer pour l’idempotence ;
+10. vérifier l’état final via CLI ou RPC lorsque pertinent.
+
+## 7. WebSocket
+
+Exécuter intégralement [`WEBSOCKET_LIFECYCLE_VALIDATION_SCENARIO.md`](../validation/WEBSOCKET_LIFECYCLE_VALIDATION_SCENARIO.md).
+
+## 8. Résultats à consigner
+
+Pour chaque campagne, conserver :
+
+- profil et cluster ;
+- opération ;
+- comptes publics concernés ;
+- signature ;
+- résultat simulation ;
+- résultat envoi et confirmation ;
+- nombres raw/Core/decode/materialize ;
+- diagnostics ;
+- résultat du second replay ;
+- commande CLI ou RPC de vérification finale.
+
+## 9. Hors périmètre
+
+Metaplex Token Metadata complet n’est pas un critère de `0.4.6`. Il sera planifié et terminé dans `0.4.7`.
+
+Le registre ElGamal reste conditionnel tant que son déploiement réseau et les preuves nécessaires ne sont pas confirmés.