某公司系统设计报告编写规范标准

1、 系统设计报告编写规文件编号： NW506101 生效日期： 2000.3.20受控编号：密级：秘密版次：Ver2.1修改状态： 2 / 22总页数19正文4附录15胡景德 袁淮、孟莉 孟莉东大阿尔派软件股份（所有，翻版必究）文件修改控制修改记录编号修改状态修改页码与条款修改人审核人批准人修改日期目录1. 目的2. 适用围3. 术语与缩略语 3 / 224.编写规4.1 排版规4.2 模板使用5.引用文件6. 附录1.目的系统设计报告主要为使软件产品和软件项目满足规定的软件规格要求而确定软件系统的体系结构、组成成分、数据组织、模块、外部接口。主要任务有：1) 建立软件产品和软件项目目标系统的总

2、体结构。对于大规模软件系统，应分为若干子系统，在本报告中只说明总体设计，然后为每个子系统编写系统设计报告；2) 总体设计；3) 模块设计；4) 涉与使用数据库的设计需编写数据库设计。2.适用围适用于软件开发设计阶段的系统设计报告的编写。3.术语与缩略语本程序采用 NQ402100质量手册中的术语和缩略语与其定义。4.编写规4.1排版规1）整个规由 2 节构成，模板单独一节。 4 / 222）正文样式采用“规正文”。3）标题编号采用每节独立编号。4.2模板使用系统设计报告的编写可依据具体情况选用摸板的格式或编写指南的格式。1）拷贝规。2）删除第一节（系统设计报告封面前的所有页）。3）在修改完容后

3、，更新目录域和相关的页数域。5.引用文件(无)6.附录以下部分为系统设计报告的模板与编写指南。 密级：文档编号：第版分册名称：第册/共册项目名称（项目编号）系统设计报告（部门名称）东大阿尔派软件股份 2 / 22总页数正文附录生效日期：年月日目录1. 引言11.1 目的11.2 背景11.3 术语11.4 参考资料12. 总体设计12.1 系统运行环境12.2 软件功能描述12.3 软件结构12.4 技术路线12.5 外部接口22.5.1 用户接口22.5.2 软件接口22.5.3 其它接口23. 模块设计23.1 功能23.2 性能23.3 部接口2 3 / 223.4 外部存贮结构设计24

4、. 故障处理说明25. 数据库设计25.1 数据字典设计25.2 安全设计2 1. 引言1.1目的说明编写本系统设计说明书的目的。1.2背景：说明理解本报告所需的背景，如与公司其它软件之间的联系等。1.3术语列出本系统设计说明书中专门术语的定义和英文缩写词的原词组。1.4参考资料：列出编写参考的文件、资料、技术标准以与他们的作者、标题、编号、发布日期和出版单位。编号资料名称简介作者日期出版单位列出编写本报告时需查阅的 Intenet 上杂志、专业著作、技术标准以与他们的网址。网点简介2.总体设计2.1系统运行环境给出本软件系统运行所需的基本软/硬件环境、使用本软件系统典型用户的设备分布图与设备

5、上相应软件配置。软件环境包括：操作系统、数据库、以与其它支撑软件；硬件环境包括：主机类型、网络类型、存储器容量、其它特殊设备。2.2软件功能描述描述被开发软件的功能，如有同等作用的文件（如已编写的软件功能规格说明书）则可直接在此引述该文件名与归档的部门即可。 2 / 222.3软件结构以图表形式给出软件子系统结构和模块组成结构。凡单独编写系统设计报告的子系统，其部自用的模块不必列出。2.4技术路线给出本软件系统在实现过程中所采用的技术路线、方法。对比较新的技术给予详细的阐述与必要的说明，在可能的情况下给出相应的技术参考资料。2.5外部接口2.5.1用户接口描述该软件与用户的接口，包括用户输入输

6、出界面样式、操作方式和界面间的转移关系。如具有等同作用的文件（如使用开发工具编写的界面原型程序等），本处仅需列出该文件名、保管部门即可。2.5.2软件接口描述该软件与其它系统的软件接口，主要说明其它系统提供的编程接口和本系统向其它系统提供的编程接口，如具有等同作用的文件（如包含接口说明与注释的源文件程序头文件、接口帮助的超文本文件等），本处仅需列出该文件名、保管部门即可。2.5.3其它接口描述该软件与其它系统的其它类型接口，主要说明其它系统提供的和本系统向其它系统提供的硬件接口、通信协议与规程、数据交换格式等，如具有等同作用的文件，本处仅需列出该文件名、保管部门即可。3.模块设计3.1功能简述

