软件系统需求说明书写的经验之谈_项目管理文章库

用户名密码

联盟服务关于我们联系方式收藏本站

PgMP认证，美国项目管理协会高端项目管理认证！大型项目与项目群管理Program Management全球权威认证

服
务
区

网站登录：会员企业专家服务商
企业服务：PMP培训内训课公开课
工具箱：发表文章提问题发案例

首页：动态 | 文库 | 下载 | 书架 | 访谈 | 专栏 | 专题 | 人才 | 培训 | 软件 | PMC

互动：活动 | 案例 | 问答 | 论坛 | 博客 | 圈子

应用：基础┊工程┊软件┊制造┊活动┊研发认证：PMP┊NPDP┊ACP┊PgMP┊IPMP┊P2┊ISPMP┊IMCP┊建造师┊MPM 特色：热点┊奖项

适合敏捷开发项目
敏捷项目管理最佳实践

重视项目商业分析
商业价值与需求分析能力

产品管理国际认证
全球产品管理最佳实践

单项目管理经典指南
年轻项目经理首选

北京 | 直播 | 录播

大型复杂项目全球标准
定位高级项目管理层

链接战略与项目
实现组织资源投资回报

信息系统项目管理师
系统集成项目管理工程师

计划 | 报名 | 经验

当前位置：文库首页 >> 文章内容

软件系统需求说明书写的经验之谈

作者：佚名提交人：项目管理者联盟[佚名] 属性：提交人转载发布时间：2009/1/7 点击：2751 【收藏本文】

