软件分析报告模板.docx

资源描述

软件分析报告模板.docx

《软件分析报告模板.docx》由会员分享，可在线阅读，更多相关《软件分析报告模板.docx（77页珍藏版）》请在冰豆网上搜索。

软件分析报告模板.docx

软件分析报告模板

3.软件开发

错误！

未定义书签。

•错误！

未定义书签。

错误！

未定义书签

错误!

未定义书签。

•••..错误!

未定义书签。

错误!

未定义书签。

1.范围错误！

未定义书签。

2.总体要求错误！

未定义书签。

总体功能要求软件开发平台要求软件项冃的开发实施过程管理要求

软件项冃实施过程总体要求••软件项冃实施变更要求……软件项冃实施里程碑控制••…

错误！

未定义书签。

软件的需求分析

需求分析

需求分析报告的编制者

错误！

未定义书签。

错误!

未定义书签。

・・・・・错误!

未定义书签。

需求报告评审

需求报告格式

软件的概要设计

概要设计••…

•错误［未定义书签•错误!

未定义书签错误！

未定义书签。

错误!

未定义书签。

编写概要设计的要求

错误!

未定义书签。

概要设计报告的编写者错误!

未定义书签。

错误!

未定义书签。

概要设计和需求分析、详细设计之间的矢系和区别

概要设计的评审错误!

未定义书签。

概要设计格式错误!

未定义书签。

软件的详细设计错误！

未定义书签。

详细设计

错误!

未定义书签。

详细设计的要求.

错误1未定义书签

数据库设计.

错误1未定义书签

详细设计的评审.

错误1未定义书签

详细设计格式.

错误1未定义书签

软件的编码

错误！

未定义书签。

软件编码.

错误1未定义书签

软件编码的要求.

错误1未定义书签

编码的评审.

错误!

未定义书签

编程规范及要求.

错误!

未定义书签

软件的测试

错误！

未定义书签。

软件测试.

错误!

未定义书签

测试计划.

错误!

未定义书签

软件的交付准备

错误！

未定义书签。

交付清单.

错误!

未定义书签

软件的鉴定验收

错误！

未定义书签。

软件的鉴定验收・

错误1未定义书签

验收人员.

错误!

未定义书签

验收具体内容.

错误!

未定义书签

软件验收测试大纲・

错误!

未定义书签

培训

错误！

未定义书签。

系统应用培训.

错误!

未定义书签

系统管理的培训（可选）

错误!

未定义书签

特例.

错误!

未定义书签

附录软件需求分析报告文档模板

附录软件概要设计报告文档模板

附录软件详细设计报告文档模板

附录D软件数据库设计报告文档模板

本指南用于指导软件开发者为南京市交通局开发软件项冃的过程，通过规范软件项冃承

担单位的开发过程达到提高软件质虽，降低维护成本的目的。

开发者应根据本指南进行软件

开发和编制软件开发文档»本指南是对软件项冃承担单位的基本要求。

在本指南的附录至E中提供了文档的编写模板供开发者参考，在进行具体软件开发时，开发者可根据实际情

况采编写，但必须提供双方约定的文档，文档中约定的內容必须描述漬楚。

2•总体要求

2.1总体功能要求

网络应用环境以Internet/1ntranet技术为核心。

开发者应在充分分析需求的基础上，选择采用B/S结构或者C/S结构°

软件系统的数据库应依照《南京市交通局信息化数据库建设规范》进行设计和建设。

本指南中没有规定开发者采用何种具体的软件工程开发方法，开发者可根据项冃具体特

点、自身擅长来选择采用面向过程的方法、面向对象的方法或面向数据的方法，但建议开发

商使用面向对象软件工程的方法，如：

采用目前被广泛使用的RUP（RationalUnified

Process）方法来进行分析、设计和开发°

2.2软件开发平台要求

开发者开发的软件必须能够在南京市交通局规定的软件平台上正常运行。

冃前软件平台

为：

数据库管理系统：

Oracle9i以上版本

