🚚 Logistics & Supply Chain · C4 Architecture · Pro
Shipment Tracking Platform Architecture
A logistics platform that tracks shipments across carriers: booking, scan events from hubs, carrier integrations and customer notifications.
C4 Architecture diagrams are part of Pro. Anyone can view this one; generating and editing it needs Pro.
Drawing diagram…
What this diagram shows
- Scan events from hubs and carriers flow through one event stream
- Carrier adapters normalise different carrier APIs
- Customers and businesses track through the same tracking API
Prompt used
A shipment tracking platform: shippers book shipments on a web app, hub staff scan parcels with a handheld app, and third-party carriers send updates through carrier adapter services. All scan events go to Kafka, a tracking service builds the current status in PostgreSQL, an ETA service predicts delivery time, and a notification service sends SMS/WhatsApp updates to recipients. Businesses use a public tracking API.
Mermaid code
C4Container
title Shipment Tracking Platform
Person(shipper, "Shipper", "Books shipments")
Person(hubstaff, "Hub Staff", "Scans parcels")
Person(recipient, "Recipient", "Tracks parcel")
System_Boundary(ship, "Tracking Platform") {
Container(web, "Shipper Portal", "React", "Bookings and labels")
Container(scan, "Hub Scanner App", "Android", "Scan events")
Container(adapters, "Carrier Adapters", "Node.js", "Normalise carrier updates")
ContainerQueue(events, "Scan Events", "Kafka", "All tracking events")
Container(track, "Tracking Service", "Go", "Current status")
Container(eta, "ETA Service", "Python", "Delivery time prediction")
Container(notify, "Notification Service", "Node.js", "SMS and WhatsApp")
ContainerDb(db, "Tracking DB", "PostgreSQL", "Shipments and events")
}
System_Ext(carriers, "Partner Carriers", "Courier APIs")
Rel(shipper, web, "Uses")
Rel(hubstaff, scan, "Uses")
Rel(scan, events, "Publishes")
Rel(carriers, adapters, "Webhooks")
Rel(adapters, events, "Publishes")
Rel(events, track, "Consumed by")
Rel(track, db, "Stores")
Rel(track, eta, "Asks ETA")
Rel(track, notify, "Status changes")
Rel(notify, recipient, "Sends updates")Related templates
Last-Mile Delivery Sequence
From an order leaving the hub to the parcel at the customer's door: rider assignment, live tracking, OTP handover and proof of delivery.
Warehouse Inbound Receiving
How a warehouse receives goods: appointment, unloading, checking against the ASN, quality check, putaway and stock update.
Fleet Route Optimisation Data Flow
How a delivery company plans daily routes: orders, vehicle capacity, time windows and live traffic feed a route optimiser that assigns stops to drivers.
Freight Booking Lifecycle
The states of a freight shipment booking, from quote and booking through pickup, transit, customs and delivery.
Cold Chain Monitoring Deployment
Where cold chain monitoring runs for vaccines or fresh food: temperature loggers in reefers and cold rooms, gateways, and a cloud alerting platform.
Logistics Shipment Database Schema
Tables for a logistics system: customers, shipments, packages, consignment legs, hubs, vehicles and tracking events.