Transport - transportation management (TMS)
One controlled record
for how goods move.
This page describes the intended design for the Splenta family's transportation system of record - one place that would know what was planned, who accepted it, where it is, why it is late, whether it was delivered, and what the freight cost. It is a blueprint today, not running software.
designed lifecycle
CX-Freight
carrier
LTL / 2-day
service
3
packages
evidence the record would hold
booking response . label . manifest . tracking id . tracking events . POD . freight cost evidence
Illustrative concept from the TMS blueprint - designed, not live data. No running service backs this card.

Designed capabilities
What one movement record is designed to hold.
These are the capabilities the blueprint sets out - one short line each. None is built yet, so each is written as an intent, not a claim.
Order
Transport orders
Designed to turn each request to move goods into one controlled order - source reference, promise, mode and lifecycle.
Movement
Shipments & loads
Designed to hold the concrete movement - packages, stops, service level, carrier and tracking id - as one record.
Carrier
Carriers & tendering
Designed to tender to carriers, capture acceptance, and confirm bookings against contract and serviceability rules.
Tracking
Tracking events
Designed to normalize carrier, telematics, manual and system milestones into one append-only timeline.
Delivery
Proof of delivery
Designed to capture signature, photo, OTP or document as delivery evidence that is never silently edited.
Finance
Freight-cost evidence
Designed to reconcile quoted, booked and invoiced freight, and hand the variance to finance with evidence.
Exceptions
Exceptions & claims
Designed to classify delays, missed pickups, damage and overcharge, and recommend the safest approved next action.
The designed movement sequence
Planned to delivered, one ordered path.
Every movement is designed to walk one ordered sequence, with a control on each transition - no booking without carrier acceptance, no delivered without proof. This is the designed shape, not a running pipeline.
01
Planned
Order becomes a shipment plan
02
Tendering
Offered to carriers
03
Booked
Carrier accepts
04
In transit
Tracking events land
05
Delivered
Proof of delivery captured
The problem
Logistics truth scatters the moment goods leave the dock.
- Every upstream system grows its own shadow copy of shipment status
- Bookings, tracking and proof of delivery stay locked in carrier portals
- Exceptions and freight overcharges reach the team as surprises
DockThe designed approach
One movement record, from plan to proof of delivery.
- Designed to plan, tender and book carriers from one order
- Designed to normalize every tracking event into one timeline
- Designed to reconcile quoted, booked and invoiced freight for finance
In transitWhere it would sit
Where TMS would sit.
This is a hypothetical placement, not a benchmark - TMS is a blueprint, so it is compared on design intent, not shipped behaviour. The neighbours are real and keep their real strengths.
TMS is pre-code and pre-revenue. Standalone TMS suites keep real breadth and proven scale; spreadsheets and carrier portals are everywhere because they are easy to start with. TMS is designed to trade none of that away except by being family-native and agent-ready by design - a design that does not exist as software yet, which we say plainly.
The designed architecture
The designed architecture, before a line of code.
The story above is the plain version. For evaluators, here is how the blueprint is meant to hold together - the designed transport lifecycle, the proposed agent surface, and the family boundary. All of it is designed, not implemented: there is no service behind any of these panels yet.
The designed transport lifecycle
One coherent record is designed to carry a movement from plan to proof of delivery. Each transition would have a control - no booking without carrier acceptance, no delivered without proof of delivery - and corrections would be append-only, never a silent edit.
Reference flow - outbound parcel (the first proof path, designed)
- 1RMS captures the customer shipping option and delivery promise at checkout.
- 2WMS picks and packs the order, then emits package-ready evidence.
- 3TMS creates the shipment plan from WMS package evidence and the RMS promise.
- 4TMS selects or confirms carrier and service using contract and serviceability rules.
- 5TMS books the carrier and stores the booking response, label, manifest and tracking id.
- 6TMS consumes pickup, in-transit, out-for-delivery, delay and POD events.
- 7TMS classifies exceptions and recommends the safest approved next action.
- 8RMS receives a customer-visible status projection; FMS receives freight cost evidence.
The proposed Arin-over-MCP surface
The blueprint reuses the family pattern already designed for Arin driving SCM: the agent would read facts, classify and prepare an approval-bound action - never book a carrier or close an exception directly. TMS would validate policy and human approval, then execute. This surface is designed, not implemented.
designed MCP surface - read resources
action tools (approval-gated)
Every mutating tool would declare a required tms:* scope and an idempotency key. Booking, cancellation, retender, claim and freight-dispute actions would need an approval state and a reason. Proposals would stay proposals until TMS validates policy and a human approves.
The family boundary
TMS is designed to own transport truth and nothing else - not orders, stock, procurement, accounting or fleet-maintenance truth. It would talk to its neighbours only through REST, MCP and events. Every exchange below is part of the blueprint: designed, not built.
Blueprint stage - shaping the design
Help shape the transport system of record.
TMS is a design-stage blueprint, not a product you can buy or run today. If your team lives in the gap between the warehouse and the carrier, we would like to hear how you move goods and where the truth breaks down. That input shapes what gets built first.