为什么需要功能需求设计说明书

为什么需要功能需求设计说明书

在没有功能设计文档时，主要有如下几个问题：

• 前期研究团队沟通成本

  如何要让团队里面的所有人员对软件产品的功能需求设计有一个共识？没有功能设计文档，反正我是想不出有什么办法。当该项目的团队人员越多，沟通成本就变得很高。 
  
  研发人员很容易有一个通病：以为自己了解了一小块需求就立即开始埋头狂撸……代码。最终很可能与项目经理和客户真正想要的功能相差甚远。
  
  更可怕的，研发人员把数据库设计好了，代码也已经写得差不多了，这时产品狗突然跑到程序猿这，说我们的需求要做一点变化，大家都知道，“对产品狗来说那一点变化，可能会害得程序猿撸过几天几夜”。那很小的变更可能导致之前设计的数据库，码的代码都不能用了。对于程序猿没有什么比加班加点写了几个月的代码，最终被产品狗告知需求变了，代码要删除重新写更可怕的。估计只能用涨工资来安慰一下那受伤的心灵了。   
  
  还有一个比较隐藏的事情是，每个程序猿都认为自己写的代码很牛逼（其实对于大多数人这只是一个错觉，你写得代码并不优秀），不太愿意删除之前所写的东西，总是想在原有的代码基础上进行修改，让他们删除代码比杀了他还难。   
  
   作为公司的技术负责人，我每几天都会Code Review团队里面所有人的代码，一直要求他们把不用的代码去掉，但他们的应对方式总是加两个//。注释掉他们写的代码，而不是去做真正的删除动作。他们总有自己的理由，“这只是暂时注释掉，后面会用到”，但最终的结果是那些代码就像尸体一样，一直在那里，干扰着团队人员正常的思路。所以我只能强制性让他们那些“暂时没有用，以后会用到的代码”干掉 。
  

• 前期任务进度安排和分配

  该文档也是任务进度安排和分配的重要依据。在没有功能需求设计文档之前的所有任务进度计划都是瞎扯淡，都不知道具体要做什么东西，哪能拿出合理的任务进度计划。如果你拿出来了，我也不相信那是经过认真分析做的进度计划，我知道那只是用来看领导看的。 
  

• 中期产品经理需求变更

  软件在开发过程中难免会遇到功能的需求变更，将程序猿们召集在一起把所有的变更讲一遍？当走出会议室的时候可能每个人都有自己的理解。下一场战争已悄然临近…
  

• 后期测试团队产品测试

  测试团队应该在项目Kickoff之时就应该介入，而不是在产品开发完成之后。测试团队应该对功能需求设计文档充分了解，且以此来编写具体的测试用例文档。否则，只能是在界面上进行简单的表面测试，而真正的BUG并不在表面，这些BUG会藏得很深，等发现的时候可能已经造成很大的损失。测试团队想覆盖全部的测试用例此时已经相当困难，他们甚至都不知道产品有哪些功能。  
  

  测试用例应该尽可能详细，尽量保证测试用例走完能确保产品能上线发布。下图为我们在登录注册时用到的一部分用例：

  

---

文档应该放在何处

功能说明文档一定要保持实时性，任何变更的需求，新增的需求都必须在该文档中体现。

一只产品狗（或一群）在编写完文档后，要发给项目经理、研发人员、销售人员、运营推广人员等人，如何保证每个人的文档都是最新的呢？如果通过QQ，邮件等方式，是不是每次更新都要重新通知所有人：“嘿，各位兄弟，文档作了一次修改，我给大家都重新发一份新的”。每个人电脑里面都有好几个版本的文档，时间长了，自己都忘记哪个文档是最新的；产品狗也记不清是否是所有相关的人都发了最新的文档。

研发人员可能会说通过SVN来作版本管理啊，给每个人分配一个帐号。“天啊，SVN是啥？”-销售人员、运营推广人员估计一脸懵逼。

更好的办法是通过团队实时协作的云端工具。从而实现分享和实时讨论，告别反复修改版本再发送邮件的麻烦。如果你会FQ，那你可以使用Google Docs、Office Online。否则你可以使用石墨文档、一起写。

---

什么是功能需求设计文档 & 应该包含那些内容

功能需求设计文档最重要的是描述产品所要包含的所有功能，越详细越好，可以结合产品的原型设计图来讲解。让项目所有相关人知道产品是什么，包含哪些页面，页面如何跳转等。

该文档是产品经理、项目经理、研发人员、销售人员、运营推广人员沟通的一个桥梁，一份好的功能需求设计文档是软件产品是否能成功的关键。

考虑是该文档的受众，这份文档不应该包含具体的编程技术上的说明。不管你是用C#/.NET、JAVA还是其它，这应该是另外研发团队内部使用的一份文档。

一般人第一反映就是去网上找一份功能需求设计文档模板，我个人感觉那些模板90%根本没有存在的必要。都太过形式化，不要没有实际意义和模板化的内容，只会使文档成为一个摆饰，反而是在浪费大家的时间。

那么一份合格的软件需求设计文档应该包括哪些内容呢？

1. 项目背景

    项目产生的实际背景、具体的运用场景、大致要解决什么样的问题、针对的阅读对象、版本修改记录、文档作者以及修改人信息。

2. 详细的功能点描述 

    写明产品所包含的所有功能点，对功能、界面、接口的描述一定要充分详细，每处可以交互的地方都要给出具体的说明。再次强调，一定要详细描述每一个页面所拥有的功能。

3.  产品不包含的功能点说明 

    除了写明产品所包含的所有功能点外，还应该写明软件所不包含的功能，这一点也很重要。

4.  使用场景（画面感） 

    将复杂的业务逻辑融入到具体的使用场景中，更容易让项目经理、研发人员、销售人员、运营推广人员不同背景的人产生共识。

5.  流程图 

    大家都知道“一图胜千言”，能用图说明的尽量用图来说明，只通过大量枯燥的文字可能效果并不太好。流程图是一种用图形表示逻辑和算法的工具，特别对研发人员撸代码很有帮助。
Windows用户可以使用Visio，Mac用户可以使用OmniGraffle，还可以使用免费在线作图,实时协作工具ProcessOn。