信息管理软件需求说明书17

1、软件开发设计规范书的撰写大伙儿好！ 下午的课讲关于软件开发设计规范书的撰写， 一些设 计撰写的提纲、解释，在微软我开发了几个产品，具体规范书包 括什么内容给大伙儿看一下。首先讲定义，作为我们开发治理人员，程序经理，开发治理 企业的领导等等， 到底是应该写什么样的内容， 如何样用它作为 指导，关心我们写软件。写作打算，到底是在撰写开发打算书开 发过程中间，到底要做什么样的工作。撰写的提纲，大伙儿也明 白，做任何情况提纲就仿佛一份参照表似的， 有如此的参照表写 作的时候相对来讲容易的多， 让所有的职员写的时候都按照规范 来写。然后讲一下自己写的实例，最后做一些问答，做一个双向 的讨论。整个软件开发

2、过程是一个相当复杂的流程， 并不是简单的靠 几个设计工程师自己在那边写软件就完， 而是要有从头到尾， 包 括专门多人，不同专家，不同的专业，不同的知识放在一起，最 后才造成一个完善的软件产品。从决定开始，到打算、设计，最 后到写程序、执行，然后还有测试、纠错、保证稳定、发行、部 署、调试，整个过程是一个相当长的过程，并不是一个简单的程 序。要为了保证软件的质量， 能够达到客户满足和满足市场的要 求，专门要紧的工作，早期工作做的越是完善、认真，幸免后面 的工作，由于前面不完善造成的返工，造成的白费，起到关键性 的作用。 大伙儿可能在网上读到在美国软件项目治理的权威， 写 过专门多关于软件治理方面

3、的书， 专门有名一个理论确实是讲他 做过专门多研究和调查， 发觉早期的工作要是没有做好， 而造成 后面工作的返工，带来的白费是巨大的。有类似如此的图表，他 做出的结论， 假如在设计时期出现了问题， 在设计时期假如你没 有及时找到和纠正的话， 到执行时期才发觉， 你会看到三条不同 的曲线， 越是早期的错没有发觉， 最后由于要返工而造成的代价 费用越来越高，假如前面没有问题，到最后只是发觉半个纠错， 花费的代价相当低，因为你是纠错，然后重新测试就完了。但是 假如执行的时候，程序编程编错了，后来重新编，重新测试，那 个费用相对来讲就要高。 假如是设计的时候出现错误， 由于对需 求治理没有治理好， 客

4、户和市场的要求都错了， 开发出来的东西 完全到后面重新执行、重新纠错的话，会看到那个曲线，几乎是 几何形上升的， 成倍的费用的增加。 能够保证操纵产品开发过程 中间的费用增加，早期工作完善，做设计的时候，越早做的越完 善，对操纵后面的消耗起的作用是特不大的。从那个方面讲， 我早上举的例子造房子一样， 造房子的蓝图， 对盖一个房子的重要性，对早期设计的完善作用也是一样的。什么是设计规范书。 大伙儿听过专门多不同的名称， 叫法也 不一样，到底是什么东西。首先它是总结一个软件功能和性能、 使用方案的总结书， 是描述一个产品， 到底该为客户提供什么服务，起到什么样的作用，到底能够完成什么任务，从那个角

5、度对 软件产品做一个总结 , 是提供软件功能和性能以及使用方案的总 结。也确实是讲， 他应该包括的内容是向开发人员专门详细的描 写清晰，那个软件到底应该如何工作，他使用方案的总结，他的 功能性的总结， 而不应该包括产品具体的设计的构架， 到底如何 执行，如何设计， 这方面内容事实上是有不的文档或者文件去总 结的。早上也提到，作为开发团队人员，当设计经理、项目经理 把软件功能定完以后， 真正产品如何开发， 是应该由设计团队人 员去做。在微软有的比较大型的团队，我们有所谓的设计师，具 体开发也开发团队的领队和开发人员， 他们每个人依照功能的描 写总结出来具体设计的执行方案， 那个事实上是不应该写在

