研究所软件设计说明解析

编写人 参加人 校 对 审 核 会 签 标准化 审 批 批 准

说明：

标记 处数 更改文号 签 字 日期 标记 处数 更改文号 签 字 日期

目 次

1 范围 ........................................................... 1 1.1 标识 ......................................................... 1 1.2 系统概述 ..................................................... 1 1.3 文档概述 ..................................................... 1 2 引用文档 ....................................................... 1 3 软件设计决策 ................................................... 1 3.2 设计原则 ..................................................... 2 3.3 设计规约 ..................................................... 2 3.4 开发规范 ..................................................... 2 3.5 设计方法 ..................................................... 2 3.6 开发模型 ..................................................... 2 4 软件体系结构设计 ............................................... 2 4.1 软件部件设计 ................................................. 2 4.1.2 部署设计 ................................................... 3 4.1.3 运行设计 ................................................... 3 4.1.4 技术架构设计 ............................................... 4 4.1.5 总体功能设计 ............................................... 4 4.1.6 领域对象设计 ............................................... 4 4.1.7 包结构设计 ................................................. 4 4.1.8 数据访问机制设计 ........................................... 4 4.1.9 界面设计 ................................................... 4 4.2 执行方案 ..................................................... 4 4.3 接口设计 ..................................................... 4 4.3.1 接口标识和接口图 ........................................... 4 4.3.X (接口的项目唯一的标识符) .................................. 4 5 软件详细设计 ................................................... 6 5.1 功能模块设计（软件单元的项目唯一标识符） ..................... 6

I

5.2 保密性设计 ................................................... 7 5.3 六性设计 ..................................................... 7 5.4 性能设计 ..................................................... 7 6 需求可追踪性 ................................................... 8 7 注释 ........................................................... 9

II

型代号/任务代号$配置项编号-SJ-V版本号

软件设计说明

1 范围 1.1 标识

本条应描述本文档所适用系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号和发布号。

a) 本文档已批准的标识号为：型代号/任务代号$配置项编号-SJ-V版本号；

b) 标题为：XXX$X软件设计说明； c) 本文档适用的软件：XXX$X软件。 1.2 系统概述

本条应概述本文档所适用的系统和软件的用途。

它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其他有关文档。 1.3 文档概述

本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。 2 引用文档

本章应列出引用文档的编号、标题、编写单位、修订版及日期，还应标识不能通过正常采购活动得到的文档的来源。 3 软件设计决策

本节应根据需要给出软件设计决策，即从用户角度出发描述系统将怎样运转以满足需求；同时给出和其他影响该软件单元的选择与设计的决策。

针对关键性需求(例如对安全性或保密性关键的需求)作出的设计决策，应在专门的章条中加以叙述。如果设计决策依赖于系统状态或方式，则应指明这一依赖性。设计决策的例子如下：

1

型代号/任务代号$配置项编号-SJ-V版本号

a) 关于软件将接收的输入和将产生的输出的设计决策，包括与其他系

统、硬件,软件和用户的接口。如果这一信息的全部或部分已在接口设计说明(IDD)中给出，则可以直接引用。

b) 有关响应每个输入或条件的软件行为的设计决策，包括软件要执行

的动作、响应时间和其他性能特性，模型化的物理系统的说明，选定的方程式/算法/规则，以及对不允许的输入或条件进行的处理。 c) 有关数据库/数据文件如何呈现给用户的设计决策。如果这一信息的

全部或部分在数据库设计说明(DBDD)中给出，则可直接引用。 d) 为满足安全性和保密性需求所选择的方法。

e) 为满足需求所做的其他配置项级设计决策，例如为提供所需的灵活

性、可用性和可维护性所选择的方法。

3.2 设计原则

3.3 设计规约

3.4 开发规范

3.5 设计方法

3.6 开发模型

4 软件体系结构设计

本章应分为以下几条描述软件体系结构设计。如果设计的全部或部分依赖于系统的状态或方式，此依赖性应予指明。如果设计信息在多于一个条中出现，它只需被提供一次，而在其他条中引本条应提供或引用为了理解设计所需要的设计约定。 4.1 软件部件设计

本条应描述：

a) 所有软件单元。应赋予每个软件单元一个项目唯一的标识符。

注：软件单元是软件设计中的元素；例如，软件主要分支、软件组成部分，类、对象、

