guanlan-src/app_frontEnd/web/tools/render_parity.mjs

/**
 * 呈现对拍（P11）· 多页签版：把**重构前的页面**与**Vue 迁移后的组件**放在同一份数据上比一遍。
 *
 * 口径（实逮决定）：
 *  · `/detail/v2` 是浏览器里现渲的单页（HTML 只有壳 + 内联 app.js/charts.js + 语言包，无 window.__DATA__）
 *    ⇒ 基线必须**让旧代码真跑一遍**：jsdom 加载现网页面，并在 **beforeParse** 装 fetch 桩转发到真实网关
 *    （桩晚装一句，旧页面就 `fetch is not defined`，基线全空）。
 *  · 页签由 hash 决定（`#tab=energy`）⇒ 基线按同一 hash 加载，两边渲染同页签。
 *  · Vue 侧用**同一份数据**（fetch 桩记录下的 /api/fleet 响应）经 SSR 渲成 HTML。
 *  · 比对：
 *      ① 文本序列（`#root` 下所有文本节点，按 DOM 顺序、空白归一）—— 结构 + 文案一致；
 *      ② 表格单元格文本（逐表、逐行）；
 *      ③ **图表数据**：旧页面内联 SVG 里的数字 vs Vue 侧 ECharts option 里 `__data__` 的数字
 *         （视觉实现不同是用户令「引入 ECharts」的结果，**数据必须同源**）。
 *
 * 用法：node tools/render_parity.mjs [gateway] [tab1] [tab2] ...
 * 退出码：0 全一致 · 9 有不一致 · 2 基准页取不到。
 */
import { fileURLToPath, pathToFileURL } from 'node:url'
import { dirname, resolve } from 'node:path'
import { JSDOM, VirtualConsole } from 'jsdom'

const HERE = dirname(fileURLToPath(import.meta.url))
const GATEWAY = process.argv[2] || 'http://127.0.0.1:28084'
const TABS = process.argv.slice(3).length ? process.argv.slice(3) : ['overview', 'energy', 'component', 'fault']

/**
 * 显式前置条件：把 `/api/curves` 追到**出图**那一份为止（首次常是 building）。
 * 追不到就抛错 —— 宁可报错，也不要让"骨架屏 vs 出图"把对拍结果搞成不可复现。
 */
async function awaitCurves(tries = 20, gapMs = 3000) {
  for (let k = 0; k < tries; k++) {
    const r = await fetch(GATEWAY + '/detail/api/curves')
    if (!r.ok) throw new Error(`/api/curves ${r.status}`)
    const j = await r.json()
    if (!j.building && (j.figs || []).length) return j
    await new Promise((r2) => setTimeout(r2, gapMs))
  }
  throw new Error('等 /api/curves 出图超时（仍是 building/无 figs）—— 先让服务端把曲线算完再对拍')
}

/** 取一份 /api/fleet —— 对拍两侧**共用这一份**（先取后喂，避免"页面缓存数据 vs 新取数据"的版本错位）。 */
async function fleetData(win = '') {
  const url = GATEWAY + '/detail/api/fleet' + (win ? `?win=${encodeURIComponent(win)}` : '')
  const r = await fetch(url)
  if (!r.ok) throw new Error(`取数失败 ${r.status} ${url}`)
  return await r.json()
}

/**
 * 给 jsdom 装 fetch 桩：
 *   · `/api/fleet` **一律返回 state.fleet**（加载页面前我们自己取好的那一份）—— 保证"旧页面"与"Vue"
 *     渲染的是同一份数据（实逮：页面有 pending 轮询，桩若记录"最后一次"响应，两边数据版本会不同，
 *     于是把"数据错位"误判成"文案不一致"）；
 *   · 其余请求照常转发到真实网关。
 */