6、设计 规范书里的， 因此要理解清晰， 设计规范书是描写产品对客户如 何用，而不是描写那个产品具体开发逻辑如何执行， 那个是和开 发有关系的。 作为设计规范书是项目经理的工作， 确实是要把那 个产品的功能描写清晰。 它该包含的内容和不该包含的内容不要 搞混乱。阻碍设计规范书的因素专门多，首先最重要的是功能需求， 客户对使用软件有它一定的要求， 那个软件应该提供什么样的服 务，该完成什么样的任务，这方面就叫做功能需求。事实上是有 不同的好几个因素来阻碍整个功能需求的，对市场竞争的分析， 我们竞争的对手他的产品有什么样的功能， 从而得出我们产品应 该也有什么样的功能， 甚至功能比他更好， 这是对功能

7、需求的起 3 / 19阻碍因素的。 还有客户之间的回馈， 他讲我那个产品为我的行业 做工作， 那个和明显是客户具体的要求。 还有确实是用户解决问 题的要求， 比如讲他讲我不在乎你那个产品如何开发， 不管你往 常的产品， 或者你开发的产品往常有什么功能， 由于要解决新的 问题，必须加进如此的功能。还有用户所谓的使用方案，他真正 解决问题， 使用的方案流程是如何样的， 由于他商业之间运行有 直接关系， 假如客户商业流程决定是如此的运作的顺序， 你软件 设备也应该要配合客户使用方案设计。 所有这些是最关键的因素 阻碍功能需求， 功能需求也是第一个最要紧的阻碍到设计规范书 该描述清晰的，解决的什么样的

8、问题。除此之外是性能需求， 光描写讲我那个软件按一个键能够写 一个数字还不够， 假如是客户要求我按一个数字， 在 0.3 秒之内 写出来， 或者是我按键以后印出五百万字来， 他显示数据的速度 如何样， 他的要求也是阻碍到设计规范书的。 他包括整个系统的 要求，假如大型的软件，运行的系统，什么样的硬件，什么样的 内存存什么样的网络， 所有这些对性能的需求都起到阻碍。 他的 运行的环境， 到底是有没有兼容不同的操作平台， 不同的操作平 台之间不同。对软件的功能也是起到阻碍的，还有安装部署，特 不是大型的系统， 因为我在搞工业操纵专门多年也明白， 安装部 署的要求， 软件在实验室完成跑到真正大型的工

9、厂里， 完全是另 外一回事。环境的安装部署要求，在专门脏的环境里，边上有各 种干扰的因素，在如此的运行如此的软件，性能是不是有保证， 保证可不能死机， 数据可不能出现什么错误， 或者出现错误有什 么样的反应，这些都会阻碍到开发软件的要求。 还有是质量要求， 有一部分是能解决的， 还有一部分是不能解决的， 中间的质量要 求是碰到什么情况能够应付， 碰到什么情况如何应付， 这些不同 的用户都会有详细的要求， 这些差不多上规范设计书应该总结的 内容。除了这些以外， 还有非功能的要求， 然而在设计的时候非得 考虑到，包括地区、行业，甚至国家在某一个行业里的标准。象 在欧美市场上，每个行业都有自己的标准

10、。假如你是设计软件， 为某一个行业设计， 里面软件设计接口标准， 可能使用数据规范， 关于专门多标准，假如你是对那些不熟悉，或者是不了解，甚至 是用错的话， 开发出来不符合那些客户要求就要改。 这些和真正 产品的功能毫无关系， 但是要为了保证在以后产品开发出去幸免 如此的错误， 由于如此的错误重新返归， 就要把这些要求了解清 晰。技术还有技术开发的局限，你想如此开发，你想提供如此的 功能，然而首先得了解，目前客户所用的设备的硬件，或者他的 运作的操作系统环境， 有没有某些局限， 你想开发性能的时候他 没有方法达到， 把这些情况弄专门清晰的话， 幸免和客户讲不清 晰的争论。在描写功能的时候，那个

