SothoGent/pulse_medibay

Centralized Medical Bay is a multi-stakeholder digital ecosystem that eliminates the exhausting, time-consuming search for prescribed medications across Zimbabwe. By connecting patients, doctors, pharmacies, and medical aid companies on a single, transparent platform, we replace "door-to-door" pharmacy hunting etc. Pulse Medibay – Centralized Medical Bay A full-stack Next.js application connecting patients, doctors, and pharmacies in a unified grid. Real‑time stock visibility, e‑prescriptions, price comparison, and medical‑aid claims – all designed for the Zimbabwean healthcare ecosystem. 📋 Table of Contents Features Tech Stack Prerequisites Installation Environment Variables Database Setup Seeding the Database Running the App Demo Accounts Project Structure Troubleshooting ✨ Features Patient Portal View active prescriptions, compare pharmacy prices, reserve medication, track orders, log medication intake, and book appointments. Doctor Portal Issue signed e‑prescriptions, manage patients, view appointment schedules, and access prescription history. Pharmacy Portal Manage inventory and pricing, view and update fulfilment queue, process orders, and track dispensing. Medical Aid Integration Automatic claims adjudication (simulated) based on patient’s medical aid provider. Responsive UI with Light/Dark Mode Fully themed interface using Tailwind CSS and next‑themes. 🛠️ Tech Stack Framework: Next.js 16 (App Router, Turbopack) Language: TypeScript Database: PostgreSQL (native or Docker) ORM: Drizzle ORM Styling: Tailwind CSS 4 UI Components: React 19 Maps: Leaflet / React Leaflet Authentication: Cookie‑based sessions with scrypt hashing 📦 Prerequisites Before you begin, ensure you have the following installed: Node.js (v20 or higher) – Download npm (comes with Node.js) PostgreSQL (v14+) – either: Native installation (recommended for Windows) – Download Docker (optional) – Download Git (optional, for cloning) 🚀 Installation Clone the repository (or extract the project archive): bash git clone cd pulse_medibay Install all dependencies: bash npm install 🔐 Environment Variables Create a .env.local file in the project root with the following content: env DATABASE_URL=postgresql://postgres:postgres@localhost:5433/app_db Username: postgres (default superus …