create-vrrsystem-app 1.0.0

package/templates/VehicleRentalReservationSystem/backend-project/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "vrs-backend",
+  "version": "1.0.0",
+  "description": "Vehicle Rental & Reservation System - Backend",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js",
+    "seed": "node seed/seed.js"
+  },
+  "dependencies": {
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.5",
+    "express-validator": "^7.0.1",
+    "helmet": "^7.1.0",
+    "jsonwebtoken": "^9.0.2",
+    "mongoose": "^8.0.3",
+    "morgan": "^1.10.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.2"
+  }
+}

package/templates/VehicleRentalReservationSystem/backend-project/routes/auth.routes.js

@@ -0,0 +1,21 @@
+const router = require('express').Router();
+const { body } = require('express-validator');
+const c = require('../controllers/auth.controller');
+const validate = require('../middleware/validate');
+const { protect } = require('../middleware/auth');
+
+router.post('/register', [
+  body('username').isLength({ min: 3 }),
+  body('password').isLength({ min: 6 }),
+  body('role').optional().isIn(['ADMIN','STAFF','MANAGER'])
+], validate, c.register);
+
+router.post('/login', [
+  body('username').notEmpty(),
+  body('password').notEmpty()
+], validate, c.login);
+
+router.post('/refresh', c.refresh);
+router.post('/logout', c.logout);
+router.get('/me', protect, c.me);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/customer.routes.js

@@ -0,0 +1,20 @@
+const router = require('express').Router();
+const { body } = require('express-validator');
+const c = require('../controllers/customer.controller');
+const validate = require('../middleware/validate');
+const { protect, authorize } = require('../middleware/auth');
+
+router.use(protect);
+const rules = [
+  body('fullName').notEmpty().withMessage('Full name required'),
+  body('nationalId').isLength({ min: 6 }).withMessage('Invalid National ID'),
+  body('phone').matches(/^[+0-9\s-]{7,20}$/).withMessage('Invalid phone'),
+  body('email').isEmail().withMessage('Invalid email'),
+  body('address').notEmpty()
+];
+router.get('/', c.list);
+router.get('/:id', c.get);
+router.post('/', authorize('ADMIN','STAFF'), rules, validate, c.create);
+router.put('/:id', authorize('ADMIN','STAFF'), c.update);
+router.delete('/:id', authorize('ADMIN'), c.remove);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/dashboard.routes.js

@@ -0,0 +1,6 @@
+const router = require('express').Router();
+const c = require('../controllers/dashboard.controller');
+const { protect } = require('../middleware/auth');
+router.use(protect);
+router.get('/', c.stats);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/report.routes.js

@@ -0,0 +1,6 @@
+const router = require('express').Router();
+const c = require('../controllers/report.controller');
+const { protect, authorize } = require('../middleware/auth');
+router.use(protect, authorize('ADMIN','MANAGER','STAFF'));
+router.get('/', c.generate);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/reservation.routes.js

@@ -0,0 +1,14 @@
+const router = require('express').Router();
+const c = require('../controllers/reservation.controller');
+const { protect, authorize } = require('../middleware/auth');
+router.use(protect);
+router.get('/', c.list);
+router.get('/:id', c.get);
+router.post('/', authorize('ADMIN','STAFF'), c.create);
+router.put('/:id', authorize('ADMIN','STAFF'), c.update);
+router.delete('/:id', authorize('ADMIN'), c.remove);
+router.patch('/:id/approve', authorize('ADMIN','MANAGER'), c.approve);
+router.patch('/:id/reject', authorize('ADMIN','MANAGER'), c.reject);
+router.patch('/:id/pickup', authorize('ADMIN','STAFF'), c.pickup);
+router.patch('/:id/return', authorize('ADMIN','STAFF'), c.returnVehicle);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/user.routes.js

@@ -0,0 +1,10 @@
+const router = require('express').Router();
+const c = require('../controllers/user.controller');
+const { protect, authorize } = require('../middleware/auth');
+router.use(protect, authorize('ADMIN'));
+router.get('/', c.list);
+router.get('/:id', c.get);
+router.post('/', c.create);
+router.put('/:id', c.update);
+router.delete('/:id', c.remove);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/routes/vehicle.routes.js

