fix(admin): 管理端入口收敛到 /admin/ 子路径,staging 端口 13521,修复生产 /admin/ 假成功

承接 rc.15 的管理端端口收敛(3000 → 13520),本轮把「入口」也收敛到一处:

- staging admin 发布端口 3001 → 13521(保持「生产 + 1」错开),同步
  tests/uat/run-uat.sh 的默认 UAT_ADMIN_URL。
- 管理端产物改为 /admin/ 子路径部署:vite 构建 base=/admin/(dev 仍为 /,开发与
  排查习惯不变)、router history base 跟随 import.meta.env.BASE_URL、三处容器化
  入口(生产 nginx / 本地整套栈 nginx / admin-web 容器内 nginx)统一为「不剥离
  前缀」转发,形态一致。
- 修复生产 nginx /admin/ 的假成功:原为 alias /usr/share/nginx/html/,而那正是
  nginx:alpine 纯净镜像自带的默认页目录(管理端产物不在该容器内),访问返回
  200 + nginx 欢迎页 —— 浏览器不报错、状态码正常,只是打开的不是管理端,比 404
  更难发现。改为 upstream admin_web + proxy_pass,并以真实两跳容器实测:
  /admin/ → 200 且为管理端标题与 /admin/assets/*、/admin/dashboard → 200(SPA
  兜底)、/admin/brand/logo-mark.png → 200、根路径 → 显式 404(用 location = /
  钉住,不依赖「本配置恰好没有 server 级 root」这一偶然事实)。
- 品牌资源引用统一走新增的 src/brand.ts(public/ 资源不受 vite base 影响,原 5 处
  写死根路径,子路径部署下会裂图);favicon 由仓库内并不存在的 /favicon.svg 改为
  存在的品牌标。
- 补全 tests/uat/run-uat.sh 被截断的尾部:原文件停在 `if [ -`,bash -n 不通过、
  脚本根本无法运行;顺带把此前「定义了却无人消费」的 ADMIN_URL 接到管理端可达性
  实测上,并补结果汇总与非零退出码。
- ui-tests:ui-document-baseline-contracts 新增两类一致性断言(staging 发布端口 ⇄
  run-uat.sh 默认入口、子路径部署的五处约束);admin-reference-contracts 的资产
  断言适配 brand 模块(断言「组件经 brand 模块引用」+「brand 模块指向正式资产」)。
  6 条新增断言全部经负向注入验证(注入对应缺陷 → 守卫变红且信息指向正确对象)。

验证:UI 门控 14/14 绿;vue-tsc EXIT=0;vite build EXIT=0 且产物资源均为
/admin/ 前缀;三份 nginx 配置 nginx -t 通过。

注:docs/STATUS.md 含此前的在途文档改动(非本次工作,且其中引用了已被删除的
plans 文件),故未纳入本提交;本轮的口径更新已写入该文件待一并处理。
This commit is contained in:
WorkBuddy
2026-09-18 20:51:12 +08:00
parent 16538d7af5
commit f96dcb8aa6
14 changed files with 266 additions and 29 deletions
+39 -2
View File
@@ -6,7 +6,12 @@
set -euo pipefail
BASE_URL="${UAT_BASE_URL:-http://localhost:8080}"
ADMIN_URL="${UAT_ADMIN_URL:-http://localhost:3001}"
# 管理端 UAT 入口。
# 13521 = staging admin 容器发布端口(infrastructure/docker-compose.staging.yml),
# 按「生产 admin 端口 + 1」错开;/admin/ 是管理端产物的部署子路径
# (base 由 admin-web/vite.config.ts 决定)——根路径不提供服务,访问根会 301 到 /admin/。
# 此默认值由 ui-tests/ui-document-baseline-contracts.mjs 钉住,改端口时须两处同步。
ADMIN_URL="${UAT_ADMIN_URL:-http://localhost:13521/admin/}"
PLATFORM_URL="${UAT_PLATFORM_URL:-https://match.danyang.gov.cn}"
TOKEN_FILE="/tmp/uat_token.txt"
PASS=0
@@ -247,4 +252,36 @@ else
fi
# 5.2 备份文件存在
if [ -
# 备份由 infrastructure/scripts/backup.sh 产出(容器内 /app/backups,宿主机为 infrastructure/backups)。
if ls infrastructure/backups/*.sql.gz > /dev/null 2>&1; then
BACKUP_COUNT=$(ls -1 infrastructure/backups/*.sql.gz 2>/dev/null | wc -l | tr -d ' ')
log_result "数据库备份文件" "PASS" "发现 ${BACKUP_COUNT} 个备份"
else
log_result "数据库备份文件" "SKIP" "未发现备份文件(首次部署前正常)"
fi
# 5.3 管理端页面可达
# 2026-09-18 前 ${ADMIN_URL} 是个定义了却无人消费的常量 —— 端口/子路径改了、
# 脚本没同步,也不会有任何检查变红。此处把它接到实测上:
# 期望 200,且期望的是 `/admin/` 子路径(管理端产物 base 为 /admin/,访问根路径会 301)。
ADMIN_CODE=$(curl -s -o /dev/null -w "%{http_code}" "${ADMIN_URL}" 2>/dev/null || echo "000")
if [ "$ADMIN_CODE" = "200" ]; then
log_result "管理端页面可达" "PASS" "${ADMIN_URL}"
else
log_result "管理端页面可达" "FAIL" "${ADMIN_URL} → HTTP ${ADMIN_CODE}"
fi
echo ""
# ========================================
# 6. 结果汇总
# ========================================
echo "============================================"
echo " UAT 检查结果:PASS=${PASS} FAIL=${FAIL} SKIP=${SKIP}"
echo "============================================"
# 有 FAIL 时以非零退出:让 CI/人工调用方靠退出码就能发现,而不是必须滚屏找 ❌。
if [ "$FAIL" -gt 0 ]; then
exit 1
fi
exit 0