如何出色地撰写 B 端产品需求文档

01 如何解读需求文档

在产品经理的天地里,从无“轻松”可言

需求文档写得不佳会遭人指责;

需求沟通不畅会遭人指责;

客户服务不到位会遭人指责;

之所以谈及这个话题,是鉴于近期自身撰写需求文档以及目睹其他产品经理所写的需求文档,从而想探讨一下需求文档究竟该如何撰写。

需求文档,亦称 PRD,简称产品需求规格说明书,乃是用于记录产品自需求描述至原型与方案设计的一份文档。其主要服务对象涵盖研发、测试、UI、项目经理、业务方等,用于进行需求传递以及组织过程资产的沉淀。

为何 0 – 3 岁的产品经理需要精心撰写需求文档?而 3 岁之后的产品经理就无需追求完美的需求文档了吗?

在此,我略抒己见:

先看第一个问题:0 – 3 岁的产品经理作为初入职场的新人,用心依照需求文档模板(后文提供)编写文档,是一种训练并提升思维的技能,能让你养成从需求概念至方案设计的标准化流程,实现对需求的宏观把控,有效增强逻辑能力、细节把控能力,避免需求文档元素的遗漏,以免造成返工。

再看第二个问题:产品经理的工作精力主要应当投入到思考、分析、规划以及沟通协调当中。例如,业务的本质为何,行业的发展趋向怎样,产品的定位是什么,竞品有何举措,用户的群体结构状况如何,产品要如何运营和推广,产品数据情况怎样,产品 1 – 3 年的规划以及未来的目标。

02 需求文档提纲

本文重点介绍

Word 文档中日常需求文档的撰写方式。

下面给出一篇需求文档的范例提纲:

此提纲主要是将需求和方案清晰阐述,传递给研发、UI、测试、项目经理等人员

,本文基于把事情阐释明白,不拘泥于形式,文档主要记录必须向研发人员讲清楚的内容,不推崇事无巨细的范例,如此一来,阅读者累,撰写者也累,真正的价值难以产出。

大家要明白不同公司不同产品的范例都会存在差异,适合自身团队的范例才是最佳的。最为理想的境界是产品经理将需求和方案讲述一遍,在白板上绘制个草图,团队就能着手工作。

03 案例拆解

了解了需求文档提纲后,接下来我们逐步拆解文档结构,通过案例的形式使我们对每个章节的内容理解更为深入。

在撰写之前,务必想清楚,想清楚,想清楚!

①需求:

主要解决何种问题?

用户是哪些群体?

方案是什么样的?

需要多少资源?包括研发、UI、测试、硬件等

预期的结果是怎样的?

存在哪些风险和注意事项?

②文档:

使用者是何人?如产品人员、研发人员、UI 人员、测试人员等

文档形式?是 Word 文档还是原型图加注解或者 excel

案例示例:《ASN 预约需求规格说明书》

标题:本篇需求文档的核心关键字和题目,例如《ASN(送货通知单)预约需求规格说明书》

修订记录:这部分内容主要记录文档修订的内容以及版本日期,方便追踪文档的调整逻辑,更好地理解当前功能。比如,

版本

日期

编制/修订

审核

批准

修订内容

V1.0

2020.12.2

Robin

李四

王五

初稿

V1.1

2020.12.5

Robin

李四,张三

王五

修订稿,修改关单流程

V1.2

2020.12.8

Robin

李四

王五

评审稿,调整 SAP 接口逻辑

第 1 节:需求描述

1、目的:阐述当前需求的背景和目标

2、内容:对需求进行主要描述,包括:

业务场景:依据场景来描述需求,例如,ASN 送货单,ASN 退货单

适用范围:适用的组织范围、物质类别

价值目标:提升工作协同效率

功能描述:概述该需求的主要功能点,例如增删改查、导入导出、接口对接等

3、如何做:通常是调研用户需求,在需求分析后,得出用例图,便能明确用户的主要动作,进而编写 word 文档或 EXCEL 文档

4、案例分享:ASN 预约需求描述

业务场景

