Đây là bài 2 trong phần 1 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ể
Một request đi qua middleware, route và controller trước khi tạo response. Controller nên điều phối thay vì chứa toàn bộ quy tắc nghiệp vụ.
Tình huống lỗi
Trả toàn bộ model có thể lộ trường không dành cho client. Sử dụng resource hoặc cấu hình trường được phép hiển thị.
Chẩn đoán có bằng chứng
Trong bài request, route và controller, hãy cố ý tái hiện tình huống trên ở môi trường thử nghiệm. Mục tiêu là thấy vì sao kết quả sai và thu thập đủ bằng chứng để phân biệt lỗi dữ liệu, lỗi quy tắc và lỗi cấu hình. Không sửa đồng thời nhiều yếu tố vì bạn sẽ khó xác định nguyên nhân.
- Ghi rõ bước thao tác và kết quả mong đợi.
- Thu nhỏ ví dụ đến mức vẫn tái hiện được lỗi.
- Đối chiếu dữ liệu thực với giả định ban đầu.
- Đặt giả thuyết và thay đổi một yếu tố.
- Xác nhận bằng cách tái chạy ví dụ tối thiểu.
Mẫu đối chiếu
Route::get("/courses", [CourseController::class, "index"]);
public function index()
{
return Course::query()->where("status", "published")->paginate(12);
}Kiểm tra sau sửa
- Không trả bản nháp
- Có phân trang
- Không lộ trường nội bộ
Khi lỗi biến mất, thực hiện lại yêu cầu gốc: Thiết kế endpoint liệt kê khóa học đã xuất bản với phân trang và cấu trúc response nhất quán. Sau đó thử trường hợp đầu vào rỗng hoặc trạng thái chưa được khởi tạo nếu phù hợp. Một bản sửa phải khôi phục hành vi đã định nghĩa, không chỉ làm mất thông báo lỗi.
Ghi chú bàn giao
Viết báo cáo ngắn gồm nguyên nhân, phạm vi ảnh hưởng, thay đổi và cách kiểm chứng. Nếu chưa xác định được nguyên nhân, ghi rõ điều còn chưa biết và phép kiểm tra tiếp theo, không biến giả thuyết thành kết luận.