中间件（应用服务器）系统:

IBMWebSphere

OA系统：

LotusDomino/Notes

网络架构：

完全支持TCP/IP协议

开发工具或技术体系：

为保证软件的上下兼容性，开发者应选择比较通用的开发工具的较新版本进行开

发>女口MicrosoftVisual，BorlandDelphi，C卄Bu订dcr»或J2EE（Java2PlatformEntcrpriscEdition）等。

2.3软件项目的开发实施过程管理要求

2.3.1软件项冃实施过程总体要求

（一）开发者提交软件开发工作大纲，交通局组织专家组对工作大纲逬行评审，并提出整改意见-

（二）通过评审后，开发者根据整改意见完善工作大纲，经过交通局认可后组织项冃组进行软件开发。

软件开发工作按照需求分析、概要设计、详细设计、编码、测试等几个阶段进行，在开发过程

中，开发者需分阶段提交相关文档。

（三）在软件开发工作完成后，开发者应向交通局提交完整的软件文档，交通局组织

验收组对软件进行验收审查°

2.3.2软件项冃实施变更要求

在开发过程中，需求或设计不可避免地需要发生变更，相关变更必须经过交通局书面同

意方可进行。

在需求或设计发生变更时，需要对原有文档进行修改，并提供完整的变更记录，以使变更処于可控制的状态°变更单如下表所示：

表2・1变更单

需求变更申请

申谴变更的需求文档

输入名称•版本•日期等信息

变更的内客及其理由

评估需求变更将对

项冃造成的影响

申谴人签字

变更申请的审批意见

项冃经理签字

审批意见：

签字日期

客户签字

（合同项冃）

审批意见：

签字日期

更改需求文档

变更后的

需求文档

输人名称，版本，完成日期等信息

更改人签字

重新评审需求文档

需求评审小组签字

评审意见：

签字日期

变更结束

项冃经理签字

签字日期

233软件项冃实施里程碑控制

交通局将分四个阶段进行把矢，召开专家审查会。

（一）需求分析（结合原型进行审查）确认；

（-）槪要设计磁据库设计；

（三）预验收（试运行后）；（四）正式验收（推广使用后）

3.软件开发

设计・详细设计・编码・测试・验收・鉴定等活动组成。

3.1软件的需求分析

报告。

在需求分析报告中必须描述的基本问题是：

功能・性能“强加于实现的设计限制♦属性♦外部接口。

结果，而不是获得这些结果的手段。

软件需求可以用若干种方法来表达•如通过输人、输出说明；使用代表性的例子；用规

范化的模型»开发者应尽可能地使用模型的方式，因为这是表达复杂需求的精确和有效的方

法°比如用统一建模语言（UML来描述需求。

编写需求分析报告的要求

a.无歧义性

对最终产品的每一个特性用某一术语描述；若某一术语在某一特殊的行文中使用时具有

多种含义，那么应对该术语的每种含义做出解释并指出其适用场合。

b.完整性

需求分析报告应该包括全部有意义的箱求•无论是矢系到功能的、性能的、设计约束的、

还是光系到外部接口方面的需求；对所有可能出现的输入数据的响应予以定义，要对合法和

非合法的输入值的响应做出规定；填写全部插图、表、图示标记等；定义全部术语和度虽单

位。

C.可验证性

需求分析报告描述的每一个需求应是可以验证的。

可以通过一个有限处理过程来检查软

件产品是否满足需求。

d.一致性

在需求分析报告中的各个需求的描述不能互相矛盾。

e.可修改性

需求分析报告应具有一个有条不紊、易于使用的内容组织；没有冗余，即同一需求不能

在需求分析报告中出现多次-

f•可追踪性

每一个需求的源流必须濱晰，在逬一步产生和改变文件编制时，可以方便地引证每一个

需求。

g.运行和维护阶段的可使用性

需求分析报告必须满足运行和维护阶段的需要。

在需求分析报告要写明功能的来源和冃

的。

3.1.2需求分析报告的编制者

