Đây là bài 6 của chương 1: Request, route và controller, thuộc khóa demo Laravel Backend. 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 backend quản lý khóa học, bài học và tiến độ học tập.
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í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: 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.
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 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.
Điều kiện nghiệm thu
- Không trả bản nháp
- Có phân trang
- Không lộ trường nội bộ
Rủi ro cần xử lý
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ị.
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 đề.