Tournees de livraison
Creer, gerer et suivre les tournees de livraison qui regroupent plusieurs taches en une feuille de route unique.
Tournees de livraison
Une tournee de livraison (delivery run) regroupe plusieurs taches (collectes, livraisons, transferts) en une feuille de route unique assignee a un chauffeur. C'est l'unite d'execution sur le terrain : le chauffeur suit l'ordre des arrets defini dans la tournee.
Acceder aux tournees
La page Tournees (/delivery-runs) est accessible depuis le menu Operations > Tournees dans la barre laterale. Elle est egalement accessible depuis la page Dispatch (/map).
Page de liste des tournees
Filtres
| Filtre | Description |
|---|---|
| Onglets de statut | Toutes, Brouillon, Assignee, En cours, Terminee |
| Recherche | Par reference de tournee ou nom du chauffeur |
| Date | Filtrer par date de creation |
| Chauffeur | Filtrer par chauffeur assigne |
Statistiques
Trois compteurs sont affiches en haut :
- Tournees : nombre total de tournees (dans le filtre actif)
- En direct : nombre de tournees actuellement en cours
- Colis : nombre total d'arrets (taches)
Tableau
| Colonne | Contenu |
|---|---|
| Reference | Identifiant unique de la tournee (genere automatiquement) |
| Statut | Badge colore avec animation pulse pour les tournees en cours |
| Routage | Mode de routage : Direct ou Via hub |
| Chauffeur | Nom du chauffeur assigne (ou « Non assigne ») |
| Arrets | Nombre de taches dans la tournee |
| Date planifiee | Date prevue (si definie) |
| Creneau | Fenetre horaire de debut et fin |
Cliquez sur une ligne pour acceder au detail de la tournee.
Detail d'une tournee
La page de detail affiche :
En-tete
- Reference de la tournee
- Statut (badge colore)
- Mode de routage (Direct ou Via hub)
- Nombre d'arrets et nombre total de colis
Actions (tournees non terminales uniquement)
| Action | Description |
|---|---|
| Ajouter des arrets | Ouvre une modale pour rechercher et ajouter des taches a la tournee |
| Reassigner | Changer le chauffeur et/ou le vehicule de la tournee |
| Annuler | Passe la tournee en statut cancelled |
| Supprimer | Supprime la tournee (administrateur ou tournee non terminale) |
Carte
Une carte interactive affiche les arrets de la tournee avec des marqueurs numerotes dans l'ordre de passage.
Liste des arrets
Chaque arret affiche :
- Numero de sequence dans la tournee
- Type de tache : badge (collecte, livraison, transfert, retour)
- Ville de destination
- Statut de la tache (badge colore)
- Nombre de colis (badge si plusieurs, notamment pour les collectes groupees)
- Bouton de suppression pour retirer l'arret de la tournee
Pour les collectes groupees, la liste des colis est depliable et affiche le tracking et le destinataire de chaque colis.
Une barre de progression indique le nombre de taches completees par rapport au total.
Panneau de details
Le panneau lateral affiche :
- Chauffeur assigne (nom)
- Vehicule (nom et immatriculation)
- Date planifiee
- Hub de destination (mode Via hub uniquement)
- Date de creation
Creer une tournee
Depuis la page Dispatch
- Selectionnez des taches dans la liste de gauche (Dispatch Tree).
- Cliquez sur Creer une tournee.
- Le formulaire de creation s'ouvre dans une modale.
Formulaire de creation
| Section | Champs |
|---|---|
| Mode de routage | Direct ou Via hub |
| Hub de destination | Liste des depots permanents (mode Via hub uniquement, obligatoire) |
| Chauffeur | Selecteur de chauffeur (optionnel) |
| Vehicule | Selecteur de vehicule (optionnel) |
| Planification | Des que possible ou Planifier (date + creneau horaire) |
| Notes | Instructions pour le chauffeur |
Ordonnancement des taches
Les taches selectionnees sont listees dans un ordre modifiable :
- Glisser-deposer pour reordonner les arrets
- Boutons haut/bas pour ajuster l'ordre
- Un avertissement de distance s'affiche si deux arrets consecutifs sont eloignes (calcul Haversine)
Contraintes de validation
- Minimum 2 taches requises
- Maximum 200 taches par tournee
- Les taches en statut terminal ne sont pas eligibles
- Les taches deja dans une tournee active ne sont pas eligibles
- En mode Via hub, les taches de type
deliveryne sont pas autorisees (uniquement collectes, transferts, retours) - Les taches de type
pickupdoivent etre au statutpicked_up
Composition d'une tournee
| Element | Description |
|---|---|
| Reference | Identifiant unique genere automatiquement par organisation |
| Chauffeur | Chauffeur assigne (cascade : le chauffeur de la tournee est propage a toutes ses taches) |
| Vehicule | Vehicule utilise (optionnel) |
| Taches | Liste ordonnee des arrets avec un runOrder (index de sequence) |
| Routage | direct (livraison directe) ou via_hub (passage par un hub intermediaire) |
| Depot de destination | Hub de destination pour le routage Via hub |
| Date planifiee | Jour prevu de la tournee |
| Creneau | Fenetre horaire (deliverAfter / deliverBefore) |
| Notes | Remarques pour le chauffeur |
Statuts d'une tournee
| Statut | Code | Couleur | Description |
|---|---|---|---|
| Brouillon | draft | Gris | Tournee en preparation, aucun chauffeur assigne |
| Assignee | assigned | Bleu | Un chauffeur est assigne, aucune tache n'a demarre |
| En cours | in_progress | Bleu ciel | Au moins une tache a demarre |
| Terminee | completed | Vert | Toutes les taches sont achevees. Statut terminal. |
| Annulee | cancelled | Rouge | Tournee annulee manuellement. Statut terminal. |
Recalcul automatique du statut
Le statut est recalcule automatiquement a chaque modification de la tournee ou de ses taches :
- Annulee : le statut
cancelledest persistant et n'est jamais ecrase - Terminee : toutes les taches sont en statut terminal, ou toutes les taches de collecte sont au statut
picked_up - En cours : au moins une tache a demarre
- Assignee : un chauffeur est assigne mais aucune tache n'a demarre
- Brouillon : aucun chauffeur et aucune tache demarree
Ajouter des taches a une tournee existante
Depuis le detail d'une tournee, cliquez sur Ajouter des arrets :
- Une modale affiche les taches eligibles de l'organisation.
- Recherchez par tracking, destinataire ou ville.
- Cochez les taches a ajouter.
- Cliquez sur Ajouter pour les integrer a la tournee.
Les nouvelles taches sont ajoutees a la suite de l'ordre existant. Le chauffeur de la tournee leur est automatiquement assigne.
Retirer une tache d'une tournee
Depuis le detail de la tournee, cliquez sur le bouton de suppression a cote d'un arret. La tache est dissociee de la tournee et son runOrder est reinitialise. Le statut de la tournee est ensuite recalcule.
Reassignation
Cliquez sur Reassigner depuis le detail de la tournee pour changer le chauffeur et/ou le vehicule. La modification du chauffeur est propagee en cascade a toutes les taches de la tournee.
Ejection automatique en cas d'echec
Lorsqu'une tache de collecte echoue, le systeme effectue automatiquement :
- La tache en echec est retiree de la tournee.
- Les livraisons en aval encore en attente (statuts
waiting_for_pickupouassigned_waiting) sont retirees de la tournee. - Le chauffeur est desassigne des taches ejectees.
- Le statut des taches ejectees est reinitialise a
pendingpour permettre une replanification. - Un evenement
delivery_run_task_ejectedest enregistre sur chaque expedition concernee. - Le statut de la tournee est recalcule.
L'ejection ne touche que les livraisons non encore demarrees. Une livraison deja en cours n'est pas ejectee.
Evenements de tracabilite
| Evenement | Code | Declencheur |
|---|---|---|
| Tournee creee | delivery_run_created | Creation d'une tournee |
| Tache ajoutee | delivery_run_task_added | Ajout d'une tache a la tournee |
| Tache retiree | delivery_run_task_removed | Retrait manuel d'une tache |
| Tache ejectee | delivery_run_task_ejected | Ejection automatique apres echec |
Voir aussi : Collecte groupee | Optimisation