ICS 75-010 E 07 SY 备案号：38003—2013 中华人民共和国石油天然气行业标准 SY/T 5232-—2012 代替SY/T52321999 石油工业应用软件工程规范 Specification of application software engineering for petroleum industry 2012—11—09发布 2013-03-01实施 国宝能活口 SY/T5232—2012 目 次 前言 1 范围 引用标准 3 术语与定义 4 应用软件工程细则 4.1项目确定阶段 4.2 软件开发阶段 软件运维阶段 4.3 5软件文档编制 5.1 文档编制过程 5.2各阶段产生的文档 质量保证 8 6.1 设立质量保证机构 6.2 编制质量保证计划 6.3 实施质量保证过程 7 配置管理 7.1 配置管理过程 7.2 配置管理活动 附录A（资料性附录） 软件工程文档 附录B（资料性附录） 软件质量保证文档 附录C（资料性附录） 软件配置管理文档 75 参考文献·. 87 SY/T5232—2012 前言 本标准按照GB/T1.1一2009《标准化工作导则第1部分：标准的结构和编写》给出的规则 起草。 本标准代替SY/T5232—1999《石油工业应用软件工程规范》，与SY/T5232--1999相比:，主要 变化如下： 针对中国石油天然气行业现状，参照GB/T8566一2007的基本过程进行剪裁，确定中国石 油天然气行业应用软件工程生存周期； 针对中国石油天然气行业现状，删除了对软件工程文档的封面规定，简化了各类软件·工程文 档的编写规定； 根据GB/T8567—2006，修改了软件文档编制部分； 根据GB/T8566一2007，修改质量保证及配置管理部分的相关内容； 1999年版中的开发费用评估与管理部分，由于不适应当前形势发展而废止； 文字表述更加简练、规范。 本标准由石油信息与计算机应用专业标准化委员会提出并归口。 本标准起草单位：中国石油东方地球物理勘探有限公司。 本标准主要起草人：黄幽丽、李新宅、郑永升、靳黎明、田广忠。 本标准代替SY/T5232—1999。 SY/T5232--1999的历次版本发布情况为： SY5232.1~5232.8-1991; SY 5232.10—1991; SY 5232.11-1991; —SY 5232.14--1991。 SY/T5232—2012 石油工业应用软件工程规范 1范围 本标准规定了石油工业应用软件工程的一般要求。 本标准适用于石油工业应用软件工程的全过程。 2 引用标准 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T8566—2007信息技术软件生存周期过程 GB/T8567—2006计算机软件文档编制规范 GB/T11457—2006软件工程术语 3术语与定义 本标准中使用的软件工程术语，均采用GB/T85662007，GB/T8567-—2006，GB/T11457 2006中的定义。 4应用软件工程细则 参照GB/T8566-2007规定的软件生存周期基本过程，结合软件工程生存周期的概念，规定石 油工业应用软件开发应实施的过程控制。 石油工业应用软件工程可划分为如下三大阶段： a）项目确定阶段。 b）软件开发阶段。 c）软件运维阶段。 4.1项目确定阶段 4.1.1依据 以石油行业用户需求、市场需求和任务需求作为项目确定的依据。 4.1.2论证 从经济、技术、社会、法律、方案等方面对开发项目进行可行性论证。 a）经济可行性：从石油行业应用软件系统的资金条件和建设投资、运行维护费等方面说明项目 的经济可行性。 b）技术可行性：从风险、资源、技术因素研究技术可行性，如软件功能、系统性能、硬件环境、 SY/T5232—2012 软件环境、时间、人力等因素。 c）社会可行性：从项目是否存在侵犯、妨碍公众利益，是否符合石油行业HSE要求，是否符合 现有管理制度、人员素质、石油行业应用惯例和操作方式等方面，研究社会可行性。 d）法律可行性：研究系统开发可能导致的侵权、违法和责任。 e）开发方案可行性：以风险、费用和效益等方面的适当准则对选择方案进行分析，以确定开发 方案可行性。 编写《可行性分析（研究）报告》参见A.1。编写《软件开发计划》参见A.2。 4.2 软件开发阶段 软件开发阶段包括需求分析、概要设计、详细设计、软件编码、集成、软件测试、安装记运行和 验收活动。 4.2.1需求分析 4.2.1.1需求分析任务 需求分析的任务包括：系统的功能与能力；业务、组织和用户的需求；安全、安全保密性、接 口、运行和维护需求；设计约束和合格性需求。 4.2.1.2需求分析实施 软件需求分析实施应形成软件需求规格说明文档，参见A.6。软件需求包括： a）功能与能力规格说明，包括性能、物理特性和软件项执行的环境条件。 b）软件项的外部接口。 c）合格性需求。 d）安全规格说明，包括与运行、维护相关的方法、环境影响和人为损坏等因素。 e）安全保密性规格说明，包括与敏感信息泄露相关的要求。 f）数据定义和数据库需求。 g）在运行和维护场所安装与验收已交付的软件产品的需求。 h）用户操作与执行需求。 i）用户维护需求。 4.2.1.3需求分析评审 应根据下列评价准则评价软件需求，评价结果应形成文档： a）系统需求和系统设计的可追踪性。 b）与系统需求的外部一致性。 c）内部一致性。 d）可测试性。 e）软件设计的可行性。 f）运行和维护的可行性。 4.2.2 概要设计 4.2.2.1 概要设计任务 概要设计应标识硬件、软件和人工操作项，并把软件项的需求转变为一种体系结构，该体系结构 描述其顶层结构并标识各个软件部件。确保软件项的所有需求都被分配给了其软件部件，并得到进 SY/T5232—2012 步的细化以便于进行详细设计。 4.2.2.2 概要设计实施 概要设计实施要求如下： a）软件项的体系结构应形成系统／子系统设计（结构设计）说明文档，参见A.4。 b）编制软件项的外部接口的顶层设计，以及软件项的各个软件部件间的接口的顶层设计，并形 成接口设计说明文档，参见A.5。 c）编制数据库的顶层设计，并形成数据库（顶层）设计说明文档，参见A.8。 d）宜编制用户文档的最初版本，并形成软件用户手册，参见A.11。 e）确定软件集成的初步测试需求和进度安排，并形成软件测试计划，参见A.3。 4.2.2.3概要设计评审 根据下列评价准则评价软件项的体系结构、接口和数据库设计，评价结果应形成文档： a）软件项需求的可追踪性。 b）与软件项需求的外部一致性。 c）软件部件之间的内部一致性。 d）所应用的设计方法和标准的适宜性。 e）详细设计的可行性。 f）运行与维护的可行性。 4.2.3详细设计 4.2.3.1详细设计任务 对软件项的每一软件部件进行详细设计。软件部件应细化到更低级别。这些级别包含能被编码、 编译、测试的软件单元。应确保来自这些软件部件的所有软件项需求都被分配到软件单元。 4.2.3.2详细设计实施 详细设计实施要求如下： a）详细设计应形成软件（结构）设计说明文档，参见A.7。 b）编制软件项外部接口的详细设计，以及软件部件之间、软件单元之间的接口的详细设计，并完 善接口设计说明文档，参见A.5。接口的详细设计应允许在不需要更多信息的情况下进行编码。 c）编制数据库的详细设计并完善数据库（顶层）设计说明文档，参见A.8。 d）必要时，更新用户文档。 e）规定软件单元的测试需求和测试进度安排，并完善软件测试说明（参见A.9）和软件测试计 划文档（参见A.3）。测试需求宜包括对软件单元在需求边界的强化要求。 f）更新软件集成的测试需求和进度安排，完善软件测试说明（参见A.9）和软件测试计划文档 (参见A.3)。 4.2.3.3详细设计评审 根据下列评价准则评价软件详细设计和测试需求，评价结果应形成文档： a）软件项需求的可追踪性。 b）与结构设计的外部一致性。 c）软件部件和软件单元之间的内部一致性。 SY/T5232—2012 d）所应用的设计方法和标准的适宜性。 e）测试的可行性。 f）运行与维护的可行性。 4.2.4软件编码 4.2.4.1软件编码任务 以软件（结构）设计说明文档为依据，用选定的程序设计语言进行编码。 4.2.4.2 软件编码实施 应开发下列各项： a）完成软件编码，并完善软件测试说明（参见A.9）和软件测试计划文档（参见A.3）。 b）每一个软件单元和数据库。 c）用于测试每一个软件单元和数据库的测试规程和数据。 d）必要时，应及时更新用户文档。 4.2.4.3软件编码评审 应根据下列准则评价软件编码和测试结果，评价结果应形成文档： a）软件项需求和设计的可追踪性。 b）与软件项的需求及设计的外部一致性。 c）单元需求之间的内部一致性。 d）所应用的编码方法和标准的适宜性。 e）软件集成与测试的可行性。 f）运行与维护的可行性。 4.2.5集成 4.2.5.1集成任务 集成应将软件单元和软件部件集成到软件项，并将软件配置项和硬件配置项、人工操作及其他系 统集成到系统中。随着这些集合体的开发，应对照它们的要求来测试这些集合体。 4.2.5.2集成实施 集成实施要求如下： a）应按照集成计划将软件单元和软件部件作为开发的集合体进行集成和测试。应确保每一集合 体满足软件项的需求，并且在集成活动终了时软件项已经集成。 b）必要时，应更新用