Innocentmakaya/TBTrack

This is a Tuberculosis (TB) adherence monitoring dashboard used by healthcare professionals in South Africa to monitor TB patients in South Africa who use a smart pillbox which assists them in taking their medication as prescribed. # TBTrack — TB Medication Adherence Dashboard A full-stack web application for healthcare professionals to monitor tuberculosis (TB) patient medication adherence using data from a smart pillbox device. --- ## 🌍 Problem Statement Tuberculosis (TB) remains one of the leading infectious disease killers globally. A major challenge in TB treatment is medication adherence, patients must take multiple medications daily for 6–18 months. Missing doses leads to treatment failure and the development of drug-resistant TB strains. TBTrack addresses this by giving healthcare workers a centralised dashboard to monitor their patients' adherence in real time, powered by data from a smart pillbox that records when medication is taken. --- ## ✨ Features - Authentication — Signup, login, email verification and forgot/reset password - Patient Management — Add and manage TB patients linked to a specific healthcare worker - Medication Scheduling — Prescribe medications with daily schedules for configurable durations (7–180 days) - Adherence Tracking — View dose logs showing taken/missed status for every scheduled dose - Adherence Analytics — 7-day trend chart and dose log per patient - Side Effect Reporting — View patient-reported side effects with severity levels (mild/moderate/severe) - Appointment Management — View and update appointment statuses (pending/confirmed/cancelled/completed) - Role-based Access — Each healthcare worker only sees their own assigned patients - Email Notifications — Verification and password reset emails via Resend --- ## 🛠️ Tech Stack ### Frontend | Technology | Purpose | |---|---| | React 18 + TypeScript | UI framework with type safety | | Vite | Fast build tool and dev server | | Tailwind CSS v3 | Utility-first styling | | React Router DOM | Client-side routing | | Recharts | Adherence trend charts | | Lucide React | Icon library | | TanStack Query | Server state management | ### Backend | Technology | Purpose | |---|---| | Node.js + Express | RE …