PCE GUI Portal — 銷項內頁 UI（查詢條件／workbench）
用途：說明 iframe 內銷項工具頁的共用元件、目前已交付版面，以及 2026-10-04 曾試做又還原的 workbench 對齊範圍。
對象：開發／顧問／產品
最後更新：2026-11-02（Portal 頁首環境名稱後顯示 NetSuite Account ID）
程式基準：Portal 版面仍以
對象：開發／顧問／產品
最後更新：2026-11-02（Portal 頁首環境名稱後顯示 NetSuite Account ID）
程式基準：Portal 版面仍以
7560a43 的背景／作廢 workbench 單卡為準。作廢規則、ACK 與主檔表單群組見 c973cc6 與 ar-status。共用元件（SuiteApp 程式）
| 元件 | 路徑 | 說明 | ||
|---|---|---|---|---|
| 查詢條件 card | common/PCE_LIB_PceFilterCollapse.js | 可收合「查詢條件」、條件 badge／chip、重設；embeddedInShell 用於 workbench 內嵌樣式 | ||
| 分頁（client-side） | common/PCE_LIB_PceClientTabs.js | renderWorkbenchCardLayout：單卡 + card-header-tabs（橙線 active） | ||
| Portal 頂栏同步 | common/PCE_LIB_PceShellHeader.js | pce_embed=T 時 postMessage；分頁切換可更新 intro（背景 workbench 已用） | ||
| 登入身分 | common/PCE_SL_Workbench.js | 頁首正中間顯示已對應通用系統設定的名稱、該列 NetSuite Account ID、使用者、角色（`測試區 (TD2905095) \ | 使用者: … \ | 角色: …`）。名稱與帳號來自該帳號 Mapping 那一筆。沒有對應時名稱顯示 —，不加帳號。角色名稱查不到時改顯示角色代碼 |
| iframe 殼 | common/PCE_LIB_PceLayout.js | renderEmbedDocument、.pce-embed-root | ||
| 處理中遮罩 | common/PCE_LIB_PceProcessing.js | 工具頁查詢、送出、Portal 切頁與延遲載入時顯示橘色轉圈；CSV 範本下載不顯示 |
本機測試：npm run test:pce-filter-collapse（若有）、npm run test:workbench（Portal 殼）。
目前已交付（TD2905095／master）
| 入口 | workbench 單卡 + header 分頁 | 查詢條件 UI | 備註 |
|---|---|---|---|
| 背景自動開立 | 是（提交｜進度） | 是（embedded；有結果時收合＋摘要） | 8b09862 起；PCE_SL_AR_AutoIssueWorkbench |
| 開立銷項發票/折讓單 | 否 | 是（獨立 card；結果區為 nav-pills） | PCE_SL_AR_Issue |
| 作廢銷項發票／折讓單 | 是（銷項發票｜折讓單） | 是（embedded） | workbench 單卡 + card-header-tabs，對齊背景自動開立 |
| 發票本管理 | 否 | 查詢分頁為傳統 card 表單 | 三 tab：查詢／手動／CSV |
| 加值中心上傳錯誤清單 | 否 | 是（獨立 card；對齊開立清單 host／fetch fragment） | 側欄 加值中心 → 上傳錯誤；PCE_LIB_AR_UploadErrorsHtml |
| 加值中心上傳監控 | 否 | —（唯讀儀表） | 側欄 加值中心 → 上傳監控；PCE_LIB_AR_UploadMonitorHtml |
| 營業稅進銷項與零稅率 | 否 | 營業人、民國年、雙月期別 | 側欄 營業稅申報 → 進銷項與零稅率。未勾 產報稅檔功能 時不顯示。進項、銷項整組同樣依 進項功能、銷項功能 顯示 |
開立銷項發票/折讓單仍為舊版「分頁列 + 獨立查詢 card」；作廢與背景自動開立已採 workbench 單卡分頁。
Invoice／Credit Memo／Customer Deposit 檢視頁的開立按鈕會開啟這個 Portal，右側直接載入該筆確認頁，左側選單預設收合（可按 ☰ 展開）。從中心進入 Portal 時，側欄仍依上次收合狀態。
2026-10-04 試做與還原（勿與現行帳上混淆）
曾實作並 CPD（commit 199d5a3、6658650）：作廢、發票本、一般開立清單改為與背景相同的 workbench 單卡 + Portal 分頁頂栏同步。
使用者驗收後要求 reset；master 已 force-push 回 c0e6ed7，並重新 deploy。上述兩 commit 不在現行分支，僅 Git reflog／遠端快取可能暫留。
若需重做對齊，可從 reflog 取 diff 或重開需求；設計討論脈絡見 Cursor agent transcript（本機，不納 Git）：
~/.cursor/projects/Users-yucheng-PwC-Development-com-netsuite-pceguitw/agent-transcripts/23bb1cd9-0b5f-41e4-9431-ea72c027f425/23bb1cd9-0b5f-41e4-9431-ea72c027f425.jsonl
相關文件
| 文件 | 內容 |
|---|---|
| AR 進度 | 變更紀錄、功能清單 |
| 背景自動開立 | 提交／進度行為 |
| 使用說明 §3.1 Portal | 會計視角導覽 |
| docs 索引 | 全文件目錄 |