软件设计说明书
蓄电池检测单元
软件设计说明书
拟制日期
评审日期
批准日期
修订记录
目录
软件设计说明书编写规范 (2)
一、编写目的 (4)
二、应用文档..................................................................................... 错误!未定义书签。
三、要求及内容................................................................................. 错误!未定义书签。
2.1编写格式要求............................................................................. 错误!未定义书签。
2.2说明书内容................................................................................. 错误!未定义书签。
2.2.1说明书目的 (4)
2.2.2参考资料及文档 (4)
2.2.3设计原则 (4)
2.2.4接口描述 (5)
2.2.5功能描述 (6)
2.2.6接口协议 (6)
2.2.7编程协定 (6)
2.2.8数据结构 (7)
2.2.9逻辑结构 (7)
2.2.10程序流程 (8)
2.2.11源文件列表 (10)
2.2.12其他 (10)
2.3文档修订历史 (10)
四、编写文档注意事项..................................................................... 错误!未定义书签。
五、样例及模板文档......................................................................... 错误!未定义书签。
一、编写目的
项目主管或软件工程师根据《软件需求说明书》,对程序系统的设计考虑,包括程序系统的基本处理流程、程序系统的组织结构、模块划分、功能分配、接口设计。运行设计、数据结构设计和出错处理设计等,需编写《软件设计说明书》,本文档供项目主管和软件工程师遵循《用户需求规格说明书》(见《用户需求规格说明书编写规范》)如何编写《软件设计说明书》所编写的规范。
1.1.1说明书目的
软件设计说明书又可称系统设计或程序设计,这里所说的系统是指程序系统。编制的目的是说明对程序系统的设计考虑,包括程序系统的基本处理流程、程序系统的组织结构、模块划分、功能分配、接口设计。运行设计、数据结构设计和出错处理设计等;更详细设计说明是将一个软件系统各个层次中的每一个程序(每个模块或子程序)的设计考虑,此时可对程序较为详细设计,如果一个软件系统比较简单,层次很少,可直接编写系统设计,本说明书可供软件设计师、项目主管及测试人员使用。
1.1.2参考资料及文档
列出编写本说明书时参考的文件(如经核准的计划任务书或合同、上级机关的批文等)、资料、技术标准,以及他们的作者、标题、编号、发布日期和出版单位等。
1.1.3设计原则
1.1.3.1界面设计原则
设计大体遵循以下原则:
A.界面简洁大方
B.附有详细的说明
C.遵循用户的操作习惯
D.具有指引性
E.色调协调
1.1.3.2数据结构设计原则
设计大体遵循以下原则:
A.每个数据表都设有主键,做为流水号,放在第一字段;字段名使用中文字段命
名。
B.字段类型使用字符型,整形,浮点型,时间型及二进制型。
C.只使用数据库的存储功能,数据表间的关系以程序逻辑实现控制。
1.1.3.3程序结构设计原则
程序结构设计,对软件程序做出一个划分,应根据具体情况不同,做出不同的调整,程序结构设计过程中,经常用到的程序结构划分方式包括:
A.根据功能划分
B.根据技术划分
C.根据程序借口划分
D.程序结构划分应大体遵循以下原则:
1)应以用户为中心划分
2)围绕中心问题划分
3)符合结构清晰,层次简明的原则
1.1.3.4框图、UML协作图和UML时序图
程序需包含系统结构框图,较为复杂时应提供相应的UML协作图(见《UML时序图规范说明书》)。
在涉及到复杂方法体时应引用程序员为方法或过程编写的UML时序图。
1.1.4接口描述
1.1.4.1软件模块分配
A.数据处理软件模块;
数据处理软件模块是整个软件的基础,为整个软件提供分析数据,其接口要求如下表:
[此处加入接口要求表]
B.数据分析软件模块;
分析软件模块包括电能、电压、电量、谐波4个模块,是整个软件的功能实现,实现软件的分析功能,其接口要求分别如表1,表2,表3,表4及表5:
[此处加入表]
说明:表5 是xxxxxx.
C.报表软件模块;
报表软件模块是为整用户提供报表功能,其接口要求如下表:
[此处加入接口要求表]
D.主界面软件模块;
主界面软件模块是整个软件的总控,为软件的各个模块提供接口,其接口要求如下表:
[此处加入接口要求表]
由于上表较长,表中分为3部分,表中第2部分说明为:xxxxxxxxxxxxx
1.1.4.2模块之间的关系
[此处加入模块之间的关系]
1.1.5功能描述
A.功能说明
[此处加入功能说明]
B.功能框图
[此处加入功能框图]
C.时顺图
复杂功能可用UML时序图(见《UML时序图规范说明书》)表示。
1.1.6接口协议
[此处加入接口协议]
1.1.7编程协定
A.操作系统
windows NT 操作系统,或windows 98 操作系统.
B.编程工具
Delphi 7.0 编程工具,由于该软件工具具有可视化编程,对象化处理的优点,利于我们快速完成编程工作,减少编程BUG ,提高工作效率,降低开发成本;因此,我们确定使用该软件为软件的主界面,分析,及报表功能的开发平台。
VC++ 编程工具,由于该软件具有编程深度高,实现灵活,有利于完成我们软件中的入库程序。
另外,根据本软件的特点:xxxxxxxxxxxxx
C.编辑、调试、联接程序
[此处加入编辑、调试、联接程序]
D.编译工具
[此处加入编译工具]
E.模拟、仿真数据
模拟数据使用过去的真实数据,数据如下:
[此处加入数据]
过程、方法如下:
[此处加入过程、方法]
F.诊断、测试程序
[此处加入诊断、测试程序]
G.检测程序
[此处加入检测程序]
1.1.8数据结构
A.物理结构
[此处加入物理结构]
B.库结构
[此处加入库结构]
C.链路结构
[此处加入链路结构]
D.表结构
[此处加入表结构]
E.内部存贮区分配
[此处加入内部存贮区分配]
1.1.9逻辑结构
A.常量定义
[此处加入常量定义]
B.变量定义
C.结构定义
[此处加入结构定义]
D.全局定义
[此处加入全局定义]
1.1.10程序流程
A.主程序
1)功能
[此处加入功能]
2)入口参数
[此处加入入口参数]
3)出口参数
[此处加入出口参数]
4)局部变量
[此处加入局部变量]
5)函数调用
[此处加入函数调用]
6)对象调用
[此处加入对象调用]
7)流程图
[此处加入流程图]
8)UML时序图(见《UML时序图规范说明书》)
仅用于复杂程序流程,一般可用流程图表示即可。
B.子程序
1)功能
[此处加入功能]
2)入口参数
[此处加入入口参数]
3)出口参数
[此处加入出口参数]
4)局部变量
5)函数调用
[此处加入函数调用]
6)流程图
[此处加入流程图]
7)UML时序图或协作图(见《UML时序图规范说明书》)仅用于复杂程序流程,一般可用流程图表示即可。
C.信息及通讯
1)信息类型
[此处加入信息类型]
2)信息等级
[此处加入信息等级]
3)功能
[此处加入功能]
4)入口参数
[此处加入入口参数]
5)出口参数
[此处加入出口参数]
6)局部变量
[此处加入局部变量]
7)队列
[此处加入队列]
8)流程图
[此处加入流程图]
D.对象
1)功能
[此处加入功能]
2)入口参数
[此处加入入口参数]
3)出口参数
[此处加入出口参数]
4)变量(私有,公有,重载等)
[此处加入变量]
5)函数
[此处加入函数]
6)属性
[此处加入属性]
7)流程图
[此处加入流程图]
1.1.11源文件列表
[此处加入源文件列表]
列表如下:
1.1.12其他
[相关参考资料及文档其他信息] 1.2文档修订历史
文档修订列表如下:
批准人签字如下