按代码规范检查整改实体注释、Service Javadoc 与分层边界
公司代码规范检查的问题③⑤⑦⑧⑨⑩:
- 问题③:实体与展示对象补齐全部字段注释,状态/类型字段标注枚举
全部取值(测试状态、接收状态、通道工作状态、认领状态、字段类型、
适配器类型、来源类别等);record 类型改用 @param 说明各组件。
- 问题⑤:Service 公共方法与核心状态流转方法补齐 Javadoc 四要素,
接收落库、接收状态流转、异常判定等核心路径按 `// STEP n` 分步注释。
- 问题⑦:测试预警异常的归属校验与关闭规则从 Controller 下沉到
TestWarningExceptionService,Controller 只保留参数接收与一行调用。
- 问题⑧:SSE 推送线程池与两个模拟器线程池改为显式
ThreadPoolExecutor / ScheduledThreadPoolExecutor,自定义 ThreadFactory
命名(sse-live-pool-%d、bts-simulator-pool-%d)。
- 问题⑨:TodoService.handle 重命名为 completeTodo,同步 Controller
与测试;HTTP 路径不变,前端无需改动。
- 问题⑩:落地表查询改显式列名;三类数据表的动态表名查询与平台原生
SELECT *、System.out 登记为不改动基线。
验证:mvn test 273 个用例、0 个错误;1 个既有失败为
FlywayMigrationContractTest 的 V2 哈希常量过期,该迁移文件未被本次修改
触及,与本提交无关。前端未改动。