Doctor Appointment Booking System with source code

Requirements

Python (latest version preferable)
Django (latest version preferable)
IDE (Visual Studio Code preferable)
and a browser is needed to run the project.
If you don't know how to create a Django local virtual environment please click the link to know about.

Abstract

Doctor Appointment Booking system using Django framework in python, along with Html and Css. Django not only makes our work easy which also provides the end user a user-friendly visualisation of what is happening.

The beauty of Django is that it provides an in-built database. So there is no need to create a database connection that has to be created in this project.

One of Django's features is that we can split users into groups. Here we are going to split user’s into three groups called Admin, Doctor and Patient group. For a new user patient group is going to be a default one, if the user belongs to a doctor or admin administrative person has to put the user in that specified group.

Django also provides a default user registration and authentication system within it. With the help of the group's, user's will be redirected to their respective pages. For Example If the user belongs to a patient group that user will be redirected to the Patient Registration Page.

Feature Of Work

While filling the patient's registration form the user has to choose the appointment date and a doctor from the available doctor's drop down and the details will be shown to the particular doctor and the doctor makes the decision whether to schedule or reject the requested appointment and an email will sent to the patient's Email ID to know about the appointment details.

Procedure

Step 1: Run the Django project and open the URL generated in IDE’s terminal in a browser. Now, in the home page we get to view the register and login options.
Step 2: Once a user account is changed to a doctor's group that doctor has to fill the Doctor’s Registration Form.
Step 3: While filling the patient's registration form the user has to choose the appointment date and a doctor from the available doctor's drop down.
Step 4: In the doctor module the doctor has to approve or reject the requested patient's appointment.
Step 5: Once the appointment has been confirmed or rejected a mail will be generated and sent to the patient's mail-id.

Problem Statement

The only impediment about this project is one patient can request as many appointment's as he/she wants and there is no restriction for a patient user to wait until the requested result arrives he/she can be request appointment's to multiple doctor's at the same time.

views.py

