Voyage Analyser
Ports have limited space to dock. Voyage Analyser reads a ship's cargo manifest before it arrives, works out how much of it is essential, and uses that to decide who docks first, what gets offloaded, and who to notify once it's done.
$ cat tldr.md
Every ship sends its manifest ahead of time. Voyage Analyser turns that file into a docking priority, an offboarding plan, and a queryable index — before the ship is even in sight of the port.
$ cat problems.md
Why this needed building
- Berth space is limited, and deciding which ship docks first is usually a manual call made without a clear read on what each ship is actually carrying.
- Manifests arrive as raw files with no easy way to tell essential cargo from non-essential, let alone ask questions about what's on board.
- Customs filing and notifying cargo owners both happen after the fact, as separate, disconnected steps once the ship has already docked and unloaded.
$ ls features/ -la
What it does
Manifest Intake
Ships submit their cargo manifest ahead of arrival, so analysis starts before they're anywhere near the berth.
Essential / Non-Essential Scoring
Every product line in the manifest gets classified, and the ship's cargo is scored by what percentage of it is essential.
Docking Prioritization
Incoming ships are ranked by that essential-cargo score, so limited berth space goes to the cargo that needs it most.
Offboarding Plan
The exact containers to pull are identified in advance, instead of being worked out dockside after arrival.
AI Manifest Chat
Admins can ask natural-language questions about any manifest — the full cargo data is indexed and queryable on demand.
Customs-Ready Filing
The same indexed, structured data that powers search feeds straight into customs paperwork instead of being re-keyed.
Insights & Charts
Dashboards surface cargo trends, essential/non-essential mix, and throughput across ships and time.
Owner Notifications
Once a shipment is approved and docked, cargo owners get an automatic email or message that their items have arrived.
$ trace pipeline.log
Manifest to dockside, step by step
- 01
Manifest received
A ship nearing port sends its cargo manifest in advance.
- 02
Cargo classified
Every line item is parsed and tagged essential or non-essential.
- 03
Priority computed
The ship gets a docking priority score based on its essential-cargo percentage.
- 04
Offboarding mapped
The specific containers that need to come off are flagged before the ship is even at berth.
- 05
Docked & filed
The ship docks in priority order, and the same indexed data streamlines the customs filing.
- 06
Owners notified
Once approved, cargo owners are emailed or messaged that their shipment has docked.