README

External Hubleto application for recording business and private vehicle trips.

Features

vehicle registry with registration number, VIN, propulsion and consumption data;
trip date, sequence number, driver, time, route, purpose and odometer data;
automatic duration, distance, business/private split and expected energy consumption calculations;
petrol, diesel, LPG, CNG, hybrid, plug-in hybrid and electric vehicles;
an interactive OpenStreetMap route picker directly in the trip form;
reverse geocoding of selected points to real place names;
all business fields are optional, so a route can be saved before a vehicle or other details are known;
standard Hubleto tables, forms, date/time inputs and app navigation.

The app uses Hubleto's built-in React components and includes its own JavaScript and CSS. It has no separate frontend build step and does not require Leaflet or a Google Maps API key.

Installation

Requires an existing Hubleto 2 development installation with the Auth, Settings and Desktop apps. The Composer package currently depends on hubleto/erp:dev-main.

After registration on Packagist, run these commands from the Hubleto project root:

composer require wai-blue/hubleto-vehicle-log
php hubleto app install 'Hubleto\App\External\WaiBlue\VehicleLog'

Open Vehicle log in the sidebar, or visit /vehicle-log.

Until Packagist registration, use a local Composer path repository as described in the external app tutorial.

The app uses the vehicle_log_vehicles and vehicle_log_trips tables shared with the former enterprise version. Do not enable both versions together. Before switching an existing installation, back up the database and review its schema, app configuration and migration history; these steps describe a new installation.

Usage

Open Vehicle log > Vehicles (/vehicle-log/vehicles) and add a vehicle.
Set its propulsion type and fuel or electricity consumption where applicable.
Open Vehicle log > Trips (/vehicle-log) and click Add trip.
Select a vehicle and driver, then enter the date, times, route and purpose.
Enter the odometer readings and business/private kilometres where known.
Save the trip. Hubleto calculates the duration, distance and expected energy consumption from the supplied values.

A trip can also be saved before a vehicle or other business details are known. The map lets you select its start and end points and fills in their coordinates and place names. It does not calculate driving directions or road distance; distance is calculated from the odometer readings or the kilometre split.

Map Services

The map needs internet access. Tiles are loaded from OpenStreetMap, and selected coordinates are sent to the public Nominatim service to resolve place names. If reverse geocoding is unavailable, the selected coordinates remain available.

Use these services in accordance with the OpenStreetMap tile policy and Nominatim usage policy.

License

GPL-3.0-only.

wai-blue / hubleto-vehicle-log

Package info

Security

Statistics