# 公网 live smoke 与真实 OCR 准备清单

**文档状态**：当前操作手册，用于部署后公网、企业微信入口和真实 OCR 条件复核。

发布候选证据、权限直连审计、部署预检和小范围试运行顺序，以 [`发布试运行准备清单.md`](发布试运行准备清单.md) 为准；本文只列 live smoke 和真实 OCR 的执行条件。

## 必需环境变量

- `LIVE_SMOKE_BASE_URL`：默认 `https://oa.hyinda.com`。
- `LIVE_SMOKE_ADMIN_IDENTIFIER` / `LIVE_SMOKE_ADMIN_PASSWORD`：管理员 smoke 账号。
- `LIVE_SMOKE_EMPLOYEE_IDENTIFIER` / `LIVE_SMOKE_EMPLOYEE_PASSWORD`：员工 smoke 账号。
- `LIVE_EXPECT_WECOM_STATUS`：建议设为 `ready`，用于校验企业微信入口状态。

## 真实 OCR 复核

- `PLAYWRIGHT_OCR_LIVE_FILE`：单张真实测试发票 PDF。
- 或 `PLAYWRIGHT_OCR_LIVE_DIR`：批量 PDF 票样目录。
- 可选 `PLAYWRIGHT_OCR_LIVE_IDENTIFIER` / `PLAYWRIGHT_OCR_LIVE_PASSWORD`：专用 OCR 测试员工账号；未提供时复用 `LIVE_SMOKE_EMPLOYEE_*`。
- 可选 `PLAYWRIGHT_OCR_ALLOW_DUPLICATE=1`：允许重复样本被识别为重复，用于反复测试同一张票。

## 命令

```bash
node scripts/qa/check-live-smoke-env.mjs
LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
```

## 判定

- 缺少 live smoke 账号或 OCR 样本时，脚本必须输出 `SKIP` 和缺项，不得误报通过真实链路。
- 配置完整时，脚本执行公网 `/ready`、公网资源文案扫描、网页 live smoke 和真实 OCR 样本上传。
- 脚本不得打印密码、腾讯密钥或第三方 secret。
- 手机企业微信入口必须由真实企业微信客户端补测；自动化 UA 只能作为辅助证据。