Xây dựng ứng dụng quản lý kho với Java Spring MVC, Hibernate và MySQL
Nguyễn Việt Hùng
Xây dựng ứng dụng bán khóa học trực tuyến với ASP.NET Core 10, Clean Architecture, CQRS, OpenIddict & React/Next.js
12 chương • 14 video • 3 giờ học
Xây dựng ứng dụng bán khóa học trực tuyến với ASP.NET Core 10, Clean Architecture, CQRS, OpenIddict & React/Next.js.
Dự án xuyên suốt: TEDU Market — nền tảng bán khóa học trực tuyến (không phải LMS quản lý nội bộ), gồm Web học viên (Next.js), App quản trị (React Vite) và backend .NET. Khóa đi theo cách làm sản phẩm thật: viết bộ tài liệu dự án trước (PRD, glossary, architecture, ux, deploy, conventions), rồi làm từng story theo backlog Kanban từ docs/status.md. Mỗi bài là một story có acceptance criteria quan sát được, làm xong mới sang story kế tiếp.
Developer đã biết C# và ASP.NET Core cơ bản (Controller, EF Core CRUD đơn giản).
Muốn nâng trình độ lên kiến trúc production thật (Clean Architecture, CQRS, OAuth2/OIDC chuẩn, full-stack React/Next.js, CI/CD, vận hành), không dừng ở mức "chạy được".
Muốn có 1 sản phẩm full-stack hoàn chỉnh (backend + 2 frontend + hạ tầng) làm portfolio.
Không phù hợp cho: người chưa từng làm Web API.
Yêu cầu đầu vào: C# và ASP.NET Core cơ bản. Trong combo: học sau TEDU-66 và TEDU-68.
Xây được toàn bộ một hệ thống bán khóa học trực tuyến chạy được trên staging và production, không phải project demo rời rạc.
Dùng Clean Architecture + CQRS ngay từ story đầu tiên (Mediator, EF Core phía ghi, Dapper phía đọc).
Xây Authorization Server bằng OpenIddict (Authorization Code + PKCE, Google login, vai trò Student/Instructor/Admin, policy và kiểm tra sở hữu).
Làm luồng thanh toán chuyển khoản VietQR an toàn: hook xác thực token, idempotent, Outbox, Enrollment không trùng.
Tải video lên, xử lý bằng ffmpeg thành HLS AES-128 và phát qua API có kiểm soát quyền.
Triển khai bằng Docker, GitHub Actions, Nginx 3 subdomain, TLS, backup/restore, giám sát; có staging và production, rollback.
Viết unit test, integration test (Testcontainers), test phân quyền, E2E, đo Lighthouse và load test trước khi go-live.
Nền tảng bán khóa học trực tuyến: hành trình duyệt khóa, giỏ hàng, thanh toán, sở hữu quyền truy cập, học video; Instructor đăng khóa (qua duyệt) và nhận doanh thu chia theo tỷ lệ.
Epic (theo status.md) | Phạm vi |
|---|---|
Nền tảng | Monorepo, backend khung, DB, log, test, CORS/cache/rate limit, package |
Hạ tầng/CI-CD | CI PR, Dockerfile, GHCR, VPS, compose prod, deploy stg/prod, backup, giám sát |
Identity | OpenIddict + Identity, seeding Admin, Google login, Outbox, Notification (Resend) |
Instructor | Duyệt Instructor, Hồ sơ Instructor |
Course | Category, Khóa học, Bài học, thumbnail, duyệt khóa, snapshot LastApprovedVersion, xem thử, truy vấn công khai, tìm kiếm full-text |
Video | Upload mp4, worker ffmpeg HLS AES-128 |
Enrollment, Cart/Coupon | Quyền truy cập, Coupon, Giỏ hàng |
Order, Payment | Checkout idempotent, VietQR, hook thanh toán, hết hạn, xử lý đơn |
Learning | Phát video, báo lỗi video |
Revenue | Tỷ lệ chia, Khoản chia, Số dư, Phiếu chi, dashboard doanh thu |
Chất lượng & vận hành | Test phân quyền, E2E, Lighthouse, load test, diễn tập khôi phục, go-live |
Query side tách khỏi Entity ghi. Ghi: EF Core + Aggregate. Đọc: Dapper raw SQL chiếu thẳng ra DTO.
Mediator của martinothamar (source generator) cho CQRS, thay MediatR (tránh giấy phép thương mại của MediatR từ v13). Cần xác nhận lại điều khoản license trước khi ghi lên trang khóa học.
OpenIddict chạy chung trong API project, không tách Authorization Server thành service riêng.
Monorepo pnpm + Turborepo: apps/student-web (Next.js 16), apps/admin-app (React Vite), packages/ui, packages/api-client (sinh bằng @hey-api/openapi-ts).
Outbox + BackgroundService (thăm dò ~2 giây, FOR UPDATE SKIP LOCKED), không dùng Hangfire.
Thanh toán qua hook (header X-API-Token, so sánh thời gian cố định, UPDATE có điều kiện), Payment và OutboxMessage ghi cùng transaction.
Video: mp4 ≤ 1 GB, HLS AES-128 bằng ffmpeg, phát qua API và Nginx X-Accel-Redirect.
Bài | Story | Tên bài |
|---|---|---|
3 | T01 | Khởi tạo monorepo pnpm + Turborepo và solution .NET |
4 | T02 | Khung backend: Minimal API |
5 | T03 | PostgreSQL 18, EF Core, Dapper, docker-compose dev và migration đầu |
6 | T04 | Log có cấu trúc Serilog + Seq, CorrelationId, health live/ready |
7 | T05 | Khung test: xUnit, Testcontainers, phân loại Unit/Integration, coverage |
8 | T06 | CORS, security headers, Output Cache và RateLimiter trong bộ nhớ |
9 | T07 | Package |
10 | T08 | API client dùng chung sinh bằng openapi-ts |
11 | T09 | Khung Web học viên (Next.js 16): layout, header, responsive, SEO nền |
12 | T10 | Khung App quản trị (React Vite): sidebar theo vai trò, layout, responsive |
Bài | Story | Tên bài |
|---|---|---|
13 | T11 | CI cho pull request: unit, integration và ngưỡng coverage |
14 | T12 | Dockerfile api/web/admin/migrator và job build đẩy GHCR theo SHA |
15 | T13 | Dựng VPS: Docker, user deploy, Nginx 3 subdomain, TLS, volume Video |
16 | T14 | docker-compose.prod.yml, |
17 | T15 | Job |
18 | T16 | Job |
19 | T17 | Backup và restore: pg_dump hằng ngày, đồng bộ Video và MinIO ra ngoài VPS |
20 | T18 | Giám sát: probe ngoài VPS, alert, đĩa, TLS, backup |
Bài | Story | Tên bài |
|---|---|---|
21 | T19 | Identity: OpenIddict + ASP.NET Core Identity, Code + PKCE, vai trò, policy |
22 | T20 | Seeding Admin: mật khẩu ngẫu nhiên ghi |
23 | T21 | Đăng nhập Admin bằng email + mật khẩu, đổi mật khẩu, đăng xuất thu hồi token |
24 | T22 | Google external login, tạo Học viên ở lần đăng nhập đầu |
25 | T23 | Outbox và BackgroundService: OutboxMessage, thăm dò ~2 giây, SKIP LOCKED |
26 | T24 | Notification: gửi email qua Resend từ Outbox, email chào mừng |
27 | T25 | Web học viên: Đăng nhập bằng Google (OIDC server session) |
28 | T26 | App quản trị: đăng nhập OIDC, sidebar theo vai trò, menu tài khoản, Đổi mật khẩu |
29 | T27 | 🚀 Xác nhận đăng nhập Google và Admin trên staging |
Bài | Story | Tên bài |
|---|---|---|
30 | T28 | Duyệt Instructor: gán role và tạo Hồ sơ Instructor |
31 | T29 | Hồ sơ Instructor: Admin sửa/xóa, Instructor sửa của mình |
32 | T30 | App quản trị: Instructor (danh sách, Duyệt Instructor, sửa/xóa Hồ sơ Instructor) |
33 | T31 | App quản trị: Hồ sơ Instructor của mình |
Bài | Story | Tên bài |
|---|---|---|
34 | T32 | Category: CRUD |
35 | T33 | Khóa học: tạo/sửa ở trạng thái Chưa đăng, kiểm tra sở hữu |
36 | T34 | Bài học: thêm, sửa, xóa, sắp xếp lại |
37 | T35 | Thumbnail khóa học: MinIO, presigned URL |
38 | T36 | Gửi duyệt và Gửi lại: Chưa đăng → Chờ duyệt (khóa học) |
39 | T37 | Duyệt khóa học: Duyệt, Từ chối kèm Lý do từ chối, Admin đăng không cần duyệt |
40 | T38 | LastApprovedVersion (snapshot JSONB) và sửa khóa Đã đăng phải duyệt lại |
41 | T39 | Bài học xem thử: đánh dấu và bỏ đánh dấu |
42 | T40 | Truy vấn công khai: danh sách, lọc Category, sắp xếp, chi tiết (Dapper) |
43 | T41 | Tìm kiếm full-text PostgreSQL, gõ không dấu vẫn khớp |
44 | T42 | App quản trị: Category (CRUD) |
45 | T43 | App quản trị: Khóa học (danh sách, form tạo/sửa, thumbnail, modal sửa khóa Đã đăng) |
46 | T44 | App quản trị: Bài học (thêm/sửa/xóa, kéo thả, Xem thử) |
47 | T45 | App quản trị: Gửi duyệt, badge trạng thái, banner Lý do từ chối, Gửi lại |
48 | T46 | App quản trị: Duyệt khóa học (hàng đợi, Duyệt/Từ chối) |
49 | T47 | Web học viên: Danh sách khóa học (lọc, sắp xếp, tìm kiếm) |
50 | T48 | Web học viên: Chi tiết khóa học (SEO, nhãn Xem thử) |
Bài | Story | Tên bài |
|---|---|---|
51 | T49 | Tải lên Video: chỉ mp4 ≤ 1 GB, kiểm tra magic bytes, trạng thái xử lý |
52 | T50 | Worker ffmpeg: HLS AES-128, giới hạn song song, Sẵn sàng/Lỗi |
53 | T51 | App quản trị: Upload video (tiến độ %, hủy, kiểm tra khi chọn, badge trạng thái) |
Bài | Story | Tên bài |
|---|---|---|
54 | T52 | Enrollment: thực thể, unique (Học viên, Khóa học), truy vấn sở hữu và Khóa học của tôi |
55 | T53 | Coupon: CRUD cho Admin và tính giá |
56 | T54 | Giỏ hàng: thêm, xóa khóa, áp Coupon, chặn khóa đã mua |
57 | T55 | App quản trị: Coupon (CRUD) |
58 | T56 | Web học viên: Giỏ hàng, Coupon, Thêm vào giỏ, Vào học |
Bài | Story | Tên bài |
|---|---|---|
59 | T57 | Checkout idempotent → Đơn Mới (hạn 15 phút), chặn khóa đã mua, rate limit |
60 | T58 | Mã QR VietQR, Nội dung chuyển khoản duy nhất, truy vấn trạng thái Đơn |
61 | T59 | Hook thanh toán: X-API-Token, Đã thanh toán đúng 1 lần, ghi Payment và Outbox cùng transaction |
62 | T60 | Hook: tiền thừa/thiếu → Chênh lệch tiền, Đơn sang Đang chờ |
63 | T61 | Job Hết hạn sau 15 phút và tự Đã hủy sau 1 giờ |
64 | T62 | Hook cho Đơn Hết hạn/Đã hủy: ghi nhận, sang Đang chờ, trả 200 |
65 | T63 | Enrollment từ Outbox (idempotent) và email hoàn thành đơn |
66 | T64 | Xử lý đơn (OrderResolution): Admin chuyển sang Đã thanh toán/Đã hủy, thu hồi Enrollment |
67 | T65 | Lịch sử đơn và danh sách Đơn cho Admin (backend) |
68 | T66 | Integration test race: Đã thanh toán trùng/đồng thời, Enrollment không trùng, crash giữa chừng |
69 | T67 | Web học viên: Checkout và Thanh toán (Mã QR, đếm ngược, polling, các trạng thái) |
70 | T68 | Web học viên: Khóa học của tôi và Lịch sử đơn |
71 | T69 | App quản trị: Đơn (danh sách, chi tiết, Xử lý đơn) |
Bài | Story | Tên bài |
|---|---|---|
72 | T70 | Phát video: token phát, manifest/segment/key qua API, Nginx X-Accel-Redirect |
73 | T71 | Báo lỗi video: Học viên gửi, Admin nhận (backend) |
74 | T72 | Web học viên: Trang học (player HLS, danh sách Bài học, trạng thái, Gửi báo lỗi) |
75 | T73 | App quản trị: Báo lỗi video |
Bài | Story | Tên bài |
|---|---|---|
76 | T74 | Tỷ lệ chia chung (cấu hình) và Tỷ lệ chia riêng (đặt/xóa) |
77 | T75 | Khoản chia: sao chép tỷ lệ vào Đơn và ghi Khoản chia chờ duyệt khi Đã thanh toán |
78 | T76 | Duyệt Khoản chia và tính Số dư |
79 | T77 | Phiếu chi: Admin chọn số tiền, không vượt Số dư |
80 | T78 | Doanh thu: truy vấn dashboard theo Instructor và khoảng thời gian (backend) |
81 | T79 | App quản trị: Doanh thu |
82 | T80 | App quản trị: Tỷ lệ chia riêng trên màn hình Instructor |
83 | T81 | App quản trị: Khoản chia chờ duyệt |
84 | T82 | App quản trị: Phiếu chi (Tạo phiếu chi) |
Bài | Story | Tên bài |
|---|---|---|
85 | T83 | Bộ test phân quyền API: vai trò, IDOR, URL file video |
86 | T84 | 🚀 Bộ E2E và job |
87 | T85 | 🚀 Lighthouse SEO và LCP trên staging |
88 | T86 | 🚀 Load test: danh sách/chi tiết, 500 người dùng đồng thời, video |
89 | T87 | 🚀 Đo Đã thanh toán → Enrollment và cảnh báo Outbox tồn đọng |
90 | T88 | 🚀 Diễn tập khôi phục khi mất VPS |
91 | T89 | 🚀 Thử nghiệm với ≥ 3 Instructor thật |
92 | T90 | 🚀 Kiểm tra hạn mức Resend gói free và cảnh báo |
93 | T91 | 🚀 Go-live production lần đầu |
Một hệ thống xuyên suốt, mỗi phase thêm một lớp, kết thúc ở T91 (go-live production lần đầu):
Sau phase | Đầu ra |
|---|---|
0 | Monorepo, backend khung chạy được, 2 khung frontend, test và log nền |
1 | CI, image trên GHCR, VPS, deploy staging tự động, deploy production có duyệt, backup, giám sát |
2 | Đăng nhập Google (học viên) và email/mật khẩu (Admin) trên staging, Outbox, email chào mừng |
3–4 | Instructor, tạo/duyệt khóa học, danh sách và chi tiết khóa học công khai, tìm kiếm |
5–6 | Upload và xử lý video, Giỏ hàng, Coupon, Enrollment |
7 | Checkout, QR VietQR, hook thanh toán, Enrollment tự động, xử lý đơn |
8 | Học viên xem video, báo lỗi video |
9 | Chia doanh thu cho Instructor, Phiếu chi |
10 | Test phân quyền, E2E, Lighthouse, load test, diễn tập khôi phục, go-live |
Mua cả combo để tiết kiệm hơn so với mua lẻ từng khóa học.