344 lines
7.2 KiB
Markdown
344 lines
7.2 KiB
Markdown
# 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 价值链路与利益相关方
|
||
|
||
```mermaid
|
||
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 管理端
|
||
|
||
**业务流程**：
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[开始] --> B{判断条件}
|
||
B -->|是| C[执行操作]
|
||
B -->|否| D[另一操作]
|
||
C --> E[结束]
|
||
D --> E
|
||
```
|
||
|
||
**关键页面/交互**：
|
||
|
||
| 页面/组件 | 说明 | 关键字段/操作 |
|
||
|---|---|---|
|
||
| 列表页 | | |
|
||
| 创建页 | | |
|
||
| 详情页 | | |
|
||
|
||
**规则与校验**：
|
||
1. {校验规则}
|
||
|
||
**接口/数据**：
|
||
- 涉及接口：{接口名称}
|
||
- 字段说明：参见第 7 章
|
||
|
||
---
|
||
|
||
## 7. 数据与埋点
|
||
|
||
### 7.1 数据模型（建议结构）
|
||
|
||
> 新建表或字段变更的建议结构，供技术方参考。
|
||
|
||
```sql
|
||
-- 新建表示例
|
||
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 章）
|