danyang-match/ui-tests/ui-document-baseline-contracts.mjs

import assert from 'node:assert/strict'
import { existsSync, readFileSync } from 'node:fs'
import { resolve } from 'node:path'

const root = resolve(import.meta.dirname, '..')
const read = (path) => readFileSync(resolve(root, path), 'utf8')
const spec = 'docs/superpowers/specs/2026-09-13-reference-driven-dual-client-ui-redesign-design.md'

const obsolete = [
  'docs/superpowers/specs/2026-09-10-ui-v11-fidelity-design.md',
  'docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md',
  'docs/superpowers/specs/2026-09-11-dual-client-full-ui-redesign-design.md',
  'docs/superpowers/plans/2026-09-10-ui-v11-fidelity.md',
  'docs/superpowers/plans/2026-09-11-codex-baseline-cleanup.md',
  'docs/superpowers/plans/2026-09-11-admin-full-ui-redesign.md',
  'docs/superpowers/plans/2026-09-11-miniapp-full-ui-redesign.md',
  'docs/superpowers/plans/2026-09-11-ui-foundation-and-pilot.md',
  'docs/UI-V11-Visual-Acceptance-2026-09-10.md',
  'docs/善缘丹阳 V1.1 前端 UI-UX 高保真原型修订说明.md',
  'design-qa.md',
  'artifacts/phase07-miniapp-home.png',
  'artifacts/phase07-miniapp-discover.png',
  'artifacts/phase07-home-comparison.png',
  'artifacts/phase07-discover-comparison.png',
  'artifacts/ui-v11/admin-counselor-1366.png',
  'artifacts/ui-v11/admin-dashboard-1440.png',
  'artifacts/ui-v11/admin-station-1366.png',
  'artifacts/ui-v11/miniapp-home-320.png',
  'artifacts/ui-v11/miniapp-home-375.png',
  'artifacts/ui-v11/miniapp-home-390.png',
  'artifacts/ui-v11/miniapp-home-430.png',
  'artifacts/ui-v11/miniapp-home-preview.html',
  'artifacts/tabbar-icons-preview.png',
  'ui-tests/admin-redesign-contracts.mjs',
  'ui-tests/miniapp-redesign-contracts.mjs',
]

const agents = read('AGENTS.md')
assert.ok(agents.includes(spec), 'AGENTS.md 未指向唯一视觉规格')
assert.doesNotMatch(agents, /善缘丹阳 V1\.1 前端 UI-UX 高保真原型修订说明\.md/, 'AGENTS.md 仍引用旧高保真规范')
for (const file of obsolete) {
  assert.equal(existsSync(resolve(root, file)), false, `旧视觉入口仍存在: ${file}`)
}

const status = read('docs/STATUS.md')
const backlog = read('docs/JIRA_BACKLOG.md')
const phase07 = read('docs/Phase-07-V11-Recovery-Completion-Report-2026-09-13.md')
const matrix = read('docs/UI_REDESIGN_PAGE_MATRIX_V1.1.md')

// —— 文档基线口径 ——
// UI 重设计首批 11 页已于 2026-09-16 通过用户验收（结论：基本达标）。
// 四份文档必须一致记录该结论。若有人把口径改回"视觉否决 / 待重新实现 / REOPENED"，
// 本门禁必须变红 —— 这是防止验收状态被静默回退的哨兵。
assert.match(status, /UI REDESIGN ACCEPTED BY USER/, 'STATUS 头部未记录 UI 已通过用户验收')
assert.match(status, /Phase 07[^\n]*已通过用户验收/, 'STATUS 未标记 Phase 07 UI 验收通过')

// JIRA 表格行必须已关闭；主表中的 REOPENED 不得复活（历史校正段落中的引用不算）。
assert.match(backlog, /^\|\s*Phase 07[^\n]*已通过用户验收/m, 'JIRA 未关闭 Phase 07 UI 条目')
assert.doesNotMatch(backlog, /^\|\s*Phase 07[^\n]*REOPENED/m, 'JIRA 主表仍将 Phase 07 UI 标记为 REOPENED')

// Phase 07 报告是历史文档：既要保留 2026-09-13 的失效判定，也要记录重新实现后的验收结论。
assert.match(phase07, /视觉结论已失效/, 'Phase 07 报告未保留 2026-09-13 历史判定')
assert.match(phase07, /首批 11 页于 2026-09-16 通过用户验收/, 'Phase 07 报告未记录重新实现后的验收结论')

assert.match(matrix, /小程序首批 11 个核心页面/, '页面矩阵未切换到当前首批范围')
assert.match(matrix, /2026-09-16 验收通过/, '页面矩阵未记录 11 页验收结论')
assert.doesNotMatch(matrix, /待重新实现|待开始/, '页面矩阵仍残留未完成状态')
assert.doesNotMatch(matrix, /63 个页面.*(全部|全量).*重构/, '页面矩阵仍要求本批全量重构')

