# huike-e2e-moicen

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

## 本机

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