软件概要设计说明模板-包设计版

1、XX软件概要设计说明V4.0-1标记数量修改单号签字日期编制XXXX会签软件概要设计说明校对XXXX标检XXXX共20页第1页审核批准XXXX中国船舶工业系统工程研究院会签XXXXGr002.6A软件概要设计说明修订记录版本号修订状态简要说明修订内容和范围修订日期修订人批准日期注：修订记录在体系文件发布后换版时使用，修订状态栏填写：A增加，MH修改,D删除7目次1范围21.1标识21.2文档概述22引用文档23 CSCI设计决策23.1假设23.2 系统体系结构 23.3软件体系结构33.4设计决策33.4.1 输入/输出设计决策43.4.2 CSCI行为设计决策 43.4.3 CSCI数据显

2、示设计决策 43.4.4 CSCI安全性设计决策 43.4.5 CSCI保密性设计决策 53.4.6其他CSCI级设计决策54 CSCI体系结构设计 64.1 CSCI包汇总 64.1.1 XX包设计64.2执行方案64.2.1 XX 功能/业务 74.3接口设计74.3.1 外部接口 74.3.2 内部接口 85用户界面设计（可选） 85.1应当遵循的界面设计规范 85.2界面信息汇总85.3界面视图95.3.1 XX主界面95.3.2 XY主界面95.4人因设计（可选）95.5界面资源设计（可选） 95.5.1 图标资源95.5.2 图像资源95.5.3界面组件96数据（库）结构设计（可选

3、） 96.1逻辑结构设计要点96.2物理结构设计要点107配置文件设计（若有） 107.1 XX配置文件107.2 XX配置文件108部署设计118.1设计部署118.2物理部署119运行设计（可选） 129.1 运行包组合129.2运行控制129.3运行时间1310性能设计1310.1 XX 性能1311系统出错处理设计1311.1出错信息1311.2补救措施1411.3系统维护设计1411.4 错误处理设计 1412 CSCI详细设计1413需求可追踪性 1414注释15图1 XX系统体系结构图3图2 XX软件体系结构图3图3 CSCI体系结构图 6错误！未定义书签图4 XX时序图图5外部

4、接口示意图7图6数据库逻辑结构图 10图7 XX软件部署设计图 11图8运行包组合图12图9运行控制图13表1 XX软件安全性设计决策表 4表2 XX软件保密性设计决策表 5表3XX软件包汇总表6表4 API接口设计表7表5信息接口设计表7表6信息接口设计表8表7 XX软件界面汇总表8表8XX表字段结构10表9 XX软件部署设计表11表9 XX软件部署设计表11表10 需求追踪表（正向） 14表11 需求追踪表（逆向）14Gr002.6A软件概要设计说明1范围1.1 标识本条应描述本文档所适用系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号和发布号。简要说明软件的标识号、发布号

5、、名称、缩略名、版本号。a）软件标识号：b）发布号：V01c）名称：d）缩略名：e）版本号：V1.0本条应概述本文档所适用系统和软件的用途。它还应描述系统与软件的一般特 性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构 等：标识当前和计划的运行现场；列出其他有关文档。分别简要说明系统的用途、软件用途。a）需方：b）用户：c）开发方：1.2 文档概述本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。示例：本文档主要描述XX软件配置项CSCI级的设计决策以及体系结构设计，包括CSCI从部件到软件单元的执行方案、接口说明，满足需求可追踪性，以确保它们完备

6、、可行、可实现和可验证 性。2引用文档本章应列出引用文档的编号、标题、编写单位、修订版及日期，还应标识不能通 过正常采购活动得到的文档的来源。a）文档名称1，编号（若有），编写单位，版本（若有），日期；b）文档名称2，编号（若有），编写单位，版本（若有），日期。3 CSCI设计决策3.1 假设设计是否基于某种假设的前提条件。3.2 系统体系结构着重从硬件（诸如网络、服务器、终端、打印机等）方面，用图形和文字方法描述软件的体系结构。图片不做形式要求图1 XX系统体系结构图用文字的形式对图片中系统的体系结构进行简要描述。3.3 软件体系结构着重从软件架构（诸如现有的系统、子系统、层等）方面，用图形

