范围

本指南用于指导软件开发者为贵阳节水办开发软件项目的过程，通过规范软件项目承担单位的开发过程达到提高软件质量，降低维护成本的目的。开发者应根据本指南进行软件开发和编制软件开发文档。本指南是对软件项目承担单位的基本要求。在进行具体软件开发时，开发者可根据实际情况编写，但必须提供双方约定的文档，文档中约定的内容必须描述清楚。

1. 总体要求

1.1 总体功能要求

开发者应在充分分析需求的基础上，采用C/S结构。

本指南中规定开发者采用SQL Server进行开发。

1.2 软件开发平台要求

开发者开发的软件必须能够在节水办软硬件基础上正常运行。

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

1.3.1 软件项目实施过程总体要求

（一）开发者提交软件开发工作大纲，节水办组织专家组对工作大纲进行评审，并提出整改意见。

（二）通过评审后，开发者根据整改意见完善工作大纲，经过节水办认可后组织项目组进行软件开发。软件开发工作按照需求分析、概要设计、详细设计、编码、测试等几个阶段进行，在开发过程中，开发者需分阶段提交相关文档。

（三）在软件开发工作完成后，开发者应向节水办提交完整的软件文档，节水办组织验收组对软件进行验收审查。

2. 软件开发

合同签订以后，项目承担单位即可组织项目组进行软件开发工作。软件开发必须严格按照软件工程的要求进行。开发过程包括开发者的活动和任务。此过程由软件需求分析、概要设计、详细设计、编码、测试、验收、鉴定等活动组成。

2.1 软件的需求分析

2.1.1 需求分析

首先，开发者和节水办应共同对节水办的应用需求作充分的调研，提交完整的需求分析报告。在需求分析报告中必须描述的基本问题是：功能、性能、强加于实现的设计限制、属性、外部接口等。应当避免把设计或项目需求写入需求分析报告中。它必须说明由软件获得的结果，而不是获得这些结果的手段。

软件需求可以用若干种方法来表达，如通过输入、输出说明；使用代表性的例子；用规范化的模型。开发者应尽可能地使用模型的方式，因为这是表达复杂需求的精确和有效的方法。

编写需求分析报告的要求

a．无歧义性

对最终产品的每一个特性用某一术语描述；若某一术语在某一特殊的行文中使用时具有多种含义，那么应对该术语的每种含义做出解释并指出其适用场合。

b．完整性

需求分析报告应该包括全部有意义的需求，无论是关系到功能的、性能的、设计约束的、还是关系到接口方面的需求；对所有可能出现的输入数据的响应予以定义，要对合法和非合法的输入值的响应做出规定；填写全部插图、表、图示标记等；定义全部术语和度量单位。

c．可验证性

需求分析报告描述的每一个需求应是可以验证的。可以通过一个有限处理过程来检查软件产品是否满足需求。

d．一致性

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

e．可修改性

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

f．运行和维护阶段的可使用性

需求分析报告必须满足运行和维护阶段的需要。在需求分析报告要写明功能的来源和目的。

2.1.2 需求分析报告的编制者

需求分析报告应由节水办和开发者双方共同完成。其中：节水办负责根据实际需要提出希望软件实现的功能；软件开发者根据节水办提出的性能需求，结合软件开发编写需求分析。

2.1.3 需求报告评审

在软件需求分析工作完成后，软件开发者应向节水办提交《软件需求分析报告》。节水办组织有关人员对需求进行评审，以决定软件需求是否完善和恰当。评审完成后，就可以进入软件的设计阶段。

2.2 软件的概要设计

2.2.1 概要设计

在节水办和开发者双方认可的《需求分析报告》基础上，开发者进行下—步的工作。首先，开发者需要对软件系统进行概要设计，即系统设计。概要设计需要对软件系统的设计进行考虑，包括系统的基本处理流程、系统的组织结构、模块划分、功能分配、接口设计、运行设计、数据结构设计和出错处理设计等，为软件的详细设计提供基础。