create-bus-project 1.0.0

package/template/backend/index.js

@@ -0,0 +1,39 @@
+import express from "express";
+import cors from "cors";
+import session from "express-session";
+import dotenv from "dotenv";
+
+import authRoutes from "./routes/authRoutes.js";
+import userRoutes from "./routes/userRoutes.js";
+import busRoutes from "./routes/busRoutes.js";
+import scheduleRoutes from "./routes/scheduleRoutes.js";
+import bookingRoutes from "./routes/bookingRoutes.js";
+
+dotenv.config();
+
+const app = express();
+
+app.use(cors({
+  origin: process.env.FRONTEND_URL || "http://localhost:__FRONTEND_PORT__",
+  credentials: true
+}));
+
+app.use(express.json());
+
+app.use(session({
+  secret: process.env.SESSION_SECRET || "y_bus_secret",
+  resave: false,
+  saveUninitialized: false
+}));
+
+app.use("/api/auth", authRoutes);
+app.use("/api/users", userRoutes);
+app.use("/api/buses", busRoutes);
+app.use("/api/schedules", scheduleRoutes);
+app.use("/api/bookings", bookingRoutes);
+
+const PORT = process.env.PORT || __BACKEND_PORT__;
+
+app.listen(PORT, () => {
+  console.log(`Server running on port ${PORT}`);
+});

package/template/backend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "__PROJECT_NAME__-backend",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js",
+    "dev": "nodemon index.js",
+    "seed": "node seeders/seedUsers.js"
+  },
+  "dependencies": {
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "express-session": "^1.18.0",
+    "mysql2": "^3.11.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.14"
+  }
+}

package/template/backend/routes/authRoutes.js

@@ -0,0 +1,17 @@
+import express from "express";
+
+import {
+  register,
+  login,
+  logout,
+  me
+} from "../controllers/authController.js";
+
+const router = express.Router();
+
+router.post("/register", register);
+router.post("/login", login);
+router.post("/logout", logout);
+router.get("/me", me);
+
+export default router;

package/template/backend/routes/bookingRoutes.js

@@ -0,0 +1,20 @@
+import express from "express";
+import {
+  getBookings,
+  getMyBookings,
+  getBookedSeats,
+  createBooking,
+  deleteBooking,
+  bookingReport
+} from "../controllers/bookingController.js";
+
+const router = express.Router();
+
+router.get("/", getBookings);
+router.get("/my/:userid", getMyBookings);
+router.get("/seats/:scheduleid", getBookedSeats);
+router.post("/", createBooking);
+router.delete("/:id", deleteBooking);
+router.get("/report", bookingReport);
+
+export default router;

package/template/backend/routes/busRoutes.js

@@ -0,0 +1,10 @@
+import express from "express";
+import { getBuses, createBus, deleteBus } from "../controllers/busController.js";
+
+const router = express.Router();
+
+router.get("/", getBuses);
+router.post("/", createBus);
+router.delete("/:id", deleteBus);
+
+export default router;

package/template/backend/routes/scheduleRoutes.js

@@ -0,0 +1,10 @@
+import express from "express";
+import { getSchedules, createSchedule, deleteSchedule } from "../controllers/scheduleController.js";
+
+const router = express.Router();
+
+router.get("/", getSchedules);
+router.post("/", createSchedule);
+router.delete("/:id", deleteSchedule);
+
+export default router;

package/template/backend/routes/userRoutes.js

@@ -0,0 +1,10 @@
+import express from "express";
+import { getUsers, createUser, deleteUser } from "../controllers/userController.js";
+
+const router = express.Router();
+
+router.get("/", getUsers);
+router.post("/", createUser);
+router.delete("/:id", deleteUser);
+
+export default router;

package/template/backend/schema.sql

