软件版本管理规范V2.doc

标 题
软件版本管理规范
编 号
F-03-007
页 次
10/10
制订部门
研发部
版 次
A001
制订日期
2008-12-02

软件版本管理规范

制订：刘志敏
审核：______
批准：______

文 件 修 订 记 录
文件名称
工程设计变更管理程序
编号
F-02-002
版次
修订内容
修改页次
修订日期
修订者
备注
A00
新版本发行

2007-10-7
刘志敏

A01
流程优化后进行相应修订

2008-12-02
姚旋

目 录
1. 目的 3
2. 适用范围 3
3. 权责 3
3.1. 版本管理员 3
3.2. 软件系统架构师 4
3.3. 软件工程师 4
3.4. 软件主管 5
3.5. 软件测试工程师 6
4. 作业流程 6
4.1. 流程及发布 6
4.2. 注意事项 6
4.3. 软件归档控制 7
4.4. 软件发布控制 8
4.4.1. 发布内容 8
4.4.2. 发布评审（Review） 9
4.4.3. 软件产品正式版本发布流程如下 9
5. 相关文件 11
5.1. 研发设计开发控制程序 11
5.2. 项目计划 11
6. 记录表单 11
6.1. 软件概要设计评审检查表 11
6.2. 软件详细设计评审检查表 11
6.3. 软件集成测试报告评审检查表 11
6.4. 软件发布评审检查表 11
6.5. SVN月度稽查检查表 11
7. 附件 11

1. 目的
1.1. 标准化软件工作流程
1.2. 软件开发过程中代码安全
1.3. 标准化配置管理，规范开发文档输入输出
1.4. 软件版本控制提高软件发布质量
1.5. 对配置管理进行跟进,调查,改善, 为纠正预防提供方向

2. 适用范围
所有软件版本管理员、软件系统架构师、软件工程师、软件测试工程师、软件技术总监/副总监、软件主管

3. 权责
3.1. 版本管理员
1) 负责版本服务器的日常维护
2) 版本服务器用户的添加，删除，修改访问权限
3) 版本服务器数据库的建立
4) 版本服务器新项目模块库建立
5) 依据系统架构师对新建项目的模块划分,设置组成员版本服务器工作权限
6) 编译检查发布正式版本,确保代码是最新可用的
7) 项目完成对代码进行编译检查,清理所有项目文档并归档
8) 文档资料的定时备份.(完成归档的项目资料按月备份)
9) 协助解决版本服务器用户使用过程中所遇到的问题
10) 对SVN服务器使用情况进行稽查提交《SVN月度稽查报告检查表》
3.2. 软件系统架构师
1) 对软件项目进行模块划分
2) 协同版本管理员在版本服务器上进行目录设置,保证代码安全
3) 检查组成员的上传代码,保证代码的质量
4) 按项目计划时间点,及时提交软件项目文件
5) 对单元测试中发现的问题及时进行处理.并在服务器做好备份工作
6) 发布集成测试软件版本和集成测试报告给测试组做集成测试验证
7) 对后期测试发现的bug要及时跟进安排解决，对修改的代码及时上传服务器并添加修改说明
8) 正式版本发布，按标准更新版本号，确保所有正式发布版本唯一
9) 项目完成对所有代码和文档做检查，提交版本管理员；对模块的代码组织进行模块化评审,归档，并提交相应说明文档
3.3. 软件工程师
1) 负责对软件功能模块的编码工作
2) 工作前对本地工作目录的代码进行检查是否为最新版本,确认后方可进行工作,否则必须先进行本地工作目录的更新
3) 工作完成后及时将本地机工作目录下的代码进行checkin,避免代码丢失造成的损失
4) 每次涉及到版本机的checkin都必须附上版本说明(说明修改的内容,新增功能,解决的bug等)
5) 服从系统架构师配置管理工作安排，文件代码要及时归档
6) 维护工作涉及代码的修改必须上传版本服务器，并且附修改说明（明确为什么修改，修改哪些地方，修改日期，修改人等信息）
3.4. 软件主管
1) 负责把关产品的软件设计，确保设计满足要求, 参与《新产品需求说明书》评审
2) 参与软件概要设计、详细设计、编码工作、单元测试、集成测试，对各环节进行检查评审，确保工作质量
3) 审批本组成员输出资料，确保输出资料准确无误
4) 把关软件《概要设计》、《详细设计》检查评审，确保设计满足需求
5) 把关软件《单元测试报告》、《集成测试报告》检查评审，确保发布到测试组的软件质量
6) 规划参与项目的本组成员，估计项目进度要求的各里程碑
7) 协助、指导本组项目成员参考研发服务器上项目计划模板制作《软件开发计划进度表》
8) 审核《软件开发计划进度表》，确保时间利用最大化
9) 督导本组成员将项目计划任务落实到月、周工作计划中
10) 负责测试用例库建设，并监督测试流程，把关测试质量
3.5. 软件测试工程师
1) 协助系统架构师和软件工程师完成软件单元测试,集成测
2) 软件系统测试,对于测试中发现的bug与对应软件工程师沟通并上TD服务器
3) 软件测试通过后组织系统架构师和相关人员召开发布评审会

