Simple CRM - Django + MySQL Docker Stack with Prometheus, Grafana & Loki

A complete, self-hosted sales pipeline stack: a Django 5.2 admin app for sales reps, companies, contacts, deals and follow-up activities 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 sales reps, companies, contacts, deals and activities, with search (deal title, company, contact) and filters (stage, owner, expected close month, industry)
• Pipeline rules in the data model: the contact must belong to the deal company, stages only move forward one step at a time (lost from any open stage needs a reason, won and lost are final), and an amount above zero is required from the proposal stage on
• Owner rules: only active reps can own deals, and a rep with open deals cannot be deactivated
• Activity rules: calls, emails, meetings and tasks can only be added to open deals, due dates cannot be earlier than the deal, a finished activity cannot be reopened, and the activities of a won or lost deal are read-only
• No orphan tasks: when a deal is won or lost, all of its open activities are closed automatically with a system note
• One primary contact per company, checked under a row lock, and protected deletes so a company, contact or rep with deals cannot be removed by accident
• Every rule is enforced the same way from the admin form, the bulk actions and direct saves, and business-rule violations show form errors in the admin instead of server errors in normal use
• Bulk actions to advance deals one stage, mark them lost with a reason, or reassign them to a rep chosen in a dropdown; activities can be marked done in bulk
• Overview dashboard with pipeline value and deal count per open stage, a weighted forecast (lead 10%, qualified 25%, proposal 50%, negotiation 75%), deals closing this month, overdue activities, the 90-day win rate and top reps by won amount
• /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 (safe to run again, fake data only) and automated tests

Good to know

• This is an internal, admin-only system for your sales team. There is no email sync, no customer portal and no public web forms.
• All amounts are in US dollars (USD).
• 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.