Django Development Patterns

Opinionated Django development toolkit enforcing consistent, production-ready patterns.

Core Principles

1. One file = one model/form - Each model and form lives in its own file
2. Consistent prefixes - Abstract (Base*), virtual (Virtual*), proxy (Proxy*)
3. UUID primary keys - All models use UUID instead of auto-increment
4. Timestamps everywhere - All models inherit created_at/updated_at
5. Soft delete by default - Use deleted_at instead of hard deletes
6. Dynaconf for config - Never use plain settings.py
7. uv + pyproject.toml - Use uv for package management with split deps
8. Class member ordering - Strict ordering for readability
9. Docker in /docker - All Docker artifacts in /docker folder

Project Setup (uv + pyproject.toml)

Always use uv for package management with split dependencies: