第一章 总则¶
第一条 制定依据
本章程依据《量潮科技基本章程》制定,旨在建立量潮云产品线的 DevOps 规范与发布纪律。
第二条 目的
为建立统一的版本发布流程,确保发布过程可追溯、可回滚、可审计,特制定本章程。
第三条 适用范围
本章程适用于量潮云(qtcloud)产品线所有数字资产的版本发布活动,包括代码库、文档站、数据档案等。
第四条 定义
(一)数字资产,指存储在 Git 仓库中的代码、文档、数据等所有受版本控制的内容。 (二)发布,指对数字资产创建可追溯的版本标识(Git tag)并推送至远程仓库,作为该资产的稳定基线。 (三)Patch 发布,指仅含 Bug 修复或微小变更的修订版本,不引入新功能。
第二章 发布流程¶
第五条 发布前置条件
每次发布前须完成以下前置检查:
(一)CHANGELOG 已更新至最新版本号,变更记录完整; (二)所有涉及本次发布的变更已提交并推送至远程仓库; (三)Git tag 已创建并推送。
第六条 发布步骤
发布应按以下步骤进行:
(一)更新 CHANGELOG,在 [Unreleased] 下方新增版本区块;
(二)提交 CHANGELOG 更新;
(三)创建语义化版本 Git tag;
(四)推送提交和 tag 至远程仓库。
第七条 发布后操作
发布完成后,须在 GitHub 上创建对应版本的 Release,Release 描述应与 CHANGELOG 对应内容一致。
第三章 发布纪律¶
第八条 CHANGELOG 先行
每次发布必须在创建 tag 之前先更新 CHANGELOG。禁止先打 tag 后补 CHANGELOG。
第九条 tag 与提交一致性
发布的 Git tag 必须指向包含 CHANGELOG 更新的提交。发布后不得对已推送的 tag 进行修改或删除。
第十条 父仓库指针更新
子模块发布后,须在父仓库(quanttide-tech → quanttide)中更新对应的子模块引用指针,提交并推送。父仓库指针的更新应视为发布流程的组成部分。
第十一条 发布记录可查
每次发布应在 GitHub Releases 页面上创建对应条目。禁止仅创建 Git tag 而不创建 Release。
第四章 版本规范¶
第十二条 版本号语义
版本号遵循语义化版本规范:主版本.次版本.修订号。发布前须根据变更类型确定版本号的递增方式。
第十三条 版本号递增规则
(一)修订号(Patch):Bug 修复、文档修正、配置调整等不改变接口的变更; (二)次版本(Minor):新增功能或内容,不破坏向后兼容性; (三)主版本(Major):不兼容的 API 变更、重大架构调整。
第五章 附则¶
第十四条 章程效力
本章程经公司治理机构审议通过,自发布之日起生效。
第十五条 解释权
本章程之解释,应遵循可追溯之基本原则。各项条文不得被解释为阻碍合理的发布流程创新或为发布设置不必要的障碍。