# 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.