需求分析报告应由交通局和开发者双方共同完成。

其中：

交通局负责根据实际需要提出

希望软件实现的功能；软件开发者根据交通局提出的性能需求，结合软件开发编写需求分析»

3.1.3需求报告评审

在软件需求分析工作完成后，软件开发者应向交通局提交《软件箱求分析报告》。

交通

局组织有矢人员对需求进行评审，以决定软件需求是否完善和恰当-评审完成后，就可以进入软件的设计阶段。

3.1.4需求报告格式

《软件需求分析报告》需按一定的格式逬行编写，具体的《软件需求分析报告》文档编

写模板请见附录A。

3.2软件的概要设计

3.2.1概要设计

在交通局和开发者双方认可的《需求分析报告》基础上，开发者逬行下一一步的工作。

首先，开发者需要对软件系统进行概要设计，即系统设计。

概要设计需要对软件系统的设计进行考虑，包括系统的基本处理流程・系统的组织结构“模块划分“功能分配“接口设计・运行设计・数据结构设计和出错处理设计等，为软件的详细设计提供基础。

322编写概要设计的要求

a._致性

概要设计的要求应该与需求分析报告所描述的希求一致。

同时，概要设计的各项要求之

间也应该一致。

b.合理性

概要设计所提出的设计方法和标准应该是合理的、恰当的。

c.可追踪性

对槪要设计所提出的各项要求应该可以得到它的清晰的源流，即在需求分析报告客户有

明确的需求描述-

d.可行性

根据槪要设计进行详细设计、操作和维护应该是可行的。

3.2.3概要设计报告的编写者

概要设计报告由开发者很据需求分析报告的要求逬行编写。

3.2.4概要设计和需求分析、详细设计之间的矢系和区别

需求分析不涉及具体的技术实现，而概要设计注重于从宏观上和框架上来描述采用何种技术手段、方法来实现这些需求。

详细设计相对概要设计更注重于微观上和框架內的设计，是编码的依据。

概要设计是指导详细设计的依据。

3.2.5概要设计的评审

在软件槪要设计工作完成后，软件开发者应向交通提交《软件系统概要设计报告》。

在

交通局对《槪要设计报告》评审通过后，即可逬入详细设计阶段。

3.2.6概要设计格式

《软件系统槪要设计报告》需按一定的格式进行编写，具体的《软件系统概要设计报告》文档编写模板请见附录B-

3.3软件的详细设计

3.3.1详细设计

在槪要设计的基础上，开发者需要进行软件系统的详细设计。

在详细设计中，描述实

现具体模块所涉及到的主要算法、数据结构、类的层次结构及调用关系‘需要说明软件系统各个层次中的每一个程序（每个模块或子程序）的设计考虑'以便进行编码和测试。

应当保证软件的需求完全分配给整个软件»详细设计应当足够详细•能够很据详细设计报告进行编码。

3.3.2特例

如果软件系统比较简单，层次较少，可以不必进行专门的详细设计，而和概要设计结合

起来。

3.3.3详细设计的要求

a.—致性

详细设计的要求应该与需求分析报告所描述的需求、与槪要设计一致。

同时，详细设计

的各项要求之问也应该是一致的-

b.合理性

详细设计所提出的设计方法和标准应该是合理的、恰当的。

c.可追踪性

对详细设计所提出的各项要求应该可以得到它的清晰的源流，即可在需求分析报告、概

要设计报告中有明确的需求描述-

d.可行性

根据详细设计进行编码、测试、操作和维护应该是可行的。

3.3.4数据库设计

如果软件产品需要使用到数据库，软件的详细设计应包括对数据库的设计。

数据库设计应在软件的需求分析、概要设计完成之后、详细设计的其它工作之前逬行。

在进行数据库设计时，应当按照交通局制定的《南京市交通局信息化数据库建设规范》要求逬行»

3.3.5详细设计的评审

在软件详细设计完成后，软件开发者应向交通局提交《软件系统数据库设计报告》和《软件系统详细设计报告》。

