Đây là bài 3 trong phần 6 của chuỗi demo “Laravel đáng tin cậy: Từ request đến công việc nền”. Các quyết định về validation, phân quyền, transaction và queue trong ứng dụng quản lý học tập. Bài viết dùng ví dụ và dữ liệu giả để minh họa; hãy thử trên môi trường riêng trước khi áp dụng vào dự án.
Mục tiêu cụ thể
Transaction nhóm các thay đổi cần cùng thành công hoặc cùng thất bại. Ràng buộc unique tại DB giúp chặn bản ghi tiến độ trùng khi request chạy đồng thời.
Tích hợp vào dự án xuyên suốt
Sản phẩm cuối khóa là backend quản lý khóa học, bài học và tiến độ học tập. Ở 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: Lưu hoàn thành bài học với unique(user_id, lesson_id), gửi lại request và kiểm tra chỉ có một hàng. 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 transaction và tiến độ học tập, 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: Lưu hoàn thành bài học với unique(user_id, lesson_id), gửi lại request và kiểm tra chỉ có một hàng.
- 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 không tạo hàng trùng
- Lỗi giữa chừng rollback dữ liệu
- Thời điểm hoàn thành được xác định rõ
Rủi ro cần xử lý
UpdateOrCreate không thay thế unique constraint. Gửi lại request sau timeout có thể tạo tác dụng phụ trùng nếu luồng không idempotent.
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 đề.