Quick Reference

Menu map, demo-data codes and statuses

Group What's in it
Base Operations Container, Container History, Voyage Service, Client
Agent Voyages East [Meridian → Halcyon], Voyages West [Halcyon → Meridian], Recent Receipts, Recent Discharges
Demurrage Open Demurrage, Demurrage Report, Detention by Client, Demurrage Detail, Invoice Run, Send Notifications, Demurrage Invoice
Dockets Delivery Docket, Receivals Docket, Release Docket, Demurrage Period
Reference Data Port, Location, Vessel, Master, Action, Client Business, Client Type, Manifest Type
System & Administration Container Size, Container Status, Depot Charge Rate, Commodity (+ Primary/Sub/Type), Owner, User

The Agent group's voyage views drill down into per-voyage tabs — Cargo Manifest, Container Manifest, Breakbulk and LCL Items — filtered by manifest type.

Action Codes (the container-movement vocabulary)

Every Container History row is one dated action against a box.

Code Meaning Kind
RCVE Receive Empty —
RCVF Receive Full —
LODF Load Full (onto a voyage) load
DCHF Discharge Full discharge
DCHE Discharge Empty discharge
SNTS Send / Transfer (ship) —
SNTR Send / Transfer (return) —
DISP Disposal / Disposition —
PURC Purchase —
ONHIRE On Hire —
AV Available —
DMR / DMX Demurrage / Demurrage Exchange —
SOLD Sold —

DCHF starts the storage clock; the container's next LODF stops it — that pairing is what the demurrage reports charge on.

Statuses & Types

  • Container status — FCL (full container load) · EMPTY · LCL. Movements use FCL / EMPTY; a box's current state is its latest action, denormalised onto the container for the list view.
  • Manifest type — Container · Breakbulk · LCL - Breakbulk. Assigned to full-container moves; empty repositioning carries no manifest.
  • Charge type — STORAGE · DETENTION · POWER (reefer power).
  • Demurrage period — OPEN (still accruing) → CLOSED → CLOSED_INVOICED; plus WAIVED, DISPUTED, INTERNAL.
  • Demurrage invoice — DRAFT → SENT (or FAILED).
  • Detention flag (on a movement) — PENDING · OVERDUE · PAID · WAIVED · CLEARED.

Depots, Rates & Geography

  • Lane — a scheduled service between Port Meridian (mainland hub) and Halcyon (island), with smaller feeder ports (Kestrel Bay, Saltmarsh, Emberton, Verdon Cove). ~85% of voyages work the Meridian ↔ Halcyon trunk.
  • Depots — MRD (Port Meridian) and HAL (Halcyon). Currency is USD.
  • Free days — 7 for storage, 30 for detention.
  • Rate bands (per container size × depot, in Depot Charge Rate): storage/detention run in tiers (e.g. days 8–14, 15–21, 22+), with a flat reefer power rate.

Demo Data at a Glance

  • ~2,200 containers · ~150 voyages · 11,000+ movements · 758 clients · ~440 demurrage periods.
  • Roles: demo_admin (developer) · demo_supervisor (supervisor) · demo_viewer (read-only).
  • The dataset is kept "live" — a background top-up appends recent movements so the dashboard's rolling-window figures stay current.

Rules of Thumb

  • Demurrage = days between DCHF and the next LODF, minus the depot's free days, charged at the tiered daily rate for that size, charge type and depot. A box discharged and not yet reloaded is an open, still-accruing period.
  • An owner marked not demurrage_applicable (e.g. the house fleet) is excluded from charging.
  • Storage is billed to the consignee, detention to the shipper.
  • Chargeable periods bundle into an invoice (Invoice Run); clients with open charges are chased by Send Notifications.
  • Duplicate clients: a variant flagged possible_duplicate points at a canonical client; Client Alias maps raw import-source names to the resolved client.
  • Transshipment: roughly one movement in six notes a connecting-leg voyage (some recorded only as "voyage not recorded").