Aman-Kasa/AFRICAN-004

# Inventory and Procurement Management System ## Overview A robust, scalable web application designed to empower African industries and SMEs with modern inventory, procurement, and supply chain management. Built with Django (backend) and React (frontend), it features real-time tracking, role-based access, analytics, notifications, and professional UI/UX. ## Features - **User Authentication:** JWT, role-based (Admin, Manager, Staff) - **Inventory Management:** CRUD, QR code scan, bulk import/export (CSV), low stock alerts - **Purchase Orders:** Create, update, approve/reject, status tracking, CSV export - **Supplier Management:** Add/view/edit/delete, search/filter, CSV export, analytics - **Notifications:** In-app and email alerts for approvals, low stock, etc. - **Reports & Analytics:** Downloadable CSVs, dashboard charts, supplier performance - **User Management:** Admin add/edit/delete users, assign roles - **Audit Logs:** View all system actions - **Professional UI/UX:** Material-UI, responsive, accessible ## Tech Stack - **Backend:** Python, Django, Django REST Framework, SimpleJWT - **Frontend:** React, Material-UI, Recharts, html5-qrcode - **Database:** SQLite (dev), PostgreSQL/MySQL (prod-ready) - **Other:** CORS, CSV/PDF export, RESTful APIs ## Setup Instructions ### Prerequisites - Python 3.10+ - Node.js 18+ - npm ## LOG IN (username = admin), (pass = admin123) ### Backend Setup ```bash cd backend/backend python3 -m venv ../../venv source ../../venv/bin/activate pip install -r ../../requirements.txt python3 manage.py migrate python3 manage.py createsuperuser # Follow prompts python3 manage.py runserver ``` ### Frontend Setup ```bash cd ../../frontend npm install npm start ``` ### Demo Data (Optional) ```bash cd backend/backend source ../../venv/bin/activate python3 manage.py shell < demo_seed.py ``` ## Usage - Access the app at localhost - Log in with your credentials - Use the dashboard and navigation to manage inventory, orders, su …