Josias2003/Clinic-Stock-Out-Tracker

A modern web application for tracking medicine stock levels across health centers in Rwanda, enabling real-time monitoring and proactive stock management. # Clinic Stock-Out Tracker A modern web application for tracking medicine stock levels across health centers in Rwanda, enabling real-time monitoring and proactive stock management. ## Project Overview This application addresses the critical issue of medicine stock-outs in Rwanda's health centers by providing: - **Real-time stock monitoring** across multiple health centers - **Automated alerts** for low and out-of-stock medicines - **Role-based access control** for clinic staff and pharmacy administrators - **Modern, responsive UI** for both desktop and mobile devices - **Comprehensive reporting** and analytics dashboard ## Architecture ### Backend (Spring Boot) - **Framework**: Spring Boot 3.2.1 with Java 17 - **Database**: PostgreSQL 14 - **Security**: JWT-based authentication with role-based access control - **API**: RESTful APIs with comprehensive error handling - **Documentation**: Built-in API documentation ### Frontend (React) - **Framework**: React 18 with modern hooks - **UI Library**: shadcn/ui components with Tailwind CSS - **Icons**: Lucide React icons - **Routing**: React Router for SPA navigation - **State Management**: Context API for authentication ### Database Schema - **Users**: Authentication and role management - **Health Centers**: Clinic information and contact details - **Medicines**: Drug catalog with categories and thresholds - **Stock Reports**: Real-time stock level tracking ## Features ### For Clinic Staff - **Stock Reporting**: Submit current medicine quantities - **Dashboard**: View recent reports and alerts - **Medicine Catalog**: Browse available medicines - **Alert Notifications**: Automatic threshold-based alerts ### For Pharmacy Administrators - **Multi-Center Dashboard**: Monitor all health centers - **Medicine Management**: Add/edit medicine catalog - **Alert Management**: View critical and warning alerts - **Analytics**: Comprehensive reporting and insights - **User Management**: Control access and permissions ### Sy …