　　软件工程中明确定义了，最为一个软件需求说明书的任务，它是一个沟通客户和程序员的纽带，是一个对于系统将要干什么的详细描述。因此，在这个文件中，必须包含很多内容，最近几天，我一直在阅读一份很奇怪的需求说明书和设计说明书，这两份资料里，不但没有系统流程说明，而且没有概念定义，需求说明书先写系统与其他系统关系，然后是系统菜单，后写菜单内容，最后写设计的表结构，我连软件对应的实体有几个都没弄清。设计说明书中，先写系统目的和产生原因，后写定义的数据和功能界面设计，我连设计的那些表哪些是其他系统定义的，哪些是自己生成的，数据如何关系都不知道。就这样两个文件，要设计程序代码，读得我这个头疼啊！ PgMp.mypm.net
转自项目管理者联盟
　　下面是我根据我历史曾经做过几个管理软件系统的需求分析与设计的经验，写的心得，希望能给大家以帮助。 www.mypm.net
club.mypm.net
　　一个需求说明书，必须包含以下内容：转自项目管理者联盟
项目经理博客
　　1、必须包含系统建立的背景资料，目的和参考资料索引以及附带相应的参考资料文件。这部分信息看上去似乎对于软件开发没有直接关系，但是，它就象我们吃一道菜必须有盘子一样，必不可少。它首先告诉读者，这个说明书依据什么而写的。 PgMp.mypm.net
项目管理者联盟
　　2、必须包含系统的简单介绍。简单介绍最好能用图片说明，或者不要超过200字。就象文章的关键词一样，系统简单介绍是让人们快速把握系统是什么的关键内容，使阅读者有一个概念。这就象一个菜的名字/简介一样，简单，易于掌握。项目管理培训
项目管理培训
　　3、必须包括系统的范围、主要完成什么内容、和已经有的或已知的正在建的系统关系是什么？这个关系描述，有两种，一种以业务操作为线索描述操作员在哪个系统做什么，又到另一个系统做什么。还有一个线索，是程序开发角度，一个系统给另一个系统提供了什么，内容是什么，或者系统间用什么方式沟通的等。根据阅读者已经有的共识和知识体系去书写。项目管理者联盟
项目管理者联盟
　　4、必须包括计划安排或开发人员安排。这个内容很关键。也很微妙。因为开发人员有的能力强，有些功能能做，有的能力弱，有些需求他可能不会做。我曾经做过些系统，也写过需求说明书，很多时候，因为开发人员的变动，往往会影响系统计划与质量。因此，一定事先获得开发人员的配置。一般需求说明书在书写开始，是没有这个信息的，只有当需求基本确定后，就可以根据功能范围，由开发团队计划出一个人力预安排，根据这个人力安排，时间安排等来决定系统开发到什么程度与范围。这部分内容，如果放在概要设计时，就有些偏晚。因为需求不应该只是用户想要干什么，很多时候，需求目标是要综合多方面因素来确定的。如果放在概要设计上，就会使一个系统说好完成什么，但实际上却被分出几个阶段来实现，或者需求都谈好了要这样实现，结果开发人员不会做，不得不改变目标甚至流程。因此，在需求说明书书写中，一定要在需求框架基本明晰的基础上，进行开发人员的确认与预安排。预安排的结果要写在文件里，作为一个参考资料。项目管理培训
项目管理者联盟
　　5、必须包含业务/操作流程描述。可以用E-R图，写清楚都牵扯了什么部门，每个角色/实体都怎么怎么样操作的。或者用业务流程图去说明，或者用表格/文字说明。但是必须说明清楚。并且，是需求分析中占主要的部分，尤其是一个新建立的系统，这部分内容可能经常被改动！这是我做过10来个管理信息系统（包括几个大型管理软件）分析设计的经验。这部分内容的改动是恐怖的，尤其是新建立一个系统，各部门先决定这么干，讨论讨论就出问题了，又换一个想法。建立管理信息系统的时候，会引起企业流程重组，业务关系变化，个别操作简化，职能重组，这些都直接引起要建立一个新的流程。所以，如果想让系统做好，就要把这部分内容写的不能再细，说的不能再清楚，同时，还要忍受在与用户讨论、小组分析中可能要不断推翻重写与改动。要经得起各方面推敲。项目管理者联盟
项目经理圈子
　　6、必须包含概念定义。不要小看概念定义，它就象说文解字一样，是解决沟通障碍的关键问题。如果懒得做名词解释，就一定会为它付出代价。代价就是可能会多出去很多问题，多开好几次讨论会，延长整个软件项目实现的时间。甚至，可能程序都做出来，某个功能根本不是用户要的。概念定义一定要定义准确，严谨，反复推敲，避免二义性，要同时能被用户和开发人员读懂。最好定位阅读者具有小学文化。项目管理者联盟
项目管理论坛
　　7、必须包含系统数据流的说明。这部分内容看上去好象是概要设计的内容。其实，在需求报告中，不应该只简单说明有什么什么单子，上面有什么。一定要说明清楚，谁根据什么产生了这个信息，信息里有什么，经过什么途径，又给了哪个位置等。同时，如果流程重组了，可以不描述旧的流程，直接按照新的流程开始说明。这部分不仅可以使阅读者明白详细的系统要求，同时还可以给需求报告书写人员一个整理思路的方式。它可以使需求分析更准确严谨，避免出错，遗漏或避免一些关键点没问清楚。项目管理者联盟
项目管理者联盟
　　8、必须包含界面或其他要求的描述。比如数据精度，界面颜色与布局风格等。很多人尝试在概要设计中，去做这部分内容，其实，有的时候，在需求报告中，也要反应用户的要求。现在很多用户已经具备了比较强的计算机理解与使用能力，他们有时会主动告诉你他要的是上面有什么，下面有什么，左面什么样，右边什么样，哪个地方都怎么样。这是很宝贵的信息，采集并获得用户确认，就可以使系统推广的时候，减少不少阻力。项目管理者联盟
training.mypm.net
　　9、必须包括系统未来的思考。这部分内容主要是作为一个需求调研人员，需求分析后，认为系统现在这样做，还有哪些局限或不足，将来还可以发展成什么样。这部分书写，可以给系统概要设计人员定义系统生存周期、设计数据结构等提供宝贵的参考资料。因此，如果有能力，就要让自己发挥作用，一定别忘了写上。项目经理圈子
项目经理博客
　　在需求说明书的书写中要注意的几个问题与误区： service.mypm.net
PgMp.mypm.net
　　1、不要怕写的多。一定要建立合理的目录结构，使人们可以按照自己关心的部分去阅读。不要怕长，但是语句一定要准确精练。有的时候，阅读者不一定需要第一次就把文件全看完，他首先是有一个概念，然后去某部分仔细确认与查找。要把需求说明书写得象我们的手机使用说明书那样，越明白越细致越准确越好。项目管理者联盟
项目管理培训
　　2、千万不能出现二义性。在需求说明书中，有二义性的语句可能会产生灾难性后果的！所以，作为书写人员，一定要尽量回避二义性，同时做需求报告评审审核时，也要把二义性做为重点消除目标。项目管理者联盟
项目管理者联盟
　　3、写报告前定义阅读者。这个工作可以写在需求说明书里，让每个阅读者都知道，也可以开发小组内部确认就行了。因为实际情况不同，需求说明书可能不是给用户读，也可能是用户与开发人员，还可能是用户、开发人员和某些特殊部门。阅读者的不同，会影响我们说明书的内容与书写角度。看看手机说明书，如果是给用户，一种写法，如果是给维修人员，一种写法，如果是给测试人员，一定是另一种写法，所以，需求说明书书写前，要确认阅读者范围。项目管理者联盟
项目管理者联盟
　　4、一定要在写需求说明书的同时，保留一份书写记录。这个工作看上去没什么，其实，这个工作可以帮助你去清理思路，甚至指导需求分析人员，去问什么，找什么人，系统计划是否合理等。我的记录内容是一个表格，从什么时间开始，到什么时间，做了什么，参与人是谁，内容简介。比如，我接触一个系统，先根据个人经验，写了一个系统框架，以它为第一稿。然后获得了一些电子文件资料，我就会在书写记录里加一行，什么时间，从谁那里获得电子资料，是什么，放哪个目录里了。然后，根据这个电子资料，写了一个改动文件，定义为第二稿，我也会写什么时间，写了第二稿，与第一稿的区别主要是增加/修改了哪些内容。我个人觉得，这个资料对于一个大型管理系统的分析非常有用，前后责任人及项目进度很清晰。项目管理者联盟
项目管理者联盟文章
　　5、讨论会议与流程确认前，一定要写计划及执行结果。内容为有哪些疑问，都是怎么回答的。这个资料可以使需求说明书更严谨，不容易出错，也可以避免一些理解偏差与重复讨论。还可以参考结果进行计划安排。项目管理者联盟
项目管理者联盟
　　6、个人定位要低调。做需求调研和报告书写，必须本着唯物主义，客观的，冷静的观点去书写。同时，还要肯付出，对于反复修改的工作不厌其烦，始终保持耐心细致，扎实认真的态度。这个态度决定说明书的可用性有多高。项目管理者联盟