2

型代号/任务代号$配置项编号-SJ-V版本号

模块、函数、例程或数据库。软件单元可以出现在层次结构的不同层上，且又可以由其他软件单元组成。在设计中，软件单元与实现它们的代码和数据实体(例程，过程，数据库，数据文件等)，或与包含这些实体的计算机文件之间，可以有、也可以没有一对一的对应关系。一个数据库可被处理为一个软件配置项也可被处理为一个软件单元。软件设计说明可以采用与所使用设计方法相一致的任何名字来称呼软件单元。

b) 软件单元的静态关系。根据所选择的软件设计方法学，可以给出多

种关系(例如，采用面向对象的设计方法时，本条既可给出类和对象结构，也可给出模块和过程结构)。

c) 每个软件单元的用途，指明分配给它的软件需求和配置项级设计决

策。

d) 每个软件单元的开发状态/类型(如新开发、按原样重用已有的设计

或软件、为重用而要开发的软件等)。针对现有的设计或软件，本说明应提供标识信息，例如名字、版本、文档引用、库等。 e) 软件计划使用的计算机硬件资源(例如处理机能力，内存能力，输入

输出设备能力，辅存能力以及通信/网络设备能力)。本说明应覆盖软件的资源使用需求中、影响该软件的系统级资源分配中、以及在软件开发计划的资源使用测量策划中包含的全部计算机硬件资源。如果针对指定计算机硬件资源的所有使用数据都在同一处提供，例如在软件设计说明中提供，那么本条可直接引用。对每个计算机硬件资源，应包括如下信息：软件需求或系统级资源分配、使用数据基于的假设和条件、影响使用的特殊考虑(例如，虚存、多处理器的使用情况，操作系统、库软件的开销或其他实现开销的影响)、所使用的测度的单位(例如，处理器能力的百分比、周期/秒、内存字节数、千字节/秒)，以及进行评估或测量的级别(例如，软件单元，软件配置项或可执行程序)。

f) 标识实现每个软件单元的软件放置在哪个程序库中。 总体业务框架设计 4.1.2 部署设计 4.1.3 运行设计

3

型代号/任务代号$配置项编号-SJ-V版本号

4.1.4 技术架构设计 4.1.5 总体功能设计 4.1.6 领域对象设计 4.1.7 包结构设计 4.1.8 数据访问机制设计 4.1.9 界面设计 4.2 执行方案

本条应说明软件单元间的执行方案，可采用图表和描述，来说明软件单元间的动态关系，即软件运行期间软件单元间的相互作用情况，(若适用)应包括执行控制流程、数据流、动态控制序列、状态转换图、时序图、单元间的优先关系、中断处理、时序/排序关系、例外处理、并发执行、动态分配与去除分配、对象/进程/任务的动态创建/删除、以及动态行为的其他方面。 4.3 接口设计

4.3.1 接口标识和接口图

本条应说明赋予每个接口的项目唯一的标识符，(若适用)应通过名称、编号、版本及文档引用来标识接口实体(软件单元、系统、配置项、用户等)。该标识应说明哪些实体具有固定的接口特性(从而把接口需求分配给这些接口实体)；说明哪些实体正在开发或修改(这些实体己有各自的接口需求)。(若适用)应通过接口图来描述这些接口。 4.3.X (接口的项目唯一的标识符)

本条(从4.3.2开始)应通过项目唯一的标识符来标识接口，应简要地标识接口实体。视需要可分条描述单方或双方接口实体的特性。本条可引用其他文档(例如数据字典、通信协议标准、用户接口标准)代替在此所描述的信息。(若适用)需求应包括如下内容，并以任何适合于需求的顺序给出，还应从接口实体的角度说明这些特性之间的区别(例如对数据元素的大小、频率或其他特性的不同期望值)：

a) 软件必须分配给该接口的优先级。

b) 对要实现的接口类型的要求(例如实时数据传送、数据的储存和检索等)。

4

型代号/任务代号$配置项编号-SJ-V版本号

c) 软件必须提供、储存、发送、存取、接收的各个数据元素所要求的特征，例如： 1)名称/标识符： a.项目唯一的标识符； b.非技术(自然语言)名称； c.数据元素名称；

d.技术名(如在代码或数据库中的变量名或字段名)； e.缩略名或同义名。

