软件版本管理规范V2.doc

1、 标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 1/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-021软 件 版 本 管 理 规 范制 订 ： 刘 志 敏审 核 ： _批 准 ： _文 件 修 订 记 录文 件 名 称 工 程 设 计 变 更 管 理 程 序 编 号 F-02-002 版 次 修 订 内 容 修 改 页 次 修 订 日 期 修 订 者 备 注A00 新 版 本 发 行 2007-10-7 刘 志 敏A01 流 程 优 化 后 进 行 相 应 修 订 2008-12-02 姚 旋标 题 软 件 版 本 管 理 规 范

2、 编 号 F-03-007 页 次 2/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-022目 录1. 目 的 .32. 适 用 范 围 .33. 权 责 .33.1. 版 本 管 理 员 .33.2. 软 件 系 统 架 构 师 .43.3. 软 件 工 程 师 .43.4. 软 件 主 管 .53.5. 软 件 测 试 工 程 师 .64. 作 业 流 程 .64.1. 流 程 及 发 布 .64.2. 注 意 事 项 .64.3. 软 件 归 档 控 制 .74.4. 软 件 发 布 控 制 .84.4.1. 发 布 内 容 .84.4.2. 发 布 评

3、 审 （ Review） .94.4.3. 软 件 产 品 正 式 版 本 发 布 流 程 如 下 .95. 相 关 文 件 .115.1. 研 发 设 计 开 发 控 制 程 序 .115.2. 项 目 计 划 .116. 记 录 表 单 .116.1. 软 件 概 要 设 计 评 审 检 查 表 .116.2. 软 件 详 细 设 计 评 审 检 查 表 .116.3. 软 件 集 成 测 试 报 告 评 审 检 查 表 .116.4. 软 件 发 布 评 审 检 查 表 .116.5. SVN 月 度 稽 查 检 查 表 .117. 附 件 .11标 题 软 件 版 本 管 理 规 范

4、编 号 F-03-007 页 次 3/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-0231. 目 的1.1.标 准 化 软 件 工 作 流 程1.2.软 件 开 发 过 程 中 代 码 安 全1.3.标 准 化 配 置 管 理 ， 规 范 开 发 文 档 输 入 输 出1.4.软 件 版 本 控 制 提 高 软 件 发 布 质 量1.5.对 配 置 管 理 进 行 跟 进 ,调 查 ,改 善 , 为 纠 正 预 防 提 供 方 向2. 适 用 范 围所 有 软 件 版 本 管 理 员 、 软 件 系 统 架 构 师 、 软 件 工 程 师 、 软 件 测 试

5、 工 程 师 、 软 件 技 术 总 监 /副总 监 、 软 件 主 管3. 权 责3.1.版 本 管 理 员1) 负 责 版 本 服 务 器 的 日 常 维 护2) 版 本 服 务 器 用 户 的 添 加 ， 删 除 ， 修 改 访 问 权 限3) 版 本 服 务 器 数 据 库 的 建 立4) 版 本 服 务 器 新 项 目 模 块 库 建 立5) 依 据 系 统 架 构 师 对 新 建 项 目 的 模 块 划 分 ,设 置 组 成 员 版 本 服 务 器 工 作 权 限6) 编 译 检 查 发 布 正 式 版 本 ,确 保 代 码 是 最 新 可 用 的7) 项 目 完 成 对 代 码

6、进 行 编 译 检 查 ,清 理 所 有 项 目 文 档 并 归 档8) 文 档 资 料 的 定 时 备 份 .(完 成 归 档 的 项 目 资 料 按 月 备 份 )9) 协 助 解 决 版 本 服 务 器 用 户 使 用 过 程 中 所 遇 到 的 问 题10) 对 SVN 服 务 器 使 用 情 况 进 行 稽 查 提 交 SVN 月 度 稽 查 报 告 检 查 表 标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 4/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-0243.2.软 件 系 统 架 构 师1) 对 软 件 项 目

7、进 行 模 块 划 分2) 协 同 版 本 管 理 员 在 版 本 服 务 器 上 进 行 目 录 设 置 ,保 证 代 码 安 全3) 检 查 组 成 员 的 上 传 代 码 ,保 证 代 码 的 质 量4) 按 项 目 计 划 时 间 点 ,及 时 提 交 软 件 项 目 文 件5) 对 单 元 测 试 中 发 现 的 问 题 及 时 进 行 处 理 .并 在 服 务 器 做 好 备 份 工 作6) 发 布 集 成 测 试 软 件 版 本 和 集 成 测 试 报 告 给 测 试 组 做 集 成 测 试 验 证7) 对 后 期 测 试 发 现 的 bug 要 及 时 跟 进 安 排 解 决