[相关文章]

[网友互动]

·四招提高项目需求准确性及完整性 (2343)	项目管理者联盟	06-22
·新手项目经理常有的几大错觉，这. (3066)	项目管理者联盟	06-01
·应对需求变更，基实就跟谈恋爱一. (3180)	项目管理者联盟	04-08
·资深PMO和项目经理总结的经验语录 (3147)	项目管理者联盟	04-02
·需求分析师和产品经理都有哪些不. (1715)	项目管理者联盟	03-28
·软件项目管理各环节常见问题及解. (3123)	项目管理者联盟	03-14
·如何避免需求遗漏？ (6269)	项目管理者联盟	03-04
·项目集管理PgMP认证备考经验，看. (3839)	项目管理者联盟	02-25

02-28[帖子] 实测半年后，我彻底被易趋项目管理软件. (402)
01-13[帖子] 项目管理专家：易趋项目管理软件“C位出 (734)
12-15[帖子] 制造行业项目管理工具选型经验分享（简. (953)
11-11[帖子] PMI项目管理大会落幕，易趋IPD实战核心. (1034)
09-28[帖子] IPD产品研发项目如何借助专业的项目管理 (1135)
09-12[帖子] PMO的价值重塑：从“经验决策”到“数据 (928)
06-16[帖子] 来自技术面试官的忠告：0-3年经验程序员 (706)
06-16[帖子] 中小企业怎么选择合适的项目管理软件？ (1326)

[发表评论]

本站热点

·从《PMBOK指南》第八版看项目经理角色
·国际项目管理奖项PMI(中国)项目管理大
· 华师大CTO学院：科创生态建设与创新项
·宏发电声江玫瑰谈PgMP：“下好一盘棋”
·PgMP：交付能力与创造未来的项目管理方
·开放讲座|《项目组合管理与PfMP认证》
·开放讲座|项目组合管理与PfMP认证
·开放讲座|PgMP：项目管理思维与方法论
·开放讲座|《项目组合管理与PfMP认证》

栏目说明

《文库》栏目为项目管理者联盟网站核心栏目，收录了十大行业项目管理文章5000余篇，囊括了项目管理五个阶段、九个知识领域的相关文章，是广大项目管理爱好者学习的知识库，欢迎大家发表原创文章、转贴文章，或直接发给编辑。须联盟会员且登陆后才能发表文章。

项目管理活动

活动QQ群：531390275
免费积累PDU,仅500人
2022年项目管理活动计划
2021活动精彩回顾

原创排行榜

项目管理评论杂志	311	高扬	106
乔东	100	项目管理	84
高国伟	61	人月神话	60
张为	59	郭致星	52
蒋昕炜	46	肖杨	38
曾伟强	37	潘德有	36

搜索文章

关键词：

行业：

团队成本风险进度
沟通采购质量合同

更多>> 专题集锦

企业项目化管理

PMO实践与应用

如何处理项目客户关系

经理访谈

个人专栏

王树文

赵春明

高国伟

项目管理者联盟特刊

	联盟特刊是对网站会员发行的内部刊物，刊物内容包括：案例及分析等，得到了会员好评。
电子期刊：
特刊下载：
2017合刊 2016合刊 2015合刊 2014合刊 2010合刊 2009合刊 2008合刊 2004合刊 2005合刊 2006合刊 2007合刊

施工企业管理

	《施工企业管理》创刊于1986年1月，中国施工企业管理协会主办，是反映施工企业管理杂志。
浏览往期：

建造师杂志

	《建造师》杂志由清华国际工程项目管理研究院主办，是中国面向建设企业管理人的高端杂志。
浏览往期：

如转载本站文章，必须于文章开头处注明转自“项目管理者联盟”，并注明原作者

PMI,Project Management Professional, OPM3, PMBOK, PMP，PgMP，PfMP，PMI-ACP，PMI-PBA
and the PMI Registered Education Provider logo are registered trademarks of the Project Management Institute, Inc.