2)数据类型(字母、数字、整数等)。

3)大小和格式(如：字符串的长度和标点符号)。 4)计量单位(如：m等)。

5)可能值的范围或枚举(如：0-99) 。 6)准确性(正确程度)和精度(有效数字位数)。

7)优先级别、定时、频率、容量、序列以及其他约束条件(例如数据元

素是否可以被更新、业务规则是否适用)。 8)保密性约束。

9)来源(设置/发送实体)和接收者(使用、接收实体)。

d) 接口实体将提供、存储、发送、访问、接收的数据元素组合体(记录、消息、文件、数组、显示、报表等)所要求的特征，例如： 1)名称/标识符： a.项目唯一的标识符； b.非技术(自然语言)名称；

c.技术名称(如在代码或数据库中的记录名或数据结构名)； d.缩略名或同义名。

2)数据元素组合体中的数据元素及其结构(编号、顺序和成组情况)。 3)介质(例如磁盘)以及在介质上数据元素/包的结构。

4)显示和其他输出的视听特性(例如颜色、布局、字体、图标和其他显示元素、峰鸣音和亮度)。 5)包之间的关系，如排序/存取特性。

6)优先级、时序、频率、容量、序列及其他约束，例如包是否可以被

5

型代号/任务代号$配置项编号-SJ-V版本号

更新、业务规则是否适用。 7)保密性约束。

8）来源(设置/发送实体)和接收者(使用/接收实体)。 e) 接口实体用于接口的通信方法所要求的特征。如： 1）项目唯一的标识符；

2)通信链接/带宽/频率/介质及其特性； 3)消息格式；

4)流控制(如：序列编号和缓冲区分配)； 5)周期/非周期传送的数据传送速率，传输间隔； 6)路由、寻址、命名约定； 7)传输服务，包括：优先权和等级；

8)安全性/保密性考虑，如：加密、用户鉴别、隔离和审核。 f) 接口实体用于接口的协议所要求的特征，如： 1)项目唯一的标识符； 2)协议的优先级别/层次；

3)打包，包括拆包和重新打包、路由和寻址； 4)合法性检查、错误控制和恢复过程； 5)同步，包括建立连接、保持和终止； 6)状态、标识及任何其他报告的特性。

g) 其他特性，例如接口实体的物理兼容性(尺寸、公差、负载和接插件的兼容性等)、电压等。

5 软件详细设计

5.1 功能模块设计（软件单元的项目唯一标识符）

本条应通过项目唯一的标识符来标识软件单元，并对该单元进行说明。(若适用)该说明应包括下列信息。本条也可以指定一组软件单元，然后再分小条对它们分别进行标识和说明，包含其他软件单元的软件单元可引用那些软件单元的说明，而无需在此重复。

a) (若有)单元设计决策，例如所使用的算法(如果此前尚未选定)。 b) 该软件单元设计中的任何约束、限定或非常规特征。

c) 如果使用的编程语言不同于本软件所指定的语言，则应指出并说明使

6

型代号/任务代号$配置项编号-SJ-V版本号

用它的理由。

d) 如果该软件单元包含过程性命令或由过程性命令组成(例如数据库管理系统(DBMS)中用于定义表单和报表的菜单选择，用于数据库访问和操纵的在线DBMS查询，用于代码自动生成的图形用户接口(GUI)构造器的输入，操作系统的命令或Shell脚本)，应列出这些过程性命令，并引用解释它们的用户手册或其他文档。

e) 如果该软件单元包含、接收或输出数据，(若适用)应对它的输入、输出及其他数据元素和数据元素组合体进行说明。本文档的4.3.X条提供了(若适用)应包括的主题。软件单元的局部数据应与软件单元的输入或输出数据分开来描述。如果该软件单元是一个数据库，应弓!用相应的数据库设计说明(DBDD)；接口特性可以在这里提供、也可以引用第4章或相应的接口设计说明(IDD)。

f) 如果该软件单元包含逻辑，则给出该软件单元所用到的逻辑，(若适用)应包括：

1) 该软件单元执行启动时，其内部起作用的条件。 2) 将控制传递给其他软件单元的条件。

3) 对每个输入的响应以及响应时间，包括数据转换、重命名以及数据传输操作。

