(完整版)详细设计说明书实例

信息发布系统

(详细设计说明书)

编写单位：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、任务提出者：JA V A实践小学期

开发者：第22组成员

C、实现完成的系统将可用在所有JA V A虚拟机的个人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、工程类型：JA V 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存储分配

本程序在高级语言JA V A进行编码，直接的内存分配由JA V 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 处理流程 下面将使用（结构化设计）面向数据流的方法对机票预定系统的处理流程进行分

(完整版)软件详细设计说明书模板

软件详细设计说明书 v1.0 200X年月XX日 修订历史记录

编制 审查 审核 批准 文档评审负责人：参加评审人员：

目录 1引言 (4) 1.1编写目的 (4) 1.2背景 (4) 1.3定义 (4) 1.4设计依据 (4) 2软件系统结构 (4) 2.1功能需求 (4) 2.2子模块划分 (4) 2.3子模块间关系 (4) 3公共数据结构 (4) 4程序设计说明 (5) 4.1程序1设计说明 (5) 4.1.1程序描述 (5) 4.1.2功能 (5) 4.1.3性能 (5) 4.1.4输入 (5) 4.1.5输出 (5) 4.1.6算法 (5) 4.1.7流程 (5) 4.2程序2设计说明 (5) 5模块重用说明 (5)

1引言 1.1编写目的 〖说明编写这份软件详细设计说明书的目的〗 1.2背景 〖说明待开发软件（子）系统的名称和此软件（子）系统所属大系统的名称； 说明任务的来源（开发背景和市场背景）等；该软件（子）系统与大系统中其他子系统的关系。〗 1.3定义 〖列出本文档中所用到的专门术语的定义和缩写词的原意〗 1.4设计依据 〖列出本文档所引用的有关设计依据（标题、文件编号、版本号、作者、发布日期、出版单位），包括本项目内部已编写的有效文档、出版刊物和国家标准或规范〗2软件系统结构 2.1功能需求 2.2子模块划分 〖说明本软件系统(或模块)的实现，即其内部的子模块划分（给出程序的名称和标识符）。建议以图形说明。〗 1.XXXXXXXX 2.XXXXXXXX 3.XXXXXXXX 4.XXXXXXXX 5.XXXXXXXX 6.XXXXXXXX 2.3子模块间关系 〖说明各子模块间的控制、顺序等耦合关系。〗 3公共数据结构 〖给出本软件系统使用的每一个公共数据结构的类型定义、存储方式，公共数据结构内各元素项的类型定义、初始取值、可能取值的范围及相应的物理含义。建议以类似Ｃ语言的数据说明格式来描述。〗

项目开发详细设计说明书(超好用模板)完整版

详细设计说明书XX有限公司

修订记录

目录 第一章概述........................................................................... 错误!未定义书签。 1.1.应用模块的目的....................................................... 错误!未定义书签。 1.2.应用模块总体描述................................................... 错误!未定义书签。 1.3.应用模块接口描述................................................... 错误!未定义书签。 1.4.假设条件................................................................... 错误!未定义书签。第二章设计模式（Design pattern） ................................... 错误!未定义书签。第三章类设计....................................................................... 错误!未定义书签。 3.1.分块类图................................................................... 错误!未定义书签。 <类图1> ............................................................ 错误!未定义书签。 <类图n> ............................................................ 错误!未定义书签。 3.2.整体继承关系........................................................... 错误!未定义书签。 3.3.类描述....................................................................... 错误!未定义书签。 <类名1> Class Description............................. 错误!未定义书签。 <类名n> Class Description............................. 错误!未定义书签。第四章交互图....................................................................... 错误!未定义书签。 4.1.<情景编号1: 情景名称> ........................................ 错误!未定义书签。 交互图................................................................ 错误!未定义书签。 例外情况及条件................................................ 错误!未定义书签。 4.2.<情景编号n: 情景名称> ........................................ 错误!未定义书签。第五章状态图....................................................................... 错误!未定义书签。 5.1.<状态图编号1:状态图名称> .................................. 错误!未定义书签。 5.2.<状态图编号n:状态图名称> .................................. 错误!未定义书签。第六章时序流程图............................................................... 错误!未定义书签。第七章用户界面设计说明................................................... 错误!未定义书签。 7.1.用户界面关系........................................................... 错误!未定义书签。 7.2.用户界面具体描述................................................... 错误!未定义书签。 <界面编号1:界面名称〉 ................................. 错误!未定义书签。 <界面编号N:界面名称〉 ................................ 错误!未定义书签。

