SupplyNet SCMS — MongoDB Version

Supply Chain Management System for SupplyNet Ltd (Musanze District, Rwanda). Built with Node.js + Express (backend) and React JS (frontend), using MongoDB + Mongoose as the database.

Project Structure

supplynet-mongodb/
├── backend/
│   ├── server.js
│   ├── db.js
│   ├── .env.example
│   ├── package.json
│   ├── middleware/auth.js
│   ├── models/
│   │   ├── User.js
│   │   ├── Supplier.js
│   │   ├── Shipment.js
│   │   └── Delivery.js
│   └── routes/
│       ├── auth.js
│       ├── suppliers.js
│       ├── shipments.js
│       └── deliveries.js
└── frontend/
    ├── package.json
    ├── public/index.html
    └── src/
        ├── App.js / App.css / index.js
        ├── components/Navbar.js
        └── pages/
            ├── Login.js
            ├── Dashboard.js
            ├── Suppliers.js
            ├── Shipments.js
            ├── Deliveries.js
            └── Reports.js

Setup Instructions

1. MongoDB Setup

Make sure MongoDB is running: mongod (or use a MongoDB Atlas URI in .env)

2. Backend Setup

cd backend
cp .env.example .env
# Set your MONGO_URI
npm install
npm run dev

Runs on http://localhost:5000

3. Frontend Setup

cd frontend
npm install
npm start

Runs on http://localhost:3000 — Register an account on first run.

Data Models

Supplier

{ supplierCode, supplierName, telephone, address, email }

Shipment

{ shipmentNumber, shipmentDate, shipmentStatus, destination, supplier: ref(Supplier) }

Delivery

{ deliveryCode, deliveryDate, quantityDelivered, deliveryStatus, shipment: ref(Shipment) }

Relationships:

• Supplier → Shipment : One-to-Many (ObjectId ref)
• Shipment → Delivery : One-to-Many (ObjectId ref)