ReshDeen/perishable-inventory-risk-engine

P.I.R.E is a full-stack inventory management solution designed to minimize waste in retail environments by tracking product life cycles in real-time. Built with a Node.js/Express backend and a React frontend, the system doesn't just store data—it analyzes it.

# P.I.R.E. – Perishable Inventory Risk Engine **Predict. Prevent. Preserve.** P.I.R.E. is a production-style MERN + Python + XGBoost platform for perishable inventory risk analysis. It predicts expiry risk, surfaces operational alerts, provides analytics, and exports inventory intelligence for demonstration and reporting. ## Architecture - **Frontend:** React, Vite, Tailwind CSS, React Router, Axios, Recharts, Lucide React - **Backend:** Node.js, Express, MongoDB, JWT authentication - **Machine Learning:** Python, scikit-learn, XGBoost, joblib - **Integration:** Node `spawn` executes Python prediction script and returns JSON to the frontend ## Project Structure - `smart-grocery-frontend/` - React dashboard UI - `smart-grocery-backend/` - Express API, authentication, analytics, alerts, export, and prediction services - `smart-grocery-backend/ml/` - dataset generation, training, and prediction pipeline ## Features - JWT authentication with register/login/profile flow - Inventory CRUD with search and risk filtering - XGBoost-driven expiry risk prediction - KPI dashboard and charts - Alert engine for expiry, high-risk, and overstock conditions - CSV and PDF export - Responsive green-themed dashboard UI ## Screenshots https://drive.google.com/file/d/18A6mohoFrCq-ox87OcnX8LaZ8uwn9Y6U/view?usp=sharing ## Setup Instructions ### 1. Install dependencies Frontend: ```bash cd smart-grocery-frontend npm install ``` Backend: ```bash cd smart-grocery-backend npm install ``` ### 2. Configure environment files Copy the example files: - `smart-grocery-backend/.env.example` to `smart-grocery-backend/.env` - `smart-grocery-frontend/.env.example` to `smart-grocery-frontend/.env` Update values if needed: - MongoDB connection string - JWT secret - Frontend URL ### 3. Pre