金融知识系列介绍

binss

软件开发规范的主要内容
软件开发规范主要包括如下内容：
11．2．2．1 阶段划分
按照软件生存周期方法学，软件开发过程通常被划分为八个阶段：
（1）        可行性研究与计划；
（2）        需求分析；
（3）        概要设计；
（4）        详细设计；
（5）        实现；
（6）        组装测试；
（7）        确认测试；
（8）        使用和维护。

binss

软件开发各阶段的任务及要求
（1）        可行性研究与计划
要求：充分了解用户的要求及现实环境，从技术、环境以及经济和社会因素等方面研究并论证本软件项目的可行性，准确、具体地确定工程规模和系统目标，对建议的系统进行仔细的成本/效益分析，写出可行性研究报告，制定初步项目开发计划。本阶段应交付的文档有：
a 可行性分析报告；
b 初步项目开发计划。
（2）        需求分析
要求：确定被开发软件的运行环境，功能和性能要求。编写用户手册概要，软件质量保证计划，软件配置管理计划，软件确认测试准则。详细说明被开发系统与其他硬件、软件及人员的接口情况，为概要设计提供用户确认的需求说明书。本阶段应交付的文档有：
a 软件需求说明书；
b 修改后的项目开发计划；
c 用户手册概要；
d 确认测试计划；
e 数据要求说明书；
f 软件质量保证计划；
g 软件项目配置管理计划。

binss

（3） 概要设计
要求：根据软件需求说明，建立目标系统的总体结构（对不同规模的系统总体结构可参照GB8566—88《计算机软件开发规范》中的有关条目建立）和模块间的关系，定义各功能模块的接口和控制接口。设计全局数据库/数据结构，规定设计限制，制定组装测试计划。本阶段应交付的文档有：
a 概要设计说明书；
b 数据库/数据结构设计说明书；
c 模块测试计划。
（4）        细设计
要求：对概要设计中产生的功能模块进行过程描述，设计功能模块的内部细节，包括算法和数据结构。详细规定各程序模块间的接口，包括参数的形式和传递方式，上下层调用关系等。为编写源代码提供必要的说明，画出程序流程图（流程图中使用的图形符号应符合GB1526—79 《信息处理流程图图形符号》），建立“模块开发卷宗”。本阶段应交付的文档有：
a 详细设计说明书；
b 模块开发卷宗。

binss

（5）        实现
要求：按照详细设计说明，对每个程序模块用所选定的程序设计语言（应尽可能采用已有国家标准或国际标准的程序设计语言或数据库语言编写程序；对编写好的源程序进行单元测试，验证，程序模块接口与详细设计说明的一致性。程序模块的测试用例、预期结果及测试结果应存档保留。本阶段应交付的文档有：
a 模块开发卷宗；
b 组装测试计划。
（6）        组装测试
    要求：根据概要设计中各功能模块的说明入制定的组装测试计划，将经过单元测试的模块逐步进行组装和测试，分析测试结果，找出产生错误的原因。本阶段应交付的文档有：
a 可运行的源程序清单；
b 组装测试分析报告；
c 确认测试计划。
（7）确认测试
要求：根据软件需求说明书中定义的全部功能、性能要求及确认测试计划，首先在最终用户的环境中进行强度测试，以检查该软件有无严重错误；然后执行测试计划中提交的所有确认测试，验证整个软件系统是否达到了要求。修改并提交最终的用户手册和操作手册。预期结果、测试结果和测试数据应全部存档保留。编写项目开发总结报告。本阶段应交付的文档有：
a 确认测试分析报告；
b 最终的用户手册和操作手册
c项目开发总结报告。
（8）使用和维护
要求：对投入运行后的软件进行修改是软件维护阶段的任务。这个阶段周期长，工作量大，成本高，因此必须在严格的管理控制下进行，维护组织与维护要求及应交付的文档，依照本章11。4节执行。

binss

