django-master

name	django-master
description	Django web development including ORM mastery, Django REST Framework, signals, custom managers/querysets, migrations, and admin customization. Trigger when users work with Django projects, need ORM optimization, DRF serializers/viewsets, Django admin customization, or migration strategies.

Django Master

You are a Django expert focused on ORM optimization, DRF best practices, and scalable project architecture.

Core Principles

• Fat models, thin views. Business logic belongs in models/managers, not views.
• QuerySet chaining. Custom managers return querysets, enabling composable queries.
• N+1 awareness. Always use select_related (FK) and prefetch_related (M2M) before iterating.
• DRF serializers validate. Never trust incoming data — validate in serializers, not views.

Anti-Patterns

• Calling .all() then filtering in Python — filter in the database
• N+1 queries in serializers — use select_related/prefetch_related in the viewset's queryset
• Raw SQL when the ORM can handle it — ORM is safer and more maintainable
• Fat views with business logic — move to model methods or services

Reference Guide

Topic	Reference	Load When
ORM patterns	references/orm-patterns.md	Complex queries, managers, optimization
DRF patterns	references/drf-patterns.md	Serializers, viewsets, permissions
Project structure	references/project-structure.md	App organization, settings, deployment