Fleet

Fahrzeuge und Fahrer

MarktplatzBetriebVersion 0.2.0manifest

Wofür sie gedacht ist ​

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

Was das Paket leistet und was nicht ​

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

Modelle ​

fleet_vehicle ​

A vehicle the business operates

Lesegruppe: fleet.user. Schreibgruppe: fleet.manager.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
platetextnoneneinfleet.userim KlartextRegistration plate
modeltextnoneneinfleet.userim KlartextMake and model, for example Renault Master
vintextnoneneinfleet.userim KlartextVehicle identification number (chassis number)
fuelselect (petrol, diesel, hybrid, electric, other)noneneinfleet.userim KlartextFuel or drive type: petrol, diesel, hybrid, electric, other
odometer_kmnumbernoneneinfleet.userim KlartextLast known odometer reading in kilometres
acquired_ondatenoneneinfleet.userim KlartextDate the vehicle entered the fleet (YYYY-MM-DD)
drivertextinternaljafleet.usermaskiertName of the driver currently using the vehicle, as free text
driver_idref → fleet_vehicle_drivernoneneinfleet.userim KlartextDriver record currently assigned to the vehicle
stateselect (available, in_service, maintenance, retired)noneneinfleet.userim KlartextAvailability: available, in_service, maintenance, retired

fleet_vehicle_driver ​

A person authorised to drive fleet vehicles

Lesegruppe: fleet.user. Schreibgruppe: fleet.manager.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
nametextpublic_directoryjafleet.usermaskiertFull name of the driver
phonetextinternaljafleet.usermaskiertWork phone number of the driver
licence_numbertextconfidential_hrjafleet.managerzurückgehaltenDriving licence number
licence_expirydateconfidential_hrjafleet.managerzurückgehaltenDate the driving licence expires (YYYY-MM-DD)
stateselect (active, suspended)noneneinfleet.userim KlartextDriver status: active, suspended

fleet_vehicle_service ​

A maintenance, repair or inspection job on a vehicle

Lesegruppe: fleet.user. Schreibgruppe: fleet.user.

FeldArtDatenklassePersonenbezogene DatenGruppeAgenten sehenBeschreibung
vehicle_idref → fleet_vehiclenoneneinfleet.userim KlartextThe vehicle serviced
kindselect (maintenance, repair, inspection, tyres, other)noneneinfleet.userim KlartextType of job: maintenance, repair, inspection, tyres, other
service_ondatenoneneinfleet.userim KlartextDate of the job (YYYY-MM-DD)
odometer_kmnumbernoneneinfleet.userim KlartextOdometer reading in kilometres when serviced
costmoneynoneneinfleet.userim KlartextTotal invoiced by the workshop (minor currency units, e.g. cents)
workshoptextnoneneinfleet.userim KlartextName of the workshop or garage
noteslongtextnoneneinfleet.userim KlartextWhat was done or found
stateselect (planned, done, cancelled)noneneinfleet.userim KlartextJob status: planned, done, cancelled

Workflows ​

fleet_vehicle ​

AktionBewegtWer sie ausführen darfFreigabe
fleet_vehicle.dispatchstate: available → in_servicefleet.managernein
fleet_vehicle.return_to_poolstate: in_service → availablefleet.managernein
fleet_vehicle.retirestate: available → retiredfleet.approverja

fleet_vehicle_driver ​

AktionBewegtWer sie ausführen darfFreigabe
fleet_vehicle_driver.suspendstate: active → suspendedfleet.managernein
fleet_vehicle_driver.reactivatestate: suspended → activefleet.managernein

fleet_vehicle_service ​

AktionBewegtWer sie ausführen darfFreigabe
fleet_vehicle_service.completestate: planned → donefleet.usernein
fleet_vehicle_service.cancelstate: planned → cancelledfleet.usernein

Berechtigungsgruppen ​

Von dieser App verwendete Gruppen:

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

Freigabeschritte ​

Schritte, die ein Agent nur vorschlagen kann:

  • fleet_vehicle.retire

Was Agenten tun können und was nicht ​

Ein Agent kann Datensätze dieser App lesen, durchsuchen, anlegen und aktualisieren sowie Aktionen ausführen, die keine Freigabe brauchen, und zwar innerhalb der Berechtigungsgruppen seines Tokens.

Diese Schritte kann er nur vorschlagen, und eine Person muss sie freigeben: fleet_vehicle.retire, fleet_vehicle.delete, fleet_vehicle_driver.delete, fleet_vehicle_service.delete.

Personenbezogene Daten werden als Platzhalter maskiert: fleet_vehicle.driver, fleet_vehicle_driver.name, fleet_vehicle_driver.phone.

Diese Felder werden Agenten vollständig vorenthalten: fleet_vehicle_driver.licence_number, fleet_vehicle_driver.licence_expiry.

Abhängigkeiten ​

Keine.

Installation ​

Installieren Sie sie in der App Customize (Marktplatz) oder über die Kommandozeile:

bash
obop modules install-from fleet

Erfordert eine Datenbank und Administratorrechte.

Selbst bauen ​

Der Modulleitfaden zeigt, wie Apps wie diese geschrieben werden