概要设计说明书实例

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)

网上购物系统——详细设计说明书

网上购物系统 详细设计说明书 1引言 1.1编写目的 电子商务是于九十年代初，在欧美兴起的一种全新的商业交易模式，它实现了交易的无纸化，效率化，自动化表现了网络最具魅力的地方，快速的交换信息，地理界限的模糊，这所有的一切也必将推动传统商业行为在网路时代的变革。随着电子商务，尤其是网上购物的发展，商品流通基础设施和配套行业的重点将会将对中国商品流通领域和整个经济发展带来种种影响，确实值得我们认真研究。特别是在全球经济一体化的国际背景下，在我们继续扩大国内流通领域对外开放的同时，深入研究这个问题，审慎制订相应的宏观对策，尤其重要和迫切。网上购物是一种具有交互功能的商业信息系统。它向用户提供静态和动态两类信息资源。所谓静态信息是指那些比经常变动或更新的资源，如公司简介、管理规范和公司制度等等；动态信息是指随时变化的信息，如商品报价，会议安排和培训信息等。网上购物系统具有强大的交互功能，可使商家和用户方便的传递信息，完成电子贸易或EDI交易。这种全新的交易方式实现了公司间文档与资金的无纸化交换。 1.2.项目背景 软件名称：网上购物系统 开发者：宋金德，袁浩，王朝阳，许威 项目简介：本系统主要实现网上产品展示与在线定购及人员的管理， 一、不同身份有不同的权限功能（管理人员、注册用户、游客） 二、在线产品展示（分页显示） 三、在线定购 四、后台管理（用户管理、商品的管理） 1.3定义 Asp(active server pages)是微软公司推出的一种用以取代CGI的技术，基于目前绝大多数网站应用于windows平台，asp是一个位于windows服务器端的脚本运行环境，通过这种环境，用户可以创建和运行动态的交互式的web服务器应用程序以及EDI（电子数据交换）。 ADO：ActiveX Data Object, ActiveX 数据对象 SQL：Structured Query Language 1.4参考资料 [1] 谭浩强《动态网页制作ASP》北京电子工业出版社. 2001 [2] 彭万波《网页设计精彩实例》北京电子工业出版社.2002

软件概要设计说明书范例

XX概要设计说明书

文档修改记录

填写说明 1. 系统结构的定义 本体系对整个软件系统按如下结构方式进行划分：系统子系统模块子模块 其中： （1）“系统子系统”划分属于“系统设计”，在系统设计说明书中予以描述。 （2）“子系统模块”划分属于“概要设计”，在本说明书中予以描述。 （3）“模块子模块”划分属于“详细设计”，在详细设计说明书中予以描述。如果系统相对简单，可以省略“子模块”这一层次。 2. 如果填写了系统设计说明书，则在本说明书中略过“系统子系统”划分的相关内容（即第2章）。 3. 如果系统相对简单，不需要做“系统子系统”划分，这种情况下，取消填写系统设计说明书，只须填写本说明书，直接套用“子系统模块”划分（即第3章）进行“系统模块”划分（把其中“子系统”一词替换为“系统”），并删除本说明书中“系统子系统”划分的相关内容（第2章）。

