# 开发复核清单 ## 一、表结构设计(编码前) ```markdown ## 表结构复核 - [ ] 字段类型与长度能满足业务上限(名称、备注、单号) - [ ] 金额字段用 DECIMAL,不用 FLOAT/DOUBLE - [ ] 状态字段有注释说明每个枚举值含义 - [ ] 必填字段设置 NOT NULL,并给默认值或明确由程序保证 - [ ] 索引有明确依据(对应哪个查询场景),不是每个字段都建 - [ ] 联合索引顺序符合最左前缀原则 - [ ] 字符集 utf8mb4,排序规则与现有库一致 - [ ] 与现有表的字段命名、时间字段、逻辑删除标记保持一致 - [ ] 预留扩展字段(如快照、来源、渠道)已评估是否需要 ``` ## 二、代码交付前 ```markdown ## 代码复核 - [ ] 编译通过 - [ ] 无硬编码(连接串、密钥、绝对路径、魔法值) - [ ] 空值与边界已处理(null、空集合、0、负数、超长、时间倒挂) - [ ] 事务边界明确,外部调用不在事务内 - [ ] SQL 走索引(EXPLAIN 确认) - [ ] 无 N+1 查询 - [ ] 日志不打印敏感信息 - [ ] 异常未被吞掉 - [ ] 四类高危逻辑已标 TODO,等待人工 - [ ] 命名与现有代码风格一致 - [ ] 每段代码我能讲清为什么这么写 ``` ## 三、四类高危逻辑清单 | 类别 | 典型场景 | 规范要求 | |---|---|---| | 金额 | 单价×数量、折扣、税额、舍入、分摊 | 只留签名与调用点,计算口径由人确认后实现 | | 权限 | 数据行级权限、功能按钮权限、越权校验 | 只调权限组件,不自己写判断 | | 状态机 | 工单流转、审批状态、订单状态 | 只画状态与转换条件,实现交人工 | | 对账 | 账单核对、核销、冲正 | 只设计表结构,比对逻辑人工实现 | ## 四、必须重写而不是修补的信号 | 信号 | 说明 | |---|---| | 出现不认识的写法或注解 | 说明看不懂,出问题无法排查 | | 能跑但说不清边界为什么这样处理 | 边界条件没想清楚 | | 修改 bug 靠层层 try-catch | 根因没找到 | | 单方法超过 80 行、嵌套超过 3 层 | 结构已失控 | | 为了绕过编译错误改了依赖版本 | 埋雷 | ## 五、留痕 - 提交信息注明 AI 参与度:`feat: 请假申请提交 #RD-123 [AI:L2]` - 核心逻辑(四类高危除外)由 AI 生成且人工逐行复核过的,在 PR 描述里注明复核范围 - 不删 AI 原始输出,便于回溯