目录
第一部分、引言 (2)
1.1编写目的 (2)
1.2背景 (3)
1.3定义 (3)
3.1程序描述 (5)
3.2整体结构 (5)
3.3性能 (5)
3.4输入输出项 (5)
3.5算法 (5)
3.6主要类的设计 (5)
3.7存储分配 (7)
3.8注释 (7)
3.9限制条件 (7)
3.10测试计划 (7)
3.11尚未解决的问题 (7)
4.1程序描述 (7)
4.2功能 (7)
4.3性能 (8)
4.4输入输出项 (8)
4.5限制条件 (8)
5设计特点 (8)
5.1通信便捷 (8)
5.2开发速度快 (8)
第六部分、项目分工 (8)
附录： (9)
第一部分、引言
1.1编写目的
此说明书在概要设计的基础上，对医院综合管理系统的各个模块，程序分别进行了实现层面上的要求和说明。在以下的详细设计报告中将对在本阶段中队系统所做的所有详细设计进行说明在本阶段中，确定应该如何具体的实现所要求的系统，以便在编码阶段可以吧这个描述直接翻译成用具体程序语言书写的程序。
主要工作包括：根据软件需求说明书所描述的数据，功能，运行，性能，需求，并依照概要设计说明书所确定的处理流程、总体设计、模块外部设计、设计软件系统的结构设计，逐个模块的程序描述（包括各模块的功能、性能、输入、输出、算法、程序逻辑、接口等）软件开发小组的产品实现成员应该阅读和参考此说明书，从而进行代码的编写，测试
1.2背景
说明：
A、软件系统的名称:中大型医院综合管理系统
B、任务提出者：小玩子团队
开发者：小玩子团队
用户：中大型医院相关的员工、需求分析员、系统设计人员
C、实现完成的系统将用在大型的服务器上，而作为子模块则有部门承担，即每个部门配置
PC
1.3定义
服务器端API：服务器端设计者通过规范的API文档，提供给客户端，以方便客户端的开发，使得同时进行，提高效率，节约时间。两端通过protocol（协议类）进行通信。
Gson：Google提供的一个类库。通过使用这个类库，可以把把对象转换成json格式的字符串，以方便在网络中的传输。也可反向将字符串转换成对象，这样带有方法地操作对象，可以有效，方便地保证信息的沟通。
Json：JavaScript Object Notation，是一种轻量级的数据交换格式。易于人阅读和编写，同时也易于机器解析和生成。它基于JavaScript的一个子集，JSON采用完全独立于语言的文本格式，这些特性使得JSON成为理想的数据交换语言。
1.4参考资料，相关的文件包括：
A、《项目需求说明》；小玩子团队编
B、《项目详细设计说明书》；小玩子团队编
C、《项目概要设计说明书》；小玩子团队编
参考资料：
《软件工程概论》
《软件文档编写》
第二部分、程序系统的结构
该系统为了两大部分：客户端与服务器端，中间通过protocol类通信。其中使用gson库来转换和逆向转换对象，实现标准包括：
1、客户端主程序
A、工程类型：JAV A项目；
B、工程名称：信息发布系统
C、编译生成文件：jar形式
D、引用的组件：JDK，Gson库
注：以上提供的是工具集合，具体用到的类都包含在里面
2、服务器端主程序：
服务器端程序以及数据库操作类（DBO）
3、服务器端数据库操作
验证用户，用户注册，更改密码，更新文档，新建文档，新建记录（包括浏览记录和回复记录），查看文档，删除文档，查看记录。
第三部分、基本操作部分界面设计如下图：
3.1程序描述
A、客户端窗体：
尽量友好的设计，让用户尽可能地关注信息的内容主体。
B、服务器端设计：
该窗体在设计上尽量的符合人们的使用习惯，并且在出现非法操作的情况下，有相应的提示信息输出。
3.2整体结构
系统的整体大致结构为下图：
3.3性能
灵活性：窗口响应绝大部分的快捷菜单和控制面板操作；
时间特性：响应鼠标单击的时间在2~3秒之间；
3.4输入输出项
输入的数据是户执行的各种操作，包括鼠标、键盘等操作。
输出是从数据库中读取的数据，或错误警告信息。
3.5算法
本部分没有采用自定义的算法。
3.6主要类的设计
用户类
数据库操作类（包括静态方法）
3.7存储分配
本程序在高级语言JAV A进行编码，直接的内存分配由JAV A运行时分配。
本组件内所依赖的变量、结构要求全部在组件元素内申明。
3.8注释
在代码的适当出有中文代码注释。
注释设计请参考《Visual Basic可视化程序设计》的附录部分。
3.9限制条件
所有用户的权限都经过严格设置，不能进行权限外的操作。用户组分为三组：管理员，用户和游客。
3.10测试计划
测试日期、测试人员安排请参考测试计划，测试用例的具体内容，请参考测试用例说明。
3.11尚未解决的问题
在文件中存储文档文件中，不能存储文件名相同，但类型不同的文档。可以通过在文件名中加入文档类型来解决。但因时间关系，尚未解决。
第四部分、其它附加功能及帮助系统
4.1程序描述
本程序设计是客户机和服务器机通过C/S模式，建立连接。在此基础上，进行信息的共享，发布等功能。系统的目的是为了方便用户的沟通。
4.2功能
主要功能就是给用户带来信息的沟通，交流的便捷。
4.3性能
灵活性：响应鼠标操作和键盘操作。
时间性：视网络响应速度而定。
4.4输入输出项
从键盘，鼠标按提示输入。
依服务器响应从界面输出响应信息。
4.5限制条件
在界面上控制输入输出，服务器端如果出错也会返回出错信息。
5设计特点
5.1通信便捷
本系统客户端与服务器端采用JSON格式作为信息载体，在开发中将信息作为对象，信息传递很便捷。
5.2开发速度快
由于使用通信协议约定，所以只要客户端与服务器端约定好通信协议API文档，即可以进行通信。而且直接对对象操作，不存在类型转换的问题。这样可以使客户端与服务器端开发同时在API文档的约定下进行，提高开发效率。
第六部分、项目分工
王佳龙:负责编写GUI部分代码，以及客户端部分的所有代码
戴清灏:编写服务器端代码，设计通信协议，以及对数据库的操作。负责编写详细设计文档。
华从男:各方面知识全面，负责组织工作，在软件测试方面有一定的能力。在软件开发过程负责测试文档等文档的编写。
王玮柯:负责测试，组织工作。
附录：
服务器端操作API文档（最少需要的参数，如不全服务器会返回type=“0”的信息）：
服务器和客户端之间的所有通信都封装在protocol对象中，通过对要发送的protocol对象进行set 和get操作就可以通信。
验证用户，用户注册，更改密码，更新文档，新建文档，新建记录（包括浏览记录和回复记录），查看文档，删除文档，查看记录
1.验证用户
name,pass,LimitsOfAuthority
返回：如验证通过则返回type=“11”,不通过则返回type=“12”
2.用户注册
name,pass,LimitsOfAuthority
返回：如注册成功则返回type=“21”,不成功则返回type=“22”
3.更改密码
name,pass,newPass
返回：如更改成功则返回type=“31”,不成功则返回type=“32”
4.查看文档
filename（可选，如为“”则查询本类的所有文档，不带全部内容）,filetype，replyAuthor(可选，如果filename不为“”则必须)
返回：如查看成功则返回则返回type=“41”,不成功则返回type=“42”;文档内容在content中，文档名列表在filenames[]中，对应的文档摘要在filesummaries[]中;回复内容在recordContents[]中，对应的回复作者在recordAuthors[]中
5.建立新文档
filename,filetype,content,author,filesummary
返回：如果建立成功则返回type=“51”,如不成功则返回type=“52”
6.修改文档
filename,filetype,newFilename,newFiletype,filesummary
返回：如果修改成功则返回type=“61”,如不成功则返回type=“62”
7.建立新记录
filename,filetype,recordContent,replyAuthor
返回：如果建立成功则返回type=“71”,如不成功则返回type=“72”
8.删除文档
filename,filetype
返回：如查询成功则返回type=“81”,如不成功则返回type=“82”
9.查看浏览记录
无
返回：如查看成功则返回type=“91”,如不成功则返回type=“92”,返回的记录内容在recordContents[]中，对应的作者在recordAuthors[]中
《XXXXXX》概要设计说明书 张三、李四、王五
1．引言 1．1编写目的 在本机票预定系统项目的前一阶段，也就是需求分析阶段中，已经将系统用户对本系统的需求做了详细的阐述，这些用户需求已经在上一阶段中对航空公司、各旅行社及机场的实地调研中获得，并在需求规格说明书中得到详尽得叙述及阐明。 本阶段已在系统的需求分析的基础上，对机票预定系统做概要设计。主要解决了实现该系统需求的程序模块设计问题。包括如何把该系统划分成若干个模块、决定各个模块之间的接口、模块之间传递的信息，以及数据结构、模块结构的设计等。在以下的概要设计报告中将对在本阶段中对系统所做的所有概要设计进行详细的说明。 在下一阶段的详细设计中，程序设计员可参考此概要设计报告，在概要设计对机票预定系统所做的模块结构设计的基础上，对系统进行详细设计。在以后的软件测试以及软件维护阶段也可参考此说明书，以便于了解在概要设计过程中所完成的各模块设计结构，或在修改时找出在本阶段设计的不足或错误。 1．2项目背景 机票预定系统将由两部分组成：置于个旅行社定票点的前台客户程序，以及置于航空公司的数据库服务器。本系统与其他系统的关系如下： 1．3定义 1．3．1 专门术语 SQL SERVER: 系统服务器所使用的数据库管理系统（DBMS）。 SQL: 一种用于访问查询数据库的语言 事务流：数据进入模块后可能有多种路径进行处理。 主键：数据库表中的关键域。值互不相同。 外部主键：数据库表中与其他表主键关联的域。 ROLLBACK: 数据库的错误恢复机制。 1．3．2 缩写
系统：若未特别指出，统指本机票预定系统。 SQL: Structured Query Language（结构化查询语言）。 ATM: Asynchronous Transfer Mode (异步传输模式)。 1．4参考资料 以下列出在概要设计过程中所使用到的有关资料： 1．机票预定系统项目计划任务书浙江航空公司1999/3 2．机票预定系统项目开发计划《**》软件开发小组1999/3 3．需求规格说明书《**》软件开发小组1999/3 4．用户操作手册（初稿）《**》软件开发小组1999/4 5．软件工程及其应用周苏、王文等天津科学技术出版社1992/1 6．软件工程张海藩清华大学出版社1990/11 7．Computer Network A.S.Tanenbaun Prentice Hall 1996/01 文档所采用的标准是参照《软件工程导论》沈美明著的“计算机软件开发文档编写指南”。 2．任务概述 2．1 目标 2．2 运行环境 系统将由两部分程序组成，安装在各旅行社客户机上的客户程序及航空公司内的数据服务器程序。 根据调研得知所有旅行社的计算机配置均在Pentium 133级别以上，客户程序应能够在Pentium 133级别以上, Win NT环境下运行。 2．3 需求概述 浙江航空公司为方便旅客，需开发一个机票预定系统。为便于旅客由旅行社代替航空公司负责为旅客定票，旅行社把预定机票的旅客信息，包括姓名、性别、工作单位、身份证号码、旅行时间、旅行目的地，输入机票预定系统的客户端程序，系统经过查询航空公司内的航班数据服务器后，为旅客安排航班，印出取票通知。旅客在飞机起飞前一天凭取票通知和帐单交款后取票，系统校对无误后即印出机票给旅客。 要求系统能有效、快速、安全、可靠和无误的完成上述操作。并要求客户机的界面要简单明了，易于操作，服务器程序利于维护。 2．4 条件与限制 3．总体设计 3．1 处理流程 下面将使用（结构化设计）面向数据流的方法对机票预定系统的处理流程进行分
以下是需求分析说明书、详细设计说明书、概要设计说明书样例 需要详细资料的去 https://www.doczj.com/doc/4214476590.html,/BBS/view.asp?ID={CA9329C0-93C5-4417-9170-452FF61E8C DB}&page=1下载 XX系统概要设计说明书 目录 1. 文档介绍1 1.1 文档目的1 1.2 文档范围1 1.3 读者对象1 1.4 参考文献1 1.5 术语与缩写解释1 2. 系统概述2 3. 设计约束2 3.1需求约束2 3.2隐含约束2 4. 设计策略3 4.1扩展策略3
4.2复用策略3 4.3折衷策略3 5．系统总体结构3 5.1、系统总体结构3 5.2、子系统功能及接口4 6. 子系统的结构与功能5 6.1、TERMSERV 5 7. 功能需求追溯5 8. 环境的配置5 9．其它6 附录 6 A、与主机接口6 B、与终端接口6 1. 文档介绍 1.1 文档目的 编写该文档的目的在于从总体设计的角度明确xxxx系统的功能和处理模式，明确与银联的接口，使系
统开发人员和产品管理人员明确产品功能，可以有针对性的进行系统开发、测试、验收等各方面的工作。 1.2 文档范围 1.3 读者对象 该文档的读者为用户代表、软件分析人员、开发管理人员和测试人员。 1.4 参考文献 《xxxx系统需求说明书》 1.5 术语与缩写解释 无 2. 系统概述 XX系统是以触摸屏为主要交互工具，帮助用户以自助方式做业务查询。本系统的主要功能包括：话费 查询、新业务介绍、网点分布查询、自助终端分布查询、电信新闻、交易监控、设备维护和监控等。本系 统的设计目标是保证系统可以7*24小时安全、高效无故障运行；业务人员可以轻松完成设备和交易的监控 、管理工作；报表种类齐全，可以满足业务人员各种帐务需求。 3. 设计约束
详细设计说明书 当前版本号：1.0 最后更新日期：2011-11-25 作者：员工王 授权人：部门经理
版本记录：
目录 目录 (3) 1引言 (4) 1.1目的 (4) 1.2项目背景 (4) 1.3参考资料 (4) 1.4阅读对象 (4) 1.5术语解释 (4) 2设计概述 (5) 2.1任务 (5) 2.2运行环境概述 (5) 3系统详细设计 (6) 3.1系统总体框架 (6) 3.2功能模块详细设计 (6) 3.3用户界面详细设计 (6) 4存储设计 (7)
1引言 1.1目的 [阐述文档输出：描述本文档对下一环节工作的影响和作用。] 1.2项目背景 [应包括： 项目的委托单位、开发单位和主管部门 该软件系统与其他系统的关系。] 1.3参考资料 [本小节应完整列出此详细设计说明书中其他部分所引用的任何文档。列出有关资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括： 项目经核准的计划任务书、合同或上级机关的批文； 项目开发计划； 需求规格说明书； 概要设计说明书； 测试计划（初稿）； 用户操作手册（初稿）； 文档所引用的资料、采用的标准或规范。] 1.4阅读对象 [概述本文档的读者、用途。] 1.5术语解释 [必须提供全部需求的术语、缩写词及略语的定义，以便对本文档进行适当的解释。]
2设计概述 2.1任务 [说明详细设计的任务及详细设计所要达到的目标。] 2.2运行环境概述 [对本系统所赖于运行的硬件，包括操作系统、数据库系统、中间件、接口软件、可能的性能监控与分析等软件环境的描述，及配置要求。]
3系统详细设计 3.1系统总体框架 包含两个图：系统结构图系统运行框架 数据结构的定义 3.2功能模块详细设计 1.函数申明 ,详细说明函数的功能,参数和返回值 2.伪代码 /流程图 如: (1)短消息列表模块 For (i=0; i<短消息的条数; i++) ｛ 打印输出 ｝ 3.3用户界面详细设计 [规定人机界面的内容、界面风格、调用方式等，包括所谓的表单设计、报表设计和用户需要的打印输出等设计。此部分内容可能比较多。]
1 引言 (3) 1.1 编写目的 (3) 1.2 背景 (3) 1.3 定义 (3) 1.4 参考资料 (3) 2 总体设计 (3) 2.1 简述 (3) 2.2 架构设计 (4) 2.2.1 系统逻辑架构图 (4) 2.2.2 系统物理架构图 (4) 2.2.3 顶层系统包图 (5) 2.2.4 业务类包图 (6) 2.2.5 子系统关系图 (6) 2.3 接口设计 (6) 2.3.1 界面框架设计 (6) 2.3.2 外部接口设计 (7) 3 子系统设计 (7) 3.1 基础信息子系统 (7) 3.1.1 子系统说明 (7) 3.1.2 类图 (8) 3.1.3 类说明 (12) 3.1.4 界面设计 (19) 3.2 我的工作台子系统 (21) 3.2.1 子系统说明 (21) 3.2.2 类图 (22) 3.2.3 类说明 (26) 3.2.4 界面设计 (32) 3.3 工作进展子系统 (33) 3.3.1 子系统说明 (33) 3.3.2 类图 (34) 3.3.3 类说明 (34) 3.3.4 界面设计 (34) 3.4 信息发布子系统 (36) 3.4.1 子系统说明 (36) 3.4.2 类图 (36) 3.4.3 类说明 (37) 3.4.4 界面设计 (38) 3.5 系统管理子系统 (38) 3.5.1 子系统说明 (38) 3.5.2 类图 (39) 3.5.3 类说明 (39) 3.5.4 界面设计 (40) 3.6 个人设置子系统 (41)
3.6.1 子系统说明 (41) 3.6.2 类图 (42) 3.6.3 类说明 (43) 3.6.4 界面设计 (44) 4 约束和假定 (45) 5 系统数据结构设计 (45) 5.1 逻辑结构设计 (45) 5.1.1 角色表（PUBLIC_ROLE） (46) 5.1.2 权限表（PUBLIC_PRIVILEGE） (46) 5.1.3 角色权限表（PUBLIC_ROLEPRIVILEGE） (46) 5.1.4 部门表（PUBLIC_ DEPT） (46) 5.1.5 岗位表（PUBLIC_POST） (47) 5.1.6 员工表（PUBLIC_MEMBER） (47) 5.1.7 工作任务表（WORKPLAN_ TASK） (48) 5.1.8 任务分派表（WORKPLAN_ ALLOTTASK） (48) 5.1.9 工作计划表（WORKPLAN_ PLAN） (48) 5.1.10 计划任务表（WORKPLAN_ PLANTASK） (49) 5.1.11 工作日志表（WORKPLAN_ WORKLOG） (49) 5.1.12 工作汇报表（WORKPLAN_ WORKREPORT） (50) 5.1.13 信息发布表（PUBLIC_ PUBLISHINFO） (50) 5.1.14 收件箱表（PUBLIC_INBOX） (50) 5.1.15 系统操作日志表（PUBLIC_OPERA TELOG） (51) 5.1.16 个人提醒设置表（PUBLIC_EVENTS） (51) 5.1.17 系统表（PUBLIC_SYSTEM） (52) 5.1.18 系统功能模块表（PUBLIC_SYSTEMMODULE） (52) 5.2 物理结构设计 (52) 5.3 数据结构与程序的关系 (52) 6 系统出错处理设计 (52) 6.1 出错信息 (52) 6.2 补救措施 (53) 6.3 系统维护设计 (53)
需求分析说明书、概要设计说明书、详细设计说明书部分样例 作者：rjgczj 出处：csai论坛 以下是需求分析说明书、详细设计说明书、概要设计说明书样例，需要的朋友来信联系。rjgczj@ For personal use only in study and research; not for commercial use XX系统概要设计说明书 目录 1. 文档介绍1 1.1 文档目的1 1.2 文档范围1 1.3 读者对象1 1.4 参考文献1 1.5 术语与缩写解释1 2. 系统概述2 3. 设计约束2 3.1需求约束2 3.2隐含约束2 4. 设计策略3 4.1扩展策略3 4.2复用策略3 4.3折衷策略3 5．系统总体结构3 5.1、系统总体结构3
5.2、子系统功能及接口4 6. 子系统的结构与功能5 6.1、TERMSERV 5 7. 功能需求追溯5 8. 环境的配置5 9．其它6 附录 6 A、与主机接口6 B、与终端接口6 1. 文档介绍 1.1 文档目的 编写该文档的目的在于从总体设计的角度明确xxxx系统的功能和处理模式，明确与银联的接口，使系统开发人员和产品管理人员明确产品功能，可以有针对性的进行系统开发、测试、验收等各方面的工作。 1.2 文档范围 1.3 读者对象 该文档的读者为用户代表、软件分析人员、开发管理人员和测试人员。 1.4 参考文献 《xxxx系统需求说明书》 1.5 术语与缩写解释 无 2. 系统概述 XX系统是以触摸屏为主要交互工具，帮助用户以自助方式做业务查询。本系统的主要功能包括：话费查询、新业务介绍、网点分布查询、自助终端分布查询、电信新闻、交易监控、设备维护和监控等。本系统的设计目标是保证系统可以7*24小时安全、高效无故障运行；业务人员可以轻松完成设备和交易的监控、管理工作；报表种类齐全，可以满足业务人员各种帐务需求。
1引言 (2) 编写目的 (2) 背景 (2) 定义 (2) 参考资料 (2) 2程序系统的结构 (2) 3程序1（标识符）设计说明 (2) 程序描述 (3) 功能 (3) 性能 (3) 输人项 (3) 输出项 (3) 算法 (3) 流程逻辑 (3) 接口 (3) 存储分配 (4) 注释设计 (4) 限制条件 (4) 测试计划 (4) 尚未解决的问题 (4) 4程序2（标识符）设计说明 (4)
详细设计说明书 1引言 编写目的 该阶段开发以正式进入软件的实际开发阶段，本阶段完成系统的详细设计并明确系统的数据结构与软件结构。 在软件设计阶段主要是把一个软件需求转化为软件表示的过程，这种表示只是描绘出软件的总的概貌。本详细设计说明书的目的就是进一步细化软件设计阶段得出的软件总体概貌，把它加工成在程序细节上非常接近于源程序的软件表示。 软件开发小组的每一位参与开发成员应该阅读本说明，以清楚产品在技术方面的要求和实现策略，本手册将进行技术评审和技术的可行性检查。 背景 说明： A.软件系统的名称： BS网上商城系统 B.任务提出者： BS电子商务公司 开发者：LEI_SKY软件开发小组 C. 本系统将是一个独立的系统，目前所产生的输出都是独立的 本系统将使用MySql作为数据库的存储系统 定义 A. .B/S（Brower/Server） B. .IIS （Internet Information Server） C. .HTML（Hypertext Markup Language,超文本标记语言） D. .CSS（Cascading Style Sheets,层叠样式表单） E. .JSP（Java Server Pages） 参考资料 相关的文件包括： A. 内部文件《BS网上商城电子商务系统案例研究项目》
XX概要设计说明书
文档修改记录
填写说明 1. 系统结构的定义 本体系对整个软件系统按如下结构方式进行划分：系统子系统模块子模块 其中： （1）“系统子系统”划分属于“系统设计”，在系统设计说明书中予以描述。 （2）“子系统模块”划分属于“概要设计”，在本说明书中予以描述。 （3）“模块子模块”划分属于“详细设计”，在详细设计说明书中予以描述。如果系统相对简单，可以省略“子模块”这一层次。 2. 如果填写了系统设计说明书，则在本说明书中略过“系统子系统”划分的相关内容（即第2章）。 3. 如果系统相对简单，不需要做“系统子系统”划分，这种情况下，取消填写系统设计说明书，只须填写本说明书，直接套用“子系统模块”划分（即第3章）进行“系统模块”划分（把其中“子系统”一词替换为“系统”），并删除本说明书中“系统子系统”划分的相关内容（第2章）。
目录 1. 简介 ................................................................ 错误!未定义书签。 . 背景和目的.................................................... 错误!未定义书签。 . 范围.......................................................... 错误!未定义书签。 . 术语和缩略语.................................................. 错误!未定义书签。 2. 系统总体设计 ........................................................ 错误!未定义书签。 . 任务概述...................................................... 错误!未定义书签。 目标 .................................................... 错误!未定义书签。 需求概述 ................................................ 错误!未定义书签。 . 设计概述...................................................... 错误!未定义书签。 总体约束 ................................................ 错误!未定义书签。 系统外部接口 ............................................ 错误!未定义书签。 设计方案概述 ............................................ 错误!未定义书签。 . 系统架构设计.................................................. 错误!未定义书签。 系统的逻辑架构设计 ...................................... 错误!未定义书签。 系统的物理架构设计 ...................................... 错误!未定义书签。 . 子系统定义.................................................... 错误!未定义书签。 子系统列表 .............................................. 错误!未定义书签。 子系统间关系 ............................................ 错误!未定义书签。 3. 子系统1设计 ........................................................ 错误!未定义书签。 . 任务概述...................................................... 错误!未定义书签。 目标 .................................................... 错误!未定义书签。 需求概述 ................................................ 错误!未定义书签。 . 设计概述...................................................... 错误!未定义书签。 总体约束 ................................................ 错误!未定义书签。 子系统外部接口 .......................................... 错误!未定义书签。 设计方案概述 ............................................ 错误!未定义书签。 . 子系统架构设计................................................ 错误!未定义书签。 . 模块定义...................................................... 错误!未定义书签。
信息发布系统 （详细设计说明书） JAVA 实践小学期第22组 1.0 2010/9/5 编写单位： 设计人员： 版 本: 编写日期：
目录 第一部分、引言 (2) 1.1编写目的 (2) 1.2背景 (3) 1.3定义 (3) 3.1程序描述 (5) 3.2整体结构 (5) 3.3性能 (5) 3.4输入输出项 (5) 3.5算法 (5) 3.6主要类的设计 (5) 3.7存储分配 (7) 3.8注释 (7) 3.9限制条件 (7) 3.10测试计划 (7) 3.11尚未解决的问题 (7) 4.1程序描述 (7) 4.2功能 (7) 4.3性能 (8) 4.4输入输出项 (8) 4.5限制条件 (8) 5设计特点 (8) 5.1通信便捷 (8) 5.2开发速度快 (8) 第六部分、项目分工 (8) 附录： (9) 第一部分、引言 1.1编写目的 本说明书在概要设计的基础上，对信息发布系统的各模块、程序分别进行了实现层面上的要 求和说明。 软件开发小组的产品实现成员应该阅读和参考本说明进行代码的编写、测试。
1.2背景 说明: A、软件系统的名称：信息发布系统 B、任务提出者：JAVA实践小学期开发者：第22组成员 C、实现完成的系统将可用在所有JAVA虚拟机的个人PC上.为使用者提供信息发布，浏 览，评论的方式，沟通各个用户? 1.3定义 服务器端API :服务器端设计者通过规范的API文档，提供给客户端，以方便客户端的开 发，使得同时进行，提高效率，节约时间。两端通过protocol （协议类）进行通信。 Gson：Google提供的一个类库。通过使用这个类库，可以把把对象转换成json格式的字符串，以方便在网络中的传输。也可反向将字符串转换成对象，这样带有方法地操作对象，可以有效，方便地保证信 息的沟通。 Json： JavaScript Object Notation，是一种轻量级的数据交换格式。易于人阅读和编写，同时也易于机器解析和生成。它基于JavaScript的一个子集，JSON采用完全独立于语言的文本格式， 这些特性使得JSON成为理想的数据交换语言。 1.4参考资料，相关的文件包括： A、《项目需求说明》； B、《项目详细设计说明书》； C、《项目概要设计说明书》；参考资料： 《软件工程概论》，王华 第二部分、程序系统的结构 该系统为了两大部分：客户端与服务器端，中间通过protocol类通信。其中使用gson库来转换和逆向转换对象，实现标准包括： 1、客户端主程序 A、工程类型：JAVA项目； B、工程名称：信息发布系统 C、编译生成文件：jar形式 D、引用的组件：JDK，Gson库 注：以上提供的是工具集合，具体用到的类都包含在里面 2、服务器端主程序： 服务器端程序以及数据库操作类（DBO） 3、服务器端数据库操作 验证用户，用户注册，更改密码，更新文档，新建文档，新建记录（包括浏览记录和回复记录），查看文档，删除文档，查看记录。
实用文案
修订记录
目录 第一章概述 (5) 1.1.应用模块的目的 (5) 1.2.应用模块总体描述 (5) 1.3.应用模块接口描述 (5) 1.4.假设条件 (5) 第二章设计模式（Design pattern） (6) 第三章类设计 (7) 3.1.分块类图 (8) 3.1.1.<类图1> 8 3.1.2.<类图n> 8 3.2.整体继承关系 (8) 3.3.类描述 (9) 3.3.1.<类名1> Class Description 9 3.3.2.<类名n> Class Description 10 第四章交互图 (12) 4.1.<情景编号1: 情景名称> (12) 4.1.1.交互图 12 4.1.2.例外情况及条件 13 4.2.<情景编号n: 情景名称> (13) 第五章状态图 (14) 5.1.<状态图编号1:状态图名称> (14)
5.2.<状态图编号n:状态图名称> (15) 第六章时序流程图 (16) 第七章用户界面设计说明 (18) 7.1.用户界面关系 (18) 7.2.用户界面具体描述 (18) 7.2.1.<界面编号1:界面名称〉 18 7.2.2.<界面编号N:界面名称〉 19 第八章测试考虑 (20) 第九章附录 (21) 9.1.附录A 代码举例 (21) 9.2.附录B 设计问题 (21) 9.2.1.<设计问题1> 21 9.2.2.<设计问题n> 21
第一章概述 1.1.应用模块的目的 请明确客户建立应用模块的目的。 1.2.应用模块总体描述 描述应用模块的总体功能。 1.3.应用模块接口描述 简要描述本应用模块的公共接口，具体接口会在相应的类中进行具体描述。建议采用列表的方式。 1.4.假设条件 列出在问题领域，项目方案及其它影响系统设计的可能方面内，应当成立的假设条件。包括系统的约束条件和应遵循的标准。
《XXXXXX》 概要设计说明书 张三、李四、王五 1．引言 1．1编写目的 在本机票预定系统项目的前一阶段，也就是需求分析阶段中，已经将系统用户对本系统的需求做了详细的阐述，这些用户需求已经在上一阶段中对航空公司、各旅行社及机场的实地调研中获得，并在需求规格说明书中得到详尽得叙述及阐明。 本阶段已在系统的需求分析的基础上，对机票预定系统做概要设计。主要解决了实现该系统需求的程序模块设计问题。包括如何把该系统划分成若干个模块、决定各个模块之间的接口、模块之间传递的信息，以及数据结构、模块结构的设计等。在以下的概要设计报告中将对在本阶段中对系统所做的所有概要设计进行详细的说明。 在下一阶段的详细设计中，程序设计员可参考此概要设计报告，在概要设计对机票预定系统所做的模块结构设计的基础上，对系统进行详细设计。在以后的软件测试以及软件维护阶段也可参考此说明书，以便于了解在概要设计过程中所完成的各模块设计结构，或在修改时找出在本阶段设计的不足或错误。 1．2项目背景 机票预定系统将由两部分组成：置于个旅行社定票点的前台客户程序，以及置于 1．3 1．3．1 专门术语 SQL SERVER: 系统服务器所使用的数据库管理系统（DBMS）。 SQL: 一种用于访问查询数据库的语言 事务流：数据进入模块后可能有多种路径进行处理。 主键：数据库表中的关键域。值互不相同。 外部主键：数据库表中与其他表主键关联的域。 ROLLBACK: 数据库的错误恢复机制。 1．3．2 缩写
系统：若未特别指出，统指本机票预定系统。 SQL: Structured Query Language（结构化查询语言）。 ATM: Asynchronous Transfer Mode (异步传输模式)。 1．4参考资料 以下列出在概要设计过程中所使用到的有关资料： 1．机票预定系统项目计划任务书浙江航空公司 1999/3 2．机票预定系统项目开发计划《**》软件开发小组 1999/3 3．需求规格说明书《**》软件开发小组 1999/3 4．用户操作手册（初稿）《**》软件开发小组 1999/4 5．软件工程及其应用周苏、王文等天津科学技术出版社 1992/1 6．软件工程张海藩清华大学出版社 1990/11 7．Computer Network A.S.Tanenbaun Prentice Hall 1996/01 文档所采用的标准是参照《软件工程导论》沈美明著的“计算机软件开发文档编写指南”。 2．任务概述 2．1 目标 2．2 运行环境 系统将由两部分程序组成，安装在各旅行社客户机上的客户程序及航空公司内的数据服务器程序。 根据调研得知所有旅行社的计算机配置均在Pentium 133级别以上，客户程序应能够在Pentium 133级别以上, Win NT环境下运行。 2．3 需求概述 浙江航空公司为方便旅客，需开发一个机票预定系统。为便于旅客由旅行社代替航空公司负责为旅客定票，旅行社把预定机票的旅客信息，包括姓名、性别、工作单位、身份证号码、旅行时间、旅行目的地，输入机票预定系统的客户端程序，系统经过查询航空公司内的航班数据服务器后，为旅客安排航班，印出取票通知。旅客在飞机起飞前一天凭取票通知和帐单交款后取票，系统校对无误后即印出机票给旅客。 要求系统能有效、快速、安全、可靠和无误的完成上述操作。并要求客户机的界面要简单明了，易于操作，服务器程序利于维护。 2．4 条件与限制 3．总体设计 3．1 处理流程 下面将使用（结构化设计）面向数据流的方法对机票预定系统的处理流程进行分析。系统可分为两大部分：一、客户机上的程序，二、服务器上的程序。以下将分别对系统的这两大部分进行流程分析：
概要设计说明书示例【概要设计说明书(模板)】 概要设计说明书 修订记录 目录 第一章 1.1.1. 2.1. 3.1. 4.第二章 2.1.2.2.2. 3.2. 4.2. 5.2. 6.2. 7.第三章 3.1.3.2.3.3.第四章 4.1.4.2.4.3.第五章 5.1.5.2.5.3.第六章 6.1. 6.2.6.3. 补救措施......................................................... ........................................10系统维护设计......................................................... .. (10) 第一章引言 1.1.编写目的 说明编写这份概要设计说明书的目的，指出预期的读者。 1.2.背景 说明：
a.待开发软件系统的名称； b.列出此项目的任务提出者、开发者、用户以及将运行该软件的站点。 1.3.定义 列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4.参考资料 列出有关的参考文件，如： a.本项目的经核准的计划任务书或合同，上级机关的批文； b.属于本项目的其他已发表文件； c.本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出 第二章总体设计 2.1.需求规定 说明对本系统的主要的输入输出项目、处理的功能性能要求。 2.2.运行环境 简要地说明对本系统的运行环境（包括硬件环境和支持环境）的规定。 2.3.基本设计概念和处理流程 说明本系统的基本设计概念和处理流程，尽量使用图表的形式。 2.4.结构 用一览表及框图的形式说明本系统的系统元素（各层模块、子程序、公用程序等）的划分，扼要说明每个系统元素的标识符和功能，分层次地给出各元素之间的控制与被控制关系。 2.5.功能需求与程序的关系
详细设计说明书 1.引言 1.1编写目的 本详细设计说明书是针对网络信息体系结构的课程作业而编写。目的是对该项目进行详细设计，在概要设计的基础上进一步明确系统结构，详细地介绍系统的各个模块，为进行后面的实现和测试作准备。本详细设计说明书的预期读者为本项目小组的成员以及对该系统感兴趣，在以后想对系统进行扩展和维护的人员。 2. 系统的结构 ●ui：系统界面部分，负责接受用户输入，显示系统输出，负责其他模块功能的协调调用， 并含有站内搜索功能，即在用户指定的已打开的ftp站点中搜索用户需要的资源。ui 部分调用common部分的功能读取xml文件中保存的界面元素属性信息，用户最近访问过的10个ftp信息，用户选择的下载的ftp内容列表及其他需要通过xml文件保存的信息。 ●client：实现ftp客户端的功能，ftp连接，ftp上传及下载：上传或下载用户指定的
资源，并返回相应的信息。 ●search:资源实时检索部分，根据用户输入的资源名称关键字，资源类型和选择的检索 方式检索用户需要的资源，并验证资源的可用性，返回可用资源及其大小，速度等相关信息。 ●preview：资源预览部分，显示用户选择的资源的部分内容，以使用户决定是否需要该 资源。preview部分调用common部分读取属性文件的内容亦显示预览资源内容的显示格式。 3．模块1（ui）设计说明 3.1模块描述 实现用户界面的包，含有11个文件51个类，是本系统中最复杂的代码。 3.2功能 负责接受用户输入，显示系统输出，其他模块功能的协调调用，并含有站内搜索功能，即在用户指定的已打开的ftp站点中搜索用户需要的资源。 3.3交互的模块 client，search，preview，common。 3.4 模块设计 该模块中的主要文件，文件中包含的主要类及其功能和与其它包的交互如下： ●MainFrame.java：MainFrame是含有主函数的类，也是lyra客户端开始执行的类， 它先后进行资源的初始化，显示主界面等工作，根据屏幕大小设置界面大小，设置界面的观感。 ●FtpFrame_AboutBox.java:显示关于窗口的类，当用户点击帮助菜单中的关于菜单 项时会弹出关于对话框。 ●Tools.java：FileTools是文件操作辅助类，可以实现文件的递归删除等。 ●XMLController.java: JDOMTes是操作xml文件的类，用JDOM来操作xml文件， 实现的功能有： （1）保存ftp服务器的文件列表（站内搜索时使用），递归的从ftp服务器读取列表，并存入一个xml文件中（文件的命名方法是：ip+用户名.xml）;以目录树的形式保存。 （2）根据文件名在文件中查找文件，站内搜索时使用。 （3）保存ftp服务器的信息：ip，端口（默认端口21不保存），用户名（默认anonymous 不保存），密码，最多存10个；存在resource\settings\ serversinfor.xml文件中。 （4）读取已存储的ftp服务器信息。 （5）从type.xml读取搜索的类型。 ●Constants.java:放置系统运行时使用的一些常量，initcontent（）函数对所有常量 进行初始化，这个函数在MainFrame中被调用一次。iconHashMap是hash表，用于存放文件的系统图标。 ●CustomizedController.java：包含自定义的控件类，java中的控件可能不能满足需求， 需要自己定义某些属性。这些控件会在创建界面时使用。其中含有的类有： （1）CustomizedJTable 是表格类，设置表格的某些属性，如字体等。 （2）CustomizedTableCellRenderer是表格单元格绘制器类，主要用于显示文件的系统图标，和文件名。 （3）LeftPanel类的父类是JTabbedPane，用户显示主窗口左边的面板。 （4）RightPanel类的父类是JPanel，用户显示右边的主题部分，包括右上边的搜索及服务
＜网上书店＞ 概要设计说明书 作者：XXXXXXXXXXX 完成日期：XXXX年4月XX日签收人：XXXXXX 签收日期：XXXX年X月XX日修改情况记录：
目录 1 引言 (1) 1.1 编写目的 (1) 1.2 范围 (1) 1.3 定义 (1) 1.4 参考资料 (2) 2 总体设计 (2) 2.1 需求规定 (2) 2.2 运行环境 (3) 2.3 基本设计概念和处理流程 (3) 2.4 结构 (4) 2.5 功能需求与程序的关系 (8) 2.6 人工处理过程 (9) 2.7 尚未解决的问题 (9) 3 接口设计 (10) 3.1 用户接口 (10) 3.2 外部接口 (10) 3.3 内部接口 (10) 4 运行设计 (10) 4.1 运行模块组合 (10) 4.2 运行控制 (10) 4.3 运行时间 (11) 5 系统数据结构设计 (11) 5.1 逻辑结构设计要点 (11) 5.2 物理结构设计要点 (11) 6 系统出错处理设计 (12) 6.1 出错信息 (12) 6.2 补救措施 (12) 6.3 系统维护设计 (12) 7 阶段小结 (12)
1 引言 1.1 编写目的 服务于书店的网络化运营，管理用户购买以及其它服务、管理各类图书信息以及图书销售中的各个环节，最终用户为使用本网上书店的各类用户以及网上书店的系统管理人员和维护人员。 1.2 范围 说明： a．待开发的软件系统的名称：XXXX网上书店 b．任务提出者：刘俊铖、马俊 开发者：马俊、张倩、刘俊铖、张瑞鑫、唐志军、冯庆丰 用户：欲使自己书店网络化运营的各类书店。 使用本软件的单位：待定 1.3 定义 UML：Unified Modeling Language , 统一建模语言。 类图（class diagram）：表述系统中各个对象的类型及其间存在的各种静态关系。静态关系包括关联和子类型两种。 交互图（interactive diagram）：是表述各组对象如何依某种行为进行协作的模型。包括顺序图和协作图。 可修改性：容许对系统进行修改而不增加原系统的复杂性。 有效性：软件系统能有效地利用计算机的时间资源与空间资源的能力。 可靠性：能够防止因概念、设计和结构等方面的不完善造成的软件系统 失效，具有挽回因操作不当造成软件系统失效的能力。
中国广东核电集团 CHINA GUANGDONG NUCLEAR POWER GROUP 记录文件 项目编号 项目名称 CGN-IT-C3-A01-01 软件项目章程 版本编写审核审定批准生效时间A/0 注：如无受控文件标识（蓝色印章）则为非有效版本，以受控文件规定为准。
修改记录页
为具体内容，或删除。文件提交时不得再含有这些内容。】
目录 1 引言 (5) 1.1 编写目的 (5) 1.2 背景 (5) 1.3 术语与缩写解释 (5) 1.4 参考资料 (5) 2 模块命名规则 (6) 3 程序系统的组织结构 (6) 3.1 子系统划分 (6) 3.2 模块划分 (6) 3.3 程序与功能需求、系统模块间的关系 (6) 4 程序1（标识符）设计说明 (6) 4.1 程序描述 (7) 4.2 功能 (7) 4.3 性能 (7) 4.4 输人项 (7) 4.5 输出项 (7) 4.6 算法 (8) 4.7 流程逻辑 (8) 4.8 接口 (8) 4.9 存储分配 (8) 4.10 注释设计 (8) 4.11 限制条件 (9) 4.12 尚未解决的问题 (9) 5 程序2（标识符）设计说明 (9)
1引言 1.1编写目的 【给出项目详细设计说明书的编写目的，同时指明读者对象。】 1.2背景 【说明： a．待开发软件系统的名称； b.本项目的任务提出者、开发者、用户和运行该程序系统的计算中心。】 1.3术语与缩写解释 【列出本文件中用到的专门术语的定义和外文首字母缩写的原词组。】 1.4参考资料 【提示：可包括：（1）本项目经核准的计划任务书、需求规格说明书、合同、项目设计概要说明书或上级机关的批文；（2）本文档所引用的资料、规范等，列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源。】
1引言 (2) 1.1编写目的 (2) 1.2背景 (2) 1.3定义 (2) 1.4参考资料 (2) 2总体设计 (2) 2.1需求规定 (2) 2.2运行环境 (2) 2.3基本设计概念和处理流程 (3) 2.4结构 (3) 2.5功能器求与程序的关系 (3) 2.6人工处理过程 (3) 2.7尚未问决的问题 (3) 3接口设计 (3) 3.1用户接口 (3) 3.2外部接口 (3) 3.3内部接口 (4) 4运行设计 (4) 4.1运行模块组合 (4) 4.2运行控制 (4) 4.3运行时间 (4) 5系统数据结构设计 (4) 5.1逻辑结构设计要点 (4) 5.2物理结构设计要点 (4) 5.3数据结构与程序的关系 (4) 6系统出错处理设计 (5) 6.1出错信息 (5) 6.2补救措施 (5) 6.3系统维护设计 (5)
概要设计说明书 1引言 1.1编写目的 说明编写这份概要设计说明书的目的，指出预期的读者。 1.2背景 说明： a.待开发软件系统的名称； b.列出此项目的任务提出者、开发者、用户以及将运行该软件的计算站（中心）。 1.3定义 列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4参考资料 列出有关的参考文件，如： a.本项目的经核准的计划任务书或合同，上级机关的批文； b.属于本项目的其他已发表文件； c.本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出这些文件的 标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。 2总体设计 2.1需求规定 说明对本系统的主要的输入输出项目、处理的功能性能要求，详细的说明可参见附录C。 2.2运行环境 简要地说明对本系统的运行环境（包括硬件环境和支持环境）的规定，详细说明参见附录C。
概要设计的写法 做软件到一定层次了，就要考虑到设计了，设计了很久，就是不系统，系统的设计需要一个记录，记录就用文档，那么对项目所有包括技术上的设计都记录下来，我们就可以理解为软件的概要设计了。在需求明确、准备开始编码之前，要做概要设计，而详细设计可能大部分公司没有做，有做的也大部分是和编码同步进行，或者在编码之后。因此，对大部分的公司来说，概要设计文档是唯一的设计文档，对后面的开发、测试、实施、维护工作起到关键性的影响。 概要设计写什么？概要设计怎么做？如何判断设计的模块是完 整的？为什么说设计阶段过于重视业务流程是个误区？以需 求分析文档还是以概要设计文档来评估开发工作量、指导开发计划 准确？结构化好还是面向对象好？以上问题的答案请在文章 中找。 二、概要设计的目的? 将软件系统需求转换为未来系统的设计；逐步开发强壮的系统构 架；使设计适合于实施环境，为提高性能而进行设计；结构 应该被分解为模块和库。 三、概要设计的任务? 制定规范：代码体系、接口规约、命名规则。这是项目小组今后共 同作战的基础，有了开发规范和程序模块之间和项目成员彼此之间 的接口规则、方式方法，大家就有了共同的工作语言、共同的工作 平台，使整个软件开发工作可以协调有序地进行。总体结构设 计：功能（加工）－>模块：每个功能用那些模块实现，保证每 个功能都有相应的模块来实现；模块层次结构：某个角度的软件 框架视图；模块间的调用关系：模块间的接口的总体描述；模 块间的接口：传递的信息及其结构；处理方式设计：满足功能 和性能的算法用户界面设计；数据结构设计：详细的数 据结构：表、索引、文件；算法相关逻辑数据结构及其操作；上 述操作的程序模块说明（在前台？在后台？用视图？用过程？······）接口控制表的数据结构和使用规则其他性能设计。 四、概要设计写什么?