Exploitation¶
Assurer le service demande d'affecter des moyens aux courses, puis de constater ce qui a réellement été fait. L'API expose les deux, et c'est leur confrontation qui a de la valeur.
Prévoir, puis constater¶
Deux objets se ressemblent et répondent à des questions différentes.
| planning | duties | |
|---|---|---|
| Répond à | Qui devait assurer quoi | Qui a effectivement assuré le service |
| Nature | Prévision | Constat |
| Produit par | La planification de l'exploitant | La prise de service du conducteur sur son appareil |
Comparer les deux donne les écarts d'exploitation : course non couverte, changement de conducteur, véhicule substitué. Aucun endpoint ne calcule cette comparaison — c'est à l'intégration de la faire, en rapprochant les deux lectures sur la même date.
| Endpoint | Rôle |
|---|---|
GET /api/v4/groups/<group_id>/planning |
Donne l'affectation prévue sur une période |
GET /api/v4/groups/<group_id>/duties |
Liste les services réellement assurés |
GET /api/v4/groups/<group_id>/duties/<duty_id> |
Décrit un service et les courses qu'il couvre |
Le service de conduite relie tout¶
Le service de conduite est le pivot de l'exploitation : c'est lui qui associe, pour une plage horaire donnée, un conducteur, un véhicule, un appareil et une liste de courses effectuées. Il porte aussi les kilomètres parcourus hors course commerciale, et les informations de prise et de fin de service.
C'est donc le point d'entrée pour toute question de la forme « qui conduisait ce véhicule à telle heure », à laquelle ni la course ni l'appareil ne répondent seuls.
Les moyens¶
Trois entités décrivent les moyens engagés, définies dans le glossaire : les conducteurs, les véhicules et les appareils.
Deux points comptent pour une intégration :
- Un conducteur n'est pas un utilisateur. Il ne se connecte pas à l'interface d'exploitation ; il s'identifie sur l'application Pysae Driver. Les comptes utilisateurs, eux, relèvent de l'organisation.
- L'archivage n'est pas une suppression. Un conducteur ou un véhicule qui quitte le réseau est archivé : il disparaît de l'exploitation courante, mais reste rattaché à l'historique qu'il a produit. Une intégration qui filtre sans tenir compte de l'archivage perd les données passées.
| Endpoint | Rôle |
|---|---|
GET /api/v4/groups/<group_id>/drivers |
Liste les conducteurs |
GET /api/v4/groups/<group_id>/vehicles |
Liste les véhicules |
Le cloisonnement par équipe¶
Un groupe peut se subdiviser en équipes — un dépôt, un secteur, un sous-traitant. Conducteurs et véhicules y sont rattachés, et les droits d'un utilisateur peuvent se limiter à certaines d'entre elles.
Une intégration dont la clé d'API est restreinte à des équipes ne voit qu'une partie du réseau. Un écart de volumétrie inexpliqué se vérifie donc d'abord de ce côté-là.
Et ensuite¶
Pour analyser tout cela sur des périodes longues, la voie est l'export en masse — page Statistiques et exports.