feat(gitea): 升 28.2.0 并把品牌装饰层纳管为可重跑的仓库真源 #62

Open
zhangxiang wants to merge 1 commits from feature/gitea-branding into dev
pull from: feature/gitea-branding
Owner

变更摘要

自建 Gitea(https://git.f.novalon.cn)从出厂外观换成「睿新致遠 / NOVALON」品牌,并顺路补上落后的两个安全版本。

  • 升级 1.27.2 → 28.2.0:1.27.3 含 16 条 SECURITY 修复,其中 fix(git): restrict hook permissions(#39008)打的正是本实例 8 月被入侵所用的 packObjectsHook 向量;28.x 另带审计日志(#38189)。28.0.0 的 git egress BREAKING 已按裁定收为 EGRESS_MODE=strict。
  • 装饰层入库为可重跑的仓库真源:infra/cicd/gitea-custom/(结构即实测 CustomPath=/data/gitea)+ infra/cicd/gitea/docker-compose.live.yml(生产编排的真实副本,此前只存在于服务器)。
  • 页头/OG/默认头像换简标与刻版、novalon-brand.css 覆盖 --color-primary 全色阶(浅 #C41E3A / 深 #E13C58)、custom/header.tmpl 外链注入、signin_inner.tmpl 登录页加字标锁定、导航加「官网」项、APP_NAME 去出厂串。
  • 纠正两处生产口径失真(详见 CONTEXT.md 与 docs/lessons-learned.md §5.52)。

零 src/** 改动:本轮全部落在 infra/、docs/ 与四份项目级文档。

关联 Issue

关闭:N/A

来源:本轮由「Gitea 能否按最新 logo 做自定义装饰」的口头需求直接展开,无对应 Issue;执行计划与判据见会话内批准的 plan 与 docs/acceptance/2026-10-22-gitea-branding/README.md。

提交前检查

硬性要求:提交 PR 前必须通过 bash scripts/check-pr-checklist.sh <本描述文件>,确保模板三节完整且所有 checklist 子项均已勾选。
不适用的子项仍须勾选并在行尾注明 N/A:<理由>;留空未勾选即视为门禁未过。

全链路检查

跨层变更(页面 ↔ 组件 ↔ CMS 内容模型 ↔ seed ↔ 测试)必须完成以下检查:

  • npm run type-check 通过(0 error)— 实测 TYPECHECK_EXIT=0(本树 tsc --noEmit 无输出)
  • npm run lint 通过:0 error,且 warning 数未新增(须与改动前基线逐行比对,不接受「本来就有一堆告警」)— 实测 LINT_EXIT=0、84 problems (0 errors, 84 warnings);本次未新增任何被 lint 覆盖的语言文件(新增物为 .sh/.py/.cjs/.md/.yml/.svg/.png,其中 .cjs 不在 eslint 项目配置范围内,已确认 lint 输出里无 infra/cicd/gitea-custom 条目)
  • 路由/链接真实:本次新增或改动的每个 href、Link 目标均已确认真实存在,无 href="#" 死链、无 404 死路 — 新增外链仅一枚 https://www.novalon.cn(域名口径取仓库内主用写法:实测 269 处 vs 裸域 60 处);模板内资源路径 /assets/img/*、/assets/css/novalon-brand.css 全部由 verify-branding.sh 按内容 sha256 断言为 200 且与仓库文件逐字节相等,不是「200 就算过」
  • 涉及 CMS 内容模型:字段定义与 seed 已同步 — N/A:零 src/** 与零 prisma/** 改动,未触达内容模型;不需要重跑 npm run db:seed
  • 涉及视觉/交互改动:已在浏览器上复核 — 是,但对象是 Gitea 而非本站:chrome-devtools 真实仿真 1440×900 @1x 与 375×812 @2x、浅/深两档,共 4 张取证图落 docs/acceptance/2026-10-22-gitea-branding/;本站 next dev 未涉及(无页面改动)
  • 暗黑模式:新增样式使用语义 token — N/A(本站语义令牌体系不适用于 Gitea);对应做法是在 Gitea 侧只重定义其自身令牌 --color-primary*,装饰 CSS 里除 #0D0D0D(按钮文字色,甲方裁定的「黑字朱底」)外不写死任何色值,且脚本对「蓝残留」判红
  • 动效合规 — N/A:未新增任何动效;装饰层只改颜色令牌与一条 #navbar 边框
  • 品牌红 #C41E3A:每页 ≥ 3 处触达点,覆盖面积 ≤ 10% — 登录页实测触达点 4 处(页头简标底、#navbar 朱砂条 3px、主按钮底色、链接与必填星号),朱砂为点缀非铺底;面积上限判据沿用品牌手册,本轮未做全站逐页统计(内部工具,非营销面)
  • 数字与宣称口径 — N/A:无对外数字与结果型宣称;本轮写入文档的数值(116 表 / 20 仓库 / 8 用户 / 61,402,034 B / 4.62:1 / 8s)全部是实测读数并附复算命令
  • 无遗留 console.log / TODO / FIXME / .only() — 新增脚本无;deploy-branding.sh 的打印是运维输出不是调试残留

测试分层检查(L0–L3)

参考 docs/testing.md 与 docs/testing-guide.md

  • L0 单元 — N/A:零 src/** 改动,无新增工具函数/Hook/CMS 渲染器。替代验证:build-brand-css.py 与 check-assets.py 各自内置「夹具对账 + 反向自证」,不通过就不写盘(详见下条)
  • L1 组件 — N/A:无 React 组件改动
  • L2 E2E — N/A:无本站用户路径改动。Gitea 侧的功能契约由 verify-branding.sh 断言:登录页表单 name="user_name" / name="password" / action= / type="submit" 四项必须在场(模板覆盖改坏会当场判红并自动回滚)
  • L3 视觉回归 — N/A:未触达 e2e/visual-snapshots,本站视觉基线 132 张与本轮无交集。Gitea 侧的「视觉回归」是 4 张真尺寸截图 + 计算样式探针(rgb(196,30,58) / rgb(225,60,88) / 3px / 字标 220×103 / 另一版 display:none)
  • 新增机械守卫测试均带正控制,杜绝「匹配零」的假绿 — 三台仪器各自带反向自证:①build-brand-css.py 先拿上游 14 档色阶做夹具对账(逐通道偏差 ≤1 才继续),再喂上游蓝要求「蓝残留」与「对比度不达标」双双判红(实测抓 50 + 2 处);②check-assets.py 造 4 个明知违规的样本(含 <text>、缺 viewBox、尺寸不符、清单文件缺失)要求全部判红,实测 4/4;③verify-branding.sh 每次跑都请求一个不存在的路径,必须 404,否则前面的比对全部作废
  • 已运行相关测试并全绿,无 .only() / 跳过态残留 — npm run test:unit、npm run check:contrast(44/44)实测通过;patch-compose.py / patch-app-ini.py 在生产文件的本地副本上跑过首次 / 幂等重跑 / 缺锚点负对照三态

质量门禁

  • npm run test:unit 全部通过 — 本树实测,输出见 PR 评论粘贴
  • npm run test:coverage 通过 coverageThreshold 且未下调阈值 — N/A:零 src/** 改动,覆盖率分母未变;阈值真源 config/test/jest.config.js 未被本次变更触及
  • npm run test(Playwright E2E)全部通过 — N/A:未改动任何被测页面;Gitea 侧的等价回归是真实 git 链路验证(HTTPS git ls-remote exit 0、SSH 2222 可达、EGRESS_MODE=strict 生效且启动日志无告警、升级后 healthz 200)
  • npm run check:contrast 与 npm run check:headings 通过(WCAG 2.1 AA)— check:contrast 实测 44/44 通过;check:headings N/A(无页面渲染变化)。Gitea 侧对比度单独量过:浅档 #C41E3A 三处 5.84:1 全过;深档按钮 #E13C58×#0D0D0D 4.62:1 过,深档链接 3.92:1 未达正文 AA,作为已登记让步保留(上游蓝同位 4.14,本就不达标;登记在 build-brand-css.py 的 DEVIATIONS,跌破下限即判红)
  • npm run lighthouse 满足 lhci 断言 — N/A:零前端产物变化(无 src/**、无 next.config.mjs、无 public/** 站点资产改动)
  • npm run test:security:headers 通过(若改动涉及响应头、CSP 或部署配置)— N/A:本站部署配置未改;Gitea 侧的部署配置确实改了,其影响面单独核过:升级后响应头仍无 CSP(与升级前一致,1.27.0 的 script-nonce 属可选启用),装饰层因此刻意只用外链 CSS、custom/header.tmpl 内不写内联样式,启用 CSP 后也不会被打断
  • 文档已同步:README.md / CONTEXT.md / CLAUDE.md 及 docs/ 下受影响文件 — 已改 5 份:README.md(进度 + CI/CD 节)、CONTEXT.md(「Gitea 品牌装饰层的口径」与「CI 生产口径的两处失真」两行)、CLAUDE.md(四条命令 + 授权提示)、docs/deployment/cicd/README.md(2026-10-22 一节,含架构图版本号)、docs/lessons-learned.md §5.52;新增 infra/cicd/gitea-custom/README.md 与 docs/acceptance/2026-10-22-gitea-branding/README.md;DESIGN.md / PRODUCT.md N/A(本轮不改设计令牌与产品口径,品牌色值沿用手册 §3 已裁定的两档)
  • 提交信息符合 Conventional Commits,且每个 commit 是可独立评审的垂直切片 — 单提交 feat(gitea): …,切片 = 「升级 + 装饰层 + 文档纠正」,三者不可分(装饰基准取自升级后的真实模板)
  • 破坏性/共享状态动作已单独取得授权,未夹带在常规变更里 — 已逐项取得:升级窗口与重启(会话内选定「现在就升」)、深档按钮改黑字朱底、EGRESS_MODE=strict、写入生产 CustomPath + chown + 重建、以及本轮的 worktree 提交与 PR;pg_dump 与探针库还原为只读/一次性动作,探针库用完即 DROP

假绿灯纪律

测试全绿 ≠ 功能可用。以下条目用于区分「验证过了」与「看起来验证过了」。

  • 门禁命令实际执行过并粘贴真实输出(失败口径如实记录)— 是。失败口径也如实记录:①首次部署时 13 项断言里「标题仍是出厂串」判红,脚本按当时的「任一红即回滚」把整套装饰撤了 → 事后把门禁分成核心/配置/仪器三档退出码,而不是把该项删掉;②GITEA__server__APP_NAME 与 GITEA__DEFAULT__APP_NAME 两条路都被实测证伪(后者被 environment-to-ini 写成字面 [default] 段,go-ini 不认),最终改为直写 app.ini 顶层;③备份验证脚本自身有三处坏点($$ 被 shell 展开、建库失败被 > /dev/null 吞成「0 errors」、docker cp 进 tmpfs 后 psql 找不到文件),修成「还原到探针库 + 表数与业务行数对账」后才拿到真结论
  • 未通过删测试、放宽断言、skip/todo、下调阈值等方式让门禁变绿 — 未删任何判据;唯一的粒度调整是把「标题未生效」从回滚触发项降级为独立退出码,其判据本身仍在且仍打印红因
  • 未把误报当问题「修掉」— 两处保留并写明理由:深档链接 3.92:1(真不达 AA,非误报,按「不比上游更差 + 达非文本 3:1」登记让步);docs/acceptance/qa-tracker.md 的在途改动属另一会话,未代为处置
  • 结论以 origin/* 与实测为准 — 生产事实全部取自 docker inspect 的 label 与挂载表、gitea help 的 CustomPath、容器内 gitea embedded extract 抽出的 28.2.0 原版模板;仓库里那份「加固版」compose 与运维文档的记载被实测证伪并已纠正(从未上线、REQUIRE_SIGNIN_VIEW 实际为 false、DB 大小 61MB 而非文档的 1.7MB)
  • UI 改动已人工复核关键与边界态;无法复核时明确写出「未验证项」而非沉默 — 未验证项三条,已写进 docs/acceptance/2026-10-22-gitea-branding/README.md:①登录后内页(仓库/issue/后台)未做浏览器取证(需真实口令,本轮不把凭据喂进自动化),装饰层对其生效是推断不是实测;②strict egress 的负对照未做(需造 mirror = 写生产数据);③/explore 匿名可浏览是否收口属策略裁定,本轮只登记

其他说明

  • 生产现状:gitea/gitea:28.2.0,装饰已上线,verify-branding.sh 13 项全绿 + 负对照通过。
  • 回滚路径:deploy-branding.sh 判红自动回滚;手动回滚命令与备份位置(/root/gitea-brand-backup-<TS>.tgz、/root/app.ini.bak-brand-<TS>、docker-compose.yml.bak-brand-<TS>、/root/gitea-pre28-*.sql)见 infra/cicd/gitea-custom/README.md。
  • 遗留(只登记未动,避免夹带):①REQUIRE_SIGNIN_VIEW=false 的匿名浏览面;②SSH_PORT=22 与宿主 2222:22 的克隆地址错配(改动影响所有人已存 remote);③docs/deployment/cicd/03-credential-incident.md 的明文口令 P0 仍未闭合,本轮未扩大也未修复,且预检用 root cat app.ini 时把 SECRET_KEY / INTERNAL_TOKEN / DB 口令带入了会话输出,建议按该文档流程轮换收口。
  • 需要评审者特别关注:深档按钮是「黑字朱底」,这是甲方在「单令牌双角色 ⇒ AA 区间为空(按钮白字 L≤0.1833 vs 链接 on 深底 L≥0.2362)」的实测结论下做的裁定,不是配色疏漏;改回白字需连带接受 4.21:1 的 AA 破口。

提交前执行:bash scripts/check-pr-checklist.sh 验证所有 checklist 子项已勾选。

## 变更摘要 自建 Gitea(`https://git.f.novalon.cn`)从出厂外观换成「睿新致遠 / NOVALON」品牌,并顺路补上落后的两个安全版本。 - **升级 `1.27.2 → 28.2.0`**:1.27.3 含 16 条 SECURITY 修复,其中 `fix(git): restrict hook permissions`(#39008)打的正是本实例 8 月被入侵所用的 `packObjectsHook` 向量;28.x 另带审计日志(#38189)。28.0.0 的 git egress BREAKING 已按裁定收为 `EGRESS_MODE=strict`。 - **装饰层入库为可重跑的仓库真源**:`infra/cicd/gitea-custom/`(结构即实测 `CustomPath=/data/gitea`)+ `infra/cicd/gitea/docker-compose.live.yml`(生产编排的真实副本,此前只存在于服务器)。 - 页头/OG/默认头像换简标与刻版、`novalon-brand.css` 覆盖 `--color-primary` 全色阶(浅 `#C41E3A` / 深 `#E13C58`)、`custom/header.tmpl` 外链注入、`signin_inner.tmpl` 登录页加字标锁定、导航加「官网」项、`APP_NAME` 去出厂串。 - **纠正两处生产口径失真**(详见 `CONTEXT.md` 与 `docs/lessons-learned.md` §5.52)。 零 `src/**` 改动:本轮全部落在 `infra/`、`docs/` 与四份项目级文档。 ## 关联 Issue 关闭:N/A > 来源:本轮由「Gitea 能否按最新 logo 做自定义装饰」的口头需求直接展开,无对应 Issue;执行计划与判据见会话内批准的 plan 与 `docs/acceptance/2026-10-22-gitea-branding/README.md`。 ## 提交前检查 > **硬性要求**:提交 PR 前必须通过 `bash scripts/check-pr-checklist.sh <本描述文件>`,确保模板三节完整且所有 checklist 子项均已勾选。 > 不适用的子项**仍须勾选**并在行尾注明 `N/A:<理由>`;留空未勾选即视为门禁未过。 ## 全链路检查 跨层变更(页面 ↔ 组件 ↔ CMS 内容模型 ↔ seed ↔ 测试)必须完成以下检查: - [x] `npm run type-check` 通过(0 error)— 实测 `TYPECHECK_EXIT=0`(本树 `tsc --noEmit` 无输出) - [x] `npm run lint` 通过:0 error,且 warning 数未新增(须与改动前基线逐行比对,不接受「本来就有一堆告警」)— 实测 `LINT_EXIT=0`、`84 problems (0 errors, 84 warnings)`;本次未新增任何被 lint 覆盖的语言文件(新增物为 `.sh/.py/.cjs/.md/.yml/.svg/.png`,其中 `.cjs` 不在 eslint 项目配置范围内,已确认 lint 输出里无 `infra/cicd/gitea-custom` 条目) - [x] 路由/链接真实:本次新增或改动的每个 `href`、`Link` 目标均已确认真实存在,无 `href="#"` 死链、无 404 死路 — 新增外链仅一枚 `https://www.novalon.cn`(域名口径取仓库内主用写法:实测 269 处 vs 裸域 60 处);模板内资源路径 `/assets/img/*`、`/assets/css/novalon-brand.css` 全部由 `verify-branding.sh` 按**内容 sha256** 断言为 200 且与仓库文件逐字节相等,不是「200 就算过」 - [x] 涉及 CMS 内容模型:字段定义与 seed 已同步 — N/A:零 `src/**` 与零 `prisma/**` 改动,未触达内容模型;**不需要**重跑 `npm run db:seed` - [x] 涉及视觉/交互改动:已在浏览器上复核 — 是,但对象是 Gitea 而非本站:chrome-devtools 真实仿真 1440×900 @1x 与 375×812 @2x、浅/深两档,共 4 张取证图落 `docs/acceptance/2026-10-22-gitea-branding/`;本站 `next dev` 未涉及(无页面改动) - [x] 暗黑模式:新增样式使用语义 token — N/A(本站语义令牌体系不适用于 Gitea);对应做法是在 Gitea 侧只重定义其自身令牌 `--color-primary*`,装饰 CSS 里除 `#0D0D0D`(按钮文字色,甲方裁定的「黑字朱底」)外不写死任何色值,且脚本对「蓝残留」判红 - [x] 动效合规 — N/A:未新增任何动效;装饰层只改颜色令牌与一条 `#navbar` 边框 - [x] 品牌红 `#C41E3A`:每页 ≥ 3 处触达点,覆盖面积 ≤ 10% — 登录页实测触达点 4 处(页头简标底、`#navbar` 朱砂条 3px、主按钮底色、链接与必填星号),朱砂为点缀非铺底;面积上限判据沿用品牌手册,本轮未做全站逐页统计(内部工具,非营销面) - [x] 数字与宣称口径 — N/A:无对外数字与结果型宣称;本轮写入文档的数值(116 表 / 20 仓库 / 8 用户 / 61,402,034 B / 4.62:1 / 8s)全部是实测读数并附复算命令 - [x] 无遗留 `console.log` / `TODO` / `FIXME` / `.only()` — 新增脚本无;`deploy-branding.sh` 的打印是运维输出不是调试残留 ## 测试分层检查(L0–L3) > 参考 `docs/testing.md` 与 `docs/testing-guide.md` - [x] **L0 单元** — N/A:零 `src/**` 改动,无新增工具函数/Hook/CMS 渲染器。替代验证:`build-brand-css.py` 与 `check-assets.py` 各自内置「夹具对账 + 反向自证」,不通过就不写盘(详见下条) - [x] **L1 组件** — N/A:无 React 组件改动 - [x] **L2 E2E** — N/A:无本站用户路径改动。Gitea 侧的功能契约由 `verify-branding.sh` 断言:登录页表单 `name="user_name"` / `name="password"` / `action=` / `type="submit"` 四项必须在场(模板覆盖改坏会当场判红并自动回滚) - [x] **L3 视觉回归** — N/A:未触达 `e2e/visual-snapshots`,本站视觉基线 132 张与本轮无交集。Gitea 侧的「视觉回归」是 4 张真尺寸截图 + 计算样式探针(`rgb(196,30,58)` / `rgb(225,60,88)` / `3px` / 字标 220×103 / 另一版 `display:none`) - [x] 新增机械守卫测试均带**正控制**,杜绝「匹配零」的假绿 — 三台仪器各自带反向自证:①`build-brand-css.py` 先拿上游 14 档色阶做夹具对账(逐通道偏差 ≤1 才继续),再**喂上游蓝**要求「蓝残留」与「对比度不达标」双双判红(实测抓 50 + 2 处);②`check-assets.py` 造 4 个明知违规的样本(含 `<text>`、缺 viewBox、尺寸不符、清单文件缺失)要求全部判红,实测 4/4;③`verify-branding.sh` 每次跑都请求一个不存在的路径,必须 404,否则前面的比对全部作废 - [x] 已运行相关测试并全绿,无 `.only()` / 跳过态残留 — `npm run test:unit`、`npm run check:contrast`(44/44)实测通过;`patch-compose.py` / `patch-app-ini.py` 在**生产文件的本地副本**上跑过首次 / 幂等重跑 / 缺锚点负对照三态 ## 质量门禁 - [x] `npm run test:unit` 全部通过 — 本树实测,输出见 PR 评论粘贴 - [x] `npm run test:coverage` 通过 `coverageThreshold` 且未下调阈值 — N/A:零 `src/**` 改动,覆盖率分母未变;阈值真源 `config/test/jest.config.js` 未被本次变更触及 - [x] `npm run test`(Playwright E2E)全部通过 — N/A:未改动任何被测页面;Gitea 侧的等价回归是真实 git 链路验证(HTTPS `git ls-remote` exit 0、SSH 2222 可达、`EGRESS_MODE=strict` 生效且启动日志无告警、升级后 healthz 200) - [x] `npm run check:contrast` 与 `npm run check:headings` 通过(WCAG 2.1 AA)— `check:contrast` 实测 44/44 通过;`check:headings` N/A(无页面渲染变化)。Gitea 侧对比度单独量过:浅档 `#C41E3A` 三处 5.84:1 全过;深档按钮 `#E13C58`×`#0D0D0D` 4.62:1 过,**深档链接 3.92:1 未达正文 AA,作为已登记让步保留**(上游蓝同位 4.14,本就不达标;登记在 `build-brand-css.py` 的 `DEVIATIONS`,跌破下限即判红) - [x] `npm run lighthouse` 满足 `lhci` 断言 — N/A:零前端产物变化(无 `src/**`、无 `next.config.mjs`、无 `public/**` 站点资产改动) - [x] `npm run test:security:headers` 通过(若改动涉及响应头、CSP 或部署配置)— N/A:本站部署配置未改;**Gitea 侧的部署配置确实改了**,其影响面单独核过:升级后响应头仍无 CSP(与升级前一致,1.27.0 的 script-nonce 属可选启用),装饰层因此刻意只用外链 CSS、`custom/header.tmpl` 内不写内联样式,启用 CSP 后也不会被打断 - [x] 文档已同步:`README.md` / `CONTEXT.md` / `CLAUDE.md` 及 `docs/` 下受影响文件 — 已改 5 份:`README.md`(进度 + CI/CD 节)、`CONTEXT.md`(「Gitea 品牌装饰层的口径」与「CI 生产口径的两处失真」两行)、`CLAUDE.md`(四条命令 + 授权提示)、`docs/deployment/cicd/README.md`(2026-10-22 一节,含架构图版本号)、`docs/lessons-learned.md` §5.52;新增 `infra/cicd/gitea-custom/README.md` 与 `docs/acceptance/2026-10-22-gitea-branding/README.md`;`DESIGN.md` / `PRODUCT.md` N/A(本轮不改设计令牌与产品口径,品牌色值沿用手册 §3 已裁定的两档) - [x] 提交信息符合 Conventional Commits,且每个 commit 是可独立评审的垂直切片 — 单提交 `feat(gitea): …`,切片 = 「升级 + 装饰层 + 文档纠正」,三者不可分(装饰基准取自升级后的真实模板) - [x] 破坏性/共享状态动作已单独取得授权,未夹带在常规变更里 — 已逐项取得:升级窗口与重启(会话内选定「现在就升」)、深档按钮改黑字朱底、`EGRESS_MODE=strict`、写入生产 `CustomPath` + `chown` + 重建、以及本轮的 worktree 提交与 PR;`pg_dump` 与探针库还原为只读/一次性动作,探针库用完即 `DROP` ## 假绿灯纪律 > 测试全绿 ≠ 功能可用。以下条目用于区分「验证过了」与「看起来验证过了」。 - [x] 门禁命令**实际执行过**并粘贴真实输出(失败口径如实记录)— 是。失败口径也如实记录:①首次部署时 13 项断言里「标题仍是出厂串」判红,脚本按当时的「任一红即回滚」把整套装饰撤了 → 事后把门禁分成核心/配置/仪器三档退出码,而不是把该项删掉;②`GITEA__server__APP_NAME` 与 `GITEA__DEFAULT__APP_NAME` 两条路都被实测证伪(后者被 environment-to-ini 写成字面 `[default]` 段,go-ini 不认),最终改为直写 app.ini 顶层;③备份验证脚本自身有三处坏点(`$$` 被 shell 展开、建库失败被 `> /dev/null` 吞成「0 errors」、`docker cp` 进 tmpfs 后 psql 找不到文件),修成「还原到探针库 + 表数与业务行数对账」后才拿到真结论 - [x] 未通过删测试、放宽断言、`skip`/`todo`、下调阈值等方式让门禁变绿 — 未删任何判据;唯一的粒度调整是把「标题未生效」从回滚触发项降级为独立退出码,其判据本身仍在且仍打印红因 - [x] 未把误报当问题「修掉」— 两处保留并写明理由:深档链接 3.92:1(真不达 AA,非误报,按「不比上游更差 + 达非文本 3:1」登记让步);`docs/acceptance/qa-tracker.md` 的在途改动属另一会话,未代为处置 - [x] 结论以 `origin/*` 与实测为准 — 生产事实全部取自 `docker inspect` 的 label 与挂载表、`gitea help` 的 `CustomPath`、容器内 `gitea embedded extract` 抽出的 28.2.0 原版模板;**仓库里那份「加固版」compose 与运维文档的记载被实测证伪并已纠正**(从未上线、`REQUIRE_SIGNIN_VIEW` 实际为 false、DB 大小 61MB 而非文档的 1.7MB) - [x] UI 改动已人工复核关键与边界态;无法复核时明确写出「未验证项」而非沉默 — 未验证项三条,已写进 `docs/acceptance/2026-10-22-gitea-branding/README.md`:①登录后内页(仓库/issue/后台)未做浏览器取证(需真实口令,本轮不把凭据喂进自动化),装饰层对其生效是**推断不是实测**;②strict egress 的负对照未做(需造 mirror = 写生产数据);③`/explore` 匿名可浏览是否收口属策略裁定,本轮只登记 ## 其他说明 - 生产现状:`gitea/gitea:28.2.0`,装饰已上线,`verify-branding.sh` 13 项全绿 + 负对照通过。 - 回滚路径:`deploy-branding.sh` 判红自动回滚;手动回滚命令与备份位置(`/root/gitea-brand-backup-<TS>.tgz`、`/root/app.ini.bak-brand-<TS>`、`docker-compose.yml.bak-brand-<TS>`、`/root/gitea-pre28-*.sql`)见 `infra/cicd/gitea-custom/README.md`。 - 遗留(只登记未动,避免夹带):①`REQUIRE_SIGNIN_VIEW=false` 的匿名浏览面;②`SSH_PORT=22` 与宿主 `2222:22` 的克隆地址错配(改动影响所有人已存 remote);③`docs/deployment/cicd/03-credential-incident.md` 的明文口令 P0 仍未闭合,本轮未扩大也未修复,且预检用 root `cat` app.ini 时把 `SECRET_KEY` / `INTERNAL_TOKEN` / DB 口令带入了会话输出,建议按该文档流程轮换收口。 - 需要评审者特别关注:**深档按钮是「黑字朱底」**,这是甲方在「单令牌双角色 ⇒ AA 区间为空(按钮白字 L≤0.1833 vs 链接 on 深底 L≥0.2362)」的实测结论下做的裁定,不是配色疏漏;改回白字需连带接受 4.21:1 的 AA 破口。 > **提交前执行**:`bash scripts/check-pr-checklist.sh` 验证所有 checklist 子项已勾选。
zhangxiang added 1 commit 2026-10-22 18:57:35 +08:00
自建 Gitea 此前是出厂外观(茶杯标 + 「Gitea: Git with a cup of tea」标题),而品牌「纯字标 + 朱砂条」已在官网落地;同时现网 1.27.2
  落后两个安全版本 —— 1.27.3 的 fix(git): restrict hook permissions 打的正是本实例 8 月被入侵所用的 packObjectsHook
  向量。装饰基准取自升级后从容器抽出的真实模板,不凭记忆手写。

- 升级 28.2.0:pg_dump 后还原到一次性探针库对账(116 表 / 20 仓库 / 8 用户全等),停服 8s;28.0.0 的 git egress BREAKING
  按裁定收为 EGRESS_MODE=strict(实测 app.ini 无旧 ALLOWED_* 键、mirror 仓库 0 个 ⇒ 空白名单不伤业务)。

- 装饰层真源入库 infra/cicd/gitea-custom/(结构即实测 CustomPath=/data/gitea):页头/OG/默认头像换简标与刻版、novalon-
  brand.css 覆盖 --color-primary 全色阶、custom/header.tmpl 外链注入、signin_inner.tmpl
  登录页加字标锁定(220×103)。

- 色阶由脚本生成并自带夹具:先对上游 14 档对账(light/dark 两档 ramp 命名互为反向,手敲必错),再喂上游蓝做反向自证,双双通过才写盘。

- 深档按钮改「黑字朱底」:Gitea 用同一令牌既当按钮底色又当链接文字色,AA 区间为空(按钮白字 L≤0.1833 vs 链接 on #1e1f20 L≥0.2362)⇒ #E13C58
  × #0D0D0D 实测 4.62:1;深档链接 3.92:1 作为已登记让步保留(上游蓝同位 4.14,本就不达标)。

- deploy/verify 带预检、备份、内容 sha256 比对、负对照与 0/1/2/3 退出码分档,核心判红自动回滚(首轮就靠它把「标题未生效」与「装饰未生效」区分开)。

- 纠正两处生产口径失真:仓库那份「加固版」compose 从未上线(真实文件纳管为 infra/cicd/gitea/docker-compose.live.yml);生产
  REQUIRE_SIGNIN_VIEW 实为 false,且 compose 的 DISABLE_REGISTRATION=false 会经 environment-to-ini
  在重建时静默打开注册 —— 已对齐为 true。遗留的匿名浏览面与 SSH_PORT 错配只登记不擅动。
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feature/gitea-branding:feature/gitea-branding
git checkout feature/gitea-branding
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novalon/novalon-website#62