目录 1. 简介 ................................................................ 错误!未定义书签。 . 背景和目的.................................................... 错误!未定义书签。 . 范围.......................................................... 错误!未定义书签。 . 术语和缩略语.................................................. 错误!未定义书签。 2. 系统总体设计 ........................................................ 错误!未定义书签。 . 任务概述...................................................... 错误!未定义书签。 目标 .................................................... 错误!未定义书签。 需求概述 ................................................ 错误!未定义书签。 . 设计概述...................................................... 错误!未定义书签。 总体约束 ................................................ 错误!未定义书签。 系统外部接口 ............................................ 错误!未定义书签。 设计方案概述 ............................................ 错误!未定义书签。 . 系统架构设计.................................................. 错误!未定义书签。 系统的逻辑架构设计 ...................................... 错误!未定义书签。 系统的物理架构设计 ...................................... 错误!未定义书签。 . 子系统定义.................................................... 错误!未定义书签。 子系统列表 .............................................. 错误!未定义书签。 子系统间关系 ............................................ 错误!未定义书签。 3. 子系统1设计 ........................................................ 错误!未定义书签。 . 任务概述...................................................... 错误!未定义书签。 目标 .................................................... 错误!未定义书签。 需求概述 ................................................ 错误!未定义书签。 . 设计概述...................................................... 错误!未定义书签。 总体约束 ................................................ 错误!未定义书签。 子系统外部接口 .......................................... 错误!未定义书签。 设计方案概述 ............................................ 错误!未定义书签。 . 子系统架构设计................................................ 错误!未定义书签。 . 模块定义...................................................... 错误!未定义书签。

详细设计说明书模版

（项目名称）详细设计说明书 文件版本 编写日期 发布日期

文件修改记录 修改日期版本号变化状态修改内容修改人 *变化状态：C――创建，A——增加，M——修改，D——删除 文档审批信息 版本号提交人批准人批准日期发布日期备注

目录 1引言 (1) 1.1编写目的 (1) 1.2适用范围 (1) 1.3术语和缩写 (1) 1.4参考资料 (1) 2概述 (1) 2.1系统概述 (1) 2.2系统功能定义 (1) 3总体结构说明 (1) 3.1系统结构 (1) 3.1.1系统内外部关系图 (1) 3.1.2功能模块简要说明 (1) 3.1.3依赖的外部接口 (1) 3.1.4对外提供的接口 (1) 3.2模块程序构件结构图 (1) 4数据模型（Data Model）设计 (2) 4.1逻辑实体模型 (2) 4.1.1实体模型1 (2) 4.1.2实体模型2 (3) 4.2表结构（物理设计） (3) 4.2.1表汇总 (3) 4.2.2表1 (3) 4.2.3表2 (3) 4.3视图列表 (4) 5功能实现说明 (4) 5.1数据流类模块 (4) 5.1.1数据流程图 (4) 5.1.2实现说明 (4) 5.1.3程序设计 (4) 5.2业务处理类模块 (5) 5.2.1Object Model设计 (5)

5.2.2程序设计 (5) 6界面实现说明 (5) 6.1模块1 (5) 6.1.1总体界面结构（业务操作区）说明 (5) 6.1.2功能点1界面结构说明 (5) 6.1.3功能点2界面结构说明 (5) 6.2模块2 (6) 6.2.1总体界面结构（业务操作区）说明 (6) 6.2.2功能点1界面结构说明 (6) 6.2.3功能点2界面结构说明 (6)

概要设计说明书范例及模板

《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引言 (4) 1.1编写目的 (4) 1.2背景 (4) 1.3术语与缩写解释 (4) 1.4参考资料 (4) 2模块命名规则 (4) 3程序系统的组织结构 (5) 3.1子系统划分 (5) 3.2模块划分 (5) 3.3程序与功能需求、系统模块间的关系 (5) 4程序1（标识符）设计说明 (5) 4.1程序描述 (5) 4.2功能 (6) 4.3性能 (6) 4.4输人项 (6) 4.5输出项 (6) 4.6算法 (6) 4.7流程逻辑 (6) 4.8接口 (6) 4.9存储分配 (7) 4.10注释设计 (7) 4.11限制条件 (7) 4.12尚未解决的问题 (7) 5程序2（标识符）设计说明 (7)