7、和文字方法描 述软件的体系结构，如图2所示。应用层o基础层ODBCQa图2 XX软件体系结构图用文字的形式对图片中软件的体系结构进行简要描述，主要包括分层的设计原理 （设计模式），每层的主要功能及功能包等。3.4 设计决策本章应根据需要分条给出 CSCI级设计决策，即CSCI行为设计的决策（忽略其内 部实现，从用户角度出发描述系统将怎样运转以满足需求）和其他影响组成该CSCI的 软件单元的选择与设计的决策。如果在需求中所有这些决策是明确的，或者这些决策要推迟到CSCI的软件单元的设计时指出，则本章应如实陈述。针对关键性需求（例如对安全性或保密性关键的需求）作出的设计决策，应在专门的章条中加以叙

8、述。如果 设计决策依赖于系统状态或方式，则应指明这一依赖性。本条应给出或引用理解这些 设计所需的设计约定。CSCI级设计决策的例子如下：建议项目组主要从以下几个方面进行考虑，也可根据项目特点自行裁剪或添加。3.4.1 输入/输出设计决策关于CSCI将接收的输入和将产生的输出的设计决策，即本软件输入/输出的设计原则。包括与其他系统、HWCI CSCI和用户的接口。如果这一信息的全部或部分已在 接口设计说明（IDD）中给出，则可以直接引用，否则填写下表信息。例如：1）触摸屏输入：由于该系统为 ZZ/WQ发控类系统，对发控类命令要求较高，因此诸如工作方式切换、WQ发控命令采用触摸屏设计；2） 界面输

9、出：为了提高操作人员的警惕度，软件运行过程中出现的故障信息均用闪烁的红色显示，便于ZZ过程中及时处理。3.4.2 CSCI行为设计决策有关响应每个输入或条件的 CSCI行为的设计决策，即本软件CSCI行为的设计原则。包括CSCI 要执行的动作、响应时间。例如：1 ）为不影响XX设备态势信息处理的准确性，软件态势信息发送到订阅客户端的响应时间为100ms。3.4.3 CSCI数据显示设计决策有关数据库/数据文件如何呈现给用户的设计决策，即本软件CSCI数据显示的设计原则。如果这一信息的全部或部分在数据库设计说明（DBDD）中给出，则可直接引用。例如：1 ）文件信息显示：为便于 ZZ过程中对目标信

10、息进行直观分析，接收到的目标信息采用态势图的形式显示；2）文件导出：只有软件空闲时，才允许对数据文件的导出。3.4.4 CSCI安全性设计决策CSCI的安全性是指防止其合法用户使用该CSCI时对系统或其中的信息造成不良影响，本条应针对该CSCI的软件需求规格说明中描述的安全性需求，逐一描述其采取的防护措施和方法的设计原则。例如：表1 XX软件安全性设计决策表序号安全性需求采取的防护措施1.输入信息的合法性所有用户录入信息入库前必须进行数据的合法性检 查，对非法数据 CSCI将提示用户修改，直至数据合法 方可入库；对录入信息的必填项进行高亮或特殊颜色提示，入库 前进行数据库主键检查；在各人机界面

11、上进行信息录入说明。2.误操作防护按照工作流程要求，在软件界面中对功能按钮的状态 （有效/无效）进行控制；编制CSCI运行导航程序；增加操作撤消与恢复功能。3.信息删除警示CSCI中所有数据库数据的删除操作均给予用户以删除 警示，并由用户进行删除确认后方执行信息删除操作； 用户删除的所有数据文件均存放在系统的回收站中， 用户可根据需要还原或清理回收站中的文件。CSCI中所有数据库数据的删除操作均给予用户以删除 警示，并由用户进行删除确认后方执行信息删除操作； 用户删除的所有数据文件均存放在系统的回收站中， 用户可根据需要还原或清理回收站中的文件。4.数据库访问权限控 制利用数据库管理系统，对不

