2026-07-19 — 採購單簽章回執：供應商回覆交期（雙向閉環）

摘要

把採購單簽章 PDF 迴圈補成雙向閉環：供應商匯入採購單後，可簽一份採購單簽章回執

（接受 / 調整交期 / 拒接）寄回買方；買方在採購協同回覆審閱（POCOLLABRPY）匯入回執、驗章後，

照既有流程套用交期回採購單。回執落進與 Phase 7 token 回覆同一張 reply 表，套用邏輯完全重用。

新增

• 供應商可回覆買方：於「採購協同收件」（POINBOUND）匯入採購單後，按「回覆買方」，

選擇接受 / 調整交期（逐行填新交期、數量、備註）/ 拒接並附整單備註 → 簽章後產出回執 PDF

自動寄回買方。

• 買方可匯入簽章回執：於採購協同回覆審閱（POCOLLABRPY）動作列新增「匯入簽章回執」按鈕，

選回執 PDF → 驗章通過後落入回覆清單，照原有「套用交期」把交期寫回採購單（更新預訂交期、

發送狀態、開待辦），與供應商臨時連結回覆走同一套審閱套用流程。

- 同一份回執重複匯入會被擋（防重放）。

- 回執明細以「單號 + 序號」自動對應採購明細；對不上的行仍會落入審閱清單供人工檢視。

變更

• 採購單簽章資料新增買方回覆信箱：送出採購單時，payload 加入採購員（採購單輸入人員）的

email，供應商回執自動寄回該信箱。此信箱只寫進簽章資料、不印在採購單報表上（人看報表不露信箱），

且受簽章保護、防竄改。

刪除

無

Breaking Changes

無：採購單簽章 PDF 的資料格式（payload）新增 buyerEmail 欄位向後相容，既有已簽章文件仍可驗章；

回執落入既有回覆表，不影響原有的臨時連結回覆流程。

前置設定（使用者需先完成）

回執為 B2B 全迴圈延伸，沿用簽章 PDF 的既有前置（見 2026-07-18 採購單簽章 PDF）：

1. 產生機構簽章金鑰：買賣雙方各自跑簽章金鑰向導產生正式金鑰。

2. 設定往來對象公鑰（POKEYCP）：買方需匯入供應商公鑰卡才驗得了回執的章。

3. 回覆信箱來源：採購員（採購單輸入人員）需於 perdata 維護 email，回執才寄得回本人。

!!! warning "尚未 runtime 驗證"

本次交付建置與單元測試全綠（供應商端回執組裝、買方端驗章落表、既有套用交期回歸測試皆通過），

但供應商真簽章產回執 PDF、寄信，以及買方真驗章匯入、套用交期回採購單等 runtime 全鏈尚未實機驗證；

「匯入簽章回執」按鈕的多語系文字尚未建立（有預設中文，不影響功能）。上線前請先完成前置設定並實機測試。

相關 ADR

• ADR 0109 — 採購單簽章回執：供應商回覆交期

• ADR 0107 — 採購單簽章 PDF：B2B 雙向迴圈

• ADR 0108 — 採購單簽章 PDF：完整文件加密

2026-07-18 — 採購單簽章 PDF：給供應商的 B2B 雙向迴圈

摘要

把採購單接進既有簽章 PDF 系統，做成 B2B 雙向迴圈：買方送出簽章採購單 PDF → 供應商收下驗章

→ 匯入自家系統自動建立銷貨訂單。沿用既有 RSA-3072 簽章、PDF/A-3 內嵌與公鑰配對機制。

新增

• 採購單可列印/預覽：補完採購單報表（含單價、原幣未稅、合計），可從採購單列印/預覽出圖。

• 供應商協同信可附上採購單簽章 PDF：協同信寄出時附帶已簽章的採購單 PDF，供應商端可驗章確認來源與內容未遭竄改。

• 「採購協同收件」功能（POINBOUND）：供應商匯入已簽章採購單 PDF → 驗章通過後自動建立銷貨訂單（ORMAST）。

- 依採購單上的買方統一編號自動對應客戶代號（查無客戶檔則擋下，提示先建檔）。

- 同一份採購單重複匯入會被擋（防重放），並回報既有訂單號。

變更

• 採購單報表資料對映修正：原報表因欄位對映問題無法正常顯示，本次修正後欄位正常帶值。

• 供應商協同信改為「先產簽章 PDF 附件、失敗則回退純連結信」——產 PDF 失敗不影響協同連結寄達。

刪除

無

Breaking Changes

無：採購單簽章 PDF 的資料格式（payload）新增欄位一律向後相容，既有已簽章文件仍可驗章。

前置設定（使用者需先完成）

此功能為 B2B 全迴圈，上線前需先備妥簽章金鑰與往來對象公鑰：

1. 產生機構簽章金鑰：跑簽章金鑰向導產生正式金鑰（未產生時送出端會提示「金鑰未建立」，不會建立錯誤 PDF）。

2. 設定往來對象公鑰（POKEYCP）：於「往來對象公鑰」維護匯入供應商/客戶的公鑰卡，收件端才驗得了章。

3. 部署資料庫物件：對各目標 DB 執行 sql/pocollab-inbound-doc-deploy.sql（建收件防重放表 twork_com_inbound_doc + _sheetno/_tableseq 登錄）。

!!! warning "尚未 runtime 驗證"

本次交付建置與單元測試全綠，但送出端 headless 渲染 PDF、真簽章、供應商端真驗章匯入 ORMAST 等

runtime 流程尚未實機驗證；正式機資料庫物件尚未部署。上線前請先完成前置設定並實機測試。

相關 ADR

• ADR 0107 — 採購單簽章 PDF：B2B 雙向迴圈

• ADR 0042 — 報表附加資料：嵌入簽章 PDF

• ADR 0046 — 採購協同公鑰配對

2026-07-18 採購協同：採購單完整文件加密

摘要

採購協同送出簽章採購單時，新增「完整加密文件」選項——採購單整份加密，只有指定供應商用 TsERP

能打開，email 途中、郵件伺服器、誤收者都讀不到金額。簽章（防偽 / 防竄改）不變，加密是再加一層。

新增

• 發送方式三選一：PURCH 發送供應商協同時可選 ① 一般簽章 PDF ② 完整加密文件

③ 只要供應商回覆交期（純連結、不附檔）。

• 完整加密：採購單整份簽章 PDF 加密成 .poenc 檔隨信寄出，只有指定供應商用 TsERP 匯入才解得開；

金額照留在文件內（整份都是密文）。

• 收件端支援加密檔：供應商在「採購協同收件」（POINBOUND）可匯入 .poenc，系統自動用自己的

私鑰解密還原文件、驗章後建立訂單；既有明文 .pdf 簽章檔照常匯入。

• 機構金鑰備份 / 還原：金鑰向導可把機構金鑰備份成密碼保護檔並在換機 / 重建時還原

（加密私鑰一旦遺失，先前收到的加密單將永久打不開，故務必備份）。

變更

• 買賣雙方識別改帶統編 + 完整公司名稱：國外客戶（無統一編號）可改用公司名稱對映，

收件匯入建訂單時客戶對映改為「統編優先、公司名稱後備」。

• 金鑰輪替保留舊金鑰：重新產生機構金鑰時保留舊私鑰於本機，以便解開先前收到的加密單；

向導提醒改為「新公鑰卡須重新交付往來對象配對」。

刪除

• 無。

Breaking Changes

• 無（既有明文簽章 PDF、純連結協同均照常運作；加密是新增選項，非取代）。

Migration Notes

• 發送方式欄：各資料庫需執行 sql/pocollab-portal-deploy.sql 的 Phase F2 段

（為 sent 表加 發送方式 欄）。dev（csa1 / csa5）已完成；正式機（csa2/3/4 及其他客戶庫）待部署。

• 雙向公鑰配對：要送「完整加密文件」給某供應商，須先在 POKEYCP 匯入該對象的公鑰卡；

買方自身也要把新公鑰卡交付往來對象配對。POKEYCP 選單權限掛載與 _sheetno 重登為前置。

• 未配對到對方公鑰時，系統會自動改送「未加密簽章 PDF」並於發送結果訊息提醒。

已知限制 / 未驗

• 金鑰向導開窗互動、端到端加密收送（.poenc → email → 匯入解密驗章）、跨客戶機的憑證庫行為

尚未實機驗證（金鑰解密 / 備份還原 / 輪替已於本開發機憑證庫以整合測試驗過）。

• 目前採單一金鑰雙用途（簽章 + 解密），簽 / 密金鑰分離列為日後強化選項。

2026-07-17 供應商協同入口廣義化

摘要

供應商回覆表單全新設計（手機優先、繁體中文），並讓協同追蹤機制脫離採購單、支援任意單據別與

客戶／廠商雙類別。承辦人拉回回覆後，左側待辦事項會出現通知，套用或忽略即自動消失。

新增

• 供應商回覆表單全新設計：手機優先版面、繁體中文介面，提供確認、逐項調整、

拒接三種回覆動作，並顯示回覆期限。表單仍不顯示金額。

• 承辦人待辦通知：供應商回覆拉回後，承辦人左側「待辦事項」出現「供應商回覆」通知；

承辦人套用或忽略該回覆後，通知自動消失。

變更

• （內部）協同追蹤表廣義化：追蹤欄位由採購專用改為通用——單號、單據別、

客戶廠商代號、類別（客戶／廠商）等欄位，讓同一套協同流程可套用到採購單以外的單據別。

刪除

• 無。

Breaking Changes

• 無面向使用者的破壞性變更。內部追蹤表欄位改名（採購單號→單號、供應商統編→統一編號等）

以冪等 migration 處理，見 Migration Notes。

Migration Notes

• 正式機部署執行 sql/pocollab-portal-deploy.sql（含追蹤表欄位改名／新增的冪等 migration，

可重複執行）。worker 端與表單端契約 v2 已同步佈署。

已知限制

• 套用交期寫回明細目前僅支援採購單（PURCH）；其他單據別可讀取／回覆，但套用交期寫回會被

擋下，待該單據別補寫回支援後再開放（見 ADR 0106）。

2026-07-17 總務模組畫面接線修復＋12 個資料型別註冊補齊

使用者可見變動

• G庫存主檔（GINVENT）可以正常使用了：先前開窗只顯示一行類別名稱（畫面空白）、按上下筆會跳「Cannot create a DbSet」或「Object reference not set」錯誤；現在開窗後點「基本」分頁即可正常瀏覽與導覽資料。

- 已知小瑕疵：開窗當下不會自動選中「基本」分頁，需手動點一下（待後續修正）。

• 總務模組其餘程式（G廠商報價、G採購單、G出入庫單、G出貨單、領料、倉庫表等 8 支）畫面已接上：先前一律顯示空白＋類別名稱。其中仍使用舊版表格元件的程式（如 G廠商報價）開窗會出現「Exception has been thrown by the target of an invocation」錯誤視窗——這是既有的舊表格元件問題，待表格元件升級（dg-to-radgrid）後解除。

• 修復 12 個單據型別的本機資料庫註冊（GPURCH、GSPLACE、PPURCH、PURAMA/TWRAMA/WKRAMA、SALEMA、SAMPLE）：這些單據相關畫面先前導覽即崩潰；同時依兩客戶庫（鈞寶/朝陽）欄位聯集補齊資料欄位與共用審核欄。

技術摘要

1. Model/LocalDbContext.cs 新增 12 個 DbSet（C.總務／E.訂單／G.採購／新增 J.品質區）；smoke baseline 由 126 收緊至 112。

2. TsERP/App.xaml 補 C.GeneralAffair 8 支隱式 DataTemplate（該模組原本零接線）。

3. GinventViewModel.TabSelectedItem 加 null 防護（Tabs 集合從未初始化，靜態分頁 XAML 與動態分頁 VM 的 fork 斷裂）。

4. 14 個 Source 拿掉 (IAppContext context) 建構子改無參（EF materialize 需求），呼叫端連動修改（含 Gstkbas_1TmpPoco、Sample1Source 衍生類 : base()）。

Migration

無需資料庫變更。本機 SQLite 由 EnsureCreated 自動重建新表。

2026-07-16 傳票「未沖帳款查詢」暫時下架；項目編號表「項目分類」標籤可跳摘要檔

傳票（SLIY）：未沖帳款查詢暫時下架

• 右側支援面板的「其他查詢」頁籤（未沖帳款查詢／挑款）暫時移除，新增傳票時也不再自動切到該頁。

• 屬暫時下架（2026-07-16 裁決）：SliyViewModel 移除 ISpecialQuery 介面；要恢復把介面加回並還原建構子的 SpecialQueryContent 與 AfterAddNew 的切頁呼叫即可，SliyBalanceViewModel 本體未刪。

• 手冊 docs/N-GeneralLedger/sliy.md 已同步移除對應段落與截圖佔位。

項目編號表（ACCITEM）：「項目分類」標籤加超連結

• 「項目分類」標籤改用 TsNavigateLabel（比照群組表 GRPM 分類標籤既有模式）：雙擊標籤跳轉摘要檔（SMEMS）並定位到 C227 類別，方便直接維護項目分類選項。

PURCH 採購單畫面調整

日期：2026-07-16

變更內容

• 表頭版面：唯讀欄位（輸入人員、總數量、原幣金額、本幣金額）移到「是否結案」下方集中顯示，標籤顏色統一為系統產生欄顏色；傳真日期移至左欄補位。

• 發送供應商協同按鈕：從採購單號旁移到表頭最右側，獨立成一個直欄與其他欄位區塊並排。

• 運送方式：表頭與明細表格內的下拉選單改為只顯示名稱（原先為代號＋名稱兩欄併排），上下兩處樣式一致。

• 明細表格「結案」「須否成績表」勾選欄經查與增刪修狀態本來就同步（EF 變更追蹤保證），行為不變。

• 本幣金額改顯示本幣合計：原先與原幣金額綁同一個合計值（兩欄永遠同數字），現改為各自加總明細的原幣未稅／本幣未稅。

影響範圍

僅 PURCH 畫面呈現；共用下拉控件新增的「只顯示名稱」模式為選用（預設關閉），其他程式不受影響。

行動儀表板網站：歷史報表保留＋多公司發布專案參數

日期：2026-07-16

變更內容

每次發布保留歷史（原本只留最新一份）

主管行動儀表板網站（Cloudflare Pages，tserp-dash）原本每次排程發布會整站替換，只看得到最新一期報表。現在：

• 每次發布時，來源檔會先累積到發布機的歷史夾（%ProgramData%\TsERP\dash-archive\<專案名>\，檔名含期間，同一期重發覆蓋不重複），再連同全部歷史一起上傳。

• 首頁不變：打開網站仍直接是最新一期報表，右下角多一顆「🗂 歷史報表」浮動按鈕。

• 點入 history.html 是各期清單（最新置頂，附產出時間），點任一期可看當期完整報表。

• 佔位頁模式（-Placeholder，事故蓋台用）不帶歷史；本機歷史夾不受影響，下次真實發布即還原。

多公司：排程參數可指定發布專案

排程任務 Customdash_ScheduledDeck 新增參數「發布專案」：

• 空白＝預設 tserp-dash（現行行為不變，既有排程事件不用改）。

• 填專案名＝發布到該 Cloudflare Pages 專案（一家公司一個專案、各掛各的 Access 白名單）；歷史夾也按專案名分開。

• 新公司啟用前置：在 Cloudflare 建同名 Pages 專案、掛 Access（**必須含 <專案>.pages.dev 與 *.<專案>.pages.dev 兩筆**，缺一即漏）、無痕實測被擋後才發真實數據。

影響範圍

• tools/dash-publish.ps1：新增 -ArchiveDir 參數；dist 打包邏輯改為「最新 index.html＋歷史檔＋history.html」。

• AutoPilot/Customdash_ScheduledDeck.cs：DefaultParameter 加「發布專案」，TryPublishMobile 帶入 -ProjectName。

• 既有排程事件參數不需調整；下次日報發布起自動開始累積歷史。

2026-07-16 表單有驗證錯誤時允許切換其他程式

使用者可見變動

• 表單欄位有紅框（驗證錯誤）時，現在可以直接切換到其他程式。以前只要目前畫面有任何欄位驗證錯誤，點選單裡的任何程式都沒有反應、也沒有任何提示，體感像系統當掉；打單打到一半想切去別支程式查資料會被卡住。

• 切換後資料不會遺失：切走再切回來，打到一半的內容與紅框都還在（程式畫面有快取）。

• 資料正確性不受影響：存檔時仍會完整驗證，有錯誤的資料照樣存不進去。

（此變更取代 2026-07-15 changelog 中「表單有欄位驗證錯誤時切換其他程式被擋的行為維持不變」的敘述——2026-07-16 裁決改為放行。）

技術面

• ViewModel/ProgramNavigator.cs：CanSwitch 移除第一段「目前畫面有驗證錯誤 → 對所有目標程式回 false」的檢查。

• TsERP/ScreenshotAutomation/ScreenshotRunner.cs：同步更新引用該行為的註解（批次截圖仍以權限存在性判定，避免建 VM 失敗跳錯誤窗打斷批次）。

2026-07-16 ACC_SCAN 新增「展開位數上限」（第 5 參數）

變動

• ACC_SCAN 新增第 5 參數＝展開位數上限：ACC_SCAN('目標','範圍別','範圍內容',抬頭,位數上限)。控制逐科目展開時「列到科目代號幾碼為止」，省略＝ 4（多數帳套的明細科目層級）。

- 逐科目展開的結構（大／中／小分類標頭、層級縮排、每科目一列）維持不變。

- 代號長度超過上限的子科目不各自成列，金額由其較短碼的母科目那一列以 % 前綴合計併入——母科目公式自動變成 ACC_xxx('代號%')（例：ACC_IS('1101%') 涵蓋 1101 及其所有子科目）；母科目底下無更深子科目時公式不帶 %。

- 母子科目同時成列不重複計數：母科目與其子科目都在上限內、都成列時（如統制科目 110 與 4 碼 1101 並存），母列只計自身與「未各自成列的子科目」，不用 110% 吞掉已成列的 1101；保證每個科目金額在整份展開中恰被計入一列。

- 孤兒保底：超過上限、但沒有可併入的短碼母科目（母科目不在掃描範圍內）的子科目，仍個別列出，金額不漏。

• 要展更細：把第 5 參數調大，例如 ACC_SCAN('IS','L','營業費用',1,6) 會把 6 碼子科目也各自列出。

• R 範圍別一樣套用位數上限規則（平鋪、不補分類標頭）。

• 參數檢查：第 5 參數若填非正整數（含 0、負數、非數字），公式檢查會報「錯誤」級（第5參數展開位數須為正整數）。

• 兩種引號寫法（各自引號 ('IS','L','營業費用',1,6) 與一組引號 ("IS,L,營業費用,1,6")）都支援；減項（公式前加 -）維持整段以減項計入。

影響範圍

自訂財務報表（ACC_SELFRPT）查詢與 ACC_RPT「模擬表預覽」中的 ACC_SCAN 展開結果。既有寫 ACC_SCAN 的報表列不需改設定——省略第 5 參數者一律套預設 4 碼上限（子科目金額併入母科目列）；要維持逐科目展到更深，補上第 5 參數即可。

2026-07-16 自訂財報公式新增「含子科目」寫法（前綴 %）

使用者可見變動

• 自訂財報（Acc_selfrpt）的算值公式，科目參數多了一種「含子科目」寫法：在科目代號後面加 %。例如 ACC_IS('1101%') 會加總所有以 1101 開頭的科目——含母科目 1101 本身與其下所有子科目（110101、110102…）。

• 適用四個算金額的函式：ACC_IS、ACC_ISA、ACC_BS、ACC_SC。

• 解決的痛點：母科目底下掛子科目、明細金額都記在子科目上時，舊的單一代號寫法 '1101' 是完全比對、算不到子科目，使用者得手動湊一段區間才行；現在寫 '1101%' 一次到位。

• 既有寫法行為完全不變：單一代號 '1101' 仍是完全比對（不含子科目）、區間 '1101~1199' 仍照起迄加總。

!!! warning "% 要放結尾、且是整段前綴比對"

% 只能放在科目代號最後面當前綴合計，不是萬用字元。前綴是整段比對：'1101%' 不會把 1102 算進來；要同時涵蓋 1101 與 1102，請用共同母層前綴 '110%' 或區間 '1101~1102'。

技術面

• LogicBll/N.GeneralLedger/Util_Acc.cs：新增 ParseGLAccountRange helper 統一解析科目參數（單一代號／區間／% 前綴），四支函式改呼叫它。前綴模式把「迄值」定為三個資料來源（TmpSliySum／TmpSliyyear／TmpBudget）中最大的同前綴科目代號，讓既有的 string.Compare 起迄過濾天然涵蓋所有子科目；幣別／部門／借貸／預算／期初等其餘分支一行未動。

• 之所以選 % 而非 *：公式引擎 AccSelfReportEvaluateBll.DecodeFormula 會對原始公式字串以運算子（+ - * /）切割，引號內的 * 會被誤當乘號切壞公式；% 不在運算子集合，安全。

• LogicBll/N.GeneralLedger/Acc_selfrpt/AccFormulaChecker.cs：公式檢查的科目存在性驗證同步支援 % 前綴（改用 StartsWith 判定），查無時沿用原警告訊息。

2026-07-15 自訂面板配置（CUSTOMDASHCFG）操作性調整

變動內容

• 查詢清單可直接拖曳排序：在「自訂面板配置」的查詢清單內按住項目上下拖曳即可調整順序（＝看板查詢與匯出的排序）；原本的「上移／下移」按鈕保留。

• 彙整列印報表下拉改顯示中文報表名稱：原本顯示報表檔名（如 Balance1），改顯示報表抬頭（如「資產負債表」）。查詢清單項目下方與看板側「已選報表」的顯示同步改為中文；舊配置沒存過中文抬頭時仍顯示檔名，重選一次報表即更新。

• 版面精簡：拿掉配置表單外圍的「配置」群組框。

• 匯出項目分頁文字放大（字級 12 → 14），並將分頁與面板內控件統一為 Ts 系列控件（TsTabControl／TsLabel／TsTextBlock／TsComboBox／TsTextBox）。

相容性

• 配置 JSON 新增選填欄位 報表抬頭（僅供顯示；彙整列印比對仍用 報表編號），舊配置照常讀取，無需轉檔。

• 修正開窗時右上稽核面板的綁定錯誤：twork_sys_customdashconfig 補上標準審核五欄（聯絡單id／工作流程／審核人員／審核日期／已審核）。部署需先跑 sql/customdashconfig-add-audit-columns.sql 再更新程式（dev 已跑；正式機待跑）。

2026-07-15 自訂查詢面板匯出 HTML 標題改用公司名稱

變動

• 自訂查詢面板「匯出HTML」與排程報表產出的封面／瀏覽器標題，原本固定顯示「禾久」，改為讀系統設定的公司名稱（公司基本資料 codata 的公司名稱欄）。

• 平台層 DeckExportOptions.公司名 預設值不再寫死客戶名，未帶入時留空，避免其他客戶匯出印成禾久。

影響範圍

自訂查詢面板匯出 HTML、排程報表（ScheduledDeck）各格式輸出、行動版儀表板 HTML。

2026-07-15 崩潰復原改進與全程式開窗體檢

使用者可見變動

• 程式畫面崩潰不再拖垮整個系統：某支程式開啟時若持續發生錯誤（例如畫面元件載入失敗），以前會連跳數次錯誤視窗後整個 ERP 自動關閉；現在改為：第一次只提示錯誤，若同一錯誤重複發生，系統自動把壞掉的畫面清空，其他程式照常使用。

• 「系統錯誤」視窗現在會顯示是哪支程式發生錯誤（內文第一行「程式：XXX」）。以前錯誤訊息可能在切換到下一支程式時才彈出，容易誤判是新程式的問題。

• 表單有欄位驗證錯誤時切換其他程式被擋的行為維持不變；但程式畫面「建立失敗」的殘留狀態不再令所有程式都無法切換。

追加（同日晚間）：舊頁面批次修復

• 18 支原本打不開的程式恢復可用：傳票（SLIY）、客戶資料（CUDATA）、財產目錄（ASSET）、銀行資料（BANK）、發票系列（TICKMIN/TICK3/TUTAX）、MRP、庫存查詢（INVSTK/INVBK1）等。成因為三層歷史問題疊加：舊 TsPage 頁面進不了新容器、查詢條件元件未註冊、畫面模板未登記。

• 44 支舊 TsPage 頁面完成 TsView 遷移；15 支確認尚未移植（薪資、成本、群組維護等，屬移植待辦非故障）。

技術面

• TsERP/App.xaml.cs：全域例外處理改「重發才復原」策略（ADR-0103）。

• ViewModel/ProgramNavigator.cs：CanSwitch 對半毀 context 加 null 防護。

• TsERP/ScreenshotAutomation/ScreenshotRunner.cs：批次截圖模式強化（單支 45 秒逾時、結果逐筆落檔、登入等待 60 分、權限判定去污染）。

• 全程式開窗體檢結果與後續修復清單：.claude/tmp/opencheck-20260715/REPORT.md。

追加（深夜）：查詢條件面板統一

• 15 支查詢程式的查詢條件改到畫面下方的標準查詢區（原本各自畫在畫面上方）：總務入庫帳簿、營業稅媒體申報（401）、MRP、庫存查詢、庫存帳簿、庫齡、樞紐、預測、FillRate、Itemship、AR/AP 查詢、採購查詢、表格設定等。條件內容與預設值不變。

• 這批程式先前無法開窗的問題一併解決；排程報表現在能正確記住這些程式的查詢條件（ADR-0105）。

2026-07-15 行事曆圓點尊重權限

變動內容

• 主視窗右側行事曆的日期圓點（提示當天有事件）改為只統計使用者有權限看的事件。修正前：非管理員雖然在下方清單看不到「系統」類事件，但只有系統事件的日期仍會畫圓點，等於洩漏了看不到的資料存在。

• 「今天沒有事件」與「已被篩選隱藏」的判斷同步改用權限過濾後的事件，無權限的事件不再被當成「被篩選隱藏」。

• 「個人／部門／公司」勾選是暫時的顯示篩選，行為不變：取消勾選只影響下方清單，圓點照常顯示。

2026-07-15 主動警示第二批：六個新警示源＋信件風格統一

新增警示源（warning 信件，於「警示規則」程式啟用與設定門檻）

警示類型	內容	預設門檻

採購逾期未交（PO_OVERDUE）	未結案採購單，預訂交期逾期且尚有未交量，按廠商彙整通知採購	逾期 3 天

委外逾期未交（WK_OVERDUE）	未結案委外派工單，預訂完成日逾期且尚有未交量	逾期 3 天

呆滯庫存（STAGNANT_STOCK）	有庫存但長期無任何出入庫異動的品項（含從無異動紀錄者）	180 天、明細列前 200 筆

退票警示（CHECK_BOUNCE）	收票發生退票（已兌退票／未兌退票／票貼退票）即時通知財務	回看 7 天

排程健康監控（SKD_HEALTH）	排程執行失敗或執行中卡死，通知系統管理員	回看 24 小時、卡死 60 分鐘

郵件佇列監控（MAILQ_STUCK）	通知信死信／滯留／卡鎖，通知系統管理員	滯留 2 小時

• 全部沿用警示框架（ADR 0092）：規則表門檻 JSON、收件人設定、重複警示抑制。

• 新規則預設停用，需在警示規則程式逐項啟用並填收件人。

• 排程掛載：行事曆事件設「執行方法＋Dispatcher=SKD」即可定時觸發（同安全庫存警示作法）。

信件風格統一

• 所有系統警示信改用同一套版面（深藍表頭、紅色警示強調、統一字體字級）；風格集中於

資料庫函數 TWORK_FN_HTML_STYLE，日後調整一處生效（ADR 0104）。

• 朝陽「送樣未合格通知」信件由無樣式舊版改為標準版面（內容欄位不變）。

部署注意（正式機）

1. 先跑 sql/html-fn-deploy.sql（風格函數，警示 SP 相依它）。

2. 再跑各警示源 deploy：po-overdue、wk-overdue、stagnant-stock、check-bounce、

skd-health、mailq-stuck，以及 refit 後的 ar-overdue-deploy、check-due-deploy。

3. CY 另跑 cy-sample-notify-restyle-deploy.sql（送樣通知改版）。

4. 皆需 sqlcmd -f 65001（含中文），跑完看各檔結尾驗證區。

2026-07-15 ACC_SCAN 展開補序號／分類標頭縮排／模擬表列號修正

變動

• ACC_SCAN 展開列帶序號：展開出來的每一列序號＝母公式列序號＋子流水（如 000005-01），在模擬表預覽與查詢結果中可直接看出該列由哪條掃描公式產生。純顯示用，不寫回報表設定。

• L/M/S 掃描自動產生分類標頭與縮排：依大／中／小分類補純文字標頭列（無公式），縮排比照 ACC_BSCE——大分類 0 格、中分類 2 格、小分類 4 格、科目列 6 格。R（科目範圍）掃描維持平鋪不變。

• 模擬表預覽列號修正：原本列號出現 1、10、11、2 跳著排——根因是 _sheetno 的 ACC_RPT 序號長度登記為 0，列號完全不補零，格線字串排序就亂了。現列號寬度至少取總列數位數，保證等寬可排序。

• 模擬順序修正：新增尚未存檔的公式列（序號空白）原會排到模擬結果最前面，改排最後（與存檔後被編到尾端一致）。

影響範圍

自訂財務報表（ACC_RPT 維護的「模擬表預覽」按鈕）與 ACC_SELFRPT 查詢的 ACC_SCAN 展開結果。既有報表不需改設定。

2026-07-14 簽核流程修復（送簽通知、核准生效、退件回上一關）

行為修復（原本壞掉、現在會動的）

• 核准真正生效：按「同意」後，關卡完成率確實更新、全部關卡完成時來源單據會蓋上

審核章（已審核=Y）並鎖定不可修改。（修復前核准只在畫面上看起來成功，後端從未寫入。）

• 代理人可以簽核：有被設定為代理人（組織代理關係）的使用者，現在可以代處理人核准；

修復前代理判定永遠失敗、只有本人能簽。

• 取消流程生效：取消後流程正確結案。

行為變更

• 退件改為「退回上一關」：在第 N 關按退件，流程回到第 N-1 關重新簽核（退件說明會記錄）；

在第一關退件則整個流程退回發行者重新開始。修復前退件一律整個流程重來。

• 簽核通知改走郵件佇列：送簽、核准（通知下一關）、退件三種事件都會發信通知對應處理人，

由排程服務統一寄送（含失敗重試）；寄信失敗不影響簽核動作本身。

• 待簽清單預設範圍：預設只列「本人＋代理」的待辦；查看下屬待辦的分頁仍在，

但簽核動作僅限本人與代理人。

• 送簽通知改為單一來源（存檔成功後發），修正同一位簽核人收到兩封送簽通知的問題。

2026-07-14 供應商協同入口（採購單交期回覆）

新增

• 發送供應商協同：採購單（PURCH）新增「發送供應商協同」按鈕，對當前採購單產生一次性

安全連結、寄信給供應商。供應商用手機或電腦開連結，即可看到採購單明細（品項、數量、需求交期；

不含單價與金額）並回覆：一鍵確認訂單、逐行調整交期（可含數量）、或拒接並附備註。

• 供應商回覆審閱（POCOLLABRPY，掛在採購模組）：採購人員檢視供應商回覆，逐行對照原交期與

供應商回覆的新交期，決定「套用交期到採購單」或「忽略」。套用後才會更新採購單的預訂交期並留下紀錄；

系統不會自動改單。

• 逾期未回提醒：供應商在期限（預設發送後 14 天、到期前 3 天起）內未回覆，系統會寄信提醒

當初發送的採購人員（一天一封彙整）。此提醒預設關閉，由警示規則啟用。

安全與行為

• 供應商連結有 14 天效期、可撤銷；重新發送會使舊連結失效。

• 連結本身即權限（無需帳號密碼），請勿轉發給非供應商。

• 入口只顯示該採購單的明細，不顯示任何金額；供應商無法看到其他採購單或其他供應商的資料。

• 供應商的回覆為「快照」，採購人員審閱後手動套用，不即時改動採購單。

2026-07-14 主管行動端儀表板（排程寄送行動版 + 受控網址）

新增

• 行動版報表格式 HTMLMOBILE：排程報表（行事曆事件 Customdash_ScheduledDeck）的

「格式」參數新增 HTMLMOBILE（別名 MOBILE），產出手機直立可讀的卡片流 HTML，

檔名尾為 _mobile.html；可與 HTML、EXCEL 等並列多選。

• 寄信標註：信件內文會把行動版附件標為「（行動版）」並提示用手機瀏覽器開啟。

• 發布到受控網址（選用）：排程事件參數新增「發布網址」（預設不啟用）；設 Y 時

寄信成功後自動把最新行動版推上受 Cloudflare Access 保護的網址，主管手機開網址即看。

需在 worker 環境設定 Cloudflare 憑證與 DASH_ACCESS_CONFIRMED=Y（Access 驗證完成的明示確認）。

行為變更

• 排程報表檔名加期間段：<配置名>_<期間>_<產出日>（期間＝目標月 yyyyMM 或「當期」），

例 財務報表_202606_20260714_mobile.html。原因：同配置的日報與週報同日產出時舊檔名會互相覆蓋。

保留天數清理同時認得新舊兩種檔名，既有舊檔照常清理。

• 行動版隱藏零值：整列全為 0 的資料列不顯示；數值欄的 0 顯示為空白（代號欄如「0001」不受影響）。

桌機版 HTML／Excel 不變。

2026-07-14 多語言覆蓋補完

改善

• 多語言覆蓋率大幅提升：全系統畫面（XAML）的多語言真實覆蓋率從約 29% 提升到約 74%。

原本大量畫面標籤、表格欄位標題是寫死的中文或英文，切換英／日／越語系時會露出原文；

本次把有多語言基礎的一般程式補齊四語（繁中／英／日／越），切語言時會正確翻譯。

• 英文介面中文化：部分畫面（多為進退貨、統計、報表頁）表格欄位標題原本是英文（如 Line No、SKU、

Unit Price），現已改為中文並補上多語言，中文介面不再露出英文欄名。

修正（順帶清理的既有問題）

• 移除 25 個「永遠空白」的欄位：這些表格欄位綁定到不存在的資料屬性，任何情況下都顯示空白（既有缺陷），

已移除。

• 下架一張空白舊頁：應收對帳的舊列印預覽頁（已被新版取代、開啟即空白）已下架。

已知限制

• 少數畫面（客戶專屬客製版、部分舊式視窗）尚未納入，之後按需補做。

• 自動翻譯的專業術語建議由熟悉業務的人員過目校正。

• 部分表格欄位標題在非中文語系下仍顯示中文（底層命名機制的既有限制，中文顯示不受影響）。

2026-07-14 群組表維護（GRPM）：新增「使用狀況查詢」分頁

變更

• 群組表維護畫面改為兩個分頁：

- 群組資料：原本的群組維護內容（欄位、明細）完全不變。

- 使用狀況：查出目前這個群組代號被哪些主檔資料引用，結果列在表格。

• 使用狀況分頁行為：

- 切到分頁時，依「群組別」自動查對應主檔（品號→品號檔、客戶→客戶檔、廠商→廠商檔、科目→科目群組、總務品號、費用、工作中心、稽核）。

- 上方顯示目前群組代號與群組別；提供「查詢」按鈕可手動重新整理。

- 隨主檔上一筆／下一筆切換自動更新（同一筆重覆切分頁不會重覆查詢）。

- 群組別為「區域」或未設定時，顯示「此群組別尚未支援使用狀況查詢」。

影響範圍

• TsERP/B.BasicData/Grpm.xaml（加分頁）、ViewModel/B.BasicData/Grpm/GrpmViewModel.cs

