zentao-flow/.agents/skills/pmassist-v3/references/prd.md

PRD 模板（pmassist-v3）

使用说明：按需裁剪，保留证据标注。所有关键结论需引用 materials_index.md 中的来源 ID。 FR 编号（FR-xxx）需与 outputs/acceptance.md 中的 AC 对应。

---

0. 文档信息

字段	内容
版本	v1.0
状态	草稿 / 评审中 / 定稿
作者
创建日期
最后更新
适用范围

变更记录

版本	日期	变更编号	变更说明	影响章节
v1.0		CHG-000	初稿	全部

---

1. 业务背景

1.1 现状与痛点

描述当前业务现状，用数据或事实证据支撑。

• 现状描述：[SRC-001]
• 核心痛点：
  1. [ASSUMPTION]
  2. [ASSUMPTION]

1.2 业务目标与问题陈述

本需求要解决的核心问题是什么？

1.3 相关历史决策

可链接 decision_log.md 中的历史决策。

---

2. 目标与成功指标

2.1 业务目标（可量化）

目标	指标	当前值	目标值	截止时间

2.2 北极星指标

2.3 约束条件与边界

• 时间约束：
• 技术约束：
• 合规约束：
• 不在本期范围：

---

3. 用户与场景

3.1 目标用户/角色

角色	描述	典型诉求
运营
用户/客户
管理员

3.2 关键使用场景

场景编号	场景描述	涉及角色	优先级
S-001			P0
S-002			P1

3.3 价值链路与利益相关方

graph LR
    A[角色1] --> B[操作] --> C[系统] --> D[结果]

---

4. 需求范围

4.1 范围内（In Scope）

模块	功能	备注

4.2 范围外（Out of Scope）

• 本期不做： 1. 2.

4.3 假设与依赖

依赖项	类型	状态	负责方
	内部/外部	待确认/已确认

---

5. 整体方案介绍

5.1 方案概述

5.2 核心机制/策略

5.3 结算/计费/策略规则（如适用）

5.4 字段新增/调整

字段名	表/对象	类型	说明	证据

5.5 方案对比与取舍

方案	优点	缺点	结论
方案 A（选定）			✅ 采用
方案 B			❌ 放弃

---

6. 需求内容

6.1 端/渠道覆盖矩阵（强制）

端/渠道	是否覆盖	核心差异点	涉及 FR	证据
管理端	✅/❌/部分		FR-001~005
商户平台
合伙人平台
小程序/H5
API/开放接口
其他端

6.2 功能需求列表（FR）

编号规则：主功能 FR-001；子功能 FR-001-1。每条 FR 需有对应 AC（见 outputs/acceptance.md）。

FR-001：{功能名称}

• 优先级：P0 / P1 / P2
• 角色：{涉及角色}
• 触发条件：WHEN/IF {条件}
• 需求：系统 SHALL {做什么}
• 业务规则：
  1. {规则1}
  2. {规则2}
• 边界条件：{非正常路径说明}
• 证据：[SRC-001] / [CODEMAP:...] / [ASSUMPTION]
• AC 引用：AC-001-1, AC-001-2

FR-002：{功能名称}

（同上格式）

---

6.3 各端功能详细说明

按端展开，每端包含：业务流程 → 关键页面/交互 → 规则与校验 → 接口/数据

6.3.1 管理端

业务流程：

flowchart TD
    A[开始] --> B{判断条件}
    B -->|是| C[执行操作]
    B -->|否| D[另一操作]
    C --> E[结束]
    D --> E

关键页面/交互：

页面/组件	说明	关键字段/操作
列表页
创建页
详情页

规则与校验：

1. {校验规则}

接口/数据：

• 涉及接口：{接口名称}
• 字段说明：参见第 7 章

---

7. 数据与埋点

7.1 数据模型（建议结构）

新建表或字段变更的建议结构，供技术方参考。

-- 新建表示例
CREATE TABLE `{表名}` (
  `id`          BIGINT      NOT NULL AUTO_INCREMENT  COMMENT '主键',
  `code`        VARCHAR(64) NOT NULL                 COMMENT '编号',
  -- 业务字段...
  `status`      TINYINT     NOT NULL DEFAULT 0       COMMENT '状态：0=xxx，1=xxx',
  `create_by`   VARCHAR(64)                          COMMENT '创建人',
  `create_time` DATETIME                             COMMENT '创建时间',
  `update_by`   VARCHAR(64)                          COMMENT '更新人',
  `update_time` DATETIME                             COMMENT '更新时间',
  `del_flag`    CHAR(1)     NOT NULL DEFAULT '0'     COMMENT '删除标志',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='';

7.2 字段定义

字段名	类型	取值/范围	说明	来源

7.3 数据口径

指标名	计算方式	来源表/字段	备注

7.4 统计/埋点需求

事件名	触发时机	携带参数	用途

7.5 导出/对账口径

字段	页面展示	导出字段	对账字段	差异说明

---

8. 差异点清单（强制）

记录"现状 vs 目标"的差异，避免只写方案不写差异。

维度	现状	目标	影响范围	涉及 FR	证据
策略差异
口径差异
UI/交互差异
数据结构差异
权限差异

---

9. 风险确认与应对

风险编号	风险描述	类型	等级	应对措施	负责人
R-001		合规/业务/技术/体验	高/中/低

9.1 回滚/灰度策略

---

10. 里程碑与发布计划

里程碑	交付物	时间	负责方	状态
M0-需求确认	PRD Final		PM
M1-架构设计	架构文档		Arch
M2-开发完成	代码+单测		Dev
M3-测试通过	测试报告		QA
M4-上线	发布说明		DevOps

10.1 上线策略与验收标准

---

11. 其他需求 / 备注

11.1 重要决策记录

可引用 decision_log.md

11.2 待后续决策事项

---

12. 证据映射表（强制）

章节	关键结论	证据	状态
业务背景
方案介绍
功能需求
数据与口径
风险

---

13. FR → AC 覆盖矩阵（强制）

FR 编号	FR 标题	AC 数量	AC 列表	覆盖状态
FR-001		2	AC-001-1, AC-001-2	✅ 已覆盖
FR-002		0	—	⚠️ 待补充

---

14. 系统资产引用（强制）

资产类型	路径	用途
CodeMap
DomainMap
Runtime

---

15. 参考资料与索引

• 来源索引：见 materials_index.md
• CODEMAP/DOMAINMAP/RUNTIME 引用：见第 14 章

---

图表要求（强制检查）

• 至少 1 个 mermaid 图（流程图/时序图/状态图任选）
• 至少 1 张表（范围清单/风险列表/需求拆解等）
• 端覆盖矩阵已填写（第 6.1 节）
• 差异点清单已填写（第 8 章）
• FR→AC 覆盖矩阵已填写（第 13 章）