8、， 对 修 改 的 代 码 及 时 上 传 服 务 器 并 添加 修 改 说 明8) 正 式 版 本 发 布 ， 按 标 准 更 新 版 本 号 ， 确 保 所 有 正 式 发 布 版 本 唯 一9) 项 目 完 成 对 所 有 代 码 和 文 档 做 检 查 ， 提 交 版 本 管 理 员 ； 对 模 块 的 代 码 组 织 进 行 模块 化 评 审 ,归 档 ， 并 提 交 相 应 说 明 文 档3.3.软 件 工 程 师1) 负 责 对 软 件 功 能 模 块 的 编 码 工 作2) 工 作 前 对 本 地 工 作 目 录 的 代 码 进 行 检 查 是 否 为 最 新 版 本 ,确 认

9、 后 方 可 进 行 工 作 ,否则 必 须 先 进 行 本 地 工 作 目 录 的 更 新3) 工 作 完 成 后 及 时 将 本 地 机 工 作 目 录 下 的 代 码 进 行 checkin,避 免 代 码 丢 失 造 成 的 损失4) 每 次 涉 及 到 版 本 机 的 checkin 都 必 须 附 上 版 本 说 明 (说 明 修 改 的 内 容 ,新 增 功 能 ,解决 的 bug 等 )5) 服 从 系 统 架 构 师 配 置 管 理 工 作 安 排 ， 文 件 代 码 要 及 时 归 档6) 维 护 工 作 涉 及 代 码 的 修 改 必 须 上 传 版 本 服 务 器 ，

10、并 且 附 修 改 说 明 （ 明 确 为 什 么 修 改 ，修 改 哪 些 地 方 ， 修 改 日 期 ， 修 改 人 等 信 息 ）3.4.软 件 主 管1) 负 责 把 关 产 品 的 软 件 设 计 ， 确 保 设 计 满 足 要 求 , 参 与 新 产 品 需 求 说 明 书 评 审标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 5/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-0252) 参 与 软 件 概 要 设 计 、 详 细 设 计 、 编 码 工 作 、 单 元 测 试 、 集 成 测 试 ， 对 各 环 节 进

11、行 检查 评 审 ， 确 保 工 作 质 量3) 审 批 本 组 成 员 输 出 资 料 ， 确 保 输 出 资 料 准 确 无 误4) 把 关 软 件 概 要 设 计 、 详 细 设 计 检 查 评 审 ， 确 保 设 计 满 足 需 求5) 把 关 软 件 单 元 测 试 报 告 、 集 成 测 试 报 告 检 查 评 审 ， 确 保 发 布 到 测 试 组 的 软 件质 量6) 规 划 参 与 项 目 的 本 组 成 员 ， 估 计 项 目 进 度 要 求 的 各 里 程 碑7) 协 助 、 指 导 本 组 项 目 成 员 参 考 研 发 服 务 器 上 项 目 计 划 模 板 制 作

12、软 件 开 发 计 划 进 度表 8) 审 核 软 件 开 发 计 划 进 度 表 ， 确 保 时 间 利 用 最 大 化9) 督 导 本 组 成 员 将 项 目 计 划 任 务 落 实 到 月 、 周 工 作 计 划 中10)负 责 测 试 用 例 库 建 设 ， 并 监 督 测 试 流 程 ， 把 关 测 试 质 量3.5.软 件 测 试 工 程 师1) 协 助 系 统 架 构 师 和 软 件 工 程 师 完 成 软 件 单 元 测 试 ,集 成 测2) 软 件 系 统 测 试 ,对 于 测 试 中 发 现 的 bug 与 对 应 软 件 工 程 师 沟 通 并 上 TD 服 务 器3)

13、软 件 测 试 通 过 后 组 织 系 统 架 构 师 和 相 关 人 员 召 开 发 布 评 审 会4. 作 业 流 程4.1.流 程 及 发 布详 见 软 件 组 工 作 流 程 4.2.注 意 事 项a) 下 班 前 更 新 时 ,不 要 把 没 有 编 译 成 功 的 程 序 文 件 迁 入 版 本 服 务 器b) 添 加 修 改 版 本 服 务 器 上 的 文 件 ， 必 须 添 加 注 释 说 明c) 本 机 除 了 开 发 工 程 目 录 外 ， 还 需 建 一 个 中 间 工 程 目 录 ， 目 录 下 面 可 以 根 据 自 己 需 要标 题 软 件 版 本 管 理 规 范