4. 作业流程
4.1. 流程及发布
详见《软件组工作流程》
4.2. 注意事项
a) 下班前更新时,不要把没有编译成功的程序文件迁入版本服务器
b) 添加修改版本服务器上的文件，必须添加注释说明
c) 本机除了开发工程目录外，还需建一个中间工程目录，目录下面可以根据自己需要新增子目录，每次工作前，先更新中间工程目录，使它与版本服务器上的工程文件完全一致
d) 备份文件代码迁入版本服务器前，必须对文件进行编译检查
e) 标签和分支的命名必须遵照标准进行(产品完整型号+版本+分支名称)
f) 备份文件归档时,将代码中编译冗余文件清除(如:.a;.o等等)
g) 产品到发布版本给测试的阶段，要修改版本服务器代码必须有系统工程师或相关人员审核确保代码的准确
h) 项目全部源代码仅有管理员和架构师掌握,确保代码安全
i) 所有代码必须从版本服务器上下载,禁止以其它任何形式传递获取代码
j) 正式软件必须由版本管理员发布,加强对软件版本的控制
4.3. 软件归档控制
1) 开发完成后进行软件版本归档，内容主要有：软件名称（中、英文），版本号，编译后的可执行文件，源代码和文档（需求分析文档，概要设计，详细设计，测试用例和bug报告等）
2) 系统架构师确定要发布的版本号，然后由版本管理员检查是否满足版本提交条件，最后由版本管理员确认后，将该版本存档
3) 软件版本升级变更时，由系统工程师根据软件工程师提交的源代码和文档在版本服务器进行更新检查并知会版本管理员，然后由版本管理员检查是否满足版本提交条件，最后由版本管理员确认后，再将该版本存档
4) 当发生用户需求变更时，系统架构师提交程序需求变更设计说明，并另行标明在源程序和文档中何处进行了更改，最终由软件主管审核通过后，将该版本存档
5) 确定每个版本责任人，同一软件可以有不同时期的责任人
6) 版本提交归档后，软件的任何修改需先向管理人员申请，由版本管理员提交该版本，开发人员不能自行使用开发时使用的源程序
7) 软件提交同时需附上编译说明文档,内容包括:编译环境,编译工具,编译步骤等
4.4. 软件发布控制
4.4.1. 发布内容
4.4.1.1. 在软件发布中，会因发布的类型不同而产生不同的发布包。可能会有以下几种类型:
Ø 产品升级发布: 指在早期版本的基础上提高产品的特征集，当然也包括更新内容
Ø 产品更新发布 通常是修复老产品的缺陷 如收集一定时间内的产品缺陷，汇总产生如3.0.1 进行更新发布
Ø 补丁发布：补丁（紧急修复）是用来修复产品缺陷或掩饰缺点的。补丁和更新之间的区别是紧急程度和实施的工作量
4.4.1.2. 发布包的主要构成如下，如果是补丁或产品更新发布，发布包简化为程序、说明性文档和源码
Ø 程序
Ø 源码
Ø 发布说明文档，包括各种readme（测试组提供）
Ø 用户（操作）手册（测试组提供）
Ø 全套项目文档
Ø 配置说明文档
Ø 其它
4.4.2. 发布评审（Review）
对于软件正式发布，测试工程师要组织各相关人员召开评审会由系统工程师支持审核和检查，以保证发布的产品满足用户的需求及公司的各类规范
Ø 软件发布评审
Ø 项目文档的检查
Ø 源代码和安装程序的检查
4.4.3. 软件产品正式版本发布流程如下
4.4.3.1. 发布准备 发布之前，所有程序由测试工程师进行确认测试；检查BUG系统内登记的所有bug都已经被解决，或者遗留的bug不影响系统的使用，如果有严重bug未解决则不能发布；程序打包前做测试
4.4.3.2. 测试工程师组织软件发布评审，由软件系统工程师主持评审
4.4.3.3. 源码、文档入库 编译构建脚本和所有源代码；文档包括需求说明、设计说明、计划，测试文档，操作手册、使用demo等
4.4.3.4. 系统工程师进行程序打包 标记源码、文档版本tag
4.4.3.5. 编写发布说明readme.txt Read me的内容应该包括产品版本说明；本次发布包含的文件包、文档说明；本次发布包含或者新增的功能特性说明；遗留问题及影响说明；版权声明以及其他需要说明的事项
4.4.3.6. 正式发布通知 通知开发、测试、市场、销售各相关部门并附上发布说明和介绍
4.4.3.7. 后续工作 软件发布后，在使用过程中可能还会发现一些bug，由公司BUG管理系统跟踪。在不影响正常使用的情况下，这些bug将在下一版本发布时解决；如果bug严重影响使用，必须按照流程重新发布
4.4.3.8. 临时发布 软件产品未正式发布前，可能需要一个临时版本供软件工程师或者用户应急使用，这时候需要临时发布一个版本。这个版本只包括基本的程序包和必要的使用说明。临时发布需要通知相关开发、测试工程师；系统工程师需要为源码、文档打tag标记

