ContactLoop

內部上手指南 · 請先登入

沒有密碼?請向管理員索取。

從 0 開始 · 路線 B

QA 工程師:從 0 跑出第一套測試

auto_cl 是 ContactLoop 的 E2E 自動化測試專案(Python + Playwright),跑通它就等於把 SW ↔ Ava 整條迴圈驗過一遍。目標:在本機跑出 stg 的綠燈報告。

測試覆蓋哪些事

測試檔驗什麼
test_ip.py最先跑,確認當前 IP 環境
test_sw_nucleus.pySW 登入 → 選帳號 → 匯入聯絡人 → 驗證首則 SMS 送達(Quo)→ 模擬 lead 發 5 句 → 登入 Ava 比對訊息一致
test_sw_page_api_checks.py逐頁導航 SW 各核心頁面,攔截真實 XHR,驗狀態碼與關鍵欄位
test_sw_segments.py匯入前後 segment count 增量驗證
test_ava_link.py最後跑,Ava 對話中 Ava 發的連結有效性驗證

安裝步驟

# 1. 建立虛擬環境並安裝套件
python -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 2. 安裝 Playwright 瀏覽器
playwright install chromium

# 3. 複製環境變數範本並填入
cp .env.example .env              # Windows: copy .env.example .env

.env 必填欄位(以 stg 為例)

變數說明必填?
STG_SW_EMAIL / PASSWORDstg 的 SW Manager 帳密✅
STG_AVA_EMAIL / PASSWORDstg 的 Ava Messenger 帳密✅
QUO_API_KEYQuo SMS API 金鑰(測 SMS 驗證用)跑 Nucleus 才需要
QUO_phoneNumberId測試 lead 號碼的 Quo 內部 ID跑 Nucleus 才需要
QUO_participants_stgstg 對應的 SW 端號碼(E.164)跑 Nucleus 才需要
SMTP_EMAIL / PASSWORD測試結果通知信(Gmail App Password)要收信才需要
TEAMS_WEBHOOK_URLTeams 通知 webhook要 Teams 通知才需要
R2_*Cloudflare R2(影片/報告上傳)要上傳才需要

跑測試

# Windows 先設編碼
$env:PYTHONUTF8=1

# 全部測試(自動排序:IP → Nucleus → 頁面 API → Segments → AvaLink)
pytest --env stg -v

# 只跑某一支
pytest tests/test_sw_segments.py --env stg -v

# 只跑 Ava 相關 / 排除 SMS
pytest -m Ava --env stg -v
pytest tests/test_sw_nucleus.py --env stg -v -m "not Sms"

# 跑單一方法
pytest tests/test_sw_segments.py::TestSW::test_sw_segments_count2 --env stg -v
📍

Account ID 不在 .env 裡。它是寫在 conftest.py 的 ENV_CONFIG 裡(例如 stg sw_nucleus.account_id=93)。換帳號要改程式碼,不是改 .env。各環境帳號請找主管或既有 auto_cl 維護者確認。

產出物在哪

  • reports/report.html — HTML 測試報告
  • reports/test.log — 完整 log
  • videos/ — 每次執行的單一連續影片(.webm,檔名帶環境與時間戳)
  • reports/ava_link_issues.json — Ava 連結異常(有異常才產生)
  • reports/sw_page_api_issues.json — SW 頁面 API 檢查異常
  • reports/api_metrics.json — API 回應時間統計
  • 測試結束自動寄 Email / Teams 通知(若已設定)