14、编 号 F-03-007 页 次 6/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-026新 增 子 目 录 ， 每 次 工 作 前 ， 先 更 新 中 间 工 程 目 录 ， 使 它 与 版 本 服 务 器 上 的 工 程 文 件完 全 一 致d) 备 份 文 件 代 码 迁 入 版 本 服 务 器 前 ， 必 须 对 文 件 进 行 编 译 检 查e) 标 签 和 分 支 的 命 名 必 须 遵 照 标 准 进 行 (产 品 完 整 型 号 +版 本 +分 支 名 称 )f) 备 份 文 件 归 档 时 ,将 代 码 中 编 译 冗 余 文 件 清 除 (

15、如 :.a;.o 等 等 )g) 产 品 到 发 布 版 本 给 测 试 的 阶 段 ， 要 修 改 版 本 服 务 器 代 码 必 须 有 系 统 工 程 师 或 相 关 人 员审 核 确 保 代 码 的 准 确h) 项 目 全 部 源 代 码 仅 有 管 理 员 和 架 构 师 掌 握 ,确 保 代 码 安 全i) 所 有 代 码 必 须 从 版 本 服 务 器 上 下 载 ,禁 止 以 其 它 任 何 形 式 传 递 获 取 代 码j) 正 式 软 件 必 须 由 版 本 管 理 员 发 布 ,加 强 对 软 件 版 本 的 控 制4.3.软 件 归 档 控 制1) 开 发 完 成 后

16、进 行 软 件 版 本 归 档 ， 内 容 主 要 有 ： 软 件 名 称 （ 中 、 英 文 ） ， 版 本 号 ， 编译 后 的 可 执 行 文 件 ， 源 代 码 和 文 档 （ 需 求 分 析 文 档 ， 概 要 设 计 ， 详 细 设 计 ， 测 试 用例 和 bug 报 告 等 ）2) 系 统 架 构 师 确 定 要 发 布 的 版 本 号 ， 然 后 由 版 本 管 理 员 检 查 是 否 满 足 版 本 提 交 条 件 ，最 后 由 版 本 管 理 员 确 认 后 ， 将 该 版 本 存 档3) 软 件 版 本 升 级 变 更 时 ， 由 系 统 工 程 师 根 据 软 件 工

17、 程 师 提 交 的 源 代 码 和 文 档 在 版 本 服务 器 进 行 更 新 检 查 并 知 会 版 本 管 理 员 ， 然 后 由 版 本 管 理 员 检 查 是 否 满 足 版 本 提 交 条件 ， 最 后 由 版 本 管 理 员 确 认 后 ， 再 将 该 版 本 存 档4) 当 发 生 用 户 需 求 变 更 时 ， 系 统 架 构 师 提 交 程 序 需 求 变 更 设 计 说 明 ， 并 另 行 标 明 在 源程 序 和 文 档 中 何 处 进 行 了 更 改 ， 最 终 由 软 件 主 管 审 核 通 过 后 ， 将 该 版 本 存 档5) 确 定 每 个 版 本 责 任

18、人 ， 同 一 软 件 可 以 有 不 同 时 期 的 责 任 人6) 版 本 提 交 归 档 后 ， 软 件 的 任 何 修 改 需 先 向 管 理 人 员 申 请 ， 由 版 本 管 理 员 提 交 该 版 本 ，开 发 人 员 不 能 自 行 使 用 开 发 时 使 用 的 源 程 序7) 软 件 提 交 同 时 需 附 上 编 译 说 明 文 档 ,内 容 包 括 :编 译 环 境 ,编 译 工 具 ,编 译 步 骤 等标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 7/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-0274.

19、4.软 件 发 布 控 制4.4.1. 发 布 内 容4.4.1.1. 在 软 件 发 布 中 ， 会 因 发 布 的 类 型 不 同 而 产 生 不 同 的 发 布 包 。 可 能 会 有 以下 几 种 类 型 : 产 品 升 级 发 布 : 指 在 早 期 版 本 的 基 础 上 提 高 产 品 的 特 征 集 ， 当 然也 包 括 更 新 内 容 产 品 更 新 发 布 通 常 是 修 复 老 产 品 的 缺 陷 如 收 集 一 定 时 间 内 的 产品 缺 陷 ， 汇 总 产 生 如 3.0.1 进 行 更 新 发 布 补 丁 发 布 ： 补 丁 （ 紧 急 修 复 ） 是 用 来 修