from django.http.response import HttpResponse, HttpResponseRedirect from django.shortcuts import get_object_or_404, render, redirect from. forms import CreateUserForm, patient_info, doctor_infos from django.contrib import messages from django.contrib.auth import get_user from .import models from django.contrib.auth.models import Group from django.contrib.auth import authenticate, login, logout from django.contrib.auth.decorators import login_required from. decorators import unauthenticated_user from django.core.exceptions import ValidationError from django.contrib.auth.models import User from django.core.mail import EmailMultiAlternatives from datetime import date import re def home(request): return render(request, 'GFG.html') @unauthenticated_user def register(request): # default user login form form =CreateUserForm() if request.method == 'POST': form = CreateUserForm(request.POST) if form.is_valid(): usernamedisplay = form.cleaned_data.get('username') email = request.POST.get('email') if User.objects.filter(email=email).exists(): messages.error(request,'Please provide unique email') context = {'form':form} return render(request, 'register.html', context) #setting user to assign group by default user = form.save() group = Group.objects.get(name ='Patient') user.groups.add(group) messages.success(request,'Successfully created account for {}. Login to Continue...'.format(usernamedisplay)) else: messages.error(request,'Please provide valid details in the form') context = {'form':form} return render(request, 'register.html', context) @unauthenticated_user def login_page(request): form =CreateUserForm() if request.method == 'POST': username = request.POST.get('username') password = request.POST.get('password') user = authenticate(request, username=username, password=password) if user is not None: login(request,user) return redirect('to_user_login') else: messages.error(request,'Username and Password does not match') context = {'form':form} return render(request, 'login.html',context) def logout_page(request): logout(request) return render(request,'GFG.html') @login_required(login_url="login") def to_user_login(request): group = request.user.groups.filter(user=request.user)[0] if group.name =="Admin": return HttpResponseRedirect('admin') elif group.name == "Patient": return HttpResponseRedirect('patient') elif group.name == "Doctor": return HttpResponseRedirect('doctor_front') return render(request, 'GFG.html') def doctor_front(request): return render(request, 'doctor_front.html') def doctor(request): form = doctor_infos() user = get_user(request) if request.method == 'POST': try: instance = get_object_or_404(models.doctor_infos, id = user) form = doctor_infos(request.POST or None, instance = instance) except Exception as e: form = doctor_infos(request.POST) if form.is_valid(): form.save() return HttpResponseRedirect('doctor_front') else: try: info = models.doctor_infos.objects.get(id = user) form = doctor_infos(instance=info) except Exception as e: email_id = user.email form = doctor_infos(initial={'id':user, 'email':email_id}) context = {'form': form} return render(request, 'doctor.html',context) def patient(request): form = patient_info() user = get_user(request) if request.method == 'POST': try: form = get_object_or_404(models.patient_info, user_name = user) except Exception as e: form = models.patient_info() form.user_name = user form.email_id = user.email form.first_name = request.POST.get('first_name') form.last_name = request.POST.get('last_name') form.mobile_number = request.POST.get('mobile_number') form . state= request.POST.get('state') form.sex= request.POST.get('sex') form.city= request.POST.get('city') form.zip= request.POST.get('zip') form.dob = request.POST.get('dob') form.reason = request.POST.get('reason') form.family_doctor_name = request.POST.get('family_doctor_name') form.family_doctor_phone =request.POST.get('family_doctor_phone') form.current_medication_list = request.POST.get('current_medication_list') form.emergency_first_name = request.POST.get('emergency_first_name') form.emergency_last_name = request.POST.get('emergency_last_name') form.emergency_relationship = request.POST.get('emergency_relationship') form.emergency_mobile_number = request.POST.get('emergency_mobile_number') form.address = request.POST.get('address') form.symptoms = request.POST.get('symptoms') form.doctor = request.POST.get('doctor') form.appointment_date = request.POST.get('appointment_date') form.status = True form.save() return HttpResponseRedirect('patient') else: try: info = models.patient_info.objects.get(user_name = user) form = patient_info(instance=info) except Exception as e: email_id = user.email form = patient_info(initial={'user_name':user, 'email_id':email_id}) doctor = models.doctor_infos.objects.all() context = {'form': form,'doctor':doctor} return render(request, 'patient.html',context) def appointment(request): user = get_user(request) patient = models.patient_info.objects.all().filter(doctor = user, status = True) if request.method == 'POST': if request.POST.get('accept'): patient_user_name = request.POST.get('accept') pi = models.patient_info.objects.get(user_name = patient_user_name) di = models.doctor_infos.objects.get(id = user) doctor_name = di.first_name + " " + di.last_name patient_name = pi.first_name + " " + pi.last_name appointment_date = pi.appointment_date doctor_phone_number = di.mobile_number subject ='"Appointment with Doctor({}) has been confirmed"'.format(doctor_name) message = "Hi {}, your appointment has scheduled in the requested date {}. For more details please contact through this hospital mail or contact doctor through this {} phone number".format(patient_name, appointment_date,doctor_phone_number) sa = models.scheduled_appointments() sa.doctor = user sa.patient = patient_name sa.date = pi.appointment_date sa.reason = pi.reason sa.symptoms = pi.symptoms sa.email_id = pi.email_id sa.mobile_number = pi.mobile_number sa.save() else: patient_user_name = request.POST.get('reject') pi = models.patient_info.objects.get(user_name = patient_user_name) di = models.doctor_infos.objects.get(id = user) doctor_name = di.first_name + " " + di.last_name patient_name = pi.first_name + " " + pi.last_name appointment_date = pi.appointment_date doctor_phone_number = di.mobile_number subject ='"Sorry appointment with Doctor({}) has been cancelled"'.format(doctor_name) message = "Hi {}, your appointment has cancelled for the date {}. Please try to consult the doctor with different date or try another doctor available, sorry for the inconvenince. For more details contact through this hospital mail".format(patient_name, appointment_date) email_from = "YOUR EMAIL" email_to = [pi.email_id] email = EmailMultiAlternatives(subject,message, email_from, email_to) email.send() pi.status = False pi.save() scheduled = models.scheduled_appointments.objects.all().filter(doctor = user) today = [] future = [] for s in scheduled: if s.date == date.today(): today.append(s.date) if s.date > date.today(): future.append(s.date) context ={'patient':patient,'scheduled':scheduled,'today':today,'future':future} return render(request, 'appointment.html',context)


models.py