function installFetch(window, state) {
  window.fetch = async (input, init) => {
    const raw = typeof input === 'string' ? input : (input && input.url) || String(input)
    const url = raw.startsWith('http') ? raw : GATEWAY + (raw.startsWith('/') ? raw : '/' + raw)
    if (url.includes('/api/curves')) {
      // 数据源已在 baseline() 里前置取好（awaitCurves）；这里只负责回放，保证两侧同源
      if (!state.curves) {
        const r2 = await fetch(url, init)
        state.curves = JSON.parse(await r2.text())
        state.curvesRaw = JSON.stringify(state.curves)
      }
      const body = state.curvesRaw
      return { ok: true, status: 200, headers: { get: () => 'application/json' },
               json: async () => JSON.parse(body), text: async () => body }
    }
    if (url.includes('/api/vibcms')) {
      if (!state.cms) {                         // ★ 与 fleet 同理：只认第一次拿到的
        const r1 = await fetch(url, init)
        state.cms = JSON.parse(await r1.text())
        state.cmsRaw = JSON.stringify(state.cms)
      }
      const body = state.cmsRaw
      return { ok: true, status: 200, headers: { get: () => 'application/json' },
               json: async () => JSON.parse(body), text: async () => body }
    }
    if (url.includes('/api/fleet')) {
      if (!state.fleet) {                       // ★ 只认**第一次**（页面 pending 轮询会再取，那是另一份）
        const r0 = await fetch(url, init)
        state.fleet = JSON.parse(await r0.text())
        state.fleetRaw = JSON.stringify(state.fleet)
      }
      const body = state.fleetRaw
      return { ok: true, status: 200, headers: { get: () => 'application/json' },
               json: async () => JSON.parse(body), text: async () => body }
    }
    const resp = await fetch(url, init)
    const body = await resp.text()
    return {
      ok: resp.ok, status: resp.status,
      headers: { get: (k) => resp.headers.get(k) },
      json: async () => JSON.parse(body), text: async () => body,
    }
  }
}

const norm = (s) => String(s).replace(/\s+/g, ' ').trim()

/** 文本节点序列（跳过画布/SVG —— 图形由"图表数据"那一项比）。 */
function textsIn(root) {
  const out = []
  const walk = (n) => {
    for (const c of n.childNodes) {
      if (c.nodeType === 3) {
        const s = norm(c.textContent)
        if (s) out.push(s)
      } else if (c.nodeType === 1) {
        const tag = c.tagName.toLowerCase()
        if (tag === 'canvas' || tag === 'svg' || tag === 'script' || tag === 'style') continue
        walk(c)
      }
    }
  }
  walk(root)
  return out
}

/** 表格：每张表的行×单元格文本。 */
function tablesIn(root) {
  return Array.from(root.querySelectorAll('table')).map((tb) =>
    Array.from(tb.querySelectorAll('tr')).map((tr) =>
      Array.from(tr.querySelectorAll('th,td')).map((c) => norm(c.textContent))))
}

/** 旧页面图表里的数字（内联 SVG 文本里的数值）。 */
function svgNumbers(root) {
  const out = []
  for (const t of Array.from(root.querySelectorAll('svg text'))) {
    for (const m of norm(t.textContent).matchAll(/-?\d[\d,]*(?:\.\d+)?/g)) out.push(m[0].replace(/,/g, ''))
  }
  return out
}

/** Vue 侧：ECharts option 的 `__data__` 里的数字（数据级对拍）。 */
function chartNumbers(root) {
  const out = []
  for (const el of Array.from(root.querySelectorAll('[data-chart]'))) {
    let opt = null
    try { opt = JSON.parse(el.getAttribute('data-chart') || 'null') } catch { /* ignore */ }
    const d = opt && opt.__data__
    if (!d) continue
    const walk = (x) => {
      // 旧图把值直接写进 SVG 文本（txt(..., v)）⇒ 这里也按**原值**取字符串，不取整
      if (typeof x === 'number') { if (Number.isFinite(x)) out.push(String(x)); return }
      if (Array.isArray(x)) { x.forEach(walk); return }
      if (x && typeof x === 'object') { Object.values(x).forEach(walk) }
    }
    walk(d)
  }
  return out
}

