create-myexam-app 1.0.21 → 1.0.23

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/03_Objectives.md

@@ -0,0 +1,17 @@
+# 03. Objectives
+
+## General Objective
+
+To develop a Supply Chain Management System that helps SupplyNet Ltd manage suppliers, shipments, deliveries, and reports digitally.
+
+## Specific Objectives
+
+- To create a secure login system using sessions and encrypted passwords.
+- To insert supplier records with validation and duplicate prevention.
+- To manage shipment records using insert, get, update, and delete operations.
+- To manage delivery records using insert, get, update, and delete operations.
+- To connect suppliers to shipments using Mongoose references.
+- To connect shipments to deliveries using Mongoose references.
+- To generate daily, weekly, and monthly reports.
+- To design a responsive user interface using React.js and Tailwind CSS.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/04_Technologies_Used.md

@@ -0,0 +1,23 @@
+# 04. Technologies Used
+
+## Frontend Technologies
+
+- React.js: Used to build the user interface.
+- React Router DOM: Used for page navigation.
+- Axios: Used to send requests from frontend to backend.
+- Tailwind CSS: Used for responsive styling.
+
+## Backend Technologies
+
+- Node.js: Used as the JavaScript runtime environment.
+- Express.js: Used to create REST API routes.
+- Mongoose: Used to model and validate MongoDB data.
+- bcryptjs: Used to encrypt user passwords.
+- express-session: Used for session-based authentication.
+- cors: Used to allow frontend and backend communication.
+- dotenv: Used to manage environment variables.
+
+## Database
+
+- MongoDB: Used as the NoSQL database.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/05_ERD.md

@@ -0,0 +1,60 @@
+# 05. Entity Relationship Diagram
+
+## Entity List
+
+1. User
+2. Supplier
+3. Shipment
+4. Delivery
+
+## Primary Keys
+
+- User: `_id`
+- Supplier: `_id`
+- Shipment: `_id`
+- Delivery: `_id`
+
+MongoDB automatically creates `_id` as the primary key for every document.
+
+## Important Unique Fields
+
+- User: `username`
+- Supplier: `supplierCode`, `email`
+- Shipment: `shipmentNumber`
+- Delivery: `deliveryCode`
+
+## Foreign Key References
+
+- Shipment contains `supplier`, which references Supplier `_id`.
+- Delivery contains `shipment`, which references Shipment `_id`.
+
+## Relationships and Cardinalities
+
+### Supplier to Shipment
+
+One Supplier can have many Shipments.
+
+Manual ERD drawing:
+
+```text
+Supplier (1) -------------------- (Many) Shipment
+```
+
+The `supplier` field in the Shipment collection stores the referenced Supplier `_id`.
+
+### Shipment to Delivery
+
+One Shipment can have many Deliveries.
+
+Manual ERD drawing:
+
+```text
+Shipment (1) -------------------- (Many) Delivery
+```
+
+The `shipment` field in the Delivery collection stores the referenced Shipment `_id`.
+
+## ERD Drawing Explanation
+
+Draw four rectangles named User, Supplier, Shipment, and Delivery. Under each rectangle, list its fields. Mark `_id` as the primary key. In Shipment, mark `supplier` as a foreign key to Supplier. In Delivery, mark `shipment` as a foreign key to Shipment. Connect Supplier to Shipment using a one-to-many line. Connect Shipment to Delivery using a one-to-many line.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/06_Database_Design.md

@@ -0,0 +1,71 @@
+# 06. Database Design
+
+## Database Name
+
+```text
+SCMS
+```
+
+## Collections
+
+### Users
+
+Fields:
+
+- username
+- password
+
+Validation:
+
+- username is required and unique.
+- password is required and encrypted using bcrypt.
+
+### Suppliers
+
+Fields:
+
+- supplierCode
+- supplierName
+- telephone
+- address
+- email
+
+Validation:
+
+- All fields are required.
+- supplierCode is unique.
+- email is unique.
+
+### Shipments
+
+Fields:
+
+- supplier
+- shipmentNumber
+- shipmentDate
+- shipmentStatus
+- destination
+
+Validation:
+
+- All fields are required.
+- shipmentNumber is unique.
+- supplier references the Suppliers collection.
+
+### Deliveries
+
+Fields:
+
+- shipment
+- deliveryCode
+- deliveryDate
+- quantityDelivered
+- deliveryStatus
+
+Validation:
+
+- All fields are required.
+- deliveryCode is unique.
+- quantityDelivered must be greater than zero.
+- shipment references the Shipments collection.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/07_System_Architecture.md