引言 编写目的 【给出项目详细设计说明书的编写目的，同时指明读者对象。】 背景 【说明： a．待开发软件系统的名称； b.本项目的任务提出者、开发者、用户和运行该程序系统的计算中心。】 术语与缩写解释 【列出本文件中用到的专门术语的定义和外文首字母缩写的原词组。】 参考资料 【提示：可包括：（1）本项目经核准的计划任务书、需求规格说明书、合同、项目设计概要说明书或上级机关的批文；（2）本文档所引用的资料、规范等，列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源。】

模块命名规则 【确定本软件的模块命名规则，例如类、函数、变量等，确保设计文档的风格保持一致。可以从机构的编码规范中摘取或引用。】 程序系统的组织结构 【用一系列图表列出本程序系统内的每个程序（包括每个模块和子程序）的名称、标识符和它们之间的层次结构关系。】 子系统划分 模块划分 程序与功能需求、系统模块间的关系 程序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、服务器端数据库操作 验证用户，用户注册，更改密码，更新文档，新建文档，新建记录（包括浏览记录和回复记录），查看文档，删除文档，查看记录。

概要设计说明书---案例

＜网上书店＞ 概要设计说明书 作者：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）：是表述各组对象如何依某种行为进行协作的模型。包括顺序图和协作图。 可修改性：容许对系统进行修改而不增加原系统的复杂性。 有效性：软件系统能有效地利用计算机的时间资源与空间资源的能力。 可靠性：能够防止因概念、设计和结构等方面的不完善造成的软件系统 失效，具有挽回因操作不当造成软件系统失效的能力。

软件系统详细设计说明书模板

xxxxx系统详细设计说明书

版本历史

修改记录

目录 1引言 (5) 1.1编写目的 (5) 1.2背景 (5) 1.3参考资料 (5) 1.4术语定义及说明 (5) 2设计概述 (5) 2.1任务和目标 (5) 2.1.1需求概述 (5) 2.1.2运行环境概述 (5) 2.1.3条件与限制 (6) 2.1.4详细设计方法和工具 (6) 3系统详细需求分析 (6) 3.1详细需求分析 (6) 3.2详细系统运行环境及限制条件分析接口需求分析 (6) 4总体方案确认 (6) 4.1系统总体结构确认 (6) 4.2系统详细界面划分 (7) 4.2.1应用系统与支撑系统的详细界面划分 (7) 4.2.2系统内部详细界面划分 (7) 5系统详细设计 (7) 5.1系统程序代码架构设计 (7) 5.1.1UI(User Interface)用户界面表示层 (7) 5.1.2BLL(Business Logic Layer)业务逻辑层 (8) 5.1.3DAL(Data Access Layer)数据访问层 (8) 5.1.4Common类库 (8) 5.1.5Entity Class实体类 (8) 5.2系统结构设计及子系统划分 (8) 5.3系统功能模块详细设计 (9) 5.3.1XX子系统 (9) .1XX模块 (9) 列表和分页 (9) 创建XX (9) .2XX模块 (9) XX列表 (9) XX修改 (9) 5.3.2XX子系统 (9) 5.3.6.1用户管理模块 (9) 5.3.6.2角色管理模块 (14) 5.3.6.3系统设置模块 (14) 5.3.6.4系统登录注销模块 (14) 5.4系统界面详细设计 (14) 5.4.1外部界面设计 (14) 5.4.2内部界面设计 (14) 5.4.3用户界面设计 (14) 6数据库系统设计 (14) 6.1设计要求 (14) 6.2信息模型设计 (14) 6.3数据库设计 (14) 6.3.1设计依据 (14)

详细设计说明书书真正例子

详细设计说明书 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，用户显示右边的主题部分，包括右上边的搜索及服务