Dentacare Clinic Management System

A comprehensive dental clinic management system with multi-role support and integrated modules.

📂 Project Structure

dentacare/
├── clinic/                  # Main Django application
│   ├── models/             # Database models
│   │   ├── employees.py     # HR management models
│   │   ├── patients.py      # Patient records
│   │   └── inventory.py     # Drug inventory system
│   │
│   ├── views/              # Business logic
│   ├── templates/           # Frontend components
│   └── tests/               # Unit tests
│
├── clinic_app/             # Core Django project
│   ├── settings/           # Configuration
│   ├── urls.py             # Routing
│   └── wsgi.py             # Deployment
│
├── requirements.txt        # Dependencies
└── manage.py               # Django CLI

🌟 Key Features

Role-Based Access Control

• Medical Staff
  • Patient treatment history tracking
  • Dental charting visualization
  • Appointment scheduling
• HR Management
  • Employee onboarding workflows
  • Leave management system
  • Performance evaluation templates
• Administration
  • Drug inventory alerts (low stock/expiry)
  • Payroll integration with tax calculations
  • Audit trails for record changes

📦 Modules

Module	Technology Stack	Key Functionality
Patient Records	Django ORM + PostgreSQL	Medical history, X-ray storage, Allergy alerts
Payroll System	Python Decimal + Cronjobs	Automatic deductions, Payslip generation
Drug Inventory	Django REST Framework	Batch tracking, Supplier management, Expiry alerts
Appointment System	Celery + Redis	SMS reminders, Calendar sync, Conflict detection

🛠️ Installation

1. Create virtual environment:

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

2. Install dependencies:

pip install -r requirements.txt

3. Configure environment variables (create .env):

SECRET_KEY=your_django_secret
DEBUG=True
DB_NAME=dentacare_db
DB_USER=postgres_user
DB_PASSWORD=secure_password

4. Run migrations:

python manage.py makemigrations
python manage.py migrate

5. Create superuser:

python manage.py createsuperuser

🔧 Configuration

Update settings.py:

INSTALLED_APPS = [
    ...
    'clinic.apps.ClinicConfig',
    'rest_framework',
    'crispy_forms',
]

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'clinic/static')]

📚 Documentation

• API Docs - Endpoint specifications
• User Manual - Role-specific workflows
• Database Schema - ER diagram

🧪 Testing

Run test suite:

pytest --cov=clinic tests/

🚀 Deployment

Docker Setup

# Dockerfile
FROM python:3.10
RUN pip install gunicorn
COPY . /app
WORKDIR /app

# docker-compose.yml
services:
  web:
    build: .
    command: gunicorn clinic_app.wsgi:application --bind 0.0.0.0:8000
    ports:
      - "8000:8000"

🤝 Contributing

1. Fork the repository
2. Create feature branch:

git checkout -b feature/new-module

3. Commit changes
4. Push to branch
5. Open pull request

📄 License

MIT License

🙏 Acknowledgments

• Django Software Foundation
• PostgreSQL Global Development Group
• Medical Data Working Group standards