01 如何理解需求文档

产品经理的世界没有“容易”两字

• 写不好需求文档被人怼；

• 谈不好需求被人怼；
  

• 服务不好客户被人怼；

谈这个话题，是因为最近写需求文档和看到别的产品经理写的需求文档，想聊聊需求文档如何去写。

需求文档，又称PRD，简称产品需求规格说明书，是用来记录产品从需求描述到原型和方案设计的一个文档。它主要用于使用对象，包括研发、测试、UI、项目经理、业务方等，进行需求传递和组织过程资产沉淀。

为什么0-3岁产品经理需要好好写需求文档？3岁以后的产品经理就不要再追求完美的需求文档了？

我这里抛砖引玉：

先看第一个问题：0-3岁的产品经理是刚入职场的新人，用心的参照需求文档模板（下文提供）编写文档，是一种训练和提升思维的技能，让你养成需求从概念和方案设计的标准化流程，对需求的宏观把控，有效提升逻辑能力、细节能力，避免需求文档元素漏掉，造成返工。

再看第二个问题：产品经理的工作精力主要应该投入在思考、分析、规划和沟通协调上。比如，业务的本质是什么，行业发展趋势，产品的定位是什么，竞品做了什么，用户的群体结构如何，产品要怎么运营和推广，产品数据怎样，产品1-3的规划以及未来目标。

                          02 需求文档提纲

本文主要介绍Word文档的日常需求文档写法。

下面给出一篇需求文档的范本提纲：

这个提纲主要是将需求和方案描述清楚，传递给研发，UI，测试，项目经理的同学，本文是基于把事情讲清楚，不拘泥于形式，文档则主要记录必需给研发同学讲清楚地方，不推崇事无巨细的范本，这样看的人累，写的人也累，真正的价值没产出。

大家要知道不同公司不同产品的范本都会有差异，适合自己团队的范本才是最好。最高的境界是产品经理把需求和方案说一遍，在白板上画个草图，团队就开干。

                     03 案例拆解

知道了需求文档提纲，接下来我们逐一拆解文档结构，通过案例的形式让我们对每章节的内容理解更深。

写之前，想清楚，想清楚，想清楚！

①需求：

• 主要解决什么问题？

• 用户是谁？

• 方案是什么？

• 需要多少资源？研发，UI，测试，硬件

• 预期的结果是什么？

• 风险和注意事项？

②文档：

• 使用者是谁？产品，研发，UI，测试……

• 文档形式？Word文档 or 原型图加注解or excel

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

标题：本篇需求文档的核心关键字和题目，比如《ASN（送货通知单）预约需求规格说明书》

修订记录：这部分内容主要记录文档修订的内容和版本日期，便于追踪文档的调整逻辑，更好的理解当前功能。比如，

第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单据的几个字段信息供参考

第5节：接口说明：

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

2、内容：接口清单，接口名称，入参和出参

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

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

入参：ASN单号

出参：处理结果（result）、是否已收货（isrecepit）、备注（note）

请求路径：https://xxxxxxx

第6节：数据表结构

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

2、内容：表名，字段名，字段类型，长度

3、如何做：产品设计时根据需求设计

4、案例分享：ASN类型表

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

第7节：例外作业

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

第8节：测试要点

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

       04 总结

1、需求文档的本质是形不是神。

形比较好理解，我们可以通过口述或其他各种方法（文档，excel，图片，白板等等）去呈现自己的需求。产品经理不要拘泥于形式。

但神才是这个需求最核心的，产品经理要想清楚需求真正解决的问题和价值什么，投产比多少。

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

对于初入职场从事产品相关工作的同学来说，通过模版做到有章可循，在所有元素的对照下，可以避免缺失造成的返工。老兵的关注点不在这里。