Guide utilisateur — Console web & application mobile terminal agence. Gestion des colis, voyages, encaissements et retraits.
BAGAGEXPRESS relie deux interfaces complémentaires : la console web pour la supervision, l'encaissement et l'administration, et l'application mobile pour les opérations de terrain (enregistrement colis, scan, retrait, chargement bus).
Tableau de bord modulaire, encaissement des tickets générés sur mobile, gestion des voyages, alertes, référentiels (agences, flotte, tarifs, utilisateurs).
Utilisée au guichet, au quai et au point de retrait. Fonctionne en ligne ou hors-ligne avec synchronisation automatique.
| RĂ´le | Web | Mobile |
|---|---|---|
| Administrateur | Tous les modules + utilisateurs | Config. terminaux, agences |
| Agent guichet | Encaisser, colis, alertes | Nouveau colis, scan |
| Agent quai | Voyages, manifestes | Scanner chargement / arrivée |
| Agent retrait | Retraits web | Remise colis + code SMS |
| Chef d'agence | Pilotage complet agence | Supervision terrain |
À la première mise en production, l'administrateur (admin@bagagexpress.ci) doit configurer le référentiel avant que les agents puissent travailler.
Ouvrez la console, saisissez l'e-mail et le mot de passe administrateur. Vous arrivez sur le tableau de bord modules.
Menu Agences : vérifiez le réseau (ville, code, statut actif). Ajoutez les points de service manquants.
Onglet Terminaux dans Agences (web) ou Agences & terminaux sur mobile (profil admin). Chaque tablette téléphone = 1 terminal lié à 1 agence.
Menu Flotte : ajoutez les véhicules (cars) et les itinéraires entre agences (origine → destination, escales).
Menu Tarifs : grille par trajet, catégorie de colis (Carton, Sac, Valise, Document), poids et prix au kg.
Menu Utilisateurs : un compte par agent avec son rôle (Guichet, Quai, Retrait, Chef…) et son agence d'affectation.
Sur l'app mobile : écran de connexion → touchez le champ Terminal → authentification admin → sélectionnez le POS dans la liste. Sans terminal configuré, la connexion agent est bloquée.
Menu Voyages : créez les départs du jour (véhicule, trajet, heure). Les agents pourront y affecter les colis payés.
Depuis le tableau de bord, choisissez un module. La barre supérieure permet de rechercher un colis (Ctrl+K), changer d'agence et se déconnecter.
Valide le paiement d'un colis enregistré sur mobile. Le client présente le QR code / numéro de ticket. Choisissez le mode (Espèces, Wave, Orange, MTN, Moov, Port dû).
Remise d'un colis au destinataire depuis le web : vérification du code de retrait (6 caractères), pièce d'identité, photo preuve.
Planifiez les départs, affectez les colis payés, figez le manifeste et suivez les voyages en cours ou arrivés.
Registre complet : recherche, filtres par statut, détail colis (suivi, expéditeur, destinataire, code retrait, QR).
Colis non retirés, litiges, écarts de manifeste, codes erronés. Le badge affiche le nombre d'alertes ouvertes (données API).
RĂ©seau d'agences + onglet Terminaux (POS par agence).
Véhicules (cars) et itinéraires inter-agences.
Grille tarifaire par trajet et catégorie.
Comptes agents, rĂ´les et permissions (RBAC).
L'application est organisée autour d'une barre d'onglets et d'un bouton central Scanner.
Vue d'ensemble : agence, terminal, statut réseau (en ligne / hors-ligne), statistiques du jour. Raccourcis : Nouveau colis, Scanner, Retrait, Voyages. Liste des tâches à traiter.
Liste filtrable : Tous, À payer, À envoyer, En route, À retirer. Touchez un colis pour voir le détail et l'historique.
Voyages en route, planifiés et arrivés. Ouvrez un voyage pour charger des colis (scan) ou consulter le manifeste.
Agence, point de service, terminal. Historique des transactions. DĂ©connexion. (Admin : Agences & terminaux.)
Scan QR / code-barres pour charger un colis sur un voyage, enregistrer une arrivée ou identifier un colis.
File d'attente des opérations hors-ligne. Relance manuelle ou automatique au retour réseau.
Un colis traverse les statuts suivants, visibles dans les listes web et mobile.
| Statut | Signification | Qui agit ? |
|---|---|---|
| Enregistré | Colis créé sur mobile, en attente de paiement | Agent guichet (mobile) |
| Affecté | Payé et assigné à un voyage | Web encaissement + voyages |
| En transit | Chargé dans le bus, manifeste figé | Agent quai (scan) |
| Arrivé / Notifié | Colis à destination, SMS envoyé au destinataire | Système + agent quai |
| Retiré | Remis au destinataire avec code + pièce d'identité | Agent retrait |
| Non retiré / Litige | Délai dépassé ou incident | Alertes web |
Scénario type d'un envoi Abidjan → Bouaké.
Nouveau colis en 4 Ă©tapes :
Génération du ticket QR : code suivi (ex. BX-ABJ-…), montant, statut En attente de paiement.
Le client se présente au guichet avec le ticket. Menu Encaisser : scan ou saisie du code, validation du montant et du mode de paiement. Le colis passe en payé et peut être affecté à un voyage.
Web — Voyages : affecter le colis au départ prévu, figer le manifeste.
Mobile — Scanner ou détail voyage : scan QR de chaque colis au chargement. Statut → En transit.
À l'agence d'arrivée, l'agent quai scanne les colis (arrivée). Statut → Arrivé puis Notifié : le destinataire reçoit un SMS avec le code de retrait (6 caractères alphanumériques).
Menu Retrait :
| Étape | Interface | Agent |
|---|---|---|
| Création colis + ticket | 📱 Mobile | Guichet |
| Paiement | 🖥️ Web — Encaisser | Guichet |
| Planifier voyage / manifeste | 🖥️ Web — Voyages | Chef / Quai |
| Charger le bus | 📱 Scanner | Quai |
| Arrivée & notification | 📱 Scanner | Quai destination |
| Remise au destinataire | 📱 ou 🖥️ Retrait | Retrait |