复核清单.md 2.4 KB

开发复核清单

一、表结构设计(编码前)

## 表结构复核
- [ ] 字段类型与长度能满足业务上限(名称、备注、单号)
- [ ] 金额字段用 DECIMAL,不用 FLOAT/DOUBLE
- [ ] 状态字段有注释说明每个枚举值含义
- [ ] 必填字段设置 NOT NULL,并给默认值或明确由程序保证
- [ ] 索引有明确依据(对应哪个查询场景),不是每个字段都建
- [ ] 联合索引顺序符合最左前缀原则
- [ ] 字符集 utf8mb4,排序规则与现有库一致
- [ ] 与现有表的字段命名、时间字段、逻辑删除标记保持一致
- [ ] 预留扩展字段(如快照、来源、渠道)已评估是否需要

二、代码交付前

## 代码复核
- [ ] 编译通过
- [ ] 无硬编码(连接串、密钥、绝对路径、魔法值)
- [ ] 空值与边界已处理(null、空集合、0、负数、超长、时间倒挂)
- [ ] 事务边界明确,外部调用不在事务内
- [ ] SQL 走索引(EXPLAIN 确认)
- [ ] 无 N+1 查询
- [ ] 日志不打印敏感信息
- [ ] 异常未被吞掉
- [ ] 四类高危逻辑已标 TODO,等待人工
- [ ] 命名与现有代码风格一致
- [ ] 每段代码我能讲清为什么这么写

三、四类高危逻辑清单

类别 典型场景 规范要求
金额 单价×数量、折扣、税额、舍入、分摊 只留签名与调用点,计算口径由人确认后实现
权限 数据行级权限、功能按钮权限、越权校验 只调权限组件,不自己写判断
状态机 工单流转、审批状态、订单状态 只画状态与转换条件,实现交人工
对账 账单核对、核销、冲正 只设计表结构,比对逻辑人工实现

四、必须重写而不是修补的信号

信号 说明
出现不认识的写法或注解 说明看不懂,出问题无法排查
能跑但说不清边界为什么这样处理 边界条件没想清楚
修改 bug 靠层层 try-catch 根因没找到
单方法超过 80 行、嵌套超过 3 层 结构已失控
为了绕过编译错误改了依赖版本 埋雷

五、留痕

  • 提交信息注明 AI 参与度:feat: 请假申请提交 #RD-123 [AI:L2]
  • 核心逻辑(四类高危除外)由 AI 生成且人工逐行复核过的,在 PR 描述里注明复核范围
  • 不删 AI 原始输出,便于回溯