在交通局对《软件系统数据库设计报告》、《软件系统详细设计报告》评审通过后，即可进入软件编码阶段。

336详细设计格式

《软件系统详细设计报告》、《软件系统数据库设计报告》需按一定的格式逬行编写，具体的《软件系统详细设计报告》文档编写模板和《软件系统数据库设计报告》文档编写模

板请见附录C、附录D。

3.4软件的编码3.4.1软件编码

在软件编码阶段，开发者很据《软件系统详细设计报告》中对数据结构、算法分析和模

块实现等方面的设计要求，开始具体的编写程序工作，分别实现各模块的功能，从而实现对冃标系统的功能、性能、接□、界面等方面的要求。

3.4.2软件编码的要求

a.模块化编码

b.代码可读性

c.可维护性

d.模块接口标准化

e.界面风格统一

c.注释的应用

3.4.3编码的评审

为了尽早发现软件中的障碍，提高软件产品的质虽，开发者在编码的过程中应该强调代

码评审工作»将代码评审报告作为文档的一部分，提交给交通局。

3.4.4编程规范及要求

为了提高编程实现的质虽，软件的程序设计必须遵照国家颁布的相矢编程规范。

主要内容包括：

规范化的程序内部文档、数据结构的详细说明、清晰的语句结构、编码

规范-编码规范的內容包括命名规范、界面规范、提示及帮助信息规范、热键定义等。

其中数据库部分应遵守《南京市交通局信息化数据库建设规范》的要求。

在软件编码的同时应逬行单元测试。

3.5软件的测试

3.5.1软件测试

为了尽早发现软件产品中的错误，从而达到提高软件质虽、降低软件维护的费用，开发

者应在编码过程中对各个模块的程序代码逬行单元测试・系统集成时进行集成测试，系统集成完成后对整个软件进行系统测试。

单元测试是在软件开发过程中针对程序模块进行正确性检验。

集成测试

模块组装过程和模块接口进行正确性检验。

软件系统测试不仅是检测软件的整体行为表现，从另一个侧面看，也是对软件开发设计的再确认。

进行软件系统测试工作时。

测试主要

包括界面测试、可用性测试、功能测试、稳定性（强度）测试、性能测试、强壮性（恢复）测试、逻辑性测试、破坏性测试、安全性测试等°

开发者针对单元测试，集成测试，系统测试分别制定《测试计划》。

集成测试需要根据

需求分析报告和槪要设计制作测试用例，并须经过评审»软件测试按照《测试计划》、《需求

分析报告》的要求进行，最后形成《软件测试报告》。

3.5.2测试计划

在软件编码开始之前，开发者应向交通局提交《测试计划》，在软件交付时，开发者应

向交通局提交《软件测试报告》，以确保开发者的软件得到了充分的测试。

开发的软件必须经过充分的测试证明其符合设计要求、运行稳定、安全可用方可交付交通局。

3.6软件的交付准备

3.6.1交付清单

在软件测试证明软件达到要求后，软件开发者应向交通局提交开发的冃标安装程序、数

据库的数据字典、《用户安装手冊》、《用户使用指南》、需求报告、设计报告、测试报告等双方合同约定的产物。

《用户安装手冊》应详细介绍安装软件对运行环境的要求、安装软件的定义和内容、在

客户端、服务器端及中问件的具体安装步骤、安装后的系统配宜。

《用户使用指南》应包括软件各项功能的使用流程、操作步骤、相应业务介绍、特殊提示和注意事项等方面的内容，在需要时还应举例说明。

3.7软件的鉴定验收

3.7.1软件的鉴定验收

在软件开发完成后，为了确保软件是按照需求分析的要求逬行开发的，保证软件产品的质虽'需要对软件产品进行鉴定验收°在开发者如期交付软件后，由交通局负责确定具体的鉴定验收日期°

3.7.2验收人员

由交通局聘请具有一定的分析、设计、编程和软件测试经验的验收组长和其他专业人员组成-验收组设组长一名（可设有副组长），负责整个验收的计划、组织工作。