• 新增 LogicBll/B.BasicData/GrpmUsageBll.cs

• 查詢走既有通用查詢 SP（DARB_GETDATA4），不需部署任何資料庫物件。

詳細取捨見 ADR 0099。

2026-07-14 自訂查詢面板瘦身＋新程式「自訂面板配置」（A.系統資料）

變更

• 新程式「自訂面板配置」（A.系統資料，標準增刪修程式）：自訂查詢面板的配置管理集中到這裡——

- 標準工具列：瀏覽（只列自己的配置）、新增、修改、刪除、存檔。

- 表單：配置名稱、使用部門。

- 「查詢清單」分頁：組裝配置內容（選查詢程式→原生條件畫面設條件→加入/更新條件/移除/清空、每項自訂標題、上移/下移），並可對選中的查詢直接下拉改「彙整列印報表」。

- 「匯出項目」分頁：直接內嵌在畫面上（不再開視窗）——拖曳排序匯出頁順序、新增/編輯/停用報表與圖表顯示項目；「儲存顯示項目」立即生效（全部配置共用），匯出順序則隨「存檔」存進該配置。

• 自訂查詢面板調整：

- 查詢區：既有設置下拉（選了即載入）、查詢清單、目標月份＋整批換月；點查詢清單的項目會顯示該查詢的條件畫面，可臨時調整後按「更新條件」（只影響本次，不會改配置）。

- 儲存設置、刪除設置、配置名稱、使用部門、選程式/加入/移除/清空等管理功能移除（改到「自訂面板配置」操作）；主工具列移除「匯出設置」鈕，保留 彙整列印、匯出HTML。

• 排程報表（ScheduledDeck）的匯出頁順序改為套用配置存的「匯出項目順序」，與手動匯出一致。

影響範圍

• 新程式需登錄後才可用：sql/customdashcfg-register-program.sql（選單＋瀏覽用 _sheetno，待部署；開發環境 dev-programs.json 注入＋重登，但瀏覽也需要先跑 SQL 的 _sheetno 段）。

• 既有配置完全相容；看板選配置、查詢、列印、匯出行為不變。

詳細取捨見 ADR 0096。

2026-07-14 — 會計科目維護：分類連動與群組代號

會計科目維護（Accl）

• 大分類／中分類／小分類三個下拉連動：

- 選了大分類，中分類與小分類的選項自動縮小到該分類底下。

- 選了中分類，會自動帶入大分類；選了小分類，會自動帶入大分類與中分類（可對應到多個上層時不亂帶，維持原值）。

- 選上層分類不會清掉已填的下層分類，只縮小選項。

• 新增「群組代號」欄位：可搜尋科目群組（群組表中群組別＝科目的群組），選了之後自動帶入大／中／小分類，群組代號會隨科目儲存。

• 分類下拉的選項來源（摘要檔）與科目群組表已依現有科目資料重建完成；分類資料有疑義的科目已另列清單待與客戶確認。

注意（IT／部署）

• 本次需搭配資料庫腳本 sql/accl-tier-grpm-seed.sql（新增 accl.群組代號欄＋重建摘要檔與科目群組）。先跑腳本再發版，否則開啟會計科目維護會出錯。

2026-07-14 — 自訂財報百分比欄修復

自訂財報（ACC_SELFRPT）

• 修復：百分比欄位一律顯示 0 的問題。報表定義（acc_rpt）「百分比基準」欄填 Y 的那一列，現在會正確作為基準——全表每列的 當期百分比／總計（合計）百分比／當月百分比 ＝ 該列值 ÷ 基準列值 × 100（四捨五入取兩位；基準值為 0 時該欄為 0）。原因：查詢建立輸出列時漏帶「百分比基準」欄位，導致引擎永遠找不到基準列。

• 修復：列印／匯出（N130 報表）「今年當期百分比」誤印成「今年總計百分比」的欄位錯置。

使用方式

在財務報表格式維護（acc_rpt）想當分母的那一列（例如「銷貨收入」或「營業收入合計」）的「百分比基準」欄填 Y 即可；一張報表取第一個 Y 的列為基準。

2026-07-14 — 自訂財報新增 ACC_SCAN 掃描公式與模擬表預覽

自訂財報公式（ACC_SELFRPT）

• 新增 ACC_SCAN 掃描函數：一列公式自動展開成多列（每個符合條件的會計科目一列，抬頭＝科目名稱）。

- 寫法：ACC_SCAN('ISA','L','營業費用',1)

- 參數1＝目標函數：ISA、IS、BS、SC、CF（展開成 ACC_ISA('科目') 等）

- 參數2＝範圍別：L 大分類、M 中分類、S 小分類、R 科目範圍

- 參數3＝分類內容，或 R 時的 起始科目~截止科目

- 參數4＝抬頭：1＝科目名稱（目前僅此一種，可省略）

- 前面加 -（如 -ACC_SCAN('ISA','L','營業收入',1)）可讓展開的每列公式都帶負號。

- 引號寫法兩種都可：每參數各自引號，或一組引號內含逗號（ACC_SCAN("ISA,L,營業費用,1")）。

財務報表格式維護（acc_rpt）

• 新增「模擬表預覽」按鈕：不需執行查詢，直接列出目前公式明細展開後的報表列（列號／序號／抬頭／公式／列印碼），方便確認 ACC_SCAN、ACC_BSCE 會展出哪些科目。

- 注意：ACC_BSAUTO 依實際查詢期間有異動的科目展開，模擬時不會產生列。

• 新增「公式檢查」按鈕：一鍵檢查所有明細公式，結果依嚴重度分級列出。

- 錯誤（查詢會當掉或必然算錯）：函數名打錯或大小寫錯、括號／引號不配對、ACC_SCAN／ACC_BSC 參數不合法、ACC_ISTB 引用的單一序號不存在。

- 警告（不會當，但結果必為 0 或空）：科目／分類／引用序號範圍查無資料、ACC_SCAN 展開後 0 列、ACC_ISTB 引用計算順序排在自己後面的列、展開巨集同一列混寫其他內容。

- 檢查不需執行查詢；全部通過時直接提示「未發現公式設定問題」。

下拉選單項目提示（ToolTip）修正：不再顯示程式型別名稱

日期：2026-07-13

使用者可見變動

• 自訂查詢面板 →「彙整列印」選擇報表的下拉選單：滑鼠移上時的提示（ToolTip）原本會顯示 ViewModel.Control.Layout.PrintLayout.ReportPrintSource 之類的程式型別名稱，現在正確顯示該下拉內的報表清單（例：1.出貨日報表、2.應收帳款明細 逐行列出）。

• 無報表而停用的查詢列，滑鼠移到下拉上現在會顯示「無報表的查詢無法列印」的原因提示（先前停用狀態不會出現任何提示）。

• 本修正在平台層（TsComboBox）生效：所有使用 DisplayMemberPath 顯示自訂物件清單的下拉選單，若曾出現同樣的型別名稱提示，一併修復。

備註

• 根因：下拉項目提示在「項目來源已設定、顯示欄位路徑尚未生效」的瞬間產生，取不到顯示文字時退回物件預設字串（即型別全名），且之後不會重算。現改為顯示欄位路徑生效時重新產生提示。

• 純前端控件修正，無資料庫部署需求；runtime 尚未開窗驗收。

排程報表自動寄送：任何自訂查詢面板配置可排程產檔寄信

日期：2026-07-13

使用者可見變動

• 新排程方法「排程報表自動寄送」（自動執行方法 ScheduledDeck）：在行事曆排程事件掛上後，系統會定時把指定的自訂查詢面板（CUSTOMDASH）儲存配置整頁跑一遍（含各分頁查詢與圖表），產出 Excel＋HTML 檔，作為附件自動寄給指定收件人——財務部月報、業務月報從此無人值守。

• 排程參數：配置 pkid、格式（預設 EXCEL,HTML）、收件人（逗號分隔，必填）、輸出目錄（預設 C:\temps\排程報表\）、月份（支援 {-d1} 上月自動平移——每月 1 號排程自動產「上個月」的報表）、保留天數（預設 30）。

• 郵件佇列支援附件：排程信可帶多個附件；既有寄信行為不變。

• 產出檔留存：檔案保留在輸出目錄供事後稽核，超過保留天數的舊檔於下次排程自動清理（只清本功能產出的檔案，不動目錄中其他檔案）。

• 排程事件清單上的顯示文字為人話摘要，例：「排程報表：配置#3（當期）→ 收件人 2 人，格式 EXCEL,HTML」。

備註

• 需在排程器（SchedulerWorker）設定檔設定 headless 登入帳號（ScheduledDeck 節）；正式環境建議帳密改走 Azure Key Vault。

• PDF 格式本期未支援（匯出引擎無 PDF writer），指定 PDF 會記警告略過。

• 正式環境部署需執行：sql\mailqueue-attachment-deploy.sql（附件欄＋DEQUEUE SP）、sql\mailqueue-enqueue-deploy.sql、sql\alertlog-skd-deploy.sql、sql\autopilotmethod-register-deploy.sql（選用字典）。

• 同步修正：金流跌破警戒警示（ADR 0092）的排程資料存取改走排程派發器，修正排程環境下無法入列的問題。

對應 ADR 0093；沿用 ADR 0018（郵件佇列）、0065（集中自動化庫）、0083（配置持久化）、0088（彙整匯出）。

2026-07-13 報表預覽：按鈕順序調整＋彙整浮水印修正

變更

• 預覽工具列按鈕換位：「列印」與「匯出PDF」對調，順序改為 列印 →（中一刀列印）→ 匯出PDF → 匯出EXCEL → 搜尋 → 浮水印 → 大綱。

• 修正：自訂查詢彙整列印（合併 PDF）預覽套浮水印後，多支報表只剩一支。原因是 FastReport 內建浮水印「套用到全部頁面」會整份重新產生報表，合併自多支範本的頁面因此被洗掉。修正後浮水印直接套用在已備妥的頁面上，各報表內容保持完整；套完即可照常「匯出PDF」。

影響範圍

• TsERP/TsFastReportPreview.xaml（按鈕順序、浮水印鈕改自訂處理）

• TsERP/TsFastReportPreview.xaml.cs（合併報表浮水印安全路徑）

單一報表預覽的浮水印行為不變。

CUSTOMDASH 整批換月：自訂財報跨年時年度連動

日期：2026-07-13

變更

自訂查詢面板（CUSTOMDASH）的「整批換月」碰到自訂財報（ACC_SELFRPT）時，當期的年度與月份改為一起真實平移：

• 跨年換月時 年度 會跟著進位／回溯（例：2026 年 12 月換到下個月 → 2027 年 1 月）。

• 舊行為是年度固定、月份夾在 1–12（12 月 +1 仍停在 12 月），已取消。

• 起訖月份平移後若跨在兩個年度（如 11–12 月換到 12 月與隔年 1 月），年度以截止月份的落點為準，起始月份調整到該年度邊界。

• 截止日期（如 12/31）維持不動。

排程報表自動寄送（ScheduledDeck）的換月走同一套邏輯，行為一併更新。

相關決策：ADR 0089（2026-07-13 修訂段）。

2026-07-13 自訂查詢面板（CUSTOMDASH）：新增「匯出設置」畫面（拖曳排序＋項目維護）

變更

• 工具列新增「匯出設置」按鈕，開啟匯出內容設置畫面：

- 左側清單列出目前面板各查詢的顯示項目（報表/圖表），可拖曳調整順序（也提供上移/下移按鈕），順序即「匯出HTML」的頁面順序。

- 右側可編輯選中項目的完整定義：名稱、圖型、類別欄/數值欄/顯示欄位（下拉提供查詢結果欄位候選）、排序、TopN、篩選、欄位別名、計算欄、逐欄展開。

- 可新增顯示項目、停用（停用列不再出現在匯出勾選清單，設置畫面標灰可重新啟用）。

- 儲存時逐列驗證；若目前有選定配置會詢問是否同步更新該配置的匯出順序。

• 匯出順序會隨「儲存設置」存進配置，下次套用同配置匯出時自動套用；未調整過順序時行為與先前完全相同。

影響範圍

• 新畫面 TsERP/M.EIS/匯出內容設置.xaml＋ViewModel/M.EIS/CustomdashExportSetupViewModel.cs

• twork_sys_chartspec 改為可由程式寫回（LogicBll/CommonSystem/ChartSpec/ChartSpecBll.cs；表遷移見 sql/chartspec-maintain-deploy.sql，需部署）

• CUSTOMDASH 儲存配置 JSON 結構升級為 wrapper（舊配置自動相容）

詳細取捨見 ADR 0095。

2026-07-13 自訂查詢面板（CUSTOMDASH）匯出：新增「隱藏零值」勾選

變更

• 「匯出HTML」的勾選對話框新增「隱藏零值」選項，預設勾選，可取消：

- 資料列中所有數值欄皆為 0 的整列不匯出（純文字列與合計列不受整列過濾影響）。

- 數值為 0 的儲存格顯示空白，不再顯示 0（含合計列）。

• HTML 與 EXCEL 兩種匯出格式皆適用（EXCEL 目前預設未開啟產出，開啟後同樣生效）。

• 取消勾選時輸出與先前完全相同；排程寄送（ScheduledDeck）路徑行為不變。

影響範圍

• LogicBll/CommonSystem/Reporting/ReportDeckDtos.cs（DeckExportOptions.HideZeroValues）

• LogicBll/CommonSystem/Reporting/HtmlDeckWriter.cs、ExcelDeckWriter.cs（整列過濾＋零值留白）

• ViewModel/M.EIS/CustomdashExportSelectViewModel.cs、CustomdashViewModel.cs

• TsERP/M.EIS/自訂查詢匯出選擇.xaml（新增勾選框）

主動警示通知：應收逾期／票據到期／金流跌破警戒自動寄信

日期：2026-07-13

使用者可見變動

• 新增三種自動警示信（由排程觸發，經既有郵件佇列寄出）：

- 應收逾期帳款通知：逾期超過門檻天數（預設 30 天，可調）的未沖應收清單，含客戶／單號／到期日／逾期天數／金額與合計。

- 票據到期通知：未來 N 天內（預設 7 天，可調）到期的收票／付票清單（收付票可分別開關），含票別／票號／到期日／金額。

- 金流預測跌破警戒通知：金流預測的累計淨額首次跌破警戒線時通知，含首次跌破月／警戒線／最低累計淨額。只通知首次跌破——跌破月與警戒線沒變不會重寄。

• 同一警示不轟炸：警示內容沒變時，抑制視窗（預設 24 小時，可調）內不重寄；內容有變（例如逾期名單多了一張單）會照常通知。

• 警示設定集中維護：門檻、收件人、啟用開關、抑制時數收斂到新的警示規則設定（警示規則維護頁）；規則未設收件人時沿用行事曆事件的「通知帳號」，既有安全庫存警示行為不變。

• 金流預測畫面的「資金警戒線」數值現在可持久化到警示規則（原本只在畫面上手填、關窗即失）。

備註

• 通知通道本期為 Email（Mailgun）。LINE Notify 服務已於 2025-03-31 終止，如需 LINE 通知須另行申辦 LINE 官方帳號走 Messaging API，列為後續選項。

• dev 環境已完成三輪功能實測與排程器端到端真寄驗證；正式環境需部署：sql\alertrule-deploy.sql、sql\alertlog-deploy.sql、sql\ar-overdue-deploy.sql、sql\check-due-deploy.sql（正式機 proc_param 為 IDENTITY，用腳本檔頭註明的不帶 pkid 版）。

• 金流跌破警示的排程實跑（行事曆事件觸發）尚未 runtime 驗收。

對應 ADR 0092（主動警示框架）；通道與佇列沿用 ADR 0018、排程沿用 ADR 0065。

AI 查詢：自然語言問句可一鍵開啟查詢程式；資料列不再送雲端模型

日期：2026-07-13

使用者可見變動

• AI 查詢視窗（admin）新增「開啟查詢」動作卡：用自然語言提問（例「上個月哪個客戶毛利最低」）後，AI 會判斷該用哪支查詢程式、幫你填好查詢條件，回覆下方出現卡片與「開啟查詢」按鈕；點擊即關閉 AI 視窗並開啟該程式（例：毛利率分析），條件已預填、不自動查詢——你可以先確認或微調條件再按查詢。

• 首波支援 13 支常用查詢程式（毛利率分析、訂單/出貨/進貨查詢、客戶資料、庫齡呆料、金流預測等）；「毛利」類問題固定對應毛利率分析（QRY_PROFIT_NOGI）。

• 資料安全強化（預設生效）：AI 對話中的查詢不再把實際資料列傳給雲端模型——模型只知道欄位結構與筆數，明細請透過「開啟查詢」在程式內查看；聊天內圖表改由本地繪製（資料不經模型）。此行為由系統參數 AI_ROWS_TO_MODEL 控制（預設關閉）。

• AI 產生的查詢條件經過多重驗證（程式白名單、欄位存在、運算子合法、值型別檢查）才會開窗；個別條件套用失敗會明確提示，不會靜默遺漏。

• 毛利率分析新增預設圖表「客戶毛利額前十五」（需部署 chart-spec）。

備註

• 入口維持 admin 帳號限定；一般使用者開放與逐使用者資料權限過濾為後續議題。

• 測試指令 /testcard（僅開發版）可不接模型驗證動作卡。

• 對應 ADR 0094；沿用 ADR 0007/0027/0030（AI 查詢閘道與稽核）、0091（運算子口徑）。

2026-07-13 自訂財報（ACC_SELFRPT）：查詢時清空舊結果＋執行中指示

變更

• 按下「查詢」後立即清空上一次的查詢結果，避免查詢執行期間舊資料被誤讀成新結果。

• 查詢執行期間，表格區顯示忙碌指示（轉圈），查詢完成自動消失。

影響範圍

• ViewModel/N.GeneralLedger/Acc_selfrptViewModel.cs（Query 先清空＋IsQuerying 旗標）

• TsERP/N.GeneralLedger/Acc_selfrpt.xaml（RadBusyIndicator 包住結果表格）

報表編號未輸入時的行為不變（僅提示訊息）。

2026-07-12 — 查詢條件運算子依欄位型別過濾

使用者可見變動

查詢視窗的「條件」面板，運算子下拉選單現在會依欄位型別只顯示合理的運算子，行為對齊表格（RadGridView）內建篩選：

• 文字欄：全部運算子（等於、開始於、包含、被包含…，含大於/小於等區間比較）。

• 數值欄：等於、不等於、大於、小於（及等於）、被包含、介於之間…；不再出現「開始於／包含」等文字專用運算子。

• 日期欄：等於、不等於、大小比較、介於之間…；不再出現文字運算子與「被包含」。

• 是/否（布林）欄：等於、不等於、等於 Null、不等於 Null。

• 切換欄位後，若原本選的運算子在新欄位型別已不適用，會自動改回「不等於」。

「套用此條件／不套用此條件／介於之間」等自家延伸運算子在各型別維持可用。

相容性

• 既有已存的預設查詢條件不受影響（運算子代碼未重編，僅限制「新選」時的可選項）。

• 布林欄位的等於/不等於查詢 SQL 修正為 = 1 / = 0。

詳見 ADR 0091。

金流預測：下圖改堆疊式瀑布圖、版面調整

日期：2026-07-11（2026-07-12 更新為堆疊式瀑布；2026-07-13 改為月階梯瀑布並移除來源組成瀑布）

使用者可見變動

• 金流預測（FLOWCAST） 畫面的下方圖表由原本的「收付堆疊柱圖」改為 堆疊式瀑布圖：

- 每個月仍依 四來源（票據／帳款／訂單／採購）分色堆疊、收向上／付向下，但整根柱不再從 0 起算，而是錨在「前期累計淨額」基線上浮動——柱的堆疊頂／底恰好接到本期累計，因此下圖的柱與上圖的累計淨額折線相互呼應，一眼看出每個月是哪些來源把現金往上推或往下拉。

- 點柱段過濾：點某來源的收（或付）段，明細分頁會過濾到該月 × 該來源 × 該收付；再點同段取消、點空白清除。

- 上方「來源」勾選（票據／帳款／訂單／採購）照舊即時開關；某來源取消勾選時，該色段會變成 0 高度自動消失。

• 版面比例調整：圖表區放大、數據（明細／彙總）區縮小（由 2:3 改為 3:2）。

• 圖表區加上外框（淺灰圓角邊界）。

• 圖表區改用分頁（2026-07-12）：原本累計淨額線圖與瀑布圖上下相擠，改成三個分頁——「累計淨額趨勢」「金流瀑布」「來源組成瀑布」，各佔整個圖表區、各自帶時間軸標籤與圖例。

• 新增「來源組成瀑布」分頁（2026-07-12）：把整個查詢區間的淨現金變化，拆成四來源的淨貢獻階梯（票據 → 帳款 → 訂單 → 採購 → 期末淨變化），淨流入藍、淨流出橘、期末總計深藍灰，柱上顯示各步淨變化金額，滑鼠移上顯示名稱／金額／佔比。

• 「金流瀑布」分頁改為逐項順序堆疊（2026-07-12）：每月的瀑布柱改依 票據收 ＋ → 票據支出 － → 帳款收 ＋ → 帳款支出 － → 訂單收入 ＋ → 採購支出 － 的順序逐項疊出，末端落在該月累計淨額（原為「所有收往上、所有付往下」的分組堆疊）。

• 條件列改版（2026-07-12）：查詢條件（預測顯示區間／帳款立帳起日／資金警戒線）改成左側三排「標籤＋輸入框」對齊排列，右側新增「計算方式與口徑」說明框（列出每月現金淨變化公式與各來源可信度）。

• 「金流瀑布」改為月階梯瀑布（2026-07-13）：X 軸＝月份，每月內六段依 票據收 → 票據付 → 帳款收 → 帳款付 → 訂單收 → 採購付 順序並排階梯（原重疊堆疊在收上付下時會互相遮蓋），深色＝收（往上）、淡色＝付（往下）；每月末段收在該月累計淨額＝下月首段起點，另加一條灰色累計淨額階梯線把前後月視覺銜接起來。

• 移除「來源組成瀑布」分頁（2026-07-13）：整區間四來源組成的視角改由月階梯瀑布涵蓋（X 軸統一為月份），圖表區回到「累計淨額趨勢」「金流瀑布」兩分頁。

• 條件區說明補詳細口徑（2026-07-13）：說明框逐來源列出資料來源與日期依據——票據（票況範圍、預兌日→到期日）、帳款（rp_m 未沖、單據分類 AR＋/AP＋、到期日→收付條件 PAYMENTTERM 推算→立帳日）、訂單／採購（未交數量×含稅單價、回覆日期→預訂交期＋收付條件 PAYMENTTERM 推算）。

備註

• 本版本 Telerik RadChartView 無原生瀑布圖，月階梯瀑布以 6 條 RangeBarSeries（浮動柱、CombineMode=Cluster 同月並排）＋各段依前期累計計算的絕對座標＋ StepLineSeries 累計淨額銜接線實作。

• 純前端與 ViewModel 變更，無資料庫部署需求。

• runtime 尚未開窗驗收。

延續 ADR 0084（金流預測圖表拆雙軸）。

BOR 新增「循環稽核」按鈕

日期：2026-07-10

使用者可見變動

• Bor（上位/下位組織結構維護） 畫面備註欄下方新增一顆 「循環稽核」 按鈕。

• 按下後對全部類別碼（替代／下屬／部門／客戶／廠商／工作中心）的上位/下位關係做循環參照偵測：若存在 A→B→…→A 這種繞回自己的循環鏈，會彈出結果表格視窗列出每一條循環（類別碼／起點編號／循環點編號／循環路徑／層數）；沒有循環時提示「循環稽核完成：查無循環參照。」

• 只稽核「當前生效」（依生效起訖日）的關係。

部署需求

• 需在資料庫執行兩支腳本並實查驗證：

- sql\TWORK_QRY_BOR_CYCLE-deploy-5.sql（建立 SP，csa 五帳套）

- sql\TWORK_QRY_BOR_CYCLE-procparam-log5.sql（proc_param 登錄，log 五庫）

• 換別家客戶：照該客戶實際庫名整批取代後再跑。

詳見 ADR 0090。

2026-07-09 自訂查詢面板「整批換月」支援自訂財報

變動

CUSTOMDASH 自訂查詢面板的整批換月現在也會換到 ACC_SELFRPT（自訂財報） 的當期月份：

• 按「整批換月」並選目標月份時，清單中的財報 tile 會把「當期起始月份」與「當期截止月份」兩個月份同步平移到目標月（兩者移動同樣的月數，維持當期區間寬度）。

• 清單即使全部都是財報（沒有一般日期查詢），也能判斷來源月份並換月；先前這種情況會跳出「清單中的條件都沒有日期欄位」而換不了。

注意

• 年度不會被換月改動：只平移兩個當期月份，年度、截止日期 維持不變。因此跨年換月（例如 12 月的報表想換到隔年 1 月）月份會停在 12／1 不外溢——同一年度內逐月推進不受影響。

• 換月改的是設定端查詢清單的條件；換完仍需按「查詢」重新產生面板才會看到更新後的結果（與原本行為一致）。

• 財報的抓數區間（由年度＋截止日期決定）不受此次換月影響，換的只是報表中「當期」欄位的計算月份範圍。

對應

• ADR 0089

• runtime 尚未實機驗證（單元測試 35/35 通過）。

2026-07-08 費用攤提報表（ACCEXP）列印上線

摘要

費用攤提列印（AccexpPrint）程式原本有查詢參數面板但按不出報表（舊列印邏輯是停用的 Crystal 殘碼）。本次把兩張報表 當月攤提報表 與 年度攤提總表 轉成 FastReport 並接好整條列印管線，使用者現在可從程式實際列印／預覽。

新增

• 當月攤提報表（Accexp1）：依「起始／截止費用編號」範圍與「年度／月份」列出當期各費用的本期攤提、累計攤提。

• 年度攤提總表（Accexp2）：同範圍條件，橫向列出 01～12 月各月攤提金額的年度總表。

• 兩張報表皆掛在既有的「費用攤提列印」程式，沿用畫面上的年度／月份與費用編號起訖條件。

變更

• 「費用攤提列印」的列印按鈕從無作用改為可正常出報表（預覽／列印）。查詢條件面板與欄位不變。

刪除

• 移除 AccexpPrintViewModel 內已停用的舊 Crystal 列印註解碼（無使用者可見影響）。

Breaking Changes

• 無。

Migration Notes

• 報表檔已佈署：Accexp1.frx、Accexp2.frx 已放入報表目錄 C:\dglibrary\REPORTSROOT\Reports\。新機器佈署時，記得將這兩個 .frx 一併同步到該目錄，否則列印會找不到報表。

• 資料來源沿用既有 SP TWORK_RPT_ACCEXP，無需新增資料庫物件。

已知限制

• 簡體中文版（Accexp1cn／Accexp2cn）暫未接線：舊系統僅「鈞寶電子(蘇州)」使用簡體版報表，本次為本公司（非該客戶）只接繁體版；簡體 .frx 已轉好備存，該客戶需要時再接線。

• runtime 驗收尚未進行（未實開視窗按列印驗證資料回填）。

2026-07-06 自訂查詢面板彙整匯出（Excel／PPT／HTML）與宣告式圖表

摘要

自訂查詢面板（CUSTOMDASH）新增 彙整匯出 鈕：勾選各查詢要用的報表後，選一個資料夾，一鍵同時輸出 Excel、PowerPoint、HTML 三個檔。同時導入一套「宣告式圖表」機制——圖表定義存在資料庫，前端依定義自動畫圖，加一張圖不用改程式；資產負債表已率先掛上圖表區示範。

新增

• 彙整匯出（Excel／PPT／HTML）：面板頂端工具列的 彙整列印 (PDF) 旁新增 彙整匯出 鈕。操作與彙整列印一致（逐支查詢勾選、各挑一張報表），確定後選資料夾，系統直接以查詢的原始資料產出三個檔案並自動開啟資料夾。與既有「彙整列印（PDF）」、報表預覽「匯出EXCEL」並存、各自獨立。

• 圖表區：查詢頁面可顯示由「圖表定義」自動產生的圖表（直條／圓餅／折線）。資產負債表第一分頁明細下方已掛上圖表區作為示範；因自訂查詢面板顯示的是各查詢的原生畫面，凡是掛了圖表區的查詢，放進面板後也會一併顯示圖表。

• 匯出檔內含圖表：彙整匯出的 Excel 為 Telerik 原生圖、HTML 為 SVG 圖；PPT 一期先放「圖表位置占位文字框」（原生可編輯圖表為二期）。

變更

• 無既有功能行為變更（純新增按鈕與圖表區；彙整列印、儲存設置、整批換月等既有功能不受影響）。

刪除

• 無使用者可見刪除。

Breaking Changes

• 無。

Migration Notes

• 圖表與匯出圖表需先部署圖表定義：由系統管理者於各客戶資料庫執行 sql/chart-spec-deploy.sql（建表＋示範定義；跑含中文腳本須加 -f 65001 並實查驗證）。

• 未部署時：圖表區不顯示、彙整匯出只輸出表格頁（無圖），功能不會出錯，可照常使用。

• 之後要新增一張圖，只需在資料庫的圖表定義表插入一筆設定，不必改程式、不必重新發版。

已知限制（二期候選）

• PPT 圖表為占位文字框：一期 PowerPoint 檔中，圖表位置以文字框標示；可原生編輯的 PPT 圖表列為二期。Excel 與 HTML 已為真圖。

• 表格頁沿用彙整列印取數，沒有報表的查詢不會有表格頁（圖表頁不受此限）。

• 圖表定義一期支援排序、取前 N 名（TopN）與簡單篩選，不做分組彙總（彙總請由查詢程式本身處理）。

• runtime 驗收進行中。

匯出EXCEL 重寫：彙整列印一支報表一個工作表、不再出現細碎欄位

• 日期：2026-07-05

• 影響範圍：所有報表預覽視窗（TsFastReportPreview）的「匯出EXCEL」；彙整列印（CUSTOMDASH）受益最大

變更內容

• 彙整列印匯出 EXCEL：原本所有報表擠在同一張工作表，現在一支報表一個工作表，工作表名稱＝報表名稱（超過 31 字自動截斷、重名自動補序號）。一支報表有多頁時仍併在同一張工作表。

• 欄位不再細碎：匯出改用非 Wysiwyg 模式——原本會沿報表物件邊緣切出大量超細欄、跨欄標題被截半；現在改用較粗的欄格，出來的檔案可讀可編輯。

• 縮字貼合：文字塞不下儲存格時自動縮小該格字型完整顯示，不再被隔壁儲存格遮住

（在 OOXML 層整片補上——FastReport 自帶的 ShrinkToFit 量測偏窄會漏，SpreadProcessing 轉存又會把它丟掉）。

• 列高補足：列高低於該列最大字型所需高度時自動拉高（只加高不縮矮）——修「標題整個看不到」

（實例：資產負債表 18.7pt 標題被壓在 8.51pt 的列裡）。

備註

• 版面精度換編輯性：非 Wysiwyg 匯出與預覽畫面不會 100% 相同（要完全一致請用匯出 PDF）。

• 若個別報表匯出後版面不理想，請反映報表名稱。

BOM流程圖查詢：切到「流程圖圖形」後左側清單上下鍵失效——修正

• 日期：2026-07-05

• 影響範圍：BOM流程圖查詢（Bom_flow）

變更內容

• 修正：切到「流程圖圖形」分頁後，左側組件清單按上下鍵只動一格（或完全不動）的問題。現在可以用上下鍵連續瀏覽組件、流程圖即時跟著切換。

• 平移改進：按住空白背景拖曳即可平移視角（原本要按住 Ctrl 再拖）。拖曳節點、滾輪縮放不變。

備註

• 原因：流程圖控件（RadDiagram）在圖形重建時會主動搶走鍵盤焦點——左側清單每按一次上下鍵就重建一次流程圖，焦點隨即被搶走，下一鍵就沒反應。

• 修法：擋掉「非滑鼠操作」的焦點進入；滑鼠實際點在流程圖上時照常取得焦點（拖曳、縮放不受影響）。

2026-07-05 流程圖製程表與階層式製程表拆回兩支獨立程式

對應 ADR 0087（取代 ADR 0076 併版）。

使用者可見變動

• 流程圖製程表（BOM_FLOW） 回歸單純流程圖用途：

- 查詢條件精簡為 起訖品號 / 去除重複 / 計算流程圖。

- 移除先前併入的階層式專屬條件（查詢類別、生效日期、工時別、數量方式、母件方式），以及 自訂條件、文件說明、製程檢查基準分頁。

- 樹狀展開、流程圖、流程圖圖形、多階材料、含插件等分頁維持不變。

• 階層式製程表（BOM_HIER） 改為獨立程式（原本併在流程圖裡）：

- 完整保留 VFP 階層式查詢能力：查詢類別（品號／客戶代號暨品號）、起訖品號、客戶區間、生效日期（本日／指定日期）、工時別（標準／改善前／改善後／備料）、數量方式、母件方式、自訂條件、只顯示工時。

- 自訂條件旁提供 「泛用取品號」按鈕（可由 Excel 品號清單一鍵組成查詢條件）。

- 明細表欄位順序對齊 VFP 原版。

- 選單位置：D.設計 → 階層式製程表。若權限管理中看不到，請開啟該程式的瀏覽權限。

備註

• 兩支現為各自獨立的程式與查詢條件，可分別在「自訂查詢面板（CUSTOMDASH）」加入、各自儲存設定。

• VFP 主檔的「備註」欄本次未帶入（資料源尚未提供）；階層式製程表報表（BOM_H1/H2/H4）另案處理。

2026-07-04 朝陽（CY）庫存模組整支移植（scx_stk_cy）

摘要

VFP 庫存模組 scx_stk_cy（14 class）以三階段流程（兩庫欄位聯集 → VFP 為規格書完整實作 → 報表轉 FastReport）整批移植完成。含 6 支整支新建程式、9 支既有程式補完、5 支轉單子表單、約 50 張報表。全部建置通過；runtime 全未驗，上線前需實機驗收。

新增

• 廠商庫存表 INV_SP（CY 專屬）：年結計算（沿用 DARB_QRY_INV_SP年結）＋ Excel 匯入

• 廠商分攤計算 INV_SP1：三分頁彈窗（調撥廠商/其他單據 FIFO 分攤/稽核上傳），演算法下沉 SQL（ADR 0081）

• 委外申請單 TRINOUT_CY：朝陽委外變體（ADR 0080），含外包查詢、53 委外重算驗證

• 加工單 TRWKMA：主檔維護＋外送回收自動產耗料（DB→DARB_LOG_DB_TO_PD）＋暫收轉入 Tptodb

• 年度盤點產生 INVREC3Y：勾倉儲批次產生多張盤點單（盤點單其他5鈕）

• 轉單子表單五支：NATRLO 不良轉借、TRLIMA_M 借出查詢、NATRRB 轉不良、TRINOUT1 轉異領、TRLOST_S 調整耗料（負庫存分攤）

• 報表約 50 張：八支單據列印（依前置碼自動選版面）、進貨/出貨分析面板（各 3/4 種×含金額）、INVBK1M/GINVBOOK1 對帳、盤點卡/盤點表/盤點標籤（QR 改 FastReport 原生條碼）、TRLILOBI 未歸還明細表

• invbk1 補：計算廠商、廠商追蹤整頁、日記帳過濾、品號/群組條件別、朝陽預設

• trlost 補：盤點退料鈕＋PB→PA 鈕

變更

• trsama「已轉帳款」防呆由警告改為擋下修改（照 VFP，使用者裁定）

• Invrecm 新增查詢改走 DARB_INVREC 原版（TWORK_INVREC 從未部署，屬壞引用）

• trsama 訂單轉出貨導航修復（誤用他模組 ViewModel 的 pkid）

• H.Inventory 全部 15 支 Source 補 LocalDbContext 註冊＋無參建構子（先前 navigate 開窗即崩）

• IOther7/IOther8 介面簽章 void→Task（框架反射建 Func<Task>，void 實作按下即炸）

• 兩庫欄位聯集同步：trinoutd 委外 9 欄、trsama.隸屬客戶、trrafee.進貨單序號、多個 view 顯示欄

刪除

無（美規 Trinout、DARB 英文版報表 plugin 均保留）

Breaking Changes

無（新程式以 dev-programs.json / ProgramClassRouter 疊加，不影響既有客戶）

Migration Notes

1. 模擬環境已部署/登錄：TWORK_QRY_INV_SP1＋proc_param 七筆（INV_SP年結/INV_SP1/TRINOUTE1/TRLOST_S_P2/INVBK1_TRSP/INV_SP2×2/RPT_SPLACE）。正式庫上線時需重跑 sql/ 下對應腳本。

2. CY 切新版時執行 sql/trlost-turn-proc-param-CY.sql 註解段（prgsct1 其他鈕重排）——VFP 在線時不可跑。

3. sql/trwkma-add-darb-log-db-to-pd-nogi.sql 未執行（鈞寶是否使用加工單 DB 流程待確認）。

4. 報表 frx 需同步佈署各機 C:\dglibrary\REPORTSROOT\Reports\；版面為轉檔+手修稿，建議實印後 Designer 微調。

5. 刻意延後：WKDAY_TR 耗料產生視窗（另案）、撿料標籤群、trlost2（VFP 無路徑選到）、tr_sp 分攤編輯（invbk1）、SEEKWKQ、樞紐分析。

進貨/出貨分析報表（VFP trrama_bd / trsama_bd 移植）

摘要

scx_stk_cy 報表批次 R5：移植 VFP 瀏覽分析面板掛的 14 張分析報表，並新建兩支承載視窗。

• 進貨分析 6 張：RA_DE1/2/3（廠商別/產品別/日期別）＋含金額 RA_DE11/21/31

• 出貨分析 8 張：SAL_YR1/2/3/4（客戶/產品/日期/單號）＋含金額 SAL_YR11/21/31/41

新增

• 進貨單（TRRAMA）、出貨單（TRSAMA） 主檔畫面單號旁新增「分析報表」按鈕，開啟分析報表視窗。

• 分析報表視窗（ContentWindow 彈窗）：

- 查詢條件：交易日期區間（預設本月 1 日～今天）＋廠商/客戶代號區間（空白＝全部）

- 報表種類 radio（進貨：廠商別/產品別/進貨日期別；出貨：客戶/產品/日期/單號）

- 「包含金額」勾選 → 改印含 單價/金額 的版本（RA_DE11/21/31、SAL_YR11/21/31/41）

- 預覽 / 列印 按鈕

• 報表頁首顯示查詢條件文字（對應 VFP L_瀏覽查詢條件）。

• 資料源沿用既有 SP DARB_BD_TRRAMA / DARB_BD_TRSAMA（proc_param 已登錄，無需 DB 佈署）。

變更

• 無既有行為變更。

刪除

• 無。

Breaking Changes

• 無。

Migration Notes

• 報表樣板 14 張 .frx 已佈署 C:\dglibrary\REPORTSROOT\Reports\（其他機器需同步佈署）。

• VFP 面板上的「遮罩」鈕（grid 數量欄格式化）與樞紐選單為瀏覽 grid 專屬功能，新版由 RadGridView 欄位格式取代，不移植。

2026-07-03 業務儀表板 + 業務課報告表自動產生

摘要

新增「業務儀表板」（SALESDASH，E.營業收款）與 AutoPilot 排程任務「產生業務課報告表」，

兩者共用同一產生邏輯：ERP 訂單明細 + TTVMA 汽機車銷售統計自動填入業務課報告表 Excel 範本。

新增

• 業務儀表板：本月訂單金額／出貨數量／LOT 數／交易客戶數 KPI 卡片、

各月訂單金額長條圖、本月客戶 Top15 清單。

• 儀表板內「產生報告表」按鈕：指定年月一鍵產出業務課報告表，可勾選是否含 TTVMA 市場資料，

完成後可直接開啟輸出檔。

• AutoPilot 任務 ORMAST / SalesMonthlyReport：可排程每月自動產生（建議每月 18~20 日產上月，

Month 參數用 {-d1}）。

• 自動填寫的工作表：原紙（整年訂單明細）、樞紐1~12月、國內/國外向出貨數、國內/國外LOT、

渡邊總工程、銷貨趨勢表（實績）、營業額（實績）、4W/2W銷售（TTVMA 原表）、

汽/機車市場佔有率、4W/2W銷售趨勢圖。

變更

• 無既有功能行為變更。

刪除

• 無。

Breaking Changes

• 無。

Migration Notes

• 範本檔：C:\dglibrary\REPORTSROOT\Template\業務課報告表範本.xlsx

（SalesReportTemplateBuilder 產生的乾淨空白版；舊人工版備份為同資料夾 -原版備份.xlsx）。

• 「5月-市佔率／5月-暢銷車款／電動車市佔」三頁為外部新聞圖片，仍需人工貼圖。

• 銷貨趨勢表未來月份的客戶預示金額、營業額目標列維持人工維護，程式不覆寫。

• 開發環境入口已加入 dev-programs.json；正式環境需登錄 SALESDASH 程式權限。

報表預覽工具列：「另存新檔」改為「匯出EXCEL」

• 日期：2026-07-03

• 影響範圍：所有報表預覽視窗（TsFastReportPreview）

變更內容

• 工具列移除「另存新檔」按鈕（原為 FastReport 原生存檔對話框，可選多種匯出格式）。

• 原位置改為「匯出EXCEL」按鈕：直接匯出 .xlsx（Excel 2007 格式），選好存檔路徑後自動以預設程式開啟。

• 「匯出PDF」按鈕不變。

備註

• 匯出走已備妥的報表頁面，不重新運算（彙整多支合併的報表匯出結果與畫面一致）。

• 原「另存新檔」提供的其他匯出格式（Word、HTML、圖片等）自此版起不再提供入口；如有需要請反映。

2026-07-03 使用手冊網站改版 + 批次補主畫面截圖

摘要

manual.yanyue.io 全站視覺改版：自訂品牌配色（深松石綠 × 工安琥珀）、新首頁「模組索引牆」（20 個模組字母磚依五大業務域上色，與桌面系統選單代號一致）、新 logo/favicon、字體與導覽功能升級。並以新的批次截圖工具補齊 38 張功能頁主畫面截圖。

新增

• 首頁模組索引牆：五大業務域（基礎資料與系統／銷售與供應鏈／製造與品質／財務與帳務／協作與決策）分組的字母磚導航

• 首頁三步驟使用指引與維運連結列

• 38 張功能頁主畫面截圖（*-step1.png）

• 網站 logo 與 favicon

變更

• 佈景主題配色由預設 indigo 改為自訂色系（亮/暗兩模式皆調整）

• 字體：內文 Noto Sans TC、模組字母與編號 Space Grotesk、程式碼 JetBrains Mono

• 首頁改為隱藏側欄的全寬版面；模組名稱對齊 .nav.yml 正式名稱（如「總務管理」「工程資料」「營業收款」）

• 導覽功能追加：instant navigation、navigation.footer、toc.follow、search.share

刪除

• 舊首頁的模組表格（名稱已過時，由索引牆取代）

• 「欄位比對工具」「欄位比對列印」頁面（DB 維運工具，屬開發者工具非終端使用者功能）

Breaking Changes

無。

Migration Notes

無需動作；push 至 master 後由既有 pipeline 自動部署。

2026-07-03 金流預測圖表拆成上下兩張單軸圖

摘要

「金流預測」的圖表區從單張雙軸圖（6 條收付堆疊柱掛左軸＋累計淨額折線與資金警戒線掛右側第二軸），

改成上下兩張共用時間軸的單軸圖：上圖只畫累計淨額，下圖保留收付堆疊柱。

雙軸讓使用者容易把柱頂拿去跟警戒線比較而誤讀（柱頂是單月收付金額，警戒線是累計淨額門檻，兩者量級不同），

拆成兩張單軸圖後每張圖的縱軸只對應一種量級，避免誤讀。

新增

• 上圖新增警戒區塗色：從資金警戒線到（月彙總最低累計淨額／警戒線取小值再留 10% 緩衝）之間塗淡紅色。

• 上圖累計淨額線跌破警戒的區段改標紅色粗線（含跌破區與正常區的銜接邊界）。

• 上圖新增「最低點」標註（僅最低累計吃緊時顯示）與「首次跌破警戒」標註（僅期間內曾跌破時顯示）。

• KPI 摘要列新增「首次跌破警戒」卡片（期末累計淨額卡之後），有跌破顯示月份紅字、無跌破顯示「—」灰字。

變更

• 圖表區由「一張雙軸圖＋右側圖例」改成「上圖（累計淨額，45% 高）＋下圖（堆疊柱，55% 高）＋跨兩列圖例」。

• 下圖（堆疊柱）不再掛累計淨額折線與右側第二軸，只保留 6 條收付堆疊柱；點柱過濾、來源勾選、

X 軸粒度切換（年月/日期）行為不變。

• 圖例文字「累計淨額（右軸）」改為「累計淨額（上圖）」，新增「資金警戒線」「警戒區」兩列圖例。

• 上圖時間軸（X 軸）標籤隱藏，僅下圖顯示時間軸標籤，避免兩張圖重複顯示。

刪除

• 移除右側第二軸（cumulativeAxis）；金流預測不再有雙軸圖表。

Breaking Changes

• 無（純畫面呈現調整，資料來源與明細/月彙總分頁不變）。

Migration Notes

• FlowcastMonthPoco 新增 跌破值（可為 null）、FlowcastSummaryPoco 新增 首次跌破月／有跌破，

純附加欄位，不影響既有 SP／DB 結構。

• FlowcastComposer 新增 ApplyBaseline(periods, baseline)，取代原本內嵌在 ViewModel 的

「跌破警戒」判定迴圈；Summarize 需在 ApplyBaseline 之後呼叫才能算出正確的「首次跌破月」。

• Runtime 未驗（需開啟金流預測畫面實際操作確認圖表呈現、警戒區位置、標註顯示邏輯），已記入 memory。

2026-07-03 財務月報一期：自訂查詢面板整批換月＋進貨廠商統計

• 自訂查詢面板（CUSTOMDASH）新增「整批換月」：條件區新增「目標月份」與「整批換月」按鈕，一鍵把清單中所有查詢條件的日期平移到目標月份（月底日自動對齊目標月月底，如 5/31→6/30）。載入上個月存的月報配置後不必再逐支手改日期。

• 新增查詢程式「進貨廠商統計」（SPBUYRANK）：期間內進貨（含退貨沖減）按廠商彙總金額、降冪排序、附佔比與合計，供財務部月報「進貨/加工廠商金額統計」使用；可加入自訂查詢面板。

• 毛利率分析（QRY_PROFIT_NOGI）新增兩張報表：客戶別（M160-1）與品號別（M160-2）毛利彙總表，毛利率低於 10% 以紅字標示（FastReport 原生 Highlight，非 script）；補上後此查詢可加入自訂查詢面板的彙整列印。

• 進貨廠商統計新增報表（M-D5-1）：廠商排行列表報表，補齊後可進自訂查詢面板彙整列印。

• 整批換月支援斜線日期格式：條件裡以字串儲存的 yyyy/MM/dd 日期（全系統字串日期標準格式）也會被平移，不再只認 DateTime 型日期。

• 終端使用者手冊新增/更新四頁：自訂查詢面板（含整批換月）、進貨廠商統計、毛利率分析（列印一節＋移除過期的「尚未移植」標示）、M-EIS 索引。

• 尚未包含：以上各項 runtime 未實機驗證；庫存統計查詢的報表（口徑待確認）後續補。

相關決策：ADR 0085。

2026-07-03 自訂查詢面板：儲存設置、報表記憶、點選顯示條件

變更內容

自訂查詢面板（CUSTOMDASH）新增三項功能：

1. 儲存/載入設置（可按組織關係分享）：查詢區上方新增配置列——可將目前的查詢清單（選了哪些查詢程式、各自的條件、分頁順序）以名稱儲存，之後從下拉選單載入還原，也可刪除不用的配置。配置存於伺服器資料庫，換電腦也看得到同一份。

- 分享：儲存時會記錄「使用部門」——預設自動帶入自己目前的部門，可手動改成其他部門代號；該部門與其上層部門的人都看得到這份配置。此外，主管看得到下屬（含各層）建立的配置、代理人看得到被代理人的配置。

- 下拉選單中別人分享來的配置會標註擁有者代號；只有自己建立的配置能刪除（別人分享來的不可刪，但可另存成自己的一份）。

2. 彙整列印報表記憶：彙整列印時每支查詢選過的報表會被記住（並隨設置一併儲存），下次開彙整列印視窗自動預選上次的報表；只有勾選列印的列才會更新記憶。

3. 點選查詢清單顯示條件：點擊查詢清單中的項目，左側條件面板會顯示該項目已存的條件內容，可修改後按「更新條件」寫回；原本加入清單後條件只能從 ToolTip 看 JSON。

影響範圍

• 僅自訂查詢面板（M.主管資訊 CUSTOMDASH）；其他程式不受影響。

• 需部署資料庫腳本 sql/customdash-config-deploy.sql（五帳套一次跑完：表＋讀取權限查詢 SP TWORK_CUSTOMDASH_QRY 建至 darbnogicsa1～5、proc_param 登錄至各自配對的 darbnogilog1～5；缺席的帳套庫自動跳過；寫入改走標準上傳引擎，舊的 SAVE/DEL SP 廢除）。未部署時面板照常可用，僅儲存/載入設置會顯示失敗訊息。

• 分享可見範圍依既有的「工作關係設定（BOR）」與人事部門資料判定；未設定組織關係者，配置行為與純個人一致（只有自己看得到）。

票據管理報表列印修復（Bank / Bankfcst / Spbank / Checkrec1）

摘要

票據管理（O.Check）與帳款管理（I.ARAP）共 76 張報表全面盤點，發現 4 張報表的資料管線斷鏈（皆在票據管理），列印時跳「Not found Assembly」或整張空白，已全部修復。帳款管理 76 張中的其餘報表均健康，無需變動。

變更

• 銀行帳戶表（Bank）、預估資金表（Bankfcst）、廠商帳戶表（Spbank）、應收票據一覽表（Checkrec1）：新增對應報表 plugin 與報表 POCO。從主檔畫面列印時由 plugin 以全表資料產出；從瀏覽視窗列印時維持原本的瀏覽結果複製（可先篩選再印）。

• 應收票據一覽表：修正 CheckrecViewModel 的 sqlite 資料表名錯位（rpt_o030_checkrec_report1 → rpt_o020_checkrec_report1），並將 Checkrec1.frx 的資料表引用改為瀏覽式 _1 後綴，與應付票據一覽表（Checkpay）行為一致。

新增檔案

• Model/Rpt/Rpt_O010_BankReportPoco.cs、Rpt_O050_BankfcstReportPoco.cs、Rpt_O120_SpbankReportPoco.cs、Rpt_O020_CheckrecReportPoco1.cs

• TworkReportPluginOfficial/Bank.cs、Bankfcst.cs、Spbank.cs、Checkrec1.cs

Breaking Changes

無。

Migration Notes

• Checkrec1.frx 已同步佈署至 C:\dglibrary\REPORTSROOT\Reports\；其他機器需隨版更新報表樣板。

• 無 DB 變更（資料取數走既有 DARB_GETDATA4，proc_param 已登錄）。

• Runtime 尚未實機驗證（模擬環境 bankfcst 表無資料屬正常）。

2026-07-03 D.Bom 查詢程式條件全面補齊（對齊 VFP scx_eng_cy）

摘要

六支 BOM 查詢程式的條件面板與結果功能依 VFP 對比結果全面補上（ADR 0078）。零 DB 部署。

新增

• 共通

- 「自訂條件」輸入欄（最低階用料／產品用途表／流程圖製程表）：自由輸入 SQL 條件，非空白時優先於面板品號條件（取代 VFP _SQLQRY1）。

- 「泛用取品號」Excel 批次品號匯入（最低階用料／產品用途表／成本表）：檔案選擇視窗（預設 C:\TEMPS，支援 .xls/.xlsx），格式同 VFP（第 2 列起 B=客戶代號、D=客戶品號、E=品號）。

• 成本表（BOM_COST）

- 代工費率(元/分)＋代工費率別（單一費率／代工廠商）：P320 委外部門工序成本依此計算；代工廠商模式抓組件主要廠商費率與 B00 報價工時。

- 客戶報價截止日／廠商報價截止日：可回溯歷史報價（空白＝最新，維持原行為）；廠商報價日同時作為 BOM 展開生效基準日。

- 查詢別「泛用取品號」模式：以 Excel 清單逐列（客戶×品號）計算成本。

• 產品用途表（BOM_PURP）：結果篩選別 全部／不含舊品／去除重複星號品。

• 最低階用料（BOM_BOTM）：「相同品號彙總」勾選（依品號合併、加總數量/含損耗數量/庫存量/總重）。

• 專用材料表（BOM_EXCL）：「品別不含B.客戶機種」勾選（預設勾選，對齊 VFP 預設輸出）；查詢前品號必填驗證。

• 流程圖製程表（BOM_FLOW）：條件區 ISO 文件說明回顯（品名/文件編號/文件名稱/版次）；多階材料用量清單「含插件」整批旗標＋欄位；新「製程檢查基準」分頁（工程代號檢查項目/基準）。

變更

• 成本表 比例別預設由「成本」改回 VFP 的「售價」。

• 產品用途表「僅查詢最底階」改傳層數 0 給 SP（VFP 同款），結果等價、查詢資料量大幅下降。

修正

• 🔴 成本表 SetCost_Optimized 材料價／委外工序價兩個查價來源交叉錯置：進貨價模式材料誤抓廠商報價、委外工序報價會漏查（人工成本 0）。

• 🔴 專用材料表 用途表 品別 欄型別錯誤（SP 回傳「4.成品」字串、Poco 宣告 int）：CY 庫開查即炸；連動修正「是否專用」判斷與品別說明。

Breaking Changes

• 無（新條件預設值＝原行為；P320 邏輯僅在有該部門代號的庫觸發）。

Migration Notes

• 無 DB 變更。runtime 未驗，重點驗收：自訂條件、Excel 匯入、bom_cost File 模式、代工費率兩模式、報價截止日回溯、bom_excl 品別過濾預設值。

2026-07-03 alledi（CY 機車 OEM EDI 轉單）轉單層照 VFP 逐頁補完

摘要

alledi（ProgramClass.ALLEDI）14 個在用分頁的「轉單/上傳」業務邏輯，照 VFP alledi_utf8.prg 各頁轉單 procedure 逐頁補完。先前僅顯示層＋讀檔 parser 完成、上傳為通用骨架；本次補齊單價/單位/包裝量反查、預示版次規則、工作日攤分、編輯既有單模式、工具頁產出（EXCEL/DBF），並修正一個必炸接線 bug。

新增

• 共用轉單支援 AllediTransferSupport：

- 單價反查 vw_cupdma最新報價（SEEK 品號+客戶品號；舊頁 fallback SEEK 品號、反查不到單價=0）

- 單位反查 invent、包裝量/標籤數反查 cuinve（生效/失效區間）

- 預示表版次規則：版次 1→9 找空號、「已有大於本月份之預示訂單」擋下、單號=年月+版次+客戶代號

- 工作日曆 BackWorkDay/WorkDaysBetween（Util_Pdt LCL工作日曆，載不到退日曆日）

- 攤分演算法：SpreadByBase（基數100×工作天倍數攤分）＋BuildAllocationOrder（日期分配每 5 工作日跳排）

• AllediDbfWriter：極簡 dBase III 寫出器（年度銷售「產生DBF」用，Big5 中文欄名）

• SYM預示 工作日攤分：4 個 UI 日期（下一/下二/下三起始日＋下三截止日）接進 BLL，

期別末碼≥'A'（CKD/SPD）不拆分、其餘照 VFP edipdsym 攤成逐工作日明細，攤分後逐列重反查品號、備註=期納客供（invent.規格）

• YMTT預示 扣當月訂單量：近一年 vw_ordetlid 對照，交期改最新訂單交期+5工作日、過期標「-過期」、數量=原始數量-當月訂單量

• SY計劃/SYM-2W「編輯既有單」轉單：UploadSyPlan（依預示單號扣減既有明細'E'＋新增'A'）、

UploadSym2w（依取代預估單號，起訖區間舊明細標'D'＋新增，備註=使用者+日期+EDI）；新明細用負數 pkid（同 VFP）

• SY_BOM 先刪後建：轉單前刪 bom_m 中品別11（客戶機種）且在本批的既有 BOM（AdeUploadBll.Delete / INPUT-BD），再全新建（途程序號 001…、數量公式=STR(數量)）

• SY計劃/SYM-2W BOM 展開接真資料：invent 品號檢核＋bom_d（生效/失效過濾）展開，原 TODO stub（展開恆空）移除；需求日提前一工作日（UPDT_BACKWKDAY_LCL -1）

• 工具頁產出：泛用取品號「產生EXCEL」（CopyToExcelBll 匯出開啟）、年度銷售「產生DBF」（C:\TEMPS\訂單及預示.DBF）

• 輔助鈕全數實作：Excel 匯出×5、重新檢查×2（重標無品號）、新YAMAHA 文字檔讀入（notepad 開檔）——原「後續階段實作」占位訊息全移除

變更

• ORMAST 轉單表頭補齊 VFP 共通值：倉儲代號='出貨倉'、訂單別='1'、序號前置碼='CO'、匯率=1、per-vendor 訂單備註（鼎豪=訂單輸入日+採購+今天+EDI轉入、新SUZUKI=展開日期:…）；明細補 交貨地點/客戶訂單號/結關日期/單位/包裝量/標籤數/原幣未稅=ROUND(數量×單價,0)，序號一律重編 001…

• 轉單前置檢查：訂單類擋「查無品號」列；SY_BOM/SY計劃/SYM-2W/年度銷售 擋「錯誤欄非空」列；SY計劃/SYM-2W 擋「已更新過」重複轉單

• 年度銷售 parser 修正：CSV 第 2 欄是公司品號（含 *，直接查 invent），原誤當客戶品號走 cuinve 反查；補 查無客戶/品號無 */查無品號 檢核與 客戶簡稱/品名/停用說明

• 新YAMAHA/新SUZUKI 雙軌轉單：預示年月基準各自正確（最小預訂交期 / 展開日期）；新SUZUKI C檔下示交期接真工作日曆

• SYM-2W parser：.xls 讀檔改走共用 AllediExcel（原 XlsxFormatProvider 讀 .xls 會炸）、客戶品號反查方向修正（品號→客戶品號）

• 慶俊預示/YMTT預示/SY計劃/新SUZUKI 的工作日推算由「日曆日保底」改接真正 LCL 工作日曆（Util_Pdt，載不到才退保底）

修正

• 🔴 慶俊預示轉入必炸：VM 未把 起始日期/客戶代號 設進 BLL，BLL 起始日期必填直接 throw——已接線

• SYM/慶俊/SY計劃/SYM-2W 各頁輸入框（年度/月份/起始日期/預示單號/取代預估單號/轉單起訖日）原是裝飾、未接 BLL/轉單——全部接上

已知限制（待後續）

• 全數 runtime 未驗收：需 C:\轉EDI資料\ 真實樣本檔逐頁跑（轉入預覽＋轉單對帳）

• 選單僅開發期 dev-programs.json 注入；正式 DB 登錄（usp_新增程式+_menum）未做

• preord_m.採購員（YMTT預示='貿易商'）與 ormast.公司代碼 合併 Source 無此欄（darbnogicsa1 缺，ADR0050 CY 專屬欄待裁定）→ 未寫入

• vw_cupdma最新報價 無「已審核」欄（VFP SYM/YMTT 帶此條件；view 本身即最新報價彙總，視為等義）

• SYM預示 VFP 的「重複客戶品號+品號+交貨地點」檢查副表（EDIPDSYMCHK）未呈現（讀檔去重已涵蓋主要情境）

• 年度銷售 grid 以「每月一列」呈現（VFP 為一列 12 月欄＋總計列；產生 DBF 的資料等價）

• YMTT訂單 grid「公司報價」欄未回填（轉單時以 vw_cupdma最新報價 反查，資料等價、僅顯示差）

建置

LogicBll（dotnet）/ ViewModel / TsERP.csproj（VS MSBuild）0 error；HarnessSmokeTests 3/3 通過。

TsERP.sln 整包僅 UnitTest1.csproj（net48 參考 net8，既有問題）失敗，與本次無關。

2026-07-02 scx_qry_cy 主管資訊查詢 重新對比修補

摘要

對朝陽 CY 主管資訊 EIS 查詢庫 scx_qry_cy（15 支可執行 class）重新逐支對比 VFP 原碼與新版（程式碼 + 前端 XAML），修掉 4 組會阻斷/算錯的 RED 與數個可直接處理的 YELLOW。whole-tab／子表單／報表列印／DB 客戶專屬公式等 feature port 仍列為延後（見下）。

變更（使用者可見）

• 外退不良統計 / 派工排程查詢 / 庫存統計查詢：補回 DIExtension.cs 遺漏的 3 支 ConditionViewModel 註冊。此前這三支開窗即崩（「無法建立 ViewModel」），現在可正常開啟。（Group B 移植當時漏了 DI 那一步，同 Group A 曾犯的病。）

• 達成率統計（pd_qry4）：新增「僅查詢訂單」勾選框，預設勾選，勾選時排除 A 開頭預示/估算製通單（製通單號 NOT LIKE 'A%'）。此前無此選項＝永遠納入 A% 單，與 VFP 預設相反，會使計畫點數/達成率算錯。動態部門欄改依 生產順序 排序（原用部門代號字典序）。

• 收料不良統計（pur_qry2）：

- 廠商別頁「名次」欄修正 binding（原綁不到屬性永遠空白）。

- 廠商評分公式改對齊 VFP 現行（2019/09/03）算法，並分「採購／外包」兩式（原套用被註解的舊公式且不分類，分數會錯）。

- 明細頁新增「只顯示不良」勾選框，預設勾選（對齊 VFP page4 預設）。

• 期間效率統計（pd_qry2）：修「期間工時調整」分頁開啟即崩（重複索引鍵例外）；修「組立狀況」起訖品號在派工品號模式下用錯維度（製單品號 vs 派工品號）導致查錯資料。

• 期間效率統計 / 非生產工時統計：查詢前補「請先選擇生產部門」防呆（原全不勾會組出殘缺 SQL 拋例外）。

• 派工排程查詢（pd_qry8）：生產部門清單新增「全選／不選」批次鈕。

• 庫存統計查詢（costqry2）：Tab A/B 補顯示「期初數量／期前正數量／期前負數量」三欄（資料原已算出只是沒上版面）；各補一個 client-side 過濾勾選框（僅顯示單價不完整/銷售價為0；僅顯示材料價為0）。

新增

• sql/TWORK_QRY_EXCE_INOUT_darbcycsa1.sql、sql/TWORK_QRY_STOCKLIFE_darbcycsa1.sql：補 CY 庫（darbcycsa1）缺的 SP 本體。原本 SP 只佈署到 darbnogicsa1，但 proc_param 已指向 C → CY 執行會崩「無效物件名稱」。⚠️ body 沿用 nogi 版，執行前須人工複核 CY 是否有客戶專屬差異。

Migration Notes

• 上述兩支 CY SP 部署腳本尚未執行，需在 darbcycsa1 跑過，exce_inout / 庫齡分析 才能在 CY 環境查詢。含中文，用 sqlcmd 要 -f 65001 並執行後實查物件存在。

仍延後（本次未做，屬 feature port）

• pur_qry2 Page5「品質管制」整頁（含查詢別2 SP + 品號條件 + grid + Excel）。

• pd_qry2「調整工時」鈕開的子表單 PD_QRY21。

• qc_qry2 Page4「生產日報表含無不良明細」整頁、Page1「個別組立數/個別不良率」兩欄、Page3 權限回寫頁、彙總資料 surface（Bll 已算但未輸出＝dead code）。

• 各查詢的 FastReport 列印/Excel/Email（ADR 0034 決策：scx_qry 一律用 RadGridView 內建匯出取代）。

• stocklife：庫齡分桶交易別 DB↔MP 差異（SP 層）、單位成本公式落後版（VFP 2025/07/18 改 BOM材料+製程加工×人工費率）、庫齡明細缺 5 欄、P4 移植的是 VFP 已停用舊演算法。

• pd_qry7：設變建議品號確認窗、外部 DBF 資料別3、Excel 樞紐；OperationForecast 7 支 SP 待部署。

驗證

LogicBll（dotnet）、ViewModel、TsERP（VS MSBuild）三者建置 0 錯誤。runtime 尚未實機驗證。

</content>

</invoke>

2026-07-02 — E.Order（scx_ord_cy＋scx_ord）XAML 欄位補齊與綁定修正

摘要

依 VFP 三方對齊檢查（VFP UI 欄 ↔ Source 屬性 ↔ XAML 綁定）結果分兩批補齊：第一批對 scx_ord_cy（CY 版）7 支表單補 UI 缺欄、修正 2 個錯誤綁定、解鎖 5 處唯讀倒退、刪除 2 支不可達 US 變體孤兒 view；第二批對 scx_ord（非 CY 版）獨有 12 class 與共用 class 差集再補一輪（ormast 主檔 4＋明細 17 欄、cuqt 加工明細 4 欄、cudata 6 欄等）。全部改動 TsERP 整包 build exit 0。

新增

表單	新增欄位

訂單（Ormast）	主檔：訂單備註、聯絡單ID；明細：交貨地點、包裝量、標籤數、結關日期、製通單號（唯讀）、合併單號、補貨數量、出通單數量（唯讀）

裝箱單（Pk）	主檔：出船日、到達日；明細：產品別（插在品號附近）、合約號碼、訂單編號、預訂交期

預示訂單（Preord）	明細唯讀欄：停用日期、管制說明、生產線、工時、規格、生產批量；品號/客戶品號改值時即時回填品號附屬欄（查得到才覆蓋）

商業發票（Ci）	主檔：交易條件（可編輯文字，選碼帶入可手改）；明細唯讀欄：轉入單號、訂單編號

出貨通知（Salema）	明細：客戶訂單號（可編輯）、訂單編號-序號（唯讀反查）

報價單（Cuqt）	主檔：人工費率、YMT材料費、YMT加工費（費用區，紫標對應 VFP）

客戶資料（Cudata）	Tab1：發票地點＋發票郵遞號（地址四連段補齊）、英文簡稱、英文名稱、港口代碼（M202 下拉）、助理、助理二、業務主管（SalesRepSearch＋姓名反查）

第二批（scx_ord 非 CY 版差集）

表單	新增欄位

訂單（Ormast）	主檔：訂單別、報價單號、業務員編號（SalesRepSearch＋姓名）、聯絡人；明細 17 欄：顏色、客訂單序號、廠商代號、建議採購量、建議交期、建議售價（AllowViewPrice 閘）、請購數量、是否採購、是否核發、製程別、採購別、客戶交期、訂單分類、交期變更、營業確認、出貨別、分批交貨

報價單（Cuqt）	加工明細 grid：費率（連動重算）、參考加工費、裸價治具費、治具費（非 CY 欄組原整組漏掉）

客戶資料（Cudata）	對照碼、經銷商（C270 下拉）、科目代號（GLAccountSearch）、倉儲別、公司客號、保養廠代碼

客戶報價（Cupdma）	叫修單號

裝箱單（Pk）	明細：包裝量_箱

送樣（Sample）	聯絡單ID；承認書升級下拉（1.PDF/2.EXCEL/3.書面）；完成日期/是否結案唯讀對齊

達成率（Fillrate）	類別欄（C:客戶/S:廠商）；備註唯讀對齊

維修（Repair）	5 處唯讀對齊（叫修人/服務人員/品名/機器序號/客戶簡稱）⚠️ 叫修人/服務人員鎖定待裁定（新版原做成可編輯指派欄）

信用額度（Cudatalimit）	上次額度/最新額度欄序修正（原顛倒）

typo 修正：Sample1.xaml 兩處 DescriptionBindingPath="SKUDescription"（stale 英文名）→ 品名。

完全對齊零修改：claim、cmplain、culbl、cungma、invent1、orssma、rtaxma、visit、pdtsal、estsal、cuinve、ci、salema（差集部分）。

變更

• Ci 商品名稱碼表修正：TableAlias C269 → C275。DB 查證：朝陽庫（darbcycsa1）只有 vwcmb275_商品名稱（有實際資料），269 不存在；VFP 原始碼 c_type=275。原 C269 在 CY 環境下拉會是空/錯表。

• Pk 商品名稱升級下拉：純 TsTextBox → TsComboBoxBySql TableAlias="C275"（對齊 VFP sqlcombo c_type=275，與 Ci 同款）。

• Cudata 請款郵遞區號錯位修正：請款地點列的郵遞區號原誤綁 發票郵遞號 → 改綁 請款郵遞號；地址四連段（公司/發票/請款/送貨）郵遞配對整組核對正確。

• Cudata 唯讀解鎖 5 處：停用（Tab1）、帳號/支存帳號/活存帳號/資本額幣別（Tab2）。VFP 皆可編輯、新版無其他編輯入口、git blame 確認鎖定來自 scaffold 批次非刻意決策。

• Ci_m1（批次選取轉入）接線修復：①視窗標題改綁 VM Title（出貨通知單轉商業發票/出貨單轉商業發票）；②code-behind 補建 VM 與 DataContext（原本被註解掉、整窗 DataContext=null）＋ DialogCloser；③轉入時 轉入單號 依 VFP 規格填「出通單號-序號」（查詢別 21），出貨單路（23）維持只填倉單號。

• Preord 移除無作用的 RowDetailsVisibilityMode 殘留屬性；Cuqt 修 Orientation=" Horizontal" 多餘空格。

刪除

• TsERP/E.Order/Ormast_US.xaml(.cs)、TsERP/E.Order/Cudata_US.xaml(.cs)：兩支皆為不可達孤兒 view（無任何 DataTemplate/路由引用、TsPage 舊堆疊、綁定大面積 stale——Ormast_US 有 7 個大小寫 dead binding、Cudata_US 有 3 個 typo binding＋200+ 英文 stale 綁定）。使用者裁定刪除。tools/release-notes/bootstrap-system-map.ps1 跳過清單同步清理。

Breaking Changes

無。所有新增欄位的 Source/Model 屬性原本就存在，DB schema 未動。

Migration Notes

• 本批表單（E.Order 多數）無 per-view 語系 JSON、XAML 全走中文字面值；新增欄位比照既有慣例用中文 Header/Label。日後若做多語系需整模組一起建 JSON，非本次範圍。

• 使用者裁定不補（記憶已載，後續對比勿再報）：公司代碼欄（5 支表單，單公司環境維持 hardcode=1）、Cudata 聯絡人 grid skype/msn/facebook/呼叫器 4 欄（已淘汰）。

• 已知另案待辦：ormast 兩庫 twin 欄（訂單號碼/倉庫/ORDERCLOSE/結案 綁美系側，CY 庫需裁定）、preord LTMP 用量 6 欄（需 DB 端彙總設計，grid 已留占位註解）、Ci_m1 挑出通轉入時新欄「訂單編號」為空（TmpSalede POCO 未映射 SP 欄位，需查證 TWORK_QRY_CI）、WindowHelper 對 RadWindow 基底的 TsWindow 會 InvalidCastException（Ci_m1 開窗路徑，建議 window-to-tsview 轉換）、PkViewModel.ItemDescriptionTypeSource 死碼待清。

