create-nodemin-app 1.0.16 → 1.0.18

package/bin/cli.js

@@ -5,77 +5,96 @@ const path = require("path");
 const readline = require("readline");
 const { execSync } = require("child_process");
 
-// Create interface
 const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
 });
 
-console.log("\nSelect project to create:\n");
-console.log("1. HRMS_Mongdb(human resource Management System)");
-console.log("1. HRMS_Mysql(human resource Management System)");
+const projects = {
+    "1": { template: "vrrs", project: "vrrs-app", title: "VRRS" },
+    "2": { template: "vrrs-aline", project: "vrrs-aline-app", title: "VRRS-ALINE" },
+    "3": { template: "vrrs-deby", project: "vrrs-deby-app", title: "VRRS-DEBY" },
+    "4": { template: "vrrs-divine", project: "vrrs-divine-app", title: "VRRS-DIVINE" },
+    "5": { template: "vrrs-huggy", project: "vrrs-huggy-app", title: "VRRS-HUGGY" },
+    "6": { template: "vrrs-kelia", project: "vrrs-kelia-app", title: "VRRS-KELIA" },
+    "7": { template: "vrrs-kevine", project: "vrrs-kevine-app", title: "VRRS-KEVINE" },
+    "8": { template: "vrrs-mbarush", project: "vrrs-mbarush-app", title: "VRRS-MBARUSH" },
+    "9": { template: "vrrs-orne", project: "vrrs-orne-app", title: "VRRS-ORNE" },
+    "10": { template: "vrrs-pri", project: "vrrs-pri-app", title: "VRRS-PRI" },
+    "11": { template: "vrrs-price", project: "vrrs-price-app", title: "VRRS-PRICE" },
+    "12": { template: "vrrs-schella", project: "vrrs-schella-app", title: "VRRS-SCHELLA" },
+    "13": { template: "vrrs-trizzy", project: "vrrs-trizzy-app", title: "VRRS-TRIZZY" }
+};
+
+console.log("\n======================================");
+console.log("      SELECT PROJECT TO CREATE");
+console.log("======================================\n");
+
+Object.entries(projects).forEach(([key, value]) => {
+    console.log(`${key}. ${value.title}`);
+});
 
+console.log("");
 