async function baseline(tab, sub) {
  // ★ 不预先自取 fleet：记录**页面自己第一次**拿到的 /api/fleet，再用同一份喂 Vue（见 installFetch 注释）
  const state = {}
  // ★ generation：页面前置条件 —— 先把 /api/curves 追到出图，作为唯一数据源（见 awaitCurves）
  if (tab === 'generation') {
    state.curves = await awaitCurves()
    state.curvesRaw = JSON.stringify(state.curves)
    console.log(`   [i] /api/curves 已出图：figs ${(state.curves.figs || []).length} 张`)
  }
  const html = await (await fetch(GATEWAY + '/detail/v2')).text()
  const dom = new JSDOM(html, {
    url: GATEWAY + `/detail/v2#tab=${tab}`,
    runScripts: 'dangerously', pretendToBeVisual: true,
    virtualConsole: new VirtualConsole(),
    beforeParse: (window) => installFetch(window, state),
  })
  const doc = dom.window.document
  // ★实逮：`#root` 初始就带一个 `.panel`（出错提示占位）——若拿 `.panel` 当"渲染好了"的判据，
  //   会在 app.js 取数之前就跳出循环，基线全空。判据改用 render() 一定产出的 `.page-head`，
  //   并且要求 fetch 桩已经记下 `/api/fleet` 的响应。
  for (let i = 0; i < 120; i++) {
    const root = doc.getElementById('root')
    if (root && root.querySelector('.page-head')) break
    await new Promise((r) => setTimeout(r, 500))
  }
  // 子视图：页签内部还有一层 pill（旧页面是 `data-fsub`）；点一下再抽锚点
  if (sub) {
    const pill = doc.querySelector(`#root [data-fsub="${sub}"]`)
    if (pill) {
      pill.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true }))
      // cms 子视图要等它异步取 /api/vibcms 再渲染 ⇒ 多等几轮
      const waitMs = sub === 'cms' ? 4000 : 1200
      await new Promise((r) => setTimeout(r, waitMs))
    } else {
      console.log(`   [i] 基准页没有子视图 pill data-fsub="${sub}"（按默认子视图比）`)
    }
  }
  return { doc, data: state.fleet, cms: state.cms ?? null, curves: state.curves ?? null, root: doc.getElementById('root') }
}

async function vueAnchors(data, tab, sub, cms, curves) {
  const entry = pathToFileURL(resolve(HERE, '../target/ssr/entry-server.js')).href
  const html = await (await import(entry)).renderTab(data, tab, sub, cms, curves)
  const dom = new JSDOM(`<div id="wrap">${html}</div>`)
  const wrap = dom.window.document.getElementById('wrap')
  // ★对齐口径：基线取的是 `#root`（页签内容本身，页签导航在 #root 之外的 #tabs，子视图 pill 在 #root 内）。
  //   Vue 的 Workbench 把页签导航也渲进来了 ⇒ 摘掉 `nav.wb-tabs` 再比；导航/子视图文案单独比（见 tabsLabel）。
  const tabsLabel = Array.from(wrap.querySelectorAll('.wb-tabs button, #tabs button, [data-fsub]'))
    .map((b) => norm(b.textContent.replace(/迁移中/, '')))
  const nav = wrap.querySelector('.wb-tabs')
  if (nav) nav.remove()
  return { wrap, tabsLabel }
}

/** 深比较（表格用）：返回第一个差异的说明。 */
function cmpDeep(a, b, label) {
  const A = JSON.stringify(a), B = JSON.stringify(b)
  if (A === B) return ''
  if (a.length !== b.length) return `${label}: 张数/行数不同 ${a.length} ≠ ${b.length}`
  for (let i = 0; i < a.length; i++) {
    if (JSON.stringify(a[i]) !== JSON.stringify(b[i])) {
      const ra = a[i] || [], rb = b[i] || []
      if (ra.length !== rb.length) return `${label}: 第 ${i + 1} 张表行数 ${ra.length} ≠ ${rb.length}`
      for (let r = 0; r < ra.length; r++) {
        if (JSON.stringify(ra[r]) !== JSON.stringify(rb[r])) {
          return `${label}: 第 ${i + 1} 张表第 ${r + 1} 行不同 —— "${String(ra[r]).slice(0, 60)}" ≠ "${String(rb[r]).slice(0, 60)}"`
        }
      }
    }
  }
  return label + ': 有差异'
}