12、同的用户分配不同的角色， 并对其进行可访问信息的范围和访问权限进行设置； 对用户访问数据库的操作进行审计。3.4.5 CSCI保密性设计决策CSCI的保密性主要是防止非法用户对CSCI的攻击。本条应针对该 CSCI的软件需求规格说明 中描述的保密性需求，逐一描述其采取的防护措施和方法的设计原则。例如：表2 XX软件保密性设计决策表序号保密性需求采取的措施1.身份验证启动软件时，首先要求用户输入用户身份信息（用户名和口令），CSCI对其进行比对识别后，合法用户方能够启动运行该软件；对非法用户将 给予登陆警示和记录，登陆警示超过X次将退出；使用用户身份卡、读卡器和识别接口卡等设备对本CSCI运行的

13、计算机设备的开关机及软件启动等操作进行控制。2.数据库访问 权限控制利用数据库管理系统，对不同的用户分配不同的角色，并对其进行可访 冋信息的范围和访冋权限进行设置； 对用户访问数据库的操作进行审计。3.4.6 其他CSCI级设计决策本条可针对本 CSCI软件需求规格中的其它特殊需求（如：灵活性、可用性、可维护性等方面的需求），描述其相应的实现方法的设计原则。对有特殊需求的CSCI要求必须填写，如为满足性能指标所进行的负载均衡设计、并行计算或高性能计算设计决策等。如果本节无内容，填写“无。”4 CSCI体系结构设计描述CSCI体系结构，明确包之间的依赖关系。1人机界面类1交互消息类7数据类<

14、;控制类图3 CSCI体系结构图4.1 CSCI包汇总设计人员确定包的命名规则，确保软件设计文档的风格与代码的风格保持一致 可以从机构的编程规范中摘取或引用（如果存在的话）。另外，描述包的开发类型，包括新研、改进、完全重用、采购等。表3XX软件包汇总表序号标识名称说明开发类型1PAK MMI XX2PAK MMI XX3PAK MMI XX4PAK MMI XX5PAK MMI XX64.1.1XX包设计4.1.1.1 功能说明描述包的主要功能。4.1.1.2 性能分配（可选）描述性能指标的在包中的分配情况。4.2 执行方案必须覆盖需求中的业务流程注释：本阶段仅完成业务流程到包的设计即可。4.

15、2.1 XX功能/业务421.1 流程说明简要描述完成该业务所牵涉到的包，即在该业务中包的功能。例如：完成XX功能，需要涉及到 XX包、YY包。XX包主要负责 XX, YY包主要负责 XX=4.2.1.2 补充说明（可选）针对复杂度较高或者具有特殊性的业务功能。4.3 接口设计设计人员确定内外部接口的命名规则，确保软件设计文档的风格与代码的风格保持一致。可以从机构的编程规范中摘取或引用（如果存在的话）。4.3.1 外部接口描述CSCI外部包/组件间的接口信息，接口种类分成 API接口、信息接口和数据 库接口。使用图表的形式描述接口。图4外部接口示意图4.3.1.1 API 接口设计表4 API

16、接口设计表序号实现方依赖方接口名称接口标识接口功能说明备注124.3.1.2 信息接口设计表5信息接口设计表序号实现方依赖方接口名称接口标识接口功能说明备注12431.3数据库接口设计表6信息接口设计表序号表名标识数据项写入方读取方备注1标识/密码24.3.2 内部接口描述CSCI包/组件内部接口，即CSCI类之间接口关系。具体接口形式参见外部 接口。下表是接口的详细设计，在不影响后续开展详细设计的情况下，在概要设计中为可选，并可在后续详细设计中体现或由接口协议文件代替接口标识女如： I/F-A-B-01,以此类推。使用说明对于通讯接口，必要时，在此说明通讯的协议、传输格式、数据传 输率、周期

17、或非周期等数据元素说明名称英文名 称简短描述类型测量 单位极限值/值域精确度精度 /分 辨率合法 性检 查经度I1检杳是否 大于05用户界面设计（可选）5.1 应当遵循的界面设计规范结合用户需求和组织相关规范，阐述本软件用户界面设计应当遵循的规范（原则、 建议等）。可以从机构的编程规范中摘取或引用（如果存在的话）。5.2 界面信息汇总表7 XX软件界面汇总表标识号（XX主界面）序号标识名称说明备注1.子界面标识XX主要完成XX功能。标识号（XX主界面）序号标识名称说明备注1.子界面标识XX主要完成XX功能。5.3 界面视图5.3.1 XX主界面绘制主界面的视图，并简要介绍。531.1 XX子界

