Guide utilisateur — BAGAGEXPRESS

Présentation & rôles

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. Le parcourt type sépare souvent l'enregistrement du colis (agent avec droit « Nouveau colis ») et l'encaissement (agent de caisse / guichet).

Console web

🖥️ bagage.savoir.ci

Tableau de bord modulaire, encaissement des tickets, gestion des voyages, alertes, référentiels (agences, flotte, tarifs, utilisateurs, terminaux).

API : https://apibagagexpress.savoir.ci/api/v1

Mobile terminal

📱 Application agent

Utilisée au guichet (caisse), au poste d'enregistrement, au quai et au point de retrait. Fonctionne en ligne ou hors-ligne avec synchronisation automatique.

Rôles principaux

Rôle	Web	Mobile
Administrateur	Tous les modules + utilisateurs + terminaux	Enregistrement, encaissement, scan, voyages, agences & terminaux
Chef d'agence	Pilotage agence, encaissement, voyages, colis	Nouveau colis, encaissement, scan, voyages (gestion)
Agent guichet (caisse)	Encaisser, consulter colis, retraits	Encaisser uniquement + consultation colis/voyages (lecture seule)
Agent d'enregistrement	Nouveau colis (secours web)	Nouveau colis → ticket QR « paiement au guichet » (chef ou admin mobile)
Agent quai	Voyages, manifestes	Scanner chargement / arrivée, affectation colis
Agent retrait	Retraits web	Remise colis + code SMS + pièce d'identité
Direction	Tableaux de bord, rapports	Consultation colis et voyages

💡 Séparation des tâches : sur mobile, le rôle GUICHET (agent de caisse) n'enregistre pas de colis. Il encaisse les tickets produits par un autre agent (chef d'agence ou administrateur). Compte démo caisse : guichet@bagagexpress.ci / demo123.

Démarrage administrateur

À la première mise en production, l'administrateur (admin@bagagexpress.ci) doit configurer le référentiel avant que les agents puissent travailler.

1
Se connecter à la console web
Ouvrez la console, saisissez l'e-mail et le mot de passe administrateur. Vous arrivez sur le tableau de bord modules.
2
Créer les agences
Menu Agences : vérifiez le réseau (ville, code, statut actif). Ajoutez les points de service manquants.
3
Enregistrer les terminaux (POS)
Onglet Terminaux dans Agences (web) ou Agences & terminaux sur mobile (profil admin). Chaque tablette téléphone = 1 terminal lié à 1 agence.
4
Configurer la flotte & les trajets
Menu Flotte : ajoutez les véhicules (cars) et les itinéraires entre agences (origine → destination, escales).
5
Définir les tarifs
Menu Tarifs : grille par trajet, catégorie de colis (Carton, Sac, Valise, Document), poids et prix au kg.
6
Créer les comptes agents
Menu Utilisateurs : un compte par agent avec son rôle (Guichet, Quai, Retrait, Chef…) et son agence d'affectation.
7
Configurer chaque terminal mobile
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.
8
Planifier les voyages
Menu Voyages : créez les départs du jour (véhicule, trajet, heure). Les agents pourront y affecter les colis payés.

💡 Conseil : configurez d'abord agences → terminaux → utilisateurs, puis tarifs et flotte. Testez le parcours complet : enregistrement mobile (chef/admin) → encaissement mobile ou web (guichet) → chargement → retrait, avant la mise en service.

Application web — menus

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.

Actions du guichet

Encaisser

Valide le paiement d'un colis déjà enregistré (statut En attente de paiement). Le client présente le ticket QR ou le code suivi. Saisie du code, choix du mode (Espèces, Wave, Orange, MTN, Moov) et validation. Historique des transactions et sessions de caisse.

Retrait

Remise d'un colis au destinataire depuis le web : vérification du code de retrait (6 caractères), pièce d'identité, photo preuve.

Voyages

Planifiez les départs, affectez les colis payés, figez le manifeste et suivez les voyages en cours ou arrivés.

Colis

Registre complet : recherche par code suivi ou code de retrait (Ctrl+K), filtres par statut, détail colis (suivi, expéditeur, destinataire, code retrait, QR).

Administration

Alertes

Colis non retirés, litiges, écarts de manifeste, codes erronés. Le badge affiche le nombre d'alertes ouvertes (données API).

