What this is
A working prototype of one narrow tool: it reads a container list, knows each carrier's free time and daily
rates, and tells operations what is about to cost money and who has to act.
What it is not
Not a TMS and not a replacement for one. Your system of record stays where it is. This reads from it (CSV
today, API next) and does the part the TMS does not do well: the deadline layer.
The arithmetic, in one line
Free time starts at vessel discharge, not at collection. Last free day is discharge plus the carrier's free
days. Every day after that is billed per container. Detention is the same idea on the other clock, from
gate-out to empty return.
Three things this version already does
1. Counts both clocks separately (demurrage while the box is in the terminal, detention once it is out).
2. Adds stevedore storage as a third, overlapping charge.
3. Generates a per-client morning brief from the same rows, so the client hears about a delay before the
invoice does.
Next sprint, if it is useful
Carrier API or TMS feed instead of CSV, tariff effective dates, per-client SLA rules, and an alert that goes
to the account owner rather than a dashboard nobody opens.