完整版软件概要设计实用模板.docx
《完整版软件概要设计实用模板.docx》由会员分享,可在线阅读,更多相关《完整版软件概要设计实用模板.docx(16页珍藏版)》请在冰豆网上搜索。
完整版软件概要设计实用模板
XX概要设计说明书
XX概要设计说明书
关键词:
能够体现文档描述内容主要方面的词汇。
摘要:
缩略语清单:
对本文所用缩略语进行说明,要求提供每个缩略语的英文全名和中文解释。
缩略语
英文全名
中文解释
1
简介
2
2.1目的
2.2
这部分要描述文档的目的。
应该指明读者。
范围
2.3
软件名称
2.3.1
对软件命名
软件功能
2.3.2
解释软件产品将完成或不完成的功能(可以直接描述也可以参考相关文档)
软件应用
2.3.3
描述软件的应用(可直接描述也可以参考其他软件文档)
实现系统环境
2.4
描述本软件的硬件应用平台(主要涉及关键器件的介绍和环境组网方式)
器件特性描述
2.4.1
本器件所支持的规格、工作模式及其异同
器件工作原理介绍
2.4.2
Thedescriptionoftheworkprincipleofthedeviceweusedinoursolution.
关键寄存器介绍
2.4.3
Thedescriptionoftheregistersusedintheworkmodeoursolution.
3概要设计
4
第0层设计描述
4.1
软件系统上下文定义
4.1.1
描述系统如何与外部实体一道组成功能实体(一般用图描述)
外部实体属性描述只限于软件设计和描述相关的属性。
设计思路(可选)
4.1.2
基本设计思路
4.1.2.1
说明系统采取的基本设计思路,概要描述为什么采取本方案。
设计约束
4.1.2.2
1遵循标准
2
描述本软件所遵循的标准、规范
硬件限制
3
描述本软件系统实现的硬件限制
技术限制
4
描述本软件的技术限制
安全性和可靠性设计方案
4.1.2.3
遵循标准
5
描述本软件所遵循的标准、规范
硬件限制
6
描述本软件系统实现的硬件限制
技术限制
7
描述本软件的技术限制
其他
4.1.2.4
描述其他有关的设计考虑
第一层设计描述
4.2
系统架构(功能分解和物理分解)
4.2.1
描述组成软件系统的构件(子系统、模块),描述之间的“静态”关系。
一般采用系统方框图的形式。
要按照子系统组成系统,模块组成子系统的方式组织描述。
系统方框图应能规定出系统的整体架构,说明组成系统的各部分是如何搭配成一个完整系统的。
系统方框图应画成二种:
一种是功能性的,说明系统有哪些功能?
应由哪些功能模块来实现?
画出这些功能模块之间、本系统与其它接口系统之间的逻辑关系;描述它们间的接口方式,遵循的协议规范等。
如果是升级类产品,在原有功能方框框图上增加、删除、修改。
另一种是物理性的,说明系统由具体的哪些软件模块来实现。
注:
对于简单功能的软件系统,可省略“功能分解”(功能框图)这一步骤,而直接进行“物理分解”(物理框图)。
可测性设计的整体结构描述也应在这里给出。
说明整体系统可测性方面的层次结构,之间的逻辑关系,主要的功能接口定义,子系统、模块应具有的主要可测性规格与设计描述。
功能实现与模块/子系统的关系
4.2.2
描述系统是如何运作以实现系统需求的。
对于可测性性设计的功能,如果有单独的功能模块则在下面用单独的小节进行功能实现原理描述,如果只是某些功能需求的一部分功能,则在相应的功能需求中进行说明。
用如下矩阵图说明各项功能需求的实现与各模块/子系统的分配关系:
模块/子系统1
模块/子系统2
……
模块/子系统n
功能需求1
√
功能需求2
√
……
功能需求n
√
√
分解描述
4.2.3
模块/子系统描述
4.2.3.1
8模块/子系统1描述
9
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
并发进程描述
4.2.3.2
本节描述系统中的并发进程。
对于外部实体,从属属性不必描述。
10进程1描述
11
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
数据描述
4.2.3.3
本节描述系统中的数据结构。
外部数据实体不必描述。
12数据实体1描述
13
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
接口描述
4.2.4
本节描述软件系统中设计实体(如模块/子系统)的接口.
接口描述可以使用接口文件,参数表。
对于外部实体只有同被描述软件相关的接口才需描述。
模块/子系统接口
4.2.4.1
本节描述模块/子系统的接口。
14模块/子系统1接口描述
15
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
进程接口
4.2.4.2
本节描述进程的接口。
16进程1接口描述
17
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
第二层设计描述(Optional)
4.3
.L1中定义的每个实体的进一步设计在下面的章节进行描述。
对每个模块重复使用下述的格式。
模块1名称
4.3.1
不要写直接“模块1名称”,用简短的词语命名模块.
模块架构(物理分解)
4.3.1.1
运用物理框图描述组成软件模块的构件(子模块),描述之间的“静态”关系。
功能实现与子模块的关系
4.3.1.2
用如下矩阵图说明模块的功能需求的实现与各子模块的分配关系:
子模块1
子模块2
……
子模块n
模块的功能需求1
√
模块的功能需求2
√
……
模块的功能需求n
√
√
分解描述
4.3.1.3
描述模块的分解,并描述每个子模块的功能等属性。
.1子模块描述
.2
a)子模块1描述
b)
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
.3并发进程描述
.4
本节描述模块中的并发进程。
对于外部实体,从属属性不必描述。
a)进程1描述
b)
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
.5数据描述
.6
本节描述模块中的数据结构。
外部数据实体不必描述。
a)数据实体1描述
b)
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
接口描述
4.3.1.4
描述模块内部的接口关系,如两个子模块间的接口等。
接口描述可以使用接口文件,参数表。
对于外部实体只有同被描述软件相关的接口才需描述。
.1子模块接口
.2
本节描述子模块的接口。
a)子模块1接口描述
b)
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
.3进程接口
.4
本节描述进程的接口。
a)进程1接口描述
b)
Describeasfollows按照以下格式描述:
Identification标识:
Type类型:
Purpose目的:
Functions功能列表:
4.4
数据库(可选)
4.5
实体、属性及它们之间的关系
4.5.1
本节列出所有的数据存储类的实体,详细描述实体的内容和并列出全部属性。
对每个属性,详细描述其数据库、数据大小、特定约束。
实体的所有约束及实体间的关系也要注明。
实体关系图
4.5.2
ThissectionshoulddisplaytheE-Rdiagramforalltheentitieslistedabove.
文件的组织
4.6
文件的命名方式
4.6.1
Thedescriptionoftheorganizationforthefilesanddirectoryofcodefile.
文件的组织目录结构
4.6.2
Thedescriptionofthesourcecodefiles’directoryorganization
参考资料清单:
4.6.3
请罗列本文档所参考的有关参考文献和相关文档,格式如下:
作者+书名(或杂志、文献、文档)+出版社(或期号、卷号、公司文档编号)+出版日期+起止页码
例如:
1D.B.Leeson,“ASimpleModelofFeedbackOscillatorNoiseSpectrum,”Proc.IEEE,pp329-330,February966(英文文章格式)
2
3D.Wolaver,Phase-LockedLoopCircuitDesign,PrenticeHall,NewJersey,1991(英文书籍格式)
4
5
6