SK Fleet Features

Engineering capabilities catalog

Explore the architecture, database constraints, and visual flows powering SK Fleet.

⚠ In development. SK Fleet is a local-only build today, in pilot design with a UAE limousine operator. The domain model, the 151-operation API surface and the flows on this page are real and implemented; hosting, published tariffs and the plan prices below are not final. We show the banner rather than imply it is generally available.
01

Duties are ordered stops — not a from/to pair

One table and one API serve a two-stop airport transfer, a five-stop city tour, an open-ended hire and a nine-stop courier run. The stop sequence is the itinerary and is never re-derived from timestamps, because a tour can revisit the same zone twice.

fig 01 · not a from/to pair booking created /v1/bookings stops: 5 (ordered) seq IS the itinerary seq 1 · DXB T3 · pickup seq 2 · Downtown · wait 20m seq 3 · Marina · drop never re-sorted by time duty allocated ✓ service type inferred airport > stop count
api ingest queue push pushed ✓

High performance gates live

Scaled to process inbound workloads in sub-100ms with strict rate-limits protections.

verify key check table 1 entry

Idempotency safeguards live

All writes request carrying idempotency keys are deduplicated instantly at API gateways.

tenancy check apply policy isolated ✓

Row-Level Security live

Database layer RLS policies isolate organization records from adjacent workspaces.

02

A four-tier tariff and a quote engine with no clock

Fixed route, distance band, hourly package and day rate resolve in a fixed order — a published zone-pair fare always wins. Surcharges are derived facts about the clock and the origin zone, never typed by an agent, and the regulated floor lands last as a visible line.

fig 02 · flow diagram resolution order 1 fixed route 2 distance band 3 hourly package 4 day rate pure fare engine no fetch · no Date.now · no random · no db fare 180.00 · night +15% · airport +20.00 extras 25.00 · floor adj +0.00 quote 252.00 AED rate-plan version pinned recomputable months later
api ingest queue push pushed ✓

High performance gates live

Scaled to process inbound workloads in sub-100ms with strict rate-limits protections.

verify key check table 1 entry

Idempotency safeguards live

All writes request carrying idempotency keys are deduplicated instantly at API gateways.

tenancy check apply policy isolated ✓

Row-Level Security live

Database layer RLS policies isolate organization records from adjacent workspaces.

03

Dispatch, custody and the phone as the telematics box

The board ranks candidate vehicles and refuses a clashing assignment. Custody is the unit for the car — driver, plate and odometer out, open-ended, spanning days — so every trip in the period rides one session. The driver's phone streams position, and a geofence crossing marks arrival.

fig 03 · flow diagram dispatch board ranked candidates clash rules enforced custody session · open-ended driver drv_41 · plate DXB-A-84213 odo out 128,402 km · day 3 of hire ping every 4s → live position geofence arrival ✓ stop seq 1 marked rider notified
api ingest queue push pushed ✓

High performance gates live

Scaled to process inbound workloads in sub-100ms with strict rate-limits protections.

verify key check table 1 entry

Idempotency safeguards live

All writes request carrying idempotency keys are deduplicated instantly at API gateways.

tenancy check apply policy isolated ✓

Row-Level Security live

Database layer RLS policies isolate organization records from adjacent workspaces.

04

Permits, fines and obligations that block the work

A booking stamps its region, and that decides tax treatment and permit authority. Driver and vehicle documents live in a registry with a gap report, an expiring PDP raises a compliance hold, and a recorded fine gets a liability decision instead of quietly disappearing into the month.

fig 04 · flow diagram document registry licence · valid PDP · expires in 9d permit · snapshot stamped obligation monitor fleet.driver_pdp.approaching → alert fleet.obligation.breached → hold fleet.fine.recorded → liability set compliance hold driver undispatchable until the doc is renewed
api ingest queue push pushed ✓

High performance gates live

Scaled to process inbound workloads in sub-100ms with strict rate-limits protections.

verify key check table 1 entry

Idempotency safeguards live

All writes request carrying idempotency keys are deduplicated instantly at API gateways.

tenancy check apply policy isolated ✓

Row-Level Security live

Database layer RLS policies isolate organization records from adjacent workspaces.

05

The quote is transparency — the duty record is authority

Settlement is recomputed from what the duty actually recorded: real times, odometer, waiting and fuel — never from the frozen quote. The response shows quoted against final with the delta, the discount ladder holds its ceilings on the platform, and the accrued line posts to SK Billing.

fig 05 · the duty record is authority quoted 252.00 frozen at accept shown, not billed recomputed from duty facts odo 41 km · waiting 34m · fuel 12.00 override −15.00 (within ceiling) final 289.00 · delta +37.00 charge posted → sk-billing accrued → posted
api ingest queue push pushed ✓

High performance gates live

Scaled to process inbound workloads in sub-100ms with strict rate-limits protections.

verify key check table 1 entry

Idempotency safeguards live

All writes request carrying idempotency keys are deduplicated instantly at API gateways.

tenancy check apply policy isolated ✓

Row-Level Security live

Database layer RLS policies isolate organization records from adjacent workspaces.

Looking for API specifications?

SDK scripts, payload schemas, and webhook models are documented on the developers page.

Developers →