Video Cơ bản

Xây dựng website học trực tuyến với ASP.NET Core - 2026

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

1 học viên 1,851 lượt xem
Bạch Ngọc Toàn
Giảng viên Bạch Ngọc Toàn

Nội dung khóa học

12 chương • 14 video • 3 giờ học

Mô tả khóa học

Giới thiệu

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.

Đối tượng và yêu cầu đầu vào

  • 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.

Kết quả đầu ra

  1. 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.

  2. Dùng Clean Architecture + CQRS ngay từ story đầu tiên (Mediator, EF Core phía ghi, Dapper phía đọc).

  3. 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).

  4. 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.

  5. 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.

  6. Triển khai bằng Docker, GitHub Actions, Nginx 3 subdomain, TLS, backup/restore, giám sát; có staging và production, rollback.

  7. Viết unit test, integration test (Testcontainers), test phân quyền, E2E, đo Lighthouse và load test trước khi go-live.

Dự án thực hành — TEDU Market

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 ui, API client, 2 khung frontend

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

Quyết định kiến trúc áp dụng xuyên suốt

  1. Query side tách khỏi Entity ghi. Ghi: EF Core + Aggregate. Đọc: Dapper raw SQL chiếu thẳng ra DTO.

  2. 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.

  3. OpenIddict chạy chung trong API project, không tách Authorization Server thành service riêng.

  4. 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).

  5. Outbox + BackgroundService (thăm dò ~2 giây, FOR UPDATE SKIP LOCKED), không dùng Hangfire.

  6. 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.

  7. Video: mp4 ≤ 1 GB, HLS AES-128 bằng ffmpeg, phát qua API và Nginx X-Accel-Redirect.

Phase 0 — Nền tảng code

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 /api/v1, Mediator, OpenAPI, ProblemDetails

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 ui: Tailwind v4, shadcn/ui, design tokens, component pattern

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

Phase 1 — Hạ tầng và CI/CD

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, .env.example, secrets, project tedu-stg và tedu-prod

17

T15

Job deploy-stg, bundle migration và smoke test staging

18

T16

Job deploy-prod có người duyệt và script rollback

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

Phase 2 — Identity

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 secret.json

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

Phase 3 — Instructor

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

Phase 4 — Course và catalog

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ử)

Phase 5 — Video: tải lên và xử lý

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)

Phase 6 — Cart, Coupon và Enrollment nền

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

Phase 7 — Order và Payment

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)

Phase 8 — Học và phát video

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

Phase 9 — Doanh thu Instructor

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)

Phase 10 — Chất lượng và go-live (🚀 cần staging)

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 e2e trong CI

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

Dự án thực hành

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

Giảng viên

Combo có khóa học này

Mua cả combo để tiết kiệm hơn so với mua lẻ từng khóa học.

Lộ trình có khóa học này

Khóa học liên quan

Zalo