| Index — decision map, reading order, conventions | references/REFERENCE.md |
Setup — startproject, app layout, settings module vs package, BASE_DIR, INSTALLED_APPS, middleware order, env-based settings | references/setup.md |
Models & ORM — fields, Meta, on_delete, managers, querysets, F/Q, select_related/prefetch_related, .only()/.defer() | references/models-and-orm.md |
Migrations — makemigrations, migrate, --fake, squashmigrations, RunPython, multi-db, schema safety | references/migrations.md |
Views & URLs — FBV vs CBV, generic views, path/re_path, include(), namespacing, reverse() | references/views-urls.md |
Forms & validators — Form, ModelForm, clean_*, formsets, file uploads, related forms | references/forms-and-validators.md |
Templates — DTL, extends/block, custom tags/filters, context processors, partials, Jinja2 backend | references/templates.md |
Auth & permissions — AUTH_USER_MODEL, custom user, permission framework, decorators/mixins, sessions | references/auth-and-permissions.md |
Admin — ModelAdmin, list/detail customization, inlines, actions, autocomplete, hardening | references/admin.md |
| DRF & Django Ninja — when to use which, basic patterns | references/drf-and-ninja.md |
Async views & ASGI — async def, async ORM, sync_to_async, ASGI deploy, Channels integration | references/async-views.md |
| Caching & sessions — cache backends, low-level API, fragment cache, session backends | references/caching-and-sessions.md |
Celery & tasks — django.tasks (Django 6), Celery integration, signals, transaction.on_commit | references/celery-and-tasks.md |
Deployment — Gunicorn vs UvicornWorker, Whitenoise, collectstatic, reverse proxy, DEBUG=False checklist | references/deployment.md |
Recommended defaults — CONN_MAX_AGE, OPTIONS, HSTS, CSRF_TRUSTED_ORIGINS, cookie flags | references/recommended-defaults.md |
Troubleshooting — N+1, OperationalError, csrf_exempt abuse, race conditions, ALLOWED_HOSTS, fake-migrate, async sync-call | references/troubleshooting.md |
Wrong vs Right — N+1, csrf_exempt, bare except, sync ORM in async view, missing on_delete, SECRET_KEY in code | references/wrong-vs-right.md |
| Eval cases | references/eval-cases.md |