Bài 10. Dự án: API quản lý học tập với Express và MySQL

Một số khái niệm

qlht-api/
├── src/
│   ├── app.js, server.js
│   ├── db.js
│   ├── middlewares/  auth.js, validate.js, error.js
│   ├── modules/
│   │   ├── auth/      auth.routes.js, auth.service.js
│   │   ├── lop/       lop.routes.js, lop.service.js, lop.schema.js
│   │   ├── sinhvien/  sinhvien.routes.js, sinhvien.service.js, sinhvien.schema.js
│   │   └── diem/      ...
│   └── utils/        logger.js, paginate.js
├── test/
├── database/qlsv.sql
├── api.http          # bộ yêu cầu thử API
├── .env.example
└── README.md

Mỗi module có routes (nhận yêu cầu), service (nghiệp vụ, truy vấn CSDL), schema (Zod). Route mỏng, service chứa logic: dễ test và dễ thay CSDL sau này.

Danh sách API

Middleware kiểm tra dữ liệu dùng chung

// src/middlewares/validate.js
import { z } from 'zod';
export const validate = schema => (req, res, next) => {
  const kq = schema.safeParse(req.body);
  if (!kq.success) return res.status(422).json({ loi: 'Dữ liệu không hợp lệ', chi_tiet: z.flattenError(kq.error).fieldErrors });
  req.body = kq.data; next();
};
// routes: r.post('/', canDangNhap, canVaiTro('admin','giangvien'), validate(SinhVienSchema), themSinhVien);

Tiêu chí hoàn thành

• Mọi truy vấn dùng placeholder; mật khẩu bcrypt; JWT có hạn dùng.
• Lỗi trả JSON thống nhất { loi, chi_tiet? } và mã trạng thái đúng.
• Có ít nhất 15 test cho các tuyến chính, chạy bằng npm test.
• README hướng dẫn cài, biến môi trường, tài khoản mẫu; tệp api.http.
• Giao diện (Next.js, Bootstrap hoặc Flutter) gọi được API.
• Triển khai thử lên Render/Railway và ghi lại đường dẫn.