FAQ¶
Comment le technicien se connecte-t-il ?¶
Le technicien ouvre l'application et se connecte avec ses identifiants employé (nom d'utilisateur et mot de passe). Cela garantit que chaque échange est lié à un technicien autorisé.
Que faire si le QR code du client ne scanne pas ?¶
Passez au secours Saisir l'ID d'Abonnement. Le technicien peut saisir manuellement l'ID d'abonnement du client. Si l'abonnement n'est toujours pas trouvé, vérifiez l'ID avec le client.
Comment l'application lit-elle la batterie ?¶
L'application scanne le QR code de la batterie pour l'identifier, puis se connecte via Bluetooth Low Energy (BLE). Elle lit deux services :
- Service ATT — fournit l'ID de la batterie
- Service DTA — fournit l'énergie restante (kWh)
Que faire si la connexion Bluetooth échoue ?¶
Assurez-vous que Bluetooth est activé sur l'appareil du technicien et que la batterie est à portée. Réessayez la connexion. Si le problème persiste, redémarrez l'application ou essayez une autre batterie.
Comment le coût de l'échange est-il calculé ?¶
La formule de coût est :
energy_difference = floor(new_energy - old_energy, 2)
net_energy = energy_difference - quota_remaining
cost = net_energy × rate_per_kWh
La différence d'énergie est arrondie à l'inférieur à 2 décimales. Le quota prépayé du client est soustrait avant d'appliquer le tarif par kWh.
Que se passe-t-il si le quota du client couvre le coût total ?¶
Si le quota couvre toute la différence d'énergie, le montant net dû est zéro. Le technicien peut compléter l'échange directement — l'Étape 5 (Paiement) est ignorée et le flux passe directement à l'Étape 6 (Terminé).
Quelles méthodes de paiement sont prises en charge ?¶
Le paiement est encaissé via M-Pesa en utilisant l'une des deux méthodes :
- Scanner le QR code — le technicien scanne le QR de paiement M-Pesa du client
- Saisir le reçu manuellement — le technicien tape le code de confirmation M-Pesa
Comment les transactions sont-elles signalées au backend ?¶
Après confirmation du paiement (ou ignoré en raison du quota), l'application envoie deux messages MQTT au backend :
- Un événement de paiement avec le montant, le code de reçu et l'horodatage
- Un événement de service avec les détails de l'échange de batteries (ancienne batterie, nouvelle batterie, énergie, abonnement client)
Le technicien peut-il revenir en arrière pour corriger une erreur ?¶
Oui. Utilisez le bouton Retour à n'importe quelle étape pour revenir à l'étape précédente. Les sélections et les lectures sont préservées jusqu'à ce qu'elles soient modifiées.
Le flux fonctionne-t-il hors ligne ?¶
Le scan de batteries BLE et les lectures d'énergie fonctionnent sans Internet. Cependant, la recherche du client (Étape 1) et le signalement du paiement/MQTT (Étape 5) nécessitent une connectivité réseau.
Le technicien peut-il démarrer un autre échange immédiatement ?¶
Oui. Après avoir complété un échange à l'Étape 6 (Terminé), le technicien appuie sur Nouvel Échange pour retourner à l'Étape 1 et commencer une nouvelle transaction.