Skip to content

评审:测试与 e2e 基建迁移方案 #95

Closed

Description

@JonasGao

Part of #88

Question

Playwright/vitest 基建如何指向 Go server 并保持等价验收:webServer 启动方式换什么、/api/e2e/fixtures 与 scripted-AI 注入怎么移植、auth 套件与 WR_AUTH_DISABLED 语义怎么消化、XDG 隔离与 cgroup 包装存不存续、服务端单测的 Go 化边界划在哪。

Activity

  1. self-assigned this
    on Nov 5, 2026
  2. JonasGao commented on Nov 5, 2026

    @JonasGao
    CollaboratorAuthor

    决议(两轮 answer-board + 收束确认,8 项)

    D1 webServer:e2e 只跑生产单二进制;构建入口与发布共享——go-server.ts(接替 next-server.ts,只拼命令)调用与发布同一个 Makefile 生产构建目标(make build:vite build → go build embed);webServer 超时 5min → 2min(vite build 秒级、go build 缓存命中秒级,留冷缓存余量);webServer.env 继续注入 XDG tmp 根 / E2E_FIXTURES=1 / WR_AUTH_DISABLED=1。验收工件 = 发布工件,不写 e2e 专属构建脚本。

    D2 模式矩阵退役:E2E_SERVER_MODE / E2E_BUNDLER / NODE_OPTIONS 堆上限 / webServerTimeout 双档全部删除(存在理由——bundler 四象限内存实测——随 Next 消失);SPA 侧调试 = vite dev + 手工 go serve 组合,不进 playwright 配置;双 config 结构(默认套件 + auth 套件)保留,auth.config.ts 的 cwd hack 与 NODE_OPTIONS 随 Next 退役。

    D3 fixtures 移植:/api/e2e/fixtures 原样移植 Go——同路径、同 {action, marker, ...} 请求/响应形状、E2E_FIXTURES=1 门控、withAuth 语义、直接写 DB(database/sql);DELETE 清理同形。

    D4 scripted-AI 不移植:留在 e2e/(Node 测试侧资产,非应用代码)。衍生约束(进 #96 蓝图引擎节):Go openai-compatible 路径必须继续发 /chat/completions,消息历史形状(user instruction 文本 + assistant tool_calls 回放)不变——marker 协议(base64url 剧本 + 步骤序号 = user 轮数 + 已完成工具步数)依赖此形状;现有 e2e 套件零改动通过 = Go 引擎验收标准。

    D5 auth/env 语义:WR_AUTH_DISABLED 同名同值 '1'、boot 时读一次(测试按套件切换、进程级即可);XDG_DATA_HOME / XDG_CONFIG_HOME 同名沿用,Go 数据目录解析遵守——e2e 隔离机制不变;preparePassword 预生成 hack 保留(auth.json 文件格式与哈希算法被存量数据冻结——Go 必须能验证既有部署的存量文件——TS 同算法预生成继续可用,测试取密码路径不变)。

    D6 cgroup 保留:run-e2e.mjs wrapper 与 knobs 原样(MemoryMax 8G / CPUQuota 300% / memory.peak + oom_kill 回读不动);Chromium workers 仍是内存大头,wrapper 继续护整机;memory.peak 回读兼作「内存不劣于 Next 版」动机的量化验收(Next 生产+Turbopack 基线 6.1–6.2G 峰值,记录于 e2e/next-server.ts 注释,蓝图 runbook 引用为对比基准);E2E_WORKERS 放开与 MemoryMax 收紧 = cutover 后实测决策,写进 runbook,不预承诺数值。

    D7 服务端单测边界:测试跟着代码走——33 个 route.test.ts → Go httptest 等价测试(同用例集:同 happy path + 同 {error, code} 错误形状断言),放 server 侧对应包(布局归 #96);lib 里 server-only 模块(auth guard、db、生成引擎等)→ Go 单测;被 client 代码 import 的任何东西(zod schema、纯函数、类型)→ 留 vitest;批次划分归 #96。

    D8 验收时点(两段式 + 预切换演练):施工期(Next 仍为运行时)路由族完工验收 = 仅 Go httptest 同用例集全绿,e2e 继续指向 Next 守护现有行为不回退;全部 57 路由移植完成、正式切换之前,runbook 写死一步预切换演练——全套 e2e 对 Go 单二进制跑绿;cutover 门槛 = 全量 e2e 零改动对 Go 二进制跑绿;cutover 后 e2e 永久指向 Go,删除对应 TS server 测试。

    对地图的影响

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions