正文
获取原文件references/coverage-and-states.md
1. 页面盘点
现状审查从以下位置交叉取数;目标页面集合同时保留用户批准但尚未实现的页面:
- 路由配置、文件系统路由和动态路由参数。
- 一级/二级导航、快捷入口和深链。
- 弹窗、抽屉、步骤流、条件分支和权限页面。
- 404、403、登录失效、维护和离线页面。
PRD 或原型模式从角色、任务、入口、结果和恢复路径推导页面。推导项标记为 INFERRED。
2. 映射表字段
route-design-map.csv 或 screen-design-map.csv 至少使用:
source_id,screen_id,name,source_type,requirement_refs,status,required_states,artifact_path,notes
source_type:EXPLICIT、INFERRED、UNKNOWN。status:PLANNED、CREATED、OBSERVED、VERIFIED、BLOCKED、NOT_APPLICABLE。这些状态描述页面产物,与任务和业务验收状态分别记录;OBSERVED仅表示已读取现有产物。requirement_refs:PRD、路由或原型屏幕的可追溯编号。
3. 状态族
按适用性检查:
- 数据:初始、加载、增量加载、刷新、空、部分数据、过期。
- 网络:慢网、离线、超时、断线重连、重复提交。
- 权限:未登录、无权限、权限申请、会话过期。
- 操作:默认、进行中、成功、失败、撤销、确认、危险操作。
- 内容:短文本、长文本、异常字符、多语言、图片失败。
- 业务:锁定、审核中、驳回、完成、归档、已删除。
状态不适用时写明原因,不能简单留空。
4. 流程完整性
每个核心任务流至少记录:
- 入口和前置条件。
- 主路径与关键决策点。
- 中止、返回、失败和恢复路径。
- 完成状态和后续动作。
覆盖率分母必须来自可核查基线。不要把“推导出的建议页面”混入“原始范围已覆盖”数字。
5. 完成度计算
- 页面覆盖率 = 已创建必需页面 / 必需页面总数。
- 状态覆盖率 = 已创建适用状态 / 适用状态总数。
- 验证覆盖率 = 已完成要求验证的必需页面和状态 / 全部必需页面和状态。
分别报告,不合并成一个模糊百分比。任何 BLOCKED 项单列原因和解除条件。