TOSS TMS

Internal dispatch TMS for Trucking One Stop Shop. TOSS dispatches for several carrier companies and bills each one a percentage of the gross ("dispatch fee"). Same logins as TOSS Leads (shared Supabase project).

What's in it

Area	What it does
Dashboard	Month KPIs, fleet board (which trucks need a load), today's pickups/deliveries, items needing attention, 12-week trend
Loads	List / Board (drag to change status) / Calendar. Filters, bulk status, CSV and printable report
New / edit load	Drop a rate con → broker, rate, stops, miles filled in. Multi-stop editor, Mapbox miles + deadhead, every field editable
Load page	Status stepper, per-stop progress, map, re-assign truck/driver, paperwork checklist (RC/BOL/POD), one-click factoring packet (merged PDF), activity log with notes
Invoices	"Ready to bill" per carrier, invoice from delivered loads, inline-editable invoice, Draft/Sent/Paid/Void (loads follow), overdue tracking, PDF, custom invoices
Analytics	Gross, fee, RPM, miles, collections; by carrier, driver, truck, broker, lane, dispatcher
Fleet & Company	Carriers, trucks (broker sheet with one-tap copy + pitch), drivers (CDL/medical expiry), documents (with expiry), encrypted credentials vault, profile & fee terms
Settings	Team (owners add TOSS accounts), invoice profile, document types, light/dark

Run locally

npm install
npm run dev

Copy .env.example to .env.local and fill in the keys. Open http://localhost:3000.

UI preview without logging in (development only): open http://localhost:3000/preview-ui to browse every page with sample data. /preview-ui?off turns it off. It cannot be enabled in a production build.

Database

Supabase project grvuqxxjjiebnxnwcmxu (shared with TOSS Leads). The TMS owns only public.tms_* and the tms_private schema — see supabase/migrations/0001_tms_core.sql.

• Access: a TOSS account can use the TMS only if it has a row in tms_members (Settings → Team). Owners manage the team, invoice profile, and can delete companies.
• Files: private storage bucket tms-docs, opened through short-lived signed links.
• Vault passwords are encrypted at rest (pgcrypto, key in Supabase Vault).
• Realtime keeps every dispatcher's screen in sync.

Rate confirmation reader

/api/ratecon: PDF text (or page images for scans) → DeepSeek deepseek-flash with a time limit → a local rule-based reader fills anything missing (and everything when DeepSeek is busy) → Mapbox highway miles. The dispatcher reviews and can change every field.