hubertnshuti/livestock-marketplace-system

A web-based Livestock Marketplace connecting rural farmers and buyers in Rwanda. Features include digital herd management, an inquiry-based ordering system, and advanced search filtering. Built with Django and Bootstrap 5. 🐄 ItungoHub: Livestock Marketplace System > **Digitizing the Livestock Trade in Rwanda** > A bridge connecting rural farmers to urban markets through a secure, inquiry-based digital platform. --- ## 📖 Table of Contents - About the Project - Key Features - System Architecture - Technology Stack - Getting Started - Usage Guide - Screenshots - Meet the Team - License --- ## 📝 About the Project **ItungoHub** is a web-based platform designed to modernize the traditional livestock market (*Amabagiro*) in Rwanda. Currently, farmers face significant challenges including lack of market access, high transport costs, and reliance on middlemen. This system solves these problems by providing a centralized digital marketplace where: 1. **Farmers** can list their herd, manage inventory, and receive direct inquiries. 2. **Buyers** can search for verified livestock by species, location, and price. 3. **Transactions** are secured through an **"Inquiry & Approval" workflow**, replacing the risky instant-buy model with a trust-based negotiation system suitable for the agricultural sector. --- ## 🌟 Key Features ### 🚜 For Farmers * **Digital Herd Management:** specific forms to list animals with details like Tag ID, Weight, Age, and Breed. * **Sales Dashboard:** Real-time tracking of "Total Livestock" vs. "Sold Items". * **Inquiry Management:** Receive purchase requests, view buyer contact details securely, and Approve/Reject sales. * **Revenue Tracking:** Monitor completed sales and income. ### 🛒 For Buyers * **Advanced Marketplace:** Filter livestock by **Species** (Cattle, Goats, Pigs), **Location** (District/Sector), and **Price Range**. * **Smart Cart:** A "Self-Healing" cart system that ensures accurate pricing calculations. * **Pay-on-Delivery Workflow:** Place inquiries without immediate payment; pay only after the farmer approves and delivery is arranged. * **Order History:** Track the status of requests from "Pending" to "Approved" to "Delivered". ### 🛡️ Sy …