代码管理规范

一、git代码管理规范

1. 分支管理：
   - master分支为线上稳定代码分支，一般情况不直接在该分支上进行开发，每次发布之前，需要使用tag打版本号；
   - develop分支为日常开发分支，开发者在该分支下建立自己的feature分支进行开发，测试通过后合并到develop分支，由负责人进行review进行代码合并；
   - feature分支为具体开发任务分支，根据开发任务命名，任务完成后合并到develop分支；
2. 提交信息规范：
   - 提交信息需简明扼要，能够快速了解到该次提交的目的和修改内容；
   - 提交描述必须包含任务编号，如：bug #12，feature #14；
   - 描述信息遵守约定俗成的习惯，格式一般为： 
     feat：新功能；
     fix：修复bug；
     style： 修改样式；
     docs：修改文档；
     test： 增加或修改测试；
3. 合并代码规范：
   - 在合并代码前，必须执行rebase操作，确保代码是基于最新的分支（如：develop）进行合并，减少merge带来的代码冲突；
   - 每个合并者都需要进行代码review，确保代码无误；
   - 每个分支、每次合并记得标记version和author等必要信息。

二、代码版本管理规范

代码的版本管理是保障代码安全的基石，因此代码版本管理规范非常重要。相关的代码版本管理规范如下：

1. 版本号规范：
   - 发布正式版本应该采用x.y.z的格式，其中：
     x为大版本号，通常在重大变更发生时才会调整，且x的变更意味着API或主要功能有向后不兼容的变化；
     y为次版本号，一般为增加了新功能，对现有的参数和返回值有增加但向后兼容的变化；
     z为修订号，一般为bug修复、性能优化以及文档的修改，对原有API保持向后兼容；
2. Git tag规范：
   - 对于线上稳定版本必须打tag，tag命名应该与版本号命名一致；
   - 在tag名称中添加前缀v，如：v1.0.0；
3. 归档规范：
   - 对于每一次发布的版本，都需要归档保存，包括代码文件（压缩文件）、sql文件、配置文件等，方便后期维护；
   - 归档的文件需要按照日期和版本号进行命名，例如：2022-01-01-release.v1.0.0.zip。

三、svn代码管理规范

虽然svn已经逐渐被git替代，但是仍然有部分项目在使用svn。针对svn，相关的代码管理规范如下：

1. 仓库规范：
   - 为每个项目单独创建版本库；
   - 在版本库中创建branches（分支）、tags（快照）和trunk（主干）目录；
   - 将主干（trunk）作为日常开发版本，分支（branches）为迭代版本，快照（tags）为发布版本；
2. 提交规范：
   - 在每一次提交代码之前，必须先执行更新操作（svn update），并进行代码冲突检查；
   - 提交信息需简明扼要，能够快速了解到该次提交的目的和修改内容；
   - 每个分支、每次合并记得标记相关信息，确保每个版本都可以追溯代码贡献者和版本号等信息；
3. 版本号规范：
   - 发布正式版本应该采用x.y.z的格式，其中：
     x为大版本号，通常在重大变更发生时才会调整，且x的变更意味着API或主要功能有向后不兼容的变化；
     y为次版本号，一般为增加了新功能，对现有的参数和返回值有增加但向后兼容的变化；
     z为修订号，一般为bug修复、性能优化以及文档的修改，对原有API保持向后兼容；

四、代码管理不规范

如果代码管理不规范，将会对项目开发和维护带来严重的影响，下面是常见的代码管理不规范：

1. 没有规范的版本号：缺乏版本号规范，不能清晰区分版本，不利于问题定位和更新升级；
2. 分支混乱：经常出现分支交叉合并，或者无意义的分支建立，导致混乱不堪；
3. 提交信息不规范：提交信息没有明确的描述该次修改的内容，无法进行追溯，对代码质量和开发交流都带来严重影响；
4. 代码审查不规范：缺乏代码审查流程，各个开发者的代码质量、风格不统一，导致代码的质量参差不齐，代码的可读性、可维护性差，不利于团队合作。

五、代码管理规范样本

下面是一份比较完整的代码管理规范样本，供各位参考。

https://github.com/k88hudson/git-flight-rules

六、固定资产投资项目代码管理规范

对于固定资产投资项目代码管理，需要遵循以下规范：

1. 项目结构规范：
   - 将工程代码与工程文件分离，代码不应与IDE及开发工具相关；
   - 工程应该清晰地描述出所有的编译、构建参数；
   - 项目必须包含文档和测试。
2. 代码规范：
   - 注释规范，每个代码的方法、变量、类都需要添加必要的注释说明其用途；
   - 代码风格规范，统一使用公司开发规范的编码风格；
   - 代码安全规范，处理用户输入数据时必须考虑安全问题；
3. 版本管理规范：
   - 版本/修订号规范，升级版本需更新主要功能、bug件的修复及文档的更新等；
   - 分支创建规范，一般提供两种分支定制：
     a. 单独的分支针对新需求而开发的改进版；
     b. 定制版，是针对特定客户而创建的分支。

七、气瓶使用安全管理规范

对于气瓶使用安全管理，需要采取以下代码管理规范：

1. 编写规范：
   - 消防设计人员应编写气瓶使用与保养标准；
   - 瞬间插接连接器的使用和保养标准；
   - 物理阻隔高限度保护使用和保养标准；
   - 低液位报警器和电接点信号的使用和保养标准。
2. 检测管理规范：
   - 定期检验管理规定，拥有气瓶的单位或者个人必须按照规定将气瓶交给具备检验检测资质的检验机构进行检验；
   - 气瓶使用机构对气瓶的日常使用情况要进行跟踪、记录，并按时上报。
3. 维护保养规范：
   - 在存储、搬运、运输和使用过程中严格执行相关要求，切勿违章操作；
   - 保养气瓶必须要由操作工采用合适的仪器、工具进行，切勿折弯、撞击气瓶等危险行为。

八、手术室管理规范最新版

对于手术室管理规范，需要做好以下代码管理工作：

1. 记录管理规范：
   - 病历资料要做到观察完整、检查清楚、内容准确、记录规范；
   - 微量制剂要按照制剂规范、制剂记录的要求来执行，确保制剂过程中药品数量和药品质量符合标准。
2. 重点项目监管管理规范：
   - 手术实施规范，手术室负责人要认真维护手术规范、操作规范、清洁卫生卫生管理要求；
   - 职业健康监测规范，审查进门材料，核实相关信息，拒绝登记哪些不符合要求，确保医疗安全；
   - 备货管理规范，对于高风险物品，必须要有较为完善的备货管理流程以留下证据。
3. 设备管理规范：
   - 非一次性跟踪器材要分类存放、细化管理，严格按照相应流程进行归还报废等。
   - 设备保养、维修人员要为确保数值准确、操作顺利和确保安全负责。