CI说明

维护人：周敏

适用仓库：行政协同平台

生效：0000-00-00

最近一次主干：通过，用时 20 分钟

一、流水线范围

本文说明行政协同平台在合并和打标前自动跑的检查。仓库对应总部正在使用的预订、请假、访客和用品。每次推送到 feature、main 和 release 都会触发。spike 分支只跑编译和单元测试，节省时间。流水线通过是合并进 main 的条件之一。

二、阶段与门槛

接口测试使用预发数据库的只读账号加一套可回滚的申领数据，跑完删除本次单号。它不连接生产。依赖核对若发现高优先级版本差异，流水线标红，中低优先级只警告，不挡住合并。

三、近期结果

9月20日 main 的一次完整流水线从 09:12 跑到 09:32，五段都通过。单元测试 1,240 条失败 0。接口测试 46 条失败 0。依赖核对有 1 条低优先级许可证提醒，未挡住。feature/supply-hold 在 9月27日失败于接口测试的并发预占，刘洋修复前该请求不能合并。

四、失败时

1. 编译或单元测试失败：作者当天修复，流水线重新跑。
2. 接口测试失败：王芳看用例日志，区分产品缺陷和用例过期。用例过期由王芳改，产品缺陷由作者改。
3. 打包失败：周敏先看磁盘和仓库凭证。凭证问题由她轮换，其他问题退回作者。
4. 连续 3 次基础设施失败，周敏在群里说明，这段时间合并可以经张伟同意后用本地通过的测试结果暂代，次日补跑流水线。

五、维护

周敏每季度看一次耗时。若总时长超过 30 分钟，优先并行单元测试和依赖核对。新增门槛由张伟批准后写进本说明再生效。9 月共跑主干构建 22 次，通过 21 次，总时长中位数 20 分钟，最短 18 分钟，最长 24 分钟，出现在 9月18日接口测试重试了 1 次的那次构建。目前尚未触及 30 分钟的调整线。