Retour à l'accueil

Ressources · Administration

Documentation du cockpit PayPéage

Guide pas à pas pour configurer et administrer la plateforme : devises, tarifs, postes de péage, opérateurs terrain, privilèges et suivi des recettes.

Ouvrir la console admin

Ce guide décrit l'utilisation complète du cockpit d'administration PayPéage: configuration des postes, tarifs, opérateurs terrain, suivi des recettes et contrôle des accès. Il s'adresse aux administrateurs provinciaux, superviseurs et responsables IT.

Vue d'ensemble du portail PayPéage
Figure — Vue d'ensemble du portail PayPéage

1. Accès au cockpit

Connexion

  1. Ouvrez votre navigateur et accédez à l'URL du portail (ex. https://votre-domaine/admin/login).
  2. Saisissez votre adresse e-mail et votre mot de passe administrateur.
  3. Cliquez sur « Se connecter » — vous êtes redirigé vers le tableau de bord.
Écran de connexion administrateur
Figure — Écran de connexion administrateur

Mot de passe oublié

  1. Sur l'écran de connexion, cliquez sur « Mot de passe oublié ? ».
  2. Entrez votre e-mail et validez la demande de réinitialisation.
  3. Suivez le lien reçu par e-mail pour définir un nouveau mot de passe.
Réinitialisation du mot de passe
Figure — Réinitialisation du mot de passe

Navigation dans le cockpit

