A production-grade healthcare management system enabling patients to discover doctors, book appointments, process payments, and manage medical interactions — all from one platform.
HealthAxis is a comprehensive, production-ready healthcare management platform designed to digitize the entire patient-doctor interaction lifecycle. The system serves three distinct user roles — Patients, Doctors, and Administrators — each with dedicated dashboards and feature sets.
Patients can browse verified doctors by specialty, check real-time availability, book appointments, and make secure payments through Razorpay. Doctors receive instant notifications, manage their schedules, generate digital prescriptions, and track revenue analytics. Administrators have platform-wide control over user management, appointment oversight, and system monitoring.
The platform was built with a focus on security, scalability, and real-world usability — handling sensitive medical data with proper encryption, authentication, and role-based access control throughout.
Secure JWT-based authentication with bcrypt password hashing. Role-based access control ensures patients, doctors, and admins see only what they should. Session management with refresh tokens for persistent login.
Real-time doctor availability with slot-based booking. Patients can view doctor profiles, specializations, fees, and available time slots. Automatic slot blocking prevents double-booking conflicts.
Razorpay payment gateway for secure appointment fee processing. Automated refund logic handles cancellations gracefully. Complete payment history tracking for both patients and doctors.
Comprehensive dashboard with revenue analytics, appointment calendar, patient history, and digital prescription generation. Doctors can manage their profile, availability, and consultation fees.
Fully configured CI/CD pipeline managing deployments across 17 distinct production iterations on Vercel, ensuring consistent uptime and robust application stability.
Cloudinary integration for storing doctor profile images, medical documents, and prescription files. Optimized image delivery with automatic format conversion and responsive sizing.
The frontend is built with React.js and Tailwind CSS, featuring a component-based architecture with custom hooks for state management. React Router handles client-side navigation with protected routes based on user roles.
The backend runs on Node.js with Express.js, following a modular MVC pattern. RESTful API endpoints are organized by domain — auth, appointments, doctors, patients, and admin. Middleware layers handle authentication verification, role checking, input validation, and error handling.
MongoDB serves as the primary database, with Mongoose ODM for schema validation and relationship modeling. Database queries are optimized with proper indexing on frequently searched fields like doctor specializations and appointment dates.
Third-party integrations include Razorpay for payments, Cloudinary for file storage, and automated deployment pipelines to Vercel — each wrapped in service layers for clean separation of concerns.
Multiple patients could attempt to book the same time slot simultaneously. Implemented optimistic locking with MongoDB's atomic operations to prevent double-bookings while maintaining a smooth user experience.
Handling automated refunds on appointment cancellations required careful state management. Built a transaction state machine that tracks payment lifecycle from initiation through completion or refund.
Three distinct user roles needed completely different dashboard experiences. Designed a flexible component architecture with role-aware routing and conditional rendering patterns.