create-myexam-app 1.0.21 → 1.0.22

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/frontend-project/src/pages/Supplier.jsx

@@ -0,0 +1,118 @@
+import React, { useEffect, useState } from "react";
+import { createSupplier, getSuppliers } from "../api/supplierApi";
+import Message from "../components/Message";
+import PageHeader from "../components/PageHeader";
+
+var emptySupplier = {
+  supplierCode: "",
+  supplierName: "",
+  telephone: "",
+  address: "",
+  email: "",
+};
+
+function Supplier() {
+  var formState = useState(emptySupplier);
+  var formData = formState[0];
+  var setFormData = formState[1];
+  var supplierState = useState([]);
+  var suppliers = supplierState[0];
+  var setSuppliers = supplierState[1];
+  var messageState = useState("");
+  var message = messageState[0];
+  var setMessage = messageState[1];
+  var messageTypeState = useState("");
+  var messageType = messageTypeState[0];
+  var setMessageType = messageTypeState[1];
+
+  function loadSuppliers() {
+    return getSuppliers()
+      .then(function (response) {
+        setSuppliers(response.data);
+      });
+  }
+
+  useEffect(function () {
+    loadSuppliers().catch(function () {});
+  }, []);
+
+  function handleChange(event) {
+    var newFormData = Object.assign({}, formData);
+    newFormData[event.target.name] = event.target.value;
+    setFormData(newFormData);
+  }
+
+  function handleSubmit(event) {
+    event.preventDefault();
+    setMessage("");
+
+    createSupplier(formData)
+      .then(function (response) {
+      setMessageType("success");
+      setMessage(response.data.message);
+      setFormData(emptySupplier);
+      loadSuppliers();
+      })
+      .catch(function (error) {
+        setMessageType("error");
+        setMessage(error.response && error.response.data ? error.response.data.message : "Failed to save supplier");
+      });
+  }
+
+  return (
+    <div>
+      <PageHeader title="Supplier" subtitle="Insert supplier records only" />
+
+      <form onSubmit={handleSubmit} className="mb-6 rounded-md border border-slate-200 bg-white p-4">
+        <Message type={messageType} text={message} />
+        <div className="grid gap-4 md:grid-cols-2">
+          {Object.keys(emptySupplier).map(function (field) {
+            return (
+            <div key={field}>
+              <label className="mb-2 block text-sm font-semibold">{field}</label>
+              <input
+                className="w-full rounded-md border border-slate-200 bg-slate-50 px-3 py-2 outline-blue-900"
+                name={field}
+                value={formData[field]}
+                onChange={handleChange}
+                required
+                type={field === "email" ? "email" : "text"}
+              />
+            </div>
+            );
+          })}
+        </div>
+        <button className="mt-4 rounded-md bg-blue-900 px-5 py-2 font-semibold text-slate-50">Insert Supplier</button>
+      </form>
+
+      <div className="overflow-x-auto rounded-md border border-slate-200 bg-white">
+        <table className="w-full min-w-[760px] text-left text-sm">
+          <thead className="bg-blue-900 text-slate-50">
+            <tr>
+              <th className="p-3">Code</th>
+              <th className="p-3">Name</th>
+              <th className="p-3">Telephone</th>
+              <th className="p-3">Address</th>
+              <th className="p-3">Email</th>
+            </tr>
+          </thead>
+          <tbody>
+            {suppliers.map(function (supplier) {
+              return (
+              <tr key={supplier._id} className="border-t border-slate-200">
+                <td className="p-3">{supplier.supplierCode}</td>
+                <td className="p-3">{supplier.supplierName}</td>
+                <td className="p-3">{supplier.telephone}</td>
+                <td className="p-3">{supplier.address}</td>
+                <td className="p-3">{supplier.email}</td>
+              </tr>
+              );
+            })}
+          </tbody>
+        </table>
+      </div>
+    </div>
+  );
+}
+
+export default Supplier;

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/frontend-project/src/styles.css

@@ -0,0 +1,27 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+body {
+  margin: 0;
+  background: #f8fafc;
+  color: #1e3a8a;
+  font-family: Arial, Helvetica, sans-serif;
+}
+
+input,
+select,
+button {
+  font: inherit;
+}
+
+@media print {
+  .no-print {
+    display: none !important;
+  }
+
+  .print-area {
+    padding: 0 !important;
+  }
+}
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/frontend-project/tailwind.config.js

@@ -0,0 +1,8 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: ["./index.html", "./src/**/*.{js,jsx}"],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/frontend-project/vite.config.js

@@ -0,0 +1,6 @@
+var defineConfig = require("vite").defineConfig;
+var react = require("@vitejs/plugin-react");
+
+module.exports = defineConfig({
+  plugins: [react()],
+});

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/README.md