-// Ask user
 rl.question("Enter your choice: ", (choice) => {
 
-    let templateName = "";
-    let projectName = "";
-
-    switch (choice) {
-        case "1":
-            templateName = "HRMS_Mongodb";
-            projectName = "hrms-app";
-            break;
-        case "2":
-            templateName = "HRMS_Mysql";
-            projectName = "hrms-app";
-            break;
-
+    const selectedProject = projects[choice];
 
-
-        default:
-            console.log(" Invalid choice");
-            rl.close();
-            return;
+    if (!selectedProject) {
+        console.log("\n❌ Invalid choice!");
+        rl.close();
+        return;
     }
 
-    const targetPath = path.join(process.cwd(), projectName);
-    const templatePath = path.resolve(__dirname, "../templates", templateName);
+    const templatePath = path.resolve(
+        __dirname,
+        "../templates",
+        selectedProject.template
+    );
+
+    const targetPath = path.join(
+        process.cwd(),
+        selectedProject.project
+    );
 
     if (!fs.existsSync(templatePath)) {
-        console.log(" Template not found:", templatePath);
+        console.log(`\n❌ Template not found: ${templatePath}`);
         rl.close();
         return;
     }
 
     if (fs.existsSync(targetPath)) {
-        console.log(` Folder "${projectName}" already exists`);
+        console.log(`\n❌ Folder "${selectedProject.project}" already exists.`);
         rl.close();
         return;
     }
 
     try {
-        // Create folder
+        console.log("\n📁 Creating project...\n");
+
         fs.mkdirSync(targetPath, { recursive: true });
 
-        // Copy template
-        fs.cpSync(templatePath, targetPath, { recursive: true });
+        fs.cpSync(templatePath, targetPath, {
+            recursive: true
+        });
+
+        console.log(`✅ ${selectedProject.title} created successfully!`);
+        console.log(`📍 Location: ${targetPath}`);
 
-        console.log(`\n ${projectName} created successfully!`);
-        console.log(" Location:", targetPath);
+        console.log("\n📦 Installing dependencies...\n");
 
-        // Install dependencies (IMPORTANT for npx usability)
-        console.log("\n Installing dependencies...\n");
-        execSync(`cd ${targetPath} && npm install`, { stdio: "inherit" });
+        execSync("npm install", {
+            cwd: targetPath,
+            stdio: "inherit"
+        });
 
-        console.log("\n Setup complete!");
-        console.log(`\n Run your project:`);
-        console.log(` cd ${projectName}`);
-        console.log(` npm run dev\n`);
+        console.log("\n🎉 Setup complete!");
+        console.log("\nRun your project:");
+        console.log(`cd ${selectedProject.project}`);
+        console.log("npm run dev\n");
 
     } catch (error) {
-        console.log(" Error:", error.message);
+        console.error("\n❌ Error:", error.message);
     }
 
     rl.close();

package/package.json

@@ -1,7 +1,6 @@
-
 {
   "name": "create-nodemin-app",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "",
   "main": "index.js",
   "bin": {

package/templates/vrrs/README.md

@@ -0,0 +1,161 @@
+# Vehicle Rental and Reservation Subsystem (VRRS)
+
+Web application for **SwitchWheels Enterprise** (Huye) to manage customers, fleet vehicles, reservations/rentals, and reporting.
+
+## Stack
+
+| Layer | Technology | Port |
+|-------|------------|------|
+| Frontend | React + Vite + Tailwind | **5180** |
+| Backend | Express + Mongoose + express-session | **5560** |
+| Database | MongoDB **VRRS** | — |
+
+## Quick start
+
+```bash
+cd vrrs/backend && cp .env.example .env && npm install && npm run dev
+cd vrrs/frontend && npm install && npm run dev
+```
+
+Open http://localhost:5180 — login: `admin` / `admin123`
+
+## Features
+
+| Feature | Implementation |
+|---------|----------------|
+| MongoDB database **VRRS** | `backend/config/db.js` |
+| ERD with PK/FK | Below |
+| Level 0 DFD | Below |
+| CRUD + search | Customers, vehicles, reservations, users |
+| Session login | Cookie `vrrs.sid`, `withCredentials` |
+| Roles | admin, manager, staff |
+| Report | `GET /api/reports/reservation-rental` |
+
+---
+
+## Entity Relationship Diagram (ERD)
+
+```mermaid
+erDiagram
+  CUSTOMERS ||--o{ RESERVATION_RENTALS : "makes"
+  VEHICLES ||--o{ RESERVATION_RENTALS : "involves"
+  USERS ||--o{ RESERVATION_RENTALS : "records"
+
+  CUSTOMERS {
+    int customer_id PK
+    varchar full_name
+    varchar national_id UK
+    varchar phone
+    varchar email
+    varchar address
+  }
+
+  VEHICLES {
+    int vehicle_id PK
+    varchar plate_number UK
+    varchar brand
+    varchar model
+    int year
+    varchar vehicle_type
+    decimal purchase_price
+    enum status
+  }
+
+  RESERVATION_RENTALS {
+    int reservation_rental_id PK
+    date reservation_date
+    date start_date
+    date end_date
+    enum reservation_status
+    date rental_date
+    date return_date
+    decimal rental_fee
+    enum rental_status
+    int customer_id FK
+    int vehicle_id FK
+    int user_id FK
+  }
+
+  USERS {
+    int user_id PK
+    varchar user_name UK
+    varchar password
+    enum role
+  }
+```
+
+### Relationships
+
+1. **Customer (1) — (M) Reservation_Rental**
+2. **Vehicle (1) — (M) Reservation_Rental**
+3. **User (1) — (M) Reservation_Rental**
+
+---
+
+## Level 0 DFD
+
+External entities: **Customer**, **User**, **Manager**
+
+| Process | Data stores |
+|---------|-------------|
+| 1.0 Manage Customers | D1 Customers |
+| 2.0 Manage Vehicles | D2 Vehicles |
+| 3.0 Manage Reservation/Rental | D1, D2, D3 |
+| 4.0 Generate Reports | D1, D2, D3 |
+| 5.0 User Authentication | D4 Users |
+
+```mermaid
+flowchart TB
+  Cust["Customer"]
+  User["User"]
+  Mgr["Manager"]
+  P1(("1.0 Manage Customers"))
+  P2(("2.0 Manage Vehicles"))
+  P3(("3.0 Manage Reservation/Rental"))
+  P4(("4.0 Generate Reports"))
+  P5(("5.0 Authentication"))
+  D1[("D1 Customers")]
+  D2[("D2 Vehicles")]
+  D3[("D3 Reservations")]
+  D4[("D4 Users")]
+  Rpt["Reservation Rental Report"]
+
+  Cust --> P1 --> D1
+  User --> P2 --> D2
+  User --> P3
+  P3 --> D1
+  P3 --> D2
+  P3 --> D3
+  User --> P5 --> D4
+  Mgr --> P4
+  D1 --> P4
+  D2 --> P4
+  D3 --> P4
+  P4 --> Rpt
+```
+
+---
+
+## API
+
+| Method | Endpoint |
+|--------|----------|
+| POST | `/api/auth/login` |
+| POST | `/api/auth/logout` |
+| GET | `/api/auth/me` |
+| CRUD | `/api/customers`, `/api/vehicles`, `/api/reservations` |
+| GET | `*/search?q=` |
+| CRUD | `/api/users` (admin) |
+| GET | `/api/reports/reservation-rental` (manager/admin) — full report |
+| GET | `/api/reports?startDate=&endDate=` (manager/admin) — report by date |
+
+---
+
+## Project structure
+
+```
+vrrs/
+├── README.md
+├── backend/          ← MongoDB (database VRRS)
+└── frontend/
+```

package/templates/vrrs/backend/.env.example

@@ -0,0 +1,4 @@
+PORT=5560
+SESSION_SECRET=change_me_in_production
+FRONTEND_URL=http://localhost:5180
+MONGO_URI=mongodb://localhost:27017/VRRS

package/templates/vrrs/backend/README.md

@@ -0,0 +1,11 @@
+# VRRS Backend
+
+MongoDB database: **VRRS**
+
+```bash
+cp .env.example .env
+npm install
+npm run dev
+```
+
+Port **5560**. Session cookie: `vrrs.sid`. Seed login: `admin` / `admin123`.

package/templates/vrrs/backend/config/db.js

@@ -0,0 +1,33 @@
+import mongoose from "mongoose";
+import dotenv from "dotenv";
+import User from "../models/User.js";
+import Counter from "../models/Counter.js";
+
+dotenv.config();
+
+const ADMIN_HASH = "$2b$10$aULsUjp9bb9lf5CZZyY.7./KhwsocVO0duyPlqu0Qnte75xHBdG5C";
+
+export const connectDatabase = async () => {
+  try {
+    await mongoose.connect(process.env.MONGO_URI || "mongodb://localhost:27017/VRRS");
+    console.log("Database Connected Successfully");
+    if ((await User.countDocuments()) === 0) {
+      await User.create({ user_id: 1, user_name: "admin", password: ADMIN_HASH, role: "admin" });
+      await Counter.findOneAndUpdate({ name: "user_id" }, { seq: 1 }, { upsert: true });
+    }
+    for (const name of ["customer_id", "vehicle_id", "reservation_rental_id", "user_id"]) {
+      await Counter.findOneAndUpdate(
+        { name },
+        { $setOnInsert: { seq: name === "user_id" ? 1 : 0 } },
+        { upsert: true }
+      );
+    }
+    return true;
+  } catch (error) {
+    console.log("Database Connection Failed");
+    console.error(error.message);
+    return false;
+  }
+};
+
+export default mongoose;

package/templates/vrrs/backend/constants/employeeStatuses.js

@@ -0,0 +1,7 @@
+export const EMPLOYEE_STATUSES = [
+  "On Leave",
+  "Left",
+  "Blacklisted",
+  "Deceased",
+  "On Mission",
+];

package/templates/vrrs/backend/constants/statuses.js

@@ -0,0 +1,4 @@
+export const VEHICLE_STATUSES = ["Available", "Reserved", "Rented", "Maintenance", "Sold"];
+export const RESERVATION_STATUSES = ["Pending", "Confirmed", "Cancelled", "Completed"];
+export const RENTAL_STATUSES = ["Not Started", "Active", "Returned", "Overdue"];
+export const USER_ROLES = ["admin", "manager", "staff"];

package/templates/vrrs/backend/controllers/authController.js

@@ -0,0 +1,32 @@
+import bcrypt from "bcryptjs";
+import User from "../models/User.js";
+import { toAuthUser } from "../utils/authUser.js";
+
+export const login = async (req, res) => {
+  try {
+    const { username, password } = req.body;
+    if (!username || !password) return res.status(400).json({ message: "Username and password are required." });
+    const user = await User.findOne({ user_name: username.trim() });
+    if (!user || !(await bcrypt.compare(password, user.password))) {
+      return res.status(401).json({ message: "Invalid credentials." });
+    }
+    const profile = toAuthUser(user);
+    req.session.user = profile;
+    return res.json({ message: "Login successful.", user: profile, auth: { session: true } });
+  } catch {
+    return res.status(500).json({ message: "Server error during login." });
+  }
+};
+
+export const logout = (req, res) => {
+  req.session.destroy((err) => {
+    if (err) return res.status(500).json({ message: "Could not end session." });
+    res.clearCookie("vrrs.sid");
+    return res.json({ message: "Logged out successfully." });
+  });
+};
+
+export const me = (req, res) => {
+  if (!req.session?.user) return res.status(401).json({ message: "Not authenticated." });
+  return res.json({ user: req.session.user });
+};

package/templates/vrrs/backend/controllers/customerController.js

@@ -0,0 +1,103 @@
+import Customer from "../models/Customer.js";
+import ReservationRental from "../models/ReservationRental.js";
+import { nextId } from "../utils/ids.js";
+
+const strip = (d) => {
+  const o = d.toObject ? d.toObject() : d;
+  const { _id, __v, ...r } = o;
+  return r;
+};
+
+export const create = async (req, res) => {
+  try {
+    const { fullName, nationalId, phone, email, address } = req.body;
+    if (!fullName?.trim() || !nationalId?.trim() || !phone?.trim() || !email?.trim() || !address?.trim()) {
+      return res.status(400).json({ message: "All customer fields are required." });
+    }
+    await Customer.create({
+      customer_id: await nextId("customer_id"),
+      full_name: fullName.trim(),
+      national_id: nationalId.trim(),
+      phone: phone.trim(),
+      email: email.trim(),
+      address: address.trim(),
+    });
+    return res.status(201).json({ message: "Customer added successfully." });
+  } catch (e) {
+    if (e.code === 11000) return res.status(409).json({ message: "National ID already exists." });
+    return res.status(500).json({ message: "Failed to add customer." });
+  }
+};
+
+export const getAll = async (_req, res) => {
+  try {
+    return res.json((await Customer.find().sort({ customer_id: -1 }).lean()).map(strip));
+  } catch {
+    return res.status(500).json({ message: "Failed to fetch customers." });
+  }
+};
+
+export const search = async (req, res) => {
+  try {
+    const q = (req.query.q || "").trim();
+    if (!q) return getAll(req, res);
+    const re = new RegExp(q, "i");
+    return res.json(
+      (
+        await Customer.find({
+          $or: [{ full_name: re }, { national_id: re }, { phone: re }, { email: re }],
+        })
+          .sort({ customer_id: -1 })
+          .lean()
+      ).map(strip)
+    );
+  } catch {
+    return res.status(500).json({ message: "Failed to search customers." });
+  }
+};
+
+export const getById = async (req, res) => {
+  try {
+    const doc = await Customer.findOne({ customer_id: Number(req.params.id) }).lean();
+    if (!doc) return res.status(404).json({ message: "Customer not found." });
+    return res.json(strip(doc));
+  } catch {
+    return res.status(500).json({ message: "Failed to fetch customer." });
+  }
+};
+
+export const update = async (req, res) => {
+  try {
+    const { fullName, nationalId, phone, email, address } = req.body;
+    const doc = await Customer.findOneAndUpdate(
+      { customer_id: Number(req.params.id) },
+      {
+        full_name: fullName?.trim(),
+        national_id: nationalId?.trim(),
+        phone: phone?.trim(),
+        email: email?.trim(),
+        address: address?.trim(),
+      },
+      { new: true }
+    );
+    if (!doc) return res.status(404).json({ message: "Customer not found." });
+    return res.json({ message: "Customer updated successfully." });
+  } catch (e) {
+    if (e.code === 11000) return res.status(409).json({ message: "National ID already exists." });
+    return res.status(500).json({ message: "Failed to update customer." });
+  }
+};
+
+export const remove = async (req, res) => {
+  try {
+    const id = Number(req.params.id);
+    if (await ReservationRental.findOne({ customer_id: id })) {
+      return res.status(409).json({ message: "Cannot delete: customer has reservations/rentals." });
+    }
+    const doc = await Customer.findOneAndDelete({ customer_id: id });
+    if (!doc) return res.status(404).json({ message: "Customer not found." });
+    return res.json({ message: "Customer deleted successfully." });
+  } catch {
+    return res.status(500).json({ message: "Failed to delete customer." });
+  }
+};

package/templates/vrrs/backend/controllers/reportController.js

@@ -0,0 +1,88 @@
+import Customer from "../models/Customer.js";
+import Vehicle from "../models/Vehicle.js";
+import ReservationRental from "../models/ReservationRental.js";
+
+const fmt = (d) => {
+  if (!d) return null;
+  const date = d instanceof Date ? d : new Date(d);
+  if (!Number.isNaN(date.getTime())) return date.toISOString().slice(0, 10);
+  const s = String(d);
+  return /^\d{4}-\d{2}-\d{2}/.test(s) ? s.slice(0, 10) : null;
+};
+
+const inRange = (dateStr, start, end) => {
+  if (!dateStr) return false;
+  const d = fmt(dateStr);
+  return d >= start && d <= end;
+};
+
+async function buildReportRows(filterFn = null) {
+  const rows = await ReservationRental.find().sort({ reservation_rental_id: -1 }).lean();
+  const customers = Object.fromEntries((await Customer.find().lean()).map((c) => [c.customer_id, c]));
+  const vehicles = Object.fromEntries((await Vehicle.find().lean()).map((v) => [v.vehicle_id, v]));
+  const filtered = filterFn ? rows.filter(filterFn) : rows;
+  return filtered.map((r) => {
+    const c = customers[r.customer_id] || {};
+    const v = vehicles[r.vehicle_id] || {};
+    return {
+      customer_full_name: c.full_name,
+      national_id: c.national_id,
+      phone_number: c.phone,
+      vehicle_plate_number: v.plate_number,
+      vehicle_brand: v.brand,
+      vehicle_model: v.model,
+      vehicle_year: v.year,
+      vehicle_type: v.vehicle_type,
+      reservation_date: fmt(r.reservation_date),
+      rental_start_date: fmt(r.start_date),
+      rental_end_date: fmt(r.end_date),
+      reservation_status: r.reservation_status,
+      rental_date: fmt(r.rental_date),
+      return_date: fmt(r.return_date),
+      rental_fee: r.rental_fee,
+      rental_status: r.rental_status,
+      reservation_rental_id: r.reservation_rental_id,
+    };
+  });
+}
+
+export const getReservationRentalReport = async (_req, res) => {
+  try {
+    const report = await buildReportRows();
+    return res.json({
+      reportTitle: "Customer Vehicle Reservation Rental Report",
+      company: "SwitchWheels Enterprise — Huye",
+      totalRecords: report.length,
+      rows: report,
+    });
+  } catch {
+    return res.status(500).json({ message: "Failed to generate report." });
+  }
+};
+
+export const getReportByDate = async (req, res) => {
+  try {
+    const { startDate, endDate } = req.query;
+    if (!startDate || !endDate) {
+      return res.status(400).json({ message: "Start date and end date are required." });
+    }
+    if (startDate > endDate) {
+      return res.status(400).json({ message: "Start date must be before or equal to end date." });
+    }
+
+    const report = await buildReportRows(
+      (r) => inRange(r.reservation_date, startDate, endDate) || inRange(r.start_date, startDate, endDate)
+    );
+
+    return res.json({
+      reportTitle: "Reservation & Rental Report by Date",
+      company: "SwitchWheels Enterprise — Huye",
+      startDate,
+      endDate,
+      totalRecords: report.length,
+      rows: report,
+    });
+  } catch {
+    return res.status(500).json({ message: "Failed to generate report." });
+  }
+};