详细设计怎么写

-精选财经经济类资料- -最新财经经济资料-感谢阅读- 1 详细设计怎么写 详细设计怎么写 在大多数软件项目中，要末不作 详细设计，要么开发完成后再补详细设 计文档，质量也不容乐观，文档与系统 往往不能同步，使详细设计文档完全流 于形式，对工作没有起到实际的帮助。 那到底应不应该写详细设计文档 呢，怎么使详细设计文档起到他应有的 作用呢，下面就让我们来认识一下详细 设计及写详细设计文档的好处和问题。 ?什 么是详细设计 详细设计是相对概要设计而言的， 是瀑布开发流程的一个重要环节，在概 要设计的高层设计的基础上，从逻辑上 实现了每一模块的功能，是编码阶段的 -精选财经经济类资料- -最新财经经济资料-感谢阅读- 2 主要参考资料，是从高层到低层、逐步 精化思想的具体实现。 详细设计文档的内容包括各个模 块的算法设计， 接口设计， 数据结构 设计，交互设计等。必须写清楚各个模 块/接口/公共对象的定义，列明各个模 块程序的各种执行条件与期望的运行效 果，还要正确处理各种可能的异常。? 为什么要作详细设计 在开发过程中，由需求及设计不 正确、不完整所导致的问题是项目进度 拖延、失败的一个主要因素，而软件系 统的一个重要特性就是需求和设计的不 断构建和改进，在写详细设计文档过程 中， 详细设计实际上是对系统的一次 逻辑构建，可以有效验证需求的完整性 及正确性。 如果不写详细设计文档，一般就 从概设直接进入编码阶段，这时开发人 员所能参考的资料就是需求规格说明书 及页面原型、数据库设计等，不能直接 进行开发，需要进行信息的沟通，把页 -精选财经经济类资料- -最新财经经济资料-感谢阅读- 3 面原型不能体现的设计讲清楚，这样既 容易遗忘，也容易发生问题，详细设计 文档可以作为需求人员、总体设计人员 与开发人员的沟通工具，把静态页面无 法体现的设计体现出来，包含整体设计 对模块设计的规范，体现对设计上的一 些决策，例如选用的算法，对一些关键 问题的设计考虑等等，使开发人员能快 速进入开发，提高沟通效率，减少沟通 问题。 对于系统功能的调整，后期的维 护，详设文档提供了模块设计上的考虑、 决策，包括模块与整体设计的关系、模 块所引用的数据库设计、重要操作的处 理流程、重要的业务规则实现设计等等 信息，提供了对模块设计的概述性信息， 阐明了模块设计上的决策，配合代码注 释，可以相对轻松读懂原有设计。 ?存在的问题 要由专门的人写，是比较麻烦的， 也是很需要时间的，会对进度造成压力， 也容易形成工作瓶颈，使设计人员负担 -精选财经经济类资料- -最新财经经济资料-感谢阅读- 4 过重，而开发人员无事可作。对于现在 一般的以数据库为中心的管理系统而言， 这个工作始终是要作的，区别只不过是 不是形成专门文档，形成文档可能会多 花一两周时间，但相对于规避的风险和 问题来说，也是值得的，另外由于现在 高级语言的流行，所以更详细的设计应 该直接体现在代码的设计上，而文档则 只体现设计上的一些决策，协调整体设 计与模块设计的关系，把页面原型所不 能体现的设计情况文档化，所以所花费 的时间是有限的。 设计内容容易过细，但设计阶段 是不能考虑特别清楚地，时间也不允许。 对于这个问题，一个对策是上边所提到 的，文档只体现设计上的决策，页面原 型所不能反映的信息，详细设计只体现 总体设计对模块设计的一些考虑，例如 对功能的数据库设计等等，而具体的实 现实现，则到代码中再去实现，相关的 设计也仅体现在代码中。 需求、设计需要不断的被更新、 -精选财经经济类资料- -最新财经经济资料-感谢阅读- 5 构建，则设计文档需要不断的重新调整， 文档的维护需要跟上，否则文档和系统 的同步就很难得到保障了，且造成多余 的工作量。文档的内容易流于形势，质 量糟糕，不能成为开发人员的参考手册， 一是要建立起相关制度，如有修改，先 改文档，后作开发，从工作流程上切实 保障文档与系统的同步，二是要规范文 档质量，对文档该写什么，不该写什么， 标准是什么，粒度是什么，语法应该如 何组织，有明确的标准和考虑，同时， 建立审计文档评审、审核制度，充分保 障系统的使用。 ?应该如何写详细设计文档 下面讨论如何写出一个符合要求、 实用的详细设计文档。 首先是文档的内容，根据项目和 团队的不同，详细设计文档的内容也有 所不同，一般说来，粒度不宜过细，不 能代替开发人员的设计和思考，但要把 有关设计的决策考虑进去，包括与其他 模块、整体设计的关系、操作的处理流 -精选财经经济类资料- -最新财经经济资料-感谢阅读- 6 程，对业务规则的设计考虑等，有一个 标准为，凡是页面原型、需求规格说明 书所不能反映的设计决策，而开发人员 又需要了解的，都要写入文档。 其次是文档所面向的读者，主要 为模块开发人员、后期维护人员，模块 开发人员通过详细设计文档和页面原型 来了解所开发的功能，后期维护人员通 过实际系统、模块代码、详细设计文档 来了解一个功能。 再有就是谁来写文档，因为文档 主要考虑的是设计上的决策，所以写文 档的人应该为负责、参加设计的技术经 理、资深程序员，根据团队情况和项目 规模、复杂度的不同，也有所不同。 还需要保证文档的可读性、准确 性、一致性，要建立