@@ -0,0 +1,84 @@
+# KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026
+
+## Project Name
+
+Stock Management System for StockHub Ltd.
+
+## Technologies Used
+
+Frontend:
+- React.js
+- React Router DOM
+- Axios
+- Tailwind CSS
+
+Backend:
+- Node.js
+- Express.js
+- MongoDB
+- Mongoose
+- bcryptjs
+- express-session
+
+## Installation Steps
+
+1. Open the project folder:
+
+```bash
+cd KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026
+```
+
+2. Install backend dependencies:
+
+```bash
+cd backend-project
+npm install
+```
+
+3. Install frontend dependencies:
+
+```bash
+cd ../frontend-project
+npm install
+```
+
+4. Make sure MongoDB is running locally.
+
+The backend uses this MongoDB database:
+
+```bash
+mongodb://127.0.0.1:27017/SMS
+```
+
+## Backend Startup
+
+```bash
+cd backend-project
+npm run dev
+```
+
+Backend URL:
+
+```bash
+http://localhost:5000
+```
+
+Default login account:
+
+```bash
+Username: manager
+Password: manager123
+```
+
+## Frontend Startup
+
+```bash
+cd frontend-project
+npm run dev
+```
+
+Frontend URL:
+
+```bash
+http://localhost:5173
+```

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/.env

@@ -0,0 +1,3 @@
+PORT=5000
+MONGO_URI=mongodb://127.0.0.1:27017/SMS
+SESSION_SECRET=stockhub_sms_exam_secret

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/config/db.js

@@ -0,0 +1,13 @@
+const mongoose = require("mongoose");
+
+const connectDB = async () => {
+  try {
+    await mongoose.connect(process.env.MONGO_URI || "mongodb://127.0.0.1:27017/SMS");
+    console.log("MongoDB connected to SMS database");
+  } catch (error) {
+    console.error("MongoDB connection failed:", error.message);
+    process.exit(1);
+  }
+};
+
+module.exports = connectDB;

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/productController.js

@@ -0,0 +1,29 @@
+const Product = require("../models/Product");
+
+const createProduct = async (req, res) => {
+  try {
+    const existingProduct = await Product.findOne({ productCode: req.body.productCode });
+    if (existingProduct) {
+      return res.status(400).json({ message: "Product code already exists" });
+    }
+
+    const product = await Product.create(req.body);
+    res.status(201).json({ message: "Product recorded successfully", product });
+  } catch (error) {
+    res.status(400).json({ message: "Product was not recorded", error: error.message });
+  }
+};
+
+const getProducts = async (req, res) => {
+  try {
+    const products = await Product.find().sort({ createdAt: -1 });
+    res.json(products);
+  } catch (error) {
+    res.status(500).json({ message: "Products could not be retrieved", error: error.message });
+  }
+};
+
+module.exports = {
+  createProduct,
+  getProducts
+};

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/reportController.js

@@ -0,0 +1,52 @@
+const Product = require("../models/Product");
+const StockTransaction = require("../models/StockTransaction");
+
+const getDateRange = (period) => {
+  const now = new Date();
+  const start = new Date(now);
+
+  if (period === "weekly") {
+    start.setDate(now.getDate() - 7);
+  } else if (period === "monthly") {
+    start.setMonth(now.getMonth() - 1);
+  } else {
+    start.setHours(0, 0, 0, 0);
+  }
+
+  const end = new Date(now);
+  end.setHours(23, 59, 59, 999);
+
+  return { start, end };
+};
+
+const getReports = async (req, res) => {
+  try {
+    const period = req.query.period || "daily";
+    const { start, end } = getDateRange(period);
+
+    const availableStock = await Product.find().sort({ productName: 1 });
+    const transactions = await StockTransaction.find({
+      transactionDate: { $gte: start, $lte: end }
+    })
+      .populate("product warehouse")
+      .sort({ transactionDate: -1 });
+
+    const stockIn = transactions.filter((item) => item.transactionType === "Stock In");
+    const stockOut = transactions.filter((item) => item.transactionType === "Stock Out");
+
+    res.json({
+      period,
+      startDate: start,
+      endDate: end,
+      availableStock,
+      stockIn,
+      stockOut
+    });
+  } catch (error) {
+    res.status(500).json({ message: "Reports could not be generated", error: error.message });
+  }
+};
+
+module.exports = {
+  getReports
+};

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/stockTransactionController.js