@@ -0,0 +1,28 @@
+# 07. System Architecture
+
+The system uses MVC architecture on the backend and a component-based React frontend.
+
+## Backend MVC Structure
+
+- Models: Define MongoDB collections and validation rules.
+- Controllers: Contain business logic for authentication and CRUD operations.
+- Routes: Define API endpoints.
+- Middleware: Protect routes using session authentication.
+- Config: Contains MongoDB database connection.
+
+## Frontend Structure
+
+- api: Contains Axios API request files.
+- components: Contains reusable layout and message components.
+- pages: Contains main system pages.
+
+## System Flow
+
+1. The user logs in from the React frontend.
+2. The backend checks username and encrypted password.
+3. If login is successful, a session is created.
+4. The user can access protected pages.
+5. React sends requests to Express API routes using Axios.
+6. Controllers process requests and use Mongoose models to communicate with MongoDB.
+7. Data is returned to the frontend and displayed in forms, tables, and reports.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/08_API_Documentation.md

@@ -0,0 +1,43 @@
+# 08. API Documentation
+
+Base URL:
+
+```text
+http://localhost:5000/api
+```
+
+## User API
+
+| Method | Endpoint | Description |
+| --- | --- | --- |
+| POST | `/users/register` | Create a user account |
+| POST | `/users/login` | Login user |
+| POST | `/users/recover-password` | Recover password |
+| POST | `/users/logout` | Logout user |
+| GET | `/users/session` | Get current session user |
+
+## Supplier API
+
+| Method | Endpoint | Description |
+| --- | --- | --- |
+| POST | `/suppliers` | Insert supplier |
+| GET | `/suppliers` | Get suppliers for display, dropdowns, and reports |
+
+## Shipment API
+
+| Method | Endpoint | Description |
+| --- | --- | --- |
+| POST | `/shipments` | Insert shipment |
+| GET | `/shipments` | Get shipments |
+| PUT | `/shipments/:id` | Update shipment |
+| DELETE | `/shipments/:id` | Delete shipment |
+
+## Delivery API
+
+| Method | Endpoint | Description |
+| --- | --- | --- |
+| POST | `/deliveries` | Insert delivery |
+| GET | `/deliveries` | Get deliveries |
+| PUT | `/deliveries/:id` | Update delivery |
+| DELETE | `/deliveries/:id` | Delete delivery |
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/09_Testing.md

@@ -0,0 +1,43 @@
+# 09. Testing
+
+## Authentication Testing
+
+- Create a new user with username and password.
+- Try to create another user with the same username.
+- Login using valid credentials.
+- Login using invalid credentials.
+- Recover password and login with the new password.
+- Logout and confirm protected pages are not accessible.
+
+## Supplier Testing
+
+- Insert a supplier with all required fields.
+- Try to insert a supplier with missing fields.
+- Try to insert duplicate supplierCode.
+- Try to insert duplicate email.
+
+## Shipment Testing
+
+- Insert a shipment linked to an existing supplier.
+- Display all shipments.
+- Update shipment information.
+- Delete a shipment.
+- Confirm duplicate shipmentNumber is prevented.
+
+## Delivery Testing
+
+- Insert a delivery linked to an existing shipment.
+- Display all deliveries.
+- Update delivery information.
+- Delete a delivery.
+- Confirm duplicate deliveryCode is prevented.
+
+## Report Testing
+
+- Open Reports page.
+- Select Daily Report.
+- Select Weekly Report.
+- Select Monthly Report.
+- Change between Suppliers, Shipments, and Deliveries.
+- Print report using the Print Report button.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/10_Challenges.md