• 第二批新增另案：cupdma「業務報價查詢」暫存面板（cupdtbizprice grid）、ormast「訂單歷史查詢」彈窗（ltmp訂單歷史 11 欄）、preord「採購需求表」（ltmp 39 欄）三個整組功能未移植（無 Source，屬功能移植非補欄）；cudatam「付款條件」反查顯示欄需加 Source 屬性（循 收付條件說明＋GetPaymentTermDescription 模式）；fillrate「修改模式保留舊資料」邏輯未實作；repair 叫修人/服務人員唯讀鎖定待裁定（VFP 靠派工程式回寫，新系統若無對應則需回退為可編輯）。

• Runtime 未驗：本批為靜態補欄＋build 驗證（C#/XAML 編譯通過；完整 build 因執行中 TsERP 鎖 DLL 只到複製步驟），實機開窗驗收待使用者執行。

2026-07-02 報表預覽視窗工具列整併

摘要

報表預覽視窗（TsFastReportPreview）原本上下兩排工具列（自家的「匯出PDF／中一刀列印」+ FastReport 內建英文工具列）整併成單一自家中文工具列。

新增

• 工具列新增：列印、另存新檔（支援 FastReport 全部匯出格式）、搜尋、浮水印編輯、大綱面板開關、第一頁／上一頁／下一頁／最末頁、頁碼輸入框（輸入頁碼按 Enter 跳頁）、目前頁／總頁數顯示、縮小／放大／縮放至頁寬／整頁顯示。

變更

• 「匯出PDF」「中一刀列印」與預覽操作按鈕合併在同一列。

• 工具列文字全面中文化（原內建列為英文圖示列）。

• 工具列改用 Telerik Office2019 主題外觀（RadButton + RadGlyph 圖示），與系統整體風格一致；導覽與縮放為圖示鈕附中文 ToolTip。

刪除

• FastReport 內建工具列隱藏（ToolbarVisible=False）。其上的 Open／Design／Edit 原本就已停用；Save（匯出）功能由「另存新檔」承接。

Breaking Changes

無。

Migration Notes

無需資料或設定變更。

2026-07-02 程式分流：舊系統共用 DB 的程式鍵導向新版程式

摘要

新增程式分流中央對照表（ADR 0075）。與 VFP 舊系統共用資料庫的客戶（朝陽），選單登錄的

舊程式鍵會在登入後自動導向新版程式；超連結跳轉也會自動解析到該客戶實際使用的客製變體。

新增

• 朝陽：選單「庫存主檔」（INVENT）現在會開新版 INVENT_BS 畫面（之前顯示

「無法建立ViewModel」無法進入）。

• 全客戶：程式內品號等超連結寫死 INVENT 時，自動跳到該客戶選單實際登錄的變體

（INVENT_BS / INVENT_PRIME）。

變更

• 無既有可運作行為的變更；所有分流都只在原本會失敗（查無程式/無權限）時介入。

刪除

• 無

Breaking Changes

• 無

後續更新（2026-07-03）

• 公版庫存主檔 INVENT 完成（ADR 0077）後，移除「朝陽 INVENT→INVENT_BS」的

CompanyOverrides 條目：選單登錄 INVENT 的資料庫現在直接開公版畫面。

CompanyOverrides 機制本身保留（空表），之後有真實分流需求再登錄。

Migration Notes

• 不需要任何資料庫變更。

• 朝陽如需 INVENT_BS 的新版報表，_reportname 類 keyed 資料需另行以新鍵登錄

（純新增，不影響 VFP）。

2026-07-02 庫存主檔公版化（INVENT 基底 + 客製衍生）

摘要

新增公版庫存主檔程式 INVENT（ADR 0077）。原禾久版 INVENT_BS 重構為公版的

衍生類，功能與畫面完全不變。搭配程式分流（ADR 0075），超連結寫死 INVENT

會自動導航到各客戶實際使用的版本。

新增

• 公版庫存主檔 INVENT（InventViewModel + Invent.xaml + InventSave）。

選單登錄 INVENT 的資料庫（且無公司分流對照）現在會開公版畫面。

變更

• Invent_bsViewModel / Invent_bsSave 改為公版的衍生類——對使用者零行為變更。

刪除

• 無

Breaking Changes

• 無

Migration Notes

• 不需要資料庫變更。

• 模擬環境要單獨開公版：dev-programs.json 註冊 INVENT（注意：注入後寫死

INVENT 的超連結會開公版而非客製變體）。

2026-07-02 — 金流預測 (flowcast) 畫面與口徑強化

摘要

金流預測第二輪打磨：頂端加 KPI 摘要卡、明細區改「金流明細／月彙總」雙分頁、圖表時間軸空月補零不再跳月、點柱過濾狀態可見可清除。

新增

• KPI 摘要列（畫面頂端五張卡）：期間總流入／總流出／淨額／期末累計淨額／最低累計淨額（含發生月）。最低累計跌破資金警戒線（或警戒線 0 時為負）顯示紅字。

• 月彙總分頁：明細區改 TsTab 雙分頁，新增月彙總數字表（年月／應收／應付／當月淨額／累計淨額），累計淨額跌破警戒線的月份整列紅底。

• 點柱過濾狀態列：點圖表柱段後，明細分頁頂端顯示「過濾中：年月 × 來源收付（N 筆）」黃色標籤與 ✕ 清除鈕（原本只能再點同段或點空白取消，狀態不可見）。

• 明細 grid 補 原幣金額 欄（幣別旁，小數位走原幣設定）；欄序改「預計現金日」在最前。

• 圖表 tooltip 補來源系列名（原本只有年月＋金額，堆疊柱分不出哪層）。

新增（第二批，同日）

• X 軸粒度切換：來源勾選列加「X 軸：年月／日期」radio，日期模式逐日堆疊柱＋逐日累計線（點柱過濾與期間彙總表同步以日為鍵）。空日一樣補零，跨度超過 3 年退回稀疏顯示。

• 累計淨額改掛右側副軸：原本與月柱共用左軸，累計量級大把柱壓扁（柱狀體太矮）；現在柱用左軸、累計線與資金警戒線用右軸（圖例標示「累計淨額（右軸）」）。

變更

• 空月補零：GroupByMonth／GroupByMonthStacked 產出首月～末月連續月序列，無資料月份補 0 列（累計淨額沿用上月）。原本空月直接消失，柱狀圖時間軸跳月、累計線斜率失真。鍵解析失敗或跨度超過 50 年退回原稀疏序列。

• 摘要 KPI 抽成純函數 FlowcastComposer.Summarize（LogicBll），與月彙總同層可單元測試；FlowcastMonthPoco 加 跌破警戒 旗標（查詢時依當時警戒線計算）。

刪除

• 無。

Breaking Changes

• 無（查詢口徑、SP、參數皆未動；純顯示層與彙總呈現）。

Migration Notes

• 無需 DB 動作。警戒線仍在查詢條件「資金警戒線」設定，查詢後才會反映到月彙總紅底與 KPI 紅字。

2026-07-02 產品用途表：工程代號查詢補生效區間過濾＋成本表預設值修正

摘要

scx_eng_cy 查詢條件全面對比（六支查詢程式）發現的回歸修正。

變更

• 產品用途表（BOM_PURP）以「工程代號」查詢時，補回生效/失效日期過濾：只列「現行有效或未來生效」該工程的組件。VFP 於 2016/11/15 特別修過「工程失效也會出來」的問題，新版移植時用到修正前的舊 SQL，導致已失效工程的品號也被查出。（Bom_purpBll.cs）

• 成本表（BOM_COST）起始受訂日 預設值補設為空字串：ResetToDefault() 原漏設此欄（null），與其他欄位行為不一致。

Breaking Changes

• 無（行為回歸 VFP 正確口徑）。

Migration Notes

• 無 DB 變更。

2026-07-02 階層式製程表（流程圖製程表）補齊 VFP 缺口

摘要

依 VFP scx_eng_cy 的 bom_hier 對比結果，把整併在「流程圖製程表」（BOM_FLOW）裡的階層式製程表能力補齊：查詢條件、明細欄位、主檔欄位與「只顯示工時」過濾。（ADR 0076）

新增

• 查詢條件

- 查詢類別：品號 ／ 客戶代號暨品號（後者可輸入起訖客戶代號，以客戶產品對照 cuinve 篩品號）

- 生效日期：本日 ／ 指定日期（BOM 生效區間以指定日為基準展開）

- 工時別：標準工時 ／ 改善前工時 ／ 改善後工時 ／ 備料工時（改善前/後與備料工時僅朝陽庫有資料，其他庫為 0）

- 各層皆自數量1往下查詢：每層母件數量視為 1，明細數量＝自身單位用量

- 各層須增加原母件資料：每個展開節點前插一列母件自身（顯示序號後綴 ----）

• 製程明細表／製程明細(樹狀) 新欄位：製程別、庫存量、包裝量_包、廠商代號1、廠商簡稱1、治具品號

• 左側查詢組件清單新欄位：品名、客戶品號

• 製程明細表「只顯示工時」勾選：只列製程列（VFP SET FILTER TO '◇'$顯示品號 對應）

變更

• 無既有行為變更：新條件預設值＝原行為（本日、標準工時、兩個展開選項不勾）。

刪除

• 無。

Breaking Changes

• 無。U_Bomflow 其他呼叫端（報價單、營運預測、庫齡呆料、生產計劃）不受影響。

Migration Notes

• 無 DB 部署需求（DARB_QRY_BOM_PROCES / DARB_GETDATA4 皆已登錄 proc_param）。

• 尚未移植（後續另案）：VFP bom_hier 的「自訂查詢」條件產生器、報表選擇 5 種列印（BOM_H1 產品組件表／BOM_H2 標準工時表×3／BOM_H4 治工具管制表）與治工具管制表 Excel 匯出。

2026-07-02 — 流程圖製程表：圖形排版改水平左上、樹狀分頁補按鈕、新增需求數量重算

摘要

D-110 流程圖製程表（Bom_flow） 四項強化：流程圖圖形預設改為水平排列（根節點在左上角、先明細後製程、往右下角展開）、製程明細(樹狀)補「展開全部／收攏全部」、新增「需求數量＋重新計算」、樹狀根節點補數量/單位並讓製程列顯示名稱。

新增

• 需求數量重算：製程明細(樹狀)分頁下方新增 需求數量 輸入欄與 重新計算 按鈕。輸入需求數量後按下，整棵樹的數量（明細 = 父數量 × 單位用量）與標準工時（製程 = 數量 × 單位標工時）即時重算，製程明細表、多階材料用量清單、流程圖、流程圖圖形同步更新；純記憶體計算，不重新查詢資料庫。切換查詢組件時輸入欄會帶回該組件目前的根數量。

• 樹狀分頁按鈕：製程明細(樹狀)分頁下方新增 展開全部／收攏全部 按鈕（原本只有製程明細表有）。

變更

• 流程圖圖形預設水平排列：開啟即水平（原預設垂直）。根節點固定在左上角，每條鏈沿明細往右直走、製程與其他分支往下換列，整張圖往右下角延伸——與「流程圖」表格分頁（VFP 原版）的閱讀順序一致。垂直排列 按鈕行為不變。

• 圖形同層順序：展開子節點時先放明細（物料）再放製程；同組內仍照顯示序號。

• 圖形根節點：補顯示數量＋單位（第 3 行），品名缺漏時改從查詢結果帶入。

• 樹狀根節點：第一個組件（查詢組件自己）改用查詢結果的層數 0 那筆，因此數量、單位、生效日期等欄位都有值（原本是合成節點，數量/單位空白）。

• 樹狀品號欄：改綁 樹狀顯示品號——去掉縮排與 ▼/▲ 三角形、保留 ◎/◇ 前綴；製程列因此顯示 ◇＋工程簡稱（有名稱），不再只有工程代號。

• 製程品名顯示代號＋名稱：樹狀分頁品名欄與流程圖圖形的製程節點第 2 行改顯示「工程代號＋工程說明」（說明缺漏時退回工程簡稱），代號跟名稱一眼可見。

• 圖形連線改直角折線：連線改 Polyline＋自動路由（OrgTreeRouter 依排列方向轉折），不再畫斜線。

• 圖形雙擊不再縮放：拿掉 RadDiagram 內建「雙擊畫布重設 100% 縮放」行為，避免看圖時誤觸突然縮小。

• 隱藏背景格線：畫布背景格子改為不顯示，並在畫板外加一圈框線、自動縮放四周留 30px 邊界。

刪除

• 無。

Breaking Changes

• 無。資料庫、報表、參數皆未變動。

Migration Notes

• 無需任何佈署動作。多語系新增鍵：展開全部、收攏全部、需求數量、重新計算（Common/Lang/Xaml/Bom_flow.json）。

• 需求數量重算只影響畫面上的顯示值，不寫回任何資料表。

2026-07-01 ESTSAL 兩庫欄位聯集同步（長度補齊 + 年預估分類/分類 鏡射）

摘要

依 /dual-db-union-sync ESTSAL 比對鈞寶 darbnogicsa1 與朝陽 darbcycsa1 兩庫的

estsalm（主表，無 view）、estsald / vw_estsald（子表 + view）欄位聯集。

結論：Model / Source 的欄位聯集在先前 CY 對比時已補齊（EstsalmModel、EstsalmSource、

Twork_ord_vw_estsaldModel、Twork_ord_vw_estsaldSource 皆含兩庫聯集欄）。本次做兩件事：

(1) 修正兩個 TsStringLength 未取聯集上限、可能截斷 CY 值的問題；

(2) 對照 VFP scx_ord（NOGI）與 scx_ord_cy（CY）原始碼確認 年預估分類(int) 與 分類(char) 是

同一「年預估分類」欄的兩庫不同存法（同標籤、同 InputMask 9999），改以「設一欄、鏡射填兩欄」串接共用 UI。

比對結果

物件	NOGI	CY	處理

base estsalm	10 欄	13 欄	聯集 14 欄，Model/Source 早已齊全

base estsald	8 欄	8 欄	相同，Model 無變更

view vw_estsald	+品名	+品名/停用/停用說明/停用日期/管制說明	Source 私有欄位早已承接

（主表 estsalm 無編輯 view；年預估分類(NOGI int) 與 分類(CY char) 名稱不同，聯集各留一欄。）

變更

• Model/Source/E.Order/EstsalmSource.cs：審核人員 TsStringLength(10) → (20)

（NOGI nvarchar(10) / CY nvarchar(20)，取聯集上限避免截斷 CY 審核人員）。

• Model/Source/E.Order/Twork_ord_vw_estsaldSource.cs：品名 TsStringLength(120) → (200)

（view 顯示欄，NOGI nvarchar(120) / CY nvarchar(200)，取聯集上限）。

• Model/Source/E.Order/EstsalmSource.cs：年預估分類(int) 與 分類(char(1)) 兩個 setter 互為鏡射

（直接寫對方 Model 欄避免遞迴）。編輯共用 UI 欄或任一庫載入時，兩欄恆同步：

- 設 年預估分類 = N → 分類 = N.ToString()（N=0 時清空）。

- 設 分類 = s（CY 載入僅回傳此欄）→ 年預估分類 = int.TryParse(s)，讓 UI 顯示與

EstsalSave 的「年預估分類 != 0」必填檢查對兩庫皆成立。

• ViewModel/E.Order/EstsalViewModel.cs：AfterAddNew 新增預設 年預估分類 = 1

（對應 CY VFP REPLACE 分類 WITH '1'＝1.銷售，經鏡射同步填 CY 分類）。

VFP 對照依據

面向	NOGI scx_ord（int 年預估分類）	CY scx_ord_cy（char 分類）

綁定欄	年預估分類	分類

標籤 / InputMask	年預估分類 / 9999	年預估分類 / 9999

addagain 預設	無	REPLACE 分類 WITH '1'（銷售）

allowsave 必填	Empty(年預估分類)	EMPTY(分類)

參與 單號 組成	註解掉（若啟用取 LEFT(年預估分類,1)）	年度+分類+版次+客廠部代號（OPMODE 1/8）

刪除 / Breaking Changes

無欄位移除。行為變更：NOGI 新增單據時 年預估分類 現預設為 1（VFP NOGI 原留空由使用者輸入）；

因 EstsalSave 本就要求非 0，使用者仍會確認/改值，實務影響小。

尚未承接（後續另案，非本次範圍）

CY VFP 由 分類 等欄自動組 單號（年度+分類+版次+客廠部代號）與「上版鈕」載入前版；

現行 C# EstsalSave 仍將 單號 視為使用者輸入（is_noduplicate），CY 的 單號 自動組成尚未移植。

Migration Notes

本機 SQLite 由 EnsureCreated / LocalDbService 補欄安全網自動處理，無需手動 migration。

屬 ADR 0050（多客戶差異處理）既有決策的延伸，不新開 ADR。

2026-07-01 CI 兩庫欄位聯集同步

摘要

依 /dual-db-union-sync CI 比對鈞寶 darbnogicsa1 與朝陽 darbcycsa1 兩庫的

ci_m / vw_ci_m（主表 + view）、ci_d（子表，無 view）欄位聯集。

live 類別為 Twork_ord_vw_ci_mSource/Twork_ord_vw_ci_dSource（CiViewModel + CiSave 使用）

與其 Model Twork_ord_vw_ci_mModel/Twork_ord_vw_ci_dModel。本次僅新增兩庫聯集缺漏欄，未動既有欄位。

比對結果

物件	NOGI	CY	處理

base ci_m	27	27	差 1：NOGI 有 稅別(已在 Model)、CY 有 是否si → 補 是否si

view vw_ci_m	31	31	view-only JOIN 欄(客戶簡稱/出貨港口/目的港口/運送方式)兩庫皆有、Source 已承接

base ci_d	19	21	NOGI 有 其他金額(已在 Model)；CY 多 訂單pkid/預訂交期/合約號碼 → 補 3 欄

變更（新增欄，皆兩庫聯集）

• Common/Model/E.Order/Twork_ord_vw_ci_mModel.cs、Model/Source/E.Order/Twork_ord_vw_ci_mSource.cs：

- 是否si（CY ci_m char(1)）— string，[TsStringLength(1)]。

• Common/Model/E.Order/Twork_ord_vw_ci_dModel.cs、Model/Source/E.Order/Twork_ord_vw_ci_dSource.cs：

- 訂單pkid（CY ci_d int）。

- 預訂交期（CY ci_d char(10)）— string，[TsStringLength(10)]。

- 合約號碼（CY ci_d nvarchar(20)）— string，[TsStringLength(20)]。

NOGI 無上述欄，上傳時 OPENXML 依 ADR 0050 取交集自動略過；CY 現可持久化這些欄。

後續清理（同批完成）

• view-only 欄搬入 Source 私有欄位：客戶簡稱/出貨港口/目的港口/運送方式 從 Twork_ord_vw_ci_mModel

移除（含 ctor init 與 [XmlAttribute()] 屬性），改由 Twork_ord_vw_ci_mSource 以私有欄位承接，

使 Model 純對應 base ci_m、GetModelBase 不再序列化這 4 個 JOIN 唯讀欄。稅別(NOGI base 欄)保留於 Model。

• 刪除重複死碼對：Common/Model/Ci_mModel.cs、Common/Model/Ci_dModel.cs、

Model/Source/E.Order/Ci_mSource.cs、Model/Source/E.Order/Ci_dSource.cs —— 經全 repo（.cs/.xaml）確認

無任何 ViewModel/BLL/DataManager 註冊或反射引用，整組移除。

刻意未動（超出本次聯集範圍，另記備查）

• EDI/856-810 欄組：ci_m 的 出貨ID/名稱/地址…請款…/trno/blno/scac/carrier/shipdate/estdate/create856/create810/receiveid/TaxCode/出通單PKID、

ci_d 的 PILinePkid/SalesOrderLinePkid/reqno —— 皆不在 NOGI/CY 兩庫 ci_m/ci_d，屬第三變體(EDI)欄，保留。

• 型別/精度既有差異：公司代碼 C# short vs DB int、匯率 [TsDecimalLength(19,6)] vs DB numeric(14,4)、

產品描述別 len 10 vs DB 4 —— 皆放大或無害，保留不動。

刪除 / Breaking Changes

無欄位移除、無行為變更。純新增聯集欄。

Migration Notes

本機 SQLite 由 EnsureCreated / LocalDbService 補欄安全網自動處理，無需手動 migration。

屬 ADR 0050（多客戶差異處理）既有決策的延伸，不新開 ADR。

2026-06-30 RadGridView 表頭左上角雙擊自動調整欄寬

摘要

TsRadGridView（全 app 共用表格控件）新增一個隱形的快捷操作：在表頭左上角那一格（row indicator 上方的空白角落）點兩下，即把所有欄位寬度設成 Auto、依內容自動調整。等同原本右鍵表頭 →「自動調整欄寬」，但不必開選單。

依使用者裁定採「隱形」作法：左上角不放可見按鈕，只在滑鼠移上去時變手型游標並顯示 tooltip「點兩下自動調整欄寬」提示。

新增

• TsControl/TsTelerik/TsRadGridView.cs：

- 在 Loaded 掛勾表頭列（GridViewHeaderRow）的左上角 PART_IndicatorPresenter Border，加雙擊 → 自動調整欄寬；同時設 Cursor=Hand 與 tooltip。

- 表頭列可能晚於 Loaded 才實體化，找不到角落時延後重試一次。

變更

• 抽出共用方法 AutoFitAllColumns()；右鍵選單「自動調整欄寬」與左上角雙擊共用同一實作。

影響範圍

全 app 所有 TsRadGridView。瀏覽/查詢/明細表格皆適用。

使用方式

• 表頭左上角空白格 → 點兩下：所有欄寬依內容自動調整。

• 仍保留原入口：表頭右鍵 →「自動調整欄寬」。

Breaking Changes

無。單擊左上角、或雙擊其他表頭格的既有行為（排序）不受影響。

Migration Notes

需重建 TsERP 才會生效（改動在 TsControl 共用控件）。

ORMAST 兩庫欄位聯集同步（darbnogicsa1 ∪ darbcycsa1）

摘要

依 _sheetno 查得 ORMAST 主表 ormast/vw_ormast、子表1 ordetl/vw_ordetl，

比對鈞寶（darbnogicsa1）與朝陽（darbcycsa1）兩庫的 base table 與 view 欄位，

取聯集後同步回程式：base table 聯集進 Model、view JOIN 唯讀欄進 Source 私有欄位。

屬 ADR 0050（多客戶差異處理）的延伸，未新開 ADR。

比對結果

物件	NOGI	CY	差異	處理

base ormast	40	36	CY 多 流程樣板號；NOGI 多 訂單類別碼/集團代號/聯絡人/報價單號/叫修單號	Model 補 流程樣板號（其餘 NOGI 欄早已在 Model）

view vw_ormast	48	45	CY 多 JOIN 欄 leadtimes/leadtimet（+流程樣板號）	Source 補 leadtimes/leadtimet 私有欄位

base ordetl	59	49	CY 多 預示資料/預示比對/比對說明1/比對說明2/回覆	Model 補這 5 欄

view vw_ordetl	69	57	CY 多 JOIN 欄 停用/停用日期/預訂完工日（+上述 5 base 欄）	Source 補 5 base 欄（委派 Model）+ 停用/停用日期/預訂完工日 私有欄位

（稽核/系統欄 輸入日期/輸入人員/輸入地點/增刪修/選擇/管制碼/srvdbid/pkid/logid/linkid 不列入比對。）

新增

Common/Model/E.Order/Twork_ord_vw_ormastModel.cs

• 流程樣板號（string，nvarchar(20)，CY-only base 欄）

Model/Source/E.Order/Twork_ord_vw_ormastSource.cs

• 流程樣板號（委派 Model，base 欄）

• leadtimes、leadtimet（int，view JOIN 唯讀欄 → Source 私有欄位，不上傳）

Common/Model/E.Order/Twork_ord_vw_ordetlModel.cs

• 預示資料(250)、預示比對(150)、比對說明1(150)、比對說明2(150)、回覆(250)（皆 CY-only base 欄）

Model/Source/E.Order/Twork_ord_vw_ordetlSource.cs

• 預示資料、預示比對、比對說明1、比對說明2、回覆（委派 Model，base 欄）

• 停用(char(1))、停用日期(varchar(10))、預訂完工日(nvarchar(10))（view JOIN 唯讀欄 → Source 私有欄位，不上傳）

變更

無既有欄位行為變更。vw_ordetl 的 品名 早已由 Source 私有欄位 _SKUDescription 承接（符合 view-only 規範），不需調整。

刪除

無。本次為純加法聯集；舊 Model 既存的 view JOIN 欄（如 客戶簡稱/姓名/中文描述 等）未搬離 Model，

因使用者本次未要求 Model 嚴格對應 base table。

Breaking Changes

無。

Migration Notes

• 本機 SQLite 由 EnsureCreated 重建即帶新欄；缺欄走 LocalDbService 補欄安全網，無需手動 migration。

• 伺服器上傳沿用 ADR 0050 的 OPENXML 自動取交集，目標庫缺的 base 欄（如 NOGI 沒有 流程樣板號、預示資料 等）會被自動略過，不影響存檔。

• view JOIN 唯讀欄走 Source 私有欄位、不在 GetModelBase() 序列化，本就不會上傳。

2026-06-30 自訂查詢面板 SQLite 暫存表真正隔離（TempTableScope）

摘要

補上 CUSTOMDASH（ADR 0068）的 SQLite 盲區：同一支「SQLite 虛擬化型」查詢被寄生多份時，原本共用 per-ProgramClass/固定名的暫存表而互相 DROP/覆蓋。改以 IAppContext.TempTableScope 統一隔離，每塊 tile 各自一張表。

新增

• Common/TempTableNaming.cs：共用後綴 helper Apply(scope, table)（scope 空＝原樣回傳）。

• IAppContext.TempTableScope（+ AppContext 實作、CreateChildContext 沿用）。

• SQLiteForBrowse.DropScopedTables()：tile 釋放時清掉本後綴的孤兒暫存表。

變更

• SQLiteForBrowse：表名 T() 與清理改讀 Context.TempTableScope（取代過渡期的私有 BrowseScope）。

• InvpivotBll（"invpivot"）、Abook1Bll（"abook1"）：暫存表名帶 TempTableScope 後綴（寫讀同名）。

• ProgramNavigator：寄生查詢時對該 tile 的 scoped context 設唯一 TempTableScope。

• 3 個測試 IAppContext 實作補 TempTableScope stub。

刪除

無。

Breaking Changes

無。TempTableScope=null（所有正常程式）時表名完全不變、行為零影響——只有 CUSTOMDASH 寄生實例會帶後綴。

Migration Notes

• 經全專案掃描確認：ExportToSqlite（~250 處）皆報表/列印、CreatePivotDateInSqlite 皆樞紐 Excel、PurchQuery grid 為記憶體型——皆非 grid 暫存表，不需隔離。grid 虛擬化只有兩條路（BrowseProvider→SQLiteForBrowse、SQLiteProvider<T>），都已涵蓋。

• SQLiteProvider<T> 不需改（接收的是已帶後綴的最終表名）。

• 範圍外同型 pattern：Splace/Gsplace 也用 SQLiteProvider<T> 固定表，但為主檔編輯表單（非查詢程式），CUSTOMDASH 不 host，未處理。

• runtime 僅模擬環境手動驗（INVPIVOT 同支多開）。

2026-06-30 自訂查詢面板改回「按查詢一次全查」

摘要

CUSTOMDASH 原本是「切到分頁才查、每次切到重查」（ADR 0068 option a），用意是避開 SQLite 虛擬化型查詢共用暫存表被覆蓋。TempTableScope 上線讓每塊 tile 暫存表真正隔離後，重查的理由消失——改回使用者偏好的「按查詢按鈕＝一次把每塊 tile 都查好」，之後切分頁只顯示既有結果、不重查。

變更

• CustomdashViewModel：

- Query() 建好 tiles 後呼叫新的 全部查詢Async，直接驅動每塊寄生 VM 的 Query()（背景緒）＋ UIUpdate()（UI 緒）一次全查。直呼 VM 而非走 QueryButton，因 TabControl 虛擬化、非當前分頁的 View 沒掛 ErrorCheckable，走 QueryExecute 會 NRE。

- SelectedTile setter 不再觸發查詢（只更新選取）。

刪除

• 切換查詢Async / 自動查（lazy 切到就重查）。

• CustomdashTileViewModel.查詢中（重入旗標，已不需要）。

Breaking Changes

無。

Migration Notes

• 依賴 TempTableScope 暫存表隔離（2026-06-30 temptable changelog）才安全全查；該隔離不可回退。

• runtime 僅模擬環境手動驗。

2026-06-30 自訂查詢面板：多支查詢改並行（per-tile 獨立 SQLite 檔）

摘要

CUSTOMDASH 按「查詢」原本一支查完才查下一支（序列）。改成限流並行：每塊 tile 各自一個實體 SQLite 暫存檔，SQL Server 查詢重疊、SQLite 寫入零鎖競爭。清單多支時明顯變快。詳見 ADR 0070。

變更

• CustomdashViewModel.全部查詢Async：foreach … await 序列 → SemaphoreSlim(4) 限流 + Task.WhenAll 並行。各塊查完才解除自己的「查詢中…」轉圈。

• SQLiteCreatorFactory.GetTempDb：TempTableScope 非空時把它接成 UserDirectory 子資料夾當快取 key／檔案路徑 → 每塊 tile 一個 EnvironmentSettingDB.db。正常程式（scope 為空）行為完全不變。

• tile Dispose：改成刪整個 per-tile 子資料夾 + 淘汰工廠快取項（取代逐表 DropScopedTables）。

新增

• ISQLiteCreatorFactory.RemoveTempDb(IAppContext)：淘汰 per-tile 暫存 DB 快取項，避免 singleton cache 隨每次查詢堆積。

刪除

無。

Breaking Changes

無。TempTableScope=null（所有正常程式）時暫存 DB 的 key／路徑／表名完全不變——只有 CUSTOMDASH 寄生 tile 會分檔。

Migration Notes

• 並行前提：寄生查詢 VM 的 Query() 須 scope 自足（無 static／跨 VM 共享可變狀態）。

• runtime 僅模擬環境手動驗（多支同頁並行）。

2026-06-30 自訂查詢面板：彙整列印（多查詢報表合併成單一 PDF）

摘要

CUSTOMDASH 自訂查詢面板頂端新增「彙整列印 (PDF)」按鈕：把清單裡的多支查詢各挑一張報表，合併成一份 PDF 預覽（預覽視窗內建「匯出PDF」即另存）。詳見 ADR 0071。

新增

• 面板頂端工具列「彙整列印 (PDF)」按鈕。

• CustomdashPrintSelectViewModel + 自訂查詢彙整列印選擇.xaml（ProgramClass.CUSTOMDASHPRINT）：逐查詢勾選＋報表下拉的選擇彈窗，無報表的查詢自動 disable。

• PrintHelper.PrepareMergedReport(...)：多支報表 Load＋Prepare(append) 合併成一份 FastReport Report。

• IContentWindowService.ReportPreviewPrepared(report)：預覽「已 Prepare」的報表（不 re-Prepare，避免洗掉合併頁）。

• CustomdashTileViewModel.ScopeContext：暴露 tile 的 scoped context，供 browse 型報表從 per-tile 暫存檔匯出資料。

變更

• TsFastReportPreview 建構子加 alreadyPrepared 旗標（預設 false，既有呼叫零影響）。

• 選擇彈窗改用 TsCheckBox／TsComboBox（原 CheckBox／ComboBox）；移除說明文字的顏色覆寫。

修正

• PrintHelper.ExportDataToSqlite browse 路徑：原本用 rpt.BrowseTables[i]（server 不帶後綴表名）直接讀暫存 DB，但寄生查詢(TempTableScope 非空)的暫存表是帶後綴建的 → 讀到不存在的表 → 合併列印每筆都失敗、跳「沒有可列印的報表資料」。改成讀取／複製來源套 TempTableNaming.Apply(TempTableScope, …)（目的表維持乾淨名）。正常程式 scope 為空＝原樣，零影響。

• 註記：browse 報表沿用既有慣例，只輸出 grid 中已勾選的列（CopyBrowseToOtherSqlite 以 SysIsSelected='Y' 過濾）。彙整列印前請先在各查詢結果勾選要印的列。

刪除

無。

Breaking Changes

無。

Migration Notes

• 合併與匯出全走既有 FastReport，無新相依、不動 DB。

• runtime 僅模擬環境手動驗（多查詢挑報表→合併→預覽→匯出PDF）。

• 跨範本 Prepare(append) 若 runtime 出現版面/資料問題，備案為改用 Telerik PdfProcessing 合併（見 ADR 0071）。

2026-06-30 自訂查詢面板寄生 scope 繼承登入 session（修查詢 DataSourceRouter NRE）

摘要

CUSTOMDASH 按查詢時 Sql.SetLogSysExecCommand 讀 _context.DataSourceRouter.DbType 拋 NullReferenceException。原因：寄生 tile 用的新 DI scope 取得的是全新未初始化 AppContext，DataSourceRouter/User/EnvironmentSetting 等登入時手動塞的 session 欄位都是空的。改為新 scope 主動繼承主 context 的 session 狀態。詳見 ADR 0069。

新增

• AppContext.InheritSessionFrom(IAppContext parent)：把 parent 的 session 級服務（DataSourceRouter / User / EnvironmentSetting / LanguageService / MessageService 等）灌進本實例；刻意不沿用 SQLiteForBrowse／TempTableScope（維持每塊 tile 暫存表隔離）。

• ProgramNavigator.CreateHostedScope()（private）：統一「建 scope → 繼承 session → 設唯一 TempTableScope」。

變更

• ProgramNavigator 三條寄生路徑改用 CreateHostedScope()：CreateHostedQueryProgram、CreateHostedContent、GetProgramDefaultParameter。scope 在建 vm 之前先初始化，確保 vm 與其注入的 Sql/BLL 拿到已填好的 context。

刪除

無。

Breaking Changes

無。只有 CUSTOMDASH 寄生路徑會走 CreateHostedScope；正常程式不開新 scope、不受影響。

Migration Notes

• 暫存表隔離（ADR 0068 / 2026-06-30 TempTableScope changelog）不受影響：SQLiteForBrowse 與 TempTableScope 仍 scope-local。

• runtime 僅模擬環境手動驗（CUSTOMDASH 選查詢程式後按查詢）。

2026-06-30 自訂查詢面板（CUSTOMDASH，spike）

摘要

新增實驗性「自訂查詢面板」（ProgramClass CUSTOMDASH，放 M.主管資訊）：在下方查詢區選多支既有查詢程式、用各程式自己的中文條件畫面設條件、加入清單，按查詢後上方以 TsTab 分頁並列各查詢的原生結果表格。仍為 spike（未做存配置/拖拉版面）。

新增

• 自訂查詢面板頁面：

- 查詢區：查詢型程式下拉（只列查詢型）→ 選了直接顯示該程式原生中文條件畫面 → 「加入清單」累積成查詢清單（可移除/清空）。

- 結果區：每支查詢一個 TsTab 分頁（標題＝程式名稱），分頁內容＝該程式原生 grid。

- 切到分頁就重查：只實體化當前分頁（省記憶體），每次切到用自己的條件重跑。

• 寄生工廠（ProgramNavigator）：CreateHostedQueryProgram / CreateHostedContent / GetHostableQueryPrograms / GetProgramDefaultParameter——以反射建出查詢程式 VM 並包成 layout 寄生，不進導覽快取。

• dev-programs.json 加 CUSTOMDASH（M-D3）；App.xaml 2 個 DataTemplate；DI 註冊 CustomdashConditionViewModel。

變更

• 條件不再以 JSON 編輯，改用各程式原生條件畫面（全中文）。內部仍以英文屬性名 JSON 儲存（使用者看不到），查詢時 PopulateObject 灌回。

• 每塊分頁各自一個 DI scope → 參數隔離（同支多開、與正常開的同支互不干擾）。

刪除

無。

Breaking Changes

無（純新增）。

Migration Notes

