mukizafabrice/Shisha-Kibondo

A mobile and web-based application designed to help health centers and officials track and manage the distribution of Shisha Kibondo flour to beneficiaries. The system improves transparency, monitors stock levels, and generates reports to support Rwanda’s efforts in reducing malnutrition and stunting. # Shisha-Kibondo markdown # Shisha Kibondo Distribution Tracker A mobile and web-based application designed to help health centers and officials **track and manage the distribution of Shisha Kibondo flour** to beneficiaries. The system improves transparency, monitors stock levels, and generates reports to support Rwanda’s efforts in reducing malnutrition and stunting. --- ## ✨ Features - 📋 **Beneficiary Management** – Register and manage households receiving Shisha Kibondo. - 🏥 **Distribution Tracking** – Record when and how much flour is distributed to each beneficiary. - 📦 **Inventory Management** – Track available stock at health centers and prevent shortages. - 📊 **Reports & Analytics** – Generate summaries of distributed flour by district, center, or beneficiary. - 🔒 **Role-Based Access** – Different user roles (e.g., Admin, Health Worker, Manager). - 🌐 **Offline First (Planned)** – Allow data entry offline and sync when internet is available. --- ## 🛠️ Tech Stack ### Frontend - **React Native** – Mobile app (Android & iOS) - **React.js** – Optional web dashboard - **Bootstrap / TailwindCSS** – UI styling ### Backend - **Node.js + Express** – REST API - **MongoDB** (or MySQL/PostgreSQL) – Database - **JWT Authentication** – Secure login & access control ### Tools - **Git & GitHub** – Version control - **Postman** – API testing - **Docker (optional)** – Containerization ## 📂 Project Structure (Proposed) shisha-kibondo-distribution-tracker/ │ ├── backend/ # Node.js + Express API │ ├── models/ # Database models │ ├── routes/ # API routes │ ├── controllers/ # Logic for routes │ └── server.js # Entry point │ ├── frontend/ # React Native (or React.js for web dashboard) │ ├── components/ # UI components │ ├── screens/ # Mobile screens │ └── App.js # Entry point │ ├── docs/ …