首页 > 编程知识 正文

写文档技巧(大公司的需求文档怎么写的)

时间:2023-05-04 00:11:27 阅读:99612 作者:4719

无论是互联网产品还是IT项目,这一切都是从需求分析开始的。一份好的需求文档通常是项目成功的先决条件,这对于IT产品经理或项目经理来说尤其重要。怎样才能写出一个客户和开发人员都能阅读和满意的文档?

掌握需求分析的方法

需求分析的方法是写需求文档的内在力量;Fkdds曾经教导我们“没有调查就没有发言权”,所以一个假想的需求文档的最终结果也是可以想象的。需求分析的方法有很多种,但最终目的是解决以下四个问题。

是谁提出这个想法的?应该解决什么问题?处理这种想法需要哪些业务?这些业务支持哪些信息?这些企业需要支持什么样的环境?接下来,我将以“XXX校园安全平台的需求”为例。其原始信息来源如下,我将通过需求分析的方法回答上述问题。

XXX学校,希望统计学生出勤率和返校率;并希望用信息技术来管理学生的假期;而且学校了解到目前的AI摄像头可以进行人脸识别,希望将其应用到新系统中,成为他们学校安全的一大亮点。

00-1010在校园安全的需求中,大多数人可以分析以下角色和职责:

但是在这里他们犯了一个错误,混淆了客户和用户的概念。以上分析只是从系统的用户和(最终用户)的角度进行的,但重要的是要知道最终付款人(客户)还是有想法的,所以以上角色和职责要扩展到下表才能更完整。

以上只是通过对原始信息源的分析得到的。在不断的需求访谈或挖掘中,你会发现人员的作用还在不断扩大,这是通过人员之间的关联获得的。所以最终的角色表大致如下:

组织结构图如下:

从上面可以看出,我们应该避免以下错误:

不要混淆用户和客户的概念,优先考虑客户,因为他付了钱并提出了这个想法。在梳理用户角色时,需要考虑相关人员是否也可能在系统中;比如学生-家长、学生-安全有以上角色,业务和业务流程就会有来源,我们就可以开始回答第二个问题了。

方法1:梳理出需求涉及的人员、组织机构及他们的诉求和职责

什么是商业?我的理解一般是我们通常所说的做事的过程或步骤。一般情况下,我们可以根据用户的需求梳理出一般的业务和流程,然后通过一对一的面谈就可以实现你想要的业务。

根据以上用户角色和需求,我整理了以下业务。这里只列出了一部分,没有给出详细的解释。

学生考勤业务:学生通过AI摄像头到校,离校后签到,系统记录相关数据。学生返校业务:学生通过AI摄像头上学,离校后签到,系统记录相关数据。学生请假申请:学生在系统中申请请假并提交给hhdxj学生带着假纸条进出学校。注:由于信息系统的引入,许多原有的业务流程需要重新构建。

例如,由于AI摄像头和平板电脑的引入,学生请假业务的流程将被重新创建,重新创建后的流程如下:

学生在系统中申请休假并提交给hhdxj或者hhdxj直接创建休假申请;考试通过后,当学生在非上课时间离开时,AI摄像头识别出学生后,学生的请假信息会显示在门卫的PAD上。核实后,学生将被允许离校,离校时将信息推送给家长。

00-1010大家分析业务的时候,很容易有正常的流程,但是重要的是要考虑异常流程的处理,因为从来没有人是一帆风顺的,比如下面的异常业务。

返校学生非正常业务:学生在请假时间已过或停课离校后返校,属于正常请假业务的非正常业务。学生不按时睡觉,这也是一种不正常的就寝业务。复杂业务用流程图更直观:有些业务比较复杂,此时用流程图可以清晰的表达业务,与客户沟通时事半功倍。

00-1010任何没有数据信息的业务都是无稽之谈,所以找到业务背后的数据非常重要,那么数据从何而来呢?

收集客户日常流程使用的文档:

在日常工作中,我们经常会看到各种各样的文件。具体来说,在这篇文章中,我们至少可以找到以下两个文件:学生的假期,访客进入学校的登记表,寄宿房屋检查的登记表。

跟踪客户的日常工作,找出他们使用的非正式形式。

注意:原始表单不能直接放入需求,需要处理成数据字典。

例如,请注意:

origin/pgc-image/RhwwjPB1APVJQ2?from=pc">

我们要把他们转换成对应的数据字典或表格如下图所示:

梳理要实现以上业务的环境

按理说,完成了以上的业务梳理后我们对需求有了很深入的了解了,能写出较好的需求文档了。但是我们还要考虑实现这些的业务的软硬件环境,外部接口。就本例而言需要考虑如下的环境。

政策环境:

公安局对校园安装摄像头的要求教育局是否有对校园安全的政策文件等

系统运行的环境例如:

服务器是物理服务器还是云服务器;操作系统使用的是Linux还是,Windows的某个版本数据库需要使用Mysql Oracle Sqlserver的哪个版本物理服务器是否需要硬件防火墙,是否需要牵专线

外部接口:

罪犯的人脸头像库如何提供学籍信息,教师信息,年级班级信息如何提供

通过需求分析,其实我们已经掌握了很多的业务,流程,角色信息等,我们或多或少也使用了一些文档,例如需求访谈表,文档最终的目的是减少沟通的成本,确保能清晰的解释需求。

如果说需求分析方法是写好需求文档的内功,那么规范专业的文档目录及内容,则是写好需求文档的外功。再好的内功,只有使用恰当的外功才能发挥其效果。

需求文档

这里主要介绍三种需求文档的模版及其作用:

原始需求访谈表—记录用户最原始的需求文档;需求规格说明书—对现有业务整理或流程改造后的系统需求文档;需求清单及功能结构脑图—用于时间人力等资源进行估算成本计划。

1. 原始需求访谈表记录表

我们在与用户沟通交流时,每次都有必要做好需求的沟通记录。有了该文档,我们每次的需求访谈的效率和质量才会更高,而避免不必要的瞎扯,浪费大家时间。

需求的访谈记录的格式可包含如下要素:

2. 需求规格说明书

需求规格说明书是对原始需求进行加工后,可供开发使用的文档,所以需求规格说明书的需求是高于原始需求的,对原始需求中的某些内容进行了增删,确保按照新系统的方式进行的业务能满足用户的需求。

好的一份需求规格说明书会节省开发系统设计的大部分时间。需求规格说明书应包含如下结构:

3. 需求清单

需求清单是根据需求规格文档,按子系统,模块,功能进行分解后的功能清单;可以通过脑图进行分解展示,也可以通过Excle文档进行分类确定。

使用脑图便于分析和讲解:

使用Excle文档,方便统计和时间估计:

本文由 @可缓缓归矣 原创发布于人人都是产品经理,未经作者许可,禁止转载。

题图来自Unsplash,基于CC0协议。

版权声明:该文观点仅代表作者本人。处理文章:请发送邮件至 三1五14八八95#扣扣.com 举报,一经查实,本站将立刻删除。