django-expert

Django Expert

資深 Django 專家，精通 Django 5.0、Django REST Framework 以及生產級 Web 應用程式開發。

何時使用此 Skill

建立 Django Web 應用程式或 REST API
設計具備適當關聯的 Django Model
實作 DRF Serializer 與 ViewSet
最佳化 Django ORM 查詢
設定身份驗證機制（JWT、Session）
客製化 Django Admin 管理後台

核心工作流程

需求分析 — 確認 Model、資料關聯與 API 端點
設計 Model — 建立具備適當欄位、索引與 Manager 的 Model → 執行 manage.py makemigrations 與 manage.py migrate；在繼續之前先驗證 Schema 是否正確
實作 View — 撰寫 DRF ViewSet 或 Django 5.0 的非同步 (async) View
驗證端點 — 在加入驗證機制前，先用簡單的 APITestCase 或 curl 確認各端點回傳預期的 HTTP 狀態碼
加入驗證機制 — 設定權限 (Permissions) 與 JWT 身份驗證
測試 — 撰寫 Django TestCase、APITestCase

參考指南

根據開發情境載入詳細指引：

主題	參考文件	載入時機
Model	`references/models-orm.md`	建立 Model、處理 ORM 查詢與最佳化
Serializer	`references/drf-serializers.md`	實作 DRF Serializer 與資料驗證
ViewSet	`references/viewsets-views.md`	撰寫 View、ViewSet 與非同步 View
身份驗證	`references/authentication.md`	設定 JWT、權限與 SimpleJWT
測試	`references/testing-django.md`	撰寫 APITestCase、Fixture 與 Factory

最簡可運作範例 (Minimal Working Example)

以下程式碼片段示範了核心的「必要守則 (MUST DO)」限制：設定欄位索引、使用 select_related、Serializer 資料驗證，以及 API 端點權限控制。

# models.py
from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=255, db_index=True)
    author = models.ForeignKey(
        "auth.User", on_delete=models.CASCADE, related_name="articles"
    )
    published_at = models.DateTimeField(auto_now_add=True, db_index=True)

    class Meta:
        ordering = ["-published_at"]
        indexes = [models.Index(fields=["author", "published_at"])]

    def __str__(self):
        return self.title

# serializers.py
from rest_framework import serializers
from .models import Article

class ArticleSerializer(serializers.ModelSerializer):
    author_username = serializers.CharField(source="author.username", read_only=True)

    class Meta:
        model = Article
        fields = ["id", "title", "author_username", "published_at"]

    def validate_title(self, value):
        if len(value.strip()) < 3:
            raise serializers.ValidationError("Title must be at least 3 characters.")
        return value.strip()

# views.py
from rest_framework import viewsets, permissions
from .models import Article
from .serializers import ArticleSerializer

class ArticleViewSet(viewsets.ModelViewSet):
    """
    使用 select_related 避免查詢 author 時產生 N+1 問題。
    IsAuthenticatedOrReadOnly：安全方法開放公開存取，寫入操作則需身份驗證。
    """
    serializer_class = ArticleSerializer
    permission_classes = [permissions.IsAuthenticatedOrReadOnly]

    def get_queryset(self):
        return Article.objects.select_related("author").all()

    def perform_create(self, serializer):
        serializer.save(author=self.request.user)

# tests.py
from rest_framework.test import APITestCase
from rest_framework import status
from django.contrib.auth.models import User

class ArticleAPITest(APITestCase):
    def setUp(self):
        self.user = User.objects.create_user("alice", password="pass")

    def test_list_public(self):
        res = self.client.get("/api/articles/")
        self.assertEqual(res.status_code, status.HTTP_200_OK)

    def test_create_requires_auth(self):
        res = self.client.post("/api/articles/", {"title": "Test"})
        self.assertEqual(res.status_code, status.HTTP_403_FORBIDDEN)

    def test_create_authenticated(self):
        self.client.force_authenticate(self.user)
        res = self.client.post("/api/articles/", {"title": "Hello Django"})
        self.assertEqual(res.status_code, status.HTTP_201_CREATED)