# 七维需求澄清检查清单（A~G）

本文件是 `xiaoma-prd-clarify` 的**规则库主体**，由 Claude 在执行"逐维度检查"步骤时按需读取。七个维度构成基线，可按业务域扩展（见末节）。

## 如何使用本清单

- **逐维度、逐检查点核对**：从 A 到 G 不跳维；每个检查点都对照 PRD 原文判断"是否说清、能否据此写代码"。
- **四类问题判别**：
  - **缺失**＝该说未说（检查点在 PRD 中找不到对应说明）；
  - **模糊**＝说了但不可执行（无具体取值、无规则、无公式）；
  - **歧义**＝存在多种合理理解；
  - **矛盾**＝前后文、正文与原型 / 表格 / 状态图之间不一致。
- **逐条定位**：每命中一条，记录其 PRD 出处（章节 / 段落 / 表格行 / 图号）与原文摘录。
- **判级**：按 P0 / P1 / P2（判定准则见 `scoring.md`）。
- 命中即生成一条澄清条目（字段见 `output-template.md`）；未命中不强行造问题，避免噪音。

## A 业务逻辑与流程

**核心关注：** 主流程是否完整闭环，异常与逆向路径是否覆盖。

- 主流程（happy path）是否端到端描述清楚，每一步的输入、处理、输出是否明确。
- **异常分支与逆向流程**：失败、驳回、撤销、退回、作废、超时等分支是否定义；能否回退、回退到哪一步。
- **状态机**：是否列全所有状态、状态间的合法流转、每次流转的触发条件与操作人；是否存在到达不了或出不去的状态（死状态）。
- **规则触发条件**：每条业务规则的生效前提、优先级、互斥 / 叠加关系是否说明；多规则冲突时如何裁决。
- **跨系统 / 跨模块依赖**：流程是否依赖外部系统或上游数据；依赖不可用时如何处理。
- **时序与先后约束**：步骤是否有强制先后顺序、并行可能、定时触发。

## B 字段与数据

**核心关注：** 每个字段能否被唯一确定地实现。

- **基本属性**：类型、长度、精度（小数位）、是否必填、默认值是否逐字段说明。
- **枚举穷尽**：枚举值是否列全、是否含"其他 / 未知"、各枚举的业务含义；枚举是否与状态流转、筛选项一致。
- **计算公式**：金额 / 利率 / 费用 / 比例等公式是否给全；**取整规则、保留小数位、舍入方式（四舍五入 / 向下取整）、单位、币种**是否明确；中间值精度是否说明。
- **字段来源**：派生 / 带出字段的数据来源、计算时机（实时 / 落库）、与源字段的同步规则。
- **校验规则**：格式校验、值域校验、唯一性、关联校验、跨字段一致性校验是否定义；校验失败的提示与处理。
- **数据字典对齐**：若已有数据字典 / 字段规范，PRD 字段定义是否与之一致。

## C 边界与异常

**核心关注：** 极端与异常情况是否覆盖。

- **数值边界**：上下限、最小步长、是否含端点（开 / 闭区间）、超界处理。
- **非法 / 越界取值**：负数、零、超出范围、错误格式等非法输入的拒绝与提示（如利率 / 比例为 0 或负、金额越界、日期早于今日）。
- **空值与缺省**：null / 空字符串 / 0 / 未选择 的区分与各自表现。
- **时间边界**：起止时间含否端点、时区、跨天 / 跨月 / 跨年、节假日、生效与失效时点。
- **数据量与规模**：列表 / 导入 / 导出的条数上限、分页、超大数据量下的表现与降级。
- **并发与幂等**：重复提交、并发修改同一数据、按钮重复点击的去重 / 加锁 / 幂等键；接口重试是否安全。
- **失败与超时**：外部调用失败、超时、部分成功（批量中部分失败）的处理：整批回滚 / 跳过失败项并返回失败清单 / 重试。

## D 交互与显示

**核心关注：** 界面行为是否明确、图文是否一致。

- **显隐 / 置灰 / 只读**：字段或按钮在不同状态 / 角色 / 条件下的可见性、可用性、可编辑性规则。
- **联动**：字段间联动、级联选择、选项随上文变化的规则与默认。
- **默认值与初始态**：进入页面 / 新建 / 编辑时各字段的默认值与默认选中。
- **排序 / 筛选 / 分页**：默认排序字段与方向、可筛选项、分页大小。
- **提示文案**：成功 / 失败 / 校验 / 二次确认 文案是否给出，还是仅写"给出提示"。
- **图文一致**：正文描述与原型图 / 交互稿是否一致（字段、按钮、状态、布局），不一致处需澄清以哪个为准。

## E 接口与集成

**核心关注：** 系统间交互是否清晰可实现。

- **上下游接口**：依赖哪些接口、谁提供、入参出参、字段映射是否给全。
- **同步 / 异步**：调用方式、回调 / 轮询机制、异步结果如何回写与通知。
- **幂等 / 重试 / 补偿**：接口幂等性、失败重试策略、补偿 / 对账机制。
- **对账与一致性**：跨系统数据如何保证最终一致、对账周期与差异处理。
- **协议与鉴权**：接口协议、鉴权方式、限流约定（如涉及）。

## F 权限与安全合规

**核心关注：** 谁能在什么条件下做什么、数据如何受控。

- **功能 / 数据 / 操作权限**：各角色可见的功能、可访问的数据范围（行 / 列级）、可执行的操作是否说明。
- **数据隔离**：多机构 / 多租户 / 多组织下的数据隔离与共享规则。
- **审计留痕**：关键操作（创建、修改、审批、作废、导出）是否需要留痕及留痕内容。
- **脱敏 / 加密**：敏感字段（证件、账号、金额等）的展示脱敏与存储加密要求。
- **行业合规**：金融票据、信贷等场景的监管与合规要求（额度、风控、双录、留痕等）是否覆盖。

## G 非功能性

**核心关注：** 落地的工程约束是否说明。

- **性能**：响应时间、吞吐、关键操作的性能预期。
- **数据量与增长**：存量与增量规模、增长预估对方案的影响。
- **兼容性**：浏览器 / 终端 / 版本兼容范围，新老数据兼容。
- **数据迁移**：是否涉及存量数据迁移、迁移规则与回滚。
- **可用性与回滚**：灰度、降级、回滚预案；故障时的业务表现。

## 按业务域扩展规则

七维为通用基线。可在不改主流程的前提下，向本文件追加业务域专属检查片段，例如：

- **票据**：票据状态机（出票 / 背书 / 贴现 / 质押 / 提示付款 / 拒付）闭环、金额与到期日计算、要素一致性校验、监管留痕。
- **信贷**：授信 / 用信 / 还款 的额度计算与占用释放、利率与计息规则、逾期与罚息、风控准入。

> 维护方式：将历史高频模糊点沉淀为新的检查点，附"业务域 / 触发场景 / 检查要点"，持续提升识别准确率。