PCE TW GUI MODULE — 銷項 Phase 1 單元測試清單

這些測試不連 NetSuite 帳號。test/helpers/amd-loader.js 在 Node 載入 SuiteScript define()；各模組 harness mock N/record、N/search 等相依模組。

1. 怎麼跑

在專案根目錄：

# Phase 1 核心套件（195 案，2026-09-14）
npm run test:ar-phase1

# 開立核心（單元 + issueFromSources E2E，49 案）
npm run test:ar-issue
npm run test:ar-issue-from-sources

# 分模組
npm run test:ar-book-allocate    # 取號／手填（86 案）
npm run test:ar-validate         # 銷項驗證（6 案）
npm run test:ar-feature          # 子公司 feature flag（6 案）
npm run test:ar-issue-search     # 開立 Saved Search（4 案）
npm run test:ar-book-csv         # 發票本 CSV（21 案）
npm run test:ar-book-import      # 發票本匯入（4 案）
npm run test:ar-book-import-log  # 匯入紀錄（7 案）
npm run test:ar-book-search      # 發票本查詢／配號（12 案）

# Phase 1 延伸（未納入 test:ar-phase1，但屬同一交付範圍）
npm run test:ar-allowance        # 折讓取號／閘道／餘額（33 案）
npm run test:ar-void             # 作廢（15 案）
npm run test:ar-custom-lines     # 自訂商品明細 lib（31 案）

# 共用 list 值解析（4 案，已納入 npm test）
npm run test:list-value

# 交易表身 UE（23 案）
npm run test:ar-trans-ar-body-ue

# 全專案（含 AP 與上述銷項，471 案）
npm test

依名稱篩選（Node 20+）：

node --test --test-name-pattern="淨額" test/ar-issue-from-sources.test.js

2. 覆蓋範圍總覽

2.1 npm run test:ar-phase1（274 案）

2.2 Phase 1 延伸（48 案，建議 regression 一併跑）

Phase 1 單元測試合計（含延伸）：274 + 48 = 322 案（2026-09-21）。

2.3 共用與表身 UE（27 案，npm test 已含 list-value）

2.3 尚未覆蓋（需帳上／手動）

2.4 Phase 7 背景開立（本機，建議與銷項 regression 一併跑）

npm run test:ar-auto-issue
npm run test:ar-auto-issue-monitor
npm run test:taiwan-date

規格：背景自動開立

3. Harness 對照

E2E 常用 factory：

• defaultSourceTransaction(txId, overrides) — Invoice mock
• defaultAllowanceTransaction(txId, overrides) — Credit Memo mock
• customLinesByTxId — customrecord_pce_ar_custom_line search mock

4. 案例清單 — 開立（test:ar-issue）

4.1 ar-issue.test.js（21 案）

4.2 ar-issue-from-sources.test.js（43 案）

單張／合併／淨額

失敗情境

折讓開立（格式 33）

自訂明細

背景明細

合併／淨額總備註預填（loadTransactionsForIssueForm.remarks）

（單張 INV／訂金總備註預填、訂金含稅反推等案例見同一檔 Customer Deposit 轉開 describe。）

5. 案例清單 — 驗證／Feature／Search

5.1 ar-validate.test.js（6 案）

• validateRecord 統編：合法、B2C 略過、買方錯、賣方錯
• applySalesAmountDefaultsToNsRecord：空值補 0
• formatErrorsAsText／Html

5.2 ar-feature.test.js（6 案）

• isArFeatureEnabledForSubsidiary：啟用／未啟用／空
• shouldIssueInvoiceForTransaction：有客戶且啟用、無客戶、applyIssueInvoiceFlag

5.3 ar-issue-search.test.js（4 案）

• Saved Search 開立資格（issue=T、未鎖、無號碼）
• buildListCriteriaFilters：有條件／空
• buildInternalIdFilter

6. 案例清單 — 發票本／取號

取號詳細案例與 mock 發票本欄位見 取號測試指南。

6.1 摘要

7. 案例清單 — Phase 1 延伸

7.1 ar-allowance.test.js（33 案）

7.2 ar-void.test.js（15 案）

7.3 ar-custom-lines.test.js（31 案）

8. 建議 regression 順序

1. npm run test:ar-phase1 — 開立＋取號＋發票本核心（CI 必綠）
2. npm run test:ar-allowance && npm run test:ar-void && npm run test:ar-custom-lines — 同交付範圍延伸
3. 部署後帳上：開立 Suitelet 單張／合併／淨額各一筆（手動 checklist）

9. 新增 E2E 案例指引

在 test/ar-issue-from-sources.test.js 新增案例時：

1. 使用 loadIssueLibForSources()，每案獨立 mock，避免 state 汙染。
2. 來源交易用 defaultSourceTransaction／defaultAllowanceTransaction。
3. 自訂明細補 customLinesByTxId 並將 useCustomLines 設為 T。
4. 折讓需 arInvoiceRows 模擬原發票銷項主檔。
5. 斷言優先查 issueState.createdRecords、issueState.submitFieldsCalls。

範本見 ar-issue-from-sources.test.js 第一個 happy path 案例。

10. 修訂紀錄