Engr-Dolo/teddyride-delivery

TeddyRide Delivery is a business-ready local logistics platform built for households, retailers, and growing businesses that need dependable last-mile delivery across Liberia. The platform combines customer order booking, admin-led operations control, rider workflow support, live tracking, and delivery confirmation into one operating system. # TeddyRide Delivery TeddyRide Delivery is a business-ready local logistics platform built for households, retailers, and growing businesses that need dependable last-mile delivery across Liberia. The platform combines customer order booking, admin-led operations control, rider workflow support, live tracking, and delivery confirmation into one operating system. ## What The Platform Does - Customers can place delivery requests and receive tracking codes. - Operations teams can review orders, assign riders, monitor service activity, and manage rider capacity. - Riders can sign in, view active work, start trips, and confirm completed handoffs. - Customers can track active orders and see delivery confirmation progress. ## Current Product Surfaces - Customer home: `/` - Admin operations dashboard: `/admin` - Rider workspace: `/rider` - Backend API: `localhost` ## Technology Stack - Frontend: Next.js 16, React, Tailwind CSS - Backend: Express 5, Node.js, MongoDB, Mongoose - Authentication: secure server-managed admin and rider sessions - Delivery controls: tracking codes, rider assignment, OTP-ready delivery confirmation ## Local Setup ### 1. Install dependencies ```bash cd client npm install cd ../server npm install ``` ### 2. Configure environment files - Frontend example: client/.env.local.example - Backend example: server/.env.example ### 3. Start the platform In one terminal: ```bash cd server npm run dev ``` In another terminal: ```bash cd client npm run dev ``` ## Documentation - Full platform report: docs/TeddyRide-Platform-Report.md - Frontend guide: client/README.md ## Current Milestone TeddyRide now supports: - secure admin access - rider registration and rider sign-in - customer order intake - tracking code lookup - rider assignment - delivery start and completion flow - OTP-ready confirmation workflow for drop-off ## Recommended Next Build Layers - SMS and WhatsApp notification provider abstraction for Liberia and diaspor …