# 文档一致性检查清单（精简版）

> 面向机器执行/判断的最小规则集

## 1. 目标
- 代码变更必须同步到对应文档
- API/状态机/测试文档保持最新

## 2. 触发与对应文档（必须）
### 2.1 前端变更
- 组件/页面结构变化 → `docs/modules/<module>/05-ui-interaction-spec.md`
- 可访问性标识变化（role/name/aria-label） → `05-ui-interaction-spec.md` 元素定位索引
- 路由变化 → `05-ui-interaction-spec.md` 页面URL映射

### 2.2 后端 API 变更
- 新增/删除端点 → `docs/modules/<module>/07-api.md`
- 请求/响应字段变化 → `07-api.md`
- 错误码变化 → `08-error-codes.md`
- 权限变化 → `07-api.md`

### 2.3 状态机变更
- 状态新增/删除/流转变化 → `04-state-machine.md`
- 触发条件/权限/副作用变化 → `04-state-machine.md`

### 2.4 测试与页面行为变更
- 页面流程/断言变化 → `09-test-scenarios.md`
- 元素定位（role/name/aria-label）/页面结构变化 → `10-e2e-test-spec.md`

## 3. 优先级规则
- P0：契约与元素定位变更（API 字段、错误码、路由、role/name/aria-label）
- P1：展示文案、次级业务说明

## 4. 最小检查清单
- 是否影响 API 契约（路径/字段/语义/错误码/权限）
- 是否影响状态机（状态/流转/条件）
- 是否影响 UI 交互（页面/路由/元素定位标识）
- 是否影响测试场景或 E2E 规范