Différences

Ci-dessous, les différences entre deux révisions de la page.

--- changes:cynodbo:july-2025-3.8.6_rc6 [2025/07/14 18:32]
mactar.ba créée
+++ changes:cynodbo:july-2025-3.8.6_rc6 [2025/07/14 22:15] (Version actuelle)
mactar.ba
@@ Ligne 1: / Ligne 1: @@
 ====== Release Note - CYNOD - Juillet 2025 (version 3.8.6_RC6) ======
-Cette version apporte des corrections critiques liées à la gestion des transactions en conditions dégradées (perte de réseau, plantage, coupure avant mise à jour carte) dans l’application mobile CYNOD.
+Cette version améliore la robustesse du traitement des ventes en conditions réseau instables. Elle introduit des fonctionnalités permettant de mieux gérer les opérations non confirmées, de limiter les relances inutiles et d’améliorer la lisibilité côté utilisateur.
 ===== Application mobile =====
 ==== Cynod FO v3.1.63 ====
-  - **Workflow de gestion des opérations douteuses**
+  - **Workflow de gestion des opérations douteuses (en attente)**
-    * Détection automatique des transactions sans retour serveur avec un timeout de 5s
+    * Détection automatique des transactions sans retour serveur après 5s.
-    * Blocage temporaire des nouvelles ventes tant qu’une opération douteuse n’est pas traitée.
+    * Blocage temporaire des ventes tant que l’opération douteuse n’est pas régularisée.
-    * Page dédiée avec :
+    * Page dédiée pour :
-      * Vérification du statut (check status)
+      * vérifier le statut de l’opération
-      * Option d’annulation manuelle
+      * annuler manuellement si nécessaire
-      * Enregistrement du motif, de l’auteur et de la date d’annulation
+      * consigner les motifs, auteurs et dates d’annulation lors de la synchronisation
   - **Optimisation des messages écran**
-    * Affichage contextuel selon le type d’échec ou de rejet : solde insuffisant, réseau instable, erreur serveur, etc.
+    * Affichage contextuel selon la situation actuelle : solde insuffisant, réseau instable, erreur serveur, etc.
   - **Traitement des transactions hybrides**
-    * Meilleure gestion des opérations commencées online et terminées offline.
+    * Meilleure gestion des opérations démarrées online et finalisées offline.
-    * Vérification post-synchro et régularisation automatique si nécessaire.
+    * Synchronisation automatique dès retour réseau.
   - **Revue du journal FO**
-    * Corrections sur l’ordre d’affichage des transactions.
+    * Mise à jour fiable même après crash ou fermeture inattendue.
-    * Mise à jour assurée même en cas de crash ou fermeture inattendue.
+    * Affichage ordonné et marquage clair des transactions offline.
-    * Marquage explicite des transactions offline.
 ===== Application web BO v3.8.6_RC65 =====
@@ Ligne 37: / Ligne 36: @@
 | --------- | ------------------------------------------ | -------- |
 | FO        | Gestion des opérations douteuses           | Ajouté   |
-| FO        | Blocage temporaire des ventes              | Ajouté   |
+| FO        | Blocage intelligent des ventes             | Ajouté   |
-| FO        | Affichage messages d’erreur contextualisés | Amélioré |
+| FO        | Messages d’erreur explicites               | Amélioré |
+| FO        | Reprise fiable après interruption          | Corrigé  |
 | FO        | Synchronisation post-crash                 | Corrigé  |
-| BO        | Rejet contrôlé des duplications            | Amélioré |
+| BO        | Détection et rejet des doublons            | Amélioré |
-| BO        | Enregistrement des annulations non initiées par la système            | Ajouté   |
+| BO        | Historisation complète des annulations utilisateur            | Ajouté   |
+----
+===== Guide Utilisateur - Transactions en conditions dégradées =====
+Ce guide vous aide à gérer les situations liées à des coupures réseau, à des timeout serveur ou à une interruption inattendue pendant une vente. Suivez les étapes décrites dans chaque scénario pour sécuriser vos opérations et éviter les doublons.
+==== Cas d’usage ====
+=== 1. Gérer une opération douteuse ===
+Une transaction a été envoyée au serveur mais n’a pas reçu de réponse dans le délai imparti (5 secondes). Le terminal ne peut pas passer en mode offline.
+**Message affiché :**
+"Délai d'attente dépassé. Vérifiez votre connexion internet puis vérifiez le statut de l'opération depuis le journal."
+Étapes à suivre :
+  - Touchez Opérations douteuses (la seule page accessible).
+  - Appuyez sur Vérifier pour connaître le statut de la transaction.
+  - Si elle n’existe pas ou a échoué, elle est annulée automatiquement.
+  - Si elle est validée, une confirmation s’affiche.
+> Tant qu’une opération douteuse est détectée, aucune autre vente ne peut être effectuée. Vous pouvez choisir d’annuler manuellement l’opération. Elle sera synchronisée au serveur pour traitement, même si elle avait été validée côté BO.
+=== 2. Débloquer une vente bloquée par une opération en attente ===
+Une opération douteuse est encore en attente de régularisation. Toute tentative de vente affiche un blocage.
+**Étapes à suivre :**
+  - Touchez Opérations douteuses.
+  - Vérifiez ou annulez l’opération signalée.
+  - Une fois l’opération traitée, les ventes peuvent reprendre normalement.
+=== 3. Gérer une transaction hybride (online → offline) ===
+Une vente a commencé en ligne mais a été finalisée en mode offline suite à une perte de connexion.
+**Comportement observé :**
+  * La transaction est sauvegardée localement.
+  * Elle sera synchronisée automatiquement dès que la connexion est rétablie.
+**Étapes à suivre :**
+  - Ne relancez pas la vente.
+  - Attendez la synchronisation ou accédez à Divers > Synchroniser.
+  - Vérifiez le journal FO pour confirmation.
+  - En cas de doute, comparez avec le reçu imprimé ou contactez le support.
+=== 4. Régulariser après une fermeture inattendue ===
+L’application s’est fermée ou le terminal s’est éteint avant que la carte soit mise à jour.
+**Étapes à suivre :**
+  - Redémarrez l’application.
+  - Une alerte vous informe :
+    * si l’opération a bien été enregistrée (retour serveur reçu)
+    * ou si elle a échoué (aucune réponse serveur)
+  - Accédez à Opérations douteuses pour finaliser ou annuler.
+==== Foire aux questions (FAQ) ====
+**Q: Comment retrouver une vente manquante dans le journal ?**Consultez la page Opérations douteuses. L’opération a pu être interrompue et est en attente de régularisation.
+**Q: Comment savoir si une transaction a été acceptée ?**Dans la page Opérations douteuses, utilisez Vérifier le statut. Vous pouvez aussi consulter le journal FO : une transaction acceptée y apparaît comme Validée.
+**Q: Pourquoi je ne peux pas lancer une nouvelle vente ?**Le TPE a détecté une transaction non finalisée. Régularisez-la depuis la page Opérations douteuses avant toute nouvelle vente.
 ----