From aa801a3e18f74214038085326fcc74e1e6cc71df Mon Sep 17 00:00:00 2001
From: chenhang <averych@126.com>
Date: Thu, 16 Jul 2026 16:31:01 +0800
Subject: [PATCH] ci(docker): bypass quality gate on test

---
 .gitea/workflows/docker-image.yml | 8 ++++++++
 docs/docker-image-ci.md           | 6 +++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/.gitea/workflows/docker-image.yml b/.gitea/workflows/docker-image.yml
index fef715cc..90fa1d8d 100644
--- a/.gitea/workflows/docker-image.yml
+++ b/.gitea/workflows/docker-image.yml
@@ -18,16 +18,24 @@ jobs:
       SENTRY_UPLOAD_SOURCEMAPS: "0"
 
     steps:
+      - name: Skip quality gate for test branch
+        if: ${{ github.ref == 'refs/heads/test' }}
+        run: echo "Quality gate is disabled for the test branch."
+
       - name: Checkout
+        if: ${{ github.ref != 'refs/heads/test' }}
         uses: actions/checkout@v4
 
       - name: Install dependencies
+        if: ${{ github.ref != 'refs/heads/test' }}
         run: pnpm install --frozen-lockfile
 
       - name: Run quality checks
+        if: ${{ github.ref != 'refs/heads/test' }}
         run: pnpm quality
 
       - name: Enforce bundle budgets
+        if: ${{ github.ref != 'refs/heads/test' }}
         run: pnpm perf:bundle:check
 
   publish:
diff --git a/docs/docker-image-ci.md b/docs/docker-image-ci.md
index 87d932a0..5765b8f2 100644
--- a/docs/docker-image-ci.md
+++ b/docs/docker-image-ci.md
@@ -11,7 +11,11 @@
 | `.gitea/workflows/ci.yml` | `dev`、`main`、`test` push / PR | 安装依赖、Lint、单元测试、Next.js 构建 |
 | `.gitea/workflows/docker-image.yml` | `main`、`test` push / 手动触发 | 构建 Docker 镜像、推送到镜像仓库，并通过 SSH 部署 |
 
-这样可以避免所有开发分支都发布镜像，也能让代码检查失败时不污染镜像仓库。
+这样可以避免所有开发分支都发布镜像，并确保生产镜像通过发布门禁。
+
+`main` 分支发布前会执行 Docker workflow 内的质量和 bundle 门禁。`test`
+分支为快速部署测试环境，会跳过该门禁；独立的 `ci.yml` 仍会照常执行测试分支检查，
+但不会阻塞测试镜像构建与部署。
 
 ## 必需 Secrets