Fullstack Python
Trang chủ / Module 7
🎸 Module 7 / 19 · 4 ngày 📅 Tuần 5 ●●○○ Trung bình

Django cho sản phẩm web: ORM, admin, DRF/Ninja, và khi nào chọn Django

Django là framework Python được tuyển dụng nhiều nhất cho sản phẩm web: project/app, ORM và tối ưu truy vấn (select_related, prefetch_related, F, Q, transaction), migration, admin, auth, DRF hoặc Django Ninja cho API, signal và các bẫy thường gặp.

DjangoDjango ORMAdminDRFDjango Ninjaselect_related
📌 Vì sao module này quan trọng

Rất nhiều công ty trả lương cao (fintech, healthtech, marketplace, SaaS ở Mỹ/Âu) chạy Django từ nhiều năm. Biết Django sâu mở ra gần gấp đôi số việc làm so với chỉ biết FastAPI. Django 'pin kèm' giúp giao sản phẩm rất nhanh, nhưng ORM tiện lợi cũng là nơi sinh N+1 và truy vấn chậm hàng loạt — người phỏng vấn Django gần như luôn hỏi về select_related/prefetch_related.

🎯 Mục tiêu học tập

  • Tổ chức project/app Django, settings theo môi trường
  • Dùng Django ORM hiệu quả: select_related, prefetch_related, only, annotate, F, Q
  • Dùng transaction.atomic, select_for_update, on_commit đúng cách
  • Xây API bằng Django REST Framework hoặc Django Ninja
  • Tận dụng admin, auth; biết bẫy của signal và fat model

Model và ORM hiệu quả

class Task(models.Model):
    org = models.ForeignKey(Organization, on_delete=models.CASCADE, related_name="tasks")
    project = models.ForeignKey(Project, on_delete=models.CASCADE, related_name="tasks")
    assignee = models.ForeignKey(User, null=True, on_delete=models.SET_NULL)
    title = models.CharField(max_length=200)
    status = models.CharField(max_length=20, choices=TaskStatus.choices, default=TaskStatus.TODO)
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        indexes = [models.Index(fields=["project", "status", "-created_at"])]
        constraints = [models.CheckConstraint(condition=~Q(title=""), name="task_title_not_empty")]

# ❌ N+1
for t in Task.objects.all(): print(t.project.name, t.assignee.email)
# ✅
tasks = (Task.objects.filter(org=request.user.org)
         .select_related("project", "assignee")                       # FK/one-to-one → JOIN
         .prefetch_related(Prefetch("comments", queryset=Comment.objects.order_by("-id")[:3]))  # many → query riêng
         .only("id", "title", "status", "project__name", "assignee__email")
         .annotate(comment_count=Count("comments")))

Product.objects.filter(pk=pid, stock__gt=0).update(stock=F("stock") - 1)   # nguyên tử, không race condition

Công cụ: Django Debug Toolbar, django-silk, assertNumQueries trong test; nplusone phát hiện N+1.

Transaction và side effect

from django.db import transaction

@transaction.atomic
def pay_order(order_id: int) -> None:
    order = Order.objects.select_for_update().get(pk=order_id)
    if order.status != OrderStatus.PENDING:
        raise InvalidState()
    order.status = OrderStatus.PAID
    order.save(update_fields=["status"])
    transaction.on_commit(lambda: send_receipt.delay(order.id))   # chỉ gửi khi đã commit thật
  • ATOMIC_REQUESTS bọc cả request trong transaction — tiện nhưng giữ transaction lâu; thường bọc tường minh ở chỗ cần.
  • Signal (post_save) là logic ẩn, khó debug, không chạy với update()/bulk_create — ưu tiên gọi service tường minh.
  • Tránh "fat model" chứa mọi thứ: đặt nghiệp vụ trong tầng service (services.py), model giữ quy tắc nhỏ gắn với dữ liệu.

API: DRF hay Django Ninja

# Django REST Framework
class TaskSerializer(serializers.ModelSerializer):
    class Meta:
        model = Task
        fields = ["id", "title", "status", "assignee", "created_at"]
        read_only_fields = ["id", "created_at"]

class TaskViewSet(viewsets.ModelViewSet):
    serializer_class = TaskSerializer
    permission_classes = [IsAuthenticated, IsOrgMember]
    def get_queryset(self):                                   # LỌC TENANT ở đây — chống IDOR
        return Task.objects.filter(org=self.request.user.org).select_related("assignee")

# Django Ninja — cú pháp kiểu FastAPI, Pydantic, async
api = NinjaAPI()
@api.get("/tasks/{task_id}", response=TaskOut)
def get_task(request, task_id: int):
    return get_object_or_404(Task, pk=task_id, org=request.auth.org)

DRF phổ biến nhất trong codebase hiện có (serializer, viewset, permission, throttling, pagination); Django Ninja nhẹ, nhanh, type hints — lựa chọn tốt cho dự án mới. Serializer lồng nhau là nguồn N+1 kinh điển của DRF.

Admin, auth, async và khi nào chọn Django

  • Admin: back-office trong vài giờ (list_display, search, filter, action) — tối ưu bằng list_select_related; phân quyền chặt và không mở công khai.
  • Auth: custom user model ngay từ đầu (AUTH_USER_MODEL) — đổi về sau rất đau; permission/group; django-allauth cho đăng nhập mạng xã hội.
  • Async: Django hỗ trợ view async và ORM async (aget, afilter...) nhưng nhiều phần vẫn đồng bộ bên dưới; chạy ASGI (Uvicorn/Daphne) khi cần WebSocket (Channels).
  • Django 5.x/6.x mang thêm các tiện ích mới (composite primary key, template partials, Content Security Policy, framework background task) — kiểm tra phiên bản dự án trước khi dùng.
  • Chọn Django khi sản phẩm nhiều CRUD, cần admin, auth, form, template (HTMX), team muốn quy ước rõ; FastAPI khi chủ yếu là API async, dịch vụ AI, microservice.

🏋️ Bài tập thực hành

Back-office Django cho capstone

Dựng một dự án Django dùng chung database PostgreSQL với capstone (hoặc bản sao): (1) custom user model, model Organization/Project/Task (managed hoặc unmanaged tuỳ thiết kế); (2) admin cho nhân viên hỗ trợ với search/filter/action, phân quyền theo group; (3) API báo cáo bằng Django Ninja hoặc DRF có lọc tenant; (4) test với assertNumQueries chứng minh không N+1; (5) một thao tác dùng select_for_update + on_commit. Viết ghi chú so sánh trải nghiệm Django vs FastAPI.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Dùng đúng select_related/prefetch_related, có assertNumQueries
  • Side effect chạy qua on_commit, tránh lạm dụng signal
  • API lọc tenant trong get_queryset
  • Giải thích được khi nào chọn Django thay FastAPI