# MotherShip 登录后查价录制 SOP（Step 12.61）

> 匿名 widget 仍走 `npm run record:mothership`（GD-15）。  
> **本文件仅覆盖：客户配置账密后的登录态查价路径。**

## 前置

1. `.env` 已填 `MOTHERSHIP_EMAIL` / `MOTHERSHIP_PASSWORD`（勿提交真实密码）
2. 本机已装 Playwright Chromium/Chrome；`RPA_BROWSER_CHANNEL=chrome` 推荐
3. 关闭会干扰 codegen 的自动填密插件（或全程手动粘贴）

## 启动

```bash
npm run record:mothership -- --logged-in
# 或指定入口（允许 dashboard / login）
npm run record:mothership -- --logged-in https://dashboard.mothership.com/
```

Windows：

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

产物约定：

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

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

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

标准样例：Pickup **Los Angeles / 90001** → Delivery **Dallas / 75201**；单托 500 lb、48×40×48 in、托盘数 2（或登录后表单等价字段）。

1. codegen 浏览器打开登录页（若未登录）
2. **手动粘贴**邮箱/密码并提交（脚本不自动填）
3. 进入登录后查价入口（记录最终 URL）
4. 按页面真实字段走完：地址/货物/提交 → **等到报价结果出现**
5. 关闭 codegen 窗口，确认 js + storage 落盘

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

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

| # | 项 | 说明 |
|---|----|------|
| 1 | 登录页 URL | 含 `/login` 或实际登录入口 |
| 2 | 登录后报价入口 URL | 出表单的首个稳定 URL |
| 3 | `RPA_SELECTOR_LOGIN_EMAIL` | email 输入 |
| 4 | `RPA_SELECTOR_LOGIN_PASSWORD` | password 输入 |
| 5 | `RPA_SELECTOR_LOGIN_SUBMIT` | 登录提交 |
| 6 | 表单可见标记 | heading / 关键文案（供 `isLoggedInQuoteForm`） |
| 7 | 提货/派送地址字段 selector | |
| 8 | 货物字段 selector | 托盘/重量/尺寸或登录后等价项 |
| 9 | 提交报价 selector | |
| 10 | 出报价特征 | 网络 URL 模式或结果 DOM 文案 |

## 禁止

- 匿名模式录制登录后页（GD-15 会拦 dashboard）
- 用手猜 selector 跳过本 SOP
- 把登录态 storage 写进匿名 `RPA_STORAGE_STATE_PATH`

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

> 2026-07-15：登录 + 「Create a new shipment」一级表单已录制（`mothership-logged-in-20260715-105824.js`）。  
> **警告**：录制脚本含明文账密，仅存 `.rpa/`（gitignore），勿提交、勿写进文档。

| 项 | 值 |
|----|-----|
| 录制脚本文件 | `.rpa/recordings/mothership-logged-in-20260715-105824.js` |
| 登录页 URL | `https://dashboard.mothership.com/login` |
| 登录后报价入口 URL | `https://dashboard.mothership.com/ship`（直达；亦可 dashboard → Ship → Create a new shipment） |
| LOGIN_EMAIL | `getByTestId('auth-email-input')` |
| LOGIN_PASSWORD | `getByTestId('auth-password-input')` |
| LOGIN_SUBMIT | `getByTestId('auth-log-in-button')` |
| 表单可见标记 | 文案 `Create a new shipment` / 中文 UI「创建新货件」 |
| 地址字段 | `quote-create-pickup-input-search` / `quote-create-delivery-input-search` |
| 附加服务 | `address-book-accessorials-trigger` + `address-book-accessorials-option-*` |
| 货物字段 | `cargo-type-dropdown-input` / `cargo-quantity-input` / `cargo-weight-input` / `cargo-length\|width\|height-input` |
| 提交钮 | `ship-create-continue-button`（一级「继续」） |
| 出报价特征 | rate-card / `quote-details-rate-option-*`（二级，后续） |
| 录制日期 | 2026-07-15 |
| 系统 UI | Step 12.62 `MothershipLoggedInShipmentForm`（有账密或 `?ms_logged_in=1`） |