function cmpList(a, b, label) {
  if (a.length !== b.length) {
    const [short, long, side] = a.length < b.length ? [a, b, 'Vue 多'] : [b, a, '基准多']
    const extra = long.slice(short.length, short.length + 6).map((s) => `"${String(s).slice(0, 60)}"`)
    return `${label}: 条数 ${a.length} ≠ ${b.length}；${side} ${long.length - short.length} 项，例如 ${extra.join(' / ')}`
  }
  for (let i = 0; i < a.length; i++) {
    if (a[i] !== b[i]) return `${label}[${i}]: "${String(a[i]).slice(0, 70)}" ≠ "${String(b[i]).slice(0, 70)}"`
  }
  return ''
}

/** 图数据：**子集**规则 —— 旧图把数据与坐标刻度都写成 SVG 文本，ECharts 的刻度在画布上拿不到，
 *  所以只要求"Vue 画的每个数都在旧图数字里出现"（抓数据画错/画多；刻度差异不算）。 */
function cmpSubset(vueNums, baseNums, label) {
  const pool = new Set(baseNums)
  const missing = vueNums.filter((v) => !pool.has(v))
  if (missing.length) return `${label}: Vue 有 ${missing.length} 个数字不在旧图里，例如 ${missing.slice(0, 6).join(',')}`
  return ''
}

/**
 * 显式例外（每条例外都要写清"为什么不是前端偏差"）：
 *   tab : 页签 · prefix : 两侧文本都以此开头时视为同一条 · why : 理由
 */
const ALLOW = [
  {
    tab: 'vibration', prefix: '窗末月? (',
    why: '与 fault 同类：列窗文案在"页面按窗缓存"与"实时 /api/fleet"两条路径上不同（"(变化统计方法=同型机)" vs '
       + '"(变化口径=同型机)"）⇒ 非前端偏差；待后端统一口径后删除本例外。',
  },
  {
    tab: 'fault', prefix: '平均停机间隔(MTBO',
    why: '后端两条路径文案不一致（页面的按窗缓存 vs 实时 /api/fleet）："(MTBO统计方法)/(纯故障统计方法)" vs '
       + '"(MTBO口径)/(纯故障口径)"。两侧同一字段、同一模板 ⇒ 非前端偏差；待后端统一口径后删除本例外。',
  },
]

/** 把基准文本按例外归一到 Vue 侧（并返回用到的例外数）。 */
function applyAllow(tab, baseTexts, vueTexts) {
  let used = 0
  const out = baseTexts.map((s, i) => {
    const rule = ALLOW.find((r) => r.tab === tab && s.includes(r.prefix) && (vueTexts[i] || '').includes(r.prefix))
    if (rule) { used += 1; return vueTexts[i] }
    return s
  })
  return { texts: out, used }
}

