post-bank-point-mall/.qoder/rules/requirements.md

1.5 KiB

trigger description
model_decision 生成需求文档的时候需要

需求文档编写规范

文档结构要求

必须且仅包含以下6个章节,顺序固定:

  1. 功能模块划分: 明确的模块结构和模块关系
  2. 功能详细说明: 每个功能的具体描述、业务规则、验收标准
  3. 用户故事: 从用户视角描述需求和期望价值
  4. 数据需求: 数据实体、字段定义、数据规则
  5. 流程图: 使用 PlantUml 语法实现,清晰展示业务流程和逻辑
  6. 附录: 业务术语表及其他补充说明

用户故事格式

采用标准用户故事格式:

作为 [用户角色],我希望 [功能需求],以便 [业务价值]
  • 用户角色: 明确的角色定义(如:普通用户、管理员、运营人员)
  • 功能需求: 具体的功能期望
  • 业务价值: 该功能带来的价值或解决的问题

附录要求

业务术语表

术语 定义 示例
术语名称 准确的业务定义 具体使用示例

需求描述要求

  • 简洁: 避免冗余和无关信息
  • 聚焦: 只描述业务需求,不涉及实现方案
  • 明确无歧义: 每个需求点都有准确定义,避免模糊表述

规则作用

保持需求文档的纯粹性,将需求分析与设计实现分离,通过流程图直观展示业务逻辑

规则重要性

确保需求文档聚焦业务价值和用户需求,便于需求评审、开发理解和后续变更管理