《软件概要设计说明模板.docx》由会员分享，可在线阅读，更多相关《软件概要设计说明模板.docx（23页珍藏版）》请在三一办公上搜索。
1、XX软件概要设计说明V4.0-1标记数量修改单号签字日期编制XXXX会签软件概要设计说明校对XXXX标检XXXX共23页第1页审核批准XXXX中国船舶工业系统工程研究院会签XXXX修订记录版本号修订状态简要说明修订内容和范围修订日期修订人批准日期注：修订记录在体系文件发布后换版时使用，修订状态栏填写：A一增加，M一修改,D一删除目次1Qkll*21.1标识21.2文档概述22引用文档23CSCI设计决策33. 1假设33.2系统体系结构33.3软件体系结构33.4设计决策43.4.1输入/输出设计决策43.4.2CSCI行为设计决策43.4.3CSCl数据显示设计决策43.4.4CSCI安全性
2、设计决策53.4.5CSCl保密性设计决策63. 4.6其他CSCl级设计决策64CSCl体系结构设计64. 1CSCI包汇总74. 1.1XX包设计74. 2执行方案84. 2.1XX功能/业务84.3 接口设计84.4 .1外部接口84. 3.2内部接口95用户界面设计（可选）105.1应当遵循的界面设计规范105.2界面信息汇总105.3界面视图105. 3.1XX主界面105. 3.2XY主界面1054人因设11（可选）105. 5界面资源设计（可选）105. 5.1图标资源105. 5.2图像资源115. 5.3界面组件116数据（库）结构设计（可选）115.1 逻辑结构设计要点11
3、6. 2物理结构设计要点127配置文件设计（若有）126.1 XX配置文件126.2 XX配置文件128部署设计128.1设计部署128. 2物理部署129运行设计（可选）138.1 运行包组合139. 2运行控制149.3运行时间1510性能设计1510. 1XX性能15H系统出错处理设计15H.1出错信息1511.2 补救措施1611.3 系统维护设计1611.4 错误处理设计1612CSCI详细设计1613需求可追踪性1614注释17图序图1XX系统体系结构图3图2XX软件体系结构图4图3CSCl体系结构图7图4XX时序图错误!未定义书签。图5外部接口示意图8图6数据库逻辑结构图11图7
4、XX软件部署设计图13图8运行包组合图14图9运行控制图15表序表1XX软件安全性设计决策表5表2XX软件保密性设计决策表6表3XX软件包汇总表7表4APl接口设计表8表5信息接口设计表9表6信息接口设计表9表7XX软件界面汇总表10表8XX表字段结构11表9XX软件部署设计表12表9XX软件部署设计表13表10需求追踪表（正向）16表11需求追踪表（逆向）171范围1. 1标识本条应描述本文档所适用系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号和发布号。简要说明软件的标识号、发布号、名称、缩略名、版本号。a）软件标识号：b）发布号：VOlc）名称：d）缩略名：e）版本号：V
5、I.0本条应概述本文档所适用系统和软件的用途。它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等：标识当前和计划的运行现场；列出其他有关文档。分别简要说明系统的用途、软件用途。a）需方：b）用户：c）开发方：1.2文档概述本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。示例：本文档主要描述XX软件配置项CSCI级的设计决策以及体系结构设计，包括CSCI从部件到软件单元的执行方案、接口说明，满足需求可追踪性，以确保它们完备、可行、可实现和可验证性。2引用文档本章应列出引用文档的编号、标题、编写单位、修订版及日期，还应标识
6、不能通过正常采购活动得到的文档的来源。a）文档名称1，编号（若有），编写单位，版本（若有），日期；b）文档名称2，编号（若有），编写单位，版本（若有），日期。3CSCI设计决策3.1 假设设计是否基于某种假设的前提条件。3.2 系统体系结构着重从硬件（诸如网络、服务器、终端、打印机等）方面，用图形和文字方法描述软件的体系结构。图片不做形式要求图1XX系统体系结构图用文字的形式对图片中系统的体系结构进行简要描述。3.3软件体系结构着重从软件架构（诸如现有的系统、子系统、层等）方而，用图形和文字方法描述软件的体系结构，如图2所示。应用层可巴产严E严严图2XX软件体系结构图用文字的形式对图片中软件的
7、体系结构进行简要描述,主要包括分层的设计原理（设计模式），每层的主要功能及功能包等。3. 4设计决策本章应根据需要分条给出CSCI级设计决策，即CSCI行为设计的决策（忽略其内部实现，从用户角度出发描述系统将怎样运转以满足需求）和其他影响组成该CSCl的软件单元的选择与设计的决策。如果在需求中所有这些决策是明确的，或者这些决策要推迟到CSCl的软件单元的设计时指出，则本章应如实陈述。针对关键性需求（例如对安全性或保密性关键的需求）作出的设计决策，应在专门的章条中加以叙述。如果设计决策依赖于系统状态或方式，则应指明这一依赖性。本条应给出或引用理解这些设计所需的设计约定。CSCl级设计决策的例子如
8、下：建议项目组主要从以下几个方面进行考虑，也可根据项目特点自行裁剪或添加。4. 4.1输入/输出设计决策关于CSCI将接收的输入和将产生的输出的设计决策，即本软件输入/输出的设计原则。包括与其他系统、HwCI、CSCl和用户的接口。如果这一信息的全部或部分已在接口设计说明（IDD）中给出，则可以直接引用，否则填写下表信息。例如：1）触摸屏输入：由于该系统为ZZ/WQ发控类系统，对发控类命令要求较高，因此诸如工作方式切换、WQ发控命令采用触摸屏设计；2）界面输出：为了提高操作人员的警惕度，软件运行过程中出现的故障信息均用闪烁的红色显示，便于ZZ过程中及时处理。3.4.2CSel行为设计决策有关响
9、应每个输入或条件的CSCl行为的设计决策，即本软件CSCl行为的设计原则。包括CSCl要执行的动作、响应时间。例如：1）为不影响XX设备态势信息处理的准确性，软件态势信息发送到订阅客户端的响应时间为IOOmSo3.4.3CSCl数据显示设计决策有关数据库/数据文件如何呈现给用户的设计决策，即本软件CSCl数据显示的设计原则。如果这一信息的全部或部分在数据库设计说明（DBDD）中给出，则可直接引用。例如：1）文件信息显示：为便于ZZ过程中对目标信息进行直观分析，接收到的目标信息采用态势图的形式显示；2）文件导出：只有软件空闲时，才允许对数据文件的导出。3. 4.4CSCl安全性设计决策CSCI的
10、安全性是指防止其合法用户使用该CSCl时对系统或其中的信息造成不良影响，本条应针对该CSCI的软件需求规格说明中描述的安全性需求，逐一描述其采取的防护措施和方法的设计原则。例如：表1XX软件安全性设计决策表序号安全性需求采取的防护措施1.输入信息的合法性 所有用户录入信息入库前必须进行数据的合法性检查，对非法数据CSel将提示用户修改，直至数据合法方可入库； 对录入信息的必填项进行高亮或特殊颜色提示，入库前进行数据库主键检查； 在各人机界面上进行信息录入说明。2.误操作防护 按照工作流程要求，在软件界面中对功能按钮的状态（有效/无效）进行控制； 编制CSCl运行导航程序； 增加操作撤消与恢复功
11、能。3.信息删除警示 CSCI中所有数据库数据的删除操作均给予用户以删除警示，并由用户进行删除确认后方执行信息删除操作； 用户删除的所有数据文件均存放在系统的回收站中，用户可根据需要还原或清理回收站中的文件。 CSCI中所有数据库数据的删除操作均给予用户以删除警示，并由用户进行删除确认后方执行信息删除操作； 用户删除的所有数据文件均存放在系统的回收站中，用户可根据需要还原或清理回收站中的文件。序号安全性需求采取的防护措施4.数据库访问权限控制 利用数据库管理系统，对不同的用户分配不同的角色，并对其进行可访问信息的范围和访问权限进行设置； 对用户访问数据库的操作进行审计。4. 4.5CSCl保密
12、性设计决策CSCI的保密性主要是防止非法用户对CSCl的攻击。本条应针对该CSCl的软件需求规格说明中描述的保密性需求，逐一描述其采取的防护措施和方法的设计原则。例如：表2XX软件保密性设计决策表序号保密性需求采取的措施1.身份验证启动软件时，首先要求用户输入用户身份信息（用户名和口令），CSCI对其进行比对识别后，合法用户方能够用动运行该软件；对非法用户将给予登陆警示和记录，登陆警示超过X次将退出；使用用户身份卡、读卡器和识别接口卡等设备对本CSCI运行的计算机设备的开关机及软件启动等操作进行控制。2.数据库访问权限控制利用数据库管理系统，对不同的用户分配不同的角色，并对其进行可访问信息的范
13、围和访问权限进行设置；对用户访问数据库的操作进行审计。5. 4.6其他CSCI级设计决策本条可针对本CSCl软件需求规格中的其它特殊需求（如：灵活性、可用性、可维护性等方面的需求），描述其相应的实现方法的设计原则。对有特殊需求的CSCl要求必须填写，如为满足性能指标所进行的负载均衡设计、并行计算或高性能计算设计决策等。如果本节无内容，填写“无。”4CSCI体系结构设计描述CSCI体系结构，明确包之间的依赖关系。图3CSCI体系结构图4. 1CSCl包汇总设计人员确定包的命名规则，确保软件设计文档的风格与代码的风格保持一致。可以从机构的编程规范中摘取或引用（如果存在的话）。另外，描述包的开发类型
14、，包括新研、改进、完全重用、采购等。表3XX软件包汇总表序号标识名称说明开发类型1PAK_MMI_XX2PAK_MMI_XX3PAK_MMI_XX4PAK_MMI_XX5PAK_MMI_XX64. 1.1XX包设计4. 1.1.1功能说明描述包的主要功能。6. 1.1.2性能分配（可选）描述性能指标的在包中的分配情况。4.2执行方案必须覆盖需求中的业务流程。注释：本阶段仅完成业务流程到包的设计即可。4.2.1XX功能/业务4.2.1.1流程说明简要描述完成该业务所牵涉到的包，即在该业务中包的功能。例如：完成XX功能，需要涉及到XX包、YY包。XX包主要负责XX,YY包主要负责XX。4.2.1.
15、2补充说明（可选）针对复杂度较高或者具有特殊性的业务功能。4.3接口设计设计人员确定内外部接口的命名规则，确保软件设计文档的风格与代码的风格保持一致。可以从机构的编程规范中摘取或引用（如果存在的话）。4.3.1外部接口描述CSCl外部包/组件间的接口信息，接口种类分成APl接口、信息接口和数据库接口。使用图表的形式描述接口。图4外部接口示意图4.3.1.1APl接口设计表4API接口设计表序号实现方依赖方接口名称接口标识接口功能说明备注124. 3.1.2信息接口设计表5信息接口设计表序号实现方依赖方接口名称接口标识接口功能说明备注124.3.1.3数据库接口设计表6信息接口设计表序号表名标识
16、数据项写入方读取方备注1标识/密码24.3.2内部接口描述CSCI包/组件内部接口，即CSCI类之间接口关系。具体接口形式参见外部接口。下表是接口的详细设计，在不影响后续开展详细设计的情况下，在概要设计中为可选，并可在后续详细设计中体现或由接口协议文件代替。接口标识如：1/F-A-B-Ol,以此类推。使用说明对于通讯接口，必要时，在此说明通讯的协议、传输格式、数据传输率、周期或非周期等数据元素说明名称英文名称简短描述类型测量单位极限值/值域精确咬精度/分辨率合法性检查经度I1检查是否大于05用户界面设计（可选）4.1 应当遵循的界面设计规范结合用户需求和组织相关规范，阐述本软件用户界面设计应当
17、遵循的规范（原则、建议等）。可以从机构的编程规范中摘取或引用（如果存在的话）。4.2 界面信息汇总表7XX软件界面汇总表标识号（XX主界面）序号标识名称说明备注1.子界面标识XX主要完成XX功能。标识号（XX主界面）序号标识名称说明备注1.子界面标识XX主要完成XX功能。5. 3界面视图5. 3.1XX主界面绘制主界面的视图,并简要介绍。5. 3.1.1XX子界面绘制子界面的视图，并简要介绍。5.3.2XY主界面绘制主界面的视图，并简要介绍。5. 3.2.1XX子界面绘制子界面的视图，并简要介绍。5.4 人因设计（可选）（1）阐述界面的布局及理由；（2）阐述界面的色彩及理由。5.5 界面资源设
18、计（可选）5.5.1图标资源5.5.2图像资源5. 5,3界面组件6数据（库）结构设计（可选）从永久性数据存储方面来对系统进行说明。如果几乎或根本没有永久性数据，或者设计模型与数据模型之间的转换并不重要，那么本节就为可选。注：如果需要可以单独形成数据库设计说明，此处可以直接应用该文档。5.1 逻辑结构设计要点给出本系统内所使用的每个数据结构的名称、标识符以及它们之中每个数据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。DvarctarC54) 会受 W YafChSrc254) ,- VarChar仇& 石岩var6ara54)星定VafCharG54),-VarCh
19、afC54)巴件Varchar254)SjYarChar254)*主城彳 VarChart254):N：SeJD int= *rSi RChMa幺) - W 曹万套 Varahar(254) 发送人 varch3254)英三洛?凄/人intVafCtlSfl254)VafChart254)vrchar1254)varchar1254)图5数据库逻辑结构图表8XX表字段结构序号字段名称字段标识字段类型长度主键外键非空注释1是/否是/否是/否默认值等25.2 物理结构设计要点给出本系统内所使用的每个数据结构中的每个数据项的存储要求，访问方法、存取单位、存取的物理关系（数据库实例、表空间、表权限）、
20、设计考虑和保密条件。7配置文件设计（若有）对本CSCl软件使用的所有配置文件进行设计，包括配置文件的格式及配置项的说明（可用表格形式列出）。7.1 XX配置文件7.2 XX配置文件8部署设计本节用来说明运行软件的两种部署设计，其中包括设计部署和物理部署两部分。设计部署用于说明设计过程与软件实体的对应关系，物理部署用于说明软件实体与物理台位间的映射关系，对于每种配置，至少应该指出执行该软件的物理节点（计算机、CPU）及其互连情况（总线连接、LAN连接、点到点连接等）。注：如果软件的部署一目了然，那么本节就为可选。8.1设计部署表9XX软件设计部署表序号软件实体设计包备用1XX.OXX包2XX.d
21、llXX包3XX.exeXX包8.2物理部署图6XX软件物理部署图表10XX软件物理部署表序号物理台位软件实体备用1XX显控台XX.O2XX计算机XX.dll3XX服务器XX.exe9运行设计（可选）本节设计内容主要针对自动化处理软件。包括测控软件、自动运行的服务程序等软件系统。9.1 运行包组合说明对系统施加不同的外界运行控制时所引起的各种不同的运行进程/组件的组合，说明每种运行所历经的内部软件和支持软件。图7运行包组合图9.2 运行控制说明每一种外界的运行控制的方式方法和操作步骤。图8运行控制图9.3 运行时间说明每种运行软件单元组合将占用各种资源的时间。10性能设计说明为了达到需求中规定
22、的性能要求而需要进行特殊的设计、专门的处理方法。需明确性能指标分解的原因，指明实现每个性能指标的主要包，对每个性能指标说明其约束条件及在约束条件（含软件条件及硬件条件）下达到性能指标所采取的设计方法。10.1XX性能XX.11系统出错处理设计11.1 出错信息用一览表的方式说明每种可能的出错或故障情况出现时，系统输出信息的形式、含意及处理方法。应充分考虑不同层、软件单元/软部件和数据库中的代码，做到：a）出错信息描述简明扼要；b）通过出错信息可以定位错误源；11.2 补救措施说明故障出现后可能采取的变通措施，包括：a）后备技术说明准备采用的后备技术，当原始系统数据万一丢失时启用的副本的建立和启
23、动的技术，例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术；b）降效技术说明准备采用的后备技术，使用另一个效率稍低的系统或方法来求得所需结果的某些部分，例如一个自动系统的降效技术可以是手工操作和数据的人工记录；c）恢复及再启动技术说明将使用的恢复再启动技术，使软件从故障点恢复执行或使软件从头开始重新运行的方法。11.3 系统维护设计说明为了系统维护的方便而在程序内部设计中作出的安排，包括在程序中专门安排用于系统的检查与维护的检测点和专用部件。11.4 错误处理设计说明为了系统运行的稳定、可靠和维护方面的考虑，系统应专门考虑的方面，专门设计的出错处理部件。主要包括：a）专门的错误处理部件；b）系统的日志记录；c）软件应捕获的错误，并采取的错误转移处理措施。12CSCl详细设计若是软件详细设计说明文档合并到此文档，将详细设计文档的第3章节代替此章节。若是不合并，去掉此章节。13需求可追踪性表11需求追踪表（正向）软件概要设计说明软件需求规格说明包标识/名称章条号需求标识/名称章条号XX包3.2.1XX用例3.1.1表12需求追踪表（逆向）软件需求规格说明软件概要设计说明需求标识/名称章条号包标识/名称章条号XX用例3.2.1XX包3.1.114注释本章应包括有助于了解文档的所有信息（例如：背景、术语、缩略语或公式）。
