olarewajuagbaje-eng/jn-logistics-kenya

# JN Logistics Kenya — Operations Platform A complete logistics operations platform replacing manual booking, spreadsheet tracking, phone dispatching, and paper delivery notes with a single connected digital system. --- ## Project Structure ``` jn-logistics/ ├── frontend/ → Next.js 15 app (public site + portal) ├── n8n-workflows/ → 15 importable n8n JSON workflow files ├── airtable-schema/ → Complete Airtable table/field definitions └── documentation/ → Full HTML setup & deployment guide ``` --- ## Quick Start 1. **Read the guide first** — open `documentation/guide.html` in your browser 2. Set up Airtable (7 tables) 3. Import 15 n8n workflows and activate them 4. Set up Cloudinary upload preset 5. Configure Resend SMTP 6. `cd frontend && npm install && npm run dev` 7. Deploy to Vercel via GitHub --- ## Tech Stack | Layer | Technology | |-------|-----------| | Frontend | Next.js 15, TypeScript, Tailwind CSS | | Automation | n8n (15 workflows) | | Database | Airtable | | File Storage | Cloudinary | | Email | Resend (SMTP) | | Deployment | Vercel + GitHub | --- ## Platform Features ### Public - Premium logistics landing page - Shipment request form with full validation - No-login shipment tracking with live timeline and proof of delivery ### Operations Portal - **Admin Dashboard** — metrics, activity feed, revenue - **Dispatch Board** — assign drivers, view all active shipments - **Driver Portal** — mobile-first job management, pickup confirmation, delivery completion with photo POD ### Automation (n8n) | # | Workflow | Trigger | |---|---------|---------| | 01 | Create Shipment | Form submission | | 02 | Assign Driver | Dispatcher action | | 03 | Update Shipment Status | Any status change | | 04 | Driver Confirm Pickup | Driver action | | 05 | Driver In-Transit Update | Location update | | 06 | Complete Delivery | Driver action | | 07 | Upload Proof of Delivery | Delivery completion | | 08 | Generate Invoice | Auto on delivery | | 09 | …