@@ -0,0 +1,59 @@
+CREATE DATABASE IF NOT EXISTS __DB_NAME__;
+USE __DB_NAME__;
+
+DROP TABLE IF EXISTS yk_bookings;
+DROP TABLE IF EXISTS yk_schedules;
+DROP TABLE IF EXISTS yk_buses;
+DROP TABLE IF EXISTS yk_users;
+
+CREATE TABLE yk_users (
+  userid INT AUTO_INCREMENT PRIMARY KEY,
+  username VARCHAR(100) NOT NULL UNIQUE,
+  password VARCHAR(255) NOT NULL,
+  userRole ENUM('passenger','manager','driver') NOT NULL DEFAULT 'passenger'
+);
+
+CREATE TABLE yk_buses (
+  busid INT AUTO_INCREMENT PRIMARY KEY,
+  platenumber VARCHAR(50) NOT NULL UNIQUE,
+  totalseats INT NOT NULL,
+  bustype VARCHAR(100) NOT NULL
+);
+
+CREATE TABLE yk_schedules (
+  scheduleid INT AUTO_INCREMENT PRIMARY KEY,
+  busid INT NOT NULL,
+  routename VARCHAR(100) NOT NULL,
+  departurepoint VARCHAR(100) NOT NULL,
+  destination VARCHAR(100) NOT NULL,
+  departuretime DATETIME NOT NULL,
+  estimatedarrivaltime DATETIME NOT NULL,
+  ticketprice DECIMAL(10,2) NOT NULL,
+  scheduleStatus ENUM('active','cancelled','completed') DEFAULT 'active',
+  FOREIGN KEY (busid) REFERENCES yk_buses(busid) ON DELETE CASCADE
+);
+
+CREATE TABLE yk_bookings (
+  bookingid INT AUTO_INCREMENT PRIMARY KEY,
+  scheduleid INT NOT NULL,
+  userid INT NOT NULL,
+  passengername VARCHAR(100) NOT NULL,
+  passengergender VARCHAR(20) NOT NULL,
+  passengerphone VARCHAR(30) NOT NULL,
+  seatnumber VARCHAR(20) NOT NULL,
+  paymentstatus ENUM('pending','paid') DEFAULT 'pending',
+  bookingdate TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (scheduleid) REFERENCES yk_schedules(scheduleid) ON DELETE CASCADE,
+  FOREIGN KEY (userid) REFERENCES yk_users(userid) ON DELETE CASCADE,
+  UNIQUE(scheduleid, seatnumber)
+);
+
+INSERT INTO yk_buses (platenumber, totalseats, bustype) VALUES
+('RAB 123A', 30, 'Coaster'),
+('RAC 456B', 45, 'Express Bus');
+
+INSERT INTO yk_schedules
+(busid, routename, departurepoint, destination, departuretime, estimatedarrivaltime, ticketprice, scheduleStatus)
+VALUES
+(1, 'Kigali - Huye', 'Kigali', 'Huye', '2026-06-01 08:00:00', '2026-06-01 11:00:00', 5000, 'active'),
+(2, 'Kigali - Musanze', 'Kigali', 'Musanze', '2026-06-01 09:00:00', '2026-06-01 12:00:00', 4500, 'active');

package/template/backend/seeders/seedUsers.js

@@ -0,0 +1,35 @@
+import bcrypt from "bcryptjs";
+import db from "../config/db.js";
+
+const users = [
+  { username: "manager1", password: "123456", userRole: "manager" },
+  { username: "driver1", password: "123456", userRole: "driver" },
+  { username: "passenger1", password: "123456", userRole: "passenger" }
+];
+
+const seedUsers = async () => {
+  for (const user of users) {
+    const hashedPassword = await bcrypt.hash(user.password, 10);
+
+    const sql = `
+      INSERT INTO yk_users(username, password, userRole)
+      VALUES(?,?,?)
+      ON DUPLICATE KEY UPDATE username=username
+    `;
+
+    db.query(sql, [user.username, hashedPassword, user.userRole], (err) => {
+      if (err) {
+        console.log(err.message);
+      } else {
+        console.log(`${user.userRole} seeded`);
+      }
+    });
+  }
+
+  setTimeout(() => {
+    console.log("Seed completed");
+    process.exit();
+  }, 1500);
+};
+
+seedUsers();

package/template/frontend/.env

@@ -0,0 +1 @@
+VITE_API_URL=http://localhost:__BACKEND_PORT__

package/template/frontend/.env.example

@@ -0,0 +1 @@
+VITE_API_URL=http://localhost:__BACKEND_PORT__

