# 里程碑验收标准

## M1 需求分析验收

### 量化检查项

- [ ] spec.md 每个功能模块有独立章节
- [ ] use-cases.md 覆盖 charter.md 中每个功能点（61个）
- [ ] constraints.md 包含所有技术约束和业务约束
- [ ] "给下游团队的关键信息"完整

### 交付产物

| 文件 | 说明 |
|------|------|
| spec.md | 需求规格文档 |
| use-cases.md | 用例文档 |
| constraints.md | 约束条件 |
| DELIVERY-MANIFEST.md | 交付清单 |

### 覆盖度要求

- 模块数覆盖：≥ 10/10
- 功能点覆盖：≥ 61/61

---

## M2 架构设计验收

### 量化检查项

- [ ] api-definition.md 接口数 ≥ spec.md 功能点数
- [ ] DDL 每张表有字段注释
- [ ] 设计文档包含系统架构图、数据流图
- [ ] "给下游团队的关键信息"完整

### 交付产物

| 文件 | 说明 |
|------|------|
| design.md | 架构设计文档 |
| api-definition.md | 接口定义 |
| tech-stack.md | 技术选型说明 |
| DELIVERY-MANIFEST.md | 交付清单 |

### 覆盖度要求

- API 接口覆盖：≥ 61 个接口
- 数据库表覆盖：≥ 15 张表

---

## M3 编码实现验收

### 量化检查项

- [ ] DELIVERY-MANIFEST.md 中注明编译自检结果
- [ ] 业务领导复核 `mvn compile` 零错误
- [ ] 每个 Controller 方法对应 api-definition.md 中一个接口
- [ ] 风险导向分层代码抽查通过
- [ ] MyBatis XML 无 `${}` 注入风险

### 交付产物

| 文件 | 说明 |
|------|------|
| 代码文件 | src/main/java/ 下的业务代码 |
| MyBatis XML | src/main/resources/mapper/ 下的映射文件 |
| DELIVERY-MANIFEST.md | 交付清单（含修改文件清单） |

### 代码质量要求

- Controller 类：无硬编码密钥，用户输入有校验
- Service 类：异常处理合理，关键路径有日志
- MyBatis XML：全部使用 `#{}` 参数化
- 文件行数：≤ 500 行/文件

---

## M4 测试验收

### 量化检查项

- [ ] 测试用例数 ≥ use-cases.md 用例数
- [ ] 自动化测试 `mvn test` 通过
- [ ] Bug 清单含复现步骤+严重等级
- [ ] 测试覆盖业务领导指定的重点场景
- [ ] 核心接口测试覆盖率 ≥ 80%

### 交付产物

| 文件 | 说明 |
|------|------|
| test-cases.md | 测试用例 |
| test-report.md | 测试报告 |
| bug-list.md | Bug 清单 |
| DELIVERY-MANIFEST.md | 交付清单 |
| src/test/java/ | 自动化测试代码 |

### 测试质量要求

- 通过率：`mvn test` 全部通过
- 独立性：每个测试方法独立运行
- 可重复：同一测试多次运行结果一致
- 不修改源代码：测试代码不得修改 src/main/java/
- JUnit 4 风格：使用 `@Test` 注解

---

## 阶段零验收

### 环境就绪检查

| 序号 | 检查项 | 状态 |
|------|--------|------|
| 1 | `mvn compile` 零错误 | ✓ |
| 2 | 数据库连接正常，全量表结构创建完成 | □ |
| 3 | OSS Bucket 可访问 | □ |
| 4 | 短信 SDK 可调用 | □ |
| 5 | Redis 连接正常 | □ |
| 6 | 微信小程序开发者账号就绪 | □ |
| 7 | Git 仓库可 push/pull | ✓ |
| 8 | `mvn spring-boot:run` 启动无报错 | □ |

### 文档就绪检查

| 序号 | 检查项 | 状态 |
|------|--------|------|
| 1 | docs/charter.md 已创建 | ✓ |
| 2 | docs/acceptance-criteria.md 已创建 | ✓ |
| 3 | docs/project-log.md 已创建 | □ |
| 4 | docs/environment-checklist.md 已创建 | □ |