软件设计说明书模板

《软件设计说明书模板》由会员分享，可在线阅读，更多相关《软件设计说明书模板（28页珍藏版）》请在金锄头文库上搜索。

1、XX 系统_1.0.0软件设计说明书XXXX软件股份有限公司文档说明本文档所涉及到的文字、图表等，仅限于XXX软件有限公司内部使用，未经书面许可，请勿扩散。文档属性：属性内容产品名称XXX产品版本1.0.0文档标题软件设计说明书文档版本1.0作者your name完成部1门XXX完成日期2011-10-25密级机密完成状态发布文档变更历史:用户确认:客户方公司方客户代表确认确认时间公司代表确认确认时间文档送呈:姓名目的本文档仅XXXXX软件有限公司和被呈送方内部使用，未经双方许可，请勿扩散到第三方。目录1 前言11.1 编写目的11.2 适用范围11.3 参考资料11.4 术语定义22 概述2

2、2.1 产品定位32.2 设计约束33 总体设计43.1 功能架构43.2 数据架构43.3 技术架构54 产品开发规范54.1 UI布局规范64.2 前端开发规范64.3 后端开发规范64.4 代码风格规范75 目录及配置文件说明75.1 工程目录75.2 类存放目录85.3 配置文件目录85.4 页面配置目录85.5 代码提交规范96 功能模块设计96.1 功能模块1106.1.1 子功能模块1106.1.2 子功能模块2126.2 功能模块2127 非功能性需求的设计127.1 性能需求的设计127.2 功能迁移需求的设计147.3 权限控制需求的设计147.4 浏览器版本要求的设计14

3、8 接口设计158.1 内部接口158.1.1 内部接口 1168.2 外部接口168.2.1 外部接口 1169 数据库设计179.1 XX模块数据定义189.1.1 表结构说明189.1.2 视图说明209.1.3 SQL 说明219.1.4 存储过程219.1.5 表存储说明229.2 性能设计2310 图表目录251前言1.1编写目的【内容】说明此文档的主要目的，如用来内部评审，或指导每个研发人员熟悉功能和相关设计等目的。【裁剪原则】此部分内容不允许裁剪掉。1.2适用范【内容】本文的主要受众以及产品适用的用户。如列出本产品的任务提出者、需求分析者、开发者、用户以及将运行该项软件的单位。

4、具体开发范围注意与立项申请中的范围对应。【裁剪原则】此部分内容不允许裁剪掉。1.3参考资料表格1.参考资料表序号文档名称文档作者发表日期1234写本文档时用到的参考资料，可以是外部的一本书或文章，也可以是公司内部文档， 也可以是一个URL连接。如果是书、文章、内部文档，请写明名称、作者、发表日期等信息。如果是URL连接，请用简要内容加原始7RL的方式作为名称，如：云计算的搭建实 践:http:/aa.bb.cc.dd/xx.html【裁剪原则】此部分内容不允许裁剪掉。1.4术语定义项目/产品中碰到的主要术语，包括技术和业务方面的，通常是业界已有的术语，对于 本产品要定义的概念，应该对应到需求规

5、格说明书中的概念模型。【裁剪原则】此部分内容不允许裁剪掉。2概述【内容】本小段建议简要阐述一下设计人员对需求规格说明书的理解，从而做到需求到设 计的平滑过渡。设计评审的过程中，需求分析人员会非常看重“概述”及“总体设计”两大章节。【裁剪原则】此部分内容不允许裁剪掉。2.1产品定位【内容】简述此系统“是什么”1. 对应新产品，要让之前未接触过该领域的读者能看懂本章节，如说明什么领域的 什么人群会使用本产品，主要包括的几大项功能是什么；2. 对于升级产品，在说明1的情况下，还要能简要说明产品本次升级版本的定位， 包括针对外部用户的变化（如主要哪几项功能得到提升或新增、用户体验如何得 到提升、操作如

6、何得到简化等）和内部用户的变化（如实施人员的实施技能要求 如何降低、实施周期如何缩短）【裁剪原则】此部分内容不允许裁剪掉。2.2设计约束【内容】要涵盖需求规格说明书的“前置条件”章节，同时还可以根据需求增加：系统应 当遵循的标准或规范、软件、硬件环境的约束、接协议的约束等等。【裁剪原则】此部分内容不允许裁剪掉。3总体设计3.1功能架构【内容】将系统分解为若干模块，绘制逻辑图，说明各模块如何协调工作，如何实现这些业务 功能。此功能架构图应该基于需求规格说明书中功能架构图的基础上进行细化，保持延 续性。如果是升级项目，请用不同颜色区分修改模块、新增模块与已有模块。【裁剪原则】此部分内容不允许裁剪掉

7、。3.2数据架构【内容】本章节应该用一个大图或多个小图来画出系统具有的重要对象模型，以及这些对象模 型的关系（请注意参考需求规格说明书的概念模型章节并辅助以文字描述。对象模 型是用来描述、细化和串联：对象（实体概念发生在对象上的行为（动作概念）以及对 象之间关联关系的（关系可以在对象上作为属性同时关系本身也可以作为对象）部分系 统对象又通过各种-人Mapping的开发手段持久化到了数据库中，对于这部分持久化了的 对象对应的数据库表，则还需要到“数据库设计”章节详细说明。【裁剪原则】此部分内容不允许裁剪掉。3.3技术架构【内容】说明系统采用的技术架构与物理部署结构，如下：技术架构：描述系统层次结