package/template/frontend/README.md

@@ -0,0 +1,14 @@
+# Front-end
+
+## Steps
+
+```bash
+npm install
+npm run dev
+```
+
+Open:
+
+```txt
+http://localhost:__FRONTEND_PORT__
+```

package/template/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Y Bus Booking</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/template/frontend/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "__PROJECT_NAME__-frontend",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "start": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "^4.3.1",
+    "jspdf": "^4.2.1",
+    "jspdf-autotable": "^5.0.8",
+    "lucide-react": "^0.468.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "vite": "^5.4.2"
+  }
+}

package/template/frontend/src/App.jsx

@@ -0,0 +1,55 @@
+import React from "react";
+import { useEffect, useState } from "react";
+import Login from "./pages/Login.jsx";
+import ManagerDashboard from "./pages/ManagerDashboard.jsx";
+import PassengerDashboard from "./pages/PassengerDashboard.jsx";
+import { API_BASE_URL } from "./api.js";
+
+export default function App() {
+  const [user, setUser] = useState(null);
+  const [loading, setLoading] = useState(true);
+
+  const checkLoggedUser = async () => {
+    try {
+      const res = await fetch(`${API_BASE_URL}/api/auth/me`, {
+        credentials: "include"
+      });
+
+      if (res.ok) {
+        const data = await res.json();
+        setUser(data);
+      }
+    } catch (error) {
+      console.log(error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    checkLoggedUser();
+  }, []);
+
+  const logout = async () => {
+    await fetch(`${API_BASE_URL}/api/auth/logout`, {
+      method: "POST",
+      credentials: "include"
+    });
+
+    setUser(null);
+  };
+
+  if (loading) {
+    return <div className="center-page">Loading...</div>;
+  }
+
+  if (!user) {
+    return <Login setUser={setUser} />;
+  }
+
+  if (user.userRole === "manager") {
+    return <ManagerDashboard user={user} logout={logout} />;
+  }
+
+  return <PassengerDashboard user={user} logout={logout} />;
+}

package/template/frontend/src/api.js

@@ -0,0 +1 @@
+export const API_BASE_URL = import.meta.env.VITE_API_URL || "http://localhost:__BACKEND_PORT__";

package/template/frontend/src/main.jsx

@@ -0,0 +1,10 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+import App from "./App.jsx";
+import "./style.css";
+
+ReactDOM.createRoot(document.getElementById("root")).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/template/frontend/src/pages/Bookings.jsx

@@ -0,0 +1,129 @@
+import React from "react";
+import { useEffect, useState } from "react";
+import { API_BASE_URL } from "../api.js";
+
+export default function Bookings() {
+  const [bookings, setBookings] = useState([]);
+  const [schedules, setSchedules] = useState([]);
+  const [users, setUsers] = useState([]);
+
+  const [form, setForm] = useState({
+    scheduleid: "",
+    userid: "",
+    passengername: "",
+    passengergender: "Female",
+    passengerphone: "",
+    seatnumber: "",
+    paymentstatus: "pending"
+  });
+
+  const handleChange = (e) => {
+    setForm({
+      ...form,
+      [e.target.name]: e.target.value
+    });
+  };
+
+  const fetchBookings = async () => {
+    const res = await fetch(`${API_BASE_URL}/api/bookings`);
+    const data = await res.json();
+    setBookings(data);
+  };
+
+  const fetchSchedules = async () => {
+    const res = await fetch(`${API_BASE_URL}/api/schedules`);
+    const data = await res.json();
+    setSchedules(data);
+  };
+
+  const fetchUsers = async () => {
+    const res = await fetch(`${API_BASE_URL}/api/users`);
+    const data = await res.json();
+    setUsers(data);
+  };
+
+  useEffect(() => {
+    fetchBookings();
+    fetchSchedules();
+    fetchUsers();
+  }, []);
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+
+    const res = await fetch(`${API_BASE_URL}/api/bookings`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(form)
+    });
+
+    const data = await res.json();
+
+    if (!res.ok) {
+      alert(data.sqlMessage || data.message || "Booking failed`);
+      return;
+    }
+
+    setForm({
+      scheduleid: "",
+      userid: "",
+      passengername: "",
+      passengergender: "Female",
+      passengerphone: "",
+      seatnumber: "",
+      paymentstatus: "pending"
+    });
+
+    fetchBookings();
+  };
+
+  const handleDelete = async (id) => {
+    await fetch(`${API_BASE_URL}/api/bookings/${id}`, {
+      method: "DELETE"
+    });
+
+    fetchBookings();
+  };
+
+  return (
+    <div>
+      <div className="card">
+        <h1>Bookings</h1>
+
+      
+      </div>
+
+      <table>
+        <thead>
+          <tr>
+            <th>Route</th>
+            <th>Passenger</th>
+            <th>Phone</th>
+            <th>Seat</th>
+            <th>Payment</th>
+            <th>Action</th>
+          </tr>
+        </thead>
+
+        <tbody>
+          {bookings.map((booking) => (
+            <tr key={booking.bookingid}>
+              <td>{booking.routename}</td>
+              <td>{booking.passengername}</td>
+              <td>{booking.passengerphone}</td>
+              <td>{booking.seatnumber}</td>
+              <td>{booking.paymentstatus}</td>
+              <td>
+                <button className="delete" onClick={() => handleDelete(booking.bookingid)}>
+                  Delete
+                </button>
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
+    </div>
+  );
+}

package/template/frontend/src/pages/Buses.jsx

@@ -0,0 +1,100 @@
+import React from "react";
+import { useEffect, useState } from "react";
+import { API_BASE_URL } from "../api.js";
+
+export default function Buses() {
+  const [buses, setBuses] = useState([]);
+
+  const [form, setForm] = useState({
+    platenumber: "",
+    totalseats: "",
+    bustype: ""
+  });
+
+  const handleChange = (e) => {
+    setForm({
+      ...form,
+      [e.target.name]: e.target.value
+    });
+  };
+
+  const fetchBuses = async () => {
+    const res = await fetch(`${API_BASE_URL}/api/buses`);
+    const data = await res.json();
+    setBuses(data);
+  };
+
+  useEffect(() => {
+    fetchBuses();
+  }, []);
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+
+    await fetch(`${API_BASE_URL}/api/buses`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(form)
+    });
+
+    setForm({
+      platenumber: "",
+      totalseats: "",
+      bustype: ""
+    });
+
+    fetchBuses();
+  };
+
+  const handleDelete = async (id) => {
+    await fetch(`${API_BASE_URL}/api/buses/${id}`, {
+      method: "DELETE"
+    });
+
+    fetchBuses();
+  };
+
+  return (
+    <div>
+      <div className="card">
+        <h1>Buses</h1>
+
+        <form className="form-grid" onSubmit={handleSubmit}>
+          <input name="platenumber" placeholder="Plate Number" value={form.platenumber} onChange={handleChange} />
+          <input name="totalseats" placeholder="Total Seats" value={form.totalseats} onChange={handleChange} />
+          <input name="bustype" placeholder="Bus Type" value={form.bustype} onChange={handleChange} />
+          <button type="submit">Add Bus</button>
+        </form>
+      </div>
+
+      <table>
+        <thead>
+          <tr>
+            
+            <th>Plate Number</th>
+            <th>Total Seats</th>
+            <th>Bus Type</th>
+            <th>Action</th>
+          </tr>
+        </thead>
+
+        <tbody>
+          {buses.map((bus) => (
+            <tr key={bus.busid}>
+              <td>{bus.platenumber}</td>
+              <td>{bus.totalseats}</td>
+              <td>{bus.bustype}</td>
+              <td>
+                <button className="delete" onClick={() => handleDelete(bus.busid)}>
+                  Delete
+                </button>
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
+    </div>
+  );
+}

package/template/frontend/src/pages/Dashboard.jsx

@@ -0,0 +1,10 @@
+import React from "react";
+export default function Dashboard({ user }) {
+  return (
+    <div className="card">
+      <h1>Ticket Booking and Fleet Management System</h1>
+      <p>This system manages users, buses, schedules, bookings, and passenger reports.</p>
+      {user && <p>Logged in as: <b>{user.username}</b> ({user.userRole})</p>}
+    </div>
+  );
+}