From 699f19ce05b16ae53bbe899cdf407c28874add59 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Sat, 17 Oct 2026 09:28:52 +0800 Subject: [PATCH] =?UTF-8?q?docs(qa):=20=C2=A713=20=E6=B2=BB=E7=90=86?= =?UTF-8?q?=E9=97=AD=E7=8E=AF=E2=80=94=E2=80=94#33=20=E4=BB=A5=20fast-forw?= =?UTF-8?q?ard-only=20=E5=90=88=E5=85=A5=20dev?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 合并方式选 FF 而非 rebase:origin/dev 原 tip 8026d917 是 HEAD 的严格祖先 (merge-base --is-ancestor EXIT=0),FF 后 47 笔 sha 逐字不变、origin/dev = 6d46dbe8。 理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」的拓扑分叉之痛。分支未删。 - 422「[Do]: Required」要按字面读:这套 Gitea 的 merge 端点把表单字段 do 当必填, 补 {"do":"fast-forward-only"} 后 HTTP 200。不是权限、不是缺审批 (reviews=[]、mergeable=true、draft=false)。另 GET /pulls/n/merge 与 /branches/protection 在本实例 404 属端点不存在,不得当成「无保护」的证据。 - dev→main 不由代理执行:Jenkinsfile 的部署阶段带 when { branch 'main' }, 合 main = 授权一次无人值守的线上发布;生产侧字段与 navigation 行同形核对随发布做。 - 终版读数一览:tsc / type-check:e2e / check:package-keys / check:visual / check:dead / check:motion / build / check:axe / lighthouse 均 EXIT=0;jest 146 套件 1799 例 EXIT=0; 视觉逐名清单 125/125;GA4 16 passed。PR 描述门禁 checklist EXIT=0(31 子项)。 --- docs/acceptance/qa-tracker.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index 07f365b..a241e73 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -949,3 +949,14 @@ schema 落地后不能拿"之前绿过"当终版读数,故整链重跑(`docs ⇒ **不通过放宽断言或加 retry 来"修"**(那是把判据调瞎);如需本地稳定复现绿,编排上加 `--workers=1`, 并把这一条留给 CI 口径。登记为口径事实而非缺陷关闭。 + +--- + +## §13 治理闭环(2026-10-17):#33 以 fast-forward-only 合入 dev,dev→main 不由代理执行 + +| 项 | 读数 | +|---|---| +| **#33** | `worktree-ui-grammar-two-axis` → `dev`,**state=closed、merged_at 2026-10-17T09:27:55+08:00**。合并方式取 **fast-forward-only**:`origin/dev` 原 tip `8026d917` 是 HEAD 的严格祖先(`git merge-base --is-ancestor` EXIT=0),47 笔 sha **逐字不变**、`origin/dev` 现 = `6d46dbe8`。理由同 §10.9:本仓记过 rebase 造成「同标题异 hash」拓扑分叉之痛,FF 既保线性又保 sha 可引用。分支**未删**(`do_not_delete_branch=true`);删分支属独立动作 | +| **Gitea merge API 的一处口径**(踩过才记) | 首发 `POST /pulls/33/merge` 带 `{merge_style:"fast-forward-only", …}` ⇒ **HTTP 422 `"[Do]: Required"`**。那不是权限、不是缺审批(`GET /pulls/33/reviews` = `[]`,`mergeable=true`、`draft=false`),而是**这套 Gitea 版本的 merge 端点把表单字段 `do` 当必填**。补上 `{"do":"fast-forward-only", "merge_style":"fast-forward-only", …}` ⇒ **HTTP 200**。⇒ 422 的报文要按字面读,别翻译成「需要审批/我被授权不足」;另 `GET /pulls/{n}/merge`、`/branches/protection` 在本实例是 404(端点不存在),别把它当「无保护」的证据 | +| **为什么 dev→main 不由我执行** | 同 §10.9:`Jenkinsfile` 的「🚀 部署到生产环境」带 `when { branch 'main' }` ⇒ 合 main = 授权一次无人值守的线上发布。生产仍停在既有已验证发布,本批要在线上生效需决策人显式发起发布动作(含生产侧 `ContentModel.fields` 与 `navigation` 行的同形核对,见 §12.12、PR 未验证项②) | +| 本批终版门禁读数 | `tsc` 0、`type-check:e2e` 0、`check:package-keys` 0、`check:visual` 0、`check:dead` 0、`check:motion` 0、`jest` 146 套件/1799 例 0、`build` 0、`check:axe` 0、视觉逐名清单 125/125、GA4 16 passed、`lighthouse` 0、`test:all` 0(同条件复跑;首跑 1 已按 §12.13 三把读数归因) | -- 2.54.0