@@ -0,0 +1,128 @@
+const Product = require("../models/Product");
+const StockTransaction = require("../models/StockTransaction");
+
+const applyStockMovement = async (productId, transactionType, quantityMoved) => {
+  const product = await Product.findById(productId);
+
+  if (!product) {
+    throw new Error("Selected product was not found");
+  }
+
+  const quantity = Number(quantityMoved);
+  const newQuantity =
+    transactionType === "Stock In"
+      ? product.quantityInStock + quantity
+      : product.quantityInStock - quantity;
+
+  if (newQuantity < 0) {
+    throw new Error("Stock out quantity cannot be greater than available stock");
+  }
+
+  product.quantityInStock = newQuantity;
+  await product.save();
+};
+
+const reverseStockMovement = async (transaction) => {
+  const oppositeType = transaction.transactionType === "Stock In" ? "Stock Out" : "Stock In";
+  await applyStockMovement(transaction.product, oppositeType, transaction.quantityMoved);
+};
+
+const createTransaction = async (req, res) => {
+  try {
+    const transaction = new StockTransaction(req.body);
+    await transaction.validate();
+    await applyStockMovement(req.body.product, req.body.transactionType, req.body.quantityMoved);
+    await transaction.save();
+    const savedTransaction = await transaction.populate("product warehouse");
+
+    res.status(201).json({
+      message: "Stock transaction recorded successfully",
+      transaction: savedTransaction
+    });
+  } catch (error) {
+    res.status(400).json({ message: "Transaction was not recorded", error: error.message });
+  }
+};
+
+const getTransactions = async (req, res) => {
+  try {
+    const transactions = await StockTransaction.find()
+      .populate("product warehouse")
+      .sort({ transactionDate: -1, createdAt: -1 });
+
+    res.json(transactions);
+  } catch (error) {
+    res.status(500).json({ message: "Transactions could not be retrieved", error: error.message });
+  }
+};
+
+const updateTransaction = async (req, res) => {
+  try {
+    const transaction = await StockTransaction.findById(req.params.id);
+
+    if (!transaction) {
+      return res.status(404).json({ message: "Transaction was not found" });
+    }
+
+    const previousTransaction = {
+      product: transaction.product,
+      transactionType: transaction.transactionType,
+      quantityMoved: transaction.quantityMoved
+    };
+
+    transaction.product = req.body.product;
+    transaction.warehouse = req.body.warehouse;
+    transaction.transactionDate = req.body.transactionDate;
+    transaction.quantityMoved = req.body.quantityMoved;
+    transaction.transactionType = req.body.transactionType;
+    await transaction.validate();
+
+    await applyStockMovement(
+      previousTransaction.product,
+      previousTransaction.transactionType === "Stock In" ? "Stock Out" : "Stock In",
+      previousTransaction.quantityMoved
+    );
+
+    try {
+      await applyStockMovement(req.body.product, req.body.transactionType, req.body.quantityMoved);
+    } catch (error) {
+      await applyStockMovement(
+        previousTransaction.product,
+        previousTransaction.transactionType,
+        previousTransaction.quantityMoved
+      );
+      throw error;
+    }
+
+    await transaction.save();
+
+    const updatedTransaction = await transaction.populate("product warehouse");
+    res.json({ message: "Transaction updated successfully", transaction: updatedTransaction });
+  } catch (error) {
+    res.status(400).json({ message: "Transaction was not updated", error: error.message });
+  }
+};
+
+const deleteTransaction = async (req, res) => {
+  try {
+    const transaction = await StockTransaction.findById(req.params.id);
+
+    if (!transaction) {
+      return res.status(404).json({ message: "Transaction was not found" });
+    }
+
+    await reverseStockMovement(transaction);
+    await StockTransaction.findByIdAndDelete(req.params.id);
+
+    res.json({ message: "Transaction deleted successfully" });
+  } catch (error) {
+    res.status(400).json({ message: "Transaction was not deleted", error: error.message });
+  }
+};
+
+module.exports = {
+  createTransaction,
+  getTransactions,
+  updateTransaction,
+  deleteTransaction
+};

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/userController.js

