一致性校验清单
跨文档对齐的半自动校验清单
1. 需求追溯
1.1 覆盖检查
| 检查编号 |
描述 |
状态 |
详情 |
| RT-001 |
所有功能需求都有模块分配 |
⬜ |
|
| RT-002 |
所有非功能需求在规范中已处理 |
⬜ |
|
| RT-003 |
无孤立需求（未分配） |
⬜ |
|
| RT-004 |
无孤立功能（无需求引用） |
⬜ |
|
1.2 可追溯矩阵
需求 → 模块 → 设计 → 规范
验证步骤：
- 列出 requirements-spec.md 中的所有 FR-* 编号
- 检查每个 FR 至少出现在一个模块的需求映射中
- 验证每个模块设计引用其覆盖的需求
- 确认规范处理了所有非功能需求
2. API 一致性
2.1 端点覆盖
| 检查编号 |
描述 |
状态 |
详情 |
| API-001 |
所有模块端点出现在后端规范中 |
⬜ |
|
| API-002 |
请求/响应 Schema 与模块设计匹配 |
⬜ |
|
| API-003 |
错误码在各模块间一致 |
⬜ |
|
| API-004 |
认证要求一致 |
⬜ |
|
2.2 Schema 对齐
交叉检查：
- 模块设计 API 契约 ↔ 后端规范 API 标准
- 字段名称和类型匹配
- 校验规则一致
- 错误响应格式匹配规范
2.3 API 端点矩阵
| 模块 |
端点 |
在后端规范中 |
Schema 匹配 |
| MOD-001 |
|
⬜ |
⬜ |
| MOD-002 |
|
⬜ |
⬜ |
3. 数据模型一致性
3.1 实体对齐
| 检查编号 |
描述 |
状态 |
详情 |
| DM-001 |
模块设计中的所有实体出现在数据库规范中 |
⬜ |
|
| DM-002 |
设计与数据库规范间的字段类型匹配 |
⬜ |
|
| DM-003 |
关系定义一致 |
⬜ |
|
| DM-004 |
校验规则匹配（模块设计 ↔ 数据库约束） |
⬜ |
|
3.2 实体交叉引用
| 实体 |
模块设计 |
数据库规范 |
匹配 |
| 用户 |
MOD-001 |
users 表 |
⬜ |
| 订单 |
MOD-002 |
orders 表 |
⬜ |
3.3 字段校验对齐
对于每个实体，验证：
- 必填/可选状态匹配
- 数据类型兼容
- 约束等效
- 默认值一致
4. UI/UX 对齐
4.1 组件覆盖
| 检查编号 |
描述 |
状态 |
详情 |
| UI-001 |
模块设计中的所有 UI 组件存在于 UI 规范中 |
⬜ |
|
| UI-002 |
设计令牌使用一致 |
⬜ |
|
| UI-003 |
无障碍要求已满足 |
⬜ |
|
| UI-004 |
响应式要求已处理 |
⬜ |
|
4.2 屏幕/组件矩阵
| 屏幕 |
模块 |
UI 规范引用 |
无障碍 |
| 登录 |
MOD-AUTH |
表单部分 |
⬜ |
| 仪表盘 |
MOD-001 |
仪表盘布局 |
⬜ |
5. 架构对齐
5.1 组件一致性
| 检查编号 |
描述 |
状态 |
详情 |
| ARCH-001 |
模块组件与架构规范匹配 |
⬜ |
|
| ARCH-002 |
集成模式一致 |
⬜ |
|
| ARCH-003 |
安全架构已实现 |
⬜ |
|
| ARCH-004 |
性能目标可实现 |
⬜ |
|
5.2 技术栈验证
| 层级 |
架构规范 |
模块实现 |
匹配 |
| 前端 |
|
|
⬜ |
| 后端 |
|
|
⬜ |
| 数据库 |
|
|
⬜ |
6. 安全对齐
6.1 安全需求覆盖
| 检查编号 |
描述 |
状态 |
详情 |
| SEC-001 |
认证方法在文档间匹配 |
⬜ |
|
| SEC-002 |
授权规则一致 |
⬜ |
|
| SEC-003 |
数据保护需求已实现 |
⬜ |
|
| SEC-004 |
审计日志已指定 |
⬜ |
|
6.2 权限矩阵对齐
| 角色 |
需求规范 |
模块设计 |
后端规范 |
| 管理员 |
|
|
⬜ |
| 用户 |
|
|
⬜ |
7. 性能对齐
7.1 性能需求覆盖
| 检查编号 |
描述 |
状态 |
详情 |
| PERF-001 |
响应时间目标已处理 |
⬜ |
|
| PERF-002 |
缓存策略已实现 |
⬜ |
|
| PERF-003 |
数据库索引支持查询模式 |
⬜ |
|
| PERF-004 |
限流已配置 |
⬜ |
|
7.2 性能目标矩阵
| 需求 |
架构 |
后端 |
数据库 |
| < 500ms P95 |
⬜ |
⬜ |
⬜ |
| 100 请求/秒 |
⬜ |
⬜ |
⬜ |
8. 命名一致性
8.1 术语检查
| 检查编号 |
描述 |
状态 |
详情 |
| NAME-001 |
实体名称一致 |
⬜ |
|
| NAME-002 |
API 端点命名遵循约定 |
⬜ |
|
| NAME-003 |
变量/字段命名一致 |
⬜ |
|
| NAME-004 |
状态值一致 |
⬜ |
|
8.2 术语表
| 术语 |
需求 |
模块 |
数据库 |
API |
| 用户 |
|
|
users |
/users |
| 订单 |
|
|
orders |
/orders |
9. 文档完整性
9.1 必需章节检查
| 文档 |
必需章节 |
完整 |
| requirements-spec.md |
执行摘要、功能需求、非功能需求、约束 |
⬜ |
| module-planning.md |
模块列表、依赖、顺序 |
⬜ |
| module-design.md（每个） |
API、数据模型、业务逻辑 |
⬜ |
| architecture-spec.md |
技术栈、组件、部署 |
⬜ |
| ui-ux-spec.md |
颜色、排版、组件 |
⬜ |
| backend-spec.md |
API 标准、认证、校验 |
⬜ |
| database-spec.md |
表、索引、约束 |
⬜ |
10. 人工审查点
10.1 业务逻辑一致性
10.2 用户体验流程
10.3 集成点
校验报告模板
# 一致性校验报告
**项目：** {项目名称}
**日期：** {日期}
**校验者：** Claude（半自动）
## 摘要
| 类别 | 检查数 | 通过 | 警告 | 失败 |
|------|--------|------|------|------|
| 需求 | 4 | | | |
| API | 4 | | | |
| 数据模型 | 4 | | | |
| UI/UX | 4 | | | |
| 架构 | 4 | | | |
| 安全 | 4 | | | |
| 性能 | 4 | | | |
| 命名 | 4 | | | |
| **总计** | **32** | | | |
## 详细结果
### 严重问题（必须修复）
1. [检查编号] 描述
- 位置：文件、章节
- 建议：修复操作
### 警告（建议审查）
1. [检查编号] 描述
- 位置：文件、章节
- 建议：审查操作
### 需要人工审查
1. [区域] 描述
- 原因：原因
- 建议审查者：角色
## 建议
1. 优先级 1 建议
2. 优先级 2 建议
3. 优先级 3 建议
校验执行指南
自动检查（可脚本化）
- 需求覆盖：解析 FR-* 编号，交叉引用模块
- API 端点矩阵：从模块设计提取端点，比较后端规范
- 实体对齐：从模块设计解析实体，比较数据库规范
- 命名一致性：提取实体/字段名称，检查变体
需要人工审查
- 业务逻辑一致性
- 用户体验流程完整性
- 集成点兼容性
- 安全实现细节
执行校验
- 生成所有规范文档
- 运行自动检查
- 审查自动检查结果
- 对标记项进行人工审查
- 生成一致性报告
- 处理严重问题
- 修复后重新校验
