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.
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ăng | Chi tiết | Module |
|---|---|---|
| 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 & task | CRUD, Kanban kéo thả, gán người, deadline, bình luận, đính kèm file | 4-6, 12 |
| Realtime | Board cập nhật qua WebSocket nhiều instance, tiến độ job qua SSE | 10 |
| Việc nền | Email, nhắc deadline (beat), import/export CSV lớn, xử lý file | 8, 17 |
| Billing | Gói Free/Pro qua Stripe, giới hạn theo gói, webhook idempotent | 10 |
| Tìm kiếm & AI | Full-text + vector hybrid search, "Hỏi AI về project", gợi ý chia nhỏ công việc | 10, 17 |
| Back-office | Django admin hoặc trang HTMX cho nhân viên hỗ trợ, audit log | 7, 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ần | Mốc của capstone |
|---|---|
| 1-2 | Khung dự án uv/ruff/mypy, domain value object, benchmark async |
| 3-4 | API FastAPI, kiến trúc module, Unit of Work |
| 4-5 | PostgreSQL + SQLAlchemy + Alembic, race condition; back-office Django |
| 6-7 | Celery, cache, idempotency; auth đầy đủ, RLS; realtime, file, Stripe, tìm kiếm |
| 8-10 | Frontend React + TanStack Query, trang HTMX, UI, a11y, Web Vitals; bộ test |
| 11 | Docker, CI/CD, deploy domain thật, observability |
| 12 | Profiling, 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 | Đạt | Xuất sắc |
|---|---|---|
| Chức năng | Mọi tính năng chính chạy trên domain thật | Có người dùng thật và phản hồi |
| Code | Type hints, mypy/pyright strict, ruff sạch, tầng rõ ràng | Ranh giới module được cưỡng chế, 5+ ADR |
| Dữ liệu & đúng đắn | Ràng buộc DB, không N+1, không IDOR, không race condition | RLS, optimistic locking, idempotency, outbox, test đồng thời |
| Test | Integration test với Postgres thật, CI xanh | Hypothesis cho logic tiền, 5 E2E ổn định, CI < 10 phút |
| Hiệu năng | Lighthouse ≥ 90, API p95 < 300ms | Báo cáo profiling trước/sau, load test 300 req/s |
| AI | RAG có lọc quyền, stream, quota | Bộ đánh giá tự động, dashboard chi phí, structured output có xác nhận |
| Vận hành | Docker, CI/CD, Sentry | Trace end-to-end, alert, postmortem |
| Trình bày | README có sơ đồ, cách chạy, ảnh chụp | Video 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 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
-
Architecture Decision RecordsMẫu ghi lại quyết định kiến trúcGuide
-
LocustLoad testing viết bằng PythonDocs
-
Full Stack FastAPI TemplateTemplate chính thức FastAPI + React tham khảoRepo
-
Sentry (mã nguồn mở, Django)Tham khảo codebase Django rất lớnRepo
✅ 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