@@ -0,0 +1,21 @@
+const router = require('express').Router();
+const { body } = require('express-validator');
+const c = require('../controllers/vehicle.controller');
+const validate = require('../middleware/validate');
+const { protect, authorize } = require('../middleware/auth');
+
+router.use(protect);
+const rules = [
+  body('plateNumber').notEmpty(),
+  body('brand').notEmpty(),
+  body('model').notEmpty(),
+  body('year').isInt({ min: 1980 }),
+  body('vehicleType').notEmpty(),
+  body('purchasePrice').isFloat({ min: 0 })
+];
+router.get('/', c.list);
+router.get('/:id', c.get);
+router.post('/', authorize('ADMIN'), rules, validate, c.create);
+router.put('/:id', authorize('ADMIN'), c.update);
+router.delete('/:id', authorize('ADMIN'), c.remove);
+module.exports = router;

package/templates/VehicleRentalReservationSystem/backend-project/seed/seed.js

@@ -0,0 +1,80 @@
+require('dotenv').config();
+const mongoose = require('mongoose');
+const connectDB = require('../config/db');
+const User = require('../models/User');
+const Customer = require('../models/Customer');
+const Vehicle = require('../models/Vehicle');
+const RR = require('../models/ReservationRental');
+
+const firstNames = ['Jean','Eric','Aline','Claudine','Patrick','Diane','Olivier','Sandrine','Emmanuel','Yvette','Pacifique','Ange','Fabrice','Solange','Innocent','Beatrice','Theodore','Josiane','Felix','Mireille'];
+const lastNames  = ['Uwase','Niyonsenga','Mukamana','Habimana','Iradukunda','Mugisha','Ndayisaba','Ingabire','Tuyishime','Rugamba','Mutuyimana','Nzeyimana','Kayitesi','Bizimana','Munyaneza','Hakizimana','Uwimana','Mukantwari','Nshimiyimana','Twagirayezu'];
+const types = ['Sedan','SUV','Hatchback','Pickup','Van','Bus','Truck','Coupe'];
+const brands = [['Toyota','Corolla'],['Toyota','Hilux'],['Honda','Civic'],['Nissan','Patrol'],['Hyundai','Tucson'],['Kia','Sportage'],['Ford','Ranger'],['Mazda','CX-5'],['Mitsubishi','Pajero'],['Suzuki','Vitara']];
+
+const rand = (a) => a[Math.floor(Math.random()*a.length)];
+const randInt = (a,b) => Math.floor(Math.random()*(b-a+1))+a;
+
+(async () => {
+  await connectDB();
+  console.log('Clearing collections...');
+  await Promise.all([User.deleteMany(), Customer.deleteMany(), Vehicle.deleteMany(), RR.deleteMany()]);
+
+  console.log('Creating users...');
+  const users = await User.create([
+    { username: 'admin',   password: 'admin123',   fullName: 'System Administrator', email: 'admin@swiftwheels.rw',   role: 'ADMIN' },
+    { username: 'manager', password: 'manager123', fullName: 'Operations Manager',  email: 'manager@swiftwheels.rw', role: 'MANAGER' },
+    { username: 'staff',   password: 'staff123',   fullName: 'Front Desk Staff',    email: 'staff@swiftwheels.rw',   role: 'STAFF' }
+  ]);
+
+  console.log('Creating 20 customers...');
+  const customers = [];
+  for (let i = 0; i < 20; i++) {
+    const fn = rand(firstNames), ln = rand(lastNames);
+    customers.push(await Customer.create({
+      fullName: `${fn} ${ln}`,
+      nationalId: '1' + (199500000000 + i * 137 + randInt(0,9)).toString(),
+      phone: '+25078' + randInt(1000000, 9999999),
+      email: `${fn.toLowerCase()}.${ln.toLowerCase()}${i}@example.rw`,
+      address: rand(['Huye','Kigali','Musanze','Rubavu','Nyagatare','Muhanga']) + ', Rwanda'
+    }));
+  }
+
+  console.log('Creating 20 vehicles...');
+  const vehicles = [];
+  for (let i = 0; i < 20; i++) {
+    const [brand, model] = rand(brands);
+    vehicles.push(await Vehicle.create({
+      plateNumber: 'RAB' + randInt(100,999) + String.fromCharCode(65+randInt(0,25)),
+      brand, model, year: randInt(2015, 2024),
+      vehicleType: rand(types),
+      purchasePrice: randInt(15000, 60000),
+      dailyRate: randInt(40, 200),
+      status: 'AVAILABLE'
+    }));
+  }
+
+  console.log('Creating 30 reservations...');
+  const statuses = ['PENDING','APPROVED','COMPLETED','REJECTED','CANCELLED'];
+  for (let i = 0; i < 30; i++) {
+    const start = new Date(); start.setDate(start.getDate() - randInt(-15, 60));
+    const end = new Date(start); end.setDate(end.getDate() + randInt(1, 10));
+    const days = Math.max(1, Math.ceil((end-start)/86400000));
+    const v = rand(vehicles);
+    const status = rand(statuses);
+    await RR.create({
+      customerId: rand(customers)._id,
+      vehicleId: v._id,
+      userId: rand(users)._id,
+      startDate: start, endDate: end,
+      reservationStatus: status,
+      rentalDate: status === 'COMPLETED' ? start : null,
+      returnDate: status === 'COMPLETED' ? end : null,
+      rentalStatus: status === 'COMPLETED' ? 'RETURNED' : 'NOT_STARTED',
+      rentalFee: days * v.dailyRate
+    });
+  }
+
+  console.log('✅ Seed complete');
+  console.log('Login: admin/admin123, manager/manager123, staff/staff123');
+  await mongoose.disconnect();
+})();

