vertical-logistics

# Vertical: Logistics & supply chain — spec it like you've shipped a pallet SMB shipping & inventory has a deep vocabulary and a pile of rules that look optional until a real customer's data hits them. The incumbents (ShipHero, CartonCloud, Descartes ShipRush, GoFreight, AfterShip, FreightPOP) encode decades of this. A naive spec models a "shipment" as a tracking number and a "warehouse" as a quantity column — and ships a toy. This skill is the domain framing so architect/pm don't. The four products and their incumbents: | Product | Archetype | Wedge | Closest incumbent | |---|---|---|---| | shipment-tracking | dashboard | branded customer-facing tracking | AfterShip (lite) | | warehouse-lite | crud | small-warehouse WMS | ShipHero / CartonCloud | | route-optimization | booking | multi-stop route optimization | Descartes / FreightPOP | | po-mgmt | crud | purchase-order lifecycle | GoFreight / FreightPOP | ## 1. Domain vocabulary (use these terms in the spec, not paraphrases) - **TMS vs WMS** — Transportation Management System (moving goods between places: carriers, rates, routes, tracking) vs Warehouse Management System (goods at rest inside a building: SKUs, locations, pick/pack/ship). Don't conflate them; route-optimization + shipment-tracking are TMS-flavoured, warehouse-lite is WMS, po-mgmt straddles. - **Multi-carrier** — a shipment can go via USPS / UPS / FedEx / DHL / regional carriers. Each has its own API, label format, status codes, and webhook shape. -...