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 19:24]
mactar.ba
+++ 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é   |
 ----
-===== MAJ Guide Utilisateur - Transactions en conditions dégradées =====
+===== Guide Utilisateur - Transactions en conditions dégradées =====
-Ce guide vous accompagne dans la gestion des situations exceptionnelles liées aux coupures réseau, timeout ou interruptions pendant la vente. Il décrit les cas les plus fréquents et la manière d’y réagir.
+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 de figure ====
+==== Cas d’usage ====
+=== 1. Gérer une opération douteuse ===
-=== 1. 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.
-**Contexte :** Une transaction a été initiée en ligne, mais aucune réponse n’a été reçue du serveur (timeout de 5 secondes). Elle ne peut pas basculer 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."
-**Message :** "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.
-**Ce que vous devez faire :**
+> 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.
-  - Accédez à la page "Opérations douteuses" qui sera la seule page accessible.
-  - Cliquez sur "Vérifier" pour confirmer si la transaction a été validée.
-  - Si elle est en échec ou n'existe pas, le système procède à l'annulation automatique.
-  - Si elle est validée, le système vous confirme l'opération.
-À noter que tant que le terminal détecte une opération douteuse, l'utilisateur ne pourra plus exploiter les fonctions du TPE. L'utilisateur peut à tout moment annuler l'opération, laquelle sera ensuite synchronisée au serveur pour des vérifications et mises à jour de la piste d'audit. Si l'opération a été validée au niveau du serveur, cette dernière sera annulée avec les informations provenant du TPE.
+=== 2. Débloquer une vente bloquée par une opération en attente ===
-=== 2. Blocage de nouvelle vente ===
+Une opération douteuse est encore en attente de régularisation. Toute tentative de vente affiche un blocage.
-**Contexte :** Une opération douteuse n’a pas encore été régularisée. En essayant d'exploiter le TPE, une alerte vous signalera qu’une opération est en attente.
+**É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.
-**Ce que vous devez faire :**
+=== 3. Gérer une transaction hybride (online → offline) ===
-  -  Accédez à la page des opérations douteuses.
-  - Vérifiez ou annulez la transaction en attente.
-  - Une fois l'opération traitée, vous pouvez reprendre la vente.
-=== 3. Transaction hybride ===
+Une vente a commencé en ligne mais a été finalisée en mode offline suite à une perte de connexion.
-**Contexte :** Une vente a été lancée en ligne mais finalisée en offline suite à une coupure réseau.
+**Comportement observé :**
+  * La transaction est sauvegardée localement.
+  * Elle sera synchronisée automatiquement dès que la connexion est rétablie.
-**Comportement :**
+**Étapes à suivre :**
-  * La transaction est enregistrée localement.
+  - Ne relancez pas la vente.
-  * Elle sera synchronisée automatiquement lorsque la connexion sera rétablie. Si l'opération a déjà été validée au niveau serveur, les informations sur le solde et les cumuls offline seront mises à jour.
+  - 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.
-**Ce que vous devez faire :**
+=== 4. Régulariser après une fermeture inattendue ===
-  - Ne relancez pas la vente. Les informations figurent dans le journal FO.
-  - Vérifiez le statut de synchronisation des opérations offline depuis le journal FO une fois la connexion rétablie, ou initiez la synchronisation depuis le menu Divers.
-  - En cas de doute, comparez le journal FO avec le dernier reçu ou demandez une assistance.
-=== 4. Fermeture inattendue pendant la vente ===
+L’application s’est fermée ou le terminal s’est éteint avant que la carte soit mise à jour.
-**Contexte :** L’application s’est fermée ou le terminal a redémarré avant la mise à jour carte.
+**Étapes à suivre :**
-**Ce que vous devez faire :**
+  - Redémarrez l’application.
-  - Relancez l’application.
+  - Une alerte vous informe :
-  - Une alerte vous signalera :
+    * si l’opération a bien été enregistrée (retour serveur reçu)
-    * que l’opération précédente a bien été enregistrée si le retour serveur a eu lieu (juste avant la mise à jour carte),
+    * ou si elle a échoué (aucune réponse serveur)
-    * ou que l’opération a échoué si aucune réponse n’a été reçue (l'opération a été initiée en offline et la mise à jour de la carte a échouée ou ne s'est pas faite.
+  - Accédez à Opérations douteuses pour finaliser ou annuler.
-  - Accédez à la page des opérations douteuses pour la régulariser.
-==== FAQ ====
+==== Foire aux questions (FAQ) ====
-**Q : Que faire si je ne retrouve pas une vente dans le journal ?**
+**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.
-Rendez-vous dans la page "Opérations douteuses". Il est possible qu’une transaction soit en attente de confirmation ou ait été annulée.
-**Q : Comment savoir si une transaction a été acceptée ?**
+**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.
-Utilisez la fonction "Vérifier le statut" dans la page des opérations douteuses ou vérifiez dans le journal si elle est visible avec l’état "Validée".
-**Q : Pourquoi je ne peux pas lancer une nouvelle vente ?**
+**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.
-Le terminal a détecté une opération non finalisée. Vous devez d’abord la régulariser depuis la page des opérations douteuses.
 ----