管理系统编辑软件informaker详细设计说明书.docx
《管理系统编辑软件informaker详细设计说明书.docx》由会员分享,可在线阅读,更多相关《管理系统编辑软件informaker详细设计说明书.docx(13页珍藏版)》请在冰豆网上搜索。
管理系统编辑软件informaker详细设计说明书
详细设计说明书模板
目录
第一章导言2
1.1目的2
1.2范围2
1.3术语定义2
1.4相关文档3
1.5参考资料3
第二章功能模块实现设计4
2.1公用模块实现设计4
2.2专用模块实现设计5
2.3存储过程实现设计6
2.4触发器实现设计7
第三章外部接口实现设计8
3.1外部接口1实现设计8
3.2外部接口2实现设计8
第四章其它实现设计10
4.1部门角色授权设计10
4.2其它详细设计10
第五章程序文件清单10
文档类别使用对象
文档类别
本文档是软件系统详细设计说明书的模板,是详细设计说明书的书写标准及规范,是技术文档。
使用对象
该文档使用人员包括:
●系统分析人员
●系统设计人员
●系统编码人员
●系统测试人员
●系统维护人员
第一章
导言
本章对该文档的目的、功能范围、术语、相关文档、参考资料、版本更新进行说明。
一.1目的
本文档的目的旨在推动软件工程的规范化,使设计人员遵循统一的详细设计书写规范,节省制作文档的时间,降低系统实现的风险,做到系统设计资料的规范性与全面性,以利于系统的实现、测试、维护、版本升级等。
详细设计的详细程度,应达到可以编写程序的水平。
一.2范围
本文档用于软件设计阶段的详细设计,它的上游(依据的基线)是概要设计说明书,它的下游是源程序清单及单元测试计划,并为单元测试报告提供测试依据。
软件详细设计的范围是:
各子系统的公用模块实现设计、专用模块实现设计、存储过程实现设计、触发器实现设计、外部接口实现设计、部门角色授权设计、其它详细设计等。
按照三层结构(B/A/S)的布局,详细设计应从下面三个方面进行:
数据库服务器上的面向数据的设计:
数据字典物理设计、基本表物理设计、中间表物理设计(报表设计)、临时表物理设计、视图物理设计、存储过程物理设计、触发器物理设计;
应用服务器上的面向业务逻辑的设计:
接口数据设计、中间件设计、数据通讯传输设计、可视组件设计、非可视组件设计、角色授权设计、功能点设计(功能列表设计);
浏览器上的面向对象的设计:
录入修改界面设计、浏览查询界面设计、登录注册界面设计。
一.3术语定义
序号
术语名称
术语定义
1
详细设计
在概要设计的基础上,对其功能模块或部件进行实现设计,使编程人员据此能顺利书写出程序代码。
2
存储过程
存放在数据库服务器上的一段程序,它能被其它程序调用,以完成对数据库表的某些规定操作。
3
触发器
存放在数据库服务器上的一段程序,当触发条件满足时它就被执行,以完成对数据库表的某些规定操作。
4
算法
详细设计中实现某项功能的数据处理方法及处理流程。
一.4相关文档
1.源程序清单
2.单元测试计划及报告
3.用户使用手册
一.5参考资料
4.软件需求规格说明书
5.概要设计说明书
6.软件合同
7.命名规范
第二章
功能模块实现设计
详细设计是面向模块的,或者说是面向部件(组件或构件)的,不是面向组织结构或部门单位的。
一个组织或单位,根据角色的授权,可以挂上某些功能模块。
若为C/S或B/A/S结构,则要说明该模块运行在哪一层上。
二.1公用模块实现设计
公用模块的提取与设计特别重要,设计它的目的是为了复用,因此它直接影响到系统的详细设计、编程、运行的质量。
公用模块设计包括如下内容:
2.1.1
8.模块编号:
G-1
9.模块名称:
运行库
10.模块功能:
用于各模块运行所需的库
11.模块背景描述:
在该库里包含了各模块建立自己所需的数据和结构的各类程序及软件,是整个软件运行及功能实现的基础和必备,是软件不可或缺的部分。
12.模块算法设计:
调用参数的描述:
相应的选择数据,基调用的对应程序
操作对象的描述:
该功能需要读入相应的选择数据,并根据相应的选择运行对应的程序
特别引用的描述:
需要调用对应程序所需的数据
操作流程的描述:
1)读入选择数据,并进行相应判断
2)根据选择运行程序。
模块调用方法:
在程序运行初期,利用使用者根据提示所选择的调用数据调用相关程序。
当输入数据正确时正常运行相关程序;如果数据不正确进行提示,并自动恢复至初始界面。
IF软件通过接口调用了计算机操作系统的某执行库
THEN执行该指令,软件执行调用函数
ELSEIF调用的库不存在
THEN提示“运行库xx调用失败,缺乏相应的软件”
ENDIF
ENDIF
7.模块编写者:
黄健鸿
8.模块编写日期:
2012/4/12
9.模块修订者:
马博强
10.模块修订日期:
2012/4/13
11.模块测试者:
黄健鸿
12.模块测试日期:
2012/4/15
2.1.2
1.模块编号:
G-3
2.模块名称:
软件升级
3.模块功能:
用于更新软件
4.模块背景描述:
软件运行的过程中数据或者是要求可能会发生变化,有时更有可能影响到软件的正常运行和基本功能的实现,因此软件需要及时更新。
即及时检查软件的运行情况,提醒用户更新或者系统自动更新。
5.模块算法设计:
IF用户双击update程序
IF软件正在运行
提示“软件正在运行,请关闭软件”
ELSE
IF互联网无法连接
提示“互联网连接失败,请重试”
ELSE
软件通过互联网连接到官网的更新库,检查版本
IF用户使用版本为最新
THEN提示“已使用最新的版本”
ELSE下载相关文件,进行覆盖
ENDIF
ENDIF
ENDIF
ENDIF
调用参数的描述:
用户向计算机操作系统发出的执行指令
操作对象的描述:
update软件
操作流程的描述:
1)检查文件的内容
2)如果有新的数据,将其更新到现有文件
6.模块调用方法:
内部调用,手动或者设置为自动更新。
7.模块编写者:
黄健鸿
8.模块编写日期:
2012/4/12
9.模块修订者:
马博强
10.模块修订日期:
2012/4/13
11.模块测试者:
黄健鸿
12.模块测试日期:
2012/4/15
二.2专用模块实现设计
1.模块编号:
M1-1
2.模块名称:
系统分析模块
3.模块功能:
分析用户的操作
4.模块背景描述:
考虑到直接将用户设定编译生成子程序的过程过于复杂,为了简化子程序编译模块的逻辑构成,利用HTML语言的思想,在HTML的语法和描述基础上,重新定义一些部分的结构和命名,将用户的具体设定直接抽象为方计算机易于识别的、逻辑性较强的“中介语言”
5.模块算法设计:
调用参数的描述:
将用户的操作数据作为参数
操作对象的描述:
调用模块中的中介语言生成程序
特别引用的描述:
引用相应的数据库
操作流程的描述:
1)识别用户的操作模块传递的数据
2)调用模块中的中介语言生成程序以生成相应的语言
3)将生成结果显示在用户的“详细设计面板”中,并保存至程序的缓存中
具体编译结果如下(一个范例)
IF用户选择创建系统生成
THEN让用户输入系统名,继续生成<系统名>
IF用户创建信息管理系统“副本”并分别署名为“一”和“二”
THEN继续生成<系统名>
IF用户在副本“一”中创建“页面”“A”,在副本“二”中创建“页面”“B”
THEN继续生成<系统名>
IF用户在页面A中某位置插入某大小的“层”内容为某图片,在B中某位置插入某大小的层,内容为文本
THEN继续生成<系统名>
ENDIF
ENDIF
ENDIF
ENDIF
该语言对用户设计的描述细节,将于HTML语言类似
本软件将在HTML的语法和描述基础上,重新定义一些内容,例如
System
Script
Page
page_name
linkstyle
serv_url
dat_attribute
struct
stru_mem
linkto
log_pri
系统
副本
页面
页面名
不同层内容之间的逻辑结构方式(线性、循环等等结构)
服务器端的地址
数据属性(动态、静态、更改条件等详见客户需求)
结构体
结构体成员
“层”中的数据与某结构体的联系
设置登陆用户权限
如遇其他需求,另行确定
6.模块调用方法:
内部调用。
用户执行相关操作时执行
7.模块编写者:
黄健鸿
8.模块编写日期:
2012/4/12
9.模块修订者:
马博强
10.模块修订日期:
2012/4/13
11.模块测试者:
黄健鸿
12.模块测试日期:
2012/4/15
1.编号:
M2-1
2.中文名:
文本编辑模块
3.模块功能:
用户可以编辑多媒体文件
4.模块背景描述:
当用户需编辑的相关媒体文件时,可以调用此模块;
5.模块算法设计:
IF用户使用文本编辑工具
THEN调用文本编辑工具程序
ENDIF
IF用户使用图片编辑工具
THEN调用图片编辑工具程序
ENDIF
IF用户使用表格编辑工具
THEN调用表格编辑工具程序
ENDIF
输入输出的描述:
使用软件中的编辑工具,设计相应的媒体文件,而后在页面的相应位置进行应用;
操作对象的描述:
主要针对各类媒体文件;
特别引用的描述:
编写特定的语言对系统已有的媒体文件进行直接调用;
操作流程的描述:
储存媒体文件,应用;
注意事项:
注意语言的正确编写;
6.模块编写者:
黄健鸿
7.模块编写日期:
2012,03,21
二.3存储过程实现设计
存储过程是一种特殊的公用模块,它在数据库服务器上执行,这里将它单独列出来,规定其详细设计模板为:
13.存储过程中文名:
resource信息存储
14.存储过程英文名(或拼音名):
sq_informaker-resourcesaving
15.存储过程功能:
存储过程用来记忆存储用户输入的信息,同时分析用户编辑的文本和数据结构,提醒用户不要输入非法字符和不符合规范的多媒体文件。
16.存储过程算法:
第一步,用户设计输入文本语言和多媒体文件;第二部,系统自动调用函数检测输入的语言和多媒体文件;第三步,将用户设计的内容传递给设计模块过程
17.存储过程调用方式:
软件内部程序调用相关代码。
18.存储过程入口参数:
int,char,nchar,text,date,time,bit,bool等或用户自己创建的表值参数
19.存储过程出口参数:
必须是OUTPUT参数,
20.模块编写者:
王云飞。
21.模块编写日期:
2012/4/13。
22.模块修订者:
胡国进。
23.模块修订日期:
2012/4/17。
24.模块测试者:
黄健鸿。
25.模块测试日期:
2012/4/18。
二.4触发器实现设计
触发器也是一种公用的模块,不过它是隐式执行,这里将它单独列出来,规定其详细设计模板为:
26.触发器中文名:
DDL触发器
27.触发器英文名(或拼音名):
28.触发器功能:
主要用于审核与规范对数据库中表,触发器,视图等结构上的操作。
比如在修改表,修改列,新增表,新增列等。
它在数据库结构发生变化时执行,我们主要用它来记录数据库的修改过程,以及限制程序员对数据库的修改,比如不允许删除某些指定表等。
29.触发器算法:
用形式语言详细描述其算法分析,使编程人员据此能顺利书写程序。
DELIMITER|
CREATETRIGGER``.``
<[BEFORE|AFTER]><[INSERT|UPDATE|DELETE]>
ON
FOREACHROW
BEGIN
--dosomething
END|
30.触发器激活条件:
它在数据库结构发生变化时执行
31.触发器编写者:
黄健鸿。
32.触发器编写日期:
2012.4.26
33.触发器修订者:
写上修订者姓名。
34.触发器修订日期:
写上修订日期:
yyyy/mm/dd。
35.触发器测试者:
写上测试者姓名。
36.触发器测试日期:
写上测试日期:
yyyy/mm/dd。
注意:
过多地使用触发器反而会使系统的效率降低。
因此,凡是能用存储过程代替触发器功能的地方,一律用存储过程来实现。
第三章外部接口实现设计
三.1外部接口1实现设计
37.接口中文名称:
软件接口
38.接口英文名称:
Softwareinterface
39.接口内容与功能:
与数据库连接,生成软件进行连接
40.接口硬件设施:
扫描器
41.接口软件或中间件:
RFID中间件,信息以消息的形式,从一个程序传送到另一个或多个程序;功能:
传递信息,解译数据、安全性、数据广播、错误恢复、定位网络资源、找出符合成本的路径、消息与要求的优先次序以及延伸的出错工具等;
使用方法:
以应用程序为中心通过特定的reader读取数据,并传送至后端系统的应用程序或数据库,从而达成与后端系统或服务串接的目的。
42.接口的数据结构:
非线性结构中的树形结构以及散列存储结构。
43.接口的传输频率(兆/秒):
1
44.接口带宽:
64kb/s.
45.接口协议:
Tcp/ip,udp,http等网络及数据传输协议。
46.接口程序的算法分析:
本软件采用当今主流的接口信息传输程序及算法主要以visualC++为主,在此不再赘述。
三.2外部接口2实现设计
47.接口中文名称:
Rj-45以太网接口
48.接口英文名称:
Rj-45internetinterface
49.接口内容与功能:
白橙、橙、白绿、蓝、白蓝、绿、白棕、棕的直通线或交叉线;通过线路与网络进行大量的数据调用与修改。
50.接口硬件设施:
计算机、交换机、集线设备、路由器。
51.接口软件或中间件:
RFID中间件,信息以消息的形式,从一个程序传送到另一个或多个程序;功能:
传递信息,解译数据、安全性、数据广播、错误恢复、定位网络资源、找出符合成本的路径、消息与要求的优先次序以及延伸的出错工具等;
使用方法:
以应用程序为中心通过特定的reader读取数据,并传送至后端系统的应用程序或数据库,从而达成与后端系统或服务串接的目的。
52.接口的数据结构:
非线性结构中的网状结构及链式存储结构。
53.接口的传输频率(兆/秒):
10M/s。
54.接口带宽:
10M。
55.接口协议:
IEEE802.3。
56.接口程序的算法分析:
本软件采用当今主流的接口信息传输程序及算法主要以tuborC++为主,在此不再赘述。
第四章
其它实现设计
四.1部门角色授权设计
授权表的横坐标表示角色(部件、单位或岗位),纵坐标表示功能模块,“●”表示授权。
该授权表是工作站上菜单设计的依据。
部门
模块
角色1
角色2
角色3
角色4
角色5
模块中文名1
模块英文名1
●
模块中文名2
模块英文名2
●
●
模块中文名3
模块英文名3
●
●
●
模块中文名4
模块英文名4
●
●
模块中文名5
模块英文名5
●
●
●
模块中文名6
模块英文名6
●
●
模块中文名7
模块英文名7
●
模块中文名8
模块英文名8
●
●
模块中文名9
模块英文名9
●
●
四.2其它详细设计
根据需要进行设计。
第五章程序文件清单
子系统名称
子系统功能简述
子系统程序名
界面层系统
用于构建用户的编辑平台
Inforworker
业务层系统
完成一定的软件功能
Business
资源层系统
软件的基本执行资源、数据库
Resource
扩展功能系统
软件维护及扩展功能
Update