docs: 新增 PRD V0.1(Markdown 版)并纳入 README 文档索引
This commit is contained in:
1 parent
b56520e017
commit
8f9355530d
3 files changed
+559
-6
No files matched your search
@@ -25,6 +25,3 @@ __pycache__/
|
||||
*.log
|
||||
.env
|
||||
.env.local
|
||||
|
||||
# 内部文档:不推送到本仓库(仓库对外可见)
|
||||
docs/PRD/
|
||||
@@ -11,12 +11,26 @@
|
||||
- **工作流沉淀**:把每一次有效创意固化为可复用的工作流,放大成本与规模优势
|
||||
- **释放人力**:将账户搭建、DP 编写、承接页信息填写等重复配置工作自动化
|
||||
|
||||
## 仓库说明
|
||||
## 项目文档
|
||||
|
||||
本仓库只包含可公开的内容。产品需求文档(PRD)等内部资料不纳入本仓库,本地存放于 `docs/PRD/`(已在 `.gitignore` 中忽略)。
|
||||
| 文档 | 版本 | 状态 | 位置 |
|
||||
| --- | --- | --- | --- |
|
||||
| 平台电商素材生产平台 PRD(产品需求文档) | V0.1 | 草稿 | [docs/PRD/平台电商素材生产平台_PRD_V0.1.md](docs/PRD/平台电商素材生产平台_PRD_V0.1.md) |
|
||||
|
||||
PRD V0.1 已完成「1.1 背景与问题」「1.2 产品目标」及整体章节框架,其余章节待补充。
|
||||
|
||||
## 仓库结构
|
||||
|
||||
```
|
||||
.
|
||||
├── README.md
|
||||
└── docs/
|
||||
└── PRD/ 产品需求文档(Markdown)
|
||||
```
|
||||
|
||||
## 协作说明
|
||||
|
||||
- 主分支:`main`
|
||||
- 文档以 Markdown 维护,命名格式:`<项目><文档类型>_V<版本>.md`
|
||||
- 提交信息建议使用:`docs: 说明` / `feat: 说明` / `fix: 说明`
|
||||
- 文档命名格式:`<项目><文档类型>_V<版本>.<扩展名>`
|
||||
- 文档内表格使用 GFM 表格,流程图/原型图建议放 `docs/assets/` 并以相对路径引用
|
||||
@@ -0,0 +1,542 @@
|
||||
# 平台电商素材生产平台 · 产品需求文档
|
||||
|
||||
*PRODUCT REQUIREMENTS DOCUMENT*
|
||||
|
||||
**素材标准化生产与投放提效**
|
||||
|
||||
> 把商品原始物料、素材产出、提审与投放配置,做成一条可复用的标准化生产线
|
||||
|
||||
文件编号:\_\_\_\_\_\_\_\_\_\_\_\_ 密级:内部公开
|
||||
|
||||
【公司 / 部门名称】 | 2026 年 10 月
|
||||
|
||||
| **产品 / 项目名称** | 平台电商素材生产平台(暂定名) |
|
||||
| --- | --- |
|
||||
| **需求名称** | 素材标准化生产与投放提效 |
|
||||
| **文档版本** | V0.1 |
|
||||
| **文档状态** | 草稿 |
|
||||
| **编写人** | 【待填写】 |
|
||||
| **评审人** | 【产品、研发、测试、设计负责人】 |
|
||||
| **创建日期** | 2026-10-29 |
|
||||
| **最后更新** | 2026-10-29 |
|
||||
|
||||
## 修订记录
|
||||
|
||||
*▸ 填写提示:每次内容变更都要新增一行:小改动升次版本号(V1.1),范围或方案重大调整升主版本号(V2.0)。*
|
||||
|
||||
| **版本** | **日期** | **修订人** | **修订说明** |
|
||||
| --- | --- | --- | --- |
|
||||
| V0.1 | 2026-10-29 | | 初稿:完成 1.1 背景与问题、1.2 产品目标,其余章节待补 |
|
||||
| | | | |
|
||||
| | | | |
|
||||
|
||||
**文档审批**
|
||||
|
||||
| **角色** | **姓名** | **签字 / 确认方式** | **日期** |
|
||||
| --- | --- | --- | --- |
|
||||
| 产品负责人 | | | |
|
||||
| 研发负责人 | | | |
|
||||
| 测试负责人 | | | |
|
||||
| 设计负责人 | | | |
|
||||
|
||||
## 目录
|
||||
|
||||
- 1 文档概述
|
||||
- 1.1 背景与问题
|
||||
- 1.1.1 原始物料获取
|
||||
- 1.1.2 素材制作
|
||||
- 1.1.2.1 图片素材
|
||||
- 1.1.2.2 视频素材
|
||||
- 1.1.2.3 命名与提审
|
||||
- 1.1.3 账户搭建与投放配置
|
||||
- 1.1.4 多平台管理
|
||||
- 1.1.5 素材与模板资产管理
|
||||
- 1.1.6 问题归纳
|
||||
- 1.2 产品 / 项目目标
|
||||
- 1.2.1 产品目标
|
||||
- 1.2.2 产品定位与边界
|
||||
- 1.2.3 产品功能框架
|
||||
- 1.2.4 优先级说明
|
||||
- 1.3 成功指标
|
||||
- 1.4 名词与术语
|
||||
- 2 用户与场景
|
||||
- 2.1 目标用户
|
||||
- 2.2 用户场景 / 用户故事
|
||||
- 2.3 竞品与参考(可选)
|
||||
- 3 需求范围
|
||||
- 3.1 本期范围(In Scope)
|
||||
- 3.2 不在本期范围(Out of Scope)
|
||||
- 3.3 假设与约束
|
||||
- 4 功能需求
|
||||
- 4.1 功能清单
|
||||
- 4.2 功能详情
|
||||
- 4.3 业务规则汇总
|
||||
- 5 非功能需求
|
||||
- 6 交互与流程
|
||||
- 6.1 页面 / 功能清单
|
||||
- 6.2 核心流程图
|
||||
- 6.3 状态与异常处理
|
||||
- 7 数据与埋点
|
||||
- 8 依赖与风险
|
||||
- 8.1 外部依赖
|
||||
- 8.2 风险登记
|
||||
- 9 发布计划
|
||||
- 9.1 里程碑
|
||||
- 9.2 灰度与回滚
|
||||
- 10 待确认问题
|
||||
- 附录 A 参考文档
|
||||
- 附录 B 评审前自检清单
|
||||
|
||||
## 1 文档概述
|
||||
|
||||
### 1.1 背景与问题
|
||||
|
||||
平台电商的素材生产具备可标准化的特征,但当前仍以人工拍摄、人工排版与逐条配置为主,成本高、周期长、经验难以复用。我们的基本判断是:图片素材可以用标准化模板产出替代实拍,视频素材可以用 AI 生成替代产品实拍;模板化不等于低质化,关键在于把商品的展示细节做扎实,让标准化产出在效果上不输人工。
|
||||
|
||||
同时,每一次有效的创意都应被固化为一条可复用的工作流,让素材产出的成本优势与规模优势被放大,并把从原始商品到成片的全过程沉淀为平台电商的投放知识库。运营侧还有大量重复单调的配置工作(账户搭建、DP 编写、承接页信息填写),本项目的初衷是把人从这类重复劳动中释放出来,节约人的算力。
|
||||
|
||||
### 1.1.1 原始物料获取
|
||||
|
||||
平台电商素材的起点是商品详情页中的原始图片。需要按平台抓取并汇总商品详情页的原始图片,形成本次选品的原始物料库,作为后续图片与视频制作的统一输入。
|
||||
|
||||
当前问题:原始图片依靠逐张人工下载与整理,重复且容易遗漏;不同平台详情页结构不同,缺少统一的抓取与归档入口,选品一旦更换就要重新来一遍。
|
||||
|
||||
### 1.1.2 素材制作
|
||||
|
||||
素材制作分为图片与视频两条产线,二者共用同一份选品与原始物料。
|
||||
|
||||
#### 1.1.2.1 图片素材
|
||||
|
||||
图片需要三个规格:800×800、1280×720、1080×1920。单张图片由四层信息构成:基础框架模板(模板内可固定警示语)、商品展示、产品信息、Logo 信息。四层信息对应以下能力诉求:
|
||||
|
||||
- 模板导入:需要支持导入 PSD 模板,让设计侧沿用现有设计资产生产模板,而不必在系统内重画。
|
||||
- 商品展示:需要提供可选择的展示方式,最好能固定出 AI 模特、AI 脚模等可选拼接方式,保证同类商品的展示风格一致。
|
||||
- 产品信息:需要能叠加折扣信息、活动信息等标识。
|
||||
- Logo 信息:考虑品牌多样性与唯品会的实际需要,Logo 需要可编辑、可组合。
|
||||
|
||||
当前问题:三个规格、四层信息、多个品牌 Logo 全靠人工逐张排版,同一商品换平台、换活动就要整体重做,产出量被人力直接锁死。
|
||||
|
||||
#### 1.1.2.2 视频素材
|
||||
|
||||
视频主要分为 16:9 与 9:16 两个尺寸。从结构上,制作链路拆为脚本、画面、组合三段:
|
||||
|
||||
- 脚本:提供两种获取方式,AI 总结汇总与人工输入,期望输入商品链接即可产出可用脚本。AI 侧持续分析脚本,把消费心理学、行为心理学等营销经典理论融合进脚本结构,使成片更符合平台推流偏好。
|
||||
- 画面:同样两种方式,人工输入画面形象与要求,或由 AI 分析后产出画面;以 AI 视频生成替代产品实拍。
|
||||
- 组合:由 AI 将脚本与商品画面组合成成片。
|
||||
|
||||
当前问题:脚本依赖个人经验、无法沉淀复用;实拍成本高、周期长;成片风格与推流要求不稳定,产出量难以放大。
|
||||
|
||||
#### 1.1.2.3 命名与提审
|
||||
|
||||
素材产出后需要按规范命名并送审。命名需支持自定义字段组合,字段可选商品 ID、日期等;提审需要统一的待审清单与状态跟踪,明确每条素材当前处于哪一环。
|
||||
|
||||
当前问题:人工改名、手工登记,易错且难以追溯;提审进度分散在群聊与表格中,素材与商品、脚本、配置信息之间缺少稳定关联。
|
||||
|
||||
### 1.1.3 账户搭建与投放配置
|
||||
|
||||
平台电商账户搭建通常需要编写 DP,并填写落地页(承接页)等信息。需要提供一键复制与自动配置链接:运营锚定输入点,输入点可选商品 ID 或官网链接,系统据此自动配置 DP 等所需链接。
|
||||
|
||||
当前问题:配置项多、链接长,逐条复制粘贴与手工替换,出错后排查成本高;同一套配置在不同商品、不同活动之间反复填写,占用了运营大量时间。
|
||||
|
||||
### 1.1.4 多平台管理
|
||||
|
||||
不同平台电商需要可管理、可切换:在指定位置生成面向单一平台的专用资源路径,并提供新增平台、新增项目的能力。目前主要服务得物与唯品会两个平台客户。
|
||||
|
||||
当前问题:多平台并行时资源混放、口径不一;新增一个平台往往要把整条流程再走一遍,扩展成本高,也难以复用既有的模板与脚本资产。
|
||||
|
||||
### 1.1.5 素材与模板资产管理
|
||||
|
||||
无论是模板还是已产出的素材,都需要可管理。模板、Logo、商品展示方式、产品/促销信息展示方式、脚本等,均需支持人工参与和选择:可查看、可编辑、可停用、可复用。
|
||||
|
||||
当前问题:模板散落在设计个人电脑、脚本散落在文档与聊天记录里,找不到、不敢改、无法复用;每一次灵感都停在个人经验层面,无法沉淀为组织能力。
|
||||
|
||||
### 1.1.6 问题归纳
|
||||
|
||||
上述问题可归为七类,构成本产品的需求来源:
|
||||
|
||||
**表 1-1 现状问题与影响**
|
||||
|
||||
| **编号** | **环节** | **现状问题** | **影响** |
|
||||
| --- | --- | --- | --- |
|
||||
| P-01 | 原始物料 | 详情页图片逐张人工下载、分散存放 | 耗时、易漏,无法批量处理 |
|
||||
| P-02 | 图片制作 | 三规格 × 四层信息全靠人工排版 | 单套成本高,换平台/换活动需重做 |
|
||||
| P-03 | 视频制作 | 依赖实拍与个人脚本经验 | 成本高、周期长,风格与推流要求不稳定 |
|
||||
| P-04 | 命名提审 | 手工改名与登记,进度散落 | 易错、难追溯,素材与商品缺少稳定关联 |
|
||||
| P-05 | 账户搭建 | DP、承接页配置逐条复制填写 | 重复劳动多,链接出错率高、排查成本高 |
|
||||
| P-06 | 多平台 | 资源与口径不统一,扩展靠重走流程 | 新增平台成本高,既有资产难复用 |
|
||||
| P-07 | 资产管理 | 模板、脚本散落,缺统一入口 | 无法复用,个人经验无法沉淀为组织能力 |
|
||||
|
||||
### 1.2 产品 / 项目目标
|
||||
|
||||
#### 1.2.1 产品目标
|
||||
|
||||
本产品面向平台电商的素材生产与投放准备:同一份选品与原始物料,能够以更低成本、更短周期、更稳定的质量产出可投用的图片与视频素材,并由系统承接运营的重复配置工作。
|
||||
|
||||
**表 1-2 产品目标与衡量方式**
|
||||
|
||||
| **序号** | **目标** | **达成结果** | **衡量方式** |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 降低素材制作成本 | 以标准化模板替代实拍、以 AI 视频替代产品实拍,在保证展示细节的前提下压缩单套成本与周期 | 单套图片/视频制作成本(元/套、元/条)、制作周期(小时/套)、实拍依赖比例 |
|
||||
| 2 | 提升产出效率与一致性 | 把图片四层结构、视频“脚本→画面→组合”链路固化为模板与工作流,同一次灵感可被批量复现,并沉淀为可复用的投放知识库 | 人均日产出套数、模板产出占比、一次提审通过率、模板/脚本复用次数 |
|
||||
| 3 | 释放运营重复劳动 | 选品、素材、提审、投放配置收进同一平台,提供一键复制与一键配置能力 | 单账户搭建耗时(分钟)、配置出错率、运营人均承接账户数 |
|
||||
|
||||
#### 1.2.2 产品定位与边界
|
||||
|
||||
产品定位为平台电商的“素材生产线 + 投放配置台”:向上承接选品与原始物料,向下产出可提审的素材与可复制的投放配置。系统提供标准化与 AI 生成能力,但设计、运营始终保留人工选择权——模板、Logo、展示方式、促销信息、脚本均可人工指定与调整。
|
||||
|
||||
本期聚焦得物与唯品会两个平台,并把新增平台、新增项目作为可扩展能力预留;素材的投放执行与效果归因暂不在本期范围(待评审确认)。
|
||||
|
||||
#### 1.2.3 产品功能框架
|
||||
|
||||
平台以“平台切换—选品—素材制作—素材提审—投放信息”为主线,配合统一的资产管理。功能逐项如下:
|
||||
|
||||
**表 1-3 产品功能框架**
|
||||
|
||||
| **模块** | **子模块** | **功能点** | **说明** | **优先级** |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 平台 | 平台切换 | 得物 / 唯品会 | 总平台内选择平台进入,进入后为对应平台的资源与配置 | P0 |
|
||||
| 平台 | 扩展 | 新增平台 / 新增项目 | 在指定位置生成面向单一平台的专用资源路径 | P0 |
|
||||
| 选品 | 检索 | 商品 ID / SPUID | 检索主键随平台变化,定位单个商品 | P0 |
|
||||
| 选品 | 检索 | 商品名称(粗词) | 按关键词粗匹配,用于不确定商品 ID 的场景 | P1 |
|
||||
| 选品 | 圈选 | 添加本次选品 | 检索结果加入本次操作范围,作为后续制作与配置的输入 | P0 |
|
||||
| 选品 | 原始物料 | 下载原始图片 | 抓取商品详情页图片并归档到本次选品的物料库 | P0 |
|
||||
| 选品 | 记录 | 历史选品 | 保留历史选品记录,支持再次调用 | P1 |
|
||||
| 图片制作 | 执行参数 | 品类 / 尺寸 / 模板 | 选择品类、目标尺寸(800×800、1280×720、1080×1920)与套用模板 | P0 |
|
||||
| 图片制作 | 商品类别 | 鞋子 / 衣服 | 选择商品类别后进入对应的展示方式子菜单 | P0 |
|
||||
| 图片制作 | 展示方式 | 设计导入 / AI 模特 / AI 脚模 | 展示方式由设计人员后续导入,制作时选择拼接方式 | P0 |
|
||||
| 图片制作 | 商品位置 | 固定位置 / AI 调优 | 可选固定商品位置,或交由 AI 自行调优构图 | P0 |
|
||||
| 图片制作 | Logo | 主 Logo + 副 Logo | 组合式 Logo,支持拼接方式与拼接字符(字符需上传) | P0 |
|
||||
| 图片制作 | 促销信息 | 折扣 / 活动标识 | 可上传促销信息模板并叠加到图片 | P0 |
|
||||
| 图片制作 | 导出 | 按路径导出 | 制作完成后按指定路径导出成片 | P0 |
|
||||
| 图片制作 | 批量 | 多图制作与预览 | 一次选品批量出图,产出前可预览 | P1 |
|
||||
| 视频脚本 | 脚本管理 | 历史脚本 | 记录与管理已产出的脚本 | P0 |
|
||||
| 视频脚本 | 脚本模板 | 模板管理 | 沉淀可复用的脚本结构 | P0 |
|
||||
| 视频脚本 | 脚本分析 | AI 分析 | 对脚本做 AI 分析,产出分析结果并生成模板 | P0 |
|
||||
| 视频脚本 | 脚本生成 | 选品 + 模板 + 数量 | 选择本次选品与脚本模板,指定生成数量后产出脚本 | P0 |
|
||||
| 视频成片 | 动作模板 | AI 分析视频方向 | 分析视频方向与动作,形成可复用模板 | P0 |
|
||||
| 视频成片 | 视频生成 | 选品 + 脚本 + 模板 + 数量 | 选择脚本、视频模板(含自由发挥选项)与数量,成片存放于指定路径 | P0 |
|
||||
| 素材提审 | 提审标签页 | 待审清单与状态 | 集中查看待提审素材及其状态 | P0 |
|
||||
| 投放信息 | 配置管理 | 加号新增 / 自定义命名 | 按需增加配置信息,配置名称可自定义修改 | P0 |
|
||||
| 投放信息 | 复制 | 一键复制 | 单条配置内容一键复制 | P0 |
|
||||
| 投放信息 | 自动配置 | 拉取配置 / 自动生成链接 | 锚定商品 ID 或官网链接,自动拉取并配置 DP 等链接 | P0 |
|
||||
| 投放信息 | 批量 | 批量修改固定字段 | 对多条配置的固定字段批量替换 | P1 |
|
||||
| 资产 | 统一管理 | 模板 / Logo / 展示方式 / 促销信息 / 脚本 | 人工查看、编辑、停用与选择,并作为制作时的可选项 | P0 |
|
||||
|
||||
#### 1.2.4 优先级说明
|
||||
|
||||
表 1-3 中标注 P1 的为原文明确标注的次优先项:商品名称粗词检索、历史选品记录、多图制作与图片预览、投放配置批量修改固定字段。其余功能按 P0 处理;原文未标注优先级的部分在评审时确认后回填。
|
||||
|
||||
P0 为本期必须交付、缺失则主链路走不通的功能;P1 为显著影响效率、可在主链路跑通后追加的功能。
|
||||
|
||||
### 1.3 成功指标
|
||||
|
||||
指标口径需与数据侧对齐;现状值与目标值待业务方确认后填入。
|
||||
|
||||
**表 1-4 成功指标(KPI)**
|
||||
|
||||
| **序号** | **指标名称** | **定义 / 统计口径** | **现状值** | **目标值** | **观测周期** |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| 1 | 单套图片素材成本 | 图片制作总成本 ÷ 产出套数(元/套) | | | |
|
||||
| 2 | 单条视频素材成本 | 视频制作总成本 ÷ 产出条数(元/条) | | | |
|
||||
| 3 | 单套素材制作周期 | 从选品确认到素材可提审的时长(小时/套) | | | |
|
||||
| 4 | 模板产出占比 | 模板产出素材数 ÷ 素材总数 | | | |
|
||||
| 5 | 人均日产出 | 素材产出套数 ÷ 人日 | | | |
|
||||
| 6 | 单账户搭建耗时 | 从建户到配置完成的时长(分钟/账户) | | | |
|
||||
| 7 | 配置出错率 | 返工配置数 ÷ 配置总数 | | | |
|
||||
| 8 | 一次提审通过率 | 一次通过数 ÷ 提审总数 | | | |
|
||||
|
||||
### 1.4 名词与术语
|
||||
|
||||
**表 1-5 术语表**
|
||||
|
||||
| **术语** | **英文 / 缩写** | **说明** |
|
||||
| --- | --- | --- |
|
||||
| 平台电商 | — | 得物、唯品会等以平台化方式经营的商品销售渠道;本期主要服务这两家 |
|
||||
| SPU / SPUID | SPU | 标准商品单元及其唯一标识;检索主键随平台变化 |
|
||||
| 原始物料 | — | 商品详情页中的原始图片,是图片与视频制作的统一输入 |
|
||||
| 模板(PSD 模板) | PSD | 由设计侧产出、可导入系统的图片版式,含固定警示语等元素 |
|
||||
| 展示方式 | — | 商品在模板中的呈现形式,如 AI 模特、AI 脚模;由设计人员导入维护 |
|
||||
| 脚本 | Script | 视频的分镜与文案结构,可由 AI 生成或人工输入 |
|
||||
| 脚本模板 | — | 经 AI 分析沉淀、可复用的脚本结构 |
|
||||
| DP | — | 平台电商账户搭建中需要编写的详情页配置(具体口径待业务方确认) |
|
||||
| 承接页 / 落地页 | Landing Page | 投放落地页,含需填写的配置信息 |
|
||||
| 提审 | — | 素材产出后提交平台审核的环节 |
|
||||
| 配置信息 | — | 账户与承接页所需的链接、字段等,支持一键复制与自动配置 |
|
||||
| 推流 | — | 平台按算法分发的流量;脚本与画面需符合推流偏好 |
|
||||
|
||||
## 2 用户与场景
|
||||
|
||||
### 2.1 目标用户
|
||||
|
||||
描述本次需求直接服务的角色,以及每个角色的特征、诉求与使用频次。
|
||||
|
||||
**表 2-1 目标用户与画像**
|
||||
|
||||
| **用户角色** | **典型特征** | **核心诉求** | **使用频次** | **本期覆盖** |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| | | | | |
|
||||
| | | | | |
|
||||
|
||||
### 2.2 用户场景 / 用户故事
|
||||
|
||||
按“作为〈角色〉,我希望〈完成什么〉,以便〈获得什么价值〉”的句式描述典型场景。
|
||||
|
||||
*▸ 填写提示:每个场景对应至少一条功能需求,填写时在括号内标注需求编号,便于追溯。*
|
||||
|
||||
**表 2-2 用户故事**
|
||||
|
||||
| **序号** | **用户故事** | **对应需求编号** |
|
||||
| --- | --- | --- |
|
||||
| US-01 | 作为……我希望……以便…… | |
|
||||
| US-02 | | |
|
||||
| US-03 | | |
|
||||
|
||||
### 2.3 竞品与参考(可选)
|
||||
|
||||
列出参考的竞品或内部系统,说明借鉴点与差异点。
|
||||
|
||||
| **对象** | **关键做法** | **可借鉴 / 需规避** | **链接** |
|
||||
| --- | --- | --- | --- |
|
||||
| | | | |
|
||||
| | | | |
|
||||
|
||||
## 3 需求范围
|
||||
|
||||
### 3.1 本期范围(In Scope)
|
||||
|
||||
- 【功能 / 模块一】:一句话说明本期交付到什么程度。
|
||||
- 【功能 / 模块二】:……
|
||||
- 【功能 / 模块三】:……
|
||||
|
||||
### 3.2 不在本期范围(Out of Scope)
|
||||
|
||||
- 【明确不做的事项一】:说明原因与计划版本。
|
||||
- 【明确不做的事项二】:……
|
||||
|
||||
*▸ 填写提示:明确写出“不做什么”比写“做什么”更能防止范围蔓延;每条注明原因与预计版本。*
|
||||
|
||||
### 3.3 假设与约束
|
||||
|
||||
**表 3-1 假设与约束**
|
||||
|
||||
| **类型** | **内容** | **若假设不成立的影响** |
|
||||
| --- | --- | --- |
|
||||
| 假设 | | |
|
||||
| 约束 | | |
|
||||
| 约束 | | |
|
||||
|
||||
## 4 功能需求
|
||||
|
||||
### 4.1 功能清单
|
||||
|
||||
全量列出本期功能点,作为范围基线与排期依据;详细描述见 4.2。
|
||||
|
||||
**表 4-1 功能清单**
|
||||
|
||||
| **编号** | **功能模块** | **功能点** | **优先级** | **需求来源** | **负责人** | **状态** |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| FR-001 | | | | | | |
|
||||
| FR-002 | | | | | | |
|
||||
| FR-003 | | | | | | |
|
||||
| FR-004 | | | | | | |
|
||||
| FR-005 | | | | | | |
|
||||
|
||||
*▸ 填写提示:状态取值:待评审 / 开发中 / 已提测 / 已上线。超过 5 条时复制表格行,保持编号连续。*
|
||||
|
||||
### 4.2 功能详情
|
||||
|
||||
每条功能点复制一份下表,逐项填写;验收标准必须可测试、可量化。
|
||||
|
||||
**表 4-2 功能需求详情(单条需求填写单元)**
|
||||
|
||||
| **需求编号** | *FR-【模块】-001* |
|
||||
| --- | --- |
|
||||
| **需求名称** | *动词 + 对象 + 结果,一句话说清* |
|
||||
| **优先级** | *P0 / P1 / P2* |
|
||||
| **需求来源** | *业务方 / 用户反馈 / 数据分析 / 合规要求,附需求单或链接* |
|
||||
| **目标用户** | *角色 + 特征,如:首次下单的 C 端用户* |
|
||||
| **使用场景** | *用户在什么情况下、为了什么目标使用该功能* |
|
||||
| **前置条件** | *如:已登录、已完成实名认证、账户余额充足* |
|
||||
| **主流程** | *1. ……*<br>*2. ……*<br>*3. ……* |
|
||||
| **分支与异常流程** | *1. 触发条件 → 系统表现 → 用户感知*<br>*2. ……* |
|
||||
| **业务规则** | *校验规则、计算逻辑、状态流转、次数 / 额度 / 时效限制* |
|
||||
| **交互与文案** | *页面与控件、关键提示语、空状态、加载中、失败与超时表现* |
|
||||
| **数据与埋点** | *影响的数据字段、报表、下游系统;新增埋点事件名* |
|
||||
| **验收标准** | *Given …… When …… Then ……(逐条编号,可测试、可量化)* |
|
||||
| **依赖与关联** | *关联需求编号、依赖的上下游系统或团队* |
|
||||
|
||||
### 4.3 业务规则汇总
|
||||
|
||||
将跨功能生效的通用规则集中在此,避免在每条需求中重复描述。
|
||||
|
||||
- 规则一:……(适用范围、生效条件、优先级冲突时的处理)
|
||||
- 规则二:……
|
||||
- 规则三:……
|
||||
|
||||
## 5 非功能需求
|
||||
|
||||
非功能需求必须量化,否则无法验收。下表按类别填写,不适用的类别写“不适用”并说明原因。
|
||||
|
||||
**表 5-1 非功能需求**
|
||||
|
||||
| **类别** | **指标项** | **具体要求(量化)** | **验证方式** |
|
||||
| --- | --- | --- | --- |
|
||||
| 性能 | 响应时间 | 核心接口 P95 ≤ \_\_ ms;首屏 ≤ \_\_ s | 压测报告 |
|
||||
| 性能 | 并发 / 容量 | 支持 \_\_ 并发用户;峰值 QPS \_\_ | 压测报告 |
|
||||
| 可靠性 | 可用性 | ≥ 99.\_\_%;RTO ≤ \_\_ min;RPO ≤ \_\_ | 监控报表 |
|
||||
| 安全 | 权限与数据 | 鉴权方式、越权防护、敏感字段加密 / 脱敏、审计日志留存 \_\_ 天 | 安全测试 |
|
||||
| 兼容性 | 终端与环境 | 浏览器 / 机型 / 系统版本 / 分辨率 / 小程序基础库版本 | 兼容性测试 |
|
||||
| 可观测性 | 日志与监控 | 关键链路日志、核心指标看板、告警阈值与通知人 | 线上巡检 |
|
||||
| 合规 | 法规与资质 | 个人信息保护、行业监管、备案与资质要求 | 合规评审 |
|
||||
|
||||
## 6 交互与流程
|
||||
|
||||
### 6.1 页面 / 功能清单
|
||||
|
||||
**表 6-1 页面 / 模块清单**
|
||||
|
||||
| **编号** | **页面 / 模块** | **功能说明** | **优先级** | **设计稿链接** |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| P-01 | | | | |
|
||||
| P-02 | | | | |
|
||||
| P-03 | | | | |
|
||||
|
||||
### 6.2 核心流程图
|
||||
|
||||
插入主流程图、状态流转图或时序图,图下标注图名与绘制人。
|
||||
|
||||
| *【在此插入流程图 / 状态图 / 时序图】* |
|
||||
| --- |
|
||||
|
||||
### 6.3 状态与异常处理
|
||||
|
||||
**表 6-2 状态与异常场景**
|
||||
|
||||
| **场景** | **触发条件** | **系统处理** | **用户提示 / 兜底** |
|
||||
| --- | --- | --- | --- |
|
||||
| 空数据 | | | |
|
||||
| 网络异常 | | | |
|
||||
| 权限不足 | | | |
|
||||
| 重复提交 | | | |
|
||||
| 超时 | | | |
|
||||
|
||||
## 7 数据与埋点
|
||||
|
||||
明确“上线后如何判断成功”,与 1.3 的成功指标一一对应。
|
||||
|
||||
**表 7-1 数据指标定义**
|
||||
|
||||
| **指标名称** | **定义 / 统计口径** | **目标值** | **数据来源 / 报表** |
|
||||
| --- | --- | --- | --- |
|
||||
| | | | |
|
||||
| | | | |
|
||||
| | | | |
|
||||
|
||||
**表 7-2 埋点事件**
|
||||
|
||||
| **事件名称** | **触发时机** | **上报参数** | **对应指标** |
|
||||
| --- | --- | --- | --- |
|
||||
| | | | |
|
||||
| | | | |
|
||||
| | | | |
|
||||
|
||||
## 8 依赖与风险
|
||||
|
||||
### 8.1 外部依赖
|
||||
|
||||
**表 8-1 外部依赖**
|
||||
|
||||
| **编号** | **依赖方 / 事项** | **依赖内容与交付标准** | **期望交付时间** | **责任人** |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| D-01 | | | | |
|
||||
| D-02 | | | | |
|
||||
|
||||
### 8.2 风险登记
|
||||
|
||||
**表 8-2 风险登记**
|
||||
|
||||
| **编号** | **风险描述** | **影响** | **概率** | **应对措施** | **责任人** |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| R-01 | | | | | |
|
||||
| R-02 | | | | | |
|
||||
| R-03 | | | | | |
|
||||
|
||||
*▸ 填写提示:概率与影响建议用“高 / 中 / 低”标注;每条风险必须有明确的责任人与应对动作,而不是“持续关注”。*
|
||||
|
||||
## 9 发布计划
|
||||
|
||||
### 9.1 里程碑
|
||||
|
||||
**表 9-1 里程碑与交付物**
|
||||
|
||||
| **阶段** | **交付物** | **计划时间** | **负责人** |
|
||||
| --- | --- | --- | --- |
|
||||
| 需求评审 | | | |
|
||||
| 技术方案 | | | |
|
||||
| UI 设计 | | | |
|
||||
| 开发联调 | | | |
|
||||
| 测试验收 | | | |
|
||||
| 灰度发布 | | | |
|
||||
| 全量上线 | | | |
|
||||
|
||||
### 9.2 灰度与回滚
|
||||
|
||||
- 灰度策略:按〈用户 / 地域 / 流量比例〉分批放量,观察 \_\_ 小时后进入下一批。
|
||||
- 监控与熔断:核心指标劣化超过 \_\_% 时自动告警并暂停放量。
|
||||
- 回滚方案:开关位置、回滚操作步骤、数据兼容性处理、决策人与决策时限。
|
||||
- 上线检查:配置项、数据初始化、公告与客服话术、值班安排。
|
||||
|
||||
## 10 待确认问题
|
||||
|
||||
评审中未达成一致的问题必须记录在此,明确责任人并在约定时间前关闭。
|
||||
|
||||
**表 10-1 待确认问题**
|
||||
|
||||
| **编号** | **问题描述** | **影响** | **提出人** | **期望时间** | **结论** |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| Q-01 | | | | | |
|
||||
| Q-02 | | | | | |
|
||||
|
||||
## 附录 A 参考文档
|
||||
|
||||
| **序号** | **文档名称** | **版本** | **链接 / 存放位置** |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | | | |
|
||||
| 2 | | | |
|
||||
| 3 | | | |
|
||||
|
||||
## 附录 B 评审前自检清单
|
||||
|
||||
提交评审前逐项确认,全部打勾后方可发起评审。
|
||||
|
||||
**内容完整性**
|
||||
|
||||
□ 背景与问题有数据支撑,目标具体且结果可衡量
|
||||
|
||||
□ 成功指标已定义口径、现状值与目标值
|
||||
|
||||
□ 范围与非范围边界清晰,无“视情况而定”的模糊项
|
||||
|
||||
□ 每条功能需求有唯一编号、优先级与可测试的验收标准
|
||||
|
||||
□ 主流程、分支与异常场景(空、错、超时、越权、重复提交)均已覆盖
|
||||
|
||||
□ 非功能需求已量化,并有明确验证方式
|
||||
|
||||
□ 依赖、风险、待确认问题均已记录到人、到时间
|
||||
|
||||
□ 埋点事件与数据口径与指标定义一致
|
||||
|
||||
**文档规范**
|
||||
|
||||
□ 版本号规则正确,修订记录已更新
|
||||
|
||||
□ 术语全文统一,无同义词混用
|
||||
|
||||
□ 表格、图、章节编号连续,图表有标题
|
||||
|
||||
□ 数值、单位、字段名与研发口径一致
|
||||
|
||||
□ 无遗留批注、修订痕迹与灰色提示文字
|
||||
|
||||
□ 已通过评审,结论与遗留问题记录完整
|
||||
Reference in new issue
Block a user