• 開發機：dev-programs.json 已含 CUSTOMDASH，啟用 DevPrograms 重新登入即見。正式環境需 usp_新增程式 登錄（尚未產 SQL，spike 階段）。

• 已知限制：SQLite 虛擬化型查詢的 per-ProgramClass 暫存表為共用資源，DI scope 隔離不到；靠「切到就重查」在循序檢視下顯示正確，快速來回切/與正常程式並跑仍可能撞表。真正隔離需 StagingScope（ADR 0043），未做。

• runtime 僅模擬環境手動驗。

CUQT 兩庫欄位聯集同步（darbnogicsa1 ∪ darbcycsa1）

摘要

依 _sheetno 查得 CUQT（客戶報價單）主表 cuqtm/vw_cuqtm、子表1 cuqtd1/vw_cuqtd1、子表2 cuqtd2（無 view）。

比對鈞寶（darbnogicsa1）與朝陽（darbcycsa1）兩庫 base table 與 view 欄位，取聯集後同步回程式。

屬 ADR 0050（多客戶差異處理）的延伸，未新開 ADR。

⚠️ 類別命名對應（TableMap.json）

CUQT 子表類別名稱與實體表有刻意的位移，務必對照 TsERP/Lang/TableMap.json：

實體表	中文	對應類別

cuqtm	報價主檔	Twork_ord_vw_cuqtm

cuqtd1	材料明細	Twork_ord_vw_cuqtd（無數字）

cuqtd2	加工明細	Twork_ord_vw_cuqtd1（帶 1）

比對結果

物件	NOGI	CY	差異	處理

base cuqtm	49	39	CY 多 單品報價別/美元匯率/日圓匯率/模費轉訂單；NOGI 多 報價類別/序號前置碼/報價人員/有效期限/最低訂單量/圖檔名稱/模穴數/材質/生產機器/注意事項/模具摘要/聯絡單id/工作流程/已審核	Model+Source 補 4 個 CY-only 欄（NOGI 欄早已齊全）

view vw_cuqtm	52	42	view-only JOIN 客戶簡稱/說明/廠商簡稱（兩庫相同，皆已存在）	無新增

base cuqtd1（材料明細，類別 cuqtd）	20	25	CY 多 原始品號/淨數量/材料費/加工費/殘料量/殘料單價；NOGI 多 損耗率	Model+Source 補 6 個 CY-only 欄

view vw_cuqtd1	21	26	view-only JOIN 廠商簡稱（兩庫相同，已存在）	無新增

base cuqtd2（加工明細，類別 cuqtd1）	14	13	CY 多 費率_分/裸價模具費/模具費；NOGI 多 費率/裸價治具費/治具費/參考加工費	Model+Source 補 3 個 CY-only 欄；無 view

（稽核/系統欄 輸入日期/輸入人員/輸入地點/增刪修/選擇/管制碼/srvdbid/pkid/logid/linkid 不列入比對。）

新增

Twork_ord_vw_cuqtmModel / Twork_ord_vw_cuqtmSource（報價主檔）

• 單品報價別(char(1))、美元匯率(numeric(12,4))、日圓匯率(numeric(12,4))、模費轉訂單(char(1))

Twork_ord_vw_cuqtdModel / Twork_ord_vw_cuqtdSource（材料明細，實體 cuqtd1）

• 原始品號(nvarchar(30))、淨數量(numeric(15,4))、材料費(numeric(16,6))、加工費(numeric(16,6))、殘料量(numeric(11,5))、殘料單價(numeric(16,6))

Twork_ord_vw_cuqtd1Model / Twork_ord_vw_cuqtd1Source（加工明細，實體 cuqtd2）

• 費率_分(money(19,4))、裸價模具費(int)、模具費(int)

全部為 base table 聯集欄、Source 委派 Model。本次無新增 view-only JOIN 欄（客戶簡稱/說明/廠商簡稱/廠商簡稱/品名 早已存在）。

變更

無既有欄位行為變更。

刪除

無。純加法聯集；舊 Model 既存的 view JOIN 欄（客戶簡稱/說明/廠商簡稱）未搬離 Model，因本次未要求 Model 嚴格對應 base table。

已知缺口（非本次處理）

• 實體 cuqtd2（加工明細）在 _sheetno 列為子表2，無對應 view，且新系統的 Twork_ord_vw_cuqtd1 類別已承接其欄位（命名位移，見上表）。_sheetno 的「子表2 cuqtd2」本身沒有獨立的 Twork_ord_vw_cuqtd2 類別——這是既有架構（cuqtd1↔cuqtd、cuqtd2↔cuqtd1），非缺漏。

Breaking Changes

無。

Migration Notes

• 本機 SQLite 由 EnsureCreated 重建即帶新欄；缺欄走 LocalDbService 補欄安全網，無需手動 migration。

• 伺服器上傳沿用 ADR 0050 的 OPENXML 自動取交集，目標庫缺的 base 欄（如 NOGI 沒有 美元匯率、CY 沒有 損耗率/參考加工費 等）會被自動略過，不影響存檔。

• view JOIN 唯讀欄走 Model 既有欄位承接（本案未新增），不影響上傳。

CUQT 客戶報價單 — CY(朝陽/鈞寶) 成本模型還原

摘要

繼 CUQT 兩庫欄位聯集同步（commit d96e609c）補齊 DB 欄位後，本次把 CY 版客戶報價單的成本計算與 UI 還原到 VFP scx_ord_cy/cuqt 的口徑。對比報告指出新版整支原本照 NOGI 做，導致 CY 客戶的加工費、模具/治具分攤費會算成 0 或錯值。屬 ADR 0050（多客戶差異處理）的延伸，未新開 ADR。

決策：依使用者裁示，本表單顯示直接切成 CY 版（不做 prgsct1 gating），計算邏輯仍以 CompanyShortName（朝陽/鈞寶）分支以保非 CY 路徑安全。

新增（UI 欄位）

主檔（Cuqt.xaml）

• 模具組數、治具組數：CY 模具分攤費的兩個獨立分母（VFP cuqt_cy 行1926-1927）。

材料明細 grid

• 淨數量、材料費、加工費、殘料量、殘料單價：CY 專屬成本拆解欄（純輸入/顯示，無自動計算）。

加工明細 grid（改為 CY 版）

• 新增 費率(分)(費率_分)、裸價模具費、模具費；移除 NOGI 專屬的 費率、裸價治具費、治具費、參考加工費 顯示。

變更（計算邏輯）

• 加工金額：CY 改用 次數 × 加工時間 × 費率_分（VFP 行1916/1984）；非 CY 維持 費率。Twork_ord_vw_cuqtd1Source.Get加工金額() 依 CompanyShortName 分支，新增 費率_分Binding 觸發重算。

• 主檔治具價格：CY 彙總加工明細的 模具費 欄（VFP 行1916），非 NOGI 的 治具費。CuqtViewModel.Sum()。

• 族群寫回：VFP 行1929-1941 — 單品報價別='1'(族群) 時不把彙總寫回主檔；其餘才寫回。CuqtViewModel.Sum() 以 if (單品報價別 != "1") 包住主檔寫回。

• 連動重算：master listener 加入 模具組數/治具組數；detail1 listener 加入 模具費，使 CY 欄編輯即時觸發 Sum()。

• 單價連動（業務新規則，VFP 無此邏輯）：材料明細 材料費/加工費 異動 → 單價 = 材料費 + 加工費，經既有 單價Binding 連帶重算 材料金額(=數量×單價) 與 單價百分比，再觸發主檔 Sum()。單價 仍維持可手動覆寫。Twork_ord_vw_cuqtdSource 新增 材料費Binding/加工費Binding。

• 百分比顯示（先前 commit c7cdb602）：單價百分比/加工時間百分比 補 *100。

刪除

加工明細 grid 不再顯示 NOGI 的 費率/裸價治具費/治具費/參考加工費 欄（屬性仍保留於 Source/Model，僅移除 UI）。

Breaking Changes

本表單顯示改為 CY 版：非 CY(朝陽/鈞寶) 部署的加工明細將看不到 費率/治具費 輸入欄。計算分支雖保留非 CY 路徑，但 UI 已不支援非 CY 輸入。實際部署客戶皆為 CY，影響為零。

待確認 / 後續

• 原始品號（材料明細）VFP 無對應 grid 欄，未露出。

Migration Notes

• 純程式變更，無 DB migration（欄位已於 d96e609c 補齊）。

• 本機 SQLite 由 EnsureCreated 重建即帶新欄。

驗收條件

1. CY：填 次數/加工時間/費率_分 → 加工金額 = 次數×加工時間×費率_分；加工費彙總正確。

2. CY：加工明細模具費 → 主檔治具價格正確；治具組數>0 → 模具分攤費含治具分攤。

3. CY：模具組數>0 → 模具分攤費含模具分攤。

4. 報價金額 = 材料費+材料利益+加工費+加工利益+包裝費+運費+關稅+模具分攤費。

5. 單品報價別='1'(族群) 時主檔彙總欄不被明細覆蓋。

6. 材料明細輸入材料費/加工費 → 單價自動=材料費+加工費、材料金額=數量×單價隨之更新；單價仍可手動改。

2026-06-30 cuinve 上下一筆客戶簡稱空白修復

摘要

cuinve（客戶聯絡單）在「上下一筆」切換既有單據時，客戶簡稱欄常常空白。

原因

客戶簡稱 是 vw_cuinvema JOIN 客戶資料帶出的 view 欄位，navigate 時本來就由 EF 從 view 正確載入。

但 Twork_ord_vw_cuinvemaSource.RefreshDescription()（由 AfterMoverRecord 在每次 navigate 後呼叫）

會「無條件」用 DescriptionHelper.GetCustomerName(客戶代號) 的 dbf 反查結果覆蓋 客戶簡稱。

當該反查回空字串（客戶代號被 CHAR 補白對不上 key、或本機 dbf 客戶快取尚無該客戶）時，

就把 view 已帶出的正確簡稱「清成空白」→ 畫面空白。

（同模組的 ci 沒這問題：它的 客戶名稱 是 [NotMapped] 純靠 GetCustomerName 填，不從 view 載、無可被清掉的值。）

變更

• Model/Source/E.Order/Twork_ord_vw_cuinvemaSource.cs RefreshDescription()：

改為「查得到才覆蓋」——dbf 反查有值才寫入 客戶簡稱，查不到就保留 view 已帶出的值。

影響範圍

僅 cuinve 主檔客戶簡稱顯示。存檔/上傳不受影響（客戶簡稱 不寫入 Model、本就不上傳）。

Breaking Changes

無。

Migration Notes

需重建 TsERP 才會生效。

2026-06-29 — 修復 V1 `TsSearchTextBox` 存在性驗證形同虛設

摘要

修正舊版（V1）TsSearchTextBox 搜尋欄輸入不存在的代號卻不會跳錯的問題。

根因：OnApplyTemplate 建好了帶 TsSearchRule（資料存在性）/PrimaryKeyRule

（主鍵）驗證規則的 binding，卻漏呼叫 BindingOperations.SetBinding 套回控件，

導致規則建好即丟棄、實際 binding 沒有任何驗證。新版 TsSearchTextBoxV2 早已修掉

此問題（且留有註解），V1 一直沒同步。本次把 V1 對齊 V2。

變更

• TsControl/TextBox/TsSearchTextBox.cs：OnApplyTemplate 在加完驗證規則後，

以 ruleAdded 旗標守護並呼叫 BindingOperations.SetBinding(this, TextBox.TextProperty, newBinding)

把帶規則的 binding 套回（與 TsSearchTextBoxV2 寫法一致）。

影響範圍（Breaking-ish 行為變更）

• 所有 使用 V1 TsSearchTextBox 且 CheckDataExist=true（預設）的欄位，

自即日起會在失焦時驗證代號是否存在於 ExistTable：

- 查無 → 嗶聲 + 跳「資料不存在」訊息框 + 紅框，且存檔會被擋。

- IsPrimaryKey=true 的欄位同步啟用主鍵驗證。

• 這是還原本來就該有的行為（屬性預設值即 CheckDataExist=true），

但等於讓多支沿用 V1 的表單「突然開始擋」以前默默吃下的亂輸入。

• 觸發本次調查的案例：Eventproject.xaml 的「負責人」（EmployeeSearch style，

查 perdata.員工編號）以前亂打不擋，現會擋。

注意事項

• 若有欄位本來就允許自由輸入（非主檔代號）卻沒顯式設 CheckDataExist="False"，

修正後會被誤擋——請改設 CheckDataExist="False"。建議回歸時重點測 V1 搜尋欄較多的表單。

• DeepCopyBinding 已完整複製 Mode/UpdateSourceTrigger/ValidatesOnExceptions/

NotifyOnValidationError 等屬性，重新套 binding 不會掉設定。

• TsControl 專案已用 VS MSBuild 建置通過（僅既有無關警告）。

2026-06-29 安全庫存自動檢查補寄信（TWORK_AUTO_SAFETYSTOCK → mailqueue）

摘要

行事曆「安全庫存檢查」事件自動執行後，原本只把缺料結果寫進 twork_auto_safetystockhistory

並回寫 eventitem，從未把信排進 twork_skd_mailqueue，所以 SchedulerWorker 的寄信路徑（Mailgun）

永遠撈不到信、收件人收不到通知。

依 darbnogicsa20260513 庫內較新版本的 TWORK_AUTO_SAFETYSTOCK，把「撈收件人 → 把未達安全庫存清單

渲染成 HTML 表格 → INSERT twork_skd_mailqueue」這段補回 repo 的母本與各客戶部署腳本。

變更

• SqlBI/TWORK_AUTO_SAFETYSTOCK.sql（csa 母本／對照）— proc 結尾加入寄信段。

• sql/deploy-darbnogiauto1.sql（鈞寶集中自動化庫部署版）— 同步加入。

• sql/deploy-darbcyauto1.sql（朝陽集中自動化庫部署版，包在 EXEC(N'...') 內，引號加倍）— 同步加入。

寄信段行為：

1. 從 twork_skd_eventitem.通知帳號（事件設定畫面維護）取收件人；空白則 RETURN（不影響本次執行成功狀態）。

2. 本次 GUID 批次無缺料品項（@rowCount = 0）則不寄。

3. 主旨：【安全庫存檢查通知】<日期>　共 N 筆未達安全庫存。

4. 內文：HTML 表格（品號／品名／安全庫存／現有數量／滿足安全／M0–M6），現有數量紅字標示。

5. INSERT dbo.twork_skd_mailqueue(收件人, 主旨, 內文, 是否HTML='Y', 來源預存程序, 執行guid)，

交由 AP 端 TsERP.SchedulerWorker 的 DequeueMailAsync 經 Mailgun 寄出。

Breaking Changes

無。proc 對外回傳的結果集與既有 history 寫入不變，僅在最後多排一封信。

Migration Notes

⚠️ 需在各客戶的集中自動化庫重跑部署腳本才會生效（本機已 SET PARSEONLY 驗證文法，未實際部署）：

sqlcmd -S <server> -E -f 65001 -i sql\deploy-darbnogiauto1.sql   # 鈞寶


sqlcmd -S <server> -E -f 65001 -i sql\deploy-darbcyauto1.sql     # 朝陽

前置：

• twork_skd_mailqueue 表（部署腳本內已含建表）。

• CY 版另有既有 guard：darbcycsa1.dbo.twork_skd_eventitem 需有 執行guid 欄，缺欄會跳過建 proc。

• 事件需在行事曆設定「通知帳號」（收件人），否則只寫 history 不寄信。

2026-06-29 總帳儀表板（GLDASH）

摘要

總帳管理（N.總帳管理）新增一支「總帳儀表板」（ProgramClass GLDASH），比照主管儀表板（EISDASH）的版面，讓主管一頁綜覽財務全貌：損益、資產負債、費用趨勢、傳票與現金。四塊資料全部重用既有作業的 SP / BLL，不需部署任何新 SP，也不需 proc_param 登錄。

新增

• 總帳儀表板頁面：工具列（本月／本季／本年／自訂日期快切 + 自動刷新 + 重新整理）+ 8 張 KPI 卡 + 2×2 圖表 + 2 張清單。

- KPI 卡（本期）：本期營收、營業毛利（含毛利率）、營業費用、本期淨利（含淨利率，虧損紅字）、總資產、總負債（含負債比）、現金與銀行、本期傳票（含未過帳張數警示）。

- 圖表：損益結構長條（營收→成本→毛利→費用→營業利益→本期損益）、營業費用逐月趨勢、資產=負債+權益環圈、現金／銀行結餘趨勢（含票據預估）。

- 清單：未過帳傳票、本期費用科目 Top 10。

- 點擊卡片／圖表可直達對應總帳作業（損益表／資產負債表／會計日記帳／銀行金流），到頁後自動帶儀表板當前日期區間並自動查詢（不必再手動設條件或按查詢）。銀行金流因日期語意是現金流預估到期日、非查詢區間，故沿用其自身預設。

• 資料來源（皆重用既有）：損益與費用走 IncomeBll（DARB_QRY_INCOME）、資產負債走 BalanceBll（DARB_QRY_BALANCE）、傳票走 SliybrowdBll（DARB_BD_SLIY）、現金走 BankflowBll。

• 選單登錄 SQL：sql/總帳儀表板_register_program_darbnogicsa1.sql（沿用「資產負債表」選單群組、自動取未使用 N-NN 序號）。

• 開發機免動 DB：dev-programs.json 已加 GLDASH 一筆（啟用 DevPrograms 後重新登入即見）。

變更

• 金額統一以本位幣顯示。

• 各區塊獨立載入、錯誤隔離：任一塊讀取失敗只該卡片／圖表顯示「讀取失敗」，不影響其他區塊。

刪除

無。

Breaking Changes

無。

Migration Notes

• 正式環境部署：執行 sql/總帳儀表板_register_program_darbnogicsa1.sql 一次即可（前置：usp_新增程式 已部署於該庫）。

• 無新 SP、無 proc_param、無資料 migration。

• 第一版只呈現當期數字，未做 YoY/MoM 比較基準；runtime 尚未驗收。

2026-06-29 — EVENTPROJECT（排程事件（專案））補登錄到朝陽 CY

摘要

把 NOGI（darbnogicsa1）已登錄的 EVENTPROJECT（排程事件（專案））程式，

照搬補登錄到朝陽 CY（darbcycsa1）的四張中繼資料表 _menum / _menud /

_sheetno / _tableseq，讓「排程事件（專案）」表單在 CY 的 L.聯絡傳訊 模組

也能從主選單開啟與建立單號。

新增

• sql/eventproject_register_program_darbcycsa1.sql：冪等部署腳本，

以同伺服器跨庫 INSERT...SELECT 從 darbnogicsa1 複製 EVENTPROJECT 四列。

四表各以 NOT EXISTS 守護，可重複執行。

變更（兩處必要偏離，其餘逐欄原樣複製）

• 選單序號：NOGI 用 L-05，但 CY 的 L-05 已被 PROMOT_QRY

（提案資料查詢）占用。腳本於 L.聯絡傳訊 模組自動挑「現有最大序號 +1」的

第一個空號（本次 → L-07，附加在選單末端）。

• _tableseq.seqval：NOGI=5，CY 為全新安裝無任何 EVENTPROJECT 單據，

計數器歸 0（與 usp_新增程式 慣例一致），單號從頭起算。

• srvdbid 改用 CY 自身值；pkid 重算（_sheetno.pkid 為 identity）。

Migration Notes

• 執行（中文物件，務必其一，避免 sqlcmd 預設 codepage 靜默漏建）：

sqlcmd -S localhost -E -f 65001 -i sql\eventproject_register_program_darbcycsa1.sql

或於 SSMS 開檔執行。

• 已在模擬環境（localhost）實跑驗證：四列成功新增、再跑一次全部略過（冪等）。

• 本腳本只動四張選單／單號中繼表；不建 prgsct1 權限列、不改 proc。

使用者權限（可否瀏覽／修改）若需要，另循既有 prgsct1 流程補。

• 相依資料表 twork_skd_eventitemm / twork_skd_eventitem 在 CY 已存在；

但排程「自動執行」鏈在 CY csa 仍有落後（見 ADR 0065 備註：CY 缺

twork_skd_eventitem 部分欄位、twork_vw_calendarevent view 待修），

表單本身的登錄／建單不受影響。

2026-06-29 個人/期間效率統計改用 TsRadGridView + TsTab，條件面板整理

摘要

CY 主管資訊「個人效率統計」(pd_qry1) 與「期間效率統計」(pd_qry2) 內部仍混用舊 WPF 控件，與其餘查詢頁不一致；查詢條件面板排版凌亂、且未標示各條件適用於哪個分頁。本次統一改版並標註。

變更

• TsERP/M.EIS/個人效率統計.xaml：左側「生產部門」勾選表 DataGrid → TsRadGridView（選擇 用 TsGridViewCheckBoxColumn，bool 直綁）。結果格本即 TsRadGridView。補 ProgramClass="Pd_qry1" 啟用欄位版型持久化。此頁無分頁。

• TsERP/M.EIS/期間效率統計.xaml：

- 左側「生產部門」DataGrid → TsRadGridView。

- 外層 TabControl（BottomTab 樣式）→ TsControl:TsTabControl / TsTabItem（Header 用 TsTextBlock）。

- 三個結果格補 ProgramClass="Pd_qry2"。

• TsERP/M.EIS/個人效率統計Condition.xaml：改用 GroupBox（藍色標題「查詢條件（個人效率統計）」），起訖日期一列。

• TsERP/M.EIS/期間效率統計Condition.xaml：拆成兩個 GroupBox 並標註適用分頁：

- 「共用條件 · 全部分頁適用」（藍）：起訖日期（部門期間效率 / 組立狀況一覽表 / 期間工時調整一覽表 皆適用）。

- 「僅『組立狀況一覽表』分頁適用」（橘）：品號類型(4 選 2×2)、起訖品號、查詢效率。

- 分頁對應依 Pd_qry2ViewModel.Query() 實際邏輯確認（tab0/tab2 只用起訖日期；tab1 才用品號/效率/品號類型）。

影響範圍

• 兩支查詢頁的外觀與其餘查詢頁一致；條件面板可一眼看出哪些條件只對「組立狀況一覽表」生效。

• 純 View 層（XAML）調整，未改 VM/BLL/邏輯與既有資料繫結（StartDate/EndDate、RadioButtonCheck+RadioConverter、起始品號/截止品號、起始效率/截止效率、選擇、各結果 Source 維持原樣）。

Breaking Changes

無。

Migration Notes

• 改動在 TsERP 組件，需重建 TsERP。runtime 行為（查詢結果）不變。

2026-06-29 修復 CY 行事曆事件「執行」按鈕 JSON 截斷錯誤

摘要

在 CY（darbcycsa1）行事曆單獨按某事件的「執行」按鈕，出現：

ExecuteAsync異常: Unterminated string. Expected delimiter: ". Path 'LP_P1', line 1, position 100.


  at Newtonsoft.Json.Linq.JObject.Parse(...)


  at AutoPilot.AutoPilotHelper.ExecuteMethod(...)

根因：twork_skd_eventitem.參數 欄位在 CY 是 nvarchar(100)，母本 darbnogicsa1 是 nvarchar(4000)（schema 分歧）。AutoPilot 排程事件的 JSON 參數約 113 字，寫入時被 DB 靜默截斷到 100 字，剛好斷在 "LP_P1":" 之後，尾巴 {eventpkid}"} 不見 → JObject.Parse 在 position 100 失敗。App 端 Source 宣告 [TsStringLength(4000)]，本就預期 4000。

範圍：darbcycsa1 安全庫存排程事件 265 筆參數全部被截斷。

變更

• 新增 sql/fix_eventitem_param_width_darbcycsa1.sql：

1. ALTER TABLE twork_skd_eventitem ALTER COLUMN 參數 nvarchar(4000) 對齊母本。

2. 還原被截斷的事件參數為完整模板 {"DataEvent":"AutopilotLogSysExec","Procedure":"TWORK_AUTO_SAFETYSTOCK","Dispatcher":"SKD","LP_P1":"{eventpkid}"}（{eventpkid} 由 SchedulePlaceholders.ReplaceExecutionEventPkidTokens 在執行期替換）。

影響範圍

• CY 行事曆事件「執行」按鈕：參數可正確解析並派發 TWORK_AUTO_SAFETYSTOCK(@eventitempkid)。

• 僅補欄寬與還原資料，未改 AutoPilot/SP 邏輯。

Breaking Changes

無。

Migration Notes

• 此為 darbcycsa1 的 schema + 資料修正，需在 darbcycsa1 執行 sql/fix_eventitem_param_width_darbcycsa1.sql。

• ⚠️ 本次因安全機制未由工具直接套用到模擬環境，需手動執行該腳本後才生效。

• 其他客戶庫（darbkccsa1 / darbzdcsa1 / darbcmacsa1 等）可能有相同欄寬分歧，尚未逐庫盤點。

2026-06-29 修復 CY 行事曆看不到系統事件（SP 漏 or 9）

摘要

朝陽 CY（darbcycsa1）以管理員登入後，右側行事曆已能看到「系統」篩選器，但底下沒有任何系統事件。

根因：darbcycsa1 實際部署的 TWORK_SKD_GETEVENT 與母本（darbnogicsa1，SqlBI/TWORK_SKD_GETEVENT.sql）分歧——第一段 @list 來源只有 擁有者所屬類別=0（公司），漏了 or 擁有者所屬類別=9（系統），導致系統事件永遠不進結果集。資料本身存在（darbcycsa1 有 265 筆系統事件，2026-06 就有 5 筆，皆 已審核=Y、項目類型=0），純粹是 SP 不撈。

（與前一則 admin Trim 修復 2026-06-28-admin-role-trim-fix 是接續：先修好 admin 判定讓「系統」篩選器顯示，才發現 SP 這層也漏。）

變更

• DB（darbcycsa1）：ALTER PROCEDURE TWORK_SKD_GETEVENT，第一段 where 擁有者所屬類別=0 → where 擁有者所屬類別=0 or 擁有者所屬類別=9。CY 專屬的部門 JOIN（twork_bas_vw_dept / DepartmentCode / EmployeeCode）原樣保留，未套母本 schema。

• repo：新增 sql/TWORK_SKD_GETEVENT_darbcycsa1.sql，把修正後的 CY 變體納入版控（含與母本差異註記），避免重佈又掉回舊版。

影響範圍

• CY 行事曆：管理員登入即可看到系統事件（驗證：EXEC TWORK_SKD_GETEVENT '2026/06/29','CMSA' 由 0 筆 → 5 筆系統事件）。

• 系統(9) 是否限管理員仍由前端 UI 把關（DB 端不做 admin 過濾，非硬邊界）；如需 DB 端硬邊界另議。

Breaking Changes

無。

Migration Notes

• 此為 darbcycsa1 的 SP 變更，已於模擬環境套用；正式佈署各 CY 庫時請跑 sql/TWORK_SKD_GETEVENT_darbcycsa1.sql。

• 其他客戶庫（darbkccsa1 / darbzdcsa1 / darbcmacsa1 等）可能有相同「漏 or 9」分歧，尚未逐庫盤點。

2026-06-29 修正支票套印（上海商銀 / Checkpayprint）列印空白

摘要

支票列印彈窗（CheckPrintViewModel，由應付票據 checkpay 的「支票列印」鈕開啟）中，

程式碼註冊的「上海商銀」報表項（報表名稱 = "Checkpayprint"）選取後會套印空白。

變更

• TworkReportPluginOfficial/Checkpayprint.cs：ExportToSQLite 原本是空殼（直接 return true、

未把資料寫入 SQLite），補成讀取 parameters["rpt_o030_checkpayreportpoco1"] 並

ReportSqliteCreator.ExportToSqlite(...)，與 Checkpayzd1 / Checkpayzd2 行為一致。

原有的 SetParameters（注入公司電話/傳真/地址）保留不動。

根因

PluginHelper.GetReportPlugin(插件名稱, 報表名稱) 在 插件名稱 留空時，會以 報表名稱 找同名

plugin class。該報表項未設 插件名稱，於是 fallback 到同名的 Checkpayprint plugin——但它的

ExportToSQLite 沒有把 ReportSource 資料寫進共用表 rpt_o030_checkpay_report1，導致報表

讀到空表（或殘留舊資料）。會正確匯出的 Checkpayzd1/zd2（DB 註冊的各銀行版型用）才是正常路徑。

影響範圍

• 只影響選取程式碼註冊的「上海商銀 / Checkpayprint」那一筆；DB 註冊的支票套表銀行版型

（走 Checkpayzd1/zd2 plugin）不受影響、原本就正常。

• 預設選取為清單第一筆（DB 版型），故僅在使用者手動切到該筆時才會踩到。

Breaking Changes / Migration Notes

無。純行為修正，不需資料庫或設定異動。

待驗

• 實機列印確認：套印確實帶出資料（金額、金額大寫、民國年/月/天、支票抬頭）。

2026-06-29 修復管理員角色判定未 Trim 空白導致誤判非管理員

摘要

以管理員帳號（管制系統 欄位設為 ADMIN）登入，仍被判為非管理員 → 看不到行事曆「系統」事件、以及其他靠 IsAdmin() 開放的功能。

根因：UserBll.CheckRoleInManagedAccount 把 管制系統（逗號分隔角色字串）ToLower() 後 Split(',')，但沒有 Trim 各 token。當 管制系統 是固定寬度 CHAR 欄位（尾端補空白）或手動輸入夾帶空白時，token 會是 "admin "，與 "admin" 不相等 → Contains 回 false → IsAdmin() 誤判為非管理員。大小寫本來就有處理（兩邊皆 ToLower()），不是問題。

變更

• LogicBll/Login/UserBll.cs CheckRoleInManagedAccount：

- Split(',') 後對每個 token Trim()；比對的 role 也 Trim().ToLower()。

- 修正後 "ADMIN"、"ADMIN "、"Manager, Admin" 等皆能正確判定為管理員。

影響範圍

• 所有透過 IUser.IsAdmin() / CheckRoleInManagedAccount 判斷的功能（如右側行事曆「系統」事件可見性 CalendarPageViewModel.RefreshUserPermission、其他管理員專屬入口）。

• 只放寬「空白容錯」，不改變角色語意；原本就正確（無空白）的設定行為不變。

Breaking Changes

無。

Migration Notes

• 改動在 LogicBll 組件，需重建 TsERP；IsAdmin 在登入時依 管制系統 計算，需重新登入才生效。

• 資料面不需調整；即使 管制系統 欄位是 CHAR 補空白或含手動空白，現在都能正確判定。

2026-06-28 TsRadGridView 重新開啟欄虛擬化（MinColumnWidth 撐住水平捲軸）

摘要

全 app 共用表格 TsRadGridView / TsBrowseRadGridView 重新開啟欄虛擬化（取代 ADR 0026 的全域關閉），

並用 MinColumnWidth=50 把每欄寬度下限拉高，讓欄虛擬化下未實體化的 SizeToHeader/Auto 欄仍以

真實寬度計入水平 ExtentWidth，避免當初「水平捲軸間歇拖不動」重演。

變更

• TsControl/Themes/TsRadGridViewGeneric.xaml（TsRadGridView、TsBrowseRadGridView 兩個 Style）：

- EnableColumnVirtualization 由 False 改為 True。

- 新增 MinColumnWidth=50。

影響範圍

• 全 app 所有 TsRadGridView / TsBrowseRadGridView。

• 寬表（Sliy、總帳類等數十欄）恢復欄虛擬化 → 記憶體/載入/捲動效能回升。

• 各 grid 的窄欄（序號、選擇欄等）寬度下限變為 50px，原本更窄者會略變寬。

• 仍有 local EnableColumnVirtualization="False" 的頁面（ErpPivotQuery 2 個 grid、Receivepq 1 個 grid）

維持非虛擬化，視為刻意例外，本次未動。

Breaking Changes

無。

Migration Notes

• 需重建 TsERP 才會生效（改動在 TsControl 共用樣式）。

• ⚠️ 需 runtime 驗收：請在 Sliy / SliyTurn / 總帳類寬表實機確認水平捲軸可順拖、欄捲入時寬度正常。

若捲軸仍塌陷，退路為該類寬表欄改固定 px 寬，或回退（兩個 setter 改回 False / 移除 MinColumnWidth）。

• 詳見 ADR 0064。

2026-06-28 樞紐選擇器選取項目未生效修復

摘要

查詢/瀏覽類畫面(如 inventquery)底部「樞紐分析表」選擇器(PivotSelector1)的 combobox 雖可下拉選取,但按下「樞紐分析表」鈕後永遠用清單第一筆的樣板檔開啟,不管使用者實際選了哪一項。

原因是控件的選取值沒有回寫到 ViewModel:

1. PivotSelector1.xaml 把 VM 的 SelectedItem 用預設模式綁到 TsComboBoxWithDescription.SelectedItem,但該 DP 未標記 BindsTwoWayByDefault,所以是 OneWay(只 VM→控件)。

2. TsComboBoxWithDescription 內層 combobox 選取變更時(ComboBox_OnSelectionChanged)只更新 Code/Description,從不回寫自己的 SelectedItem DP。

3. 另一個 Code="{Binding SelectedItem.Code, Mode=OneWay}" 綁定是 OneWay 且指向唯讀巢狀路徑,控件裡的 UpdateSource() 形同空操作。

結果:VM 的 SelectedItem 始終停在 ItemsSource setter 初始化的 ItemsSource[0],PivotExecute 拿它的 檔名 去組樣板路徑,於是永遠開第一筆。

(這是 樞紐選擇器 combobox 在查詢畫面無法下拉修復 的後續:combobox 解鎖能下拉後,選取沒接回 VM 這條暗 bug 才浮現。)

變更

• ViewModel/Control/PivotSelector1ViewModel.cs:新增 SelectedCode 字串屬性,綁到控件的 Code(TwoWay-by-default、選取變更時會被推回);setter 依 Code 從 ItemsSource 解析出對應的 SelectedItem。ItemsSource setter 初始化改設 SelectedCode = ItemsSource[0].Code(初始仍選第一筆)。

• TsControl/Layout/PivotSelector1.xaml:combobox 綁定改為 Code="{Binding SelectedCode, Mode=TwoWay}",移除無作用的 SelectedItem="{Binding SelectedItem}" 與 OneWay 的 Code 綁定。

影響範圍

• 樞紐選擇器(PivotSelector1):使用者選哪一項,就用該項對應的樣板檔開啟。

• 未動到共用控件 TsComboBoxWithDescription 本身,其餘 64 處用法行為不變。

Breaking Changes

無。

Migration Notes

改動含 TsControl 共用控件所在組件,需重建整個 TsERP 才會完整生效。

2026-06-28 樞紐選擇器 combobox 在查詢畫面無法下拉修復

摘要

查詢/瀏覽類畫面(如 inventquery)底部「樞紐分析表」選擇器(PivotSelector1)的 combobox 點不開下拉選單。

原因是三件事疊在一起:

1. TsComboBox(全 app 共用,繼承 RadComboBox)2026-04 加入的 IsLocked 機制,在 OnPreviewMouseDown 會把滑鼠點擊吃掉並強制關閉下拉。

2. TsComboBox 的全域預設樣式(Generic.xaml)把 IsLocked 綁到所在表單的編輯狀態:FindAncestor(ITsContentControl).DataContext.ViewModelStatus.Status 經 AdeStatusIsReadOnlyConverter 轉換,FallbackValue=true。

3. AdeStatusIsReadOnlyConverter 除 Empty/Add/Edit/Copy/SpecialEdit 外一律回傳 true(鎖定)。查詢畫面停在 Normal 狀態 → 回 true → IsLocked=true → 下拉永遠打不開。

樞紐選擇器是「工具型」控件,在瀏覽(Normal)狀態下本就該可操作,卻被全域 combobox「非編輯就鎖」的樣式波及。

變更

