MySalesRoute
Route sales and field distribution command center
Execution Reset
MySalesRoute command center
This first pass resets the scaffold around route sales, field execution, delivery coordination, and Neon-backed account access.
System slices
Route planning, field execution, order capture, delivery visibility, and account access.
Execution lanes
The product is split into app routes for operators, reps, and dispatchers, with typed modules for route, order, and sync boundaries.
Mobile-first field flow
Start with account access, route visibility, visit execution, order capture, and delivery exceptions before deeper analytics.
Platform boundaries
Auth, route planning, order submission, delivery status, and downstream sync are isolated behind explicit contracts in `lib/`.
Current scope
The scaffold is aimed at the first reliable field-to-fulfillment loop, not the full ERP surface.
- Accounts, routes, visits, and orders live in the Next.js app shell.
- Dispatch, delivery, and integration work is modeled as explicit async boundaries.
- Neon Auth is the planned identity layer for rep and operator access.
- The first build should prioritize execution clarity over broad feature coverage.
Route planning
Define daily territory coverage, stop sequencing, and rep assignments before the field team rolls out.
This belongs in the synchronous app path and should become a planner view backed by territory, customer, and inventory data.
Field execution
Track visit completion, order capture, notes, and exception handling from a mobile-first workflow.
The first implementation should support route progress, quick order entry, and missed-stop follow-up without requiring a heavy admin surface.
Fulfillment and sync
Move approved orders into delivery runs, then persist normalized downstream sync state for operations.
Async workflows should handle release, delivery exceptions, and external system sync while Postgres remains the source of truth.
Next build targets
These are the concrete follow-ons after the reset.
- Prisma schema for accounts, route plans, visits, order drafts, delivery runs, and sync audits.
- Neon Auth session wiring and account-aware layouts for reps and operators.
- Dispatch and fulfillment workflows for route release, stop completion, and delivery exceptions.
- ERP or accounting integration boundary for downstream sync once database credentials exist.
Developer notes
The workspace was bootstrapped from the requested shadcn preset.
- `app/` contains the product shell and placeholder routes.
- `components/` contains reusable shell components over the preset baseline.
- `lib/` contains typed contracts for the route sales domain and auth edges.
- Press d anywhere in the app to toggle theme mode.