开发复核清单
一、表结构设计(编码前)
## 表结构复核
- [ ] 字段类型与长度能满足业务上限(名称、备注、单号)
- [ ] 金额字段用 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 原始输出,便于回溯