• TsControl/CombineComboBox/TsComboBoxWithDescription.xaml.cs:新增 opt-in 相依屬性 IgnoreEditStatus(預設 false)。為 true 時用區域值把內層 TsComboBox.IsLocked 覆寫成 false(永遠解鎖)、為 false 時 ClearValue 還原成預設樣式的狀態綁定;另在 Loaded 補套用一次以防屬性早於內層控件設定。

• TsControl/Layout/PivotSelector1.xaml:combobox 加上 IgnoreEditStatus="True"。

影響範圍

• 樞紐選擇器(PivotSelector1)的 combobox:任何狀態下皆可下拉。

• 其餘 64 處 TsComboBoxWithDescription 用途:IgnoreEditStatus 預設 false,行為完全不變(維持「非編輯狀態鎖定」)。

Breaking Changes

無。

Migration Notes

需重建 TsERP 才會生效(改動在 TsControl 共用控件)。

2026-06-28 訂單樞紐樣板資料來源 DBF→SQLite

摘要

把 C:\dglibrary\REPORTSROOT\Template 下三支訂單樞紐分析樣板的外部資料來源

從 Visual FoxPro DBF 改為 SQLite，並清空殘留的舊快取，比照已轉好的

部門費用統計表.xlsx 連線格式。

涉及檔案：

• 客戶訂單品號數量統計.xlsx

• 訂單生產部門查詢.xlsx

• 訂單資料樞紐查詢.xlsx

變更

連線字串（`xl/connections.xml`）

項目	變更前	變更後

連線	DSN=Visual FoxPro Tables;SourceDB=c:\TEMPS\PIVOT;SourceType=DBF;…	DRIVER={SQLite3 ODBC Driver};Database=C:\Temps\Sqlite\Twork_TW.db;

資料表	` SELECT * FROM 訂單明細_d `	` SELECT * FROM DARB_BD_ORMAST00 `

• DBF 的 訂單明細_d（37–39 欄）對應 SQLite Twork_TW.db 的 DARB_BD_ORMAST00

（42 欄）。逐欄比對三支樞紐的 cacheField，全部都在該表中；唯一例外是

客戶訂單品號數量統計.xlsx 的「年」欄（databaseField="0"，是 Excel 對「受訂日期」

做的年度分組欄、非來源欄），不影響。

• 用 SQLite3 ODBC Driver 以 Excel 實際送出的反引號查詢實測，DARB_BD_ORMAST00

回傳 258 筆正常。

清空舊快取

檔案	原快取筆數	現在

客戶訂單品號數量統計.xlsx	0（本來就空）	count=0

訂單生產部門查詢.xlsx	85	count=0

訂單資料樞紐查詢.xlsx	82	count=0

• pivotCacheRecords1.xml 清成 count="0" 的空根節點（保留命名空間）。

• pivotCacheDefinition1.xml 的 recordCount 設 0。

• 三支全部加上 refreshOnLoad="1"，開檔時自動向 SQLite 重抓最新資料。

刪除

移除三支連線中殘留的 odcFile 屬性（指向使用者 OneDrive 的

(預設) 訂單明細_d.odc，內含舊 DBF 連線）。保留會在重新整理時把來源蓋回 DBF；

已轉好的參考檔 部門費用統計表.xlsx 亦無此屬性。

Breaking Changes

無。樣板沿用既有樞紐版面，僅換來源。

Migration Notes

• 目標機需安裝 SQLite3 ODBC Driver（Excel 樞紐用；開發機已裝 32/64-bit 兩版）。

• Twork_TW.db 內的 DARB_BD_ORMAST00 由 ERP 匯出維護，目前已有資料。

• 各檔已備份：*.xlsx.dbfbak（換來源前）、*.xlsx.cachebak（清快取前）。

• 使用者開檔即自動重新整理；如停用自動重整，手動按「重新整理」即可。

2026-06-28 Excel 樞紐信任位置自動化（消除「已停用外部資料連線」警告）

摘要

樞紐分析表範本(.xlsx)內嵌一條外部 ODBC 資料連線(DRIVER={SQLite3 ODBC Driver};Database=C:\Temps\Sqlite\Twork_TW.db),Excel 開檔時預設封鎖外部連線,跳出「安全性警告:已停用外部資料連線 → 啟用內容」橫幅,使用者每次都要手動點「啟用內容」才會刷新資料。

由於 app 每次都把範本複製成新檔再開(PivotBll.CopySqliteAndOpen → C:\Temps\Template\Pivot\),「信任的文件(Trusted Documents)」綁檔案雜湊會每次失效,無法解決;且封鎖是 Excel 用戶端的信任判斷,檔案本身無法宣告連線可信。正解是把固定的開檔夾設為 Excel 信任位置(Trusted Location)——從信任位置開的檔,外部連線自動啟用、也跳過 Protected View。

變更

• deploy/install-customer.ps1:Install 階段(per-user)新增自動把 C:\Temps\Template\Pivot\ 設為 Excel 信任位置。

- 新函式 Set-ExcelPivotTrustedLocation:涵蓋 Office 2010~365(14/15/16.0),只設已安裝的版本,同路徑已存在就跳過(冪等);寫 HKCU\...\Excel\Security\Trusted Locations\LocationN(Path + AllowSubFolders=1)。

- 放在「程式是否已安裝」判斷之前,即使程式已裝、每次跑 Install 仍補設一次(新使用者帳號也涵蓋)。

- 新增參數 -SkipExcelPivotTrust(預設關閉=會設)與 -PivotTrustPath(預設 C:\Temps\Template\Pivot\,對應 ERPIO.PivotTemplateDirectory)。

影響範圍

• 走 install-customer.ps1 -Stage Install(或 Active Setup / GPO 使用者登入指令碼)的客戶機器:每個使用者首次套用後,開樞紐不再跳「已停用外部資料連線」警告。

• 既有單機可手動跑同等的 HKCU 設定達成相同效果(本次已在開發機 Office 16.0 套用)。

• 不影響 Config(SYSTEM)階段;不影響未走此佈署腳本的環境(行為不變,仍會跳警告直到設定信任位置)。

Breaking Changes

無。

Migration Notes

• 此設定為 per-user(HKCU),須以「該使用者」身分執行 Install 階段才會寫進其設定檔。

• 信任位置只解除「啟用外部連線」警告;連線要真正刷新仍需安裝對應位元數的 SQLite ODBC 驅動(-InstallOdbc,位元數對應 Excel 而非 OS)。兩者各管一半。

• Excel 在啟動時讀取信任中心設定;若套用當下 Excel 正開著,需完全關閉再開才生效。

2026-06-28 修復 CY 主管資訊四支效率查詢「無法建立ViewModel」

摘要

朝陽 CY 主管資訊(M.主管資訊)的四支查詢——個人效率統計、期間效率統計、達成率統計、非生產工時統計——按下選單後跳「無法建立ViewModel」錯誤,無法開啟。

根因:這類「條件查詢」程式的主 ViewModel 由 navigator 反射建立,但其依賴的 ConditionViewModel 需透過 DI 取得(IQueryConditionFactory.Create() → GetService<TCondition>())。這四支的 ConditionViewModel 類別、App.xaml DataTemplate 都齊全,唯獨 TsERP/DIExtension.cs 漏了 DI 註冊,GetService 回 null → 丟 未註冊指定查詢條件 ViewModel → navigator 顯示「無法建立ViewModel」。

(真因記錄在 C:\temps\debuglog\<date>.txt,例:[CreateErpProgramBaseViewModel] 未註冊指定查詢條件 ViewModel：Pd_qry1ConditionViewModel。)

變更

• TsERP/DIExtension.cs:補上四支 ConditionViewModel 的 DI 註冊:

- Pd_qry1ConditionViewModel(個人效率)

- Pd_qry2ConditionViewModel(期間效率)

- Pd_qry4ConditionViewModel(達成率)

- WknpdtqConditionViewModel(非生產工時)

影響範圍

• 上述四支查詢從「打不開」修復為可正常開啟條件查詢畫面。

• 純新增 DI 註冊,不影響其他程式。

Breaking Changes

無。

Migration Notes

• 改動在 TsERP 組件,需重建 TsERP 才生效。

• 通則:移植/新增「條件查詢頁」時,除了 VM 改名、ProgramClass、App.xaml DataTemplate,還必須在 DIExtension.cs 加 services.AddScoped<XxxConditionViewModel>(),否則執行期跳「無法建立ViewModel」。

2026-06-28 cuinve NOGI/CY 欄位聯集（view→Source、table→Model）

摘要

依單據別 CUINVE 比對 darbnogicsa1 與 darbcycsa1 兩庫的 _sheetno 對應，做欄位聯集後套回程式：

• Source 以 VIEW 為準：vw_cuinvema（主）/ vw_cuinve（子）。

• Model 以資料表為準：cuinvema（主）/ cuinve（子）。

主表（cuinvema / vw_cuinvema）兩庫資料欄完全相同 → Source/Model 皆無變更。

差異全在子表 cuinve / vw_cuinve。

比對結果

物件	NOGI	CY	nogi-only	cy-only

base cuinve	35	29	箱長/箱寬/箱高/材積/單重/單價/變動日期/業務員編號	產品別/紙箱尺寸

view vw_cuinve	38	63	單重/單價/變動日期/箱長/箱寬/箱高/材積/業務員編號/姓名	（另含 32 個 JOIN 庫存主檔欄）

view 比 base 多出的欄是 vw_cuinve JOIN 庫存主檔 invent 得到的唯讀欄。

變更

Model（`Twork_ord_vw_cuinveModel`）— 對應 base table `cuinve`

無新增。base cuinve 聯集（含 nogi-only 8 欄與 cy-only 產品別/紙箱尺寸）原本即已齊全。

Source（`Twork_ord_vw_cuinveSource`）— 對應 view `vw_cuinve`

新增 32 個 CY view 專屬欄（JOIN 庫存主檔），以 Source 自帶私有欄位承接（不寫入 Model）：

群組代號, 設變編號, 設變資料, 停用說明, 管制說明, 群組說明, 中文描述, 停用, 停用日期,

品別(byte), 材質, 規格, 型別, 加工, 包裝材料, 包裝量_包, 儲位, 單位, 標準售價,

廠商代號1, leadtime(short), 內箱包裝數, 最小採購量, 英文描述, 最低訂單量, 停用狀態,

庫存管制, abc分類, 生產部門, 採購緊急度, 設變導入日, 生產批量

型別/長度對齊 CY vw_cuinve。

此外，既有 view JOIN 唯讀欄 品名、客戶簡稱、姓名（base table cuinve 沒有、原本誤放在 Model）

一併改為 Source 自帶私有欄位，使 Model 純對應 base table。

刪除

Twork_ord_vw_cuinveModel 移除 品名、客戶簡稱、姓名 三個非 base-table 欄（改由 Source 私有欄位承接）。

僅 Source 內部委派引用，無其他消費端，移除後 Common/Model/LogicBll/ViewModel 建置均通過。

Breaking Changes

無。Source 新欄為 view JOIN 唯讀欄，GetModelBase() 回傳的 Model 不含這些欄 →

存檔不會序列化上傳（本就不屬 base cuinve 實表），與 ADR 0050 union 取交集行為一致。

Migration Notes

本機 SQLite 由 EnsureCreated 依 Source 模型重建，新欄自動出現；既有本機庫缺欄走補欄安全網。

伺服器端 view/table 不變。

2026-06-28 — 集中自動化庫 darbnogiauto1 + 排程專屬派發器

> 詳見 ADR 0065。

摘要

把排程/自動化預存程序與其產出的資料表，從公司庫 darbnogicsa1 集中搬到新的

集中自動化庫 darbnogiauto1，並比照 AI 查詢派發器新增**排程專屬派發器

DARB_LOG_SYS_SKD_EXEC**（寫獨立稽核表 log_sys_skd、目標一律導向新庫）。

查詢自動化資料改走與既有 log 派發器相同的機制（新庫內也佈一份 DARB_GETDATA4）。

新增

• 資料庫 darbnogiauto1，內含：

- 自動化 proc：TWORK_SKD_GET_PENDING_NOTIFY、TWORK_SKD_GET_PENDING_AUTOEXEC、

TWORK_SKD_MAILQUEUE_DEQUEUE、TWORK_SKD_MAILQUEUE_UPDATE、TWORK_AUTO_SAFETYSTOCK

（讀公司資料以三段式 darbnogicsa1.dbo.*）。

- 自動化自有表：twork_skd_mailqueue、twork_auto_safetystockhistory。

- 通用查詢 proc DARB_GETDATA4（供結果檢視走同一派發器讀本庫表）。

• darbnogilog1：排程專屬派發器 DARB_LOG_SYS_SKD_EXEC + 稽核表 log_sys_skd。

• C#：Procedure.DARB_LOG_SYS_SKD_EXEC、IDatabaseConnection.Log_Sys_Skd_Exec、

AutoPilotTask.Log_Sys_Skd_Exec。

• 部署腳本 sql/deploy-darbnogiauto1.sql、sql/deploy-darbcyauto1.sql（冪等）。

• CY 公司庫排程 schema 修補 sql/fix-darbcycsa1-scheduler-schema.sql（補 eventitem 4 欄 + 重建 calendarevent view）。

proc 本體引用本地同名 view、view 抓對應 csa（跨庫集中在 view 層；公司庫缺的 vwseek_* 用 csa 基底表組、

_date 有則 view 抓 csa、無則自建日曆表）。

• 版控補回 3 支原本只存在 DB 的 proc DDL：SqlBI/TWORK_SKD_GETEVENT.sql、

SqlBI/TWORK_SKD_UPDATE_EVENT_STATUS.sql、SqlBI/TWORK_AUTO_SAFETYSTOCK.sql。

變更

• SchedulerJob：撈待通知/待自動執行、郵件佇列出列/狀態更新 4 處改走 Log_Sys_Skd_Exec（→新庫）。

• AutopilotMethod_LogSysExec：新增 Dispatcher 參數；設為 SKD 時該事件走排程專屬派發器

（→新庫），其餘維持主派發器（→csa）。安全庫存事件請設 Dispatcher=SKD + Procedure=TWORK_AUTO_SAFETYSTOCK。

• EventResultViewModel：依事件 參數 的 Dispatcher 決定讀結果走哪個派發器（SKD→新庫）。

刪除

• 無。darbnogicsa1 原 8 支 proc、原 twork_auto_safetystockhistory、proc_param、共用

DARB_LOG_SYS_EXEC/log_sys 一律保留（主派發器 fallback）。

Breaking Changes

• IDatabaseConnection 新增 Log_Sys_Skd_Exec：若有自訂實作（測試 fake/mock 以外），需補實作。

• 排程作業（TsERP.SchedulerWorker）升級後，需先部署 darbnogiauto1 與

DARB_LOG_SYS_SKD_EXEC，否則排程的撈件/寄信/安全庫存會找不到派發器或 proc。

Migration Notes

1. 於目標 SQL 執行個體跑 sql/deploy-darbnogiauto1.sql（sqlcmd -S <srv> -E -f 65001 -i ... 或 SSMS）。

2. 確認派發器 EXECUTE AS 身分（login foxcsa）在 darbnogiauto1 有 user（腳本建 foxautoexec）；

若實機 login 名不同，改腳本第 2 節的 FOR LOGIN。

3. 安全庫存的行事曆事件：參數 設 Dispatcher=SKD、Procedure=TWORK_AUTO_SAFETYSTOCK、結果表

填 twork_auto_safetystockhistory。

4. 多客戶：其他客戶用對應 sql/deploy-darb<客戶>auto1.sql（view 層改抓該客戶 csa）。

CY（朝陽）已完成：公司庫 schema 原本落後，已用 sql/fix-darbcycsa1-scheduler-schema.sql 補齊

（twork_skd_eventitem 補真正新欄 執行開始時間/執行guid；改基底欄名 通知→是否通知、停用→是否停用

對齊共用 TsERP Source，並連帶更新引用舊名的 CY 物件 twork_skd_vw_eventitem/_v/TWORK_WKFLOW_EVENTITEM/

TWORK_MOLD_CHECK/TWORK_SKD_NOTIFYEVENT；twork_vw_calendarevent 修 IsApproved→已審核、暴露排程欄），

重跑 deploy-darbcyauto1.sql 後 CY 端對端驗證通過（NOTIFY/AUTOEXEC/安全庫存全 OK、資料保留），與 NOGI 同等。

新客戶若 csa schema 落後，先跑對應 csa 修補（參考 CY 那支、注意各庫舊欄名差異與相依物件）再跑 deploy。

5. 未來把信寫進 mailqueue 的入列端 SP，目標表改 darbnogiauto1.dbo.twork_skd_mailqueue。

2026-06-28 庫存查詢：統計表顯示 + 表頭排序/篩選

摘要

修好 InventQuery（庫存查詢）遷到 TsBrowseRadGridView 後遺留的三個缺口，全在共用 browse 控件補回，

影響所有用該控件的瀏覽/查詢畫面。詳見 ADR 0066。

變更

最底下統計表恢復顯示資料

• 病根：5 月重構把主表改成自動產生欄位、卻漏改統計表，統計表仍掛 AutoGenerateColumns="False"

→ 欄位只剩沒綁定的表頭、又被 ClearColumn 清空 → 整表空白。

• 修法：移除統計表的 AutoGenerateColumns="False"，與主表一致即顯示資料。

• 順手把統計列高度由 0.3* 改 0.2*（統計表變矮、主結果區變高）。

表頭排序改伺服器端

• 之前點欄位表頭沒反應（資料虛擬化下內建前端排序只排已載入頁）。

• 改為：點表頭三段切換「遞增 → 遞減 → 取消」，由 provider 在 SQLite 端 ORDER BY 後重新分頁抓取，

整體資料重排；表頭排序箭頭正常顯示。

表頭篩選改伺服器端

• 之前欄位漏斗篩選無作用（Telerik 篩選僅支援 IQueryable 來源）。

• 改為：欄位漏斗的「包含/等於/大於/小於/區間…」等 field filter 會轉成 SQL，由 provider 在 SQLite 端

WHERE 後重抓；多欄條件以 AND 疊加；可與排序併用。

• 相異值（distinct）勾選清單在虛擬化下不支援，已隱藏，只保留欄位篩選。

已知限制

• 套用排序/篩選後會重建欄位，漏斗的「已篩選」標記不會留著（資料仍是正確篩過的）。

• 清除篩選：按「查詢」重跑（會一併清空排序與篩選），或重開漏斗設新條件。

Breaking Changes

無。

Migration Notes

• 無需資料或設定調整，重建後生效。

2026-06-27 — Velopack 每客戶獨立發版通道

摘要

更新機制改為支援 Velopack channel：每家客戶可跟自己的通道，發版時指定通道 → 只更新該客戶、不影響其他家。

維持一份程式碼、一個發布包、一個 blob 容器。詳見 ADR 0063。

新增

• appsettings.local.json 新增 Update 區段（每客戶部署時設定，不進 repo）：

- Update:Channel — 該客戶的 Velopack 更新通道（建議用客戶代號）。

- Update:FeedUrl — 覆寫更新 feed 網址（預設 darb-vpk，保留供日後內網鏡像）。

```json

{ "DatabaseListSourcePath": "...", "Update": { "Channel": "cust-b" } }

```

• release-velopack.ps1 新增 -Channel 參數（預設 dev）：

- .\release-velopack.ps1 -Channel cust-b → 只發布到 cust-b 通道，只跟該通道的客戶會更新。

- 不帶參數 → 發到 dev（沒有客戶跟，平常開發用）。

• deploy/deploy-customer.ps1 新增 -Channel 參數：部署客戶時一併把 Update:Channel 寫進其

appsettings.local.json（設一次即可）。

• 新增 deploy/install-customer.ps1 — 大量機器（如單一客戶 500 台）一鍵初次佈署：

- -Stage Config：寫 %ProgramData%\TsERP 設定（需系管/SYSTEM），適合 GPO 電腦啟動指令碼。

- -Stage Install：per-user 靜默安裝對應通道的 Velopack Setup，已安裝自動跳過，適合 GPO 使用者登入指令碼。

- 預設 -Stage Both：手動單機一次跑完。Velopack 靜默安裝用官方 --silent 旗標（docs.velopack.io 查證）。

- 可選 -InstallOdbc [-OdbcBitness x64|x86|both]：一併靜默安裝隨程式打包的 SQLite ODBC 驅動

（NSIS /S），供 Excel 樞紐分析表透過 ODBC 讀 SQLite 資料用。TsERP 本身不需要 ODBC

（內建 System.Data.SQLite.Core 引擎已打包）。已裝會依 HKLM 註冊偵測自動跳過。

⚠ 位元數要對應 Excel 而非 OS（32 位 Office 用 x86）。

- 可選 -RegisterActiveSetup [-ActiveSetupVersion N]：在 HKLM 註冊 Active Setup，讓**每個使用者

首次登入時自動安裝**（含日後新建帳號），不必逐人手動裝。StubPath 指向 -Source 上的本腳本

-Stage Install，故 -Source 須為 UNC 分享；須以 64 位 PowerShell 執行；bump 版本號可強制全體重觸發。

（Velopack 為 per-user 安裝，沒有 MSI 式「一份全機共用」；Active Setup 是讓每使用者各自自動裝的標準作法。）

變更

• App.xaml.cs 的 CheckForUpdatesAsync 不再寫死 feed 網址，改從 appsettings.local.json 讀

Update:Channel / Update:FeedUrl，組 UpdateManager 的 ExplicitChannel。讀取失敗回退預設。

刪除

無。

Breaking Changes

無。沒設 Update:Channel 的既有安裝走 Velopack 預設通道 = 現行行為，不會壞。

Migration Notes

• 既有客戶：不需動作即維持現行更新行為。要納入「逐家發版」，重跑

deploy-customer.ps1 -Channel <客戶碼> -Force，或手動在其 appsettings.local.json 補

"Update": { "Channel": "<客戶碼>" }。

• 過渡期：尚未設通道的舊機若仍需更新，繼續以預設通道發布一份（vpk pack 不帶 channel 的舊行為）；

全數客戶設上通道後即可只發名通道。

• 發版者注意：-Channel 預設 dev 以防手滑直推客戶；正式更新某家務必明確帶 -Channel <該家>。

發版結尾會印出 Channel： 供核對。

• 某通道首次發布：該通道 blob 尚無 RELEASES，需加 -SkipDownload（與既有首次發布規則一致）。

2026-06-27 修正巢狀分頁主檔的「客戶代號/廠商代號」永遠跳「資料重複」

摘要

修正 cudata（客戶資料）、spdata（廠商資料）、invent（料件）等「主鍵欄位放在巢狀分頁裡」的主檔，按下新增後輸入主鍵一律被判定「資料重複」、重新輸入也不會消失、導致無法存檔新增的問題。

根因

主鍵驗證 PrimaryKeyValidateViewModel.CheckPrimaryKey 需要取得程式 VM（ERPProgramViewModel）才能查重，否則直接回傳「重複」。

它透過控件的 ViewHelper.RootViewModel（Inherits 附加屬性）取 VM。但 TsView.DataContextChanged 會把每個 TsView 的 RootViewModel 覆寫成「該 TsView 自己的 DataContext」。當主鍵欄位 TsPrimaryKeyTextBox 被放進巢狀分頁 TsView（如 CudataTab1，DataContext 是 CudataTab1ViewModel）時，控件取到的是分頁 VM——它不是 ERPProgramViewModel，於是 CheckPrimaryKey 走進 is not ERPProgramViewModel → return true（=重複） 的分支，無論輸入什麼值都恆判重複。

因為驗證恆失敗、主鍵欄位永遠帶錯誤，連帶無法通過存檔前的錯誤檢查，新增的客戶/廠商存不進去。

變更

• 新增介面 ViewModel.IErpProgramOwner { ERPProgramViewModel ErpProgramViewModel { get; } }。

• ERPProgramViewModel 實作之，回傳自己。

• 三個巢狀分頁基底 VM 實作之，回傳宿主程式 VM：

- CudataTabBaseViewModel → CudataViewModel

- SpdataTabBaseViewModel → SpdataViewModel

- InventTabBaseViewModel → InventBsViewModel

• PrimaryKeyValidateViewModel.CheckPrimaryKey：取不到 ERPProgramViewModel 時，改用 IErpProgramOwner 取回真正的程式 VM 再查重。

行為影響

• cudata / spdata / invent 新增主檔時，主鍵查重恢復正常：輸入既有代號才報「資料重複」，輸入新代號即通過、可存檔。

• 一般（非巢狀分頁）主檔的主鍵驗證行為不變。

附帶修正：新增後游標未自動跳到主鍵欄

同源問題。FocusExtension.IsFocused 綁 DataContext.IsFocused（分頁 VM），而分頁 VM 的 IsFocused 只是轉發程式 VM 的同名屬性。程式端 ERPProgramViewModel.SetFocus() 切的是程式 VM 的 IsFocused（false→true），不會觸發分頁 VM 的 PropertyChanged，於是 FocusExtension 收不到 false→true 邊緣、不聚焦——新增後游標不會自動落在客戶代號/廠商代號/料件代號欄。

修法：三個分頁 Tab1 VM（CudataTab1ViewModel/SpdataTab1ViewModel/InventTab1ViewModel）在建構式訂閱程式 VM 的 PropertyChanged，把 IsFocused 變更轉發成自身的 PropertyChanged。

Breaking Changes

無。

Migration Notes

無；純程式端修正，不需更動資料庫或本機 db。

2026-06-27 navigate 寫入本機 SQLite 容忍跨庫缺欄

摘要

修正切換到結構落後的資料庫（例如 darbcy）時，按上/下一筆載入會崩潰的問題：

ExecuteAsync異常: constraint failed


NOT NULL constraint failed: Cudata.扣庫存

根因：navigate 把 server SP/view 的結果寫進本機 SQLite 時，INSERT 欄位清單只照 SP/view 實際回來的欄組。當某個庫的 view 結構落後、少回了某欄（如 darbcy 的 vw_cudata 沒回 扣庫存），而本機 SQLite 對應欄是 NOT NULL 且沒有 DB 預設值，部分欄位 INSERT 就會把缺的欄塞成 NULL → 撞 NOT NULL 限制 → 開窗即崩。

此修正讓寫入路徑自動補上缺欄的型別預設值，不再崩潰；且不需要更動任何 server 資料表，也不需要重建本機 db 檔。

同時也修正「可空欄因 view 漏回而變 NULL」的問題：darbcy 的 cudata 沒有 已審核 欄（可空字串）→ navigate 後該欄為 NULL；幣別 等欄在 扣庫存 NOT NULL 崩潰回滾整筆 navigate 時也一起變空。改為連可空欄一併補預設值後，navigate 寫入本機的資料完全不含 NULL。

變更

• LogicBll/LocalDbService.cs

- 新增 GetRequiredColumnDefaults(tableName)（靜態快取）：從 EF model 取出每張本機表「非主鍵、未設 DB 預設值」的 mapped 欄位（含可空欄），連同各欄的 CLR 型別預設值（decimal→0 / 整數→0 / string→"" / bool→false / DateTime→1900-01-01 / Guid→空 / enum→0）。已排除 IsNew/IsDirty/StagingScope（這三欄已在 LocalDbContext.OnModelCreating 設過 DB 預設）。

- InsertResultSet：插入前比對 reader 實際回傳欄位，凡本機表有、但這次 SP/view 沒回的欄，改以 CLR 型別預設值補進 INSERT。非空值欄藉此避免 NOT NULL constraint failed；可空欄藉此避免變成 NULL（與「回傳值為 NULL 一律 coalesce 成型別預設」的既有行為一致）。

行為影響

• 跨庫載入時，server 端少回的欄（不論可空與否）會被靜默補成型別預設值（如 扣庫存 顯示 0、已審核/文字欄顯示空字串），而非讓使用者開窗崩潰或得到 NULL。

• navigate 寫進本機 SQLite 的 mapped 欄位不再有 NULL（缺欄補預設、回傳 NULL 也 coalesce）。

• 結構齊全的庫（如 darbnogi）行為不變——欄位有回就走原路徑。

• 預設值依 CLR 型別決定（非 SQLite 欄型別），故 EF 以 TEXT 儲存的 decimal 欄補 0 後回讀不會 parse 失敗。

注意事項

• 這是「不崩」的安全網，不是資料修正：被補預設值代表該庫 view/實表結構落後、缺真值。

• 哨兵：CheckSqlField 的檢查報告（C:\temps\debuglog\checksqlfield\<ProgramClass>.txt）的「本地ViewModel有、SQL Table沒有」段，會列出仍缺欄的表，供後續決定是否對齊 server view/實表以取得真值。

• 若需要該欄帶真值而非預設值，仍須在對應庫重建 view（明確欄位型 view，如 vw_cudata 走 sql/cudata_add_account_fields_CY.sql Section 2）或對齊實表結構。

Breaking Changes

無。

Migration Notes

無需 migration；修正在程式端生效，毋須更動 server 資料表或刪除/重建本機 localDbService.db。

2026-06-27 訂單管理（E.Order）模組英文殘留中文化（批次）

摘要

延續 CUINVE/CUQT/CUPDMA，將 訂單管理（E.Order / 銷售訂單）整個模組 的 Source/XAML 英文殘留

系統性中文化。流程：先以多代理 inventory workflow 逐表單盤點＋對 VFP 驗證每個英文 token 的分類，

再以對抗式驗證代理覆核高風險的「mapped DB 欄」判定，最後分兩波套用、逐波建置＋提交。

涵蓋 40 支候選表單：24 支實作（DO）、16 支略過（SKIP）。

分類原則（每個英文 token）

類別	動作	判準

mapped DB 欄	保留英文	Model-backed + [TsColumnName]，且 VFP *_v.<col> 確認 DB 欄即英文（如 leadtime/email/website/cino/blno/reqno）。只翻欄位標題顯示文字

SP/查詢 DTO 欄	保留英文	由 server SP 結果以屬性名對應（如 Cudatalimit 信用額度 grid、Ci_m1/OrderApprove/Odtosl 轉單 grid）；改名會靜默清空 grid

Excel 依名對應欄	保留英文	PreordPivotInput 的 CustomerCode/UnitPrice 由 Forecast.xlsx 表頭依屬性名匯入

介面成員	保留（已是中文）	ISKU/IUnitPrice/ICustomerSKU/IPageHeaderNotes/ISelfDefined 等

NotMapped/TsSkip helper	改中文	UI plumbing；與既有 mapped 同名時加 Display/Binding 後綴避免衝突

失效英文 helper	砍除	全 repo grep 確認零 consumer

顯示文字	翻中文	XAML Header/Content/DisplayMeta/按鈕字

實作清單（24 支）

• wave1（commit c73c6207）：Cudata・CudataTab1・CudataTab2・Cudatalimit・Sample・Ormast・Salema・Odtosl・Orssma・Ci・Ci_m1

• wave2（commit 1cd031de）：Pk・Preord・PreordPivotInput・Pi・Fillrate・Visit_q・Cmplain・Estsal・Cungma・Odtosladdi・WarrantyCard・OrderDuplicate・OrderApprove

• 先前（commit f7d4b18b）：Cuinve・Cuqt・Cupdma（含 CupdmaSpecialQuery 轉 RadGridView）

略過清單（16 支）與原因

• 已是中文（無殘留）：CudataAr・CudataStatistics・CudataTab3・Rtaxma・Invent1・Claim・Visit・Pdtsal・Culbl・Alledi

• 英文版本（刻意保留英文 UI）：Ormast_s・Ormast_US・Cudata_US・Rma・Shiptoaddress・OrderApprove_Credit・Darbedittool

- 註：這些英文版/工具表單與主表單共用 Source，故主表單 helper 改名時其綁定路徑亦同步更新（顯示文字維持英文）

• 壞掉的空殼：Sample1（ProgramClass 佔位、VM 未實例化、開窗 NRE）

對抗式驗證攔截到的真實風險（已修正）

1. Ormast：原判 5 組 helper（SalesRepName1-3/TaxDescription1-3/Shipping*/Transaction*/ShippingAgentName）為死碼欲砍 → 實際被 Ormast_US/Darbedittool 綁定且 OrmastSave 有引用 → 保留（砍會編譯失敗＋斷綁定）

2. Ormast 套用後建置攔截：helper CustomerName/GroupCompanyName 改名撞到既有 mapped 客戶簡稱/集團簡稱 → 改為 客戶簡稱Display/集團簡稱Display，同步修 Ormast/Ormast_US/Darbedittool 綁定與 C# caller

3. Cudatalimit：3 個信用額度欄為 SP 結果依名對應 → 保留英文綁定（只翻標題）

4. PreordPivotInput：CustomerCode/UnitPrice 為 Excel 依名匯入 → 保留

Breaking Changes

• 各表單的英文 NotMapped/TsSkip helper 屬性已改中文名；少數失效 helper 已刪除。外部若以字串/反射引用舊英文名需同步改。

• 保留英文的 mapped DB 欄 / SP-DTO / Excel 欄綁定路徑不變。

Migration / 驗收

• 不需 DB migration（DB 本即中文 schema，本批為 code 端追平）。

• Runtime 未驗：24 支表單建議人工開窗驗收欄位顯示與存取；特別是 Preord 的 停用說明（VFP REPLACE 註解中，view 是否供值待確認）、各轉單/查價 grid 的 SP 欄位填值。

• 建置：Common/Model/LogicBll/ViewModel 全 exit 0、TsERP markup exit 0；per-form 掃描確認各表單自身改名識別字在自身 XAML 0 殘留。

2026-06-27 主管儀表板「匯出簡報」改版（董事會財報風 + 修溢出）

摘要

把主管儀表板（EISDASH）的「匯出簡報」HTML deck 重新設計成專業、給老闆看的董事會財報風，並修正清單筆數多時內容被裁切、超出頁面的問題。功能、操作、輸出路徑與資料來源皆不變。

變更

• LogicBll/M.EIS/主管儀表板/儀表板簡報Generator.cs 全面改版（公開 API 儀表板簡報資料 / 產生HTML 不變，呼叫端 EisdashViewModel.匯出簡報 無須修改）：

- 視覺（乾淨清爽風）：冷調淨白底（#F4F8FA）+ 白卡片 + 墨色字（#17212E）+ 清新藍綠主色 teal（#0E9488，用於眉標細線、KPI 頂條、排名數字、頁碼）；封面為淺色薄荷漸層 + 墨字 + teal 邊角，輕盈通透。數字一律以襯線字型（Georgia）tabular 對齊排版，像印製的損益表。警示色用乾淨珊瑚紅（#E0524F）。趨勢圖：受訂深板岩藍、出貨 teal。

- 只用系統字型（Georgia / Microsoft JhengHei / Segoe UI），維持離線即開、零外部相依。

- 封面眉標移除「TSERP」前綴（改為「主管儀表板 EISDASH」）。

- 各頁左右邊距加寬至 150px、KPI 頁字級與間距微調，避免 4 卡列右側貼邊。

修正

• 清單溢出：原本呆料 Top、逾期客戶以單欄表格塞進固定 1080px 版面，筆數多時（最多 12 筆）會超出頁面被 overflow:hidden 裁掉。改為兩欄 ledger 版式（直排序、依筆數自動算每欄列數），12 筆只佔 6 列，並收緊上方標題/摘要的垂直間距，確保整頁含頁尾都容得下、不裁切。

• 筆數透明化：清單標頭顯示「共 N 筆 · 顯示前 M 筆」，超過 12 筆時明確標示僅顯示前段，不再靜默截斷。

行為

• 仍是當下顯示快照；← → 翻頁、F 全螢幕、視窗等比縮放（1920×1080 舞台）皆維持。

Breaking Changes

無。樣板與樣式更動，無 API / 資料 / 設定變動。

Migration Notes

無需 migration。

相關

• ADR 0048 — 匯出簡報採自包含 HTML deck（架構決策不變）

• 2026-06-21 主管儀表板新增「匯出簡報」

2026-06-27 客戶單品報價單（CUQT）英文殘留中文化

摘要

