PrincessHarry/Freshchain

FreshChain is built to address post-harvest losses of perishable produce Nigeria. The platform brings farmers, buyers, transporters, warehouse managers, and administrators. # FreshChain — Optimized Supply Chain Management System for Perishable Local Foods **Final Year Project:** *Optimized Supply Chain Management System for Perishable Local Foods with Reduced Post-Harvest Losses in Bokkos* FreshChain coordinates the movement of perishable agricultural produce — from farm to storage to transport to market — connecting **farmers**, **buyers**, **transporters**, **warehouse managers**, and **administrators** on a single platform to reduce spoilage and improve efficiency in Bokkos, Plateau State, Nigeria. --- ## Tech Stack - Python 3.11+ / Django 5 - SQLite (default database) - Django REST Framework (API layer) - django-filter (API filtering) - python-decouple (environment configuration) - Pillow (image handling) No Docker required. --- ## Project Structure ``` freshchain/ ├── manage.py ├── requirements.txt ├── .env / .env.example ├── freshchain/ # project settings, root urls, wsgi/asgi ├── core/ # shared base models, middleware, utils, home pages, API root ├── accounts/ # CustomUser (email auth), registration/login/profile ├── farmers/ # FarmerProfile, Produce catalogue, Harvest records ├── buyers/ # BuyerProfile, marketplace browsing ├── transport/ # TransporterProfile, DeliveryRoute, nearest-transporter logic ├── warehouse/ # Warehouse, Storage placement, capacity monitoring ├── inventory/ # Inventory ledger, FEFO stock picking ├── orders/ # Order, OrderItem, Delivery (+ auto-assign transporter) ├── notifications/ # System notifications ├── analytics/ # LossRecord, Report, dashboards data ├── dashboard/ # Role-based dashboard routing & views ├── templates/ # Shared/base templates └── static/ # CSS / JS / images ``` --- ## User Roles | Role | Description | |---|---| | Farmer | Registers harvests, tracks expiry, views alerts | | Buyer | Browses marketplace, places order …