软件产品设计项目说明指导书

{项目名称}软件产品设计阐明书文献状态：[√]草稿[]正式发布[]正在修改文献标记：Company-Project-PIM-PROPOSAL当前版本：X.Y作者：完毕日期：Year-Month-Day北京捷诺视讯数码科技有限公司BeijingGeneralDVRScience&TechnologyCo.Ltd二零一零年五月版本历史版本/状态作者参加者起止日期备注

目录TOC\o"1-3"\h\z目录 3一、 简介 5二、 体系构造设计 52.1、 目 52.2、 角色与职责 62.3、 启动准则 62.4、 输入 62.5、 重要环节 62.5.1、 设计准备 62.5.2、 拟定影响系统设计约束因素 62.5.3、 拟定设计方略 72.5.4、 系统分解与设计 72.5.5、 撰写体系构造设计文档 72.5.6、 体系构造设计评审 72.5.7、 [后续活动] 82.6、 输出 82.7、 结束准则 82.8、 度量 8三、 顾客界面设计 83.1、 目 83.2、 角色与职责 83.3、 启动准则 83.4、 输入 93.5、 重要环节 93.5.1、 设计准备 93.5.2、 顾客界面设计 93.5.3、 撰写顾客界面设计文档 103.5.4、 顾客界面设计评审 103.5.5、 [后续活动] 103.6、 输出 113.7、 结束准则 113.8、 度量 11四、 数据库设计 114.1、 目 114.2、 角色与职责 114.3、 启动准则 114.4、 输入 114.5、 重要环节 124.5.1、 设计准备 124.5.2、 数据库设计 124.5.3、 撰写数据库设计文档 134.5.4、 数据库设计评审 144.5.5、 [后续活动] 144.6、 输出 144.7、 结束准则 144.8、 度量 14五、 模块设计 145.1、 目 145.2、 角色与职责 145.3、 启动准则 155.4、 输入 155.5、 重要环节 155.5.1、 设计准备 155.5.2、 模块设计 155.5.3、 撰写模块设计文档 165.5.4、 模块设计评审 165.5.5、 [后续活动] 165.6、 输出 165.7、 结束准则 165.8、 度量 17六、 实行建议 17

