系统设计报告编写规范
系统设计报告编写规范 |文件编号： |生效日期： |受控编号： | |NW506101 |2000.3.20 | | |密级：秘密 |版次：Ver2.1 |修改状态： | |总页数 |19 |正文 |4 |附录 |15 | |编制：胡景德 |审核：袁淮、孟莉|批准：孟莉 | 沈阳东大阿尔派软件股份有限公司 （版权所有，翻版必究） 文件修改控制 |修改记录编号 |修改 |修改页码及条款 |修改人|审核人|批准人|修改日期 | | |状态 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 目录 1. 目的 2. 适用范围 3. 术语及缩略语 4. 编写规范 4.1 排版规范 4.2 模板使用 5. 引用文件 6. 附录 目的 系统设计报告主要为使软件产品和软件项目满足规定的软件规格要求而确定软件系统 的体系结构、组成成分、数据组织、模块、内外部接口。主要任务有： 1) 建立软件产品和软件项目目标系统的总体结构。对于大规模软件系统，应分为若干子系 统，在本报告中只说明总体设计，然后为每个子系统编写《系统设计报告》； 2) 总体设计； 3) 模块设计； 4) 涉及使用数据库的设计需编写数据库设计。 适用范围 适用于软件开发设计阶段的《系统设计报告》的编写。 术语及缩略语 本程序采用NQ402100《质量手册》中的术语和缩略语及其定义。 编写规范 4.1 排版规范 1. 整个规范由2节构成，模板单独一节。 2. 正文样式采用“规范正文”。 3. 标题编号采用每节独立编号。 4.2 模板使用 系统设计报告的编写可依据具体情况选用摸板的格式或编写指南的格式。 1. 拷贝规范。 2. 删除第一节（系统设计报告封面前的所有页）。 3. 在修改完内容后，更新目录域和相关的页数域。 引用文件 (无) 附录 以下部分为系统设计报告的模板与编写指南。 密级：机密 文档编号： 第 版 分册名称： 第 册/共 册 项目名称（项目编号） 系统设计报告 （部门名称） 沈阳东大阿尔派软件股份有限公司 |总页数| |正文 | |附录 | |生效日期： 年 月 日| |编制： |审核： |批准： | 目录 1. 引言 1 1.1 目的 1 1.2 背景 1 1.3 术语 1 1.4 参考资料 1 2. 总体设计 1 2.1 系统运行环境 1 2.2 软件功能描述 1 2.3 软件结构 1 2.4 技术路线 1 2.5 外部接口 2 2.5.1 用户接口 2 2.5.2 软件接口 2 2.5.3 其它接口 2 3. 模块设计 2 3.1 功能 2 3.2 性能 2 3.3 内部接口 2 3.4 外部存贮结构设计 2 4. 故障处理说明 2 5. 数据库设计 2 5.1 数据字典设计 2 5.2 安全保密设计 2 1. 引言 1.1 目的 说明编写本《系统设计说明书》的目的。 1.2 背景： 说明理解本报告所需的背景，如与公司其它软件之间的联系等。 1.3 术语 列出本系统设计说明书中专门术语的定义和英文缩写词的原词组。 1.4 参考资料： 列出编写参考的文件、资料、技术标准以及他们的作者、标题、编号、发布日期和出 版单位。 |编号 |资料名称 |简介 |作者 |日期 |出版单位 | | | | | | | | 列出编写本报告时需查阅的Intenet上杂志、专业著作、技术标准以及他们的网址。 |网点 |简介 | | | | 总体设计 8.1 系统运行环境 给出本软件系统运行所需的基本软/硬件环境、使用本软件系统典型用户的设备分布 图及设备上相应软件配置。软件环境包括：操作系统、数据库、以及其它支撑软件； 硬件环境包括：主机类型、网络类型、存储器容量、其它特殊设备。 8.2 软件功能描述 描述被开发软件的功能，如有同等作用的文件（如已编写的《软件功能规格说明书》） 则可直接在此引述该文件名及归档的部门即可。 8.3 软件结构 以图表形式给出软件子系统结构和模块组成结构。凡单独编写《系统设计报告》的子系 统，其内部自用的模块不必列出。 8.4 技术路线 给出本软件系统在实现过程中所采用的技术路线、方法。对比较新的技术给予详细的 阐述及必要的说明，在可能的情况下给出相应的技术参考资料。 8.5 外部接口 8.5.1 用户接口 描述该软件与用户的接口，包括用户输入输出界面样式、操作方式和界面间的转移关 系。如具有等同作用的文件（如使用开发工具编写的界面原型程序等），本处仅需列 出该文件名、保管部门即可。 8.5.2 软件接口 描述该软件与其它系统的软件接口，主要说明其它系统提供的编程接口和本系统向其 它系统提供的编程接口，如具有等同作用的文件（如包含接口说明及注释的源文件程 序头文件、接口帮助的超文本文件等），本处仅需列出该文件名、保管部门即可。 8.5.3 其它接口 描述该软件与其它系统的其它类型接口，主要说明其它系统提供的和本系统向其它系 统提供的硬件接口、通信协议及规程、数据交换格式等，如具有等同作用的文件，本 处仅需列出该文件名、保管部门即可。 模块设计 9.1 功能 简述各模块的功能。 9.2 性能 说明对各模块的性能要求，包括精度、时间特性和处理速度。 9.3 内部接口 说明各模块之间接口，包括： 1) 各模块的用途、使用(调用)方式； 2) 说明其每个子程序（方法，Method）、特性（Property）和反馈的事件（Event），相 应的输入、输出项说明； 3) 指明各模块内含的各类外部接口，并列出这些外部接口说明材料名。 9.4 外部存贮结构设计 说明本系统存贮于磁盘等持久性存贮介质，而且不是由数据库管理系统进行管理的数 据的组织结构，包括数据名称、用途、每个数据项的标识名、类型和含义，组织结构 、访问方法和存储要求。 故障处理说明 说明本系统所采用的基本错误处理方法和原则，例如：统一采用C++ try- catch错误方法，所有错误最终必须以界面形式向用户说明。用一览表方式说明各类 可能的错误或故障出现时系统的处理方法和补救措施。 数据库设计 11.1 数据字典设计 对数据库设计中涉及到的各种项目，如数据项、记录、表、数据库等建立数据字典， 以说明它们的标识符、同义名及有关信息，并说明对此数据字典设计的基本考虑。凡 采用数据库设计工具（如ER图设计工具）生成的数据字典，本处仅需列出对应的文件 名、保管部门即可。 11.2 安全保密设计 说明在数据库的设计中，如何通过区分不同的访问者、不同的访问类型和不同的数据 对象，进行分别对待而获得的数据库安全保密设计考虑。 系统设计报告编写指南之一 1. Introduction介绍 o 描述这个文档的编写目的； o 描述这个文档的适用范围； o 描述这个文档的读者； o 确定这个系统/产品的名称和/或版本号； o 定义重要的术语、缩写词或缩略语； o 总结（或给出一个概要）这个文档的内容。 2. System Overview系统概述 对软件系统的一般性描述，包括系统的功能和其他与设计相关的内容。 3. Design Considerations设计上的考虑 本节描述在完成一个完整的设计解决方案之前必须阐明或解决的问题。 3.1 Assumptions and Dependencies假设和依赖 o 相关的软件和硬件 o 操作系统 o 最终用户特征 o 在功能上可能发生的变化 3.2 General Constraints一般限制 o 描述对软件系统的设计有重要影响的全局限制或约束。 o 硬件或软件环境； o 最终用户环境； o 资源的可用性和挥发性； o 标准的兼容；(option) o 协同工作的要求； o 接口/协议的要求； o 数据储存和发布要求； o 安全性的要求（或其它类似的规则）； o 内存和其它的容量限制； o 性能要求； o 网络通信；(option) o 验证和确认的要求（测试）； o 其他质量目标的要求； o 在需求分析说明书中所描述的其它要求。 3.3 Goals and Guidelines目标和指导方针 描述所有支配软件系统设计的目标、指导方针、原则或者优先权。 o 尽量保持它简单易用； o 强调速度与内存使用的矛盾； o 象对待一个已经存在的产品那样工作、观察或者体会。 3.4 Development Methods开发方法 简要地描述用于软件设计的方法。如果采用正式/已公布的方法，那么就要对这些 方法进行详细描述，同时还要简单解释一下为什么采用这个方法或其中的某些部 分。 4. Architectural Strategies体系结构策略 描述所有影响整个系统的组织和结构的设计决定和/或策略，这些策略深入描述系统 体系结构所使用的关键技术和机制。对于每个设计决定和/或策略都要描述其产生原 因（可能要引用前面阐述的设计目标和原则），以及它们是如何得到均衡和折中的， 涉及内容： o 使用特定类型产品（编程语言、数据库、函数库等）； o 重用现有组件； o 软件未来扩展和升级的计划； o 用户接口模型（或系统的输入和输出模型）； o 硬件或软件接口模型； o 错误检测和恢复； o 内存管理策略； o 外部数据库和/或数据存储管理和维护； o 网络上分布式数据或控制； o 控制的一般方法； o 并发和同步； o 通信机制； o 其它资源的管理。 每一个被采用的重要战略必须在相应的子章节内加以讨论。 5. System Architecture系统体系结构 在本节应该在一个较高的层次来说明如何将系统的功能划分给各个子系统或组件，不 要涉及这些组件本身的细节（后面有一个小节专门来详细描述组件）。本节的主要目 标是描述系统是如何进行分解、这样分解的原因以及各部分是如何协作工作以完成预 定功能。 在较高的层次上描述系统所要承担的主要工作责任、系统所扮演的各种角色；描述如 何将系统划分成各个组件/子系统，每个组件/子系统的作用是什么；描述高层组件之 间是如何协调工作已完成预期的功能；进行系统分解时所采用的基本原则；可以使用 图表、模型、流程图等形式来描述上述内容。 5.1 Subsystem Architecture子系统的体系结构 建立一个子章节来详细描述某一组件的作用，进一步描述该组件是如何分为子组 件的以及各个子组件之间的关系。 6. Policies and Tactics政策和实施策略 描述影响系统的接口细节和系统实现细节的各个方面： o 选择特定产品来使用（如编译器、解释器、数据库、函数库等）； o 工程上的折中； o 编码规范和惯例； o 一个或多个子系统、模块或子程序的协议； o 选择某一特定算法或编程用语来实现系统的一部分； o 功能性说明； o 保证需求可回溯性的计划； o 软件测试计划； o 软件维护计划； o 最终用户、软件、硬件和通信的接口； o 将源代码按照物理形态（文件和路径）进行分层组织； o 如何构造和/或产生系统的交付物（如何编译、链接、加载等）。 以上各项内容必须有相应的子章节进行讨论。如果还有其他方案可供选择时，要说明 你没有选择这些方案的原因。可以使用图表、模型、流程图等形式来描述上述内容。 7. Detailed System Design详细设计 在系统体系结构中所描述的绝大多数组件需要在本章节进行更深一步的讨论，同样， 其它低层的组件和子组件也需要描述。为每个组件建立一个子章节来详细描述组件， 包括以下内容： o Classification 分类 组件的种类，例如是一个子系统、模块、类、包、函数、文件等等。 o Definition 定义 组件的确切用途和语义。可能需要参照需求说明。 o Responsibilities 责任 该组件的主要责任和/或行为，要完成什么？扮演什么角色？给客户提供哪写服务 ？可能需要参照需求说明。 o Constraints 约束 与该组件相关的任何假设、限制、或者约束，如时间、存储或组件状态，还可能 包括与该组件进行交互的规则（前提条件，后置条件，不变量，其它在输入和输 出值、局部或全局值上的限制，数据格式和数据存取...
系统设计报告编写规范