延續客戶產品表（CUINVE）的清理，將客戶單品報價單（CUQT）的 Source/XAML 英文殘留中文化。

三張 Source（cuqtm 主檔 / cuqtd 材料明細 / cuqtd1 加工明細）的欄位屬性早已中文化，本次處理剩下的

英文 NotMapped/Binding helper、一個失效的英文 mapped 屬性，以及 Cuqt.xaml 仍是英文的 Label 與欄位標題。

變更

Twork_ord_vw_cuqtm（主檔）

英文（舊）	處置

GroupDescription（[TsColumnName(nameof(GroupDescription))] + 私有 backing）	砍除 — DB view 無此欄、永遠空白；群組說明的真實欄是既有 mapped 的 說明，XAML 改綁 說明

QuotationStaffName（NotMapped，報價人員姓名顯示）	改名 報價人員姓名

Twork_ord_vw_cuqtd（材料明細）

英文（舊）	中文（新）

GroupDescription（NotMapped）	群組說明

SKUBinding（NotMapped，品號 seek）	品號Binding

QuotationDateBinding（TsSkip，幣別查匯率用日期）	報價日期Binding

UnitPriceBinding（TsBinding 單價）	單價Binding

QuantityBinding（TsBinding 數量）	數量Binding

Twork_ord_vw_cuqtd1（加工明細）

• Source 早已全中文，僅 XAML 兩個欄位標題中文化（見下）。

Cuqt.xaml

• 主檔 Label 中文化：Quotation No:→報價單號：、Quotation Staff:→報價人員：、Quotation Date:→報價日期：、

Customer Code:→客戶代號：、Customer SKU:→客戶品號：、Minimum Order Quantity:→最低訂單量：、

Vendor Code:→廠商代號：、Group Code:→群組代號：、Material Fee:→材料費：、Processing Fee:→加工費：。

• 按鈕文字 Unit Price Adjust→單價調整。

• 群組說明輸入框由 {Binding GroupDescription} 改綁 {Binding 說明}（顯示真實 DB 欄）。

• 材料明細格標題/綁定中文化：SKU→品號（綁 品號Binding）、SKUDescription→品名、Group Description→群組說明、

Vendor Code→廠商代號、Vendor Name→廠商簡稱、Currency→幣別、Foreign Exchange Rate→匯率、UOM→單位、

Quantity→數量（綁 數量Binding）、Unit Price(本幣)→單價(本幣)（綁 單價Binding）、幣別欄日期改綁 報價日期Binding。

• 加工明細格標題：Processing Code→工程代號、Processing Name→工程簡稱。

Caller 連動修正

• CuqtBll.AddDetail：SKUBinding/QuantityBinding/GroupDescription/UnitPriceBinding → 品號Binding/數量Binding/群組說明/單價Binding。

• CuqtViewModel：UnitPriceBinding→單價Binding、QuotationStaffName→報價人員姓名（2 處）、QuotationDateBinding→報價日期Binding。

Breaking Changes

• CUQT 三張 Source 的英文 helper 屬性已改中文名；主檔 GroupDescription 已刪除（改用既有 說明）。

外部若以字串/反射引用舊英文名需同步改。

Migration Notes

• 不需 DB migration（DB 本來就是中文 schema，本次為 code 端追平）。

• Runtime 未驗：CUQT 開窗、新增、取得資料（匯入 BOM）、單價調整、儲存需人工驗收。

2026-06-27 客戶產品報價（CUPDMA）英文殘留中文化

摘要

延續 CUINVE / CUQT 的清理，將客戶產品報價單（CUPDMA）的 Source/XAML 英文殘留中文化。

主檔（cupdma）與明細（cupdt）的欄位屬性早已中文化，本次處理剩下的英文 NotMapped/TsSkip helper，

並把 Cupdma.xaml 仍是英文的 Label 與欄位標題全面中文化。

變更

Twork_ord_vw_cupdma（主檔）helper 中文化

英文（舊）	中文（新）

CurrencyPlaces（NotMapped，幣別小數位）	幣別小數位

ProjectName（NotMapped，專案名稱顯示）	專案名稱

CustomerCodeBinding（NotMapped，客戶代號 seek + 帶客戶資料）	客戶代號Binding

Twork_ord_vw_cupdt（明細）helper 中文化

英文（舊）	中文（新）

Amount（NotMapped，金額）	金額

QuantityBinding（TsSkip）	數量Binding

ForeignExchangeRate（TsSkip，取主檔匯率）	匯率Binding

CurrencyPlace（TsSkip，取主檔幣別小數位）	幣別小數位Binding

• SetPrice() 內部運算式同步改中文屬性。

• Cupdma（指向主檔 Source 的型別參考）保留 — 它是實體參考、非資料欄位/非綁定路徑，命名沿用程式名。

保留的英文 mapped 欄位（DB 欄本身即英文，動了會破壞對應）

• Twork_ord_vw_cupdmaSource.ProjectCode（Model-backed mapped 欄）。

• Twork_ord_vw_cupdtSource.leadtime（VFP 確認 DB view 欄即 客報價明細_v.leadtime）。

- XAML 該欄標題仍中文化為「前置天數」（顯示文字），綁定維持 {Binding leadtime}。

Cupdma.xaml

• 主檔 23 個 Label 全面中文化（報價單號／報價別／報價日期／生效日期／客戶代號／客戶名稱／業務員編號／

聯絡人／電話／傳真／幣別／匯率／製表人員／活動起始日／活動截止日／預計結案日／實際結案日／最低毛利率／

有效天數／收付條件／專案代號／頁首備註／報價備註）。

• 主檔綁定：CustomerCodeBinding→客戶代號Binding、ProjectName→專案名稱（2 處）。

• 明細格 27 個欄位標題中文化；綁定 QuantityBinding→數量Binding、Amount→金額。

Caller 連動修正

• CupdmaViewModel.AfterMoverRecord：ProjectName→專案名稱（SetCurrencyPlaces() 方法名保留，內部改設 幣別小數位）。

• 明細 SetPrice() 由 e.Item.Cupdma（VM）／幣別匯率 weak event 觸發，運算改中文屬性。

CupdmaSpecialQuery.xaml（查價子面板）

CUPDMA 操作面板的查價子面板，本批一併處理：

• TsDataGrid → TsRadGridView（dg-to-radgrid skill）：外層容器、DataGrid.Columns、各欄類型轉換，

Binding→DataMemberBinding，v2:TsDateColumnV2→TsGridViewDataDateColumn（MaskInfo→ForceReadOnly），

取價按鈕欄改 TsButtonInCell＋ButtonCell CellStyle、Command 改 RelativeSource AncestorType=TsRadGridView。

ItemsSource="{Binding ItemsSource}" 為一般集合（非 DataManager pattern），故不加 DataManager；保留外層 ProgramClass。

• 18 欄表頭全面中文化（取價／報價日期／報價別／客戶代號／客戶名稱／專案代號／專案名稱／地點／單價／品號／

數量／單位／數量2／單位2／備註／幣別／匯率／客戶品號）。

• 綁定維持原查價結果 POCO 的英文屬性（查詢 DTO，不在本次改名範疇）。

Breaking Changes

• CUPDMA 主檔/明細的英文 helper 屬性已改中文名。外部若以字串/反射引用舊英文名需同步改。

Migration Notes

• 不需 DB migration（DB 本來就是中文 schema，本次為 code 端追平）。

• Runtime 未驗：CUPDMA 開窗、新增、查價（FindPrice）、金額試算、儲存需人工驗收。

2026-06-27 客戶產品表（CUINVE）英文殘留中文化

摘要

客戶產品表（CUINVE，E-040）的 DB view（vw_cuinve / vw_cuinvema）欄位早已中文化，但

Source/Model 仍殘留少數英文屬性，且 Cuinve.xaml 的欄位標題與 Label 仍是英文。本次以 VFP cuinve

原始欄名（包裝量 / 包裝量_箱 / 備註）為準，將殘留英文屬性改名為中文、砍掉重複的死屬性，並把

XAML 標題與 Label 全面中文化。

變更

Twork_ord_vw_cuinvema（主檔）

英文（舊）	中文（新）

Notes	備註

• Model、Source 同步改名；[TsColumnName(nameof(Notes))] → [TsColumnName(nameof(備註))]（DB 欄本為 備註，原英文 mapping 載入永遠空白）。

• 保留 NotMapped helper CustomerName（UI 查詢用，非 DB 欄）。

Twork_ord_vw_cuinve（明細）

英文（舊）	中文（新）

MinimumPackageQuantity	包裝量

• Model 屬性 MinimumPackageQuantity 改名 包裝量；Source 包裝量 wrapper 改讀新名（[TsColumnName] 本就是 包裝量，DB 欄不變）。

• 砍除 Model 死屬性 QuantityPerCarton（與既有中文欄 包裝量_箱 重複、無任何 caller）。

NotMapped UI helper 中文化

英文（舊）	處置

SKUBinding（明細，品號 seek 欄）	改名 品號Binding

CustomerName（主檔，客戶簡稱查詢顯示）	改名 客戶簡稱Display（避開既有 mapped 客戶簡稱）

SKUDescription（明細）	砍除（無任何 caller、未綁定、未賦值的死碼）

CustomerName（明細）	砍除（死碼）

SalesRepName（明細）	砍除（死碼）

• 連動修正：Cuinve.xaml（客戶 seek Description + 唯讀簡稱框 + 明細品號欄 binding）、CuinveViewModel.GetPrintViewModel（2 處讀取）、Twork_ord_vw_cuinvemaSource.RefreshDescription。

Cuinve.xaml

• 主檔 Label：Customer Code: → 客戶代號：、Notes: → 備註：；{Binding Notes} → {Binding 備註}。

• 明細格 26 個欄位標題全面中文化（LineNo_→序號、SKU→品號、SKU Description→品名、

Customer SKU→客戶品號、Minimum Package Quantity→包裝量、Quantity Per Carton→包裝量(箱)、

Notes→備註 等），沿用本檔既有 CY 欄位的字面中文 Header 寫法。

Breaking Changes

• Twork_ord_vw_cuinvemaSource.Notes、Twork_ord_vw_cuinveModel.MinimumPackageQuantity 屬性已改中文名；

Twork_ord_vw_cuinveModel.QuantityPerCarton 已刪除。外部若以字串/反射引用舊英文名需同步改。

• NotMapped helper 改名/刪除：SKUBinding→品號Binding、主檔 CustomerName→客戶簡稱Display；

明細 SKUDescription/CustomerName/SalesRepName 已刪除（皆為死碼）。

Migration Notes

• 不需 DB migration（DB 本來就是中文 schema，本次為 code 端追平）。

• Runtime 未驗：CUINVE 開窗、新增、儲存需人工驗收欄位顯示與存取正常。

2026-06-27 — cudata 補 CY 會計欄位、聯絡傳真重排

摘要

客戶資料 cudata（CY 版）補回 VFP scx_ord_cy page2 的三個會計欄位，並整理

第二分頁「詳細聯絡資訊」的電話／傳真排列。

新增

• 第二分頁「銀行帳戶與會計科目」群組（原「銀行帳戶」）加入：

- 帳戶代號 — 公司收款帳戶搜尋框，顯示帳戶簡稱。

- 應收科目 — 會計科目搜尋框，顯示科目名稱。

- 銷貨科目 — 會計科目搜尋框，顯示科目名稱。

• 公司傳真 補進第二分頁「詳細聯絡資訊」（原本只有 Tab1 有）。

變更

• 第二分頁「詳細聯絡資訊」電話／傳真改成並排兩列：

- 公司電話 ｜ 公司傳真

- 工廠電話 ｜ 工廠傳真

Migration Notes

這三個欄位是 CY 客戶（darbcycsa 家族）專屬。共用程式會 SELECT 這三欄，因此

每個 cudata 庫都要先於 SSMS 跑 sql/cudata_add_account_fields_CY.sql：

• CY 庫：取消腳本 Section 1 註解後執行（建立實體欄位），再執行 Section 2（重建 vw_cudata）。

• 非 CY 庫：只執行 Section 2（vw_cudata 會以空字串常數投影這三欄）。

未跑前該庫開啟客戶資料會載入失敗。腳本可重複執行。詳見 ADR 0062。

2026-06-27 最低階用料查詢還原「含無製程」選項

摘要

還原 VFP scx_eng_cy 中 bom_botm(最低階用料 / BOM 底層展開查詢)的「含無製程」勾選框。此選項在 CY 版 DARB_QRY_BOM_BOTM 預存程序對應第 4 參數 @查詢方式,新版 C# 先前固定不帶該參數,導致 CY 永遠走「無製程不展」分支,VFP 時代的展開模式無法觸發。

新增

• 「最低階用料」查詢條件頁新增 「含無製程」勾選框(預設不勾)。

- 勾選 → 預存程序走 DARB_BIZ_BOMBOTTOM加含無製程,將無製程組件一併往下展開。

- 不勾 → 維持原行為 DARB_BIZ_BOMBOTTOM無製程不展。

變更

• Bom_botmParameters 新增 含無製程(bool,預設 false)。

• Bom_botmConditionViewModel 新增 含無製程 屬性。

• GetSqlData.GetTWORK_QRY_BOM_BOTM 新增選用參數 queryMode(預設 "0"),映射到 dispatcher 的 LP_P4(@查詢方式)。

Breaking Changes

無。queryMode 為帶預設值的選用參數,既有呼叫端不受影響。

Migration Notes

• 不需資料庫變更。CY 庫 DARB_QRY_BOM_BOTM 本就有 @查詢方式 參數(proc_param.param_qty=4)。

• 多客戶相容:NOGI 等 param_qty=3 的庫,dispatcher 不會轉發第 4 參數,故新增的 queryMode 會被安靜忽略——對非 CY 客戶該勾選框無作用但不報錯,毋需 per-customer 分支。詳見開發者記憶 darb-qry-bom-botm-cy-nogi-divergence。

2026-06-26 — 全域 seek 欄位（TsSearchTextBoxV2 / TsSearchRule）存在性驗證修復

摘要

修復共用搜尋輸入控件 TsSearchTextBoxV2 與其驗證規則 TsSearchRule 的一連串問題：存在性驗證從未真正掛載、誤判正確資料為「資料不存在」、錯誤時不跳訊息、跳訊息後焦點被搶回造成洗版、以及清空儲存格後要點兩次按鈕。屬平台層共用控件，影響全 app 使用 TsSearchTextBoxV2 的 seek 欄位。

變更

• 補上漏掉的 SetBinding（TsSearchTextBoxV2.OnApplyTemplate）：

- 原本把 TsSearchRule／PrimaryKeyRule 加到「深拷貝後的 binding」卻沒套回 TextProperty，導致存在性驗證自始未生效。現於加完規則後 BindingOperations.SetBinding 套回（無規則時不重綁）。

• 訊息框改由規則在「發現錯誤的當下」跳出（TsSearchRule.Validate）：

- 查無此代號時，由規則自身即時 TsMsgBox.ShowMessage(資料不存在)，不再等失焦後事後檢查 Validation.GetHasError（後者因 binding 來源更新晚於 class handler 而讀到舊狀態，永遠不跳）。

- SeekCondition 未設定的設定錯誤亦即時跳窗。

• 同一個錯誤值只跳一次窗（TsSearchRule 新增 lastWarnedValue 守門）：

- 防止 Telerik 控件一次失焦驗證多次、或焦點抖動造成的訊息洗版；改成有效值或清空後重置守門，輸入新的錯誤值才會再提示。

• 移除錯誤時的焦點搶回（TsSearchTextBoxV2.OnLostFocus）：

- 先前用 Keyboard.Focus(this) 把焦點釘回欄位，會與失焦驗證形成死迴圈（點按鈕→失焦→跳窗→焦點被搶回→再點→再跳…按鈕按不到）。改為僅保留紅框（ValidationResult）視覺提示，存檔時仍會被擋。

• 清空儲存格即時清除殘留錯誤（TsSearchTextBoxV2 新增 OnTextChanged）：

- 規則只在失焦時重驗，把錯誤值刪成空白後仍掛著上一個值的錯誤狀態，使儲存格第一次點按鈕被吃掉（要點兩下）。改為文字清空時立即 Validation.ClearInvalid，空白是合法狀態，下次點按鈕一次生效；失焦時規則仍會重新驗證。

• 移除驗證結果快取（TsSearchRule）：

- 移除 previousValue／previousResult 快取。原快取會把載入當下暫時性的 false（Context／暫存表尚未就緒）寫死，導致之後正確資料也一直回「資料不存在」。改為每次重新判斷。

背景

• 2026-06-25 SLIYBROWD 的 changelog 已點出 OnApplyTemplate 漏 SetBinding 的問題，但當時刻意只在該支以 grid CellValidating 就地補、未動全域控件。本次改為直接修平台層 TsSearchTextBoxV2，全 app 的 seek 欄位一併受惠。

Breaking Changes

• seek 欄位的存在性驗證現在會真正生效（先前形同關閉）：輸入主檔不存在的代號會跳「資料不存在」並標紅框。若有畫面原本「靠驗證沒生效」而能存入不存在代號，現在會被擋。

Migration Notes

• 無資料庫異動。存在性查詢沿用既有 TWORK_EXIST（DataValidate 平台），不需新登錄。

• 行為層面：在一般表單欄位，錯誤時不再強制把焦點留在欄位（改靠紅框 + 存檔擋）。

• RadGridView 儲存格情境：「打錯就擋住、強迫修正」是 grid 原生行為（ActionOnLostFocus 預設 CommitEdit + editor ValidationRule 失敗 → grid 將焦點退回該格），Tab 切格與點 grid 外按鈕都會被擋。經裁定維持此現狀，刻意不在 editor 加 PreviewLostKeyboardFocus 去區分「Tab 到輸入欄 vs 點動作按鈕」——那會與 grid 自身的焦點管理衝突。若日後想讓「點 grid 外按鈕（取消/關閉）可放行」，正確做法是把該 grid 的 ActionOnLostFocus 設為 None，而非改 editor。

2026-06-26 統計定義中文化（特殊查詢統計面板）

摘要

客戶 / 廠商 / 品號「特殊查詢」統計面板的項目名稱與描述由英文改為繁體中文；

對應的值計算預存程序內的分支字面值同步改為中文（分支鍵維持用 StatisticsName），

並修復廠商採購額三項的計算。

變更

• twork_sys_statistics_definition 表 27 筆的 StatisticsName、Description_

由英文覆寫為繁體中文（例：Latest Quotation→最新報價單、

MTD Sales (Order)→本月銷售額(訂單)、YTD Purchasing→本年採購額）。

• 子程序 TWORK_STATISTIC_CUSTOMER / TWORK_STATISTIC_VENDOR /

TWORK_STATISTIC_INVENT 的分支判斷字面值由英文改為對應中文（分支鍵仍為 StatisticsName）。

• 移除 @language 參數：父程序與三支子程序簽章去掉 @language；日期顯示固定 yyyy/mm/dd；

QueryCondition 中文化 REPLACE 改無條件套用。C# 端 GetSqlDataWrapper.GetStatistic_definition、

CudataBll.GetStatisticDataNew 及三支 SpecialQuery ViewModel 一併移除語言引數

（位置式參數改為 UserID/Classification/PartnerCode）。SQL 與 C# 須一起部署。

修復

• 廠商「本月/本年/去年採購額」（S003/S004/S005）原本因 vwbd_purch 欄名不符而留空：

改用該 view 的 本幣未稅 金額欄、並把日期條件對應到實體欄 採購日期t，計算恢復正常

（驗證：本年採購額 328800、去年採購額 995920）。

• 金額一律改用 本幣未稅：三支子程序所有 SUM() 金額欄由 原幣未稅 改為 本幣未稅

（vwbd_trsama 出貨、vwbd_ormast 受訂、vwbd_trrama 進貨、vwbd_purch 採購）。

Dispatcher 登錄（darbnogilog1）

• DARB_LOG_SYS_EXEC 依 proc_param.param_qty 決定轉發參數個數。TWORK_STATISTIC_DEFINITION

移除 @language 後參數由 4 → 3，故 darbnogilog1 的 proc_param.param_qty 由 4 改 3。

• 部署腳本：sql/twork_statistic_definition_procparam_darbnogilog1.sql。

Migration Notes

• 部署腳本：sql/twork_statistics_definition_chinese_darbnogicsa1.sql

（以 Unicode 執行，例如 SSMS 或 SqlClient；勿用預設 codepage 的 sqlcmd，中文會漏寫）。

• 已部署於 darbnogicsa1。其他公司資料庫（darbcycsa1 / darbzdcsa1 等）若也使用此面板，

需另行套用同一腳本（並確認該庫 vwbd_purch 欄名）。

• 三者須一起部署：darbnogicsa1 程序、darbnogilog1 的 proc_param、C# 端

（移除 @language 後參數位置改變；任一未更新都會參數錯位/過多）。

• dispatcher DARB_LOG_SYS_EXEC 與 proc_param 在 log 庫 darbnogilog1，跨庫 EXEC 到 darbnogicsa1。

已走完端到端驗證（dispatcher → 跨庫 → 子程序）result=OK 並回傳中文統計列；C# 編譯通過。

注意

• 子程序分支鍵 = 顯示名稱（StatisticsName）。日後再調整顯示文字時，務必同步更新三支子程序內

的字面值，否則對應項目的值會靜默變空白。

2026-06-26 客戶產品表（CUINVE）刪除防呆還原

摘要

對比 VFP scx_ord_cy cuinve.deleteclick 後，補回「本程式不能執行刪除之功能」的整支刪除阻擋。

新版原本無 CuinveEdit/CuinveDelete，刪除走 base DeleteBll 無條件允許，使用者可刪掉某客戶的整張客戶產品表（含所有產品列），與舊系統刻意禁刪的行為不符。

變更

• 新增 LogicBll/Ade/E.Order/CuinveDelete.cs：覆寫 BeforeDelete 直接回 false 並帶出

「本程式不能執行刪除之功能」訊息（工廠以 <Pascal>Delete 反射自動接上）。

• 僅擋刪除：修改維持 base EditBll 允許（VFP 無 allowedit 擋修改）。明細列仍可在編輯時以

增刪修=D 標記移除，不受影響——本防呆擋的是主檔（整筆客戶產品表）刪除按鈕。

• 新增訊息鍵 MessageEnum.ThisProgramCannotDelete（Common/Language/MessageService.cs）

與 TsERP/Lang/Message.json 對應條目（繁中「本程式不能執行刪除之功能」/ 英文）。

修復（順帶）

• CUINVE / CUPDMA 畫面無法顯示：App.xaml 缺這兩支 ViewModel → View 的 DataTemplate

（E.Order CY 路線檔案已建但 runtime 未驗的系統性遺漏）。已補上 CuinveViewModel→Cuinve、

CupdmaViewModel→Cupdma 兩個 DataTemplate（含新增 xmlns:cupdma 命名空間），程式才能正常導覽載入。

2026-06-28 追補：不支援刪除的提醒提前

原本「本程式不能執行刪除之功能」走 CuinveDelete.BeforeDelete，而 BeforeDelete 在

DeleteBll.Delete() 內才執行——使用者得先按刪除、跳「確定刪除？」確認、按下「是」之後才被告知不支援。

• 新增 DeleteBll.IsDeleteNotSupported(out msg) 虛擬方法（預設回 false＝支援刪除）。

• CuinveDelete 改覆寫 IsDeleteNotSupported 回 true（取代原 BeforeDelete 覆寫）。

• DeleteService.Delete() 在最前面、跳確認對話框之前就先呼叫 IsDeleteNotSupported，

整支禁刪的程式按下刪除鈕立即提示，不再先問「確定刪除？」。

• DeleteBll.BeforeDelete 仍呼叫 IsDeleteNotSupported 作為後端防線。

Breaking Changes / Migration Notes

無資料庫變動。Message.json 需隨版散佈；MessageEnum 與 BLL 一起編譯部署即可。

2026-06-26 客戶資料（CUDATA）Tab1/Tab2 欄位實際補回（修正 2026-06-25 文件脫節）

摘要

2026-06-25 的 changelog（2026-06-25-cudata-vfp-field-restore.md）記載 CudataTab1 與

CudataTab2 已補回多個 VFP scx_ord_cy 對比缺漏的欄位，但實際 XAML 從未寫入——

當時只加了 Twork_ord_vw_cudataModel 的屬性，畫面綁定遺漏（git 亦無對應 commit）。

本次將該批欄位實際補進 XAML 並建置通過（VS MSBuild TsERP.csproj EXIT=0）。

新增（Tab1 基本資料）

• 直接出貨、附成績單、轉廠（Y/N 旗標，YesNoComboBox，置於基本資料群組 Row 2 第 4–9 欄）

新增（Tab2 財務）

• 新群組「詳細聯絡資訊」：負責人、身分證字號、負責人電話/分機、會計、聯絡人職稱、

會計電話/分機、聯絡人2、工廠傳真、聯絡2電話、聯絡2分機、聯絡1分機

• 新群組「公司概況與交易」：國家別、客戶區域、交易方式、成立時間、收款日、營業項目、

稅籍號碼、關係人（關係人為 YesNoComboBox，比照 SpdataTab1/廠商資料慣例）

• 新群組「徵信記錄」（多行 memo）

• 財務資訊群組新增：技術報酬金、佣金（TsNumericTextBox，兩位小數）

變更（版面）

• CudataTab2 主體 Grid 由單列改為兩列：原四個群組（銀行帳戶／財務資訊／帳款與物流設定／

詳細聯絡資訊）維持第 1 列，新增之公司概況與交易、徵信記錄置於第 2 列。

Breaking Changes / Migration Notes

• 技術報酬金 / 佣金為新 DB 欄位：cudata 表與 vw_cudata view 原本沒有。

部署前必須先於 SSMS 對每個目標庫（darbnogicsa1 / darbcycsa1 / production）執行

sql/cudata_add_commission_techfee_darbnogicsa1.sql（ALTER TABLE 加兩欄 + 重建 view）。

未執行前若儲存客戶資料會因欄位不存在而失敗。

• 其餘欄位皆為既有 DB 欄位，純補 UI，無需 migration。

備註

• 本條目為「文件與實作脫節」之修正紀錄；2026-06-25 changelog 描述之意圖至此才真正落地。

• 後續若再發生「changelog 已記但 XAML 未綁」情形，請以 build + 實查 binding 為準

（參照記憶 vfp-compare-cross-check-xaml-binding）。

2026-06-26 瀏覽／查詢 SQL Injection 防護

摘要

修補瀏覽／查詢條件產生器的 SQL Injection 風險：字串值跳脫、非 Int32 數值欄補驗證、Between 結束值也驗證，並把「自定義」查詢條件文字框改為唯讀，關閉使用者手打 raw WHERE 的入口。屬安全性修補，純 C# / XAML 變更，不動資料庫。

變更

• 字串值跳脫（ViewModel/Browse/BrowseConditionHelper.cs）：新增 Esc()（單引號 '→''），套用到所有把字串嵌進 N'...' 的分支：等於/不等於/大於小於（A~F String）、like（G/H/I/J）、In 清單（K/L String 逐項）、Between（Q 起始＋結束值）。

• 數值型驗證（ViewModel/Browse/BrowseConditionChecker.cs）：原本只驗 Int32/DateTime/Boolean，新增 Decimal/Double/Single/Int64/Int16/Byte/SByte，以逗號切分後逐 token decimal.TryParse（同時支援單值與 In 清單）；非純數字擋下並提示「請輸入數字」。

• Between 結束值驗證 + 無值運算子豁免（BrowseConditionHelper.GenerateCondition）：Between(Q) 的結束值一併驗證（原本只驗起始值）；IsNull/IsNotNull/IsEmpty/IsNotEmpty/不考慮/R 等不吃輸入值的運算子豁免值驗證。

• 自定義條件輸入框唯讀（TsControl/Themes/TsStyles.xaml，inv:InventQuery ControlTemplate）：綁 SelfDefinedCondition 的 TsTextBox 加 IsReadOnly="True"，覆蓋共用此控件的 Cudata／Invent／Spdata／Ginvent。

行為變更（使用者可見）

• 數值欄輸入非數字（含 Between 結束值）會被即時擋下並提示，而非送出後由 SQL 報錯。

• 查詢條件區的「自定義」文字框不再可手動輸入；點選預先定義的特殊查詢仍正常產生條件並查詢。

• 修正一個既有副作用：對數值欄做「IS NULL／IS NOT NULL／IS EMPTY」等不需輸入值的查詢，現在不再被誤要求「請輸入數字」。

Breaking Changes

• 無 API／資料庫破壞性變更。唯一行為差異是「自定義」文字框改唯讀，若有流程依賴使用者在該框手打 SQL 條件，將無法再使用（此即本次刻意關閉的注入入口）。

Migration Notes

• 純前端變更，無部署腳本、無 DB／範本檔需求；不影響呼叫 QueryAndStatistics 的各表單契約。

• 已用 VS 2022 MSBuild 建置 ViewModel、TsControl 通過（exit 0）。

注意（後續待辦，非本次範圍）

• DB 層二階注入未處理：TWORK_STATISTIC_CUSTOMER 等子程序把客戶代號裸拼進 QueryCondition（CudataSpecialQuery 來源）、GetSqlData.cs 的 GetCustomerSKU/GetARAllowan 同類；以及 SP TWORK_BD_VIEWLIST 的 QUOTENAME／連線帳號降權。詳見 ADR 0061。

2026-06-26 補回 App.xaml 缺漏的程式 DataTemplate（H.Inventory + P.Invoice 批次）

摘要

延續 E.Order 批次，補上 H.Inventory 與 P.Invoice 缺漏的 VM→View DataTemplate（缺了會導覽不出畫面）。

變更

TsERP/App.xaml：

• 新增 xmlns:inventory（ViewModel.H.Inventory）、xmlns:inventory1（TsERP.H.Inventory）命名空間

（此模組原本完全沒有任何 prefix——invent: 是 D.Bom.Invent，不是它）。

• P.Invoice 10 支（invoice:/invoice1:）：Tick3、Ticka、Ticka_disc、Ticka_rej、

Ticka_voidrp、Tickmin、Tickr、Ticks、Ticksr、Tother。

• H.Inventory 9 支（inventory:/inventory1:）：Bol、Invrec、Jobcode、Splace、

Trinout、Trlima、Trlost、Trrama、Trsama。

排除（誤報修正）

• MasterFile（PRIMEEDI810）不補：MasterFileViewModel 雖 override ProgramClass 且繼承

ERPProgramViewModel，但實為 Edi_ExportViewModel 的內嵌子 VM（Edi_ExportViewModel 內 new 並以

property 持有，畫面由 Edi_Export.xaml 內聯 DataTemplate 宿主），且無獨立 View → 非可導覽程式，

不需 App.xaml DataTemplate。屬靜態啟發式的預期誤報。

驗證

MSBuild TsERP.csproj /t:MarkupCompilePass1 exit 0（19 個 DataType 與 View 型別全解析）。

待辦

原 62 支缺漏：已補 E.Order 10 + H.Inventory 9 + P.Invoice 10 = 29，MasterFile 誤報排除 1，剩 32 支

（C.GeneralAffair 8、I.ARAP 5、J.QC 5、F.Production 4、G.Purchasing 4、A.SystemData 2、L.Communication 2、

D.Bom 1、K.Cost 1）分模組逐批補。建議 runtime 逐支導覽確認。

2026-06-26 補回 App.xaml 缺漏的程式 DataTemplate（E.Order 批次）

摘要

延續 Cuinve/Cupdma 的修復，系統性盤點 App.xaml：找出所有 override ProgramClass 且繼承導覽型

base（ERPProgramViewModel / ErpProgramWithDetailViewModel）卻沒有 VM→View DataTemplate 的程式

（任何 ResourceDictionary 都查不到 → 導覽時畫面無法顯示）。全專案共 62 支，本批先補 E.Order 10 支。

變更

TsERP/App.xaml 新增 10 個 DataTemplate（VM 在 ViewModel.E.Order=order:，View 在 TsERP.E.Order=order1:）：

• Ci、Cuqt、Preord、Salema、Rma、Sample、Visit、Shiptoaddress、Fillrate、WarrantyCard

（其中 Ci/Cuqt/Preord/Salema 即 scx_ord_cy 移植、先前標「檔案已建但 runtime 未驗」的那批。）

驗證

MSBuild TsERP.csproj /t:MarkupCompilePass1 exit 0（10 個 DataType 與 View 型別全解析；避開執行中 MCP server 鎖 DLL 的 copy 步驟）。

待辦

其餘 52 支（C.GeneralAffair 8、H.Inventory 10、P.Invoice 10、I.ARAP 5、J.QC 5、F.Production 4、G.Purchasing 4、A.SystemData 2、L.Communication 2、D.Bom 1、K.Cost 1）分模組逐批補。

建議 runtime 逐支實際導覽確認能顯示。

2026-06-26 alledi 新YAMAHA parser 重寫（對齊 VFP Page19 / YDS.TXT）

摘要

alledi「新YAMAHA」分頁的解析器原本整支寫成 Page1 舊 YAMAHA 的格式（SDF 固定欄寬、讀 YAMAHA.TXT、單軌 ORMAST），與本頁（VFP Page19 / EDI-P19-YAMAHA）完全不符。本次依 VFP p19yamaha查詢鈕.Click（8089-8353）整支重寫。

變更

• 來源檔改為 C:\轉EDI資料\YDS.TXT（逗號分隔 CSV，VFP APPEND ... DELIMITED），不再是 SDF 固定欄寬的 YAMAHA.TXT。VM 預設檔名同步更新。

• 欄位對映改為 YDS.TXT 的逗號欄序（順序/訂單輸入日/追加刪除/客戶品號/交貨地點/客戶訂單號/預訂交期/數量/單位/包裝量…），只取 追加刪除='A' 列；略過檔頭列。

• 客戶品號格式重整 xxx-xxxxx-xx-xx-xx（VFP 8192），再以 cuinve 依「該列預訂交期 + 交貨地點」反查品號。

新增

• 5 期工作日攤分演算法（VFP 8264-8333）：依 6 個日期輸入（下二~下六起始日 + 下六截止日）切 5 段，落在各段的數量累加進 N2T~N6T 桶（鍵：客戶品號+品號+交貨地點+單位），再以「基數 100 × 工作天數」倍數攤分、逐工作日攤平成多列。

• 日期分配表（VFP 8117-8156）：每段把交期每隔 5 個工作天分配一筆、超出再補洞，決定每筆攤分列的交期。

• 特例：品號含 *P（P 件不拆單）或 預訂交期早於下二起始日 → 直接成一列、不攤分。

• 雙軌目標單據（VFP 轉單鈕 8361-8623）：列的 客戶訂單號 非空 → ORMAST（轉至訂單）；空 → PREORD（轉至預示）。攤分（預示）列一律 PREORD。

• 6 個日期輸入框的值由 VM 帶入 BLL；必填 + 嚴格遞增驗證（VFP 8101-8108）。

工作日曆（已接真正的 LCL工作日曆）

• UPDT_WKDAYS / UPDT_BACKWKDAY_LCL 已接真正的工作日曆（含假日）：BLL 預設用 Util_Pdt（從本機 SQLite 暫存表 LCL工作日曆 載入，沿用既有 Updt_WkDays / Updt_BackWKDay_Lcl，與 VFP 同義）。

• WorkDaysBetween / BackWorkDay 仍可覆寫（單元測試用）；當工作日曆載不到（如未登入 / 測試環境）時自動退「日曆日」保底。

已知限制（後續階段）

• 需以真實 YDS.TXT 樣本檔 + DB（cuinve 反查 + LCL工作日曆 已載入）runtime 驗收欄位座標與攤分交期。

Breaking Changes

無（行為從「錯誤格式」修正為正確格式）。

Migration Notes

無需 migration。

2026-06-25 — 會計日記帳（SLIYBROWD）修改鈕守門 + seek 欄位存在性驗證

摘要

