WorkBuddy
9c26d4b7b2
本机长期并行运行三个项目（videoos / ai-callcenter / 本项目），3000 属最易被 抢用的端口之一。按用户决定改为 13520。 - admin-web/vite.config.ts：server.port 3000 → 13520 - 同处新增 strictPort: true。vite 默认在端口被占用时静默 +1 退到下一个可用端口， 结果是「文档写 13520、实际跑在 13521」且全程不报错 —— 与本项目反复处理的 「声明与兑现失联」同族。加上后端口被占用会直接失败。 - docs/STATUS.md「当前运行状态」同步为 13520。 - ui-tests/ui-document-baseline-contracts.mjs：新增端口一致性守卫。 端口写在两处（vite.config.ts 是权威，STATUS.md 给人照做），只改一处不会让任何 测试变红，却会让照文档操作的人打不开页面。守卫断言的是「两处一致」而非写死 13520 —— 允许改端口，允许的是「一起改」，不是「只改一处」。 两处解析均用「解析失败即失败」写法，避免正则匹配不到时断言退化成与 undefined 比较而失去意义（本项目踩过的守卫静默失效坑）。 用 assert.equal 而非 assert.match：match 失败会把整份 STATUS.md（3000+ 行） 打进报错，噪声会盖掉真正的不一致信息 —— 负向验证时实测确认。 - .gitignore：忽略 admin-web/vite.config.ts.timestamp-*.mjs。 vite 在 dev server 被强杀（未优雅退出）时遗留该配置临时文件，本机已多次出现。 未改动（有意）： - CORS 不受影响。CorsConfig 默认拒绝所有跨域是刻意设计，且注释已写明「管理端走 Vite 代理（同源）」—— dev 端口变化不产生跨域。 - infrastructure/docker-compose.prod.yml 的 127.0.0.1:3000:80 是生产 admin 容器 的发布端口，与开发服务器无关，未动。 - releases/v1.0.0-RC.* 内的 3000 为历史发布快照，属冻结记录，不改写。 验证 - UI 契约门控 14/14 全绿（含新增守卫）；vue-tsc --noEmit EXIT=0。 - 负向验证：把 STATUS.md 改回 3000 → 守卫变红并精确报出 「管理后台端口不一致：STATUS.md=3000，vite.config.ts=13520」及行号；还原后复绿。 - 真实启停：dev server 实跑 http://localhost:13520/（HTTP 200），旧端口 3000 无监听。 - strictPort 负向验证：端口被占用时第二实例立即以 「Error: Port 13520 is already in use」退出，未漂移到 13521。 - vite build EXIT=0（19.35s）。 注：vite build 直接执行会失败，栈停在 emptyDir(dist) 且全部位于本机 node-safe-delete-shim（批量删除守卫）内，与本次改动无关；改用全新 outDir 复跑即 成功，据此排除「改动导致构建失败」。该现象此前无记录，已写入技能备查。
89 lines
5.3 KiB
JavaScript
89 lines
5.3 KiB
JavaScript
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 的「当前运行状态」是给人照做的。只改一处不会让任何测试变红，
|
||
// 但会让照文档操作的人打不开页面 —— 属于本项目反复出现的「声明与兑现失联」同族问题，
|
||
// 因此用门控钉住。注意断言的是「两处一致」而非写死 13520：改端口是允许的，
|
||
// 允许的是「一起改」，不是「只改一处」。
|
||
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}`)
|
||
|
||
console.log('UI document baseline contracts passed')
|