浅谈软件质量管理体系文件的编写

浅谈软件质量管理体系文件的编写 信息产业部电子第四研究所 王麟贻 摘摘 要要 阐述软件企业在认证准备阶段如何按 ISO9001 2000 版标准要求结合行 业特点 建立文件化的质量管理体系和提供客观证据 介绍了软件企业建立文 件化质量管理体系的方法和提供有效客观证据的基本要求 关键词关键词 软件 质量管理体系 文件 编写 就质量管理体系审核而言 在现场审核前 认证机构首先要对受审核方提 交的质量管理体系文件进行文件审查 对受审核方是否按标准要求并结合行业 特点建立了文件化的质量管理体系 以及文件是否符合标准要求做出初步评价 现场审核时通过交谈 查阅 观察等方式调查 了解质量管理体系的实施是否 符合文件的规定 文件的实施和保持情况以及在实现所要求的结果方面是否能 提供体系有效运行的客观证据 依据 ISO9001 2000 标准要求结合软件企业特点 建立适合组织运作的文 件化质量管理体系 按体系文件要求提供客观证据是十分必要的 下面就软件 企业如何建立文件化质量管理体系并提供有效客观证据 谈几点看法 一一 软件企业建立文件化质量管理体系的基本要求软件企业建立文件化质量管理体系的基本要求 1 ISO 9001 标准对质量管理体系文件的基本要求 ISO 9001 标准要求的质量管理体系文件包括以下五种 1 由组织的最高管理者正式发布的 体现了组织总的质量宗旨和质量方 向的质量方针 组织在质量方面所追求的近期目的 包括满足产品要求所需内 容的质量目标 2 规定组织质量管理体系要求的纲领性文件质量手册 3 标准规定的 6 个程序文件 4 组织为确保其过程有效策划 运作和控制所需的程序文件 作业文件 规范等 5 提供产品 过程 体系符合要求及体系有效运行的证据和可追溯性要 求的记录 2 建立文件化质量管理体系要突出行业特点 软件企业在建立文件化质量管理体系 编写体系文件时 除必须满足 ISO 9001 2000 质量管理体系 要求 标准之外 还需要充分考虑软件行业特点 参考 ISO 9000 3 1997 ISO 9001 94 在计算机软件开发 供应 安装和维护 中的使用指南 GB T11457 1995 软件工程术语 以及 ISO IEC12207 1995 信息技术 软件生存周期过程 等国家或国际标准 建立质量管理体系前 需要组织按标准要求 对现有管理模式和规章制度 进行必要的清理 整顿 在编写质量管理体系文件时 首先应收集整理现有的 管理文件 规章制度 软件开发文档和记录表格 然后在此基础上按标准要求 进一步补充 修改和完善 以达到符合标准的要求 质量管理体系文件具有强制性和唯一性 新编写的质量管理体系文件要与 现有的管理文件 软件开发文档相协调 对现有管理文件进行补充 完善后 应纳入新的体系文件重新审批发布 并按文件控制程序统一编号和管理 以防 止作废文件的非预期使用 编写质量管理体系文件时 组织要结合软件行业特点 企业规模和人员素 质等综合因素统盘考虑 切忌将其他已通过认证企业的质量管理体系文件拿来 照搬照抄 编写质量体系文件应从以下几方面入手 二 二 质量手册的编写质量手册的编写 1 确定软件产品实现的流程 根据软件产品特点 确定以下产品实现流程图 识别流程图中各过程的输入和 输出 确定这些过程需要开展的活动和需要投入的资源 然后识别第 7 章产品 实现过程中 那些不影响组织提供满足顾客和适用法律法规要求的产品的能力 或责任的条款 并说明删减的细节和理由 2 确定标准条款与软件产品实现过程的对应关系 根据产品实现过程流程图的主要过程与标准条款的对应关系进行过程描述 质 量手册中各条款的描述最好与标准条款相对应 以便覆盖标准要求 顺利通过 认证机构的文件审查 手册对质量管理体系各过程要求和过程之间相互作用的描述要突出软件行 业特点 与软件实现过程相对应 应明确各过程需开展的质量活动 控制要求 和控制方法 主管部门和配合部门的质量职责等 三 三 软件产品实现过程的控制与实施要求软件产品实现过程的控制与实施要求 1 软件的需求分析与评审过程 本过程与 ISO9001 标准 7 2 与顾客有关的过程 相对应 组织需要根据市 场或顾客需求草案编制详细的软件需求规格说明 对那些顾客没有提出 但规 定的用途或已知预期用途所必须的要求以及法律法规要求 组织也应该予以识 别和满足 软件需求规格说明的编写应符合 GB T9385 计算机软件需求说明编制指南 的规定 软件需求规格说明实施前应得到项目负责人审批并通过组织内部评审 在合同状态下 软件需求规格说明实施前还应得到顾客确认 评审和确认 后的软件需求规格说明作为软件开发输入 2 软件系统 项目设计开发过程 本过程规定了组织策划并开发软件产品的各项活动 与 ISO9001 标准的 7 1 产品实现的策划 7 3 设计和开发 相对应 包括以下七个子过程 1 软件开发的策划 本过程需要编制软件项目开发计划 开发计划的编写应依据 GB T8567 计 算机软件开发文件编制指南 的规定 主要内容包括 定义 项目概述 顾客 组织对项目的要求和验收标准 开发阶段的划分 项目时间进度要求 每阶 段的输入 输出和所需的评审 验证和确认的活动安排 项目开发组的职责 权限 项目的资源配置 项目组成员的分工 职责和权限以及各项任务间的相 互关系 确保参与开发的不同小组 人员之间的组织协调和技术接口 各小组 和人员之间的有效沟通要求等 2 软件开发的输入 本过程需要编制 软件需求说明书 数据要求说明书 规则 惯 例和约定 等 软件需求说明书 主要内容包括 顾客或市场的需求与期望 产品主要功能 性能要求 适用的法律 法规要求和国家强制性标准 以前类 似设计提供的适用信息 对确定软件产品的安全性和适用性至关重要的特性要 求 包括安全保密 维护及使用环境等 3 软件开发输出 软件开发输出应以能针对软件开发输入进行验证的形式来表述 以证明输 出满足输入要求 为软件生产和服务运作提供适当的信息 软件系统 项目开 发输出除需编制软件程序外 还要在用户手册中规定安全和正常使用所必须的 产品特性 包括安装 使用 维护等要求 设计输出文档一般包括 概要 详细设计说明书 数据库设计说明书 软件开发工具 设备采购计划 采购软件 设备验证 测试规范 单元 集成 验收测试计划 测试 用例 测试分析报告 项目开发总结报告 用户 维护手册 培训教材 等 研发人员进行软件程序编码时 应对可能涉及的顾客提供的软件开发工具 数据或测试用例按 7 5 4 顾客财产 的要求加以识别和管理 4 软件开发的评审 在软件开发的适当阶段 应按项目开发计划的要求 组织相关部门对设计 输出成果进行系统的评审 根据评审结果编制 软件开发评审报告 研发人 员对评审中发现的问题应及时采取有效的纠正措施 并跟踪记录措施的实施情 况 组织提供的客观证据主要包括 需求分析的评审 设计输出文档和软件功 能 性能的评审记录等 5 软件开发的验证 研发人员应根据 测试计划 和 测试用例 分别对开发的软件进行单元 和集成测试 根据测试结果编制 测试分析报告 主要内容包括 测试概况 测试结果 对阶段软件功能的分析结论等 应确保软件需求输入中每一项功能 性能要求都有相应的验证记录 对于按特定合同开发的软件项目 测试活动与 标准 8 2 4 条款产品的过程检验为同一过程 6 软件开发的确认 软件系统 项目的确认目的是为了证实产品能够满足预期的使用要求 对 于自主研发的通用软件系统的确认一般在销售之前完成 按特定合同开发的软 件项目 确认通常在产品交付前完成 确认或验收测试活动与标准 8 2 4 条款 产品的最终检验为同一过程 测试应尽可能在使用环境下进行 并有顾客参加 如需经用户使用一段时间才能完成确认工作的 应在可能的适用范围内实施局 部确认 一般情况下 确认测试 现场验收测试可以合并进行 对测试中发现的不合格软件项 应按不合格品控制程序的要求 分析原因 并修改程序后 重新进行测试 对使用的测试设备 工具应实施有效控制 并 提供以下客观证据 测试用计算机定期维护记录 测试 杀毒软件和测试用例 使用前的评价与确认记录等 7 软件开发的更改 开发人员应识别和评价设计更改对软件产品使用性能 安全性 可靠性等方面 带来的影响 软件开发的更改可发生在软件生存期的任何阶段 当更改涉及到软件的主要功能和技术性能要求的改变 人身安全或相关法 律法规要求变更时 应对更改进行适当的评审 必要时 重新进行验证和确认 测试活动 3 配置管理过程 配置管理过程是在整个软件生存周期中实施技术状态管理的过程 它标识 定义系统中软件项 并指定基线 控制软件项的修改和放行 记录和报告软件 项的状态和修改申请 保证软件项的完整性 一致性和正确性 控制软件项的 储存 处理和交付 本过程与 ISO9001 标准的 7 5 3 产品标识和可追溯性 相 对应 配置管理活动包括 编制配置管理计划 确定基线 对开发设备 开发工 具 开发文档和代码实施配置管理 控制软件更改 对更改后的软件进行配置 标识 控制软件审查 测试记录 标识软件版本等 4 交付与维护过程 组织对软件产品交付和提供售后维护服务的活动与 ISO9001 标准 7 5 1 生 产和服务提供的控制 7 5 5 产品防护 相对应 1 软件产品交付 软件产品在用户现场安装前 应按标准 7 5 4 顾客财产 的控制要求对顾 客提供的硬件设备和软件运行环境等进行识别和确认 技术支持人员在用户现 场完成软件安装后 应按用户培训教材或用户手册的要求对顾客进行软件使用 的必要培训 按软件项目验收测试计划要求与顾客一同进行验收测试 并请顾 客代表签署验收意见 2 维护过程 软件产品交付后 组织应依据合同 负责软件售后维护和软件版本升级工 作 维护活动一般包括 对顾客使用中出现的软件故障进行测试 分析和修复 在维护阶段 按顾客提出的功能和性能改进要求进行软件版本升级 升级后的 软件版本应纳入配置管理 并保存软件维护 升级记录 四 四 程序文件的编写要求程序文件的编写要求 程序文件作为指导和规范各职能部门运作的文件 应具有很强的可操作和 检查性 内容一般包括 目的 范围 职责 工作要求和程序 记录要求 支 持性文件和记录表格目录等 程序文件中关于质量活动的描述应明确各过程之间的接口关系 主管部门 配合部门的职责和权限 应体现 PDCA 循环的要求 以便形成闭环管理 使质 量管理工作得到持续改进 软件企业在编写程序文件时要符合行业特点和组织运作方式 例如 某软 件公司质量手册规定质量管理体系文件采用电子文档媒体形式 该公司应在 文件控制程序 中规定电子文档管理人员的职责权限 文档的控制要求和控 制方法 一般需要做出以下规定 质量管理体系电子文档的主管部门和责任人员职责 计算机 局域网上发 布的质量体系文件的会签管理要求 电子文档在计算机 局域网上只读设置 访问权限设置 修改密码设置的要求 确保网上发布的电子文档有效性和受控 版本标识的要求 确保及时删除网上作废文件 及如何设置 作废保留 文件 夹中保存作废文件的要求 当电子文档保存在光盘或软盘中时 在媒体包装上 如何做受控版本标识的要求等 五 五 为确保过程有效运行和控制所需文件的编写要求为确保过程有效运行和控制所需文件的编写要求 这些文件一般指除标准中规定的 6 个程序文件之外 根据产品特点 组织 规模和人员素质而确定的其它程序文件 作业指导书 规范 开发文档等 在 确定文件的种类和数量时还应考虑对提供产品或服务质量的影响 顾客和法律 法规的要求 组织运作的有效性和效率等 组织可以根据软件实现过程特点考虑编制文件的种类 软件企业确定程序文件 目录时除满足标准对程序文件的一般要求外 还应结合软件实现过程特点增加 软件需求分析控制 软件开发控制 软件测试控制 测试设备 工具控制 配 置管理控制 软件安装 交付与维护等程序文件 或其他形式的管理文件 除此之外 软件企业还应根据软件开发的复杂程度 按电子行业标准 SJ T207 1 设计文件管理制度 第 1 部分 设计文件的分类和组成 中 软件 产品设计文件的成套性 的规定 确定软件开发文档的种类和数量 依据 GB T8567 计算机软件开发文件编制指南 的要求 制定软件开发文档编制规 范或模板 以规范软件开发文档的编写工作 软件开发文档编写规范或模板一般包括 软件开发计划 软件需求规格说 明 概要设计说明 详细设计说明 数据库设计说明 编码规范 测试计划 测试用例 测试分析报告 项目开发总结报告 配置管理计划 用户手册 用 户培训教材等 六 六 记录表格要求记录表格要求 记录是实现可追溯性的基础 记录可提供产品 过程和体系符合要求及质 量管理体系有效运行的证据 具有追溯 证实和依据记录采取纠正和预防措施 的作用 记录是一种特殊类型的文件 作为记录表格属于文件的范畴 需要规定记录格 式的编号并按文件控制程序进行管理 填写内容后的表格成为一种记录 记录表格除需要规定记录格式编号之外 还应规定使用后的顺序号 以便区分同一类记录表格在不同时间 不同场所 记录的不同内容的信息 软件企业除需要满足 ISO9001 标准规定的 21 处 包 括适用时的情况 记录要求外 还需要根据软件产品实现特点 按 GB T8567 计算机软件开发文件编制指南 要求填写相关记录