Cargo

This section is about shipments: what is being carried, where it is now, on which vehicle, and when it will arrive.

The data model

The system distinguishes two levels:

• Shipment (cargo) — the whole logistical unit: "Electronics pallet", with an origin, a destination and a priority.
• Package — a physical item inside the shipment with its own barcode (for example BX-4471-01). It is the package that binds to a vehicle, and the package's position that appears on the map.

One shipment can travel on several vehicles: some packages on one, some on another. The history of those bindings is preserved.

The cargo list

Open it from Manage → Cargo or at /cargo.

Column	Contents
Name	Shipment name
Status	Planned, In transit, Delivered, Damaged
Origin	Where from
Destination	Where to
Packages	Item count
Priority	Shipment urgency

Double-click opens the shipment page.

The sidebar gains a Cargo list with search ("Search cargo..."), sorting (Default, Name, Volume) and grouping (None, Status).

The shipment page

Reached by double-clicking a list row, from the map card, or at /cargo/:id. If the shipment is unavailable: "Shipment not found."

Header

The main card holds:

• Departed — when the shipment set off;
• In movement — how long it has been travelling;
• ETA — the arrival forecast;
• Distance — split into covered and to go;
• Origin and Destination;
• Current location with a Live marker;
• Carried by AB123CD · Ivanov — vehicle and driver.

Buttons: Track on map, Documents, Edit, Back.

Cargo attributes

The shipment's characteristics: volume, weight, packaging type, special conditions (a temperature range, for instance), priority.

Statistics

Aggregated figures for the shipment over the selected period.

Packages

The Packages block ("12 total · 8 on the move") lists every item in the shipment. Each shows:

• its label and barcode;
• Carried by AB123CD or Carried by AB123CD · Ivanov;
• Unassigned if the package is not on a vehicle yet;
• 4 bindings in history — how many times the package was transferred.

The button on each row tracks that specific package on the map.

With no packages: "This cargo has no packages yet."

Route history

The Route history block ("Origin → Destination · packages live") draws the path travelled and the current package positions on the map. With nothing yet recorded: "No package positions yet".

Shipment journey

The Shipment journey block ("Custody & milestones") is a timeline of the key milestones: goods received, loaded, transferred, delivered. The present moment is marked Now. With no milestones: "No milestones yet."

Vehicle binding

The Vehicle binding block ("Handling history") shows which vehicles carried the packages and over which intervals. Each entry is marked Active or Completed and links to the vehicle page.

Documents

Waybills, acts and other files attached to the shipment.

Cargo on the map

The map has a Cargoes layer showing packages at the position of the vehicle carrying them.

• Grouping By cargo produces a three-level tree: shipment → packages.
• Status filter: Planned, In transit, Delivered, Damaged.
• Clicking a package opens a card with its current position, carrier, estimated arrival and a Binding history tab.

Cargo analytics

Cross-shipment figures live on the Cargo analytics screen: volume, delivery counts, on-time share and average transit time.

Typical workflows

Answer "where is my shipment". Cargo list → find the shipment by name → shipment page → Current location and ETA. For item-level detail open the Packages block.

Investigate a delay. Shipment page → Shipment journey: the milestone where the pause happened is visible. Then Vehicle binding → open the vehicle page and review its trips over that window.

Trace a transfer. Packages block → a package with several bindings in its history → the package card on the map → the Binding history tab.