# Flock Freight 登录后查价录制 SOP（Step 12.78）

> 匿名 marketing 仍走 `npm run record:flock`（get-a-quote）。  
> **本文件仅覆盖：客户配置 Flock 账密后的登录态查价路径。**

## 前置

1. 准备 Flock 官网账密（`.env` 的 `FLOCK_LOGIN_EMAIL` / `FLOCK_LOGIN_PASSWORD`，或管理端客户「查价网站账密」）
2. 本机已装 Playwright Chromium/Chrome；`RPA_BROWSER_CHANNEL=chrome` 推荐
3. 关闭会干扰 codegen 的自动填密插件（或全程手动粘贴）

## 启动

```bash
npm run record:flock -- --logged-in
# 或指定入口
npm run record:flock -- --logged-in https://app.flockfreight.com/login
```

Windows：

```powershell
powershell -ExecutionPolicy Bypass -File scripts/record-flock.ps1 -LoggedIn
```

产物约定：

| 类型 | 路径 |
|------|------|
| codegen 脚本 | `.rpa/recordings/flock-logged-in-<时间戳>.js` |
| storageState | `.rpa/flock-logged-in-storage.json` |

与匿名 `.rpa/flock-storage.json` **隔离**，禁止混用。

## 人工路径（必须完整一次）

标准样例：Pickup ZIP **90001** → Delivery ZIP **75201**；托盘/重量/尺寸按清单（或登录后表单等价字段）。

1. codegen 打开登录页（若未登录）
2. **手动粘贴**邮箱/密码并提交（脚本不自动填）
3. 进入登录后查价入口（记录最终 URL；常见 **Let's build a quote** / Quick）
4. 按页面真实字段走完：ZIP/Type/Packaging/Class/Description/提交 → **等到报价结果出现**
5. 关闭 codegen 窗口，确认 js + storage 落盘

## 录制后必填清单（从 js 摘抄）

将下列项填入下方「附录 A」；正式写入 `.env` 的 `FLOCK_SELECTOR_*` / 登录后 UI 适配可与下一步同做。

| # | 项 | 说明 |
|---|----|------|
| 1 | 登录页 URL | 默认 `https://app.flockfreight.com/login` |
| 2 | 登录后报价入口 URL | 出「Let's build a quote」或等价表单的首个稳定 URL |
| 3 | `FLOCK_SELECTOR_LOGIN_EMAIL` | email 输入 |
| 4 | `FLOCK_SELECTOR_LOGIN_PASSWORD` | password 输入 |
| 5 | `FLOCK_SELECTOR_LOGIN_SUBMIT` | 登录提交 |
| 6 | 表单可见标记 | heading / 关键文案（供 `isFlockLoggedInQuoteForm`） |
| 7 | 提货/派送 ZIP 或地址字段 | |
| 8 | Type / Packaging / Freight Class / Description | 登录后必填项 |
| 9 | 提交报价 selector | 如 Generate my quote |
| 10 | 出报价特征 | 网络 URL 模式或结果 DOM 文案 |

录制后可运行：

```bash
npx tsx scripts/finalize-flock-logged-in-recording.ts
```

## 禁止

- 用匿名 `get-a-quote` 录制冒充登录后页（字段不同）
- 用手猜 selector 跳过本 SOP
- 把登录态 storage 写进匿名 `FLOCK_STORAGE_STATE_PATH`

## 附录 A — 本次录制摘抄（人工回填）

> 2026-07-15 15:58：人工重录完整路径（`flock-logged-in-20260715-155553.js`），已出报价 `quote/TSM-TQ8Q`。  
> **警告**：原始 js 曾含明文账密，已脱敏为 `REDACTED`；勿提交真实密码。脱敏基线：`scripts/fixtures/flock-logged-in-quote-baseline.js`。

| 项 | 值 |
|----|-----|
| 录制脚本文件 | `.rpa/recordings/flock-logged-in-20260715-155553.js` |
| storageState | `.rpa/flock-logged-in-storage.json`（存在） |
| 登录页 URL | `https://app.flockfreight.com/login` |
| 登录后入口 | `https://app.flockfreight.com/home` → `header-new-quote-button` → `quick-form-toggle` |
| 结果页示例 | `https://app.flockfreight.com/quote/{id}`（本次 `quote/TSM-TQ8Q`） |
| LOGIN_EMAIL | `getByRole('textbox', { name: 'Email Address' })` → **Next** |
| LOGIN_PASSWORD | `getByRole('textbox', { name: 'Password' })` |
| LOGIN_SUBMIT | `getByRole('button', { name: 'Log in' })` |
| 表单可见标记 | Quick：`quick-form-toggle`；提交 testid `quote-request-quick-form__submit_button` |
| ZIP/地址字段 | `Pickup ZIP Code` / `Delivery ZIP Code` |
| 提货/派送类型 | combobox `Pickup Type *` / `Delivery Type *` |
| 货物字段 | Quantity / Packaging（Bags 时有 Length/Width）/ Height / Weight / Freight Class（含 density）/ Description / Stackable |
| 出报价特征 | `/quote/{id}`；`Standard-fulfillment-option` / `FlockDirect®-fulfillment-option` |
| 录制日期 | 2026-07-15 |
