Doc-On-Call

A comprehensive healthcare management system that connects Patients, Doctors, and Hospitals. The platform features a doctor recommendation system based on patient ratings and allows seamless management of medical records and appointments.

---

🚀 Quick Start

Prerequisites

• Python 3.8+
• pip

Installation

# Clone the repository
git clone <repository-url>
cd doc-on-call

# Navigate to the project directory
cd medical/health

# Install dependencies
pip install django

# Run migrations
python manage.py migrate

# Start the development server
python manage.py runserver

The application will be available at: http://localhost:8000

---

🔐 Demo Credentials

Use these credentials to explore the application:

Role	Username	Password	Description
Patient	demo_patient	Demo@123	Access patient dashboard, records, appointments
Doctor	demo_doctor	Demo@123	View patients and appointment history
Hospital	demo_hospital	Demo@123	Manage hospital profile and view doctors
Admin	admin	admin123	Full admin access to Django admin panel

---

🗺️ Navigation Guide

Public Pages (No Login Required)

Page	URL	Description
Home	http://localhost:8000/	Landing page with portal selection
Unified Login	http://localhost:8000/login/	Single login page for all user types
See Doctors	http://localhost:8000/seedocs	View all doctors with ratings
About Us	http://localhost:8000/aboutus	About the platform
Contact Us	http://localhost:8000/contactus	Contact information

Patient Pages

Page	URL	Description
Patient Portal	http://localhost:8000/patient/	Patient landing page
Patient Signup	http://localhost:8000/patient/signup/	Register as a patient
Patient Login	http://localhost:8000/patient/login	Patient-specific login
Patient Dashboard	http://localhost:8000/patient/dashboard	View profile, records & appointments
Create Record	http://localhost:8000/patient/record	Create a new medical record
Create Appointment	http://localhost:8000/patient/appointment	Book a new appointment

Doctor Pages

Page	URL	Description
Doctor Portal	http://localhost:8000/doctor/	Doctor landing page
Doctor Signup	http://localhost:8000/doctor/signup/	Apply as a doctor
Doctor Login	http://localhost:8000/doctor/login	Doctor-specific login
Doctor Dashboard	http://localhost:8000/doctor/dashboard	View patients & appointments

Hospital Pages

Page	URL	Description
Hospital Portal	http://localhost:8000/hospital/	Hospital landing page
Hospital Signup	http://localhost:8000/hospital/signup/	Register a hospital
Hospital Login	http://localhost:8000/hospital/login	Hospital-specific login
Hospital Dashboard	http://localhost:8000/hospital/dashboard	View associated doctors

Admin

Page	URL	Description
Django Admin	http://localhost:8000/admin/	Full admin access

---

👤 User Flows

As a Patient:

1. Go to http://localhost:8000/login/ (or click "Login" in navbar)
2. Select Patient and enter credentials: demo_patient / Demo@123
3. View your dashboard with profile information
4. Create a new record by selecting a doctor
5. Create an appointment for an existing record
6. Rate your doctor after the appointment

As a Doctor:

1. Go to http://localhost:8000/login/
2. Select Doctor and enter credentials: demo_doctor / Demo@123
3. View your dashboard with patient records
4. See all appointments and ratings received

As a Hospital:

1. Go to http://localhost:8000/login/
2. Select Hospital and enter credentials: demo_hospital / Demo@123
3. View all doctors associated with your hospital

---

✨ Features

For Patients

• ✅ Secure registration and login
• ✅ Personal profile management
• ✅ Create medical records with doctors
• ✅ Book appointments
• ✅ Rate doctors (1-5 stars)
• ✅ View appointment history

For Doctors

• ✅ Professional registration
• ✅ View all patient records
• ✅ Track appointments
• ✅ See ratings and feedback
• ✅ Hospital affiliation

For Hospitals

• ✅ Hospital registration
• ✅ View associated doctors
• ✅ Profile management

General

• ✅ Unified login system (single login page for all roles)
• ✅ Doctor recommendation based on ratings
• ✅ Sortable doctor listing by specialization
• ✅ Responsive Bootstrap design
• ✅ Django admin panel

