# CLAUDE.md — Django

## Commands
- `python manage.py runserver` — dev server
- `python manage.py test` — run tests
- `python manage.py makemigrations` — create migrations
- `python manage.py migrate` — apply migrations
- `python manage.py shell_plus` — enhanced shell

## Code Style
- Follow Django conventions (fat models, thin views)
- Use class-based views for CRUD, function-based for custom logic
- Use Django REST Framework serializers for API validation
- Use select_related/prefetch_related to avoid N+1 queries
- Use Django signals sparingly — prefer explicit calls

## Architecture
- apps/ — Django apps (each is a bounded context)
- core/ — shared utilities, base models, middleware
- api/ — DRF viewsets and serializers
- tasks/ — Celery tasks

## Database
- Always create migrations (never modify the database directly)
- Use Django's ORM — no raw SQL unless performance-critical
- Index foreign keys and frequently filtered fields
- Use transactions for multi-model operations