8、构以及技术框架、组件的选用，请画图说明。物理部署架构：用来说明存在分布式部署，前置采集部署，远程部署等情况的物理部 署图，请画图说明。【裁剪原则】此部分内容不允许裁剪掉。4产品开发规范【内容】此章节是产品发布文档二次开发手册的重要来源，即产品研发相关的规范同样适 用于二次开发。鉴于产品的业务不同，可以根据具体要求增加相关子章节而不仅限于目前的子章节。【裁剪原则】此部分内容不允许裁剪掉。4.1 UI布局规范【内容】UI布局规范是通用的规范，针对IXX公司发布的UI统一开发规oc来进行增 减（因为部分内容本产品可能用不到或者部分内容还要细化主要作为通用的布局和基本 界面布局的要求，未涉及到产品具体

9、数据的呈现要求。通过本章节的规范来约束让本产品 的风格统一、界面漂亮。【裁剪原则】此部分内容不允许裁剪掉。4.2前端开发规范【内容】此处重点强调界面上根据本产品的业务特点说明如何尽量做到显示和组织数据的合理 性，从而不只做到漂亮，还要做到能提升用户体验包括：图形如何呈现、图表默认样式、 表格默认排序、表格数据空值处理、网络速率数据的GT处理等，还可以包括前端页面 文件命名等，此部分是开发人员在开发页面作呈现时必须遵守的细节规定。【裁剪原则】此部分内容不允许裁剪掉。4.3后端开发规范【内容】此处重点强调后端开发的相关要求，如调度、接口、设计模式、文件类和函数命名、路径等等的统一要求，此部分是强调

10、开发人员在开发后端程序时必须遵守的规定。【裁剪原则】此部分内容不允许裁剪掉。4.4代码风格规范【内容】此处重点强调代码的风格此部分是强调开发人员在开发所有程序时必须遵守的规定。【裁剪原则】此部分内容不允许裁剪掉。5目录及配置文件说明【内容】说明开发过程涉及到的配置文件、文件目录等的说明。此章节将作为产品发布文档配置参考手册的重要来源。【裁剪原则】关于此系统若没有特殊说明，此部分内容不允许裁剪掉。5.1工程目录【内容】说明开发工程中CW或svn路径说明。【裁剪原则】关于此系统若没有特殊说明，此部分内容不允许裁剪掉。5.2类存放目录【内容】说明开发工程中京c下类包的分类、创建、修改、删除等相关的要

11、求，说明代码包的 命名、结构和约束。【裁剪原则】关于此系统若没有特殊说明，此部分内容不允许裁剪掉。5.3配置文件目录【内容】说明开发过程中用到配置文件的说明。【裁剪原则】关于此系统若没有特殊说明，此部分内容不允许裁剪掉。5.4页面配置目录【内容】说明开发工程中表示层所等）文件的说明。【裁剪原则】关于此系统若没有特殊说明，此部分内容不允许裁剪掉。5.5代码提交规范【内容】工程中开发人员代码提交的注意事项，一般应用在团队整体开发，在提交个人代码到 cvs 或svn上的说明。【裁剪原则】关于此系统若没有特殊说明，此部分内容允许裁减掉。6功能模块设计【内容】对模块功能设计进行描述，对应需求规格说明书的

12、“产品功能”章节，同时务必 结合“产品原型”和“产品业务场景”进行详细叙述。此章节的子章节组成关系可对应到需求规格说明书中的“产品功能”章节（通常 章节上应该稍微多于需求规格说明书同时每个子功能在研发团队中都应该考虑如何履行 自测互测的相关工作：1. 在提交测试之前，每个产品的每个版本的每个新做的子功能应该都是经过自测互 测的，自测就是本子功能的开发人员自己做的测试，互测应该是和该子功能可能 相关的其他研发人员，比如推荐由该子功能的上下游的开发人员来进行互测，也 就是由提供者或者消费者来体验测试该子功能；2. 提交给测试人员的每个产品的每个版本需要同时提交一份自测互测责任表 表格中为子功能和自

13、测互测的交叉矩阵，每个子功能的自测不少升，互测不 少于2人，表格中的人员通常应该是参与代码编写的研发人员；3. 提交给测试人员的每个产品的每个版本需要同时提交一份冒烟测试责任书此责任书的负责人应该是不参与写代码的支持人员或者业务人员；【裁剪原则】此部分内容不允许裁剪掉。6.1功能模块1【内容】简单总结本功能模块。【裁剪原则】此部分内容不允许裁剪掉。6.1.1子功能模块1【内容】简单总结本子功能模块。【裁剪原则】此部分内容不允许裁剪掉。6.1.1.1功能描述【内容】对本子功能模块的设计进行详细描述。【裁剪原则】此部分内容不允许裁剪掉。6.1.1.2处理流程【内容】绘制本子功能模块的数据流图，说明

14、本子模块相关的数据库表和配置文件，并对处理 流程进行详细描述。【裁剪原则】此部分内容不允许裁剪掉。6.1.1.3 约束【内容】设计中功能模块间存在的数据引用关系和内部的相关限制说明。【裁剪原则】此部分内容不允许裁剪掉。6.1.1.4界面原型【内容】设计中功能模块准备实现的截图，此处务必首先参考原型。【裁剪原则】关于此系统若没有特殊说明，此部分内容允许裁剪掉。612子功能模块26.2功能模块27非功能性需求的设计【内容】对应需求规格说明书的“非功能性需求”中的除“前置条件”和“集成需求”之 外四个章节的设计说明。因为：“前置条件”已对应到了本文档的“设计约束”而“集成需求”对应到了本文 档的“接口设计。【裁剪原则】此部分内容不允许裁剪掉。7.1性能需求的设计【内容】对应需求规格说明书的每个条目进行逐条设计的详细说明。1. 系统关键业务的界面响应速度：G关键业务泛指用户使用较为频繁、用户体验较为重要的事务，如系统首页的 登录，自定义报表的