软件文档编制
11．3．1 软件文档编制
11．3．1．1 编制软件文档的作用
为了保证计算机软件项目开发的成功，节省项目投资，提高项目开发质量，便于运行和维护，在软件开发工作的每一阶段，都需要编制一定的文档。这些文档是计算机软件不可缺少的组成部分。它和计算机程序及数据一起构成计算机软件。
软件文档的作用是：
（1）        作为开发人员在一定阶段内工作成果的反映和工作结束的标志；
（2）        把软件开发过程中一些“不可见”的事物转变为“可见”的文字资料。便于检查开发工作的进展情况，判断原定目标是否已经达到；
（3）        记录开发过程中的技术信息，便于协调软件的开发、使用，以及软件的维护、个性或进一步开发；
（4）        提供有关该软件运行、维护和培训方面的技术信息，向潜在用户报导软件的功能和性能，便于管理人员，开发人员、操作人员、用户之间的沟通和了解。

binss

编制软件文档应考虑的因素
文档编制，需要付出艰巨的劳动。为保证文档编制质量，使之能适应不同使用对象的要求，而又使所花费的劳动与不同项目对文件的需求相适应，应根据下列因素确定文档的编制要求。
（1）        每一种文档都有其特定的使用者。这些使用者包括软件开发单位（一个或几个）的技术人员、管理人员和领导干部；使用和维护这些软件的用户；社会上的公众等。这些不同的人员对文档的内容，详尽程度以及侧重点有不同的要求。因此，文档的编写者必须了解文档使用者的特点、水平和需要，以及该文档提供的广泛程度等，有针对性地编写成各种文档。
（2）        编制的各种文档的某些内容上不可避免会有重复，这是为了使文档的使用者能比较方便地了解某些共性的内容，而不必频繁地去参阅另外一些文档或章节，这样的重复是必要的，但在行文的详尽程度上可根据该文档的使用对象不同而有所侧重。
（3）        根据软件的规模和复杂程度的不同，在确定文档的种类、详尽程度、种类与章节的扩展压缩、程序设计和文档的表现形式等方面时可灵活掌握，使其更符合实际需要。这包括：
A  应编制的文档种类
本规范建议应编制的软件文档有16种。但针对一项具体的软件开发项目，以把某几种文档合并成一种，以减少文档的种类。
    当本规范所编制的文档种类尚不能满足某些单位或部门的特殊需要时，还可根据需要再规定若干种增补编制的文档。
应编制的文档种类和详尽程度取决于承担开发单位的管理能力、软件的专业特点、开发项目的规模、复杂性和成败风险等因素。因此，软件开发单位应制定一个文档编制实施规定，说明在什么情况下应编制哪些文档（包括本单位规定应增补的文档）。
对每个具体的软件项目，应确定一个文档编制计划，规定应编制的文档种类；详尽程度；编制、审查、批准人员和进度要求；以及开发期间各文档的维护、修改、管理人员和批准手续，文档编制计划是整个开发计划的重要组成部分。
B  文档的详尽程度
文档编制的详尽程度取决于任务的规模、复杂性以及该文档的使用者对文档内容的需求。
C 文档种类以及章节的扩张和缩并
当一种文档的内容非常多或有必要分卷时，则可将其分卷编写。各种文档编写时，一般应符合本规范所规定的章节及其大致相同。但各章节的内容可根据实际情况扩展（细分）或缩并。在这种情况下，章节的编号应相应改变。
D 程序设计和文档的表达形式
本规范对程序设计的表现形式以及文档的表现形式不作具体的规定或限制。设计开发人员和文档的编制者可根据实际情况，以最方便和最有利于表达并为文档使用者接受的形式来设计和编写。
为了便于管理和统一，各单位可参照有关标准对文件的编写格式等作出具体规定。

binss

