selamtdemissie40-art/kaffa-origin

# ☕ Kaffa Origin — Ethiopian Coffee Supply Chain & Traceability Platform A full-stack web application designed to bring direct market visibility, transparent quality grading, and verifiable transaction records to Ethiopian coffee producers, cooperatives, licensed traders, and exporters. ## 🚀 Features * **Multi-Role RBAC:** Dedicated portal interfaces for Smallholder Farmers, Primary Cooperatives, Certified Q-Graders/Inspectors, Traders, and Exporters. * **Specialty Quality Grading:** SCA cup scores, moisture content verification, defect tracking, and official export grading (Grade 1–5). * **Smart Contract Execution:** Transparent trade agreements binding lot volumes, price per kg, and delivery milestones. * **Public Lot Traceability:** Consumer-facing batch lookup to trace coffee lots from origin farm/washing station to export readiness. * **Compliance & Disbursements:** Integrated payment settlement tracking and export tax documentation. ## 🛠️ Tech Stack * **Frontend:** HTML5, CSS3, Vanilla JavaScript (Fetch API) * **Backend:** Node.js, Express.js * **Database:** MySQL 8.0 * **Security:** bcryptjs (password hashing), JSON Web Tokens (JWT) ## 📦 Setup & Installation 1. **Clone the repository:** ```bash git clone github.com cd coffee-supply-chain