综合练习

这一课你将能做到

1. 交付一个模块化的刷题平台 API：题库 CRUD、条件筛选、作答判分、成绩统计，校验、鉴权、异常、配置、测试齐备
2. 用结业清单逐项自检，确认本轨道 12 节课的能力闭环
3. 用自己的话写出 NestJS vs Express vs Spring Boot 的选型结论

为什么要学

前面每节课只教一个零件：Module、Controller、Service、Pipe、Guard、Config、异常、测试。本课要求你组装。

判断是否真学会一个框架，从来不是「看得懂示例」，而是能否从零搭出结构正确的项目，并处理好失败路径——非法输入 400、未登录 401、权限不足 403、资源不存在 404。本课做完，你应该能向同事演示一个接口契约稳定、测试可红可绿的完整后端。

刻意延续「做题平台」场景：同一套业务，本站 Java 侧用 Spring Boot 实现过，Node 侧你用 Nest 再实现一遍。对比之下你会真正理解——框架换的是骨架，业务本身从没变。

先建立图像

目标接口契约：

方法与路径	访问规则	成功状态
GET /api/health	公开	200
GET /api/questions	公开，支持 difficulty/tag/page	200
GET /api/questions/:id	公开	200 / 404
POST /api/questions	管理员	201 / 400 / 403
PATCH /api/questions/:id	管理员	200 / 404
DELETE /api/questions/:id	管理员	204 / 404
POST /api/submissions	登录学生	201 / 400 / 401
GET /api/submissions/me	登录学生	200
GET /api/submissions/me/stats	登录学生	200

选型对照表：

场景	更合适的选择
脚本、极简原型、轻量 webhook	Express
TS 团队中型 API、BFF 聚合层	NestJS
本站企业级主 API、复杂事务与生态	Spring Boot
全栈页面加极简服务端逻辑	Next.js Route Handler

跟着做

步骤 1：冻结需求与目录结构

沿用本轨道的 quiz-api，最终目录应近似：

src/
  main.ts
  app.module.ts
  config/
    jwt.config.ts
  common/
    filters/all-exceptions.filter.ts
    exceptions/business.exception.ts
  auth/
    auth.module.ts
    auth.controller.ts
    auth.service.ts
    guards/jwt-auth.guard.ts
    guards/roles.guard.ts
    decorators/  (public / roles / current-user)
  questions/
    questions.module.ts
    questions.controller.ts
    questions.service.ts
    dto/  (create / update)
  submissions/
    submissions.module.ts
    submissions.controller.ts
    submissions.service.ts
    dto/submit-answer.dto.ts
  health/health.controller.ts
test/
  app.e2e-spec.ts