huike-e2e-moicen/README.md

huike-e2e-moicen

针对 已部署 的 music-room.moicen.com（或任意 HUIKE_FRONT_BASE_URL）跑 Playwright，不 clone huike-front、不起 Postgres、不编译 Rust。全栈本地 E2E 见 alchemy-studio/huike-e2e。

本机

npm ci
npx playwright install chromium
npx playwright test

走代理安装（默认 http://localhost:7890）：npm run install:with-proxy

可选：复制 .env.e2e.example → .env.e2e，填写 MOICEN_E2E_UNIONID（仅此一项敏感凭据即可跑登录链与串号用例）。不必配置 real_name：姓名非唯一标识、会变，断言「欢迎回来」等 UI 即可。勿提交 .env.e2e。

用例概览：

文件	内容
tests/guest-onboarding.spec.ts	未登录：仅见「请返回微信小程序完成登录」，不出现已登录工作台
tests/home-shell.spec.ts	#app、伪造 unionid 不白屏、page_path 净化
tests/logged-in-and-isolation.spec.ts	需 Secret：登录后非访客态；异主 unionid 剥离；多角色选身份后见「欢迎回来」（不校验姓名）

未配置 MOICEN_E2E_UNIONID 时，logged-in-and-isolation 内用例全部 skip。

GitHub Actions

在 Settings → Secrets → Actions 配置 MOICEN_E2E_UNIONID 即可。未配 unionid 时仅跑访客与壳层用例。

workflow_dispatch 可改目标 base_url；默认定时：每天 06:30 UTC（见 .github/workflows/playwright-music-room.yml）。

与 moicen 运维文档

浏览器联调、在 UC 库查 union_id 等：见团队内 plan_skills/moicen/moicen-music-room-browser-test-runbook.md（与 huiwing-migration / 运维仓同路径即可）。