:①正向发货:供应商接收订单并予以确认后,能够直接预约出货,通知仓库具体的到货日期,仓库审核后,供应商安排送货。仓库收到货物进行收货,上架。②逆向退货:供应商接收退货订单并进行确认后,可以直接预约退货,通知仓库具体的退货日期,仓库审核后,供应商安排退货,仓库退货并配货出库。

适用范围

:所有订单类型

价值目标

:提高供应商与仓库的协同效率

功能描述:创建 ASN 单,审核 ASN 单,推送 ASN 给仓库,仓库收货,上架等

第 2 节:业务流程图(重要)

1、目的:描绘需求的业务流程,涉及哪些岗位、动作、输入和输出,涉及的系统边界,例如,ASN 预约单涉及到 SRM 系统、OMS 系统、WMS 系统等

2、内容:L3 或 L4 级别的业务流程图

3、如何做:调研业务现状,基于现状流程规划未来业务流程,并用 visio 记录下来

4、案例分享:

(1)L3 级别的流程图,主要描述当前功能在子领域全流程中的环节,便于阅读文档的人员有整体的认识。

(2)L4 级别流程图,主要描述当前功能的业务流程,便于清晰了解当前功能的业务流转和信息流转。另外,清晰界定了需求的业务流程所涉及的系统边界、操作岗位、输入、输出文档或数据。

第 3 节:原型图和逻辑说明(重要)

1、目的:以图形化的形式展示原型界面,以及界面之间的交互逻辑;明确具体功能点的逻辑说明。比如,原型界面跳转,字段是文本、数字,还是日期,长度如何,数据来源在哪,计算公式是什么?

2、内容:

(1)原型界面级交互

(2)逻辑说明:

交互逻辑:页面的跳转、布局、界面的显示和隐藏等等。

操作功能:增删查改、审核、反审核的字段、业务逻辑说明,包含下一步等下推的详细业务逻辑。

业务逻辑:界面的业务规则及逻辑说明、过滤条件说明、字段的显示隐藏等等。

状态说明:若存在则写,不存在则不写;单据状态和业务状态—汇总整体的状态和权限说明书

(3)权限说明:功能权限和数据权限,全局、组织(采购组织、部门)、本人的权限要求和说明

3、如何做:

(1)基于业务流程、角色操作、输入和输出分析出每个节点应具备的功能要素,利用 Xmind 绘制出信息架构图;

(2)原型界面一般建议使用 AXURE 即可,其他还有 Sketch,MockPlus 等;

(3)逻辑说明要简洁明晰,具体到流程、字段、计算公式上,复杂的计算逻辑,可以列举实例。

(4)状态说明强烈建议用 UML 的状态图来说明,这样能够很清晰地知晓什么动作触发了什么状态,文字表述往往难以说清,研发和测试人员看着也累。

4、案例分享:

(1)基于业务流程、角色操作、输入和输出分析 ASN 预约单的信息架构图,如下:

ASN 预约单包括列表页,详情页。列表页列举了查询条件,操作按钮,展示信息;详情页列举了操作按钮,输入信息,表格,附件等元数据

(2)基于业务流程、操作角色和信息架构图,绘制出每个节点的原型图,并完成原型图之间的交付设计。比如,创建 ASN->ASN 预约单详情页。

交互逻辑

:在采购订单列表页,通过选择一个或多个采购订单,点击【新建 ASN】生成 ASN 预约单

操作功能:新增 ASN、修改、提交、确认等操作。下面列举一个操作功能的例子:

【新增 ASN】基于采购订单新建 ASN,需校验:

1)

需要做交期的订单,取订单业务状态为交期确认、ASN 预约、收货中且交期数量不为 0 的订单。若为 0,提示“订单业务状态为交期确认、ASN 预约、收货中且交期数量不为 0 的订单,才能创建预约单”;若不为 0,正常下推

2)

不需要做交期的订单,取订单业务状态为已确认、ASN 预约、收货中且订单剩余数量不为 0 的订单。若为 0,提示“订单业务状态为已确认、ASN 预约、收货中且交期数量不为 0 的订单,才能创建预约单”;若不为 0,正常下推

