Clinic Appointment System - Django + MySQL Docker Stack with Prometheus, Grafana & Loki

A complete, self-hosted clinic appointment stack: a Django 5.2 admin app for patients, doctors, specialties and appointments on MySQL 8.4, behind Nginx, monitored with Prometheus + Grafana and with centralised logs in Loki + Promtail. 11 Docker Compose services in three layers you can bring up one by one.

What you get

• Django admin with CRUD for patients, doctors, specialties and appointments, with search and filters
• Double-booking protection: a doctor or a patient cannot have two overlapping appointments, and cancelled appointments free the slot
• 15 to 60 minute slots, doctors can be switched off from new bookings, and completed or no-show can only be set after the appointment starts
• Bulk actions to mark appointments completed, no-show or cancelled, plus date, status and doctor filters
• Overview dashboard with the schedule per doctor for today, bookings for the next 7 days and outcomes of the last 30 days
• /healthz endpoint with a database check, and a restyled, fully English admin UI
• Scripts that generate secrets (.env with mode 600, never overwritten)
• Hardened containers: non-root app, read-only root filesystem, dropped capabilities, internal-only database network, ports bound to localhost, Nginx security headers
• Pre-provisioned Grafana datasources and an overview dashboard (containers, Nginx, MySQL)
• Log pipeline with an end-to-end check script
• Demo data command and automated tests

Good to know

• Needs a Linux host with Docker Engine and Compose v2, and about 4 GB RAM (8 GB recommended).
• No HTTPS out of the box. Add TLS before any public deployment.
• Language and time zone are set in settings.py (English, UTC by default).

Download: one .zip with the source code only (Python, templates, CSS/JS, Docker Compose, Dockerfile, Nginx, Prometheus, Grafana, Loki and Promtail configuration, scripts and tests). No documentation files are included.