Fleet

Véhicules et conducteurs

Place de marchéOpérationsVersion 0.2.0manifest

À quoi elle sert ​

Keep a register of company vehicles, who drives them and their service history. It records status and services; it does not compute running costs.

Ce que fait et ne fait pas le paquet ​

Vehicles, drivers and service history for a small fleet. Tracks status and service records; it does not compute running costs or fuel use.

Modèles ​

fleet_vehicle ​

A vehicle the business operates

Groupe de lecture: fleet.user. Groupe d'écriture: fleet.manager.

ChampTypeClasse de donnéesDonnées personnellesGroupeVu par les agentsDescription
platetextnonenonfleet.useren clairRegistration plate
modeltextnonenonfleet.useren clairMake and model, for example Renault Master
vintextnonenonfleet.useren clairVehicle identification number (chassis number)
fuelselect (petrol, diesel, hybrid, electric, other)nonenonfleet.useren clairFuel or drive type: petrol, diesel, hybrid, electric, other
odometer_kmnumbernonenonfleet.useren clairLast known odometer reading in kilometres
acquired_ondatenonenonfleet.useren clairDate the vehicle entered the fleet (YYYY-MM-DD)
drivertextinternalouifleet.usermasquéName of the driver currently using the vehicle, as free text
driver_idref → fleet_vehicle_drivernonenonfleet.useren clairDriver record currently assigned to the vehicle
stateselect (available, in_service, maintenance, retired)nonenonfleet.useren clairAvailability: available, in_service, maintenance, retired

fleet_vehicle_driver ​

A person authorised to drive fleet vehicles

Groupe de lecture: fleet.user. Groupe d'écriture: fleet.manager.

ChampTypeClasse de donnéesDonnées personnellesGroupeVu par les agentsDescription
nametextpublic_directoryouifleet.usermasquéFull name of the driver
phonetextinternalouifleet.usermasquéWork phone number of the driver
licence_numbertextconfidential_hrouifleet.managernon communiquéDriving licence number
licence_expirydateconfidential_hrouifleet.managernon communiquéDate the driving licence expires (YYYY-MM-DD)
stateselect (active, suspended)nonenonfleet.useren clairDriver status: active, suspended

fleet_vehicle_service ​

A maintenance, repair or inspection job on a vehicle

Groupe de lecture: fleet.user. Groupe d'écriture: fleet.user.

ChampTypeClasse de donnéesDonnées personnellesGroupeVu par les agentsDescription
vehicle_idref → fleet_vehiclenonenonfleet.useren clairThe vehicle serviced
kindselect (maintenance, repair, inspection, tyres, other)nonenonfleet.useren clairType of job: maintenance, repair, inspection, tyres, other
service_ondatenonenonfleet.useren clairDate of the job (YYYY-MM-DD)
odometer_kmnumbernonenonfleet.useren clairOdometer reading in kilometres when serviced
costmoneynonenonfleet.useren clairTotal invoiced by the workshop (minor currency units, e.g. cents)
workshoptextnonenonfleet.useren clairName of the workshop or garage
noteslongtextnonenonfleet.useren clairWhat was done or found
stateselect (planned, done, cancelled)nonenonfleet.useren clairJob status: planned, done, cancelled

Flux de travail ​

fleet_vehicle ​

ActionTransitionQui peut l'exécuterApprobation
fleet_vehicle.dispatchstate: available → in_servicefleet.managernon
fleet_vehicle.return_to_poolstate: in_service → availablefleet.managernon
fleet_vehicle.retirestate: available → retiredfleet.approveroui

fleet_vehicle_driver ​

ActionTransitionQui peut l'exécuterApprobation
fleet_vehicle_driver.suspendstate: active → suspendedfleet.managernon
fleet_vehicle_driver.reactivatestate: suspended → activefleet.managernon

fleet_vehicle_service ​

ActionTransitionQui peut l'exécuterApprobation
fleet_vehicle_service.completestate: planned → donefleet.usernon
fleet_vehicle_service.cancelstate: planned → cancelledfleet.usernon

Groupes de permissions ​

Groupes utilisés par cette application :

  • fleet.approver
  • fleet.manager
  • fleet.user

Étapes d'approbation ​

Étapes qu'un agent ne peut que proposer :

  • fleet_vehicle.retire

Ce que les agents peuvent et ne peuvent pas faire ​

Un agent peut lire, rechercher, créer et modifier les enregistrements de cette application, et exécuter les actions qui ne requièrent pas d'approbation, dans les limites des groupes de permissions de son jeton.

Il ne peut que proposer ces étapes, qu'une personne doit approuver : fleet_vehicle.retire, fleet_vehicle.delete, fleet_vehicle_driver.delete, fleet_vehicle_service.delete.

Les données personnelles sont masquées sous forme de jetons de substitution : fleet_vehicle.driver, fleet_vehicle_driver.name, fleet_vehicle_driver.phone.

Ces champs ne sont pas communiqués aux agents : fleet_vehicle_driver.licence_number, fleet_vehicle_driver.licence_expiry.

Dépendances ​

Aucune.

Installation ​

Installez-la depuis l'application Customize (Place de marché), ou en ligne de commande :

bash
obop modules install-from fleet

Nécessite une base de données et des droits d'administrateur.

Créer la vôtre ​

Le guide des modules montre comment sont écrites les applications de ce type