设计简介系统设计（SystemDesign，SD）是指设计软件系统体系构造、顾客界面、数据库、模块等，从而在需求与代码之间建立桥梁，指引开发人员去实现能满足顾客需求软件产品。系统设计过程域是CMM模型重要构成某些。本规范阐述了系统设计过程域四个重要规程：体系构造设计顾客界面设计数据库设计模块设计上述每个规程“目的”、“角色与职责”、“启动准则”、“输入”、“重要环节”、“输出”、“完毕准则”和“度量”均已定义。系统设计过程域分为两个阶段：高层设计阶段和详细设计阶段。高层设计阶段重点是软件系统体系构造设计。详细设计阶段重点是顾客界面设计、数据库设计和模块设计，如图所示。需求开发高层设计阶段体系构造设计数据库设计顾客界面设计模块设计实现与测试详细设计阶段需求开发高层设计阶段体系构造设计数据库设计顾客界面设计模块设计实现与测试详细设计阶段系统设计过程域示意图系统设计过程域产生重要文档有：《体系构造设计报告》。《顾客界面设计报告》。《数据库设计报告》。《模块设计报告》。体系构造设计目分析与设计软件体系构造。通过系统分解，拟定子系统功能和子系统之间关系，以及模块功能和模块之间关系，产生《体系构造设计报告》。角色与职责项目经理指定若干名开发人员从事体系构造设计（如下称为体系构造设计人员）。启动准则体系构造设计人员已经拟定。输入需求文档如《产品需求规格阐明书》重要环节 体系构造设计流程如图所示。Step3.拟定设计方略Step2.拟定约束因素Step1.设计准备Step3.拟定设计方略Step2.拟定约束因素Step1.设计准备Step4.系统分解设计Step6.设计评审Step5.撰写文档体系构造设计流程设计准备项目经理或者技术负责人分派系统设计任务，涉及体系构造设计、模块设计、顾客界面设计、数据库设计等。本活动也许产生一份阶段性开发筹划，如《系统设计筹划》，视工作量而定。体系构造设计人员阅读需求文档，明确设计任务。体系构造设计人员准备有关设计工具（如RationalRose）和资料。拟定影响系统设计约束因素需求约束。体系构造设计人员从需求文档如《软件需求规格阐明书》中提取需求约束，例如：本系统应当遵循原则或规范软件、硬件环境（涉及运营环境和开发环境）约束接口/合同约束顾客界面约束软件质量约束，如对的性、健壮性、可靠性、效率（性能）、易用性、清晰性、安全性、可扩展性、兼容性、可移植性等等。隐含约束。有某些假设或依赖并没有在需求文档中明确指出，但也许会对系统设计产生影响，设计人员应当尽量地在此处阐明。例如对顾客教诲限度、计算机技能某些假设或依赖，对支撑本系统软件硬件假设或依赖等。拟定设计方略体系构造设计人员依照产品需求与发展战略，拟定设计方略（DesignStrategy）。例如：扩展方略。阐明为了以便本系统在将来扩展功能，当前有什么办法。复用方略。阐明本系统在当前以及将来复用方略。折衷方略。阐明当两个目的难以同步优化时如何折衷，例如“时－空”效率折衷，复杂性与实用性折衷。系统分解与设计体系构造设计人员：将系统分解为若干子系统，拟定每个子系统功能以及子系统之间关系。将子系统分解为若干模块，拟定每个模块功能以及模块之间关系。拟定系统开发、测试、运营所需软硬件环境。撰写体系构造设计文档体系构造设计人员依照指定模板撰写《体系构造设计报告》，重要内容涉及：软件系统概述影响设计约束因素设计方略系统总体构造子系统构造与模块功能开发、测试、运营所需软硬件环境体系构造设计评审体系构造设计人员邀请同行专家、开发人员对体系构造进行正式技术评审。体系构造评审重点不是“对还是错”，而是“好还是差”。重要评审要素涉及：适当性。考察该体系构造与否适合于产品需求，与否可在预定筹划内实现。系统综合能力（Capability）。例如“时－空”效率（性能，容量等），可扩展性，可管理性（可维护性），可复用性，安全性等等，视产品特性而定。[后续活动]体系构造设计完毕后进入详细设计阶段（顾客界面设计、数据库设计、模块设计等）。输出《体系构造设计报告》结束准则《体系构造设计报告》已经完毕，并且通过了技术评审。度量体系构造设计人员记录工作量以及文档规模，报告给项目经理。顾客界面设计目设计软件顾客界面，产生《顾客界面设计报告》。制作顾客界面资源如图像、图标或者界面专用组件等。角色与职责项目经理指定若干名开发人员从事顾客界面设计（如下称为界面设计人员）。如果也许话，邀请顾客或美工人员协助设计顾客界面。启动准则需求文档已经完毕。体系构造设计已经完毕。输入需求文档体系构造设计文档重要环节 顾客界面设计流程如图所示。迭代Step2.界面设计Step4.设计评审Step3.撰写文档Step1.设计准备2.3细化2.2原型评估2.1原型创作迭代Step2.界面设计Step4.设计评审Step3.撰写文档Step1.设计准备2.3细化2.2原型评估2.1原型创作体系构造设计流程设计准备界面设计人员阅读需求文档和体系构造设计文档，明确界面设计任务。界面设计人员与顾客交流，理解顾客工作习惯和她们对界面看法。界面设计人员准备有关设计工具和资料，收集或创作基本界面资源如图像、图标以及通用组件。界面设计人员拟定本软件顾客界面设计规则（或指南），重要涉及：先进界面特性或通用设计原则；软件主界面（如主窗口、主页面）设计规则；软件子界面（如子窗口、子页面）设计规则；原则控件使用规则；美学设计规则。顾客界面设计顾客界面设计普通要经历“原型创作—>原型评估－>细化”等环节，普通迭代进行。[Step2.1]原型创作界面设计人员创作界面原型：先徒手画，或者用Visio等工具绘制界面视图；再用软件开发工具实现可以运营原型。[Step2.2]原型评估界面设计人员邀请顾客和同行们评估界面原型，汇集意见，及时改进。[Step2.3]细化界面设计人员细化界面原型，例如美工解决，添加细节等。补充阐明：开发人员在本阶段不必关怀界面原型代码质量，由于界面原型也许不断地被修改甚至被抛弃。撰写顾客界面设计文档顾客界面定型之后，界面设计人员依照指定模板撰写《顾客界面设计报告》，重要内容涉及：应当遵循界面设计规范；界面关系图和工作流程图；主界面视图、功能阐明、操作方式；子界面视图、功能阐明、操作方式；美学设计阐明。顾客界面设计评审界面设计人员邀请顾客和同行们对定型后界面进行正式技术评审，尽最大努力使界面变得更加美观、易用。顾客界面重要评审要素涉及：适当性简洁易用一致性美观动态反馈功能屏蔽和出错解决顾客控制国际化（兼容性和可移植性）适应性（针对各种顾客）[后续活动]在系统设计工作结束之后，开发人员编写界面代码，并和顾客一起通过各种途径测试界面，从而不断地完善顾客界面。（请参照关于测试文档）界面设计人员总结经验教训，不断地完善合用于本机构“顾客界面设计指南”。输出《顾客界面设计报告》结束准则《顾客界面设计报告》已经完毕，界面原型已经通过评审。度量界面设计人员记录工作量以及文档规模，报告给项目经理。数据库设计目设计软件数据库，产生《数据库设计报告》。角色与职责项目经理指定若干名开发人员从事数据库设计（如下称为数据库设计人员）。启动准则需求文档已经完毕。体系构造设计已经完毕。输入需求文档体系构造设计文档重要环节 数据库设计流程如图所示。迭代Step2.数据库设计Step3.撰写文档2.4优化2.3安全性设计2.2物理设计2.1逻辑设计Step1.设计准备Step4.设计评审迭代Step2.数据库设计Step3.撰写文档2.4优化2.3安全性设计2.2物理设计2.1逻辑设计Step1.设计准备Step4.设计评审数据库设计流程设计准备数据库设计人员阅读需求文档和体系构造设计文档，明确数据库设计任务。数据库设计人员准备有关设计工具和资料。数据库设计人员拟定本软件数据库设计规则（或指南），重要涉及：数据库命名规则逻辑设计规则（或指南）物理设计规则（或指南）安全性设计规则（或指南）优化规则（或指南）数据库管理与维护规则（或指南）数据库设计 数据库设计普通要经历“逻辑设计—>物理设计－>安全性设计－>优化”等环节，普通要迭代进行。逻辑设计数据库设计人员依照需求文档，创立与数据库有关那某些实体关系图（ERD）。如果采用面向对象办法（OOAD），这里实体相称于类（class）。物理设计设计表构造。普通地，实体相应于表，实体属性相应于表列，实体之间关系成为表约束。逻辑设计中实体大某些可以转换成物理设计中表，但是它们并不一定是一一相应。数据库表参照格式如表11-1所示。对表构造进行规范化解决（第三范式）。表名功能阐明列名数据类型（精度范畴）空/非空约束条件补充阐明数据库表参照格式安全性设计提高软件系统安全性应当从“管理”和“设计”两方面着手。这里仅考虑数据库安全性设计。顾客只能用帐号登陆到应用软件，通过应用软件访问数据库，而没有其他途径可以操作数据库。对顾客帐号密码进行加密解决，保证在任何地方都不会浮现密码明文。拟定每个角色对数据库表操作权限，如创立、检索、更新、删除等。每个角色拥有刚好可以完毕任务权限，不多也不少。在应用时再为顾客分派角色，则每个顾客权限等于她所兼角色权限之和。优化分析并优化数据库“时－空”效率，尽量地“提高解决速度”并且“减少数据占用空间”。分析“时－空”效率瓶颈，找出优化对象（目的），并拟定优先级。当优化对象（目的）之间存在对抗时，给出折衷方案。给出优化详细办法，例如优化数据库环境参数，对表格进行反规范化解决等。撰写数据库设计文档数据库设计人员依照指定模板撰写《数据库设计报告》，重要内容涉及：数据库环境阐明数据库命名规则逻辑设计物理设计安全性设计优化数据库管理与维护阐明数据库设计评审数据库设计人员邀请同行们对数据库进行正式技术评审。数据库重要评审要素涉及：对的性、完整性、一致性安全性“时－空”效率[后续活动]在系统设计工作结束之后，开发人员将编写与数据库有关代码，并和顾客一起通过各种途径测试数据库，从而不断地完善数据库。（请参照关于测试文档）数据库设计人员总结经验教训，不断地完善合用于本机构《数据库设计指南》。软件交付给顾客后，由顾客管理与维护数据库。输出《数据库设计报告》结束准则《数据库设计报告》已经完毕，并且通过了技术评审。度量数据库设计人员记录工作量以及文档规模，报告给项目经理。模块设计目设计软件所有模块重要接口与属性、数据构造和算法，产生《模块设计报告》。角色与职责项目经理指定若干名开发人员从事模块设计（如下称为模块设计人员），模块设计人员将在实现阶段编写这些模块代码。启动准则需求文档已经完毕。体系构造设计已经完毕。输入需求文档体系构造设计文档重要环节 模块设计流程如图所示。Step2.模块设计2.1接口与属性设计Step4.设计评审Step3.撰写文档Step1.设计准备迭代2.2数据构造Step2.模块设计2.1接口与属性设计Step4.设计评审Step3.撰写文档Step1.设计准备迭代2.2数据构造与算法设计模块设计流程设计准备模块设计人员阅读需求文档和体系构造设计文档，明确模块设计任务。模块设计人员准备有关设计工具和资料。模块设计人员拟定本软件编程规范，保证模块设计文档风格与代码风格保持一致。模块设计 模块设计普通要经历“接口与属性设计—>数据构造与算法设计”等环节，并且普通需要重复迭代。建议：由于当代软件开发工具越来越先进，模块详细设计和编程可以较好地融合一起，并且效率相称高，有些工具甚至具备代码自动生成功能。因此在系统设计阶段