3.7.3验收具体内容

验收内容应该包括：

合法性检查、文档检查、软件一致性检查、软件系统测试与测试结果评审等几项工作。

合法性检查检查软件开发工具是否合法、使用的函数库、控件、组件是否有合法的发布

许可。

文档检查检查开发者提交的文档必须齐全，质虽是否过矢。

需要开发者提供的文档包括：

项目实施计划；

详细技术方案；

软件需求规格说明书（SIP）（含数据字典）；

概要设计说明书（PDD）；

详细设计说明书（DDD）（含数据库设计说明书）；

软件测试计划（SIP）（含测试用例）；

软件测试报告（SIR）；

用户手冊（SUM）（含操作、使用、维护、应急処理手冊）；

源程序（SCL）（不可修改的电子文档）；

项目实施计划（PIP）；

项目开发总结（PDS）；

软件质虽保证计划（SQAP）；

此外，验收组可以根据需要对其它文档（如软件配直计划、项冃进展报表、阶段评审报

表等）进行检查»

文档的质量很据完备性、正确性、简明性、可追踪性、自说明性、规范件等方面逬行踪

合评定。

验收需要对软件代码进行检查，以确保其符合规范，并检查其一致性。

3.7.4软件验收测试大纲

在软件进行鉴定验收前，开发者需按照一定的格式编写《软件验收测试大纲》格式请见附录E

3.8培训

3.系统应用培训

主要培训内容包括：

系统操作使用、业务管理流程°

培训对象：

应用操作人员»

3.8.2系统管理的培训（可选）

主要培训内容包括：

系统安装、调试、维护；系统管理。

培训对象：

系统管理人员-

开发者应详细列出培训计划，包括•培训内容、教材、时间和人貝等°

错误！

未定义书签错误！

未定义书签

附录A软件需求分析报告文档模板

1•引言

编写目的

项目风险

文档约定

预期读者和阅读建议

产品范围

错误！

未定义书签

参考文献

错误！

未定义书签

错误！

未定义书

签

错误！

未定义书签错误！

未定义书签

错误！

未定义书签错误！

未定义书签

错误！

未定义书签错误！

未定义书签

错误！

未定义书签错误！

未定义书签

2.综合描述

产品的状况

产品的功能

用户类和特性

运行环境

设计和实现上的限制

假设和约束（依赖）

3.外部接口需求

用户界面

硬件接口

软件接口

通讯接口

4.系统功能需求

说明和优先级

激励/响应序列

输入/输出纯

5.其它非功能需求

性能需求

安全措施需求

安全性需求

软件质虽属性

业务规则

用户文档

6.词汇表

错误！

未定义书签

8.分析模型错误！

未定义书

签

9.待定问题列表

错误！

未定义书签

是为了帮助阅读者了解这份文档是如何编

引言是对这份软件产品需求分析报告的概览，写的>并且应该如何阅读・理解和解释这份文档。

编写目的

说明这份软件产品需求分析报告是为哪个软件产品编写的>开发这个软件产品意义・作

用、以及最终要达到的意图。

通过这份软件产品需求分析报告详尽说明了该软件产品的需求规格，包搖修正和（或）发行版本号，从而对该软件产品进行准确的定义-

如果这份软件产品需求分析报告只与整个系统的某一部分有矢系，那么只定义软件产品

需求分析报告中说明的那个部分或子系统。

1・2项目风险

具体说明本软件开发项冃的全部风险承担者，以及各自在本阶段所苗要承担的主要风险，首要风险承担者包括：

•任务提出者；

•软件开发者；

•产品使用者。

「3文档约定

描述编写文档时所采用的标准（如果有标准的话），或者各种排版约定。

排版约定应该包括：

•正文风格；

•提示方式；

•重要符号；

也应该说明高层吹需求是否可以被其所有细化的需求所继承•或者每个需求陈述是否都有其自己

1.4预期读者和阅读建议

