create-myexam-app 1.0.21 → 1.0.22

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

@@ -0,0 +1,106 @@
+# KALIWABO SHEMA ELYSEE National Practical Examination 2026
+
+## Project Title
+
+SUPPLY CHAIN MANAGEMENT SYSTEM (SCMS)
+
+## Company
+
+SupplyNet Ltd is located in Musanze District, Northern Province, Rwanda. The company manages suppliers, shipments, and deliveries. This system helps the company replace manual record keeping with a digital web application.
+
+## Folder Structure
+
+```text
+KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/
+  backend-project/
+    config/
+    controllers/
+    middleware/
+    models/
+    routes/
+    server.js
+    package.json
+  frontend-project/
+    src/
+      api/
+      components/
+      pages/
+      App.jsx
+      main.jsx
+    package.json
+  REPORT/
+  README.md
+```
+
+## Technologies Used
+
+- React.js
+- React Router DOM
+- Axios
+- Tailwind CSS
+- Node.js
+- Express.js
+- MongoDB
+- Mongoose
+- bcryptjs
+- express-session
+
+## Backend Setup
+
+```bash
+cd backend-project
+npm install
+copy .env.example .env
+npm run dev
+```
+
+Backend URL:
+
+```text
+http://localhost:5000
+```
+
+## Frontend Setup
+
+```bash
+cd frontend-project
+npm install
+npm run dev
+```
+
+Frontend URL:
+
+```text
+http://localhost:5173
+```
+
+## MongoDB Database
+
+Database name:
+
+```text
+SCMS
+```
+
+Collections:
+
+- Users
+- Suppliers
+- Shipments
+- Deliveries
+
+## Main Features
+
+- User registration and login
+- Session-based authentication
+- Password recovery
+- Supplier insertion
+- Shipment insert, get, update, delete
+- Delivery insert, get, update, delete
+- Daily, weekly, and monthly printable reports
+- Responsive sidebar navigation
+
+## Examination Notes
+
+Supplier update and delete were not generated because the practical requirement says Supplier is INSERT ONLY. Supplier listing is included for table display, shipment selection, and reports.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/01_Introduction.md

@@ -0,0 +1,8 @@
+# 01. Introduction
+
+The Supply Chain Management System (SCMS) is a web-based application developed for SupplyNet Ltd, a company located in Musanze District, Northern Province, Rwanda.
+
+The company manages suppliers, shipments, and deliveries. Before this system, these activities were handled manually, which made record keeping slow and difficult to report.
+
+SCMS was developed using the MERN stack. It allows authenticated users to manage supply chain records and generate daily, weekly, and monthly reports.
+

package/projects/SCMS(Ely)/KALIWABO_SHEMA_ELYSEE_National_Practical_Examination_2026/REPORT/02_Problem_Statement.md

@@ -0,0 +1,12 @@
+# 02. Problem Statement
+
+SupplyNet Ltd currently uses a manual process to manage suppliers, shipments, and deliveries. This manual process causes the following problems:
+
+- Records may be lost or duplicated.
+- Searching for shipment and delivery information is slow.
+- Report preparation takes too much time.
+- Data relationships between suppliers, shipments, and deliveries are difficult to track manually.
+- Management cannot easily view current supply chain records.
+
+The proposed system solves these problems by providing a digital platform for storing, managing, and reporting supply chain information.
+

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,
+};