5. 相关文件
5.1. 研发设计开发控制程序
5.2. 项目计划

6. 记录表单
6.1. 软件概要设计评审检查表
6.2. 软件详细设计评审检查表
6.3. 软件集成测试报告评审检查表
6.4. 软件发布评审检查表
6.5. SVN月度稽查检查表

7. 附件
《软件组工作流程》

物业安保培训方案
为规范保安工作，使保安工作系统化/规范化,最终使保安具备满足工作需要的知识和技能，特制定本教学教材大纲。
一、课程设置及内容全部课程分为专业理论知识和技能训练两大科目。
其中专业理论知识内容包括：保安理论知识、消防业务知识、职业道德、法律常识、保安礼仪、救护知识。作技能训练内容包括：岗位操作指引、勤务技能、消防技能、军事技能。
二．培训的及要求培训目的
1）保安人员培训应以保安理论知识、消防知识、法律常识教学为主，在教学过程中，应要求学员全面熟知保安理论知识及消防专业知识，在工作中的操作与运用，并基本掌握现场保护及处理知识2）职业道德课程的教学应根据不同的岗位元而予以不同的内容，使保安在各自不同的工作岗位上都能养成具有本职业特点的良好职业道德和行为规范）法律常识教学是理论课的主要内容之一，要求所有保安都应熟知国家有关法律、法规，成为懂法、知法、守法的公民，运用法律这一有力武器与违法犯罪分子作斗争。工作入口门卫守护，定点守卫及区域巡逻为主要内容，在日常管理和发生突发事件时能够运用所学的技能保护公司财产以及自身安全。
2、培训要求
1）保安理论培训
通过培训使保安熟知保安工作性质、地位、任务、及工作职责权限，同时全面掌握保安专业知识以及在具体工作中应注意的事项及一般情况处置的原则和方法。
2）消防知识及消防器材的使用
通过培训使保安熟知掌握消防工作的方针任务和意义，熟知各种防火的措施和消防器材设施的操作及使用方法，做到防患于未燃，保护公司财产和员工生命财产的安全。
3) 法律常识及职业道德教育
通过法律常识及职业道德教育，使保安树立法律意识和良好的职业道德观念，能够运用法律知识正确处理工作中发生的各种问题；增强保安人员爱岗敬业、无私奉献更好的为公司服务的精神。
4) 工作技能培训

10