Đây là bài 6 của chương 3: API và idempotency, thuộc khóa demo System Design. Nội dung được dùng để trải nghiệm cấu trúc chương trình học; hãy thực hành trên dữ liệu và môi trường thử nghiệm riêng. Trong dự án xuyên suốt, bạn sẽ xây dựng bản thiết kế nền tảng học trực tuyến với danh mục, video, tiến độ và thông báo.
Mục tiêu cụ thể
API cần hợp đồng đầu vào, đầu ra và lỗi. Idempotency giúp client gửi lại thao tác mà không gây tác dụng phụ trùng trong điều kiện đã xác định.
Tích hợp vào dự án xuyên suốt
Sản phẩm cuối khóa là bản thiết kế nền tảng học trực tuyến với danh mục, video, tiến độ và thông báo. Ở chương này, bạn cần bàn giao một phần có thể giải thích và kiểm tra độc lập: Thiết kế hợp đồng đăng ký khóa học có thể retry sau timeout; mô tả trường hợp hai request đến cùng lúc. Hãy nêu rõ phần mới phụ thuộc vào kết quả nào của chương trước và phần nào có thể làm riêng.
Kế hoạch thực hiện
- Xác định đầu vào, đầu ra và trạng thái trước khi bắt đầu. Với api và idempotency, hãy ghi lại kết quả bạn mong muốn trước khi chạy ví dụ.
- Tạo bản thử nhỏ nhất trong một thư mục hoặc môi trường riêng. Chỉ dùng dữ liệu giả; không sao chép token, tài khoản hoặc dữ liệu cá nhân vào bài tập.
- Thực hiện yêu cầu: Thiết kế hợp đồng đăng ký khóa học có thể retry sau timeout; mô tả trường hợp hai request đến cùng lúc.
- Quan sát kết quả và so sánh từng điều kiện chấp nhận. Khi chưa đạt, thay đổi một yếu tố mỗi lần để biết thay đổi nào tạo ra tác động.
- Lưu kết quả cùng ghi chú giải thích quyết định. Người khác cần tái hiện được thao tác mà không phải đoán cấu hình hoặc dữ liệu ban đầu.
Điều kiện nghiệm thu
- Request lặp có kết quả nhất quán
- Payload khác không dùng chung khóa
- Có chính sách lưu và hết hạn khóa
Rủi ro cần xử lý
Chỉ thêm header không tự tạo idempotency. Cần lưu trạng thái, xử lý request đồng thời và chính sách hết hạn.
Yêu cầu bàn giao
- Một phiên bản chạy được hoặc tài liệu thiết kế đủ để kiểm chứng.
- Mô tả đầu vào, đầu ra và cách bắt đầu thử.
- Ít nhất ba ca thử gắn với tiêu chí chương.
- Một ca lỗi được tái hiện và cách xử lý.
- Ghi chú giới hạn: điều gì chưa làm, vì sao và bước tiếp theo.
Bài dự án có thể cần nhiều thời gian thực hành hơn thời gian đọc hiển thị. Bạn tự chọn mức độ mở rộng theo mục tiêu; không cần đưa nội dung lên hệ thống production để hoàn thành bài. Khi review, tập trung vào hành vi quan sát được và tính rõ ràng của giải thích thay vì số dòng mã.
Liên hệ chương tiếp theo
Giữ lại phiên bản đã đạt tiêu chí trước khi thêm yêu cầu mới. Nếu thay đổi tiếp theo làm sai hành vi cũ, dùng các ca thử đã ghi để phát hiện và khoanh vùng thay đổi gây ra vấn đề.