To G的需求文档怎么写

本篇文章从【什么是需求文档】、【需求文档编写目的】、【需求文档内容】三个方面阐述了我理解的“To G的需求文档怎么写”。

1 什么是需求文档

本文的需求文档可以理解为大家熟知的PRD,在To G的传统IT行业内称之为《需求规格说明书》。与之配套的还有《需求分析文档》,该文档主要为客户调研结果的管理,主要目标用户为甲方客户,暂不在本文的讨论范围内。

2 需求文档编写目的

按照项目大致流程——项目启动、需求分析、开发、测试、收尾、结束,需求文档编写的目的我认为主要有以下几点:

      (1)项目启动---留档:To G的产品是某一个具体项目的产出成果,可以简单理解为是一个工程,在“保修期”内会完成要求的1.0版本,若想要2.0版本,则需要再次签订新的合同。1.0和2.0版本间的间隔可能会比较长,也就意味着会遇到需求分析人员或项目管理人员变更的情况,这时一份好的1.0版本的需求文档可以为后来者做好基础;

      (2)需求分析---备忘录:好记性不如烂笔头,需求分析人员也需要记录下来每一个功能或模块的来源及内容;

      (3)开发---呈堂证供:一旦进入开发阶段,则意味着这份需求已经被各方评审过,没有问题和质疑。开发人员需要依照需求文档进行开发,同时针对开发的成果,可以找到责任人是需求方还是开发方或是某(ling)某(dao)方(ceng),避免无辜背锅;

      (4)测试---测试依据:To G的产品往往同政策文件或是甲方的实际工作流程紧密相关,主要业务流程中的功能是重中之重,因此需求文档中的业务流程是测试的主要依据;

      (5)收尾---验收文档:传统行业的项目大部分通过政府招投标方式获得,需求文档将作为验收文档之一参与项目验收;

      (6)结束---组织过程资产:需求文档在项目结束后将作为公司的组织过程资产,为后期相关业务方向或涉及到相似功能的其他项目提供参考。

3 需求文档内容

从需求文档的编写目的中,可以抽取出需求文档的大致结构,如下图所示。(其中标注黄色感叹号的将在下文进行详细说明。)


需求文档内容结构图


3.1 数据分析

数据分析主要包含两大部分:已有数据的情况及支撑系统正常运转所需的数据情况。

需求文档中该小节需对这两大类数据情况进行详细描述。例如空间数据需求,需对数据名称、格式(TIFF、SHP等)、类型(点状、面状)、坐标系、I查询需求等进行描述。

3.2 业务流程

业务流程不同于系统流程,业务流程是政府端客户在实际工作过程中解决某一问题的现实流程;系统流程是在完成这项业务需求时,可通过信息化系统完成的过程,二者的用户、流程可能存在较大区别。

例如在进行某项审批时,现实生活中需要申请人将相关纸质材料提交至相关政府部门的窗口办理人员处,然后经过窗口办理人员、主任、处长等的各级审批,逐级通过后完成办理。


xxx审批业务流程图

  但在系统中,窗口办理人员在对相关材料审核无误后通过系统录入电子材料,并发送至主任、处长等上级领导审批,逐级通过后完成办理。


xxx审批系统流程图

通过上面的例子可以看出,申请人在业务流程中作为执行者参与其中,但在系统流程中并不存在,因为申请人提交纸质材料给窗口办理人员的过程,系统无法帮助其完成。同时在系统流程中,也去掉了窗口办理人员对申请人提交材料的线下审核过程,录入系统的材料为窗口办理人员在申请人提交时便审核通过的材料。

3.3 功能结构图

功能结构图是对系统各功能结构的整体展现,可直观了解系统结构。

以v1.8.0版本的网易蜗牛读书APP为例进行展示。


网易蜗牛读书APP功能结构图

4 总结

在上述需求文档结构中,并没有提到任何UML相关内容,该部分内容在我的学习范畴中,使用尚不熟练,怕引起歧义,因此暂不表述。



以上是当前我对To G类行业需求文档编写的见解,欢迎讨论!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343

推荐阅读更多精彩内容