软件概要设计说明书范例

模板编号GENWEB模板版本XX概要设计说明书拟制某某某日期2018年10月20日审核日期批准日期模板编号GENWEB模板版本文档修改记录修改日期版本/状态作者修改章节修改描述2017-10-17某某某初版发布模板编号GENWEB模板版本填写说明系统结构的定义本体系对整个软件系统按如下结构方式进行划分：系统->子系统->模块->子模块其中：〔1〕“系统T子系统”划分属于“系统设计”，在系统设计说明书中予以描述。〔2〕“子系统T模块”划分属于“概要设计”，在本说明书中予以描述。〔3〕“模块T子模块”划分属于“详细设计”，在详细设计说明书中予以描述。如果系统相对简单，可以省略“子模块”这一层次。如果填写了系统设计说明书，则在本说明书中略过“系统T子系统”划分的相关内容〔即第2章〕。如果系统相对简单，不需要做“系统T子系统”划分，这种情况下，取消填写系统设计说明书，只须填写本说明书，直接套用“子系统T模块”划分〔即第3章〕进行“系统T模块”划分〔把其中“子系统”一词替换为“系统”〕，并删除本说明书中“系统->子系统”划分的相关内容〔第2章〕。模板编号GENWEB模板版本目录TOC\o"1-5"\h\z\o"CurrentDocument"1.简介 1\o"CurrentDocument"背景和目的 11.2. 范围 1\o"CurrentDocument"术语和缩略语 1\o"CurrentDocument"2.系统总体设计 1\o"CurrentDocument"2.1. 任务概述 2\o"CurrentDocument"目标 2\o"CurrentDocument"2.1.2.需求概述 2\o"CurrentDocument"2.2.设计概述 2\o"CurrentDocument"2.2.1.总体约束 2\o"CurrentDocument"2.2.2.系统外部接口 2\o"CurrentDocument"2.2.3.设计方案概述 2\o"CurrentDocument"系统架构设计 3\o"CurrentDocument"2.3.1.系统的逻辑架构设计 32.3.2.系统的物理架构设计 4\o"CurrentDocument"子系统定义 52.4.1.子系统列表 5\o"CurrentDocument"2.4.2.子系统间关系 53.子系统1设计 6\o"CurrentDocument"3.1.任务概述 6\o"CurrentDocument"目标 6\o"CurrentDocument"3.1.2.需求概述 6\o"CurrentDocument"3.2.设计概述 6\o"CurrentDocument"3.2.1.总体约束 6\o"CurrentDocument"子系统外部接口 7\o"CurrentDocument"3.2.3.设计方案概述 8\o"CurrentDocument"3.3.子系统架构设计 8\o"CurrentDocument"3.4.模块定义 10模板编号GENWEB模板版本TOC\o"1-5"\h\z3.4.1.模块列表 10\o"CurrentDocument"3.4.2.模块间关系 1..1\o"CurrentDocument"3.4.3.模块描述 1..1\o"CurrentDocument"非功能性需求的实现方案 12\o"CurrentDocument"6.1. 性能的考虑 12\o"CurrentDocument"兼容性的考虑 13\o"CurrentDocument"安全的考虑 13\o"CurrentDocument"6.4. 可移植性的考虑 13\o"CurrentDocument"6.5. 集成与测试的考虑 13\o"CurrentDocument"6.6. 可扩展性的考虑 13\o"CurrentDocument"6.7. 可靠性的考虑 13\o"CurrentDocument"6.8. 可维护性的考虑 14\o"CurrentDocument"5.难点及解决方案 14\o"CurrentDocument"6.参考资料 147.附录 15模板编号GENWEB模板版本1.简介1.1.背景和目的本文档编制的目的是说明对软件系统的设计考虑，包括软件系统的基本处理流程，软件系统的组织结构、模块划分、功能分配、接口设计、运行设计、数据结构设计和出错处理设计等，为软件的详细设计奠定基础。1.2.范本文档适用于消息推送项目二期产品的服务端。1.3.术语和缩略语缩略语英文全名中文解释XMPPTheExtensibleMessagingandPreseneeProtocol可扩展通讯和表示协议2.系统总体设计{裁剪说明：如果已编写系统设计说明书，或项目不做“系统子系统”划分，此章省略；否则内部的各节必须按要求填写。}{“系统 >子系统”划分。}{目的：1〕设计系统整体框架：系统最高层次的逻辑结构、物理结构；2〕子系统的划分与依赖关系定义、子系统之间的接口定义、子系统功能定义。}模板编号GENWEB模板版本2.1.任务概述目标实现目标和功能。需求概述参考“软件需求规格说明书”。设计概述2.2.1.总体约束系统外部接口2.2.3.设计方案概述建立一套即时通讯&消息推送的解决方案：1） 云端运用spring+mina+jgroups建立一个分布式的服务端系统，以XMPP协议提供接口；2） 终端运用smack建立一个XMPP协议的客户端，调用协议接口实现消息接收和终端展示。2・3■系统架构设计2・3・1・系统的逻辑架构设计2・3・2・3■系统架构设计2・3・1・系统的逻辑架构设计2・3・1・1・单IDC服务器架构图弟二方推退平台AcihcMQ{II®SFllbask：}第=方摧送接口沱汁服舒窖 I版探服停岩【制左&据对擲蛊MPP帳外总蛭 模板编号GENWEB模板版本分六层结构：负载均衡层、接入层、逻辑处理层、数据访问层、数据层、WEB层。1） 负载均衡层：TV终端通过域名访问云端，DNS智能解析终端的IP地址让它连接就近的分发服务器，从分发服务器获取接入服务器列表，然后断开XMPP连接；2） 接入层：TV终端和接入服务器建立XMPP长连接，创建会话；3） 逻辑处理层：终端协议服务器、推送服务器〔RS〕、统计服务器。a） 终端协议服务器：终端往接入服务器发送协议包，接入服务器转发给终端协议服务器处理；b） 推送服务器：负责从MQ取出消息、解析消息〔条件体和消息体〕、终端在线和离线查询、按各接入服务器有哪些终端登录把消息包分发给接入服务器；模板编号GENWEB模板版本c）统计服务器：运用quartz执行定时任务，实现终端每天在线数、终端每小时在线数、终端每天激活数、终端登录次数、消息推送结果等统计功能。4）数据访问层：提供数据访问组件，如MysqlJDBC接口、jedis缓存接口。提供第三方推送接口，供第三方云端调用的API，提供单点推送〔明消息/暗消息〕条件〔区域+机型〕推送、regid推送。5） 数据层：Mongodb集群，Mysql数据库〔主从+读写别离〕，ActiveMQ消息队列，Redis缓存服务器。6） WEB层：运营平台、第三方推送平台。2・3・1・2・多IDC服务器架构图需要整理2・3・2・系统的物理架构设计IDC1T¥端模板编号GENWEB模板版本2・4・子系统定义2.4.1.子系统列表子系统编号子系统名称〔标识〕功能描述开发方式1运吕平台子系统由超级管理员和运营人员使用，提供第三方管理、基础数据、消息管理、运维、统计、系统设置、日志查询等功能。自行开发2第三方推送接口子系统供第三方云端调用的API，提供单点推送〔明消息/暗消息〕、条件〔区域+机型〕推送、regid推送。自行开发3第三方推送平台子系统给第三方使用，提供开发者账号注册、应用管理、消息发布、消息推送结果查询等功能。自行开发4推送服务器子系统云端的一个逻辑服务器，实现从MQ取出消息、解析消息〔条件体和消息体〕、终端在线和离线查询、按各接入服务器有哪些终端登录把消息包分发给接入服务器。自行开发5后台任务子系统云端的后台任务系统，运用quartz执行定时任务，实现终端母天在线数、终端母小时在线数、终端每天激活数、终端登录次数、消息推送结果等统计功能。自行开发6云端与终端接口：分发服务器、接入服务器、终端协议服务器为消息盒子终端提供云端接口，用XMPP协议。提供获取接入服务器列表、电视终端获取唯一标识userid、以userid登录认证、建立会话及长连接、推送消息、反馈消息接收和点击情况、终端应用激活上报等协议。自行开发7云端集群在云端用JGroups技术组建一个集群，管理各逻辑服务器，实现各成员之间的通讯、成员状态反馈、成员列表维护等功能。自行开发注：开发方式可选：采购、外包、自行开发、复用。2.4.2.子系统间关系{裁剪说明：必填}{明确子系统之间的调用关系、子系统间的接口〔消息、数据结构〕以及相关子系统之间的协同工作，可以使用结构图、〔交互〕事务图、消息序列图、ER图描述。}模板编号GENWEB模板版本3・子系统1设计{裁剪说明：必填}{标题上加入子系统的编号及名称〔标识〕}{“子系统 >模块”划分。}{目的：1〕设计子系统整体框架：子系统的逻辑结构；2〕模块的划分与依赖关系定义、模块之间的接口定义、模块功能定义。}3.1.任务概述目标{裁剪说明：可选}{说明设计意图目标〔总目标、分期目标〕、作用范围等。}3.1.2.需求概述{裁剪说明：可选}{解释软件产品将完成或不完成的功能〔可以直接描述也可以参考相关文档〕}3.2.设计概述总体约束开发标准{裁剪说明：可选。如果已填写在，此处则略。}〔1〕编码约定{规定代码体系、模块之间的接口和命名规则。}模板编号GENWEB模板版本〔2〕文件约定{规定子系统的所有配置、日志等文件命名方式与格式。}〔3〕目录约定{规定子系统的目录结构，包括运行目录、源文件目录、配置目录、日志目录、数据目录等。}3212XX约束{裁剪说明：可选。如果已填写在，此处则略。}{列出对软件设计有重要影响的系统内外部约束和限制，可选的约束包括：•用户环境•内存或其它资源限制•数据存储和分发需求•安全和可靠性需求•性能需求•测试和可维护性需求}3.2.2.子系统外部接口{裁剪说明：如果第2章已删除，这里必填〔如果有〕。}{描述该软件子系统与外部实体的接口，包括用户界面、软件接口、硬件接口和通信接口。}{软件子系统的外部实体，包括：操作系统、驱动程序、硬件、中断、其它软件子系统等。}{描述待开发软件子系统与外部实体的关系，可以使用系统架构图、顶层数据流图、事务图等来描述系统结构和交互关系，并标示出外部实体和本系统相互作用的性质〔比方：消息、库调用〕和类型〔比方：OS服务、通信服务、系统工具等〕。}{详细描述子系统外部接口的参数，如：•接口名称调用方式传输的数据：-哪些数据项?模板编号GENWEB模板版本-数据格式?-长度？-类型？频度〔实时/批处理〕数据同步机制平台无关性•遵循的标准•提供的功能•前置条件•后置条件}3.2.3.设计方案概述{裁剪说明：必填。如果在“”中已描述过的部分，可略。}{描述内容包括：〔1〕整个设计所采用的方法：面向对象设计还是结构化设计〔2〕采用的系统架构：例如MVC架构、N层架构〔3〕使用的相应技术和工具：例如OMT、Rose、Visio〔4〕采用的框架技术的形式〔5〕使用的设计模式：层模式、微内核模式、代理模式等〔6〕描述资源/内存分配，Flash资源/文件分配〔7〕描述哪些模块采用软件复用}3.3.子系统架构设计{裁剪说明：必填}{定义子系统的总体逻辑结构，定义模块划分以及模块之间的依赖关系。}{可以采用分层结构描述如何将子系统分解为模块。}模板编号GENWEB模板版本{结构描述可以使用结构图、层次分解图、数据流图，并用文字说明相互间的关系。}{举例，绘制结构图如下：具有继承等关系的类图的可使用UML等工具画出关系图，如下:LoginActlvityBaseTabActivityeom.tel.e&mmon.eshare,htftpMyHloimieActiMt#WelboCanitentActMtycam.td.commcm.c^hare.dbPastWeiboAetivltyMySpacaActlvityconn.tel.cqmimon™cshare,dmLoginActlvityBaseTabActivityeom.tel.e&mmon.eshare,htftpMyHloimieActiMt#WelboCanitentActMtycam.td.commcm.c^hare.dbPastWeiboAetivltyMySpacaActlvityconn.tel.cqmimon™cshare,dmeem»tel亡cmmamcshaireaexeeptionweiboAandlroid模板编号GENWEB模板版本EomhEomhtci(eomman.cshare3.4.模块定义341■模块列表｛裁剪说明：必填｝｛列举模块时，可以采用表格方式〔编号可以省略〕。｝模块编号模块名称〔标识〕功能简述开发方式模板编号GENWEB模板版本注：开发方式可选：采购、外包/自行开发/复用3.4.2.模块间关系{裁剪说明：必填}{明确模块之间的调用关系、模块间的接口〔消息、数据结构〕以及相关模块之间的协同工作如模块间时序图，协作图，以及系统之间状态切换流程图。}3.4.3.模块描述.模块1{标题上加入模块的编号及名称〔标识〕}1〕功能描述{裁剪说明：必填}{说明该模块具备什么样的基本功能，以及每个功能之间的相互关系。}2〕性能描述{裁剪说明：必填}{说明对模块的性能要求，包括精度、时间特性和处理速度。}3〕接口描述{裁剪说明：必填}{说明与其它模块的接口，与其它系统或硬件的接口。}{对于接口函数，可以采用以下形式描述：接口1：形式：输入：输出：返回：描述返回什么。描述：总体描述该接口实现的目的。{需要明确的信息包括：1〕输入项列出模块每一个输入项的特性，包括名称、方式、数量和频度、输入介质等；可以是逻辑层面的输入项，如：图片资源、入项，如变量1、变量2，等等。2〕输出项列出模块每一个输出项的特性，包括名称、方式、数量和频度、输出介质等。}返回：描述返回什么。描述：总体描述该接口实现的目的。{需要明确的信息包括：1〕输入项列出模块每一个输入项的特性，包括名称、方式、数量和频度、输入介质等；可以是逻辑层面的输入项，如：图片资源、入项，如变量1、变量2，等等。2〕输出项列出模块每一个输出项的特性，包括名称、方式、数量和频度、输出介质等。}4〕配置描述{裁剪说明：可选}{说明该模块所处的逻辑位置、物理位置，模板编号GENWEB模板版本标识、数据的类型和格式、数据值的有效范围、输入媒体流、网络数据等，也可以是具体的物理层面的输标识、数据的类型和格式，数据值的有效范围、输出如指明模块放在哪个应用服务器或客户端的哪个目录、哪个文件〔库〕，或是在数据库内部建立的对象。}.模块2{同。}非功能性需求的实现方案{裁剪说明：整章可选}6.1.性能的考虑{如：为满足延时、吞吐量等性能，在既定硬件环境约束下所采取的设计方案。}模板编号GENWEB模板版本6・