软件详细设计说明与模板.doc

《软件详细设计说明与模板.doc》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、软件详细设计说明与模板引言引言是对这份软件系统详细设计报告的概览，是为了帮助阅读者了解这份文档如何编写的，并且应该如何阅读、理解和解释这份文档。编写目的说明这份软件系统详细设计报告是基于哪份软件产品需求分析报告、哪份软件产品概要设计报告和哪份软件产品数据库设计说明书(如果该软件产品需要数据库支持)编写的，开发这个软件产品意义、作用、以及最终要达到的意图。通过这份软件系统详细设计报告详尽说明了该软件产品的编码结构，从而对该软件产品的物理组成进行准确的描述。如果这份软件系统详细设计报告只与整个系统的某一部分有关系，那么只定义软件系统详细设计

2、报告中说明的那个部分或子系统。项目风险具体说明本软件开发项目的全部风险承担者，以及各自在本阶段所需要承担的主要风险，首要风险承担者包括：●任务提出者；●软件开发者；●产品使用者。文档约定描述编写文档时所采用的标准(如果有标准的话)，或者各种编写约定。编写约定应该包括：●部件编号方式；●界面编号方式；●命名规范：●等等。预期读者和阅读建议列举本软件系统详细设计报告所针对的各种不同的预期读者，例如，可能的读者包括：●开发人员；●项目经理；●测试人员；●文档编写人员；●等等。描述文档中，其余部分的内容及其组织结构，并且针对每一类读者提出最适合

3、的文档阅读建议。参考资料列举编写软件系统详细设计报告时所用到的参考文献及资料，可能包括：●本项目的合同书；●上级机关有关本项目的批文；●本项目已经批准的计划任务书；●用户界面风格指导；●开发本项目时所要用到的标难；●系统规格需求说明；●使用实例文档；●属于本项目的其它己发表文件；●本软件系统详细设计报告中所引用的文件、资料；●相关软件系统详细设计报告；●等等。为了方便读者查阅，所有参考资料应该按一定顺序排列。如果可能，每份资料都应该给出：●标题名称；●作者或者合同签约者；●文件编号或者版本号；●发表日期或者签约日期；●出版单位或者资料来

4、源。支撑环境数据库管理系统描述数据库管理系统、以及安装配置情况，需要描述的内容可能包括：●产品名称以及发行厂商这里的产品名称指的是数据库发行厂商发布产品时公布的正式商品名称，不应该使用别名、简称、研发代号等非正式名称，以免混淆；同样的道理，发行厂商的名称也应该使用正式名称。●版本号数据库管理系统的准确版本号，必须按产品的实际情况描述到最细节的版本号。●补丁包版本号描述实际上将要使用的数据库管理系统补丁包的版本号，必须注意，在某些情况下该版本号不一定是最新的版本号。●语言或代码集对于只支持一种语言或者一个代码集的数据库管理系统来说，该项描

5、述不具意义。对于支持多种语言或者多个代码集的数据库管理系统来说，该项描述指的是实际使用的语言或者代码集。●安装位置描述数据库管理系统的实际安装位置，应该分别对管理系统安缺位置和数据存放位置进行描述，应该指明服务器名和安装卷号(盘号)。对于分布式数据库，必须分别描述每一个数据库管理系统。●配置参数描述数据库管理系统在实际安装时应该配置的各个参数，对于分布式数据库，必须分别描述每一个数据库管理系统的配置参数。●等等同时参照《南京市交通局信息化数据库建设规范》。开发工具、中间件以及数据库接口描述所选用的工具软件和中间件的名称、版本号，以及开发

6、工具与数据库或者中间件接口的情况。如果使用了多种开发工具、辅助开发工具、第三方软件部件、多种中间件、多种接口、等答应该逐项分别描述，并且说明每一项的适用范围。需要描述的内容可能包括：●产品名称以及发行厂商同2.1中产品名称以及发行厂商。●版本号同2.1中版本号。●补丁包版本号同2.1中补丁包版本号。●语言或代码集同2.1中语言或代码集。●数据库接口名称描述数据库接口的名称，如果使用别名时，应同时描述使用的别名。●数据库接口方式描述与数据库接口的方式，并说明该接口方式的特点；如果需要，还应该说明使用时的注意事项。●数据库接口设置描述各种接

7、口设置，包括：协议、端口号等等。同时参照《南京市交通局信息化数据库建设规范》。硬件环境描述所选用的硬件环境，各种机型，例如：服务器、工作站，应该分别描述。需要描述的内容可能包括：●机型；●主频；●内存容量；●磁盘容量；●特殊部件；●操作系统；●使用位置；●等等。网络环境描述可能影响应用软件访问数据库的各种网络环境，如果存在加密传输、VPN链路等情况，也必须描述。对于结构复杂的网络，还应该提供网络拓扑图和数据流向示意图。需要描述的内容可能包括：●网络结构；●网络操作系统；●网络带宽；●路由组织；●加密传输方式；●VPN链路连接方式；●等等

8、。多种支撑环境开发要点当软件产品将来可能遇到的多种运行环境时，应该分别按照3.1节至3.4节的内容列表描述。如果软件产品各个子系统的运行环境不完全一样时，应该分子系统按照3.1节至3.4节的内容列表描述。遇