4) 在软件单元运行期间的操作顺序和动态控制序列，包括： a. 顺序控制的方法；

b. 该方法的逻辑和输入条件，例如时序变异、优先级分配等； c. 进出内存的数据传输；

d. 对离散输入信号的感知，以及该软件单元内中断操作之间的时序关系。 5) 异常和错误处理。

5.2 保密性设计

5.3 六性设计

5.4 性能设计

7

型代号/任务代号$配置项编号-SJ-V版本号

6 需求可追踪性

本章应描述：

a) 从本软件设计说明所标识的每个软件单元，到分配给它的软件需求的可追踪性。

b) 从每个软件配置项需求，到被分配这些需求的软件单元的可追踪性。

表1 正向追溯表 序号 1 2 3 4 5 6 7 8 9 软件需求规格说明 3.2.2内容编辑 3.2.2.1内容编写 3.2.2.2接口管理 3.2.3内容管理 3.2.3.1项目管理 3.2.3.2项目配置 3.2.3.3DM管理 3.2.3.4实体管理 3.2.3.5重用单元管理 3.2.3.6任务管理 3.2.3.7数据交换 3.2.3.8基础库管理 3.2.4内容发布 3.2.4.1出版物管理 3.2.4.2数据包管理 3.2.5内容交付 3.2.6内容浏览 3.2.6.1数据包管理 3.2.6.2DM浏览控制模块 3.2.6.3交互操作模块 3.2.7系统管理 3.2.8安全管理 3.2.9审计管理 软件设计说明 5.1.1内容编辑 5.1.1.1内容编写 3.2.2内容编辑 3.2.2.1内容编写 8 5.1.1内容编辑 5.1.1.1内容编写 5.1.1.2接口管理 5.1.2内容管理 5.1.2.1项目管理 5.1.2.2项目配置 5.1.2.3DM管理 5.1.2.4实体管理 5.1.2.5重用单元管理 5.1.2.6任务管理 5.1.2.7数据交换 5.1.2.8基础库管理 5.1.3内容发布 5.1.3.1出版物管理 5.1.3.2数据包管理 5.1.4内容交付 5.1.5内容浏览 5.1.5.1数据包管理 5.1.5.2DM浏览控制模块 5.1.5.3交互操作模块 5.1.6系统管理 5.1.7安全管理 5.1.8审计管理 软件设计说明 10 11 12 13 14 15 16 17 18 19 20 21 22 23 序号 1 2 表2 逆向追溯表 软件需求规格说明 型代号/任务代号$配置项编号-SJ-V版本号

序号 3 4 5 6 7 8 9 软件设计说明 5.1.1.2接口管理 5.1.2内容管理 5.1.2.1项目管理 5.1.2.2项目配置管理 5.1.2.3DM管理 5.1.2.4实体管理 5.1.2.5重用单元管理 5.1.2.6任务管理 5.1.2.7数据交换 5.1.2.8基础库管理 5.1.3内容发布 5.1.3.1出版物管理 5.1.3.2数据包管理 5.1.4内容交付 5.1.5内容浏览 5.1.5.1数据包管理 5.1.5.2DM浏览控制模块 5.1.5.3交互操作模块 5.1.6系统管理 5.1.7安全管理 5.1.8审计管理 3.2.2.2接口管理 3.2.3内容管理 3.2.3.1项目管理 3.2.3.2项目配置 3.2.3.3DM管理 3.2.3.4实体管理 3.2.3.5重用单元管理 3.2.3.6任务管理 3.2.3.7数据交换 3.2.3.8基础库管理 3.2.4内容发布 3.2.4.1出版物管理 3.2.4.2数据包管理 3.2.5内容交付 3.2.6内容浏览 3.2.6.1数据包管理 3.2.6.2DM浏览控制模块 3.2.6.3交互操作模块 3.2.7系统管理 3.2.8安全管理 3.2.9审计管理 软件需求规格说明 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 7 注释

本章应包括有助于了解文档的所有信息(例如：背景、术语、缩略语或公式)。

9

型代号/任务代号$配置项编号-SJ-V版本号

小组意见： 签名 年 月 日 室审查意见： 签名 年 月 日 技术指导人审查意见： 所 审查技术负责人审查意见： 意 见 签名 年 月 日 院审查意见： 签名 年 月 日

签名 年 月 日