列举本软件产品需求分析报告所针对的各种不同的预期读者，例如，可能包括：

•用户；

・开发人员；

•项目经理；

・营销人员；

・测试人员；

・文档编写入员-

并且描述了文档中，其余部分的内容及其组织结构，并且针对毎一类读者提出最适合的

文档阅读建议-

1.5产品范围

说明该软件产品及其开发目的的简短描述，包括利益和目标。

把软件产品开发与企业冃

标，或者业务策略相联系-

描述产品范围时需注意，可以参考项目视图和范围文档，但是不能将其内容复制到这里。

1・6参考文献

列举编写软件产品需求分析报告时所用到的参考文献及资料，可能包括：

・本项冃的合同书；

・上级机矢有矢本项冃的批文；

・本项冃已经批准的计划任务书；

•用户界面风格指导；

•开发本项冃时所要用到的标淮；

・系统规格需求说明；

・使用实例文档；

•属于本项冃的其它己发表文件；

•本软件产品需求分析报告中所引用的文件・资料；

•相矢软件产品需求分析报告；

为了方便读者查阅，所有参考资料应该按疋顺序排列。

如果可冃匕■

出.

-标题名称；

•作者或者合冋签约者：

•文件编号或者版本号；

•发表日期或者签约日期；

•出版单位或者资料来源。

2.综合描述

这一部分槪述了正在定义的软件产品的作用范圉以及该软件产品所运行的环境、

软件产品的用户、对该软件产品己知的限制、有关该软件产品的假设和依赖■>

2.1产品的状况

描述了在软件产品需求分析报告中所定义的软件产品的背景和起源。

是否属于下列情况：

・是否是产品系列中的下一成员；

•是否是成熟产品所改进的下一代产品；

•是否是现有应用软件的替代品（升级产品）；

・是否是一个新型的、自主型的产品。

如果该软件产品需求分析报告定义的软件系统是：

・大系统的一个组成部分；

・与其它系统和其它机构之问存在基本的相互矢系-

母份资料都应该给

使用该

说明了该软件产品

那么必须说明软件产品需求分析报告定义的这部分软件是怎样与整个大系统相笑联的•或者（同时）说明相互矢系的存在形式，并且要定义出两者之问的全部接口。

2.2产品的功能

因为将在需求分析报告的第4部分中详细描述软件产品的功能，所以在此只需要概略地总结。

仅从业务层面陈述本软件产品所应具有的主要功能，在描述功能时应该针对每一项需

求准确地描述其各项规格说明»如果存在引起误解的可能，在陈述本软件产品主要功能的作用领域时，也需要对应陈述本软件产品的非作用领域，以利读者理解本软件产品。

为了很好地组织产品功能，使每个读者都容易理解，可以采用列表的方法给出。

也可以采用图形方式，将主要的需求分组以及它们之问的联系使用数据流程图的顶层图或类图逬行表示，这种表示方法是很有用的»

参考用户当前管理组织构架，了解各个机构的主要职能，将有助于陈述软件产品的主要功能»

2.3用户类和特性

确定有可能使用该软件产品的不同用户类，并且描述它们相矢的特征。

往往有一些软件

需求，只与特定的用户类有关°描述时，应该将该软件产品的重要用户类与非重要用户类区分开°

用户不一定是软件产品的直接使用者，通过报表、应用程序接口、系统硬件接□得到软件产品的数据和服务的人、或者机构也有他们的需求°所以，应该将这些外部需求视为通过报表、应用程序接口、系统硬件接口附加给软件产品的附加用户类。

2.4运行环境

描述了本软件的运行环境，一般包括：

・硬件平台；

•操作系统和版本；

・支撑环境（例如：

数据库等）和版本；

•其它与该软件有关的软件组件；

・与该软件共存的应用程序。

2.5设计和实现上的限制

确定影响开发人员自由选择的问題，并且说明这些问題为什么成为一种限制-可能的限

制包括下列内容：

・必须使用的特定技术、工具、

展开阅读全文