Ygtopher/Smart-Coffee-Supply-Chain-Management-System

The Smart Coffee Supply Chain Management System is a digital platform for IMPEXCOR Ltd to streamline coffee trading in Rwanda. It digitizes operations from farm to export, ensuring transparency via QR traceability. Built as an offline-first PWA with a FastAPI backend, it manages inventory, quality, compliance, and multi-role workflows. # Smart Coffee Supply Chain Management System (SCM) A full-stack, secure, and transparent traceability platform designed for the coffee supply chain in Rwanda. The platform tracks coffee cherry collections from farmers, monitors processing steps, records quality cupping assessments, facilitates logistics/shipment dispatch assignments, handles international export assignments, and provides an analytics and reporting dashboard for administrators. --- ## 🚀 Key Features * **End-to-End Traceability**: Batch QR codes trace coffee from initial farm intake (cherry weight, moisture, farm location) through cooperative collection, processing, cupping, logistics, and port delivery. * **Role-Based Access Control (RBAC)**: Custom portals tailored for each stakeholder: * **Farmers & Cooperatives**: Log pickups, view market price trends, and monitor delivery receipts. * **Aggregators & Processors**: Manage cherry processing batches, workstation assignments, and inventory levels. * **Quality Controllers**: Log cupping scores (Aroma, Acidity, Body, Flavour, Moisture, Defects) linked to specific batches. * **Logistics & Transporters**: Manage dispatch assignments, assign truck registration plates (Rwanda format), and register Proof of Delivery (POD). * **Exporters**: Manage international sales orders, allocate approved batches, and upload compliance documents. * **System Admins**: Configure platform parameters, manage user access, run customizable reports, and analyze volume metrics. * **Multilingual Localization (i18n)**: Fully translated into **English**, **Kinyarwanda**, and **French** to serve regional stakeholders. * **Robust Security**: Protected by JWT authorization, Multi-Factor Authentication (MFA), and rate-limiting middleware. --- ## 🛠️ Technology Stack * **Frontend**: React, TypeScript, Vite, TailwindCSS, Lucide Icons, i18next (Localization), Sonner (Toasts) * **Backend**: Node.js, Express, TypeScript, Prisma ORM, Helmet (Security headers), Morgan (Logging) * **Data …