Files
lpt-be/.agents/roles/api-response.md
T
cat-shark 27ddf8be5a docs: 规则与技能迁入 .agents/,并接入决策笔记
- roles/ 与 skills/ 迁移到 .agents/ 下,AGENTS.md 引用同步
- 收录 8 篇决策笔记到 .agents/notes/
- .rgignore 排除 archived 历史快照
2026-11-18 15:01:05 +08:00

1.1 KiB
Raw Blame History

响应规范与 DTO 转换

  • 功能:统一 API 的响应形态、错误文案风格与 DTO 转换方式。
  • 何时用:新增或修改接口返回值、处理异常、增删 DTO 字段或自定义映射时。

响应规范

  • 成功:CommonResult.success(data),code=200。
  • 业务错误:CommonResult.error(msg),code=400,HTTP 200。
  • 未登录:GlobalExceptionHandler.handleNotLogin(),HTTP 401 + code=401。
  • 参数校验失败:MethodArgumentNotValidException,code=400。
  • 用户可见错误文案必须口语化、可理解,避免“无法生成”“不存在”等技术化表述;技术细节写入日志。例如无学习报告时应提示“这个任务还没开始学习哦,学习后产生学习报告后再来吧”,而不是“没有学习报告,无法生成思维导图”。

DTO 转换

  • MapStruct 编译期生成 *ConvertImpl.java,同名属性自动映射。
  • 默认 unmappedTargetPolicy = IGNORE。
  • 自定义映射使用 @Mapping(source, target)。
  • 增删 DTO 字段后必须重新编译,否则生成代码不含新字段。