Real-Time Medical Queue & Appointment System with Django

Building MediQueue: A Real-Time Medical Queue & Appointment System with Django

In the modern healthcare landscape, waiting rooms are often the biggest pain point for both patients and providers. Traditional token systems are static, opaque, and frankly, outdated. MediQueue—a full-stack digital solution designed to revolutionize the clinic experience using real-time technology.

In this post, we’ll dive deep into the architecture, tech stack, and core logic of MediQueue, a robust medical management system built with Django 4.2, WebSockets, and MySQL.

1. Project Overview: The Digital Waiting Room

MediQueue isn’t just a booking site; it’s a live ecosystem. It replaces physical queues with a browser-based system that updates instantly. Whether a patient is checking in from their smartphone or a doctor is calling the next person in line, the data syncs across all devices without a single page refresh.

Core Capabilities:

• Live WebSocket Queue: Real-time updates for all connected users.
• Smart Check-In: Digital “tokens” assigned upon arrival.
• Comprehensive Medical Records: Integrated vitals, diagnosis, and prescription management.
• Role-Based Dashboards: Specialized interfaces for Patients, Doctors, and Administrators.

2. The Tech Stack: Appointment System with Django

To handle real-time data and secure medical information, we chose a modern, enterprise-ready stack:

• Backend: Django 4.2 (The “Batteries-Included” Framework).
• Real-Time Layer: Django Channels 4.1 & Daphne (ASGI server).
• Database: MySQL 8.0 for ACID-compliant data integrity.
• Frontend: Bootstrap 5.3 for a responsive, mobile-first UI.
• Communication: Native Browser WebSocket API for low-latency updates.

3. Database Architecture: The Heart of MediQueue

A medical system is only as good as its data model. We partitioned the logic into four distinct Django apps:

Accounts & Profiles

Extending Django’s AbstractUser, we created a custom user model that handles three roles: Patient, Doctor, and Admin.

• DoctorProfile: Stores license numbers, specializations, and ratings.
• PatientProfile: Tracks blood groups, allergies, and insurance data.

Appointments & TimeSlots

Instead of simple date-time strings, we implemented a DoctorAvailability system. Doctors set their weekly schedule, and the system auto-generates TimeSlot objects, preventing double bookings.

Queue Tracker

The QueueEntry The model is the star of the show. It tracks a patient’s position, status (Waiting, Called, Skipped), and timestamps for every stage of the visit.

Watch the Complete Demo Video:- https://www.youtube.com/@Decodeit2

4. How the Real-Time Queue Works

The magic happens in queue_tracker/consumers.py. When a doctor clicks “Call Next,” the following flow occurs:

1. Trigger: The Doctor’s browser sends a JSON action over WebSocket.
2. Logic: The QueueConsumer updates the database, marking the next patient as “Called.”
3. Broadcast: The server sends a queue_update message to the specific group queue_{doctor_id}.
4. UI Update: Every patient and staff member viewing that doctor’s queue sees the list update instantly.

Example WebSocket Message:

JSON

{
  "type": "queue_update",
  "queue": [{ "position": 1, "patient_name": "Rishabh Saini", "status": "Waiting" }],
  "stats": { "waiting_count": 5, "completed_today": 12 }
}

5. Streamlined Medical Records

MediQueue bridges the gap between queue management and clinical documentation.

• Vital Tracking: Capture BP, SpO2, Temperature, and Pulse.
• Prescription Engine: An inline formset allows doctors to add multiple medicines with specific dosages and durations.
• The “Sign-Off” Workflow: When a doctor completes a record, the system automatically marks the appointment as finished and triggers a WebSocket call to the next patient.

6. Setting Up MediQueue: Appointment System with Django

Ready to deploy? Here is the quick-start guide to getting MediQueue running locally:

Prerequisites

• Python 3.10+
• MySQL 8.0+

Installation Steps

Bash

# Clone the repository and enter the directory
cd mediqueue

# Setup Virtual Environment
python -m venv venv
source venv/bin/activate # Linux/Mac

# Install Dependencies
pip install django djangorestframework channels daphne mysqlclient pillow whitenoise

# Database Migration
python manage.py makemigrations
python manage.py migrate

# Start the ASGI Server
daphne -b 0.0.0.0 -p 8000 mediqueue.asgi:application

Note: We use Daphne instead of the standard runserver because standard Django development servers do not support the asynchronous nature of WebSockets.

7. The Future of Clinic Management(Appointment System with Django)

MediQueue demonstrates how modern web technologies like Django Channels can solve age-old logistical problems. By providing patients with transparency and doctors with efficiency, it transforms the healthcare experience from a stressful wait into a streamlined process.

Key Takeaways for Developers:

• Use Custom User Models early to avoid migration headaches.
• Leverage Django Channels for any UI element that requires “live” data.
• WhiteNoise is essential for serving static files when using an ASGI server like Daphne.

appointment system with Django GitHub
appointment system with django pdf
django booking system github
doctor appointment-system django github
appointment system with django example
django appointment github
django appointment demo
appointment-booking-system github