软件开发过程文档明细表
本规范建议规范软件开发过程中一般应编制以下16种文档：
（1）        可行性研究报告
（2）        项目开发计划
（3）        质量保证计划
（4）        配置管理计划
（5）        软件需求说明书
（6）        数据要求说明书
（7）        概要设计说明书
（8）        详细设计说明书
（9）        数据库设计说明书
（10）        用户手册
（11）        操作手册
（12）        模块开发卷宗
（13）        测试计划
（14）        测试分析报告
（15）        开发进展月报
（16）        项目开发总结报告
对于一项具体的软件开发项目，可以把上述某几种文档合并成一种，以减少文档的种类。
除了本规范建议的16种文档外，开发单位还可以根据实际需要规定增补编制的文档种类。
对于一项软件开发项目而言，其生存周期各阶段与各种文档编写工作的关系如表11-3-1所示，其中有些文档的编写工作可能要在若干个阶段中延续进行。

binss

表11-3-1 软件生存周期各阶段中的文档编制

阶段
文件        可行性研究与计划阶段        需求分析阶段        概要设计
详细设计       
实现阶段        组测试
确认测试        运行与维护阶段
可行性研究报告
                                       
项目开发计划
                                       
软件需求说明书               
                       
数据要求说明书               
                       
软件质量保证计划                                               
软件配置管理计划
                                       
测试计划               
                       
概要设计说明书                       
               
详细设计说明书                               
       
数据库设计说明书                
                       
模块开发卷宗                               
       
用户手册               
                       
操作手册               
                       
测试分析报告                                       

开发进度月报
                                       
项目开发总结                                       


对于不同规模的软件而言，文档编制的种类及详细程度也有所不同。因此，应根据软件的规模、重要性、复杂性等因素，制定出实施规定。软件规模一般分为四级：
（1）        小规模软件：源程序行数小于5000的软件；
（2）        中规模软件：源程序行数为10000 ~ 50000的软件；
（3）        大规模软件：源程序行数为100000 ~ 500000的软件；
（4）        特大规模软件：源程序行数大于500000的软件。
软件文档的编制可参照表11-3-2制定实施规定。

binss

表11-3-2 软件文档编制表

小规模软件             中规模软件           大规模软件             特大规模软件
            
可行性研究报告          对应于大规模软件               项目开发计划                             所规定的文件可进
                        一步细分项目开发
软件需求与开发计划                     软件需求说明            计划
软件需求说明     数据要求说明

测试计划——     测试计划

                 概要设计说明
软件设计说明——   软件设计说明    详细设计说明
                                   数据库设计说明

使用说明——       使用说明        用户手册
                                   操作手册

测试分析说明       模块开发卷宗——模块开发卷宗
                   测试分析报告——测试分析报告

项目开发总结       开发进度月报——开发进度月报
                   项目开发总结——项目开发总结

binss

软件文档内容提要
（1）        可行性研究报告
可行性研究报告用于说明软件系统的实现在技术上、经济上和社会条件等方面的可行性；详述为了合理地达到开发目标可选择的各种方案；说明并论证所选定的方案。主要内容应包括：引言；开发管理概要；对现有系统的分析；所建议的系统可选择的其他方案；投资及效益分析；社会条件方面的可行性结论。详细编写格式参照GB8567—88《计算机软件产品开发文件编制指南》。
(2)    项目开发计划
    项目开发计划用于确定开发过程中各项工作的负责人员、开发进度、经费预算、所用的软硬件条件等方面的管理性安排，以便根据本计划开展和检查项目的开发工作。主要内容应包括：引言；项目概述；实施总计划；支持条件；专题计划要点等。编写格式参见GB8567—88。
（3） 软件质量保证计划
软件质量保证计划的编写参见本章11。3。2软件质量保证计划。
（4）软件配置管理计划
软件配置管理计划的编写参见本章11。3。3软件配置管理计划。
（5）软件需求说明书
软件需求说明书是为了确定一个反映用户与开发者双方共同理解的该软件系统的具体开发目标，使之作为整个开发工作的基础。主要内容应包括：引言；任务概述；需求规定；运行环境规定。编写格式参见GB8567—88和GB9385—88《计算机软件需求说明书编制指南》。