django

Django Skill

Load this file when working on a Django project. Use alongside all skills/common/ files.

---

Stack

Layer	Library
Framework	Django 5.x
ORM	Django ORM (built-in)
Migrations	Django migrations
Settings	django-environ or pydantic-settings
Static Files	WhiteNoise (prod)
Task Queue	Celery + Redis
Caching	django-redis
Admin	Django Admin (with django-jazzmin for UI)

---

Project Structure

myproject/
├── config/
│   ├── settings/
│   │   ├── base.py           ← Shared settings
│   │   ├── development.py    ← Dev overrides
│   │   └── production.py     ← Prod overrides
│   ├── urls.py
│   ├── wsgi.py
│   └── asgi.py
├── apps/
│   ├── users/
│   │   ├── models.py
│   │   ├── views.py
│   │   ├── serializers.py    ← (if using DRF)
│   │   ├── services.py
│   │   ├── repositories.py
│   │   ├── urls.py
│   │   ├── admin.py
│   │   ├── apps.py
│   │   ├── migrations/
│   │   └── tests/
│   │       ├── test_models.py
│   │       ├── test_views.py
│   │       └── test_services.py
│   └── core/
│       ├── models.py         ← Abstract base models
│       └── exceptions.py
├── manage.py
└── pyproject.toml

---

Settings Pattern (Split by Environment)

# config/settings/base.py
from pathlib import Path
import environ

env = environ.Env()
BASE_DIR = Path(__file__).resolve().parent.parent.parent
environ.Env.read_env(BASE_DIR / ".env")

SECRET_KEY = env("SECRET_KEY")
DEBUG = env.bool("DEBUG", default=False)
ALLOWED_HOSTS = env.list("ALLOWED_HOSTS", default=[])

DATABASES = {
    "default": env.db("DATABASE_URL")
}

INSTALLED_APPS = [
    # Django built-ins
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # Third party
    "rest_framework",
    "corsheaders",
    # Local
    "apps.users",
    "apps.core",
]

---

Abstract Base Model