@@ -0,0 +1,115 @@
+const bcrypt = require("bcryptjs");
+const User = require("../models/User");
+
+const saveSession = (req, res, message, user) => {
+  req.session.user = {
+    id: user._id,
+    username: user.username
+  };
+
+  req.session.save((error) => {
+    if (error) {
+      return res.status(500).json({ message: "Session could not be saved" });
+    }
+
+    res.json({ message, user: req.session.user });
+  });
+};
+
+const register = async (req, res) => {
+  try {
+    const { username, password } = req.body;
+
+    if (!username || !password) {
+      return res.status(400).json({ message: "Username and password are required" });
+    }
+
+    const existingUser = await User.findOne({ username: username.trim() });
+    if (existingUser) {
+      return res.status(400).json({ message: "Username already exists" });
+    }
+
+    const hashedPassword = await bcrypt.hash(password, 10);
+    const user = await User.create({
+      username: username.trim(),
+      password: hashedPassword
+    });
+
+    saveSession(req, res, "Account created successfully", user);
+  } catch (error) {
+    res.status(500).json({ message: "Registration failed", error: error.message });
+  }
+};
+
+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({ username: username.trim() });
+    if (!user) {
+      return res.status(400).json({ message: "Invalid username or password" });
+    }
+
+    const isPasswordCorrect = await bcrypt.compare(password, user.password);
+    if (!isPasswordCorrect) {
+      return res.status(400).json({ message: "Invalid username or password" });
+    }
+
+    saveSession(req, res, "Login successful", user);
+  } catch (error) {
+    res.status(500).json({ message: "Login failed", error: error.message });
+  }
+};
+
+const logout = (req, res) => {
+  req.session.destroy((error) => {
+    if (error) {
+      return res.status(500).json({ message: "Logout failed" });
+    }
+
+    res.clearCookie("connect.sid");
+    res.json({ message: "Logout successful" });
+  });
+};
+
+const getSession = (req, res) => {
+  if (!req.session || !req.session.user) {
+    return res.status(401).json({ message: "No active session" });
+  }
+
+  res.json({ user: req.session.user });
+};
+
+const recoverPassword = async (req, res) => {
+  try {
+    const { username, newPassword } = req.body;
+
+    if (!username || !newPassword) {
+      return res.status(400).json({ message: "Username and new password are required" });
+    }
+
+    const user = await User.findOne({ username: username.trim() });
+    if (!user) {
+      return res.status(404).json({ message: "User account was not found" });
+    }
+
+    user.password = await bcrypt.hash(newPassword, 10);
+    await user.save();
+
+    res.json({ message: "Password changed successfully" });
+  } catch (error) {
+    res.status(500).json({ message: "Password recovery failed", error: error.message });
+  }
+};
+
+module.exports = {
+  register,
+  login,
+  logout,
+  getSession,
+  recoverPassword
+};

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/warehouseController.js

@@ -0,0 +1,29 @@
+const Warehouse = require("../models/Warehouse");
+
+const createWarehouse = async (req, res) => {
+  try {
+    const existingWarehouse = await Warehouse.findOne({ warehouseCode: req.body.warehouseCode });
+    if (existingWarehouse) {
+      return res.status(400).json({ message: "Warehouse code already exists" });
+    }
+
+    const warehouse = await Warehouse.create(req.body);
+    res.status(201).json({ message: "Warehouse recorded successfully", warehouse });
+  } catch (error) {
+    res.status(400).json({ message: "Warehouse was not recorded", error: error.message });
+  }
+};
+
+const getWarehouses = async (req, res) => {
+  try {
+    const warehouses = await Warehouse.find().sort({ createdAt: -1 });
+    res.json(warehouses);
+  } catch (error) {
+    res.status(500).json({ message: "Warehouses could not be retrieved", error: error.message });
+  }
+};
+
+module.exports = {
+  createWarehouse,
+  getWarehouses
+};

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/middleware/authMiddleware.js

@@ -0,0 +1,9 @@
+const requireAuth = (req, res, next) => {
+  if (!req.session || !req.session.user) {
+    return res.status(401).json({ message: "Please login first" });
+  }
+
+  next();
+};
+
+module.exports = requireAuth;

package/projects/SHMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/models/Product.js

@@ -0,0 +1,44 @@
+const mongoose = require("mongoose");
+
+const productSchema = new mongoose.Schema(
+  {
+    productCode: {
+      type: String,
+      required: [true, "Product code is required"],
+      unique: true,
+      trim: true
+    },
+    productName: {
+      type: String,
+      required: [true, "Product name is required"],
+      trim: true
+    },
+    category: {
+      type: String,
+      required: [true, "Category is required"],
+      trim: true
+    },
+    quantityInStock: {
+      type: Number,
+      required: [true, "Quantity in stock is required"],
+      min: [0, "Quantity cannot be negative"]
+    },
+    unitPrice: {
+      type: Number,
+      required: [true, "Unit price is required"],
+      min: [0, "Unit price cannot be negative"]
+    },
+    supplierName: {
+      type: String,
+      required: [true, "Supplier name is required"],
+      trim: true
+    },
+    dateReceived: {
+      type: Date,
+      required: [true, "Date received is required"]
+    }
+  },
+  { timestamps: true }
+);
+
+module.exports = mongoose.model("Product", productSchema);