Benzene Solutions - Transport Management System (TMS)

A comprehensive Transport Management System for managing Full Truck Load operations.

Features

• Shipment Management: Create, track, and manage shipments through all stages
• Vehicle Management: Track vehicle status, driver details, and hire rates
• Contract Management: Manage predefined rate contracts with multiple variables
• Invoice Management: Generate and track invoices with payment status
• Hire Slip Management: Track vehicle hire payments and balances
• Notifications: Email, SMS, and WhatsApp notifications
• Dashboard: Real-time analytics and reporting

Quick Start

1. Install MongoDB (if not already installed)
2. Run the setup script (if you haven't already)
3. Install dependencies:

   cd server && npm install
   cd ../client && npm install

4. Start the backend:

   cd server && npm run dev

5. Start the frontend (in a new terminal):

   cd client && npm start

6. Access the application at http://localhost:3000

Demo Credentials

• Email: [email protected]
• Password: admin123

Environment Setup

Backend (.env)

Configure the following variables in server/.env:

• MONGODB_URI: MongoDB connection string
• JWT_SECRET: Secret key for JWT tokens
• EMAIL_USER & EMAIL_PASS: For email notifications
• TWILIO_*: For SMS/WhatsApp notifications

Frontend (.env)

• REACT_APP_API_URL: Backend API URL (default: http://localhost:5000/api)

API Endpoints

• /api/auth: Authentication (login/register)
• /api/shipments: Shipment CRUD operations
• /api/vehicles: Vehicle management
• /api/contracts: Contract management
• /api/invoices: Invoice management
• /api/hire-slips: Hire slip management
• /api/notifications: Notification services

Technologies Used

• Backend: Node.js, Express, MongoDB, Mongoose
• Frontend: React, Tailwind CSS, React Query
• Authentication: JWT
• Notifications: Nodemailer, Twilio