Real-Time Medical Queue Appointment System with Django

MediQueue is a real-time medical queue and appointment system with Django that turns a clinic waiting room into a live digital ecosystem. Instead of static paper tokens, patients check in from their phone and watch their position update instantly, while doctors call the next patient with a single click. The system is built on Django 4.2 with Django Channels and Daphne for the WebSocket layer, so data syncs across every connected device without a page refresh. It also handles the clinical side, with integrated vitals, diagnosis, and prescription management tied into the same appointment flow.

Key Features

• A live WebSocket queue pushes real-time position and status updates to every connected patient, doctor, and staff member.
• Smart digital check-in assigns tokens on arrival and places the patient in the correct doctor's queue automatically.
• Role-based dashboards give patients, doctors, and administrators their own specialised interface and permissions.
• A custom user model extending Django AbstractUser handles all three roles with separate doctor and patient profiles.
• Doctors set a weekly availability schedule and the system auto-generates TimeSlot objects, which prevents double bookings.
• The QueueEntry model tracks position, status (Waiting, Called, Skipped), and timestamps for every stage of the visit.
• Vital tracking captures blood pressure, SpO2, temperature, and pulse for each consultation.
• The prescription engine uses an inline formset so doctors can add multiple medicines with dosage and duration in one form.
• A sign-off workflow marks the appointment complete and automatically triggers the WebSocket call for the next patient.

Technology Stack

System Requirements

• Python 3.10 or above.
• MySQL 8.0 or above with a database created for the project.
• Django 4.2 and Django REST Framework.
• Django Channels 4.1 and Daphne for the ASGI WebSocket server.
• mysqlclient for the database connection.
• Pillow for image handling and WhiteNoise for static files.
• A modern browser with WebSocket support.

How It Works

A patient books an appointment against a doctor's auto-generated time slot, then checks in digitally on arrival and receives a queue position. When the doctor clicks Call Next, the browser sends a JSON action over the WebSocket, the QueueConsumer updates the database and marks the next patient as Called, and the server broadcasts a queue_update message to the group for that doctor. Every device viewing that queue re-renders instantly with the new list and stats. After the consultation the doctor records vitals, diagnosis, and prescriptions, and signing off closes the appointment and automatically advances the queue.

Perfect For

This project suits BCA, MCA, B.Tech CS/IT, M.Tech, and MBA IT students who want a final year submission built on modern real-time web technology rather than a plain CRUD app. WebSockets, ASGI, Django Channels, custom user models, and role-based access control are all strong viva topics that you can demonstrate live. It also works well as a portfolio and interview project, since real-time systems and healthcare software are both in demand.

Future Enhancements

The project can be extended with SMS and email appointment reminders, online payment integration for consultation fees, a video consultation module, estimated wait time prediction using historical data, a mobile app frontend, lab report uploads linked to patient records, multi-clinic or multi-branch support, and analytics dashboards for patient flow.

Watch Project Demo

Watch the full project walkthrough and setup tutorial on our YouTube channel.

▶ Watch on YouTube – Decode It

More Details & Full Documentation

For complete project details, source code, and setup guide, visit the official project page.

🔗 View Full Project Details – UpdateGadh