3)ASN 弹窗页面,创建维度字段,默认勾选采购订单维度;采购订单编号,默认为下推的订单编号;点击【获取明细】按钮,根据以下过滤数据:a)

过滤订单属性为在建工程和项目类别为 D 的订单数据;b)

需要做交期的订单,取订单业务状态为交期确认、ASN 预约、收货中且交期数量不为 0 订单;c)

不需要做交期的订单,取订单业务状态为已确认、ASN 预约、收货中且订单剩余数量不为 0 订单。

4)点击【确认】,以采购订单仓库代码+预约交货时间+ASN 类型+收货类型(SAP 收货/云仓收货/其他)+订单类型+订单来源+工厂相同的生成同一 ASN。

状态说明

:描述 ASN 流转过程中的状态变化,建议用 UML 的状图展示,如下图:

权限说明:描述当前功能使用角色的功能权限和数据权限,B 端产品往往基于岗位角色使用,需区分权限数据隔离。

第 4 节:字段说明(重要)

1、目的:描述当前需求涉及单据的字段类型、长度、数据来源、计算公式等信息

2、内容:字段类型、字段值、数据来源、公式、长度等

3、如何做:按照业务需求和产品标准设计字段信息

4、案例分享:本篇列举 ASN 单据的几个字段信息以供参考

页面

字段名称

是否必填

字段属性

控制字段

控制规则

基本信息

ASN 单号

文本

系统带出

根据编码规则自动生成

ASN 类型

枚举

系统带出

枚举值:送货单、取货单;根据订单类型关联展示

预约交货时间

日期

手动选择

只能选择以当前时间为起点的 10 天的时间,例如当前 1 号,只能选择 1 – 10 号之间的时间

收货仓库名称

F7

手动选择

根据新增 ASN 弹窗中对应的采购订单仓库名称字段显示,可修改,修改规则同新增 ASN 弹窗中的字段逻辑

第 5 节:接口说明:

1、目的:描述当前需求涉及外围系统所需的接口清单和参数信息。

2、内容:接口清单,接口名称,入参和出参

3、如何做:按业务需求和业务流识别需对接的外围系统,讨论并确定外围系统接口名称和参数

4、案例分享:本篇分享一个简单 ASN 关单的接口

入参:ASN 单号

出参:处理结果(result)、是否已收货(isrecepit)、备注(note)

请求路径:https://xxxxxxx

第 6 节:数据表结构

1、目的:描述当前需求要新建的配置表和字段信息,用于做数据控制,比如下拉选项值,ASN 类型=送货单和退货单,可以新建一个配置表维护 ASN 类型,将来有扩展直接在表里维护即可

2、内容:表名,字段名,字段类型,长度

3、如何做:产品设计时根据需求进行设计

4、案例分享:ASN 类型表

表名:

ASN_table

字段名称

字段类型

长度

是否主键

id

LONG

4

ASN 类型编码

vachar

10

ASN 类型名称

vachar

30

关于数据表,如果没有可以不写,或者直接写描述告诉研发需要什么配置项。

第 7 节:例外作业

主要描述本次迭代未考虑到的场景所带来的影响。例如,ASN 单超时间未收货需要系统自动关闭,本次迭代未实现,需要人为留意。

第 8 节:测试要点

主要罗列测试要点和回归场景。例如,有些功能的上线会对以前的功能产生影响,此时需特别提醒测试人员进行回归测试。

04 总结

1、需求文档的本质在于形而非神。

形相对容易理解,

我们能够通过口述或其他各类方式(文档、excel、图片、白板等等)来呈现自身的需求。产品经理不应受限于形式。

但神才是这一需求最为核心的部分,产品经理要清晰地思考需求真正要解决的问题和价值是什么,投入产出比是多少。

2、借助需求文档的提纲梳理需求落地的方案要素,强化逻辑思维

对于初入职场从事产品相关工作的人员而言,通过模板做到有章可循,在所有元素的对照下,能够避免缺失导致的返工。经验丰富者的关注点不在此。

THE END
喜欢就支持一下吧
点赞7 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容