package/templates/VehicleRentalReservationSystem/backend-project/server.js

@@ -0,0 +1,40 @@
+require('dotenv').config();
+const express = require('express');
+const cors = require('cors');
+const helmet = require('helmet');
+const morgan = require('morgan');
+const rateLimit = require('express-rate-limit');
+const connectDB = require('./config/db');
+
+const authRoutes = require('./routes/auth.routes');
+const customerRoutes = require('./routes/customer.routes');
+const vehicleRoutes = require('./routes/vehicle.routes');
+const reservationRoutes = require('./routes/reservation.routes');
+const userRoutes = require('./routes/user.routes');
+const reportRoutes = require('./routes/report.routes');
+const dashboardRoutes = require('./routes/dashboard.routes');
+const errorHandler = require('./middleware/errorHandler');
+
+const app = express();
+connectDB();
+
+app.use(helmet());
+app.use(cors({ origin: process.env.CLIENT_URL || '*', credentials: true }));
+app.use(express.json({ limit: '5mb' }));
+app.use(morgan('dev'));
+app.use('/api/', rateLimit({ windowMs: 15 * 60 * 1000, max: 500 }));
+
+app.get('/', (req, res) => res.json({ message: 'VRS API running', version: '1.0.0' }));
+app.use('/api/auth', authRoutes);
+app.use('/api/customers', customerRoutes);
+app.use('/api/vehicles', vehicleRoutes);
+app.use('/api/reservations', reservationRoutes);
+app.use('/api/users', userRoutes);
+app.use('/api/reports', reportRoutes);
+app.use('/api/dashboard', dashboardRoutes);
+
+app.use((req, res) => res.status(404).json({ message: 'Route not found' }));
+app.use(errorHandler);
+
+const PORT = process.env.PORT || 5000;
+app.listen(PORT, () => console.log(`🚗 VRS Backend running on port ${PORT}`));

package/templates/VehicleRentalReservationSystem/backend-project/utils/token.js

@@ -0,0 +1,3 @@
+const jwt = require('jsonwebtoken');
+exports.signAccess = (user) => jwt.sign({ id: user._id, role: user.role }, process.env.JWT_SECRET, { expiresIn: process.env.JWT_EXPIRES_IN || '1d' });
+exports.signRefresh = (user) => jwt.sign({ id: user._id }, process.env.JWT_REFRESH_SECRET, { expiresIn: process.env.JWT_REFRESH_EXPIRES_IN || '7d' });

package/templates/VehicleRentalReservationSystem/frontend-project/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>SwiftWheels VRS</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>