4.14

今日Controller开发小结： 在采购和返厂模块搭建了核心控制器：采购枢纽：通过/demand接收采购需求、/inventory实时查库存、/tracking/{id}追踪物流，形成采购最小闭环返厂全流程：从创建记录到维修确认共5个接口，其中/confirm/{returnId}预留维修报告接收逻辑，支持状态流转。踩坑实录：编译报错发现@NotNull依赖缺失 → 紧急补全Jakarta Validation依赖Optional类型报错暴露新人盲点 → 显式补全import语句并更新团队编码规范。现状与规划： 骨架阶段：Controller仅调用Service占位方法，异常处理未覆盖业务场景（如重复确认拦截） 三步迭代：① 优先实现返厂状态机服务逻辑② 增强参数校验+业务规则拦截③ 用SpringDoc生成API文档，同步推进前后端开发。反思："先定义接口"模式导致开发断层，下阶段拟用OpenAPI契约测试，实现前后端并行开发。