@@ -0,0 +1,12 @@
+# 10. Challenges
+
+During development, the following challenges may be faced:
+
+- Maintaining correct references between Supplier, Shipment, and Delivery.
+- Preventing duplicate records using unique fields.
+- Protecting backend routes using session authentication.
+- Displaying reports for different periods.
+- Keeping the user interface simple and responsive.
+
+These challenges were handled using Mongoose validation, duplicate checking in controllers, Express session middleware, and responsive Tailwind CSS classes.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/11_Conclusion.md

@@ -0,0 +1,8 @@
+# 11. Conclusion
+
+The Supply Chain Management System was developed to help SupplyNet Ltd manage suppliers, shipments, and deliveries digitally.
+
+The system includes session-based authentication, password encryption, MVC backend architecture, MongoDB database design, React frontend pages, and printable reports.
+
+This project meets the National Practical Examination requirements by using simple, readable, and assessment-friendly MERN stack code.
+

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

@@ -0,0 +1,4 @@
+PORT=5000
+MONGO_URI=mongodb://127.0.0.1:27017/SCMS
+SESSION_SECRET=scms_exam_secret
+CLIENT_URLS=http://localhost:5173,http://localhost:5174

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

@@ -0,0 +1,16 @@
+var mongoose = require("mongoose");
+
+function connectDB() {
+  var mongoURI = process.env.MONGO_URI || "mongodb://127.0.0.1:27017/SCMS";
+
+  return mongoose.connect(mongoURI)
+    .then(function () {
+    console.log("MongoDB connected successfully to SCMS database");
+    })
+    .catch(function (error) {
+      console.error("MongoDB connection failed:", error.message);
+      process.exit(1);
+    });
+}
+
+module.exports = connectDB;

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/deliveryController.js

@@ -0,0 +1,145 @@
+var Delivery = require("../models/Delivery");
+var Shipment = require("../models/Shipment");
+
+function createDelivery(req, res) {
+  var shipment = req.body.shipment;
+  var deliveryCode = req.body.deliveryCode;
+  var deliveryDate = req.body.deliveryDate;
+  var quantityDelivered = req.body.quantityDelivered;
+  var deliveryStatus = req.body.deliveryStatus;
+
+  if (!shipment || !deliveryCode || !deliveryDate || !quantityDelivered || !deliveryStatus) {
+    return res.status(400).json({ message: "All delivery fields are required" });
+  }
+
+  Shipment.findById(shipment)
+    .then(function (shipmentExists) {
+      if (!shipmentExists) {
+        return { shipmentNotFound: true };
+      }
+
+      return Delivery.findOne({ deliveryCode: deliveryCode });
+    })
+    .then(function (deliveryExists) {
+      if (deliveryExists && deliveryExists.shipmentNotFound) {
+        return res.status(404).json({ message: "Selected shipment was not found" });
+      }
+
+      if (deliveryExists) {
+        return res.status(409).json({ message: "Delivery code already exists" });
+      }
+
+      return Delivery.create({
+        shipment: shipment,
+        deliveryCode: deliveryCode,
+        deliveryDate: deliveryDate,
+        quantityDelivered: quantityDelivered,
+        deliveryStatus: deliveryStatus,
+      });
+    })
+    .then(function (delivery) {
+      if (!delivery) {
+        return;
+      }
+
+      res.status(201).json({ message: "Delivery inserted successfully", delivery: delivery });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to insert delivery", error: error.message });
+    });
+}
+
+function getDeliveries(req, res) {
+  Delivery.find()
+    .populate({
+      path: "shipment",
+      select: "shipmentNumber destination shipmentDate supplier",
+      populate: { path: "supplier", select: "supplierName supplierCode" },
+    })
+    .sort({ createdAt: -1 })
+    .then(function (deliveries) {
+      res.status(200).json(deliveries);
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to get deliveries", error: error.message });
+    });
+}
+
+function updateDelivery(req, res) {
+  var id = req.params.id;
+  var shipment = req.body.shipment;
+  var deliveryCode = req.body.deliveryCode;
+  var deliveryDate = req.body.deliveryDate;
+  var quantityDelivered = req.body.quantityDelivered;
+  var deliveryStatus = req.body.deliveryStatus;
+
+  if (!shipment || !deliveryCode || !deliveryDate || !quantityDelivered || !deliveryStatus) {
+    return res.status(400).json({ message: "All delivery fields are required" });
+  }
+
+  Shipment.findById(shipment)
+    .then(function (shipmentExists) {
+      if (!shipmentExists) {
+        return { shipmentNotFound: true };
+      }
+
+      return Delivery.findOne({
+        deliveryCode: deliveryCode,
+        _id: { $ne: id },
+      });
+    })
+    .then(function (duplicateDelivery) {
+      if (duplicateDelivery && duplicateDelivery.shipmentNotFound) {
+        return res.status(404).json({ message: "Selected shipment was not found" });
+      }
+
+      if (duplicateDelivery) {
+        return res.status(409).json({ message: "Delivery code already exists" });
+      }
+
+      return Delivery.findByIdAndUpdate(
+        id,
+        {
+          shipment: shipment,
+          deliveryCode: deliveryCode,
+          deliveryDate: deliveryDate,
+          quantityDelivered: quantityDelivered,
+          deliveryStatus: deliveryStatus,
+        },
+        { new: true, runValidators: true }
+      );
+    })
+    .then(function (delivery) {
+      if (!delivery) {
+        return;
+      }
+
+      res.status(200).json({ message: "Delivery updated successfully", delivery: delivery });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to update delivery", error: error.message });
+    });
+}
+
+function deleteDelivery(req, res) {
+  var id = req.params.id;
+
+  Delivery.findByIdAndDelete(id)
+    .then(function (delivery) {
+      if (!delivery) {
+        return res.status(404).json({ message: "Delivery not found" });
+      }
+
+      res.status(200).json({ message: "Delivery deleted successfully" });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to delete delivery", error: error.message });
+    });
+}
+
+module.exports = {
+  createDelivery: createDelivery,
+  getDeliveries: getDeliveries,
+  updateDelivery: updateDelivery,
+  deleteDelivery: deleteDelivery,
+};

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/shipmentController.js

