Dự án Capstone — Framework E2E cho một sản phẩm thật
Xây một bộ test Playwright + TypeScript production-ready từ đầu đến cuối: kiến trúc, 60+ test nhiều tầng, CI có sharding, báo cáo, và tài liệu đủ để trình bày khi phỏng vấn.
Nhà tuyển dụng vị trí Senior QA/SDET đã xem rất nhiều repo "Playwright framework" gồm một page object và ba test đăng nhập trên trang demo. Thứ họ hiếm khi thấy — và là thứ phân biệt cấp độ senior — là một bộ test thể hiện quyết định có lý do: vì sao test này ở tầng E2E, dữ liệu được cô lập ra sao, flaky được xử lý thế nào, pipeline mất bao lâu và vì sao. Capstone này được thiết kế để tạo ra đúng bằng chứng đó, và cũng là thứ bạn có thể mang về áp dụng ngay cho sản phẩm của công ty.
🎯 Mục tiêu học tập
- Thiết kế và xây một framework E2E hoàn chỉnh cho một ứng dụng có độ phức tạp thật
- Áp dụng đầy đủ: fixture, POM, auth, dữ liệu qua API, mock, song song, CI
- Chứng minh độ ổn định và tốc độ bằng số liệu
- Viết tài liệu và chuẩn bị trình bày các quyết định thiết kế
Chọn ứng dụng mục tiêu
| Lựa chọn | Ưu | Lưu ý |
|---|---|---|
| Sản phẩm của công ty bạn (môi trường staging) | Giá trị thật, vấn đề thật, áp dụng được ngay | Không công khai được code — chuẩn bị một bản trình bày đã ẩn thông tin nhạy cảm |
| Ứng dụng mã nguồn mở tự chạy bằng Docker (một hệ e-commerce, quản lý dự án, hoặc CMS) | Đủ phức tạp; có API; bạn kiểm soát môi trường và dữ liệu; công khai được | Tốn công dựng môi trường — nhưng đó cũng là một phần kỹ năng |
| Ứng dụng bạn tự viết | Toàn quyền thêm test id, endpoint hỗ trợ test | Dễ quá đơn giản; đảm bảo có đủ các yếu tố bên dưới |
Ứng dụng nên có tối thiểu: đăng nhập với ít nhất hai vai trò; một luồng nhiều bước có trạng thái (đặt hàng, phê duyệt); dữ liệu dạng danh sách có lọc/sắp xếp/phân trang; một REST API gọi được; một tích hợp bên ngoài để mock (thanh toán, email); và tải lên hoặc tải xuống file. Tránh các trang demo công khai dùng chung: bạn không kiểm soát được dữ liệu nên không thực hành được phần cô lập.
Yêu cầu bắt buộc
| Hạng mục | Yêu cầu tối thiểu | Module |
|---|---|---|
| Nền móng | TypeScript strict; tsc --noEmit và ESLint (có no-floating-promises và plugin Playwright) chạy trong CI và pre-commit; cấu trúc thư mục rõ ràng; biến môi trường được xác thực | 1, 2 |
| Locator & assertion | ≥ 80% locator hướng người dùng; không sleep; không assertion tức thời; có ít nhất một custom matcher | 3, 4 |
| Fixture | Fixture cho page object, API client, dữ liệu có teardown; ít nhất một fixture worker-scoped và một fixture auto; ghép bằng mergeTests | 5 |
| POM | Page object mỏng cho các trang chính; ít nhất 3 component object dùng lại | 6 |
| Xác thực | Setup project + storageState; ≥ 2 vai trò; đăng nhập qua API; một test hai context; bộ test riêng cho trang đăng nhập | 7 |
| Dữ liệu | Mọi test tự tạo dữ liệu qua API với định danh duy nhất; có dọn dẹp; không phụ thuộc dữ liệu có sẵn | 8 |
| Network | Test cho ≥ 4 trạng thái lỗi/biên bằng mock; mock một bên thứ ba; ≥ 15 API test trong project riêng | 9 |
| Cấu hình | fullyParallel; projects cho setup, api, chromium, một trình duyệt khác và di động (tập gắn tag); tag và ba tầng chạy | 10 |
| Độ ổn định | Toàn bộ pass 10 lần liên tiếp với --workers=4, retry tắt; có chính sách flaky thành văn | 11 |
| Phi chức năng | ≥ 6 visual test (baseline trong Docker); ARIA snapshot; quét axe trên ≥ 4 trang; ≥ 2 test bàn phím; một test tải lên và một test tải xuống | 12 |
| CI | Workflow có sharding, gộp báo cáo, lưu artifact; PR nhận phản hồi dưới 10 phút; thông báo khi fail | 13 |
| Quy ước | CONTRIBUTING.md; checklist review; mọi skip có lý do | 14 |
Quy mô gợi ý: 60-100 test, trong đó khoảng 15-25 API test, 35-60 E2E, 6-10 visual, và một tập smoke 8-12 test chạy dưới 2 phút. Chất lượng quan trọng hơn số lượng — 60 test được thiết kế kỹ thuyết phục hơn 300 test sinh hàng loạt.
Tuỳ chọn nâng cao (chọn 1-2): môi trường tạm thời cho mỗi lần chạy bằng Docker Compose; reporter tuỳ biến đẩy số liệu lên dashboard; contract test bằng schema dùng chung; job phát hiện flaky tự động từ lịch sử chạy; test hiệu năng cơ bản (đo Web Vitals qua Playwright); file hướng dẫn cho trợ lý AI kèm đánh giá chất lượng test nó sinh ra.
Lộ trình 5 tuần
| Tuần | Việc | Sản phẩm |
|---|---|---|
| 1 | Dựng môi trường ứng dụng; khởi tạo dự án, lint, CI tối thiểu (lint + 1 test). Viết kế hoạch test một trang: các hành trình quan trọng, cái gì ở tầng nào, rủi ro chính. Viết lớp API client và factory | Repo chạy được trên CI + kế hoạch test |
| 2 | Xác thực (setup project, vai trò). Fixture nền tảng. Page object cho 3-4 trang chính. 15 E2E đầu tiên cho hành trình sống còn + 15 API test | Tập smoke xanh, chạy song song |
| 3 | Mở rộng E2E; test trạng thái lỗi/biên bằng mock; component object; tài khoản theo worker; bật fullyParallel và sửa mọi xung đột | 45+ test, pass ổn định khi song song |
| 4 | Visual, ARIA snapshot, accessibility, di động, file. Sharding và gộp báo cáo. Chạy lặp để săn flaky và sửa tận gốc | Pipeline đầy đủ dưới 10 phút; 10 lần chạy xanh liên tiếp |
| 5 | Hạng mục nâng cao. Tài liệu. Số liệu. Quay video demo. Tự review theo checklist Module 14 và sửa | Repo hoàn chỉnh, sẵn sàng trình bày |
Đưa pipeline lên ngay tuần 1, khi mới có một test. Mọi vấn đề về môi trường, song song, dữ liệu sẽ lộ ra sớm và từng cái một — thay vì dồn lại thành một đống khi bạn đưa 80 test lên CI lần đầu ở tuần 4.
Số liệu cần có
Một dự án senior được trình bày bằng số liệu, không bằng tính từ. Thu thập và đưa vào README:
| Số liệu | Cách đo |
|---|---|
| Số test theo tầng (API / E2E / visual / smoke) | npx playwright test --list theo project và tag |
| Thời gian chạy: cục bộ, CI một máy, CI có sharding | Log pipeline; nêu rõ số worker và shard |
| Thời gian tuần tự so với song song | Chạy với --workers=1 và cấu hình thật |
| Độ ổn định: tỉ lệ pass qua N lần chạy liên tiếp, retry tắt | Job lặp trên CI |
| Tác động của các tối ưu chính | Trước/sau: đăng nhập qua UI → storageState → API; chuẩn bị dữ liệu qua UI → API |
| Phân bố locator theo mức ưu tiên | Script đếm hoặc thống kê thủ công |
| Lỗi thật bộ test tìm được trong ứng dụng | Danh sách kèm trace — bằng chứng giá trị mạnh nhất |
| Vi phạm accessibility: hiện trạng và sau khi sửa (nếu sửa được) | Kết quả axe |
Tài liệu và trình bày
Repo nên có:
- README: ứng dụng được test, cách chạy bằng một lệnh, sơ đồ kiến trúc bộ test, bảng số liệu chính, ảnh báo cáo HTML và một trace.
- docs/STRATEGY.md: kế hoạch test — hành trình nào được phủ, cái gì cố ý không test ở tầng E2E và vì sao.
- docs/ARCHITECTURE.md: các quyết định thiết kế theo mẫu "bối cảnh → phương án cân nhắc → lựa chọn → đánh đổi": cấu trúc fixture, chiến lược dữ liệu, chiến lược xác thực, cái gì mock.
- CONTRIBUTING.md: quy ước và checklist review.
- docs/FLAKY.md: nhật ký các flaky đã gặp — triệu chứng, nguyên nhân gốc, cách sửa. Tài liệu này thể hiện kỹ năng chẩn đoán rõ hơn bất kỳ thứ gì khác.
Câu hỏi phỏng vấn nên chuẩn bị, mỗi câu kèm một ví dụ cụ thể từ dự án:
- Vì sao chọn Playwright? Nó khác gì công cụ bạn dùng trước đây ở mức kiến trúc?
- Bạn quyết định một kiểm tra nằm ở tầng E2E hay API bằng cách nào? Cho ví dụ một test bạn đã chuyển tầng.
- Các test của bạn chạy song song an toàn nhờ đâu? Điều gì xảy ra nếu hai worker cùng đặt một đơn hàng?
- Kể về flaky test khó nhất bạn đã sửa: triệu chứng, cách tìm nguyên nhân, cách sửa.
- Fixture giải quyết vấn đề gì mà
beforeEachvà lớp base không giải quyết được? - Pipeline mất bao lâu? Nếu bộ test lớn gấp 10 lần, bạn làm gì để giữ thời gian phản hồi?
- Bạn mock những gì, không mock những gì, và làm sao để mock không lệch khỏi API thật?
- Nếu một lập trình viên nói "E2E toàn flaky, bỏ đi", bạn trả lời thế nào — bằng số liệu?
Khoá Career Positioning & Job Search hướng dẫn cách đưa capstone vào CV và kể thành câu chuyện phỏng vấn; khoá Advanced QA & Test Engineering bổ sung phần chiến lược (contract test, mutation test, chỉ số chất lượng) để hoàn thiện hồ sơ Senior QA/SDET.
🏋️ Bài tập thực hành
Hoàn thành dự án theo yêu cầu bắt buộc. Trước khi coi là xong, tự kiểm tra bằng bốn phép thử: (1) một người lạ clone repo, làm theo README, và chạy được toàn bộ bộ test trong dưới 15 phút; (2) pipeline xanh 10 lần liên tiếp với retry tắt; (3) nhờ một đồng nghiệp review 5 file test bất kỳ bằng checklist Module 14 và sửa mọi điểm họ nêu; (4) bạn trả lời được tám câu hỏi phỏng vấn ở trên, mỗi câu trỏ tới một đoạn code hoặc một con số cụ thể trong repo.
📚 Tài nguyên học tập
-
Playwright — Best PracticesĐối chiếu lần cuối trước khi nộpDocs
-
Playwright — Release notesTheo dõi tính năng mới để giữ dự án cập nhậtDocs
-
Playwright — GitHub repositoryMã nguồn, issue, và bộ test của chính Playwright — nguồn ví dụ thực tế rất tốtRepo
-
Awesome PlaywrightDanh sách công cụ, tích hợp và dự án mẫu trong hệ sinh tháiRepo
✅ Tự đánh giá hoàn thành
- Đáp ứng đủ mười hai hạng mục yêu cầu bắt buộc
- Pipeline xanh 10 lần liên tiếp với retry tắt, phản hồi PR dưới 10 phút
- README có bảng số liệu; có STRATEGY, ARCHITECTURE, CONTRIBUTING và nhật ký flaky
- Người lạ chạy được bộ test chỉ bằng README
- Trả lời được tám câu hỏi phỏng vấn bằng ví dụ cụ thể từ dự án