7、各模块的功能。 3 / 223.2性能说明对各模块的性能要求，包括精度、时间特性和处理速度。3.3部接口说明各模块之间接口，包括：1) 各模块的用途、使用(调用)方式；2) 说明其每个子程序（方法，Method）、特性（Property）和反馈的事件（Event），相应的输入、输出项说明；3) 指明各模块含的各类外部接口，并列出这些外部接口说明材料名。3.4外部存贮结构设计说明本系统存贮于磁盘等持久性存贮介质，而且不是由数据库管理系统进行管理的数据的组织结构，包括数据名称、用途、每个数据项的标识名、类型和含义，组织结构、访问方法和存储要求。4.故障处理说明说明本系统所采用的基本错误处理方法和原

8、则，例如：统一采用 C+ try-catch 错误方法，所有错误最终必须以界面形式向用户说明。用一览表方式说明各类可能的错误或故障出现时系统的处理方法和补救措施。5.数据库设计5.1数据字典设计对数据库设计中涉与到的各种项目，如数据项、记录、表、数据库等建立数据字典，以说明它们的标识符、同义名与有关信息，并说明对此数据字典设计的基本考虑。凡采用数据库设计工具（如 ER 图设计工具）生成的数据字典，本处仅需列出对应的文件名、保管部门即可。5.2安全设计说明在数据库的设计中，如何通过区分不同的访问者、不同的访问类型和 2 / 22不同的数据对象，进行分别对待而获得的数据库安全设计考虑。 3 / 2

9、2系统设计报告编写指南之一1. Introduction 介绍 描述这个文档的编写目的； 描述这个文档的适用围； 描述这个文档的读者； 确定这个系统/产品的名称和/或版本号； 定义重要的术语、缩写词或缩略语； 总结（或给出一个概要）这个文档的容。2. System Overview 系统概述对软件系统的一般性描述，包括系统的功能和其他与设计相关的容。3. Design Considerations 设计上的考虑本节描述在完成一个完整的设计解决方案之前必须阐明或解决的问题。3.1Assumptions and Dependencies 假设和依赖 相关的软件和硬件 操作系统 最终用户特征 在功能

10、上可能发生的变化3.2 General Constraints 一般限制 描述对软件系统的设计有重要影响的全局限制或约束。 硬件或软件环境； 最终用户环境； 资源的可用性和挥发性； 标准的兼容；(option) 4 / 22 协同工作的要求； 接口/协议的要求； 数据储存和发布要求； 安全性的要求（或其它类似的规则）； 存和其它的容量限制； 性能要求； 网络通信；(option) 验证和确认的要求（测试）； 其他质量目标的要求； 在需求分析说明书中所描述的其它要求。3.3 Goals and Guidelines 目标和指导方针描述所有支配软件系统设计的目标、指导方针、原则或者优先权。 尽量保

11、持它简单易用； 强调速度与存使用的矛盾； 象对待一个已经存在的产品那样工作、观察或者体会。3.4 Development Methods 开发方法简要地描述用于软件设计的方法。如果采用正式/已公布的方法，那么就要对这些方法进行详细描述，同时还要简单解释一下为什么采用这个方法或其中的某些部分。4. Architectural Strategies 体系结构策略描述所有影响整个系统的组织和结构的设计决定和/或策略，这些策略深入描述系统体系结构所使用的关键技术和机制。对于每个设计决定和/或策略都要描述其产生原因（可能要引用前面阐述的设计目标和原则），以与它们是如何得到均衡和折中的，涉与容： 使用特定

12、类型产品（编程语言、数据库、函数库等）； 5 / 22 重用现有组件； 软件未来扩展和升级的计划； 用户接口模型（或系统的输入和输出模型）； 硬件或软件接口模型； 错误检测和恢复； 存管理策略； 外部数据库和/或数据存储管理和维护； 网络上分布式数据或控制； 控制的一般方法； 并发和同步； 通信机制； 其它资源的管理。每一个被采用的重要战略必须在相应的子章节加以讨论。5. System Architecture 系统体系结构在本节应该在一个较高的层次来说明如何将系统的功能划分给各个子系统或组件，不要涉与这些组件本身的细节（后面有一个小节专门来详细描述组件）。本节的主要目标是描述系统是如何进行分