from django.db import models from django.db.models import field class doctor_infos(models.Model): id = models.CharField(max_length=150, primary_key=True) email = models.CharField(max_length=320) first_name = models.CharField(max_length=20) last_name = models.CharField(max_length=20) state = models.CharField(max_length=20) address = models.CharField(max_length=100) sex = models.CharField(max_length=10) city = models.CharField(max_length=20) mobile_number = models.CharField(max_length=10) specialist_in = models.CharField(max_length=50) def __str__(self): return self.first_name + " " + self.last_name + " " + self.specialist_in class scheduled_appointments(models.Model): doctor = models.CharField(max_length=150,default="") patient = models.CharField(max_length = 50, default="") date = models.DateField(default="") reason = models.CharField(max_length=60,default = "") symptoms = models.CharField(max_length=100,default="") email_id = models.CharField(max_length=320,default = "") mobile_number = models.CharField(max_length=10) def __str__(self): return self.doctor + " " + self.patient class patient_info(models.Model): user_name = models.CharField(primary_key=True, max_length=150) email_id = models.CharField(max_length=320,default = "") first_name = models.CharField(max_length=20) last_name = models.CharField(max_length=20) mobile_number = models.CharField(max_length=10) state = models.CharField(max_length = 20) sex = models.CharField(max_length=6,blank=True, null=True) city = models.CharField(max_length = 20,default = "") zip = models.CharField(max_length=6,default = "") dob = models.DateField(default="") reason = models.CharField(max_length=60,default = "") family_doctor_name = models.CharField(max_length=50,blank=True, null=True) family_doctor_phone = models.CharField(max_length=10,blank=True, null=True) current_medication_list = models.CharField(max_length=100,default = "",blank=True, null=True) emergency_first_name = models.CharField(max_length = 30,default = "") emergency_last_name = models.CharField(max_length = 30,default = "") emergency_relationship = models.CharField(max_length = 20,default = "") emergency_mobile_number = models.CharField(max_length = 10,blank=True, null=True) address = models.CharField(max_length=100,default="") symptoms = models.CharField(max_length=100,default="") doctor = models.CharField(unique=False,max_length=150, default="") status = models.BooleanField(default=False) appointment_date = models.CharField(max_length=11,blank=True, null=True,default="") def __str__(self): return self.first_name

urls.py

from django.urls import path from . import views urlpatterns = [ path('',views.home, name="home"), path('home',views.home), path('register',views.register, name="register"), path('login_page',views.login_page, name="login"), path('logout_user',views.logout_page,name="logout"), path('to_user_login',views.to_user_login,name="to_user_login"), path('patient',views.patient,name="patient"), path('doctor_front',views.doctor_front,name="doctor_front"), path('doctor',views.doctor,name="doctor"), path('appointment',views.appointment, name="appointment") ]

forms.py

from typing import Type from django.forms import ModelForm, fields, ModelChoiceField,MultipleChoiceField from django.contrib.auth.forms import UserCreationForm from django import forms from. models import patient_info, doctor_infos from django.contrib.auth.models import User from django.forms.widgets import DateInput, TimeInput class CreateUserForm(UserCreationForm): class Meta: model = User fields =['username', 'email', 'password1', 'password2'] error_message = { 'username':{ 'unique': 'username must only contains let,num,char(@ . + - _)' } } class patient_info(ModelForm): class Meta: model = patient_info exclude = ('status','doctor') fields = '__all__' labels = { 'first_name': ('First Name'), 'last_name': ('Last Name'), 'mobile_number': ('Mobile Number'), 'address': ('Address'), 'state': ('State'), 'sex': ('Sex'), 'city': ('City Name'), 'zip': ('Pin Code'), 'dob': ('D.O.B'), 'reason':('Reason'), 'family_doctor_name': ('Family Doctor Name'), 'family_doctor_phone': ('Family Doctor Phone'), 'current_medication_list': ('Current Medication'), 'emergency_first_name': ('Emergency Person First Name'), 'emergency_relationship' : ('Emergency Person Relationship'), 'emergency_mobile_number' :('Emergency Person Mobile Number'), 'symptoms': ('Symptoms'), 'doctor': ('Available Doctors'), 'appointment_date': ('Appointment Date'), } widgets = { 'dob': DateInput(attrs={'type': 'date'}), 'appointment_date': DateInput(attrs={'type': 'date'}), } class doctor_infos(ModelForm): class Meta: model = doctor_infos # exclude = ('id','email',) fields = '__all__' labels = { 'id': ('User Name'), 'email': ('Email ID'), 'first_name': ('First Name'), 'last_name': ('Last Name'), 'mobile_number': ('Mobile Number'), 'address': ('Address'), 'state': ('State'), 'sex': ('Sex'), 'city': ('City Name'), 'specialist_in':('Specialized In'), } widgets = { 'dob': DateInput(attrs={'type': 'date'}) }

decorators.py

from django.shortcuts import redirect def unauthenticated_user(view_func): def wrapper_func(request, *args, **kwargs): if request.user.is_authenticated: return redirect('to_user_login') else: return view_func(request, *args, **kwargs) return wrapper_func
Mail

And to send email enter you Mail ID in EMAIL_HOST_USER in settings.py and the enter your email app password in EMAIL_HOST_PASSWORD in settings.py. If you doesn't have a email app password sign-in into your Google Account and create a app password for Email and enter here. And enter you Mail ID in views.py in the 'email_from' field.

EMAIL_HOST = 'smtp.gmail.com' EMAIL_PORT = 587 EMAIL_HOST_USER = 'YOUR EMAIL' EMAIL_HOST_PASSWORD = 'APP PASSWORD' EMAIL_USE_TLS = True

Conclusion

Thus the Doctor Appointment Booking System has been successfully created and implemented by including the required fundamental features.

Click here to see full project code in GitHub Repositorie.