软件概要设计模板.docx
《软件概要设计模板.docx》由会员分享,可在线阅读,更多相关《软件概要设计模板.docx(12页珍藏版)》请在冰豆网上搜索。
软件概要设计模板
{子系统名称}
XX软件概要设计说明
拟制:
审核:
会签:
质量保证:
批准:
文档修改记录
版本号
修改内容描述
修改人
日期
备注
目次
1范围1
1.1标识1
1.2术语及缩略语1
1.3文档概述1
2引用文档1
3软件设计约束1
3.1应遵循的标准或规范1
3.2接口/协议的约束2
3.3质量约束2
3.4隐含约束2
4软件的设计策略2
5逻辑包的划分及设计2
5.1逻辑包的划分2
5.2XX逻辑包设计2
5.3YY逻辑包设计3
6执行概念3
6.1包级执行设计3
6.2XX包执行设计3
7外部接口设计3
7.1外部接口示意及标识4
7.2外部接口描述6
8内部接口设计8
9与上级文档的追溯关系8
9.1正向追溯8
9.2逆向追溯8
范围
标识
本文档的标题:
本文档的标识:
本文档的版本号:
术语及缩略语
本文档中使用的术语及缩略语详见下表:
本文档使用的术语及缩略语一览表
序号
术语或缩略语
解释
备注
1.
2.
3.
文档概述
本文档各章节内容说明如下表:
文档概述一览表
章节号
章节名称
内容描述
备注
1.
2.
3.
引用文档
引用文档一览表
序号
文档标识
文档名称
版本号
备注
1.
《XX软件系统概述》
2.
3.
4.
5.
软件设计约束
本节描述在概要设计阶段制定的设计约束,对“软件需求规格说明”中定义的设计约束可直接引用不必详细描述。
应遵循的标准或规范
注1:
本节描述需求中规定的或项目组内部制定的设计应遵循的标准、规范。
如有必要可作为本文档的附近单独列出。
接口/协议的约束
注2:
本节描述需求中定义的软件对外的接口和必须遵循的协议。
质量约束
注3:
描述需求规定的或组织规定的软件质量约束,如正确性、健壮性、可靠性、性能、易用性、清晰性、安全性、可扩展性、兼容性或可移植性。
隐含约束
注4:
描述需求中未明确指出的假设或依赖,这些假设或依赖对软件的设计将会产生一定的影响。
软件的设计策略
注5:
本节描述软件的设计策略,主要包括:
设计模式:
描述C/S结构、B/S结构、消息驱动、界面模式
其它模式:
扩展策略、复用策略、折衷策略。
逻辑包的划分及设计
注6:
在本节划分逻辑包,并分章节对各逻辑包进行定义。
逻辑包的划分
注7:
画出整个软件的逻辑包视图的组成,要求画到类包(该包全部由类组成,不能再划分为子包)一级。
同时对包的组织作简要介绍。
“包”一览表
序号
包的名称
包的标识
层级编号
包的简要描述
“类”的一览表
序号
类名
类标识
归属包的标识
父类
层级编号
XX逻辑包设计
注8:
从本节开始,对每个类包的类图进行说明。
包的类图
注9:
画出包的静态类图,简要介绍包中类的组成。
类的说明
注10:
本节描述逻辑包中类与UseCase功能/辅助功能的映射关系及类的物理位置。
类与UseCase功能/辅助功能的映射关系一览表
序号
类名
类标识
实现功能
对应的UseCase功能/辅助功能
XX包中类的物理位置
序号
类标识
程序库名称
备注
YY逻辑包设计
包的类图
类的说明
执行概念
注11:
本节描述各包中类的执行概念。
应包含表示各包中类之间动态关系的图示和说明。
包级执行设计
包间的过程图
注12:
画出类包一级的过程图。
根据需要可配以文字说明。
包间的序列图
注13:
画出类包间执行序列图,来描述类包间的执行时序以及消息等其它关系。
对每一各序列图引用主事件流(MainFlow)以及子事件流(Subflow)来说明正常的执行控制过程,执行时的中断处理或异常处理可通过备选事件流(AlternativeFlow)来说明。
XX包执行设计
注14:
以下各小节可根据具体需要进行裁剪,各小节顺序可调整。
包内的序列图
注15:
分小节对各个执行重要功能的类包画出它们内部各类或对象之间的序列图。
同时配以适当的文字说明。
状态图
注16:
分小节画出其状态对其控制功能有重要影响的类的状态图,同时可描述出该类对象的生命周期。
进程转换状态图
注17:
分小节画出执行时进程的动态创建与删除图示。
并发处理
注18:
用文字、表格或合适的工具说明并发执行的激活点等动态行为。
外部接口设计
注19:
本节描述软件的外部接口特性
只描述对软件需求规格说明(SRS)中的接口需求部分做出修改或增加的接口,其余相同的部分可在此引用;
如果本节部分内容已在接口设计说明(IDD)中给出,则在此引用不必具体描述。
如接口设计说明中没有提供,那么一定要在此处给出。
外部接口示意及标识
注20:
画出接口示意图,为清楚表达出外部实体与软件内部模块的关系,要求画外部接口时直接与模块关联。
外部接口一览表
序号
接口名称
接口标识
功能描述
接口类型
优先级别
发送方
接收方
运行状态和方式集合
接口类型,如:
实时数据传送、数据的存储和检索等;
当接口有优先级要求时(如同一个接口有多个接收方),可指出它们之间的优先级别;
说明作为发送方/接收方的模块时,填写模块名称,以明确表达接口实体关系。
外部实体可用名字、编号、版本和文档引用等标识。
以下所有外部接口表格中的发送方/接收方均按此方式标识;
若该软件在《系统/子系统需求规格说明》中被指明处于多个运行状态和方式,则应在此给出该接口所对应的运行状态
外部接口描述
注21:
如果所有外部接口的通信方法特性以及协议特性相同,可放在前面一起说明;个别外部接口这两方面若有差别,应在它的特性说明部分另外给出。
此处提供的外部接口各个特性的列表只抽取了该特性的部分重要因素。
编写文档时可参考《系统/子系统需求规格说明》相应部分的详细列表,结合具体情况对它们进行裁剪。
通信方法特性
外部接口的通信方法特性
通信方法名称
通信方法标识
通信链路/带宽/频率特性
数据传送特性
传输服务
其它特性
适用的接口名称/标识
注22:
数据传送特性,包括传送速率、周期或非周期以及传送间隔;
传输服务,包括:
优先级别和等级;
其它特性,可包括:
安全性/保密性/私密性方面的考虑,如:
加密、用户鉴别、隔离、审计等;流控制(如:
序列编号和缓冲区分配);消息格式化;路由、寻址、命名约定等内容。
协议方法特性
外部接口的协议方法特性
协议方法名称
协议方法识符
优先级/层
分组
同步
其它特性
适用的接口名称/标识
注23:
分组,包括:
分段和重组、路由、寻址;
同步,包括:
连接的建立、维护、终止;
其它特性,可包括:
合法性检查、错误控制和恢复过程;状态、标识、任何其它的报告特征等内容。
(外部接口的名称和项目唯一标识符)
注24:
从7.2.3开始编号;
本节所属的各小节只针对一个外部接口的设计进行详细说明。
数据元素特性
注25:
说明接口实体必须提供、存储、发送、访问、接收的单个数据元素的特性。
(接口名称)的数据元素特性
数据元素名称
数据元素标识
用途
数据类型
数据长度
范围或精度
发送方
接收方
其它特性
注26:
名称,可包括:
非技术(自然语言)名称;军用标准数据元素名称;技术名称(如代码或数据库中的变量或字段名);缩写名或同义名;
数据类型,如字母数字、整数等;
数据长度,包括数据大小和度量单位;
其它特性,包括优先级别、时序、频率、容量、序列、其它的约束条件,如:
数据元素是否可被更新、业务规则是否适用;保密性和私密性的约束等。
数据元素集合体特性
注27:
说明接口实体必须提供、存储、发送、访问、接收的数据元素集合体的特性。
(接口名称)的数据元素集合体特性
数据元素集合体名称
项目唯一标识符
用途
集合体类型
包含的数据元素名称
数据元素序号
发送方
接收方
其它特性
集合体类型,如记录、消息、文件、数组、显示、报表等。
数据元素序号,指该数据元素在集合体中的顺序;
其它特性,包括集合体间的关系,如排序/访问特性;显示和其它输出的视听特性;优先级别、时序、频率、容量、序列、其它的约束条件,如:
数据元素是否可被更新、业务规则是否适用;保密性和私密性的约束等。
通信方法特性
注28:
若本接口的通信方法与其它外部接口不同,则按7.2.1节的形式在此给出。
否则,本小节应省略。
协议方法特性
注29:
若本接口的协议方法与其它外部接口不同,则按7.2.2节的形式在此给出。
否则,本小节应省略。
其它接口特性
注30:
描述接口其它所需的特性,如:
接口实体的物理兼容性(尺寸、容限、负荷、电压和接插件兼容性等)。
若说明某个接口特性时,省略了7.2.3.3和7.2.3.4节的内容,本小节的编号应为7.2.3.3。
内部接口设计
注31:
参考软件需求规格说明(SRS)中的UseCase结构图,画出接口示意图。
为避免重复或混乱,本节只要求画出最底一层软件模块之间的接口关系。
但是为了表达出上级的软件模块的接口关系,在描述最底一层软件模块之间接口的发送方和接收方时,须按“较高一级的软件模块名称:
下一级的软件模块名称:
...:
最底层的软件模块名称”的形式来描述,其中“较高一级的软件模块”可上溯到发送方和接收方的上级是同一个软件模块时为止;其它约定及格式参见外部接口部分。
与上级文档的追溯关系
正向追溯
正向追溯表
序号
上级文档被追踪内容的名称/标识
本文档中被追踪内容的名称/标识
备注
注32:
追溯粒度大小应合理
“上级文档被追踪内容的名称/标识”一栏中可根据项目具体情况填写,如“软件需求的名称/标识”或“界面需求名称/标识”等等。
“本文档中被追踪内容的名称/标识”一栏中可根据项目具体情况填写,如“包的名称/标识”或“类的标识”等等。
如果上一级文档由多份文档组成,应标明上一级文档的名称/标识
逆向追溯
逆向追溯表
序号
本文档中被追踪内容的名称/标识
上级文档被追踪内容的名称/标识
备注
注33:
追溯粒度大小应合理
“上级文档被追踪内容的名称/标识”一栏中可根据项目具体情况填写,如“软件需求的名称/标识”或“界面需求名称/标识”等等。
“本文档中被追踪内容的名称/标识”一栏中可根据项目具体情况填写,如“包的名称/标识”或“类的标识”等等。
如果上一级文档由多份文档组成,应标明上一级文档的名称/标识