Une fois connecté, le lanceur de modules(grille d'icônes) vous permet d'accéder à chaque section. Le header affiche les notifications, votre profil et le basculement thème clair/sombre.

Lanceur de modules du cockpit
Figure — Lanceur de modules du cockpit

2. Parcours de configuration recommandé

Pour mettre un poste de péage en service avec l'application mobile, suivez cet ordre :

  1. Configurer les devises (USD, CDF…) — module Devises & taux.
  2. Créer les catégories tarifaires (Moto, Camion…) — module Catégories tarifaires.
  3. Créer le poste de péage — module Postes de péage.
  4. Associer les catégories tarifaires au poste — module Postes de péage (bouton Tarifs).
  5. Créer le rôle « Agent terrain » si nécessaire — module Rôles & privilèges.
  6. Créer l'opérateur et l'affecter au poste — module Opérateurs.
  7. L'agent se connecte sur l'app mobile PayPéage et encaisse les péages.

Schéma du parcours de mise en service

Diagramme : Devises → Tarifs → Poste → Association → Opérateur → App mobile

Figure — Schéma du parcours de mise en service

3. Tableau de bord

Route : /admin/dashboard — Vue en lecture seule.

Fonctionnalités

  • Recettes du jour en USD et CDF
  • Nombre d'engins ayant payé et assujettis uniques
  • Graphiques : top postes par recettes, top postes par volume, tendance assujettis
  • Filtres par période, poste et catégorie tarifaire
Tableau de bord — KPI et graphiques
Figure — Tableau de bord — KPI et graphiques

4. Devises & taux

Route : /admin/currencies

Créer une devise

  1. Cliquez sur « + Ajouter » en haut à droite du tableau.
  2. Renseignez : Code (ex. CDF), Nom, Symbole (ex. FC), Taux vs USD.
  3. Validez — la devise apparaît dans la liste.
Formulaire de création d'une devise
Figure — Formulaire de création d'une devise

Activer / désactiver une devise

  1. Dans la colonne Actions, cliquez sur l'icône d'alimentation (Power).
  2. Confirmez l'activation ou la désactivation.
Activation d'une devise
Figure — Activation d'une devise
Note — La devise de référence USD ne peut pas être supprimée. Seuls les administrateurs (niveau Admin) peuvent supprimer une devise.

5. Catégories tarifaires

Route : /admin/tariffs— Définit les types d'engins et leurs prix. Ces catégories apparaissent ensuite dans l'application mobile lors de l'encaissement.

Créer une catégorie tarifaire

  1. Cliquez sur « + Ajouter ».
  2. Nom de la catégorie (ex. Moto, Camion, Semi-remorque) — obligatoire.
  3. Description (optionnelle).
  4. Prix unitaire — obligatoire.
  5. Devise — sélectionnez USD ou CDF dans la liste déroulante.
  6. Cliquez sur « Enregistrer ».
Création d'une catégorie tarifaire
Figure — Création d'une catégorie tarifaire

Activer une catégorie (rendre visible sur mobile)

  1. Vérifiez que le statut de la catégorie est « Actif » (badge vert).
  2. Si inactive, cliquez sur l'icône Power dans Actions et confirmez l'activation.
  3. Assurez-vous aussi que la catégorie est associée au poste de péage (voir section Postes).
Activation d'une catégorie tarifaire
Figure — Activation d'une catégorie tarifaire
Astuce — Une catégorie inactive ou non associée au poste de l'agent n'apparaîtra pas dans l'onglet Péages de l'app mobile.

Modifier ou supprimer

  1. Crayon (Modifier) — met à jour nom, description, prix ou devise.
  2. Corbeille (Supprimer) — réservé au niveau Admin, avec confirmation.

6. Postes de péage

Route : /admin/sites

Créer un poste

  1. Cliquez sur « + Ajouter ».
  2. Nom du poste (obligatoire) — ex. « Péage Kananga Nord ».
  3. Code (obligatoire, majuscules, max 20 car.) — ex. KAN-NORD.
  4. Adresse et Zone / Délimitation (optionnels).
  5. Latitude / Longitude — saisissez manuellement ou cliquez « Utiliser ma position actuelle ».
  6. Enregistrez.
Formulaire de création d'un poste de péage
Figure — Formulaire de création d'un poste de péage

Associer les catégories tarifaires au poste

  1. Dans le tableau des postes, cliquez sur l'icône Tags (étiquettes) de la ligne concernée.
  2. Le modal « Catégories tarifaires du poste » s'ouvre.
  3. Cliquez « + Ajouter une catégorie » et sélectionnez les tarifs à appliquer.
  4. Pour retirer une catégorie, cliquez sur la croix à côté de celle-ci.
Association catégories ↔ poste de péage
Figure — Association catégories ↔ poste de péage
Note — C'est cette association qui détermine quelles catégories l'agent mobile voit sur son poste.

7. Opérateurs (agents terrain)

Route : /admin/agents

Créer un opérateur

  1. Cliquez sur « + Ajouter ».
  2. Nom complet (obligatoire).
  3. Fonction / Rôle — choisissez un rôle autorisé à avoir un poste (ex. Agent terrain).
  4. E-mail (obligatoire) — sert aussi d'identifiant si configuré ainsi.
  5. Téléphone — utilisé pour la connexion sur l'app mobile.
  6. Mot de passe — généré automatiquement à la création (copiez-le et transmettez-le à l'agent).
  7. Poste de péage affecté — sélectionnez le poste où l'agent travaillera.
  8. Enregistrez.
Création d'un opérateur terrain
Figure — Création d'un opérateur terrain

Activer / désactiver un opérateur

  1. Colonne Statut — badge Actif / Inactif.
  2. Bouton Power — bascule le compte. Un compte inactif ne peut plus se connecter à l'app mobile.
Gestion du statut opérateur
Figure — Gestion du statut opérateur

8. Engins (registre véhicules)

Route : /admin/vehicles — Module en lecture seule. Liste les véhicules ayant déjà passé un péage (données issues des transactions).

Consulter l'historique des passages

  1. Recherchez par plaque, châssis ou nom du propriétaire.
  2. Filtrez par catégorie ou statut (Récent / Inactif 30 j).
  3. Cliquez sur une ligne pour ouvrir « Historique des passages ».
Historique des passages d'un engin
Figure — Historique des passages d'un engin

9. Rôles & privilèges

Route : /admin/roles

Matrice des permissions

Chaque rôle dispose de droits par module :

  • Lecture — consulter le module
  • Modif. — créer, modifier, activer/désactiver
  • Admin — supprimer + droits étendus
  1. Cliquez « + Ajouter » ou modifiez un rôle existant.
  2. Nom du rôle (ex. Superviseur provincial).
  3. Cochez les permissions module par module.
  4. Enregistrez — les utilisateurs avec ce rôle héritent des droits.
Matrice des privilèges par module
Figure — Matrice des privilèges par module
Note — Le rôle Administrateur (id=1) est protégé et ne peut pas être supprimé.

10. Journal d'audit

Route : /admin/audit — Lecture seule, journal horodaté de toutes les actions.

  • Colonnes : Date, Utilisateur, Module, Action, Détails, IP, Niveau
  • Filtres : recherche texte, module, niveau (Info / Alerte / Erreur)
  • Pagination pour parcourir l'historique
Journal d'audit
Figure — Journal d'audit

11. Profil & notifications

Profil utilisateur

  1. Cliquez sur votre avatar en haut à droite du cockpit.
  2. Onglet Informations — modifiez nom, téléphone, photo.
  3. Onglet Sécurité — changez votre mot de passe.
Modal profil administrateur
Figure — Modal profil administrateur

Notifications

L'icône cloche affiche les alertes liées aux événements du système (issues du journal d'audit). Cliquez une notification pour la marquer comme lue.

Centre de notifications
Figure — Centre de notifications

12. Lien avec l'application mobile

L'application mobile PayPéage (agents terrain) consomme la configuration faite dans le cockpit :

  • Connexion — téléphone + mot de passe de l'opérateur
  • Onglet Péages — catégories tarifaires actives et associées au poste
  • Dashboard agent — recettes et mouvements du jour
  • Quittance — impression ticket 58 mm après encaissement

Application mobile — encaissement d'un péage

Capture : écran Péages mobile avec catégories et formulaire engin/assujetti

Figure — Application mobile — encaissement d'un péage

13. Dépannage courant

ProblèmeSolution
Catégorie invisible sur mobileVérifier statut Actif + association au poste + poste affecté à l'agent
Agent ne peut pas se connecterVérifier compte Actif, téléphone correct, mot de passe à jour
Recettes à 0 sur le dashboardVérifier filtres date/poste ; confirmer que des transactions existent
Module inaccessibleVérifier les privilèges du rôle (Lecture minimum requis)

Checklist de vérification mise en service

Infographie : 5 points de contrôle avant ouverture d'un poste

Figure — Checklist de vérification mise en service