docs(tasks): restore H-410 contract and rework fill-in examples (H-411)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/07-user-stories.md

@@ -78,35 +78,67 @@
 
 ## 七、填写示例
 
-> 本节只演示如何填写字段，所有【占位符】必须替换为项目事实；不要把示例当作通用业务规则。
+> 本节演示"填好之后长什么样"。示例采用通用的列表检索和删除场景，把其中的【条目】替换为项目里的真实业务对象（订单、文章、成员……）即可套用；示例不是本项目的需求，不要不加判断地照抄进正式表格。
 
 ### 示例总表
 
 | ID | 标题 | 优先级 | 角色 | 要达成的目标 | 关联功能 | 关联交互 | 状态 |
 | --- | --- | --- | --- | --- | --- | --- | --- |
-| US-001 | 【完成核心操作】 | P0 | 【目标角色】 | 【完成后得到的价值】 | 【功能 1】 | IX-001 | 【待确认 / 已定】 |
-| US-002 | 【确认执行影响数据的操作】 | P0 | 【目标角色】 | 【理解影响后完成操作】 | 【功能 2】 | IX-002 | 【待确认 / 已定】 |
+| US-001 | 按关键词找到目标【条目】 | P0 | 【管理员】 | 在大量【条目】中快速定位要处理的那一条 | 【条目】检索 | IX-001、IX-003 | 已定 |
+| US-002 | 安全地删除不再需要的【条目】 | P0 | 【管理员】 | 移除失效【条目】，且不因误操作丢数据 | 【条目】管理 | IX-002 | 已定 |
 
-### US-001 【完成核心操作】
+### US-001 按关键词找到目标【条目】
 
-- 关联页面 / 入口：【页面、命令或入口】
-- 使用场景 / 前置条件：【用户已满足的条件】
+- 优先级：P0
+- 关联功能：【条目】检索
+- 关联页面 / 入口：【条目】列表页
+- 关联交互：IX-001、IX-003
+- 角色：【管理员】
+- 使用场景 / 前置条件：已登录且有查看权限；列表中【条目】数量多到无法逐条浏览。
 
-作为【目标角色】，我想要【完成核心操作】，从而【获得明确价值】。
+**用户故事**
+
+作为【管理员】，我想要按关键词检索【条目】列表，从而不必逐页翻找就能定位要处理的【条目】。
+
+**范围**
+
+- 包含：按关键词过滤列表、显示结果数量、空结果与失败时的反馈。
+- 不包含：高级筛选、排序和保存搜索条件（另立故事）。
 
 **验收场景**
 
-1. 假如【前置条件】，当用户【执行目标相关的动作】，那么【可观察到成功结果】。
-2. 假如【异常、权限或边界条件】，当用户尝试该目标，那么系统【解释原因并提供下一步】。
+1. 假如列表中存在匹配【条目】，当用户输入关键词并触发搜索，那么列表刷新为匹配结果，并显示结果数量。
+2. 假如没有匹配结果，当用户搜索，那么显示空状态说明并提供"清除搜索"入口，不当作错误处理。
+3. 假如搜索请求失败，当用户搜索，那么保留已输入的关键词，说明失败原因并允许重试。
 
-### US-002 【确认执行影响数据的操作】
+**待确认**
 
-- 关联页面 / 入口：【页面、命令或入口】
+- 【关键词匹配哪些字段、是否支持模糊匹配，由产品决策】
+
+### US-002 安全地删除不再需要的【条目】
+
+- 优先级：P0
+- 关联功能：【条目】管理
+- 关联页面 / 入口：【条目】列表页
 - 关联交互：IX-002
+- 角色：【管理员】
+- 使用场景 / 前置条件：已登录且对目标【条目】有删除权限。
 
-作为【目标角色】，我想要在了解【操作影响】后确认或取消【操作】，从而【避免意外结果】。
+**用户故事**
+
+作为【管理员】，我想要在确认影响后删除失效的【条目】，从而保持列表整洁且不担心误删。
+
+**范围**
+
+- 包含：单条删除、删除前确认、成功与失败反馈。
+- 不包含：批量删除、回收站与恢复（另立故事）。
 
 **验收场景**
 
-1. 假如【操作会影响已有数据】，当用户发起【操作】，那么系统【明确说明影响并提供确认与取消】。
-2. 假如用户取消或操作失败，那么系统【保留必要上下文并说明恢复路径】。
+1. 假如目标【条目】存在且用户有权限，当用户发起删除，那么系统先说明影响并要求确认，确认后该【条目】从列表消失并提示成功。
+2. 假如用户在确认对话框中取消，那么不发生任何数据变化，用户回到原位置。
+3. 假如删除请求失败或【条目】已被他人删除，那么系统说明原因、刷新列表，不出现"看起来删了但还在"的中间态。
+
+**待确认**
+
+- 【删除是硬删除还是软删除、是否需要审计留痕，由产品与合规决策】