# 模块用户故事：stories.md

> 模块：{module}
> 当前真相：本文件维护模块完整故事集合；不创建 per-REQ/per-round 副本
> 关联原型：`docs/design/prototypes/{module}/index.html` + 当前 `*.html`
> 关联场景：`scenario-model.json` / `cases.json` / `scenario-coverage.json` / `fixture-contract.json`

## 使用方式

本文件按模块维护完整、当前且唯一的真实用户故事集合，而不是需求增量或
历史版本集合。一个故事描述“谁在什么情境下，为何要完成什么目标”；它可
关联一条或多条 `PATH-*`，并必须引用 scenario branch / CASE。REQ 只写入
`source_refs`，不出现在文件名或所有权字段中。

## 1. 故事目录

| 故事 ID | 用户角色 | 触发场景 | 用户目标 | CASE / PATH | source_refs |
|:---|:---|:---|:---|:---|:---|
| S-001 | {role} | {real-world trigger} | {goal} | CASE-001 / PATH-001 | REQ-{id}/FR-{id} |
| S-002 | {role} | {rejection or recovery trigger} | {safe recovery goal} | CASE-002 / PATH-002 | REQ-{id}/FR-{id} |

## 2. 用户和场景

<!-- 复制第 2 至 8 节，为故事目录中的每个故事补充必要内容。故事可共享
     页面跳转和 UI/UX 审查结论；无须为了套模板重复相同背景。 -->

| 项 | 内容 |
|:---|:---|
| 故事 ID | S-{id} |
| source_refs | REQ-{id}/FR-{id}, decision/state/rule refs |
| 用户角色 | {role} |
| 触发背景 | {why this user starts the flow} |
| 业务目标 | {what success means} |
| 前置条件 | {permissions, data, state} |
| 覆盖分支 | BR-{id}-ALLOW, BR-{id}-REJECT |
| 覆盖 CASE | CASE-{id} |

## 3. 功能设计背景

{为什么需要这个功能，当前业务问题是什么，页面或模块为什么这样组织。}

## 4. 页面跳转逻辑

| 起点 | 用户意图 | 动作 | 目标页面 / 状态 | 设计理由 | 原型区域 |
|:---|:---|:---|:---|:---|:---|
| {page/state} | {intent} | {action} | {page/state} | {why this transition exists} | {prototype section} |

## 5. 成功故事

{用自然语言描述用户从入口到完成目标的完整故事。}

## 6. 异常和边缘故事

| 场景 | 用户看到什么 | 系统如何恢复 | 覆盖条款 |
|:---|:---|:---|:---|
| {empty/error/permission/cancel/retry} | {visible state} | {recovery} | FR-{id} / NFR-{id} |

## 7. UI/UX 审查问题

| 问题 | 影响 | 决策 | 状态 |
|:---|:---|:---|:---|
| {navigation/layout/copy/accessibility concern} | {impact} | {decision or owner} | open / closed |

> 状态为 `open` 且影响用户理解、页面跳转、权限、数据含义或错误恢复时，不得进入 S3 合同锁定。

## 8. REQ 映射

| source_ref | 原型区域 | 用户价值 | 验收方式 |
|:---|:---|:---|:---|
| REQ-{id}/FR-{id} | {screen/section} | {value} | {evidence} |

## 9. 与原型和动线的一致性

| 检查项 | 结果 | 证据 |
|:---|:---|:---|
| 成功故事在当前 `*.html` 中可见 | pass / fail | {section/state} |
| 异常和边缘故事在当前 `*.html` 中可见或明确 N/A | pass / fail | {section/state/N-A reason} |
| 页面跳转均有 `F-NNN` / `PATH-*` 路径覆盖 | pass / fail | {PATH ids} |
| required allow/reject branch coverage = 100% | pass / fail | {scenario-coverage.json} |
| browser-required CASE 均绑定 module spec | pass / fail | `web/e2e/{module}/` |
| 合同需要的字段、状态、错误、权限和副作用已标出 | pass / fail | {contract notes} |