Fleet Groups
Taxi & Private Hire › Products › Fleet › Fleet Groups
Generally available
A fleet group is a shared operational pool across several fleets. A fleet with no group runs in isolation — it sees only its own data; fleets in a shared group pool their supply, demand, capacity, busy-area metrics and dispatch eligibility, so a trip booked in one can be served by a driver in another. Each fleet belongs to at most one group, and group changes apply to new activity going forward.
Related
Fields
| Field | Type | Description |
|---|---|---|
name | string | Display name of the group ("All Airport Fleets", "Contractors Only", "Night Shift Fleets"). Surfaced in group-level dispatch + reporting screens. |
ref | string | External reference code, unique per tenant. Integration-friendly handle for the fleet group. |
active | bool | Whether the group is currently active. Inactive groups are hidden from operator pickers but kept for historical reporting. |
capacitySeedConfig | json | Cold-start throughput seed authored for this fleet group. Compiled into the SEEDED capacity tier at apply time via the materialiser. Read-only to generic CRUD. NULL = no seed authored. |
clientId | bigint | Tenant scope. Every tenant-aware entity carries this; `ClientFilter` enforces row-level isolation on read; the multi-tenancy routing layer (`/client/{clientId}`) sets it at create time. Surfaced only under `admin` / `tripLog` groups — never to end users. |
internalKey | string | Optional client-supplied external reference / idempotency key. When present, lets external systems correlate platform-side records back to their own source-of-truth ids. Not persisted to a column — populated by the request handler when the caller sets it. |
__objectType | string | Discriminator string (entity class short-name) emitted alongside the id in serialized output. Resolved at read time by `getObjectType()`; lets the FE dispatch entity-specific rendering without inspecting the URL. |
id | bigint | Snowflake-style primary key (unsigned BIGINT). Generated by `IdFactory` at create time; surfaced to the FE / API as a `G`-prefixed string and stripped back to plain bigint server-side before Doctrine lookup. |
createdDate | integer | Unix timestamp the row was first persisted. Set in the entity's PrePersist hook; never rewritten on subsequent updates. |
updatedDate | integer | Unix timestamp the row was last touched. Bumped on every commit that hits the Doctrine UoW for this entity; drives FE invalidation + the listing change cursor. |
passiveUpdatedDate | int | Read-through alias for `updatedDate` exposed under different serializer groups. Lets the FE distinguish "real edit" from "background touch" projections without changing the underlying column. |
listingUpdatedDate | int | Listing-projection timestamp surfaced only under the `listMode` group. Driven by `TripCache` and other listing-shape refreshers separately from `updatedDate` so a listing rebuild doesn't trigger detail-page invalidation. |