概要设计文档模板.doc-资料库

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第1页.png

第1页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第2页.png

第2页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第3页.png

第3页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第4页.png

第4页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第5页.png

第5页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第6页.png

第6页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第7页.png

第7页 / 共15页

2d2ab704-d8f5-4b67-9d76-1fca4fd6ed84.doc.pdf-第8页.png

第8页 / 共15页

国际商业机器（中国）有限公司 XXX 产品/项目概要设计说明书 dongluz@cn.ibm.com 2010-5-4 本文档所包含的信息是受国际商业机器（中国）有限公司所签署的“保密信息交换协议”保护和限制。在未事先得到国际商业机器（中国）有限公司(IBM)公司书面同意之前，本文档全部或部份内容不得用于其他任何用途或交与第三方。

更新记录 XX 产品概要设计报告版本编制/修改人修改日期修改对象备注（原因、进一步的说明等）审批人/日期国际商业机器（中国）有限公司版本：7.0.0 - 2 -

XX 产品概要设计报告目录 1 概述................................................................................................................................................................................. 1 1.1 开发与设计的总体思想................................................................................................................................................ 1 1.2 开发平台及编程语言.................................................................................................................................................... 1 1.3 名词解释........................................................................................................................................................................ 2 2 用户界面设计..................................................................................................................................................................3 3 总体设计..........................................................................................................................................................................3 3.1 产品总体结构................................................................................................................................................................ 3 3.2 软件模块组成................................................................................................................................................................ 4 3.3 业务流程........................................................................................................................................................................ 4 3.4 通信设计........................................................................................................................................................................ 6 3.5 数据结构设计................................................................................................................................................................ 7 3.5.1 数据库表关系........................................................................................................................................................8 3.5.2 表结构设计............................................................................................................................................................8 3.6 性能设计........................................................................................................................................................................ 8 3.7 可靠性设计 .................................................................................................................................................................... 9 3.8 扩展性设计 .................................................................................................................................................................... 9 3.9 兼容性设计 ..................................................................................................................................................................10 3.10 可移植性设计.............................................................................................................................................................. 10 3.11 可升级性设计.............................................................................................................................................................. 11 国际商业机器（中国）有限公司版本：7.0.0 - 3 -

1 概述手册模板的使用说明： XX 产品概要设计报告 1. 概要设计中应说明软件整体性内容，多关注产品间相互关系、模块组成和模块间相互关系、模块内的主要业务流程，特别注意不要陷入对各个模块的细节描述中（概要设计关注重点，例如：不要画类图来描述类的详细方法和参数） 2. 所有在需求文档中体现的业务流程都应在设计文档有对应说明 3. 所有蓝色文字是描述模板使用方法和应填写的内容，请在正式文档中删除； 4. 所有绿色文字是内容填写示例，请在正式文档中删除； 5. 所有红色文字是概要设计报告的评审要素，请在正式文档中删除； 6. 所有在“[”、“]”中间的内容都应根据产品进行修改或筛选、补充，； 7. 为保持所有产品的手册风格一致，便于读者学习公司所有产品，请不要调整文档目录结构，有建议请反馈给产品管理部；说明：上述 1-7 条为总体说明，请在正式文档中删除。 1.1 开发与设计的总体思想说明： 1. 当前版本开发的目的，要解决的问题，意义等。 2. 开发的总体原则，设计思想等。评审要素： 1. 全面准确的描述设计总体思想填写示例 XXX 系统（以下简称 XXX）是在公司框架基础上进行开发的产品，依据职责分配原则,分层设计开发。系统主要分为配置服务，管理服务，同步服务，查询服务。其中配置服务主要负责完成产品自身相关配置，管理服务主要负责完成产品自身业务处理，同步服务主要负责和应用系统进行数据交互，查询服务主要负责为公司网关产品提供数据查询接口。 1.2 开发平台及编程语言说明：国际商业机器（中国）有限公司版本：7.0.0 - 1 -

XX 产品概要设计报告 1. 描述组件开发的开发工具、设计工具、编程语言：如开发工具：eclipse 设计工具：Rational Software Architect 编程语言：服务器：Java（JDK1.5 以上） API： Java（JDK1.3 以上）评审要素： 1. 平台、编程语言、设计工具版本描述准确，有补丁版本的也要明确描述出来。填写示例：开发工具：Eclipse 3.x 设计工具：IBM Rational Software Architect、Microsoft Office Visio 2003 编程语言：服务端：Java（SUN JDK1.5） + 1.3 名词解释说明：列出本文件中用到的专门术语的定义和外文首字母缩写的原词组。如果不需要可以删除本节国际商业机器（中国）有限公司版本：7.0.0 - 2 -