let bad = 0
let allowed = 0
const DUMP = process.env.PARITY_DUMP === '1'
for (const spec of TABS) {
  const [tab, sub] = String(spec).split(':')
  const base = await baseline(tab, sub)
  if (!base.data) {
    console.log(`[X] ${tab}: 取不到 /api/fleet 数据（服务没起？）`)
    bad++
    continue
  }
  const vroot = await vueAnchors(base.data, tab, sub, base.cms, base.curves)
  const allowRes = applyAllow(tab, textsIn(base.root), textsIn(vroot.wrap))
  allowed += allowRes.used
  if (DUMP) {
    const bt = textsIn(base.root), vt = textsIn(vroot.wrap)
    console.log(`\n== ${tab} 文本对照（基准 ${bt.length} / Vue ${vt.length}）==`)
    for (let i = 0; i < Math.max(bt.length, vt.length); i++) {
      const same = bt[i] === vt[i]
      console.log(`  ${String(i).padStart(3)} ${same ? '  ' : '≠ '}基:${String(bt[i] ?? '—').slice(0, 60).padEnd(62)} Vue:${String(vt[i] ?? '—').slice(0, 60)}`)
    }
    console.log(`  图数字 基: ${svgNumbers(base.root).join(',')}`)
    console.log(`  图数字 Vue: ${chartNumbers(vroot.wrap).join(',')}`)
    console.log(`  末尾 基: ${bt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
    console.log(`  末尾 Vue: ${vt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
    console.log(`  表 基: ${JSON.stringify(tablesIn(base.root)).slice(0, 400)}`)
    console.log(`  表 Vue: ${JSON.stringify(tablesIn(vroot.wrap)).slice(0, 400)}`)
    const bt1 = tablesIn(base.root)[1], vt1 = tablesIn(vroot.wrap)[1]
    if (bt1 || vt1) {
      console.log(`  第2张表 基 ${(bt1 || []).length} 行 / Vue ${(vt1 || []).length} 行`)
      for (let i = 0; i < Math.max((bt1 || []).length, (vt1 || []).length); i++) {
        const A = JSON.stringify(bt1?.[i] ?? null), B = JSON.stringify(vt1?.[i] ?? null)
        if (A !== B) console.log(`   行${i} 基:${String(A).slice(0, 130)}\n          Vue:${String(B).slice(0, 130)}`)
      }
    }
  }
  const baseTabs = Array.from(base.doc.querySelectorAll('#tabs button, #root [data-fsub]')).map((b) => norm(b.textContent))
  // 例外同样作用于表格：单元格若命中登记例外（两侧都以同一前缀开头），取 Vue 侧文本再比
  const allowTables = (bt, vt) => bt.map((rows, i) => rows.map((cells, r) =>
    cells.map((c, k) => {
      const rule = ALLOW.find((x) => x.tab === tab && c.includes(x.prefix)
        && String((vt[i] || [])[r]?.[k] ?? '').includes(x.prefix))
      return rule ? String((vt[i] || [])[r][k]) : c
    })))
  const checks = [
    cmpList(allowRes.texts, textsIn(vroot.wrap), '文本序列'),
    cmpDeep(allowTables(tablesIn(base.root), tablesIn(vroot.wrap)), tablesIn(vroot.wrap), '表格'),
    cmpList(baseTabs, vroot.tabsLabel, '页签'),
  ]
  const svgN = svgNumbers(base.root)
  const echN = chartNumbers(vroot.wrap)
  // 图表：老页面没有 SVG（或该页签本就无图）时不比；两边都有才比数据集合
  if (svgN.length && echN.length) checks.push(cmpSubset(echN, svgN, '图表数据(Vue ⊆ 旧图)'))
  const fails = checks.filter(Boolean)
  const extra = `文本 ${textsIn(base.root).length} 项（例外 ${allowRes.used} 条） · 表 ${tablesIn(base.root).length} 张 · 图数字 ${svgN.length}/${echN.length}`
  if (fails.length) {
    bad++
    console.log(`[X] ${spec} —— ${extra}`)
    for (const f of fails) console.log('      ' + f)
  } else {
    console.log(`[OK] ${spec} —— ${extra}（呈现一致）`)
  }
}
if (allowed) {
  for (const r of ALLOW) console.log(`[i] 已登记例外（${r.tab} · ${r.prefix}…）：${r.why.slice(0, 90)}…`)
}
console.log(`\n结论: ${bad === 0 ? `页签 ${TABS.join('/')} 与重构前呈现一致（含登记例外 ${allowed} 条）` : `${bad} 个页签不一致（见上）`}`)
process.exit(bad === 0 ? 0 : 9)