A Django-based luxury clinic management system that streamlines patient care, appointment scheduling, and administrative workflows with a modern, responsive interface.
- Complete Patient Registration with profile photos, blood type, BMI calculation, and emergency contacts
- Medical History Tracking: allergies, chronic conditions, current medications with dosage tracking
- Doctor Recommendations: personalized service suggestions linked to patient records
- Secure Patient Dashboard for viewing appointments, medical data, and treatment plans
- Smart Appointment Scheduling with Jalali (Persian) calendar support for regional compatibility
- Service-Based Booking: patients select from available clinic services with real-time capacity management
- Automated Capacity Control: prevents overbooking with dynamic slot availability
- Appointment Confirmation Workflow with admin approval and status tracking
- Comprehensive Management Dashboard with role-based access control
- Service Catalog Management: rich-text descriptions, images, pricing, availability windows
- Staff/Personnel Management module for doctors and clinic staff
- Analytics & Reporting: appointment statistics, patient demographics, service utilization
- Real-time Chat System for patient-doctor consultations
- Contact Forms & Inquiry Management
- Comments, Ratings & Favorites system for service feedback
- SMS Notifications via Kavenegar integration for appointment reminders
- Responsive Design with Bootstrap + Tailwind CSS for mobile-first experience
- Rich Media Gallery showcasing clinic facilities and before/after results
- Promotional Offers & Discounts system with time-based activation
- Advanced Search & Filtering across services, doctors, and appointments
| Layer | Technologies |
|---|---|
| Backend | Python 3.11+, Django 5.1, Django REST Framework, SimpleJWT |
| Database | MySQL 8.0 (production-ready with dockerized setup) |
| Frontend | HTML5, CSS3, JavaScript, jQuery, Bootstrap 5, Tailwind CSS |
| Rich Content | Django-CKEditor for WYSIWYG content management |
| Localization | django-jalali, jdatetime for Persian calendar & locale support |
| Authentication | Custom user model, role-based permissions, JWT tokens |
| File Handling | Custom FileUpload utility for secure image/media management |
| DevOps | Docker, Docker Compose, environment-based configuration |
| Utilities | django-filter, django-admin-decorators, pillow for image processing |
| Challenge | Solution |
|---|---|
| ❌ Manual appointment scheduling errors | ✅ Automated capacity tracking + calendar validation prevents double-booking |
| ❌ Fragmented patient records | ✅ Unified patient profiles with medical history, medications, and allergies in one place |
| ❌ Poor patient communication | ✅ Integrated SMS reminders, real-time chat, and status notifications |
| ❌ Inefficient service management | ✅ Centralized catalog with availability windows, pricing, and promotional controls |
| ❌ Limited accessibility | ✅ Fully responsive design works on any device; Jalali calendar for regional users |
| ❌ Complex deployment | ✅ One-command Docker setup with health checks, volumes, and environment isolation |
| ❌ Data security concerns | ✅ Role-based access, secure authentication, and environment-variable configuration |
# 1. Clone & configure
git clone https://github.com/samira-dev-star/royal-clinic-project
cd royal-clinic-project
cp .env.example .env # Edit with your credentials
# 2. Launch with Docker Compose
docker-compose up -d
# 3. Access the application
# Frontend: http://localhost:8000
# Admin Panel: http://localhost:8000/admin
# phpMyAdmin (dev): http://localhost:8080- ✅ Environment-based secrets management (
.env+ Docker) - ✅ MySQL with persistent volumes for data durability
- ✅ Health checks for web and database services
- ✅ Custom middleware for request isolation and thread safety
- ✅ Input validation at model and form levels
- ✅ MIT License for flexible commercial use
💡 Ideal For: Luxury medical clinics, aesthetic centers, dental practices, and specialized healthcare providers seeking a modern, scalable, and locally-adapted management solution with Persian language/calendar support.
Built with ❤️ using Django — Secure, Scalable, Production-Ready.