Agences

Réseau d'agences + onglet Terminaux (POS par agence).

Flotte

Véhicules (cars) et itinéraires inter-agences.

Tarifs

Grille tarifaire par trajet et catégorie.

Utilisateurs

Comptes agents, rôles et permissions (RBAC).

Nouveau colis (web) existe en secours via /parcels/new mais le parcours normal d'enregistrement se fait sur mobile.

Application mobile — menus

L'interface s'adapte au rôle de l'agent. La barre d'onglets (Accueil, Colis, Voyages, Profil) est commune ; le bouton central change : Scanner pour les agents quai/chef/admin, Encaisser pour l'agent de caisse (GUICHET).

Agent de caisse (GUICHET)

Écran principal

💰 Encaisser

À la connexion, l'agent arrive directement sur /cash. Identification du colis par saisie du code (suivi ou retrait) ou scan du QR du ticket. Puis choix du mode de paiement et impression du reçu.

Consultation

📦 Colis & 🚌 Voyages

Liste et détail en lecture seule : pas de création, modification, affectation ni scan. Permet de vérifier un colis ou un voyage avant encaissement.

Bouton central

💵 FAB Encaisser

Raccourci vert vers l'écran d'encaissement depuis n'importe quel onglet.

Profil

👤 Terminal & synchro

Agence, terminal POS, historique, déconnexion. Accès à la file de synchronisation hors-ligne.

Autres agents (chef, quai, retrait, admin)

Onglet

🏠 Accueil

Vue d'ensemble : agence, terminal, statut réseau (en ligne / hors-ligne), statistiques du jour. Raccourcis selon le rôle : Nouveau colis, Scanner, Retrait, Voyages, Encaisser.

Onglet

📦 Colis

Liste filtrable : Tous, À payer, À envoyer, En route, À retirer. Recherche par code suivi ou code retrait. Bouton Nouveau colis si autorisé.

Onglet

🚌 Voyages

Voyages en route, planifiés et arrivés. Manifeste, chargement par scan (agents quai/chef).

Bouton central

📷 Scanner

Scan QR / code-barres : chargement bus, arrivée, retrait sécurisé, identification colis. Caméra au démarrage ; saisie manuelle possible.

Écran

➕ Nouveau colis

Enregistrement en 4 étapes (colis, expéditeur, destinataire, photos). Génère un ticket QR avec paiement différé — le client se présente ensuite à la caisse.

Écran

🔄 Synchronisation

File d'attente des opérations hors-ligne. Relance manuelle ou automatique au retour réseau.

Connexion & terminal

Saisissez e-mail et mot de passe agent.
Le terminal (POS) doit être configuré par l'admin avant la première connexion.
L'agent GUICHET est redirigé vers l'écran Encaisser après connexion.
En mode démo local, un sélecteur de rôle peut apparaître ; en production, le rôle vient du compte serveur.

Parcours caisse : enregistrement puis encaissement

Scénario opérationnel le plus courant en agence : un agent enregistre le colis et remet un ticket au client ; un second agent, à la caisse, encaisse le montant avant que le colis parte en voyage.

📝

Phase A — Enregistrement (agent chef / admin mobile)

Comptes types : chef@bagagexpress.ci ou admin@bagagexpress.ci

Menu Nouveau colis → renseigner colis, expéditeur (CNI + photos), destinataire, photos du bagage
Le système calcule le tarif et crée le colis avec statut Enregistré et paiement En attente
Impression ou affichage du ticket QR : code suivi (ex. BX-ABJ-…), montant, message « paiement au guichet »
Remettre le ticket au client — le colis n'est pas encore payé

🧾

Phase B — Présentation client à la caisse

Le client se présente au guichet d'encaissement avec le ticket (QR imprimé ou à l'écran sur son téléphone).

💰

Phase C — Encaissement (agent guichet / caisse)

Compte type : guichet@bagagexpress.ci — mobile Encaisser ou web Encaisser

1 · Code — Saisir le code suivi dans le champ prévu, ou appuyer sur Scanner le QR et pointer la caméra vers le ticket
Vérifier le récapitulatif : description, trajet, expéditeur, destinataire, montant
2 · Mode — Choisir Espèces, Wave, Orange, MTN ou Moov
Appuyer sur Encaisser [montant] F — le colis passe en statut Payé
3 · Reçu — Imprimer le reçu d'encaissement (code suivi, mode, montant, code de retrait)

