ICS75.020
备案号：3083-1999
中华人民共和国石油天然气行业标准SY/T5232—1999Www.vV99.net
石油工业应用软件工程规范
Specification of application software engineeringforpetroleumindustry
1999-05-17发布
国家石油和化学工业局
1999-12-01实施
SY/T5232—1999
引用标准
应用软件工程细则
软件文档编制
质量保证
配置管理
开发费用评估与管理
附录A（标准的附录）
附录B（标准的附录）
附录C（标准的附录）
附录D（标准的附录）
附录E（标准的附录）
附录F（标准的附录）
附录G（标准的附录）
附录H（标准的附录）
附录」（标准的附录）
附录K（标准的附录）
项目开发计划的编写
软件需求说明书的编写
概要设计说明书的编写
详细设计说明书的编写
用户手册的编写
测试计划的编写
测试报告的编写
验收报告格式
软件问题报告格式
软件修改报告格式
SY/T5232-1999
本标准是对SY/T5232.1~5232.17—91的修订。本标准主要修订内容如下：
1.根据GB/T1.1一1993的规定，增加了“前言”。2.将SY/T5232.1~5232.17一91中的11个标准合并成为个标准。这11个标准是：SY/T5232.1—91
SY/T5232.2-91
SY/T5232.3—91
SY/T5232.4—91
SY/T5232.5—91
SY/T5232.6—91
SY/T5232.7—91
SY/T5232.8—91
SY/T5232.1091
SY/T5232.11—91
SY/T5232.14—91
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
石油工业应用软件工程规范
开发规程
项目开发计划编写规定
需求说明书编写规定
概要设计说明书编写规定
详细设计说明书综写规定
用户手册编写规定
测试计划编写规定
测试报告编写规定
验收规程
维护规程
开发费用评估与管理规程
3，原标准中的如下标准被删除，其中三个采用相应的国家标准，另外三个标准由于不适应当前形势发展而废止，具体情况如下：被删除的标准名称
SY/T5232.9—91
《石油工业应用软件工程规
项目开发结束报告编写规定）
SY/T5232.12—91
《石油工业应用软件工程
规范软件配置管理计划编写规定》SY/T5232.1691
《石油工业应用软件工程
规范质量保证计划编写规定》
SY/T5232.13—91
规范项目管理规程》
SY/T 5232.1591
规范质量度量准则》
SY/T5232.17-91
《石油工业应用软件工程
《石油工业应用软件工程
《石油工业应用软件工程
编程一般标准和指南》
相应的国家标准或废止原因
GB/T8567-1988
《计算机软件产品开发
文件编制指南》的附录N项目开发总结报告的编写提示
GB/T12505—1990
理计划规范》
GB/T12504—1990
证计划规范》
《计算机软件配置管
《计算机软件质量保
废止，不适应当前形势发展
废止，不适应当前形势发展
废止，不适应当前形势发展
4．本标准增加了面向对象分析设计内容和可具体操作内容，使标准更具有实用性。本标准的附录A、附录B、附录C、附录D、附录E、附录F、附录G、附录H、附录J和附录K都是标准的附录。
本标准由中国石油天然气集团公司提出。本标准由石油信息与计算机应用专业标准化委员会归口。本标准起草单位：石油地球物理勘探局研究院。本标准主要起草人葛贵亭孙福来黄幽丽李新宅
赵振文
本标准于1991年7月19日首次发布，1999年5月第一次修订。V
1范围
中华人民共和国石油天然气行业标准石油工业应用软件工程规范
SY/T5232—1999l)
Specificationofapplicationsoftwareengineeringforpetroleumindustry本标准规定了石油工业应用软件工程的统一要求。本标准适用于石油工业应用软件工程的全过程。2引用标准
下列标准所包含的条文，通过在本标准中引用而构成为本标准的条文。本标准出版时，所示版本均为有效。所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。GB8566一1995信息技术软件生存期过程GB/T11457--1995软件工程术语
GB/T12504--1990计算机软件质量保证计划规范GB/T12505一1990计算机软件配置管理计划规范3定义
本标准采用下列定义。
3.1应用软件工程applicationsoftwareengineering软件工程的一般原理与实际软件开发项目结合，并根据实际情况对其中的规定和条款加以发展和具体化的过程。
应用软件工程细则
遵照GB8566一1995规定的软件生存期过程定义，规定石油工业应用软件开发需实施的过程控制。
本标准中使用的软件工程术语，未特别定义的均采用GB/T11457中的定义。石油工业应用软件工程可细划分为如下五大阶段：项目确定阶段。
软件开发阶段。
-软件测试阶段。
-软件验收阶段。
软件维护阶段。
4.1项目确定阶段
1)代替SY5223.15232.8—91、SY5232.10—91、SY5232.11—91、SY5232.14—91。国家石油和化学工业局1999－05-17批准1999-12-01实施
SY/T5232—1999
以用户需求、市场需求和任务需求作为项目确定的依据。4.1.2论证
从技术、经济等方面对开发项目进行可行性论证。论证技术可行性及开发项目应具备的条件，如硬件资源、软件资源、时间、人力、财力等因素：论证经济可行性，包括成本、效益分析等内容，以确认项目的可行性。
编写可行性研究报告。
制定初步项目开发计划，见附录A（标准的附录）。4.2软件开发阶段
4.2.1需求分析
4.2.1.1需求分析任务
根据用户对项目的需求，由软件开发单位与用户一起进行需求分析，确定开发软件的功能、性能和运行环境要求，取得用户认可，作为软件开发的依据。编写软件需求说明书、初步用户手册、初步确认测试计划，修改初步项目开发计划。4.2.1.2需求分析实施
a）运行环境分析：措述软件运行的硬件、软件、接口和控制等要求。b）软件功能分析：用文字、图表和数学公式等手段详细地描述软件每个功能的特性，包括输人、处理和输出，以及有关特殊要求。c）软件性能分析：描述软件性能要求，包括精度、时间、灵活性、容错能力及安全保密等要求。d）数据需求分析：措述软件对数据管理能力的要求。e）应交付的文档：需求说明书【编写规格见附录B（标准的附录)]、初步用户手册、初步确认测试计划。
4.2.2概要设计
4.2.2.1概要设计任务
根据软件需求说明书进行概要设计，建立目标系统的总体结构、模块功能划分、接口定义、数据结构设计，完善确认测试计划，编写概要设计说明书和集成测试计划。4.2.2.2概要设计实施
a）总体结构设计：以图表形式给出总体结构的层次图。b）系统功能划分：定义目标系统的功能模块。系统的功能划分应满足全部软件需求。c）控制流和数据流设计：确定软件在各种不同运行方式下的控制流和数据流，并确定模块的输人、输出和处理功能。
d）接口设计：包括用户接口、外部接口（与其它系统）和内部接口（模块之间）。e）应交付的文档：概要设计说明书【编写规格见附录C（标准的附录]、集成测试计划【编写规格见附录F（标准的附录)]、确认测试计划【编写规格见附录F（标准的附录)]。4.2.3详细设计
4.2.3.1详细设计任务
在详细设计阶段，对功能模块进行过程描述，设计模块内部细节（包括算法及数据结构），写出详细设计说明书。
4.2.3.2详细设计实施
a）结构设计：将概要设计产生的功能模块细化，形成若干可编程的程序单元，并用某种详细设计表示方法对其进行过程描述。b）接口设计：确定各模块间的详细接口信息。c）约定设计：规定符号使用，确定命名规则、注释规则。d）数据结构设计：数据结构设计要与过程或算法设计一样重视，注意减少模块间的耦合度。2—
SY/T52321999
e）限制设计：应考虑所使用的软件、硬件平台的限制，以及这些限制所能影响到的软件性能的属性。
f）应交付的文档：详细设计说明书【编写规格见附录D（标准的附录)]。4.2.4编程实现
4.2.4.1编程实现任务
以详细设计说明书为依据，用选定的程序设计语言进行编程，并编写单元测试计划。4.2.4.2编程约定
在编程实现过程中，应遵从如下原则：a）应少用转移语句，如必须使用时，应在同一程序单位内转移，且一般向转移语句所在点正向转移。
b）每个程序单元的语句行数要适当，以便于阅读。c）整个程序中命名应保持一致。d）在每个程序单元首部之前应有一段注释说明，描述其处理功能、输人和输出，以及要调用的其它程序清单。在源程序中注释行数不应少于源程序总行数的1/5。4.2.5单元测试
4.2.5.1单元测试任务
对编写好的源程序进行单元测试，验证单元程序功能、程序接口与设计说明的一致性。4.2.5.2单元测试实施
按照测试方案中规定的方法进行程序单元测试。在测试时，要保证每条可执行语句至少执行一次，并满足功能需求。测试用例既要考虑合法的输入，也要考虑非法的输人；既要测试正常路径，也要测试出错处理路径。做好测试记录。提交单元测试报告，编写规格见附录G（标准的附录）。4.3软件测试阶段
对所开发的软件完成单元测试后，要进行集成测试和确认测试。严格按照测试计划进行测试，测试完成要提供相应的测试报告。4.3.1集成测试
4.3.1.1集成测试任务
根据概要设计说明和集成测试计划，将经过单元测试的模块逐步进行集成和测试，并编写集成测试报告。
4.3.1.2集成测试实施
a）按照集成测试计划进行集成测试。b）要做到各模块无错误的连接，人机界面完全正确，满足各种功能和性能要求。c）加强对容错能力测试。
d）分析测试结果，找出产生错误原因，并将其反馈到开发部门，予以解决。e）应交付的文档：集成测试报告【编写格式见附录G（标准的附录）。4.3.2确认测试
4.3.2.1确认测试任务
在软件产品交付和验收之前，软件开发单位应在模拟合同规定的环境下对整个产品的运行进行确认。根据软件需求说明书中定义的全部功能和性能要求及确认测试计划，对整个软件系统进行测试，编写测试报告，提交最终用户手册。4.3.2.2确认测试实施
a）建立独立的测试组织，邀请用户一起参加确认测试。b）执行测试计划中规定的所有确认测试内容。-3—
SY/T5232—1999
c）按用户手册提供的功能逐项测试，进一步证实软件系统的实用性和有效性。d）记录测试间题，分析测试结果，找出产生错误的原因，改正测试中发现的程序错误和文档错误，重新测试。
e）应交付的文档：最终用户手册【编写格式见附录E（标准的附录）、确认测试报告【编写格式见附录G（标准的附录）。
4.4软件验收阶段
4.4.1验收阶段任务
根据软件规模和其重要程度，组织不同形式和不同规模的软件验收。软件验收包括如下内容：a）文档验收。
b）演示。
c）源程序验收。
d)验收测试。
e）评审。
f)验收报告。
4.4.2软件验收准备
a）根据软件的规模和其重要程度，成立验收委员会或验收组，设主席或组长一人。b）验收前准备好所开发软件的有关资料以及验收活动日程安排草案。c）验收工作的全过程由记录员详细记录。4.4.3验收内容
4.4.3.1软件文档验收
a）应交付的文档：软件开发单位应按照软件项目开发计划或合同的规定交付文档。b）文档验收要求：所交付的文档应根据质量保证计划中的要求进行评审，并需附有评审组的评审意见书。
4.4.3.2演示
软件开发单位应向验收组织演示软件的所有功能，这些功能应与软件需求说明书中的要求相致。
4.4.3.3源程序验收
若合同规定需要验收源程序，则：a）软件开发单位应按合同规定向验收组织提交相应的源程序目录和与测试完全一致的源程序。b所交付的源程序应根据质量保证计划中的要求进行评审，并借附有评审组的评审意见书。4.4.3.4验收测试
验收组织决定是否进行验收测试。如果决定验收测试，则根据需求说明书制定验收测试计划。验收测试计划内容包括：
a）功能测试。
b)性能测试。
c）测试用例。
d）测试数据。
e)容错性处理等。
4.4.3.5评审
对各阶段验收结果进行评审，以判断所提交的软件是否满足软件需求说明书中规定的要求。4.4.4验收报告
在软件验收工作结束时，应详细填写软件验收报告，验收组织全体成员应在验收报告上签署意见。软件验收报告编写格式见附录H（标准的附录)。4
4.5软件维护阶段
4.5.1软件维护内容
SY/T5232—1999
在软件交付使用之后，进人了软件维护阶段。软件维护主要内容有：a）校正性维护：包括改正设计错误、程序错误、文档错误而对软件进行的修改。b）适应性维护：包括为适应内部、外部环境变化而对软件进行的修改。c）完善性维护：包括为扩充软件功能、提高软件性能、提高可维护性等而对软件进行的修改。4.5.2软件维护实施步骤
a）由用户或维护人员根据软件出现的问题、需要扩充的功能或需要改善软件性能，向维护管理负责人提交维护需求报告—软件问题报告【编写格式见附录」（标准的附录）]。b）维护管理负责人指定维护人员对维护需求报告进行分析和评估，初步估计问题起因和实现维护的可能性，估计修改工作量，拟定维护方案，并报维护管理负责人审批。c）按一定的步骤，对软件进行修改或扩充，修改时要全面考虑，避免修改带来的副作用及出现错上加错的情况。同时，修改所有涉及到的文档。d）对终改过的软件要进行重新测试。e）做好测试记录，填写软件修改报告【编写格式见附录K（标准的附录)]。4.5.3维护过程的控制
软件维护应有控制地进行，使整个维护过程都处于管理和控制之下。软件维护应采取以下措施：a）设立专门的软件维护管理机构。b）确立软件维护策略。
c）严格评审和评价所有修改请求。d）合理安排进度。
e）限定修改范围。
f）强制实施文档标准和编码约定。g）完成测试。
5软件文档编制
软件开发各阶段应编写的文档有：a）可行性研究报告：在项目确定阶段完成。b）项目开发计划：在项目确定阶段产生初步项目计划，在需求分析阶段最终完成。c）需求说明书：在需求分析阶段产生。d）概要设计说明书：在概要设计阶段产生。e）详细设计说明书：在详细设计阶段产生。f）用户手册：在需求分析阶段形成初稿，在以后各阶段逐步修改完善，在确认测试后最终完成。g）测试计划：
1）单元测试计划：在编程实现阶段产生。2）集成测试计划：在概要设计阶段产生。3）确认测试计划：在需求分析阶段形成初步确认测试计划，在概要设计阶段完成。h）测试报告。在相应的测试阶段完成。i）项目开发结束报告：在软件验收阶段完成。i）数据要求说明书：在需求分析阶段产生。k）数据库、数据结构说明书：在概要设计阶段产生。以上软件开发文档，每个文档应自成体系，内容上可存在某些重复。对于不同软件开发项目，应编制的文档数目和文档编写的详细程度允许有所差别。-5-
SY/T5232--1999
所有软件开发项目，都应有软件需求说明书、用户手册。必要时，可提供包括概要设计和详细设计两部分内容的软件设计说明书。在项目开发计划中，规定该项目应编写的文档。6质量保证
6.1质量保证计划
软件开发单位应制定质量保证计划。在软件开发各阶段中，应考虑的质量属性有：功能度、可靠性、可维护性、易使用性、可移植性、时间经济性、资源经济性、安全保密性、可重用性、可连接性。
质量保证计划的制定，按照GB/T12504一1990第4章的规定，定出保证本软件质量的必要条款。
6.2质量保证机构
软件开发单位应设立软件质量保证机构，独立地行使检查和监督职能。6.3质量保证机构的职责
a）审查软件产品质量、技术和管理水平。b）参加需求评审，保证文档的完整性、正确性和一致性。c）参加软件设计评审，保证软件设计与软件需求一致。d）保证所交付的源程序代码是经过审查和测试的，且与软件设计完全一致。e）监督测试的全过程。
f)向上级有关部门报告有关质量问题。g）监督改正软件错误措施的制定和执行。7配置管理
软件配置及配置项定义见GB/T12505一1990中3.15的规定。软件开发单位应负责软件配置管理，以确保对程序和文档进行正确的标识、控制和状态统计，对程序的修改提供及时、全面和准确的记录和追踪。7.1配置管理机构
在项目开发期间，软件开发单位要设立软件配置管理小组，负责配置管理工作。配置管理小组由项目所涉及的有关部分的技术人员组成，隶属项目总体组领导。7.1.1配置管理职责
a）实施软件开发和维护各阶段的软件配置管理任务。b)完成软件开发各阶段所进行的评审和检查工作。7.1.2有关规程、制度和约定
a）程序命名约定。
b）新版本命名约定。
c）软件产品标识方法。
d）有关文档标识方法。
e）介质标识和文件管理标识。
f）文档交付过程。
g）软件产品人库的移交或交付过程。h）问题报告、修改请求和修改程序的处理过程。7.2软件配置管理活动
a）配置标识：按配置管理计划对系统中配置项进行标识。6
SY/T5232—1999
b）配置控制：按对已有的配置项修改建议、处理方法和批准权限对配置项进行控制。c）配置状态的记录和报告：收集、验证、存储、处理和报告配置项的状态和信息。d）配置检查：按规定的检查方法对系统中产生的各配置项进行配置检查。e）对供货单位的控制：使用非本项目组所开发的软件时，应对该软件进行评审、测试与检查，只有演示成功、测试合格后才能使用。8开发费用评估与管理
8.1软件开发费用估算
8.1.1软件开发费用的估算公式
软件开发费用估算公式为：
C=K,·Kz·K,·Co
式中：
软件产品的总开发费用；
Co——包括软件交付使用后一年的校正性维护费用在内的软件基本开发费用；K，一一物化因素，综合考虑经营管理、固定资产折I旧和水电消耗等费用的修正系数；一技术因素，考虑资料、差旅、评审和咨询等费用的修正系数；K2
开发方式因素，考虑软件产品的开发方式的修正系数。8.1.2各系数的计算
8.1.2.1软件基本开发费用C。的计算软件基本开发费用C。的估算公式可为：Co =A +B
式中：
A—软件开发人员费用；
B-软件开发机时费用（包括消耗材料）。软件开发人员费用可参见表1进行计算。表1软件开发人员费用表
软件工种
系统分析员、总体设计人员、系统测试人员主程序员、综合测试人员
程序员
人员费用
元/（人·年）
60000~90000
45000~60000
30 000~45 000
软件各工种在整个开发项目中所占工时比例随项目性质不同而有所差异。对一些典型项目，需求分析和概要设计的工时约占20%，详细设计和测试的工时约占40%，编程与调试的工时约占40%。在这种情况下，平均每个人月的工作量所需要的人员费用可为：[60000
121190000
×20%+
[450001
160000
[300001
[元人·月】]
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。