2 用户界面设计说明： XX 产品概要设计报告 1. 可以采用图文方式描述所有功能的用户界面，鼓励使用独立的“Demo 程序”动态展示用户界面。评审要素： 1. 界面设计应覆盖所有需求文档中描述的功能。 3 总体设计 3.1 产品总体结构说明： 1. 概述产品设计思路，主要功能模块 2. 用图形化的形式描述产品整体结构评审要素： 1. 产品总体图描述准确、清晰； 2. 主要功能模块全面；填写示例：（这个例子并不很好，仅为示意）产品总体结构 5.0.3 版是在 5.0.2 版统一用户管理系统基础上，针对以下方面的需求进行开发与设计 1. 用户审核 2. 应用账号集中管理 3. 发布功能 4. 产品易用性（易用性设计）国际商业机器（中国）有限公司版本：7.0.0 - 3 -

XX 产品概要设计报告 5. 支持第三方 SYSLOG 审计服务 XXX 在设计采用公司共性技术平台中的 XXX Server Framework 作为服务框架，在此基础上进行功能扩展。同时也采用共性技术平台中的其它公共组件作为底层支持。从纵向上依据分层设计共分为三层：WEB 服务层，TK 通讯层，业务服务层。 WEB 服务层分为 HTML， ACTION,BUSINESS 三层，其中 HTML 层负责业务及数据展示，提供友好美观的系统操作界面。ACTION 层负责接收 HTML 提出的各种业务请求并封装提交的参数。BUSINESS 层主要负责 WEB 层的业务逻辑控制。TK 通讯层采用公司通讯组件，服务将各种业务数据组装成相应报文并向业务服务层发出各种业务请求及处理业务响应。业务服务层分为 Handler,Business,Integration,DAO,数据存储五层，其中，Handler 负责接收 TK 发送的各种业务请求、将业务处理结果组装成报文对 TK 通讯层做出响应及审计日志记录。Business 层负责业务权限控制及业务逻辑控制，Integration 层负责对 DAO 层的调用逻辑控制及系统数据约束控制。DAO 层负责将业务数据进行持久化存储，数据存储层负责将数据持久化保存。从横向上主要分为用户审核，应用账号集中管理，发布功能，三个模块。用户审核模块主要完成用户增加，修改，删除等操作的申请及审核流程，应用账号管理模块主要提供应用账号管理的集中管理视图，与原有的应用账号用户视图对应，提供给使用者两种便捷的操作方式来管理系统中的应用账号。发布功能则提供给使用者集中发布的功能，与原来系统中同步服务的定制发布呼应，通过集中发布和定制发布，能够应用系统采用灵活的方式选择应用系统的结合方式与 XXX 进行数据共享。 3.2 软件模块组成说明： 1. 说明软件由哪些模块组成的，每个模块的作用是什么，模块之间的关系（依赖关系、耦合度等）。 2. 在模块说明中，对重点模块要明确说明：是重点模块，为什么是； 3. 对外提供的接口应该重点写清楚（提供了哪些接口，作用是什么，输入、输出）； 4. 对外部产品的调用应该重点写清楚（包括对外部产品和外部组件）； 5. 业务模块与《需求分析》中的功能需求对应评审要素： 1. 软件所有模块都列出，每个模块作用是否描述准确清晰 2. 模块间互相的关系描述准确清楚，模块划分是否合理 3. 对外的接口描述全面、准确―― a) 包括接口清单， b) 每个接口的作用和输入、输出等； 4. 如果有对外部产品的调用，需要重点写清楚 a) 调用了哪些接口？ b) 起到什么作用？ c) 输入、输出是什么？ 5. 业务模块是否与《需求分析》中的功能需求对应 3.3 业务流程说明： 1. 业务流程尽量使用图形来描述 2. 概要设计的业务流程描述重点是产品内部各个模块如何配合工作的，例如：一个配置 License 需求的就是由界面接收 License 文件，License 管理模块将 License 文件保存在指定的目录中，并且将 License 文件中的数据解析出来，加载到内存中使之生效。 3. 概要设计的业务流程与需求分析中的区别是，需求分析关注于用户的交互操作和输出结果，概要设计的关注内部运作流程和数据流向,及各个模块之间的接口的输入输出 4. 重要的模块要有内部流程的描述国际商业机器（中国）有限公司版本：7.0.0 - 4 -

XX 产品概要设计报告 5. 业务流程需要与需求中流程相对应注：尽量不要陷入细节中，可以通过示意图的方式来描述，不要用带有类和方法的名称的 UML Sequence 图来描述。评审要素： 1. 描述业务流程的图形要尽量易懂、清晰 2. 对业务流程的描述准确，对可能出现的错误要有明确的分析 3. 软件模块组成中设计的模块都应该在业务流程有体现，不能遗漏 4. 是不是 3.2 中所有的重点模块都有内部流程描述 5. 业务流程是否考虑到产品灵活性、稳定性、性能等方面的影响 6. 业务流程是否与《需求分析》中的业务流程相符合填写示例： 3.3.1 分配应用账号业务流程图国际商业机器（中国）有限公司版本：7.0.0 - 5 -

资料库

概要设计文档模板.doc

相关推荐

信息化

热门标签

最新资料