harshbix/MEDICINE-REDISTRIBUTION-SYSTEM

DEVELOPMENT OF MEDICINE REDISTRIBUTION SYSTEM TO REDUCE THE RISK OF OVERSTOKE AND EXPIRY IN TANZANIA HOSPITALS # Medicine Redistribution System Frontend A frontend-only web application for monitoring medicine stock, surfacing near-expiry risks, reviewing redistribution recommendations, and managing transfer requests across Tanzanian hospitals. ## Stack - React 19 - Vite - TypeScript - Tailwind CSS - shadcn-style source-owned UI components with Radix primitives - React Router ## Available scripts ```bash npm install npm run dev npm run build npm run lint ``` ## Project structure ```text src/ app/ Router, providers, and demo session state components/ layout/ Sidebar, topbar, shell, branding shared/ Reusable page-level UI patterns ui/ Source-owned shadcn-style primitives data/mock/ Modular mock datasets and derived selectors hooks/ Reusable frontend hooks lib/ Utilities and formatters pages/ Routed screens types/ Domain models ``` ## Current frontend scope - Frontend only - No backend routes - No real API calls - No Supabase integration - Local mock datasets for hospitals, medicines, inventory, alerts, recommendations, requests, users, and reports - Role-aware demo login for admin, pharmacist, and manager views ## Backend handoff notes The UI is intentionally structured so these pieces can be connected later without large rewrites: - Replace `src/data/mock/*` with backend adapters or query hooks - Replace `src/app/session-context.tsx` with real authentication/session state - Connect dashboard, inventory, alerts, recommendations, requests, reports, and settings forms to real endpoints - Persist transfer request creation and recommendation approval flows