@@ -0,0 +1,149 @@
+var Shipment = require("../models/Shipment");
+var Supplier = require("../models/Supplier");
+var Delivery = require("../models/Delivery");
+
+function createShipment(req, res) {
+  var supplier = req.body.supplier;
+  var shipmentNumber = req.body.shipmentNumber;
+  var shipmentDate = req.body.shipmentDate;
+  var shipmentStatus = req.body.shipmentStatus;
+  var destination = req.body.destination;
+
+  if (!supplier || !shipmentNumber || !shipmentDate || !shipmentStatus || !destination) {
+    return res.status(400).json({ message: "All shipment fields are required" });
+  }
+
+  Supplier.findById(supplier)
+    .then(function (supplierExists) {
+      if (!supplierExists) {
+        return { supplierNotFound: true };
+      }
+
+      return Shipment.findOne({ shipmentNumber: shipmentNumber });
+    })
+    .then(function (shipmentExists) {
+      if (shipmentExists && shipmentExists.supplierNotFound) {
+        return res.status(404).json({ message: "Selected supplier was not found" });
+      }
+
+      if (shipmentExists) {
+        return res.status(409).json({ message: "Shipment number already exists" });
+      }
+
+      return Shipment.create({
+        supplier: supplier,
+        shipmentNumber: shipmentNumber,
+        shipmentDate: shipmentDate,
+        shipmentStatus: shipmentStatus,
+        destination: destination,
+      });
+    })
+    .then(function (shipment) {
+      if (!shipment) {
+        return;
+      }
+
+      res.status(201).json({ message: "Shipment inserted successfully", shipment: shipment });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to insert shipment", error: error.message });
+    });
+}
+
+function getShipments(req, res) {
+  Shipment.find()
+    .populate("supplier", "supplierCode supplierName telephone")
+    .sort({ createdAt: -1 })
+    .then(function (shipments) {
+      res.status(200).json(shipments);
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to get shipments", error: error.message });
+    });
+}
+
+function updateShipment(req, res) {
+  var id = req.params.id;
+  var supplier = req.body.supplier;
+  var shipmentNumber = req.body.shipmentNumber;
+  var shipmentDate = req.body.shipmentDate;
+  var shipmentStatus = req.body.shipmentStatus;
+  var destination = req.body.destination;
+
+  if (!supplier || !shipmentNumber || !shipmentDate || !shipmentStatus || !destination) {
+    return res.status(400).json({ message: "All shipment fields are required" });
+  }
+
+  Supplier.findById(supplier)
+    .then(function (supplierExists) {
+      if (!supplierExists) {
+        return { supplierNotFound: true };
+      }
+
+      return Shipment.findOne({
+        shipmentNumber: shipmentNumber,
+        _id: { $ne: id },
+      });
+    })
+    .then(function (duplicateShipment) {
+      if (duplicateShipment && duplicateShipment.supplierNotFound) {
+        return res.status(404).json({ message: "Selected supplier was not found" });
+      }
+
+      if (duplicateShipment) {
+        return res.status(409).json({ message: "Shipment number already exists" });
+      }
+
+      return Shipment.findByIdAndUpdate(
+        id,
+        {
+          supplier: supplier,
+          shipmentNumber: shipmentNumber,
+          shipmentDate: shipmentDate,
+          shipmentStatus: shipmentStatus,
+          destination: destination,
+        },
+        { new: true, runValidators: true }
+      );
+    })
+    .then(function (shipment) {
+      if (!shipment) {
+        return;
+      }
+
+      res.status(200).json({ message: "Shipment updated successfully", shipment: shipment });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to update shipment", error: error.message });
+    });
+}
+
+function deleteShipment(req, res) {
+  var id = req.params.id;
+
+  Shipment.findByIdAndDelete(id)
+    .then(function (shipment) {
+      if (!shipment) {
+        return null;
+      }
+
+      return Delivery.deleteMany({ shipment: id });
+    })
+    .then(function (result) {
+      if (!result) {
+        return res.status(404).json({ message: "Shipment not found" });
+      }
+
+      res.status(200).json({ message: "Shipment deleted successfully" });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to delete shipment", error: error.message });
+    });
+}
+
+module.exports = {
+  createShipment: createShipment,
+  getShipments: getShipments,
+  updateShipment: updateShipment,
+  deleteShipment: deleteShipment,
+};

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/backend-project/controllers/supplierController.js

