Request, route và controller — Thực hành và checklist bàn giao

Đây là bài 3 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ộ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ụ.

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

• Xác định đầu vào, đầu ra và trạng thái trước khi bắt đầu. Với request, route và controller, 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ế 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.
• 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.

• Không trả bản nháp
• Có phân trang
• Không lộ trường nội bộ

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

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

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 đề.