13、解、这样分解的原因以与各部分是如何协作工作以完成预定功能。在较高的层次上描述系统所要承担的主要工作责任、系统所扮演的各种角色；描述如何将系统划分成各个组件/子系统，每个组件/子系统的作用是什么；描述高层组件之间是如何协调工作已完成预期的功能；进行系统分解时所采用的基本原则；可以使用图表、模型、流程图等形式来描述上述容。5.1 Subsystem Architecture 子系统的体系结构建立一个子章节来详细描述某一组件的作用，进一步描述该组件是如何 6 / 22分为子组件的以与各个子组件之间的关系。6. Policies and Tactics 政策和实施策略描述影响系统的接口细节和系统实现细

14、节的各个方面： 选择特定产品来使用（如编译器、解释器、数据库、函数库等）； 工程上的折中； 编码规和惯例； 一个或多个子系统、模块或子程序的协议； 选择某一特定算法或编程用语来实现系统的一部分； 功能性说明； 保证需求可回溯性的计划； 软件测试计划； 软件维护计划； 最终用户、软件、硬件和通信的接口； 将源代码按照物理形态（文件和路径）进行分层组织； 如何构造和/或产生系统的交付物（如何编译、加载等）。以上各项容必须有相应的子章节进行讨论。如果还有其他方案可供选择时，要说明你没有选择这些方案的原因。可以使用图表、模型、流程图等形式来描述上述容。7. Detailed System Design

15、 详细设计在系统体系结构中所描述的绝大多数组件需要在本章节进行更深一步的讨论，同样，其它低层的组件和子组件也需要描述。为每个组件建立一个子章节来详细描述组件，包括以下容： Classification 分类组件的种类，例如是一个子系统、模块、类、包、函数、文件等等。 7 / 22 Definition 定义组件的确切用途和语义。可能需要参照需求说明。 Responsibilities 责任该组件的主要责任和/或行为，要完成什么？扮演什么角色？给客户提供哪写服务？可能需要参照需求说明。 Constraints 约束与该组件相关的任何假设、限制、或者约束，如时间、存储或组件状态，还可能包括与该组件

16、进行交互的规则（前提条件，后置条件，不变量，其它在输入和输出值、局部或全局值上的限制，数据格式和数据存取，同步，例外等）。 Composition 合成描述组成该组件的子组件与其用途。 Uses/Interactions 用户/接口描述该组件与其它组件之间的关系，如该组件被哪些组件所使用？该组件使用了哪些其它组件？这关系到所使用的交互作用的方法。面向对象的设计必须描述那些已知的和预期的子类、超类和元类。 Resources 资源描述这个组件所管理的、影响的和使用的所有资源，如存、处理器、打印机、数据库或软件库，要描述可能存在的资源竞争、死锁等情况以与相应的解决方案。 Processing 过程

17、描述该组件的执行过程，包括所使用的算法、状态的变化、相关的时间或空间的复杂性、并发、创建方法、初始化、清除和例外情况的处理。 Interface/Exports 界面/出口描述该组件所提供的服务，如资源、数据、类型、常量、子程序和例外等集合，明确定义每一个服务元素，即分类、定义、责任、约束、组合、 8 / 22使用、资源、处理和接口的描述。7.1 Detailed Subsystem Design 详细子系统设计在本章节对该组件进行更详细描述，可使用一些复杂的图表来显示组件结构、行为、或者信息/控制流。8. Glossary 词汇表列出在文档中所定义的术语和概念。9. Bibliography

18、 参考书目一个参考书目和/或相关出版物的列表。 9 / 22系统设计报告编写指南之二1.Objectives 目标描述系统设计报告的容和目的。2.Scope 围适用于指导包含设计阶段的项目编写系统设计报告。3. References 参考4. Outstanding Issues 尚存主要问题5. Approvals 批准R&D 单位负责人6. Responsibilities职责6.1开发部长对系统设计报告进行审核；6.2项目管理部门组织对系统设计报告进行评审；6.3设计人员提交符合本指南的系统设计报告。6.4设计人员对设计阶段的文档进行配置管理。7. Template 模板7.1Intro