@@ -0,0 +1,56 @@
+var Supplier = require("../models/Supplier");
+
+function createSupplier(req, res) {
+  var supplierCode = req.body.supplierCode;
+  var supplierName = req.body.supplierName;
+  var telephone = req.body.telephone;
+  var address = req.body.address;
+  var email = req.body.email;
+
+  if (!supplierCode || !supplierName || !telephone || !address || !email) {
+    return res.status(400).json({ message: "All supplier fields are required" });
+  }
+
+  Supplier.findOne({
+    $or: [{ supplierCode: supplierCode }, { email: email }],
+  })
+    .then(function (supplierExists) {
+      if (supplierExists) {
+        return res.status(409).json({ message: "Supplier code or email already exists" });
+      }
+
+      return Supplier.create({
+        supplierCode: supplierCode,
+        supplierName: supplierName,
+        telephone: telephone,
+        address: address,
+        email: email,
+      });
+    })
+    .then(function (supplier) {
+      if (!supplier) {
+        return;
+      }
+
+      res.status(201).json({ message: "Supplier inserted successfully", supplier: supplier });
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to insert supplier", error: error.message });
+    });
+}
+
+function getSuppliers(req, res) {
+  Supplier.find()
+    .sort({ createdAt: -1 })
+    .then(function (suppliers) {
+      res.status(200).json(suppliers);
+    })
+    .catch(function (error) {
+      res.status(500).json({ message: "Failed to get suppliers", error: error.message });
+    });
+}
+
+module.exports = {
+  createSupplier: createSupplier,
+  getSuppliers: getSuppliers,
+};