Si le colis est introuvable ou déjà payé, un message d'alerte s'affiche. L'agent caisse peut consulter la liste des colis en attente sans les modifier.

✅

Phase D — Suite du circuit

Une fois payé, le colis peut être affecté à un voyage (web ou mobile quai/chef), chargé dans le bus, suivi jusqu'au retrait par le destinataire.

Qui fait quoi ?

Action	Agent	Interface
Créer le colis + ticket QR	Chef d'agence / Admin	📱 Mobile — Nouveau colis
Encaisser le paiement	Agent guichet (caisse)	📱 Mobile — Encaisser ou 🖥️ Web — Encaisser
Consulter colis / voyages	Agent guichet	📱 Mobile — lecture seule
Affecter au voyage & charger	Chef / Quai	🖥️ Web ou 📱 Scanner

💡 Bonne pratique : ne confondez pas les terminaux si possible — un poste « enregistrement » et un poste « caisse » — chacun connecté avec le bon compte. Le ticket QR lie les deux étapes sans ressaisie manuelle.

Cycle de vie d'un colis

Un colis traverse les statuts suivants, visibles dans les listes web et mobile.

Enregistré Affecté En transit Arrivé Notifié Retiré

Statut	Signification	Qui agit ?
Enregistré	Colis créé, ticket QR émis, en attente de paiement	Chef / Admin (mobile — Nouveau colis)
Payé	Paiement validé à la caisse	Agent guichet (mobile ou web — Encaisser)
Affecté	Assigné à un voyage	Chef / Quai (web ou mobile)
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

Parcours détaillé : enregistrement → retrait

Scénario type d'un envoi Abidjan → Bouaké.

📱

Étape 1 — Enregistrement (mobile, chef d'agence ou admin)

Nouveau colis en 4 étapes :

Colis — description, type, poids, destination, voyage optionnel
Expéditeur — nom, téléphone, pièce d'identité + photos
Destinataire — nom et téléphone (code SMS de retrait généré à la remise)
Photos — 2 photos du colis, montant estimé

Génération du ticket QR : code suivi (ex. BX-ABJ-…), montant, statut En attente de paiement. Message : « Ticket généré · paiement au guichet ». Le client conserve ce ticket pour la caisse.

💰

Étape 2 — Encaissement (agent de caisse)

Le client se présente à la caisse avec son ticket.

Mobile — Encaisser (agent GUICHET) ou Web — Encaisser :

Identifier le colis : saisie du code ou scan du QR du ticket
Vérifier montant et informations
Choisir le mode de paiement et valider
Imprimer le reçu d'encaissement (code de retrait inclus)

Le colis passe en Payé et peut être affecté à un voyage.

🚌

Étape 3 — Affectation & chargement

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.

📍

Étape 4 — Arrivée à destination

À 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, ex. A3K9M2).

🤝

Étape 5 — Retrait (mobile ou web)

Menu Retrait (agent RETRAIT) :

Identifier le colis (scan QR, code suivi ou code retrait)
Étape 1 — Vérifier le code retrait saisi par le destinataire (6 caractères)
Étape 2 — Vérifier la pièce d'identité + photo preuve
Confirmer la remise → statut Retiré — impression du reçu de remise possible

Mode hors-ligne : l'enregistrement et les scans sont mis en file sur le mobile. Dès que le réseau revient, l'onglet synchronisation envoie les opérations au serveur. Vérifiez régulièrement qu'il n'y a pas d'erreurs en attente.

Récapitulatif des acteurs

Étape	Interface	Agent
Création colis + ticket QR	📱 Mobile — Nouveau colis	Chef / Admin
Paiement à la caisse	📱 Mobile — Encaisser ou 🖥️ Web — Encaisser	Agent guichet (caisse)
Planifier voyage / manifeste	🖥️ Web — Voyages	Chef / Quai
Charger le bus	📱 Scanner	Quai
Arrivée & notification	📱 Scanner	Quai destination
Remise au destinataire	📱 ou 🖥️ Retrait	Retrait