18、面绘制子界面的视图，并简要介绍。5.3.2 XY主界面绘制主界面的视图，并简要介绍。5.3.2.1 XX子界面绘制子界面的视图，并简要介绍。5.4 人因设计（可选）（1）阐述界面的布局及理由；（2）阐述界面的色彩及理由。5.5 界面资源设计（可选）5.5.1 图标资源5.5.2 图像资源5.5.3 界面组件6数据（库）结构设计（可选）从永久性数据存储方面来对系统进行说明。如果几乎或根本没有永久性数据，或 者设计模型与数据模型之间的转换并不重要，那么本节就为可选。注：如果需要可以单独形成数据库设计说明，此处可以直接应用该文档。6.1 逻辑结构设计要点给出本系统内所使用的每个数据结构的名称、标识符

19、以及它们之中每个数据项、 记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。16昨勺口畑nzr于二亏二 URL V&rcBrZfi盘员IDwdhMp!54】¥»rt±ari254-)vardwp&fi*»rcar25-<'ardrar就 54)wwciTFZM-n"*civ<intSSMI、m甘w 2空L S-rlDinivaji 8254)u =".”E E> :in:主誉专亡，EW二遷島祈 wadw（2&4） 授龙-* vBroraT；? J 蚕亡 FF 31旷：

20、兽图5数据库逻辑结构图表8XX表字段结构序 号字段名称字段标识字段类 型长度主键外键非空注释1是/否是/否是/否默认值等26.2 物理结构设计要点给出本系统内所使用的每个数据结构中的每个数据项的存储要求，访问方法、存 取单位、存取的物理关系（数据库实例、表空间、表权限）、设计考虑和保密条件。7配置文件设计（若有）对本CSCI软件使用的所有配置文件进行设计，包括配置文件的格式及配置项的说明（可用表格形式列出）7.1 XX配置文件7.2 XX配置文件8部署设计本节用来说明运行软件的两种部署设计，其中包括设计部署和物理部署两部分。设计部署用于说明设计过程与软件实体的对应关系，物理部署用于说明软件实体

21、与物 理台位间的映射关系，对于每种配置，至少应该指出执行该软件的物理节点 （计算机、 CPU及其互连情况（总线连接、LAN连接、点到点连接等）。注：如果软件的部署一目了然，那么本节就为可选。8.1 设计部署表9 XX软件设计部署表序号软件实体设计包备用1XX.0xx包2xx.dllxx包3xx.exexx包8.2 物理部署WinX系统多功能显控台B壬务计算机3信息收集/分发构件任务计算集成框架图6 XX软件物理部署图心析构件了示构件人机界面集成框架WinXI系统耳标管理服务构件干扰状态处理服务构件WinX系统任务计算集成框架表10 XX软件物理部署表序号物理台位软件实体备用1XX显控台XX.0

22、2XX计算机XX.dll3XX服务器xx.exe9运行设计（可选）本节设计内容主要针对自动化处理软件。包括测控软件、自动运行的服务程序等 软件系统。9.1 运行包组合说明对系统施加不同的外界运行控制时所引起的各种不同的运行进程/组件的组合，说明每种运行所历经的内部软件和支持软件。图7运行包组合图9.2 运行控制说明每一种外界的运行控制的方式方法和操作步骤。图8运行控制图9.3 运行时间说明每种运行软件单元组合将占用各种资源的时间。10性能设计说明为了达到需求中规定的性能要求而需要进行特殊的设计、专门的处理方法。 需明确性能指标分解的原因，指明实现每个性能指标的主要包，对每个性能指标说明 其约束条件及在约束条件（含软件条件及硬件条件）下达到性能指标所采取的设计方 法。10.1 XX性能XX11系统出错处理设计11.1 出错信息用一览表的方式说明每种可