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；管理端 /tasks 用例填 MOICEN_ADMIN_USER / MOICEN_ADMIN_PASSWORD（见 example 内说明）。勿提交 .env.e2e。

用例概览：

文件	内容
tests/smoke-http.spec.ts	request：GET / 返回 HTML（网关 / TLS / 静态入口底线，不启浏览器）
tests/core-full-chain.spec.ts	访客：未登录访问 /course 被送回 / 且见访客占位；已登录：黄金路径（会话→深链→课程体系壳层→JWT 与机构闭环）；可选 MOICEN_HEALTHCHECK_URL
tests/guest-onboarding.spec.ts	未登录：仅见「请返回微信小程序完成登录」，不出现已登录工作台
tests/home-shell.spec.ts	#app、伪造 unionid 不白屏、page_path 净化
tests/logged-in-and-isolation.spec.ts	需 Secret：登录后非访客态；异主 unionid 剥离；多角色选身份后见「欢迎回来」（不校验姓名）
tests/org-multi-tenant.spec.ts	需 Secret：机构选择页可达且呈现机构列表 UI
tests/org-data-isolation.spec.ts	需 Secret：CurrentOrgId 与 JWT current_org_id 一致；多机构时可切换机构并更新上下文；/course 课程体系列表不出现「请求失败」错误态
tests/admin-tasks.spec.ts	需 MOICEN_ADMIN_USER / MOICEN_ADMIN_PASSWORD：管理端登录后打开 /tasks

未配置 MOICEN_E2E_UNIONID 时，logged-in-and-isolation、org-multi-tenant、org-data-isolation 内用例全部 skip。未配置管理端账号时，admin-tasks 内用例 skip。

GitHub Actions

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

可选：在 Settings → Secrets and variables → Actions → Variables 配置 MOICEN_HEALTHCHECK_URL（完整 URL，返回 2xx），用于可选后端健康检查用例；未配置时该条自动 skip。

Playwright 成功后，CI 会 SSH 到 moicen（需 Secrets：MOICEN_SSH_PRIVATE_KEY、MOICEN_SSH_USER、MOICEN_SSH_KNOWN_HOSTS），在机上执行 scripts/moicen-remote-readonly-check.sh：TS_DATABASE_URL 探库、redis-cli ping、tail htyproc 与 OpenResty error.log。fork 仓库发起的 PR 不会跑该步（无 Secrets）。主机名固定 moicen.com（写在 workflow）。

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 / 运维仓同路径即可）。