11、功能有什么样的能力，没有 什么样的能力，描写的专门清晰。还有对时刻的依靠， 对外在因素的依靠， 那个地点面是需要 时刻的。项目治理上所谓三角形的定理，有这么多时刻，你有这 么多资源只能开发出这么多功能。 假如把你的时刻砍掉一半， 其 他因素不变的情况下，绝对不能按时刻、质量研发出来。这些都 会阻碍到你设计规范书的撰写， 你要写得专门清晰， 软件开发哪 些能力我是能够完成的， 哪些是不能够完成的。 还有可用性的需 求，软件为了要赢得客户的心， 赢得市场的心， 专门要紧的一点， 不光是把软件开发出来大伙儿能够用， 客户用了可不能觉得专门 混乱，依旧专门闹心，依旧用起来专门顺手，那个地点面的可用 性

12、，这些东西也是专门重要。 什么因素决定可用性， 用户的特点， 不同的用户， 不同的使用者， 也会决定软件开发应该按照适合他 们的要求。 开发出来的软件是给一些专门的设计人员用的， 那些 人受过高等教育， 差不多上专门熟悉的， 和你开发出来给爷爷奶 奶用，那个地点边不同的客户，都有专门的特性，因此在微软把 不同的使用者， 分成不同类型的组群， 那个地点的要求如何回事。 所有这些差不多上阻碍到可用性需求。 整个设计规范书在描写完 善的软件过程，这些都要考虑到。你不考虑的，不在乎的就去写 软件，等你开发出来这些搞错的话，一定阻碍软件最后的质量。软件规范书的读者， 规范书是干什么的， 为谁而写？作为开

13、 发治理人员项目经理到底做什么工作。第一个是给开发团队用 的，构架设计、开发执行的打算。开发团队是第一位读者，需要 拿那个来盖房子。除此以外，测试团队，在定测试打算的时候， 也是依照你对功能的描述。 因此假如一个软件里调出一千多个功 能，就要定一千多，甚至三千、五千相对应的测试方案。测试团 队也是设计规范书的读者。 文档团队， 要让客户能够专门方便的 了解、熟悉你那个软件的产品， 专门要紧一点你要有所谓的专门 使用手册，假如软件是推向市场的，给爷爷奶奶用，从来没有用 过那个软件的， 看一个讲明书如何样能够关心这些没有技术水平 的人在专门短的时刻内用这些软件。 文档协作专门重要， 编辑的 人也不

14、明白计算机， 只能描述那个产品， 他们所需要的内容也是 从那个地点来的。 可用性团队， 他们要用产品找一些客户到内部 进行调查， 他们如何设计测试， 可用性的案例？他们也是要依照 设计规范书的内容决定。 最后确实是市场营销团队， 当你有一个 完整的设计规范书， 营销产品的时候， 当产品完了以后向市场进 行推销的时候， 营销人员会比较清晰的了解， 那个产品到底有什 么样的功能， 能够完成什么样的任务， 然后向宽敞市场描写那个 产品有什么好处。因此你看到设计规范书一般是为这么多团队， 这么多人服务的。还有给客户领导，在你产品还没有开发之前， 在你和客户交流的时候， 我们在某一个产品， 为他们专门设

15、计的 软件，在开发之前，并不是签一个协议，告诉我写一个东西，然 后就开发了。 开发之前假如有一个专门完整的规范书， 让客户从 头到尾把我整个开发的打罢了解清晰， 开发的内容， 我要提供的 功能，能够提供的，不能提供的写的专门清晰的话，他看了以后 就会明白符不符合他的要求。 关心客户了解整个开发的打算， 他 给你进行回馈， 帮你做调整， 领导能够依照那个对整个项目进行 跟踪。假如你都写清晰了，作为企业的领导，能够从高层次领导 整个开发的打算， 跟你原来的打算， 定的时刻表能够明白什么时 候能够完成。 因此起一个专门好的交流作用， 关心团队和领导之 间保持一致。在写规范书通常要通过什么样的步骤， 做什么情况能够达到 最后的结果？在你正在写之前，首先需要确定你要解决的问题， 最要紧的是从市场需求来了解， 我那个软件到底该做什么， 那个 软件是什么缘故样人服务的， 做什么样的情况。 定出你所要的功 能之前，首先先要了解使用方案， 三步法，明白客户的使用方案， 从那个得出你的需求到底是如何样的。然后依照体的需求总结， 定出你要设计的功能到底是哪些。 由这些需求、 总结定出这些功 能，最后依照三