---

🛠️ Technology Stack

Component	Technology
Backend	Django 5.x (Python)
Database	SQLite (default), PostgreSQL/MySQL ready
Frontend	HTML5, CSS3, Bootstrap 4.5
Icons	Font Awesome 4.7
JavaScript	Vanilla JS, jQuery

---

📁 Project Structure

medical/health/
├── manage.py              # Django management script
├── db.sqlite3             # SQLite database
├── .env.example           # Environment variables template
├── .gitignore             # Git ignore rules
│
├── static/css/            # Shared CSS styles
│   └── style.css
│
├── templates/             # Shared templates
│   └── base.html          # Base template with navbar/footer
│
├── health/                # Main project app
│   ├── settings.py        # Django settings (env-based)
│   ├── urls.py            # Main URL routing
│   ├── views.py           # Home, login, seedocs views
│   └── templates/health/  # Main templates
│
├── patient/               # Patient app
│   ├── models.py          # Patient, Record, Appointment models
│   ├── views.py           # Patient views
│   ├── forms.py           # Patient forms
│   └── templates/patient/
│
├── doctor/                # Doctor app
│   ├── models.py          # Doctor model
│   ├── views.py           # Doctor views
│   ├── forms.py           # Doctor forms
│   └── templates/doctor/
│
└── hospital/              # Hospital app
    ├── models.py          # Hospital model
    ├── views.py           # Hospital views
    ├── forms.py           # Hospital forms
    └── templates/hospital/

---

🔧 Configuration

Environment Variables

For production, create a .env file based on .env.example:

cp .env.example .env

Key settings:

SECRET_KEY=your-secret-key-here
DEBUG=False
ALLOWED_HOSTS=yourdomain.com

Database Configuration

Default: SQLite (no configuration needed)

For PostgreSQL:

DB_ENGINE=django.db.backends.postgresql
DB_NAME=doconcall
DB_USER=your_user
DB_PASSWORD=your_password
DB_HOST=localhost
DB_PORT=5432

---

📊 Database Schema

Entity Relationships

Hospital (1) ──── (Many) Doctor (1) ──── (Many) Patient_Record (1) ──── (Many) Appointment
                              │                       │
                              └───────────────────────┤
                                                      │
               Patient (1) ──────────────────────(Many)

Models Overview

Model	Key Fields
Hospital	Name, Address, Phone, User (FK)
Doctor	Name, Qualification, Specialization, Hospital (FK), User (FK)
Patient	Name, DOB, Phone, Address, User (FK)
Patient_Record	Patient (FK), Doctor (FK), Diagnostics
Appointment	Patient_Record (FK), Date, Medication, Fee, Rating

---

📸 Screenshots

ER Diagram

Schema Diagram

Home Page

See Doctors (with Ratings)

Patient Dashboard

Doctor Dashboard

Hospital Dashboard

Admin Panel

---

🔮 Future Scope

• Real-time appointment scheduling with availability calendar
• Video consultation integration
• Prescription management system
• Payment gateway integration
• Mobile app (React Native/Flutter)
• ML-based doctor recommendations
• Email/SMS notifications
• Multi-language support

---

👥 Contributors

• Jash Jain
• Naitik Jain

---

📄 License

This project is for educational purposes.

---

🐛 Troubleshooting

Common Issues

1. "No module named django"

pip install django

2. Database errors after model changes

python manage.py makemigrations
python manage.py migrate

3. Static files not loading

python manage.py collectstatic

4. Create new demo users

python manage.py shell

from django.contrib.auth.models import User
from patient.models import Patient

user = User.objects.create_user('new_patient', 'email@example.com', 'password123')
patient = Patient(user=user, is_patient=True, F_Name='new_patient', M_Name='Test', L_Name='User',
                  Phone_No='1234567890', DOB='1990-01-01', Street='123 Test St',
                  City='Mumbai', State='Maharashtra', Pincode='400001')
patient.save()

---

📞 Support

For issues or questions, please create an issue in the repository.