B1-B8 建立项目级流程与QA门禁

docs/trialrun/live-smoke-readiness.md

@@ -0,0 +1,28 @@
+# 公网 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/JPG/PNG/WEBP。
+- 或 `PLAYWRIGHT_OCR_LIVE_DIR`：批量票样目录。
+- 可选 `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。