19、duction 绪论 项目概述； 所设计的产品的概述。7.2System Description 系统描述 10 / 227.2.1 Support for Requirements 对需求的支持 设计满足需求的程度； 设计未能完全满足的需求与其原因。7.2.2 System Purpose 系统目标简述所开发的系统，如果本系统同其他系统有不论是手工还是计算机方面的关系，也要描述。可参考需求分析报告的容。7.2.3 Inputs and Outputs 输入和输出详细描述系统的所有输入和输出，包括界面设计、报表设计，参数格式。7.2.4 Functions 功能描述系统所提供的所有功能。7.2

20、.5 Stored data 数据存贮简述系统的数据文件。7.2.6 Security and backup 安全和备份系统在安全和备份方面的考虑与设计，包括回滚和恢复。7.2.7 Exception handling 例外处理系统产生的所有错误信息的列表，包括错误发生的条件以与所采取的措施。所有例外情况的列表，以与系统所采取的措施。7.2.8 Impact assessment 影响评估描述系统对现有环境的重要影响，如工序的变化，工作量的变化和硬件的变化。可以参照需求分析报告的容。7.3User Procedures 用户规程7.3.1 System navigation 系统导航描述那些使

21、用户能充分使用系统的规则；7.3.2 Routine 例程 描述在正常工作环境下，系统预期的使用方法； 11 / 22 使用流程图来描述例程，流程图要带有辅助描述，描述那些使用每个功能的用户的类型。7.3.3 Exception 例外处理描述系统在异常情况下所使用的处理方式，如网络失效时的数据恢复。7.3.4 Installation 安装描述系统的安装过程。7.4System architecture 系统结构7.4.1 Design principles 设计原则描述系统设计所采用的策略，如用户界面的形式，所使用的标准产品等。7.4.2 Design rationale 设计原理 描述进行

22、设计的依据，如数据库结构等； 模块调用原理：是部还是外部，是修改还是重建或重用。7.4.3 Software components and interfaces 软件组件和接口 描述系统中的主要组件，包括它们之间传递的包和数据流； 数据流图和功能分解图； 描述所引用的外部模块。7.4.4 Capacity requirements系统资源需求估计系统容量等需求的临界值，如存、磁盘空间和、传输速率等。7.4.5 System structure 系统结构描述系统的各模块是如何连接在一起工作的。7.5Data 数据7.5.1 Definitions 定义对系统中包含的所有数据项的描述。7.5.2

23、Database design 数据库设计 12 / 22 对逻辑数据库/文件设计的描述； 对物理数据库/文件设计的描述； 数据校验规则。7.5.3 Calculations 算法 定义系统所采用的计算或算法； 确定实现这些算法的流程。7.5.4 Data management procedures 数据管理程序描述对系统数据的管理流程，如存档等。7.6Module specifications 模块说明 详细描述每个模块的逻辑、功能或每个模块的所有状态、与其他模块的关联、状态的变迁、存在的条件与采取的动作； 使用简洁、标准的语言； 说明每个模块的输入和输出。7.7Physical envir

24、onment 物理环境描述建立和运行系统所需要的物理环境。7.8Appendices 附录 数据流图 数据模型 13 / 22系统设计报告检查表项目名称： 项目编号：序号内容YesNo不适用1 整个系统组织很清晰，并包括一个良好的体系结构概述和verification2 对模块进行明确定义，包括模块的功能说明和与其它模块的接口说明3 包含需求分析报告中列出来的所有功能4 主要的数据结构被调用函数隐藏起来了5 描述数据库的组织结构和内容6 描述并验证所有关键的算法7 定义了用户接口的关键方面8 包括一致的错误处理策略9 将错误信息清晰、简洁地反映在用户界面上10 体系结构的设计可以适应可能发生的变化11 作为实现系统的程序员，你对这个体系结构感到满意12 描述了处理用户输入的策略13 清晰地阐述了系统的主要目标14 所有主要的数据结构都有描述过并通过verification15 描述并验证所有主要的对象16 用户接口都被模块化以使其内部的变化不对程序的其它部分产生影响17 对内存的使用事先作了估计并对内存管理策略进行了描述和verificati