kolisang2222/-LesoFarmHub

Full-stack Java Web Application for agricultural supply chain management in Lesotho. Built with Servlets, JSP/JSTL, MySQL and Bootstrap. Features role-based dashboards, inventory tracking, marketplace, order lifecycle management, delivery tracking and AI-based spoilage prediction. # 🌿 LesoFarm Hub **Agricultural Supply Chain & Inventory Management System** A full-stack Java Web Application built for Lesotho's agricultural sector. LesoFarm Hub digitally transforms the agricultural supply chain by connecting farmers, buyers, cooperative managers, delivery drivers and government officers on one unified platform. > Built as a portfolio project demonstrating enterprise Java development, > MVC architecture, relational database design and full-stack engineering skills. --- ## 🚀 Live Demo > Deploy locally following the setup instructions below. **Demo Login Credentials** (password for all: `Admin@123`) | Email | Role | |-------|------| | admin@lesofarm.ls | System Admin | | thabo@lesofarm.ls | Farmer | | palesa@lesofarm.ls | Buyer | --- ## 💡 Problem Statement Farmers in Lesotho and across Africa face: - Poor inventory tracking leading to product spoilage - No direct market access to buyers - Manual record keeping with no analytics - Weak supply chain visibility from farm to buyer - No forecasting or demand prediction tools **LesoFarm Hub solves this** by providing a complete digital platform for the entire agricultural supply chain. --- ## ✨ Features ### 🔐 Authentication & Security - BCrypt password hashing — passwords never stored in plain text - Session-based authentication with 30-minute timeout - Role-based dashboard redirect on login - AuthFilter protecting every URL from unauthorized access - PreparedStatements throughout — SQL injection prevention ### 👥 Six Role-Based Dashboards | Role | Key Functions | |------|--------------| | **Farmer** | Add products, manage inventory batches, view sales analytics | | **Buyer** | Browse marketplace, place orders, track deliveries, print invoices | | **Cooperative Manager** | Oversee all inventory, confirm orders, assign deliveries | | **Delivery Personnel** | View assigned deliveries, update delivery status step by step | | **Government Officer** | Read-only analytics, market activity, fo …