20、 复 产 品 缺 陷 或 掩 饰 缺 点 的 。补 丁 和 更 新 之 间 的 区 别 是 紧 急 程 度 和 实 施 的 工 作 量4.4.1.2. 发 布 包 的 主 要 构 成 如 下 ， 如 果 是 补 丁 或 产 品 更 新 发 布 ， 发 布 包 简 化 为 程序 、 说 明 性 文 档 和 源 码 程 序 源 码 发 布 说 明 文 档 ， 包 括 各 种 readme（ 测 试 组 提 供 ） 用 户 （ 操 作 ） 手 册 （ 测 试 组 提 供 ） 全 套 项 目 文 档 配 置 说 明 文 档 其 它4.4.2. 发 布 评 审 （ Review）对 于 软 件 正 式

21、发 布 ， 测 试 工 程 师 要 组 织 各 相 关 人 员 召 开 评 审 会 由 系 统 工 程 师 支 持审 核 和 检 查 ， 以 保 证 发 布 的 产 品 满 足 用 户 的 需 求 及 公 司 的 各 类 规 范 软 件 发 布 评 审 项 目 文 档 的 检 查 源 代 码 和 安 装 程 序 的 检 查4.4.3. 软 件 产 品 正 式 版 本 发 布 流 程 如 下4.4.3.1. 发 布 准 备 发 布 之 前 ， 所 有 程 序 由 测 试 工 程 师 进 行 确 认 测 试 ； 检 查标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 8/9

22、制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-028BUG 系 统 内 登 记 的 所 有 bug 都 已 经 被 解 决 ， 或 者 遗 留 的 bug 不 影 响 系统 的 使 用 ， 如 果 有 严 重 bug 未 解 决 则 不 能 发 布 ； 程 序 打 包 前 做 测 试4.4.3.2. 测 试 工 程 师 组 织 软 件 发 布 评 审 ， 由 软 件 系 统 工 程 师 主 持 评 审4.4.3.3. 源 码 、 文 档 入 库 编 译 构 建 脚 本 和 所 有 源 代 码 ； 文 档 包 括 需 求 说 明 、设 计 说 明 、 计 划 ，

23、测 试 文 档 ， 操 作 手 册 、 使 用 demo 等4.4.3.4. 系 统 工 程 师 进 行 程 序 打 包 标 记 源 码 、 文 档 版 本 tag4.4.3.5. 编 写 发 布 说 明 readme.txt Read me 的 内 容 应 该 包 括 产 品 版 本 说 明 ；本 次 发 布 包 含 的 文 件 包 、 文 档 说 明 ； 本 次 发 布 包 含 或 者 新 增 的 功 能 特性 说 明 ； 遗 留 问 题 及 影 响 说 明 ； 版 权 声 明 以 及 其 他 需 要 说 明 的 事 项4.4.3.6. 正 式 发 布 通 知 通 知 开 发 、 测 试

24、、 市 场 、 销 售 各 相 关 部 门 并 附 上 发 布 说明 和 介 绍4.4.3.7. 后 续 工 作 软 件 发 布 后 ， 在 使 用 过 程 中 可 能 还 会 发 现 一 些 bug， 由 公司 BUG 管 理 系 统 跟 踪 。 在 不 影 响 正 常 使 用 的 情 况 下 ， 这 些 bug 将 在 下一 版 本 发 布 时 解 决 ； 如 果 bug 严 重 影 响 使 用 ， 必 须 按 照 流 程 重 新 发 布4.4.3.8. 临 时 发 布 软 件 产 品 未 正 式 发 布 前 ， 可 能 需 要 一 个 临 时 版 本 供 软 件 工 程师 或 者 用 户

25、 应 急 使 用 ， 这 时 候 需 要 临 时 发 布 一 个 版 本 。 这 个 版 本 只 包 括基 本 的 程 序 包 和 必 要 的 使 用 说 明 。 临 时 发 布 需 要 通 知 相 关 开 发 、 测 试 工程 师 ； 系 统 工 程 师 需 要 为 源 码 、 文 档 打 tag 标 记5. 相 关 文 件5.1.研 发 设 计 开 发 控 制 程 序5.2.项 目 计 划标 题 软 件 版 本 管 理 规 范 编 号 F-03-007 页 次 9/9制 订 部 门 研 发 部 版 次 A001 制 订 日 期 2008-12-0296. 记 录 表 单6.1.软 件 概 要 设 计 评 审 检 查 表6.2.软 件 详 细 设 计 评 审 检 查 表6.3.软 件 集 成 测 试 报 告 评 审 检 查 表6.4.软 件 发 布 评 审 检 查 表6.5.SVN 月 度 稽 查 检 查 表7. 附 件 软 件 组 工 作 流 程