Fullstack Python
Trang chủ / Module 18
🏆 Module 18 / 19 · 10 ngày (song song từ tuần 3) 📅 Tuần 3 → 13 ●●●● Cực khó

Dự án Capstone: SaaS quản lý công việc đa tenant có AI, bằng FastAPI + React

Một sản phẩm duy nhất được xây dần suốt khoá: SaaS quản lý công việc đa tenant bằng FastAPI + SQLAlchemy + PostgreSQL + React, có back-office Django/HTMX, realtime, Celery, thanh toán, tìm kiếm, trợ lý AI có RAG, test, CI/CD, giám sát — chạy trên domain thật.

CapstoneFastAPIMulti-tenantRealtimeBillingAI
📌 Vì sao module này quan trọng

Nhà tuyển dụng trả $5000 mua bằng chứng rằng bạn giao được sản phẩm hoàn chỉnh. Một ứng dụng Python thật có người dùng, số liệu hiệu năng, quyết định kiến trúc được ghi lại, và một tính năng AI được làm có trách nhiệm (quyền, chi phí, đánh giá) là portfolio vượt trội so với hàng chục dự án CRUD. Mỗi hạng mục của capstone tương ứng với một nhóm câu hỏi phỏng vấn thường gặp.

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

  • Giao một sản phẩm fullstack Python hoàn chỉnh trên domain thật
  • Áp dụng toàn bộ kiến thức 17 module vào một codebase nhất quán
  • Ghi lại quyết định kiến trúc (ADR), số liệu hiệu năng và chất lượng AI
  • Có README, video demo và bài viết kỹ thuật để dùng khi phỏng vấn

Phạm vi sản phẩm: "TaskFlow" phiên bản Python

Nhóm tính năngChi tiếtModule
Tài khoản & tổ chứcĐăng ký, xác minh email, Google OIDC, 2FA, organization, mời thành viên, vai trò9
Project & taskCRUD, Kanban kéo thả, gán người, deadline, bình luận, đính kèm file4-6, 12
RealtimeBoard cập nhật qua WebSocket nhiều instance, tiến độ job qua SSE10
Việc nềnEmail, nhắc deadline (beat), import/export CSV lớn, xử lý file8, 17
BillingGói Free/Pro qua Stripe, giới hạn theo gói, webhook idempotent10
Tìm kiếm & AIFull-text + vector hybrid search, "Hỏi AI về project", gợi ý chia nhỏ công việc10, 17
Back-officeDjango admin hoặc trang HTMX cho nhân viên hỗ trợ, audit log7, 13

Kiến trúc mục tiêu

                 ┌─────── CDN (React build, ảnh) ───────┐
Trình duyệt ───▶ │ Load balancer                         │ ──▶ FastAPI (N pod × Uvicorn workers) ──▶ PostgreSQL (+pgvector, replica)
     ▲           └───────────────────────────────────────┘          │                         ──▶ Redis (cache, session, pub/sub, broker)
     │ WebSocket / SSE ◀────────────── Redis pub/sub ◀──────────────┤                         ──▶ S3/R2 (file)
     │                                                              │
     │                Celery workers (default / heavy / ai) + beat ◀┘──▶ Email · Stripe · LLM API
     │                Back-office Django/HTMX (cùng DB, quyền riêng)
     OpenTelemetry → traces · structlog → logs · Sentry → errors · GitHub Actions → deploy

Lộ trình xây dần theo tuần

TuầnMốc của capstone
1-2Khung dự án uv/ruff/mypy, domain value object, benchmark async
3-4API FastAPI, kiến trúc module, Unit of Work
4-5PostgreSQL + SQLAlchemy + Alembic, race condition; back-office Django
6-7Celery, cache, idempotency; auth đầy đủ, RLS; realtime, file, Stripe, tìm kiếm
8-10Frontend React + TanStack Query, trang HTMX, UI, a11y, Web Vitals; bộ test
11Docker, CI/CD, deploy domain thật, observability
12Profiling, scale, tính năng AI có đánh giá, tài liệu thiết kế
13Đánh bóng, dữ liệu demo, video, README, bài viết kỹ thuật

Tiêu chí đạt (rubric)

Hạng mụcĐạtXuất sắc
Chức năngMọi tính năng chính chạy trên domain thậtCó người dùng thật và phản hồi
CodeType hints, mypy/pyright strict, ruff sạch, tầng rõ ràngRanh giới module được cưỡng chế, 5+ ADR
Dữ liệu & đúng đắnRàng buộc DB, không N+1, không IDOR, không race conditionRLS, optimistic locking, idempotency, outbox, test đồng thời
TestIntegration test với Postgres thật, CI xanhHypothesis cho logic tiền, 5 E2E ổn định, CI < 10 phút
Hiệu năngLighthouse ≥ 90, API p95 < 300msBáo cáo profiling trước/sau, load test 300 req/s
AIRAG có lọc quyền, stream, quotaBộ đánh giá tự động, dashboard chi phí, structured output có xác nhận
Vận hànhDocker, CI/CD, SentryTrace end-to-end, alert, postmortem
Trình bàyREADME có sơ đồ, cách chạy, ảnh chụpVideo demo 3 phút + bài viết kỹ thuật

README chuẩn portfolio

  • Một câu mô tả + link demo + tài khoản demo + ảnh GIF.
  • Sơ đồ kiến trúc, tech stack và vì sao chọn từng thứ (FastAPI vs Django ở đâu, React vs HTMX ở đâu, Celery vs arq).
  • Mục "Điểm kỹ thuật đáng chú ý": tenant isolation, race condition, không chặn event loop, idempotency, realtime nhiều instance, chất lượng AI có số liệu.
  • Chạy local bằng một lệnh (docker compose up) với dữ liệu seed.
  • Link tới ADR, OpenAPI docs, báo cáo hiệu năng, báo cáo đánh giá AI, postmortem.

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

Hoàn thiện và công bố

Hoàn thành mọi hạng mục ở mức "Đạt", tối thiểu 3 hạng mục "Xuất sắc". Quay video demo 3 phút (vấn đề → demo → một điểm kỹ thuật khó). Viết một bài kỹ thuật (ví dụ: "Không bao giờ chặn event loop trong FastAPI — 3 cách và số liệu", "RAG đa tenant không rò dữ liệu với pgvector") đăng trên Viblo / dev.to / LinkedIn. Nhờ một developer khác review code và sửa theo góp ý.

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

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

  • Sản phẩm chạy trên domain thật với dữ liệu demo
  • Đạt mọi hạng mục rubric, ≥ 3 hạng mục xuất sắc
  • README, video demo, bài viết kỹ thuật đã công bố
  • Đã có người khác review code