🩺 Doctor Appointment System

---

🏥 Overview

The Doctor Appointment System is a complete backend web application developed using Flask and SQLite that simplifies appointment scheduling between patients and doctors.

The system provides secure authentication, appointment management, role-based access, an administrative dashboard, and automated email notifications for every appointment lifecycle.

It demonstrates practical backend engineering concepts including database design, authentication, CRUD operations, email integration, and role-based authorization.

---

✨ Key Features

👤 Authentication

• Secure User Registration
• User Login
• Logout Functionality
• Session Management
• Password Authentication

---

👨‍⚕️ Doctor Management

• Doctor Profiles
• Medical Specializations
• Doctor Availability
• Appointment Schedule

---

🧑‍🤝‍🧑 Patient Features

• Browse Doctors
• Book Appointment
• View Appointment History
• Cancel Appointment
• Appointment Status Tracking

---

📅 Appointment Management

• Create Appointment
• View Appointment
• Update Appointment
• Cancel Appointment
• Appointment Approval Workflow
• Rejection Workflow
• Status Management

---

👨‍💼 Admin Dashboard

The administrator has complete control over the system.

User Management

✅ View Users

✅ Manage Patients

✅ Manage Doctors

✅ Remove Users

---

Appointment Management

✅ View All Appointments

✅ Approve Appointment

✅ Reject Appointment

✅ Cancel Appointment

✅ Track Appointment Status

---

📧 Email Notification System

The application automatically sends email notifications for:

📩 Appointment Booking

📩 Appointment Approval

📩 Appointment Rejection

📩 Appointment Cancellation

Supports:

• Gmail SMTP
• Local Debug SMTP
• Production SMTP Server

---

🛡 Security Features

• User Authentication
• Session Protection
• Role-Based Access Control
• Admin Authorization
• Input Validation
• Secure Form Handling

---

🏗 Tech Stack

Category	Technologies
Backend	Flask
Language	Python
Database	SQLite
ORM	SQLAlchemy
Forms	Flask-WTF
Email	Flask-Mail
Authentication	Flask Login
Frontend	HTML5, CSS3, Bootstrap
Templates	Jinja2

---

📂 Project Structure

doctor-appointment-system/
│
├── app.py
├── models.py
├── forms.py
├── routes.py
├── email_utils.py
├── requirements.txt
│
├── templates/
│   ├── admin/
│   ├── patient/
│   ├── doctor/
│   └── auth/
│
├── static/
│
├── instance/
│   └── database.db
│
└── README.md

---

🚀 Quick Start

Create Virtual Environment

python -m venv venv

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

---

Install Dependencies

pip install -r requirements.txt

---

Debug SMTP Server

python -m smtpd -c DebuggingServer -n localhost:8025

---

Initialize Database

flask --app app.py init-db

---

Run Application

flask --app app.py run

Application URL

http://127.0.0.1:5000

---

👥 Sample Accounts

👨‍💼 Administrator

Email:
admin@example.com

Password:
password

---

🧑 Patient

Email:
patient@example.com

Password:
password

---

👨‍⚕️ Doctor 1

Email:
doc1@example.com

Password:
password

Specialization:
Cardiology

---

👨‍⚕️ Doctor 2

Email:
doc2@example.com

Password:
password

Specialization:
Dermatology

---

📧 Real SMTP Configuration

Configure environment variables

MAIL_SERVER=smtp.gmail.com
MAIL_PORT=587
MAIL_USE_TLS=True
MAIL_USERNAME=your@gmail.com
MAIL_PASSWORD=your_app_password
MAIL_DEFAULT_SENDER=your@gmail.com

---

⚙ Application Workflow

Patient Registration
        │
        ▼
User Login
        │
        ▼
Browse Doctors
        │
        ▼
Book Appointment
        │
        ▼
Appointment Stored
        │
        ▼
Email Notification Sent
        │
        ▼
Admin Reviews
        │
        ▼
Approve / Reject
        │
        ▼
Patient Receives Email

---

📌 Future Enhancements

• PostgreSQL Migration
• REST API Integration
• JWT Authentication
• Doctor Availability Calendar
• Payment Gateway Integration
• Video Consultation
• Prescription Upload
• Medical Reports
• SMS Notifications
• Docker Deployment
• CI/CD Pipeline
• AWS Deployment
• Redis Caching
• Appointment Analytics Dashboard

---

🎯 Learning Outcomes

This project demonstrates practical experience with:

• Flask Application Development
• SQLAlchemy ORM
• Authentication & Authorization
• CRUD Operations
• MVC Architecture
• Database Design
• Flask-Mail Integration
• SMTP Configuration
• Admin Dashboard Development
• Session Management
• Form Validation
• Production Configuration
• Backend System Design

---

💡 What Makes This Project Stand Out?

Unlike a basic CRUD application, this project focuses on solving a real-world healthcare scheduling problem by implementing:

• Multi-role authentication
• Appointment lifecycle management
• Automated email communication
• Administrative control panel
• Secure backend architecture
• Clean and maintainable project structure

These features closely resemble patterns used in production-grade web applications.

---

👨‍💻 About the Developer

Vishnu R

Python Backend Developer | Django Developer | Flask Developer

I enjoy designing backend systems that are clean, scalable, and practical. My primary focus is on building REST APIs, authentication systems, database-driven applications, and production-ready backend architectures using Python.

Through projects like this Doctor Appointment System, I have strengthened my understanding of backend development by implementing real-world workflows such as role-based access control, secure authentication, email automation, and complete CRUD operations.

I continuously explore better software engineering practices, modern backend technologies, and scalable system design to build applications that are reliable, maintainable, and ready for real-world deployment.

---

⭐ Thank You for Visiting!

If you found this project helpful or interesting, consider giving it a ⭐ on GitHub.