// —— 管理端端口一致性（本地开发 / 文档 / 生产发布） ——
// 同一个端口写在三处：admin-web/vite.config.ts 是唯一权威，
// docs/STATUS.md 的「当前运行状态」是给人照做的，
// infrastructure/docker-compose.prod.yml 是生产 admin 容器的发布端口。
// 只改一处不会让任何测试变红，但会让照文档操作的人打不开页面，
// 或让本机直连排查打到错的端口 —— 属于本项目反复出现的「声明与兑现失联」同族问题，
// 因此用门控钉住。注意断言的是「几处一致」而非写死 13520：改端口是允许的，
// 允许的是「一起改」，不是「只改一处」。
// 前两处（vite / STATUS）是版本控制内的硬断言；第三处（生产 compose）只能
// 「存在才断言」，因为它被刻意排除在版本控制之外 —— 理由见下。
//
// 刻意不纳入守卫的另外两处「管理端入口」，它们是不同形态，不是同一端口的失联：
//   - infrastructure/docker-compose.yml：admin 容器不发布端口，管理端经 nginx 的 6688
//     与 /api 一起暴露（6688 是 nginx 入口端口，不是纯管理端端口）；
//   - infrastructure/docker-compose.staging.yml：staging 需与生产同机共存，
//     全部端口按「生产 + 1」错开（5433/6380/8081/3001），且 3001 被
//     tests/uat/run-uat.sh 的 UAT_ADMIN_URL 依赖。
// 改动这些入口时应同步其消费方，而不是让本守卫去断言它们等于 vite 端口。
const viteConfig = read('admin-web/vite.config.ts')
const vitePort = viteConfig.match(/^\s*port:\s*(\d+),/m)?.[1]
// 解析失败即失败：正则匹配不到时捕获组为 undefined，断言会退化成"与 undefined 比较"
// 而失去意义 —— 守卫静默失效是本项目踩过的坑。
assert.ok(vitePort, '未能从 admin-web/vite.config.ts 解析出 server.port（守卫自身失效）')

// 用 equal 而不是 match：match 失败会把整份文档打进报错里，
// 3000 行的噪声会盖掉真正的不一致信息。
const docPort = status.match(/管理后台:\s*http:\/\/localhost:(\d+)\//)?.[1]
assert.ok(docPort, 'docs/STATUS.md「当前运行状态」未声明管理后台地址（守卫自身失效）')
assert.equal(docPort, vitePort, `管理后台端口不一致：STATUS.md=${docPort}，vite.config.ts=${vitePort}`)

// 生产 compose 的 admin 发布端口。
// ⚠️ infrastructure/docker-compose.prod.yml 位于 .gitignore 的「Secrets and certificates」
// 段，刻意不进版本控制 —— 因此 CI（全新克隆）上这个文件根本不存在。若在这里硬 read()，
// 门控会在 CI 上抛 ENOENT 变成假红。故取「存在即断言、不存在则显式打印跳过」：
// 本机有它，本机就能拦住漂移；跳过时打印原因，不让它被误读成「已校验通过」。
const prodComposePath = 'infrastructure/docker-compose.prod.yml'
if (!existsSync(resolve(root, prodComposePath))) {
  console.log(`skip: ${prodComposePath} 不在版本控制内（CI 上不存在），跳过生产管理端端口校验`)
} else {
  // 先切出 admin-web 服务块（到下一个 2 空格缩进的服务名为止），
  // 再取块内唯一的带引号端口映射（形如 "127.0.0.1:13520:80"）。
  // 不直接写 /ports:\s*\n\s*-\s*"/ —— 端口上方允许有注释行，那样会匹配不到并让守卫误判为失效。
  const prodCompose = read(prodComposePath)
  const prodAdminBlock = prodCompose.match(
    /container_name:\s*danyang-match-admin\n([\s\S]*?)(?=\n {2}[a-z]|$)/,
  )?.[1]
  assert.ok(prodAdminBlock, '未能从 docker-compose.prod.yml 切出 admin-web 服务块（守卫自身失效）')
  const prodAdminMapping = prodAdminBlock.match(/-\s*"([^"]+)"/)?.[1]
  assert.ok(prodAdminMapping, '未能从 docker-compose.prod.yml 的 admin-web 解析出端口映射（守卫自身失效）')
  // "127.0.0.1:13520:80" → 主机端口取倒数第二段（兼容不带绑定地址的 "13520:80"）。
  const prodAdminPort = prodAdminMapping.split(':').at(-2)
  assert.equal(
    prodAdminPort,
    vitePort,
    `管理端端口不一致：docker-compose.prod.yml=${prodAdminPort}，vite.config.ts=${vitePort}`,
  )
}

console.log('UI document baseline contracts passed')