Tag规范

维护人：周敏

适用仓库：行政协同平台

生效：0000-00-00

当前生产标签：v1.2.4

批准人：张伟

一、目的

标签用来标记行政协同平台已经发布或准备发布的版本。生产现在运行 v1.2.4，服务总部 420 名员工的预订、请假、访客和用品。看到标签就能找到当时的代码、数据库说明和发布人。分支会继续前进，标签保持不动。

二、命名

1. 正式版本写成 v主号.次号.修订号，例如 v1.2.4。三位都是数字，不加字母前缀以外的字符。
2. 主号在对外承诺不兼容时加一。次号在有员工能感知的功能时加一。修订号只在修复时加一。
3. 预发候选写成 v1.3.0-rc.1，rc 序号从 1 递增。候选标签可以作废，正式标签打出后不再移动。
4. 标签说明写一行：日期、主要变化、发布人。例如「9月9日 访客二维码 周敏」。

三、打标权限

只有周敏和张伟可以在 main 或 release 上打正式标签。打标前 CI 为通过，且该提交已经在预发跑完王芳的检查单。刘洋可以打 rc 标签供预发使用，不能打不含 rc 的正式标签。打错的正式标签不删除，下一个修订号说明跳过原因，避免别人已经按旧标签部署。

四、近期标签

v1.2.2 由刘洋打标，发生在本规范生效前。生效后的正式标签只由周敏或张伟操作。v1.3.0-rc.1 只在预发，生产仍是 v1.2.4。

五、与部署的对应

生产部署必须填写标签名。周敏在发布单里写目标标签和上一标签。回滚时选上一正式标签重新部署，例如从 v1.2.4 回到 v1.2.3。rc 标签不能选作生产目标。陈静每月核对生产两台实例的版本与最新正式标签一致，9 月核对结果是两台都为 v1.2.4。核对时间是 9月10日 10:15，健康检查同时为通过。