修正會計日記帳查詢頁（SLIYBROWD）修改模式的兩個問題：修改鈕可被任意切換、以及可輸入的代號欄位（項目編號等）不檢查是否存在。對齊 VFP scx_acc 原行為。

變更

• 修改鈕守門（SliybrowdViewModel.Edit()）：

- 已在修改模式時再按「修改」不再重新進入 —— 避免重置每列 IsChanged/增刪修 把使用者已做的變更追蹤洗掉（按修改→改幾格→又按修改 會靜默清空、儲存等於沒存）。

- 需具該程式「可否修改」權限才允許切入修改模式；無權限時跳訊息並維持唯讀。

- 對應 VFP ledit.Click 守門條件「LSAVE.ENABLED=.F. AND IS_可修改」。

• seek 欄位存在性驗證（Sliybrowd.xaml.cs 新增 CellValidating）：

- 修改模式下，項目編號／部門代號／客廠代號／員工編號／專案代號等 seek 欄位提交前會檢查代號是否存在於主檔，查無此代號就擋下提交、焦點留在格內、跳「資料不存在」。

- 空值與 MISC（雜項）不檢查，比照既有 TsSearchRule 行為。

背景

• 既有平台 TsSearchTextBoxV2.OnApplyTemplate 把 TsSearchRule（存在性檢查）加到「深拷貝後的 binding」卻漏了 SetBinding 把它套回控件，導致 seek 控件的存在性驗證從未生效（此修正先在 SLIYBROWD 這支以 grid CellValidating 就地補上，未動全域 TsSearchTextBoxV2，避免影響全 app 其他 seek 欄）。

• VFP 原版實際只開放編輯 摘要／部門代號／專案代號／分類索引1／分類索引2 五欄；新版 grid 另外放開了 項目代號／客廠代號／員工／分類索引3、4。本次先補驗證，是否要把這幾欄改唯讀以完全對齊 VFP 待裁定。

Breaking Changes

• 無「可否修改」權限的使用者，原本能切入修改模式，現在不行（屬權限修正）。

Migration Notes

• 無資料庫異動。存在性查詢走既有 TWORK_EXIST（DataValidate 平台），不需新登錄。

scx_ord_cy（CY 朝陽/鈞寶 訂單模組）功能補完

日期：2026-06-25

摘要

依 VFP scx_ord_cy 全模組對比 + 逐欄位（每個 TextBox/Column）稽核結果，補回新版 TsERP 缺漏的

欄位驗證/連動/機制。多客戶分歧依 ADR0050 以 Context.Env.CompanyShortName == "朝陽" || "鈞寶"

護欄包覆，不污染非 CY（US/NOGIHISA）行為。本批為 ultracode 多代理人協作（對比→稽核→驗證設計→套用）。

新增（universal，全客戶受惠）

• cupdma：選品號帶 leadtime/最低包裝數/最低訂單量/規格/中文描述；master 補綁 最低毛利率/有效天數；最低毛利率≤0 擋存。

• salema：明細品號查無/停用 存檔驗證。

• preord：控制面板補「調整數量」（交期區間×比率）、「交期變更」（工作日曆回推、*P 用 P件天數）。

新增（cy-specific，朝陽/鈞寶 護欄）

• preord：朝陽+客戶 AZY/AZZ 跳過客戶品號反查。

• cuqt：CY 模具/治具各自獨立分母分攤（非 CY 維持新價台數）。

• pk：A07 客戶箱號前置文字='CY'。

• salema：'單價'$IS_備註 權限隱藏 單價/金額 欄。

• estsal：明細帶 SK_INVENT 停用/停用說明/停用日期 唯讀欄；交期排序鈕（品號+預訂交期重編序號）。

• ormast：預訂交期→依客戶 leadtime 工作日曆回推 回覆日期 + 出貨日90日提示；客戶訂單號帶下空白明細。

• pdtsal：grid 客戶簡稱 顯示欄（IsCyCompany 才顯示）。

• ormast（needs-service/reuse）：客戶品號→反查 cuinve 帶 品號/包裝量/單價（reuse GetCustomerSKU，無新 SP）。

• 基建：EnvShortcut.CompanyShortName（供全模組公司分流）。

跳過（使用者裁定）

• 金額幣別小數位（salema GetAmount 維持 round-2，不動金額計算）。

• 所有「列變色 / 動態底色 / 前景色」（cuinve/pdtsal/estsal DynamicBackColor、cuinve 品號變紅）。

• 快速審核（QuickApproval）。

⏳ 待辦（外部相依，本環境無法完成驗證）

1. needs-service（reuse-existing，已設計、同 ormast 客戶品號反查 pattern，待套用）：

- estsal 客廠品號↔品號 雙向反查（reuse SetSKUByCustomerSKU/SetCustomerSKUBySKU）＋計算單價鈕（DARB_BIZ_CUST_UNITPRICE）

- cupdma 客戶品號→反查品號（reuse GetCustomerSKU）

- preord 客戶品號反查補 預訂交期+交貨地點 第 4 參數 + 查無客戶品號存檔擋

- cuinve 明細唯讀顯示欄（庫存管制/管制說明/停用/群組/設變，reuse Darb_GetData4 'invent'）

2. pdtsal「計算資料」鈕（CY 核心，~420 行）：跨 preord/ormast/pdtinf/cost/交易單/cupdt 彙總自動產生產銷計畫。

- ⚠️ 依賴 DB view vw_pdtsal交易單（新庫不存在），須先在 DB 建該 view（資料庫物件，非 SP）；之後寫 PdtsalCalculateBll + grid2 成本匯率輸入 + RelayCommand。無此 view 無法取上月庫存/生產實績/銷售實績。

3. alledi（CY 機車 OEM EDI 轉訂單，18 個在用分頁）：整支未移植。

- 在用分頁：鼎豪/SYM/SYM預示/慶俊訂單/慶俊預示/YMTT/YMTT預示/泛用取品號/年度銷售/SY_BOM/SY計劃/SYM-2W/新YAMAHA/新SUZUKI 等。

- ⚠️ 無法靜態完成：各廠 XLS/XLSX/CSV/PRN(SDF) 解析的欄位起訖/Cell 座標/表頭列數/編碼，須拿 C:\轉EDI資料\ 下真實樣本檔逐欄校對；cuinve 反查須朝陽/鈞寶實機 DB；上傳須跑 INPUT-BB dispatcher（PREORD/ESTSAL/BOM 上傳路徑各須實測）；Telerik SpreadProcessing 解析 API 下筆前須查 telerik-dpl-assistant。建議參考既有 LogicBll/E.Order/Darbedittool/（Amazon/EBay/Walmart）架構，逐廠單頁 runtime 驗收。

如何檢查

• 建置：VS MSBuild TsERP\TsERP.csproj（已全程 exit 0）。

• 業務驗收（須在朝陽/鈞寶庫，CompanyShortName=朝陽/鈞寶）：

- cupdma：選品號→單位/leadtime/包裝/訂單量自動帶；最低毛利率輸入 0 存檔應擋。

- preord：填交期區間+比率按「調整數量」；按「交期變更」交期回推。

- ormast：輸客戶品號→自動帶品號/單價；改預訂交期→回覆日期回推 + 超90日提示；改主檔客戶訂單號→空白明細帶入。

- salema：權限備註含「單價」者，單價/金額欄應隱藏；明細輸停用品號存檔應擋。

- estsal：明細顯示停用欄；按交期排序序號重編。

- pk：A07 客戶存檔後明細前置文字=CY。

- 非 CY 庫（如禾久）以上 cy 行為應不觸發（護欄）。

2026-06-25 — 新增「營運預測模擬」、原「生產計劃查詢」回歸精簡

摘要

把生產計劃查詢（pd_qry7）拆成兩支：新增獨立的「營運預測模擬」做為前瞻分析/模擬的第二版，

原「生產計劃查詢」回歸只保留 VFP 三頁 + 金流預測。詳見 ADR 0056。

新增

• 營運預測模擬（OperationForecast） 全新程式，為 pd_qry7 的完整 fork（自有 Model/Source/SP/BLL/VM/XAML）。

分頁與目前生產計劃查詢相同：訂單預示預估、生產計畫、使用量、原物料用量(庫存缺口)、金流預測、模擬插單、產能負荷(需求)、樞紐分析。

• 7 支專屬 SP：TWORK_QRY_OPERATIONFORECAST、TWORK_QRY_OPFCST_{GETORDER,PRODORDER,OTHERDATA,SUPPLY,CASHBASE,WKLOAD}。

• SQL 部署腳本：sql/TWORK_QRY_OPERATIONFORECAST_darbnogicsa1.sql、sql/TWORK_QRY_OPFCST_EXT_darbnogicsa1.sql、

sql/TWORK_QRY_OPFCST_WKLOAD_darbnogicsa1.sql（+ _darbcycsa1.sql）、登錄腳本 sql/營運預測模擬_register_program_darbnogicsa1.sql。

變更

• 生產計劃查詢 移除四個分頁：原物料用量、模擬插單、產能負荷(需求)、樞紐分析；

保留：訂單、預示及預估／生產計畫／使用量(機種別)／金流預測。

刪除

• 原「生產計劃查詢」清除被移除分頁的 dead code：

- VM 的 模擬/產能/缺口彙總·明細/樞紐 成員、code-behind 樞紐 handler。

- BLL 的 RunSimulation/BuildWorkCenterLoad/WorkCenterLoads 與只給模擬用的快取。

- 檔案 WorkCenterLoadPoco.cs、SimulationOrderPoco.cs、ProductionplanDrillDownViewModel.cs、生產計劃查詢明細.xaml(.cs)；類別 ShortageSummaryPoco。

- XAML 的 OrderPivotProvider、ShortageRowBackgroundConverter、模擬累計折線與圖例。

- 保留：BuildShortage/ShortageCalculator/ShortageRows 與 Supply/CashBase SP — 金流預測的計劃預測層仍需缺口計算。

Breaking Changes

• 無（原程式碼識別、ProgramClass、SP 名皆未改；只是分頁變少 + 多一支新程式）。

Migration Notes

• 「營運預測模擬」要能從選單開啟，需在每個目標資料庫部署上述 4 支 SQL（SP+proc_param）並執行登錄腳本。

sqlcmd 跑含中文 UTF-8 無 BOM 腳本要加 -f 65001；朝陽 darbcylog1 的 proc_param.pkid 是 IDENTITY，WKLOAD 用 _darbcycsa1.sql 版。

• 原生產計劃查詢無需任何 DB 變更。

2026-06-25 — 本地化採「中文當鍵」（additive）

摘要

多語言查表改用中文當鍵：JSON 新增中文鍵別名（保留英文鍵），讓佔 85% 的中文鍵 XAML 綁定能直查到譯文、切換非中文語言正確翻譯。詳見 ADR 0055。

新增

• Common/Lang/Xaml/*.json：94 檔新增共 2060 個中文鍵別名（指向同一譯文物件）。

變更

• 還原 Checkpay pilot：Checkpay.xaml 由 PascalCase 鍵改回中文鍵（中文鍵現可直查命中）。

• JsonLocalizationStore：移除先前的反查 fallback（中文鍵直查即命中，反查冗餘）。

Breaking Changes

無（英文鍵 JSON 條目保留，77 個英文鍵 XAML 檔零回歸）。

Migration Notes

• runtime 需 Rebuild TsERP 套用 JSON 變更。

• ⚠️ 類別產生器（repo 外）仍輸出 PascalCase 鍵，下次重跑 JSON 會覆寫中文別名（待後續同步生成器）。

• 25 筆撞名（同 class 兩屬性共用同一中文）只保留一個中文別名，待人工檢視。

2026-06-25 — 新增「金流預測」(flowcast)

摘要

新增獨立的金流預測程式，用票據／帳款／訂單採購單 三來源推未來現金（月堆疊柱＋累計淨額線）。詳見 ADR 0057。

新增

• 金流預測（flowcast） 程式（ProgramClass FLOWCAST，M.EIS）：

- 一支 SP TWORK_QRY_FLOWCAST 回 4 RS（票據／帳款／訂單未交／採購未交）。

- FlowcastComposer（純函數）合成統一現金事件＋月彙總/堆疊；到期日接 PayTermDate。

- UI：來源勾選（票據/帳款/訂單/採購）＋月堆疊柱（收上付下）＋累計淨額線＋資金警戒線＋點柱過濾明細。

• 檔：Model/SQLProcedure/Twork_Qry_Flowcast/*、LogicBll/M.EIS/Flowcast/*、ViewModel/M.EIS/Flowcast{,Condition}ViewModel.cs、TsERP/M.EIS/金流預測{,Condition}.xaml。

• SQL：sql/TWORK_QRY_FLOWCAST_darbnogicsa1.sql、sql/flowcast_register_program_darbnogicsa1.sql。

口徑重點

• 票據：收 CA/CB/CF、付 CP/CQ（排除 CC/CD 融資）；現金日預兌日優先。

• 帳款：rp_m 未沖，方向用 rpdef.單據分類（AR+ 收／AP+ 付）；費用申請只算 9B＋83 的「6.直接沖帳」；排除預收/預付/暫付/待抵；立帳起日預設近一年。

• 訂單採購：未交＝數量−已交數量，非結案；金額本幣含稅按未交比例；現金日回覆日/預訂交期＋收付條件。

• 三來源靠票況／單據分類／已交數量分界，零重疊。

Breaking Changes

• 無（全新程式；既有 OperationForecast 的金流分頁不受影響）。

Migration Notes

• 每個資料庫部署 TWORK_QRY_FLOWCAST SP（含 proc_param）＋執行登錄 SQL 後，重啟即可從選單開「金流預測」。

• sqlcmd 跑含中文 UTF-8 腳本要 -f 65001（或轉 UTF-16）；其他庫 cy/zd/production 各自部署。

2026-06-25 開發用本機臨時參數檔（dev-prgpar.json）

摘要

延續 dev-programs.json（ADR 0054），新增參數版：開發中的新程式需要專屬參數時，可先把臨時參數寫進 repo 內 dev-prgpar.json，登入時合併進記憶體參數表，使 U_Prgpar(...) 不必先寫 DB _prgpar 即可讀到。僅開發機啟用，正式環境不受影響。

新增

• TsERP/dev-prgpar.json：本機臨時參數檔（放 repo、複製到輸出目錄）。欄位對齊 _prgpar（programClass/name/value/description/category/categoryDescription），預設 parameters: [] 附範例。

• Common/Environment/DevPrgparRegistry.cs：讀 JSON → 合併進 ParameterList 的載入器（同名鍵覆寫、新鍵新增）。

• EnvironmentSetting.DevParametersEnabled 靜態旗標；啟動時由 App.xaml.cs 從設定讀入。

• appsettings.example.json 新增 DevParameters:Enabled 說明。

變更

• UserBll.GetParameters()：建好 ParameterList 後，旗標開啟時合併 dev-prgpar.json 的臨時參數。

啟用方式

在 %ProgramData%\TsERP\appsettings.local.json 加：

{ "DevParameters": { "Enabled": true } }

於 dev-prgpar.json 的 parameters 陣列加參數並重新登入；程式內以 Context.User.U_Prgpar("名稱") 讀取。

Breaking Changes

無。Production 不設旗標 → 完全 no-op。

Migration Notes

• 範圍只覆蓋記憶體 U_Prgpar。Util2017.U_PrgparSql（每次查 DB）與「目前表單參數」編輯器（直接讀 _prgpar）不受影響。

• 同名鍵：臨時值覆寫已載入的 DB 值（開發時可暫時試不同值）。

• 還原到資料庫：依各筆 programClass 開該程式的「目前表單參數」編輯器照值重輸存檔即可（不自動產生 SQL）。

2026-06-25 客戶資料（CUDATA）補齊 VFP 缺漏欄位與驗證

摘要

以 VFP scx_ord_cy 的 cudata 逐欄交叉比對現行畫面，補回「資料層有、UI 沒綁」的欄位、新增兩個資料庫欄位，並補回一條輸入驗證。

新增（Tab1 基本資料）

• 直接出貨、附成績單、轉廠（Y/N 旗標，置於基本資料群組）

• 英文簡稱、英文名稱

• 工廠電話（聯絡資訊群組；Tab1 電話僅保留公司電話＋工廠電話）

• 發票地點、請款郵遞號（地址資訊群組）

新增（Tab2 財務）

• 新群組「詳細聯絡資訊」：負責人、負責人電話/分機、會計、會計電話/分機、聯絡人2、聯絡2電話、聯絡1/2分機、聯絡人職稱、身分證字號、工廠傳真

• 新群組「公司概況與交易」：國家別、客戶區域、交易方式、成立時間、收款日、營業項目、稅籍號碼、關係人

• 新群組「徵信記錄」（多行）

• 財務資訊群組新增：技術報酬金、佣金

變更（行為）

• 帳款起始日：輸入時驗證須為 1~31（對應 VFP 帳款起始日.Valid），於 CudataSave.AllowSave。

Breaking Changes / Migration Notes

• 技術報酬金 / 佣金為新欄位：cudata 表與 vw_cudata view 原本沒有。

部署前必須先於 SSMS 對每個目標庫執行 sql/cudata_add_commission_techfee_darbnogicsa1.sql

（ALTER TABLE 加兩欄 + 重建 view）。未執行前若儲存客戶資料會因欄位不存在而失敗。

• 其餘欄位皆為既有 DB 欄位，純補 UI，無需 migration。

未處理（依需求略過）

• 聯絡人明細 grid 的 skype / msn / facebook / 呼叫器 4 欄（D 類，刻意忽略）。

2026-06-25 alledi 各分頁顯示還原（對齊 VFP）

摘要

alledi（CY 機車 OEM EDI 轉訂單工具）原本 14 個分頁共用同一個簡化版面（固定 11 欄表格、版面全相同）。逐頁對照 VFP 後，把各頁顯示內容還原成與原版一致：各頁專屬表格欄位、客戶選擇器、日期/年月輸入框、小計、Excel/DBF/篩選/重新檢查等按鈕、正確的轉單鈕文字，並修正會讓分頁壞掉的預設檔名。架構改為 per-tab DataTemplate（每頁一個 VM 子類 + 一個對應 DataType 的 DataTemplate，見 ADR 0058）。 顯示與轉入已就緒、轉單上傳走既有 AllediUploadBll；各廠轉單深層規則（報價/單位反查、工作日攤分、版次、.XLS 舊檔、新YAMAHA 重寫）須真實樣本檔 + DB runtime 驗收，屬後續階段。

變更

• 預設檔名修正（原本錯誤，部分會導致分頁無法使用）：

- SYM：VMEP.XLS → 640C.TXT

- SYM預示：YAMAHA.PRN → 640C.TXT

- 慶俊訂單／慶俊預示：640C.TXT → A09.XLS

- 新SUZUKI：SUZUKI.TXT → SUZUKI_A.TXT（B/C 檔由同目錄推導；原檔名會直接 FileNotFound）

• 轉單鈕文字依各頁還原（原一律以「是否含預示」推導）：SY_BOM＝轉至BOM、SY計劃＝轉至預示、SYM-2W＝轉至年度預估、新YAMAHA／新SUZUKI＝轉至訂單及預示、泛用取品號＝產生EXCEL、年度銷售＝產生DBF，其餘維持轉至訂單／轉至預示。

• 表格欄位改為各頁專屬（對齊 VFP 各頁 cursor 欄位），不再固定 11 欄。

新增

• 各頁還原 VFP 專屬控件：

- 客戶代號選擇器（各頁預設 A01／A02／A04／A07／A09／A33）。

- 日期/年月輸入框：SYM（年度/月份）、SYM預示（下一/下二/下三起始日、下三截止日、年度/月份）、慶俊訂單（年度）、慶俊預示（起始日期/年度/月份）、SY計劃（起始日期/預示單號/轉單起始日）、SYM-2W（起始日期/取代預估單號/轉單起始日/轉單截止日）、新YAMAHA（下二~下六起始日、下六截止日）、年度銷售（年度）。

- 小計：YMTT訂單（數量小計/金額小計）、YMTT預示（原始數量小計/數量小計），轉入後即時重算。

- 額外按鈕：YMTT（Excel）、SY_BOM（EXCEL）、SY計劃/SYM-2W（篩選錯誤、Excel）、新YAMAHA（文字檔讀入、篩選錯誤）、SYM預示/慶俊預示（重新檢查）、年度銷售（篩選錯誤）。

- 篩選錯誤：已實作客端過濾（只顯示「錯誤」欄非空的列）。

• 解析器把原本塞進「備註」的資料改填獨立欄並顯示：鼎豪（客戶訂單號/三陽編號/訂單輸入日）、YMTT訂單（客戶訂單號/結關日期）、新SUZUKI（客戶訂單號/展開日期/類別）。

已知未完成（後續階段）

• 轉單/上傳（ORMAST/PREORD/ESTSAL/BOM 組單、報價反查單價、單位/包裝量帶值、版次遞增、原幣未稅）尚未實作；多數 BLL 目前只做 Parse。

• 預示頁工作日攤分（含第二/三表格明細）未做。

• Excel/DBF/重新檢查/文字檔讀入 按鈕目前點擊顯示「後續階段實作」訊息。

• .XLS（舊 BIFF）讀取：SY計劃/SYM-2W 真檔仍會解析失敗（reader 為 XlsxFormatProvider）。

• ~~新YAMAHA：parser 仍為舊 YAMAHA（Page1）格式~~ → 已於 2026-06-26 重寫，見 2026-06-26-alledi-newyamaha-parser-rewrite.md。

Breaking Changes

無（顯示層還原；資料表/上傳格式未變）。

Migration Notes

無需 migration。AllediImportRow 新增多個顯示欄位（聯集），皆為純 POCO 屬性。

2026-06-25 alledi（OEM EDI 轉單）移植完成 + scx_ord_cy 收尾

摘要

完成 VFP scx_ord_cy.prg（CY = 朝陽／鈞寶 客戶專屬版，18 class）對比的最後一塊缺口：

alledi（機車 OEM EDI 轉訂單工具）整支移植。同時收尾 scx_ord_cy 的

cy-specific 連動、needs-service（reuse 既有服務）與 pdtsal「計算資料」。

本檔承接 2026-06-25-scx-ord-cy-feature-completion.md，補記 alledi 與建置修正。

新增

• alledi 程式（OEM EDI 轉單） — LogicBll/E.Order/Alledi/、ViewModel/E.Order/Alledi/、TsERP/E.Order/Alledi.xaml

- 統一列模型 AllediImportRow（實作 ICustomerSKU）。

- 14 支在用廠別 parser（Alledi*ImportBll.cs）：鼎豪／SYM／SYM 預示／慶俊訂單／慶俊預示／

YMTT 訂單／YMTT 預示／泛用取品號／年度銷售／SY_BOM／SY 計劃／SYM-2W／新 YAMAHA(P19)／新 SUZUKI(P20)。

cell 座標、SDF 欄寬均抄自 VFP；客戶品號對照走 cuinve 反查。

- 共用讀檔工具 AllediExcel.cs（Telerik Document Processing，.xls+.xlsx 皆支援）。

- 上傳 AllediUploadBll：依「目標單據」自動分派至 ORMAST／PREORD／ESTSAL／BOM，

走 ItemsBindingManager（Register<Source>().DirectSaveToSqlite → SaveAll → UploadToSql → TruncateAll），

主從以 linkid = 主檔 pkid 串接。

- 程式外殼：ProgramClass.ALLEDI + AllediViewModel（14 分頁）+ AllediVendorTabViewModel

（選檔→轉入預覽→上傳）+ Alledi.xaml（RadTabControl + 預覽 RadGridView）+ App.xaml DataTemplate。

• dev-programs.json 加入 ALLEDI — 開發期免動 DB，於 appsettings.local.json 開

DevPrograms:Enabled 後重新登入，即於「E.營業收款」出現「OEM EDI 轉單」。

變更

• LogicBll/LogicBll.csproj — 新增 4 個 cross-platform Telerik DPL 套件

（Telerik.Documents.Spreadsheet + .FormatProviders.OpenXml + .FormatProviders.Xls），

供 LogicBll 解析 Excel 而不引入 WPF UI 依賴。

• Common/ProgramClass.cs — 新增 ALLEDI。

• TsERP/App.xaml — 新增 alledi namespace 與 AllediViewModel DataTemplate。

修正

• 登入崩潰 The given key 'ALLEDI' was not present in the dictionary — GetExtendFunction.SetDescription

（登入時跑）會逐筆走 PermissionTable 用 dic[類別名稱] 取各程式的「其他N說明」（擴充功能鈕標題），

字典 dic 只由 DB prgsct1 建。dev-programs.json 注入的程式（如 ALLEDI）不在 DB → dic["ALLEDI"]

丟 KeyNotFoundException 擋住整個登入。改為 TryGetValue 略過缺項（其他N說明留空）——

一併修好所有「純注入、未在 DB prgsct1 登錄」的開發程式。（EISDASH/PRODUCTIONPLAN 因已有 DB prgsct1 列才沒踩到。）

• AllediViewModel 點選後空白 — 原繼承 ERPProgramBaseViewModel（非導覽器認得的三種版面型之一，item 為 null

→ 不渲染）。改繼承 ERPProgramDefaultViewModel（同 Library/TodoList 自訂頁面型），由 ErpProgramDefaultLayout

承載 Content；無下方查詢面板故 BottomPanelContent 回 null。

• 建置「App 未包含 InitializeComponent」+ MSB3027/MSB3021 — 並非 App.xaml 錯誤，

而是執行中的 TsErp.Ai.Mcp.Server 鎖住輸出 DLL，導致 App.xaml markup 編譯未完成、

App.g.cs 未重新產生。停掉該程序後重建，TsERP exit 0、0 編譯錯、0 檔案鎖錯。

（已記入 [[build-toolchain-vs-msbuild]]：再遇到先關 TsErp.Ai.Mcp.Server 再 build。）

• Telerik DPL Excel API 對版（telerik-dpl-assistant）：改用 Import(stream)、

Cells[r,c].GetValue().Value.RawValue、Worksheet，移除不存在的

GetValueAsDouble/GetDefaultCellFormat/HasValue/CellValues。

• 平行代理產生的 parser bug：SyPlan 客户代號→客戶代號、YmttForecast 重寫補 helper、Sym 客戶代號預設。

跳過（使用者裁定）

• 快速審核、金額幣別小數位、所有列變色／底色／前景色，本次不做。

Migration Notes

• 無新 SP、無 DB schema 變更：pdtsal 計算資料、estsal 客廠品號雙向、ormast/cupdma/preord 客戶品號反查

全 reuse 既有 DescriptionHelper / Darb_GetData4。

• alledi 正式上線：開發期走 dev-programs.json；正式須 usp_新增程式 + _menum/_menud/prgsct1 登錄。

• 待 runtime 驗收：alledi 各廠 parser cell 座標需以 C:\轉EDI資料\ 真實樣本檔逐欄校對，

主檔表頭預設（受訂日期／序號前置碼／訂單別／幣別／匯率）需依各廠 VFP「轉至訂單」校正。

• cy-specific 連動以 Context.Env.CompanyShortName == "朝陽" || "鈞寶" 護欄，非 CY 客戶不受影響。

詳見 LogicBll/E.Order/Alledi/README.md 與記憶 [[scx-ord-cy-compare-complete]]。

2026-06-24 — scx_nogi 鈞寶專屬查詢（6 支）按 VFP 重寫移植

摘要

把 VFP scx_nogi.vcx（NOGIHISA／鈞寶客戶專屬查詢報表庫）6 支查詢整批按 VFP 行為移植到新版 TsERP，沿用既有 DARB SP，不新建 SP。三專案（LogicBll/ViewModel/TsERP）建置通過，runtime 待驗收。詳見 ADR 0051。

新增

• 訂單資料查詢（M-020，Qry_ord_nogi）：起訖訂單/客戶/品號/受訂日期/預訂交期/業務員 + 集團/倉儲/只含未出貨；結果 grid + 訂單/已出/未出三項統計。

• 出貨資料查詢（M-050，Qry_sal_nogi）：8 個彙總頁（出貨明細/產品/客戶/業務/類別/日期/單號/群組）；出貨退回(SB)金額取負；合計框。

• 毛利率分析（M-160，Qry_profit_nogi）：8 彙總頁；利潤=本幣未稅−成本、標準利潤對照（coststd）；標準單位成本差異%篩選。

• 其他交易單查詢（M-190，Qry_trli_nogi）：12 種倉儲交易單別（EI/EO/LO/LI/BI/BO/AA/SS/IT/NB/GU/IA，第12欄 UI 標 CI 但過濾碼為 IA）；LO/LI 自銷售單補抓；EO 交易備註串接。

• 耗料查詢（M-140，Qry_trwk_nogi）：起訖部門/品號/日期/單號 + 交易別/轉入倉儲；衍生欄（未交數量、金額、年月、使用單號依參數 3012）。

變更

• 進貨資料查詢（M-070，Qry_ra）修正既有 beta bug，對齊 VFP qry_ra_nogi：

- 結果欄位對映修復（原英文屬性無對映 → 整批空白）。

- 4 個單據別 checkbox（進貨RA/退出RB/總務進貨RC/總務退出RD）與付款別（已轉/未轉應付）實際接上查詢條件（原為空，勾選無效）。

- 新增「進貨費用」勾選 → 帶出進貨費用明細列。

刪除 / 不做

• 列印報表（.frx）、樞紐分析表、報表選擇排序鈕：一律不做，改用清單內建排序與匯出。

• 公司專屬除錯碼（特定 usercode 匯出 dbf）不移植。

後續調整（同日）

• 進貨資料查詢（Qry_ra）介面現代化：改為 TsView、查詢條件改成獨立面板、欄位標題與條件 label 全面中文化（對齊其他 5 支 nogi 查詢）。

• 耗料查詢（M-140）新增明細列雙擊 drill-down：雙擊一列依單號開頭開啟對應「加工單」或「損耗單」並定位（還原 VFP 雙擊跳轉）。

Breaking Changes

無。

Migration Notes

• 不需任何 DB migration：沿用現成 DARB_QRY_STD / DARB_GETDATA4，無新 SP、無 proc_param 變更。

• 選單路由：6 支 ProgramClass 命名一致（M-070 進貨已將 VM 改名 Qry_ra_nogiViewModel / ProgramClass QRY_RA_NOGI），選單碼對應 QRY_*_NOGI 即可路由。

• 待 runtime 驗收：開啟各查詢確認有資料、條件過濾正確、彙總金額正負號正確。

2026-06-24 多語言收斂單一服務 + 即時切換語言

摘要

多語言系統改走單一服務（方案 B 第一刀，見 ADR 0052）。切換語言即時生效、不再需要重新登入；

畫面文字、grid 表頭、選單會一起換成新語言。backend 仍是 JSON，之後可無痛換成資料庫。

新增

• Common/Lang/ILocalizationStore + JsonLocalizationStore：多語言字串的可抽換來源（之後換 DB 只動這層）。

• Common/Lang/ILocalizationService + LocalizationService：單一語言服務（目前語言、即時切換、查表）。

• Common/Lang/LocalizationLocator：給元件層取服務的橋接。

• TsControl/Localization/HeaderLocalization：TsDataGrid 與 TsRadGridView 共用的表頭翻譯。

• 單元測試 LogicBllTests/Lang/LocalizationServiceTests（8 項，全綠）。

變更

• 設定 → 切換語言：存檔後即時套用，提示改為一般「儲存成功」，不再顯示「請重新登入」。

• ERPSystemContainerView 功能列新增「語言」選單：直接選語言即時切換並持久化（下次登入沿用），

與設定頁共用同一條 ChangePasswordAndMyFavoriteBll.ChangeLanguage；切換時功能列文字本身也即時重翻

（MainWindowMenuViewModel.ChangeText 改讀單一服務目前語言 + 訂閱 LanguageChanged）。

• TsRadGridView 現在會翻譯欄位表頭（先前完全不翻，dg-to-radgrid 遷移後的迴歸已修）。

• 切換語言後，grid 表頭、選單列、各表單欄位標籤即時更新。

• grid 版型存檔改存「欄位穩定鍵」而非當下譯文 → 版型跨語言通用（英文存、中文開不再被蓋亂）。

缺口補完（同日追加）

• 訊息/對話框文字即時化：MessageService 與 ViewModel LanguageService 改讀單一服務的目前語言，

切語言後提示訊息、翻譯文字即時跟著變（不重登）。

• 查詢/報表語言對齊：IUser.Language 改為委派單一服務的 CurrentLanguage，約 30 個讀 User.Language

的呼叫點（查詢/報表撈語系資料）切換後自動使用新語言。

• 報表 locale 即時刷新：新增 FastReportLocalizationService 訂閱語言切換 → 重載對應 .frl

（繁中/簡中；英日越無檔則退回英文）。新開報表即套新語言。

• grid 右鍵選單翻譯（M2）：排序/群組/匯出/匯入/新增/刪除/勾選等 17 條選單字串改走單一服務翻譯，

查無則以現有繁中字面 fallback；選單每次開啟重建，切語言即生效。

• 列舉/下拉即時翻譯：CobPoco 實作 INotifyPropertyChanged + Retranslate，EnumManager 訂閱語言切換

反射重翻所有已建立的列舉集 → 列舉下拉顯示文字即時更新。

• 漏譯偵測（L6）：DEBUG 下非繁中查無翻譯會去重記到 C:\temps\debuglog\MissingTranslations.txt。

• 壞檔防護（L2）：LanguageMerger.MergeAll per-file try/catch，單一壞 JSON 不再毀整表/擋啟動。

• CJK 標題修正（N2）：AddBlankBeforeCapital 含 CJK 直接原樣返回，不再誤刪中日文間空白。

刪除

• 無（LanguageConverter/TitleConverter 兩個空轉換器標 [Obsolete]，實體刪除留待後續刀次）。

Breaking Changes

• 無對使用者操作的破壞性變更。

Migration Notes

• 既有 grid 版型自動相容：舊版型存的是譯文 header，第一次開啟時當「鍵」查；中文版型會正確翻譯，

非中文/特殊舊版型則原樣顯示，下次存檔自動轉成穩定鍵（自癒），無需手動處理。

• 已知限制：報表（FastReport）文字與系統訊息對話框維持登入當下語言，切換語言後需重新登入才更新；

欄位/表頭/選單則即時生效。

2026-06-24 — 本地化 JSON 收斂單一樹

摘要

多語言翻譯字典從「分檔樹 + 發行專屬合併樹」兩棵收斂成單一來源樹，並修復約 69 個翻譯分檔未進發行版的漏譯 bug。詳見 ADR 0053。

變更

• Common.csproj：Lang\Xaml\*.json、Lang\Model\*.json 改用萬用字元一次納入部署（取代 160 筆逐檔登記）。新增 section JSON 免再手動登記。

• JsonLocalizationStore.Reload()：DEBUG / RELEASE 一致讀 Lang/Xaml 分檔（移除 release 專屬 Xaml1 分支與 L3 兩樹差異 log），保留 Xaml1 fallback 僅為相容舊輸出。

刪除

• TsERP/Lang/Xaml1/（發行專屬合併檔）與 TsERP.csproj 對應登記。

• TsERP/Lang/Model1/Model.json（確認為死檔——全 repo 無 .cs 讀取）與 TsERP.csproj 對應登記。

• 舊 ModelMapService 機制全清：Common/Lang/Model/（整夾）、Common.csproj 的 Lang\Model\*.json glob、Common/Context/ModelMapAttribute.cs，及 Tmp1.cs/Tmp2.cs 的 [ModelMap] 標註。

Breaking Changes

無。執行期行為對使用者相同（翻譯來源不變，僅部署/讀取路徑收斂）。

Migration Notes

• 開發/發行端重建輸出即可；下次 Velopack 發版自動帶齊全部分檔（含先前漏掉的 ~69 個）。

• 舊輸出目錄殘留的 Lang/Xaml1 不再被讀取，可忽略或清除。