~curtischang/CB_IMGPSScan.git

---
base_path: "doc/curtis/prompt/scanimpl_analysis"

script_path: "script"

B1.1 分析方法集合：

請依 @Delphi_套件相依.md 裡「依功能拆分模組與第三方套件綁定分析」要項
對 @CB_IMGPSScanImp.pas 檔案進行分析，將合於該分類的方法名集合找出來
生成對應的 json 檔, 該生成的 json 檔可用來代表 @CB_IMGPSScanImp.pas.bk
拆分前的每個方法，其分類是什麼，其所在區段是什麼，最後該 json 檔將餵入
腳本，透過腳本執行，進行檔案拆分及測試，而不是透過 AI 拆分

以下是詳細規格需求：

B1.1.1. 輸入檔案：

程式需讀取同一目錄下的 CB_IMGPSScanImp.pas.bk 檔案。

B1.1.2. 方法擷取：

尋找檔案中所有以 procedure TCB_IMGPSScanX. 或 function TCB_IMGPSScanX. 開頭的行。
紀錄每個方法的：
- lIndex：該方法在檔案中的起始行號（從 1 開始計算）。
- methodName：方法的完整簽名字串 (例如：procedure TCB_IMGPSScanX.StatrTwainScan;, procedure TCB_IMGPSScanX.OnAcquire( const DibHandle : THandle;)。

B1.1.3. 計算 `rIndex`：

每個方法的結束行 (rIndex) 可以假設是下一個方法開始的前一行 (lIndex - 1)。
如果是最後一個方法，它的 rIndex 應該是檔案的總行數。

B1.1.4. 分類邏輯 (tags)：

我需要你將找到的每個方法，分配到對應的 `tags`。
請根據以下關鍵字進行簡單的字串比對分類 (如果不在此列表內，則預設分類到 `"UIView"` / `"UIView.misc"`):

ScannerControl (硬體掃描控制模組)
- StatrTwainScan, OnAcquire, initkscan, CheckScannerConfig, PageEnd, PageDone, R_W_Scanini, GetDefScanIni -> ScannerControl.twainWrapper
ImageProcessor (影像處理與轉換模組)
- DeskewImg, Rotate, CropImg, ImageReSize_FormID, ImageReSize_tmp, CheckNeedCrop -> ImageProcessor.transformer
- ConvertToBW, ConvertToGray, Image_Smooth, NegativeImg, CleanupBorder -> ImageProcessor.converter
- MpsGetBarcode, Get_OMR -> ImageProcessor.barcodeRecognizer
- FindPoint, CheckSize, GetSiteOMR -> ImageProcessor.anchorAnalyzer
TransportManager (安全傳輸與 API 通訊模組)
- ProcessServlet, ProcessServlet_Get, ProcessServlet_FormData -> TransportManager.requestWrapper
- upFile, dnFile, dnFile_Get, GetftpInfo, SetFtpInfo, FtpCaseComplete -> TransportManager.fileTransfer
- En_DecryptionStr_Base64, LoadFileGetMD5, HTTPSClientCertificateValidate -> TransportManager.utilities
- ZipMainFile, ZipMaskFile, ExecuteUnZip -> TransportManager.payloadArchiver
BusinessLogic (業務邏輯與資料解析模組)
- SetSQLData, GetSQLData, FindSQLData, GetSetInf1, GetSetInf2, GetSetInf3, GetSetInf4, GetSetInf5, GetSetInf6, GetSetInf7 -> BusinessLogic.paramState
- BarCode2FormID, BarCode2CaseID, FormCode2DocNo, DocNo2DocName, DocNoNeedDiv, CreateDocNo_Info, CreateCustDocNo_Info -> BusinessLogic.entityMapping
- OMRCheckCase, OMRErr2ini, OMRErrini2List -> BusinessLogic.ormRuleEngine
- SetUseCase, GetUseCase, OldCasetoNewCase, ErrFormtoCurrentForm, DeleteDocNoFileForESCAN -> BusinessLogic.caseManager
UIView (UI 視圖與介面呈現模組)
- 包含 TreeView 的方法 (如 TreeView1Click, DrawDocItem2 等) -> UIView.treeView
- 包含 ISB, ImageScrollBox, ScrollBox 的方法 (如 ISB1Click, CreatePreViewISB 等) -> UIView.scrollView
- InitialLanguage, DownLanguage -> UIView.i18n
- DisplayMode, GoViewMode -> UIView.misc
- DataLoading, Timer2Timer, StatusBar1DblClick -> UIView.statusMessenger

B1.1.5. 方法分類 tags 說明：

ScannerController (掃描硬體控制模組)

ScannerController.twainWrapper (TWAIN 介面與硬體初始化)
ScannerController.acquisitionHandler (硬體取像非同步回呼與後處理)

ImageProcessor

ImageProcessor.transformer (影像幾何與物理變換)：如各種縮放 (ReSize)、裁切 (CheckNeedCrop)、旋轉 (Rotate)、去斜 (Deskew) 及所有 UI 比例變換等。
ImageProcessor.converter (影像色彩與品質轉換)：包含黑白轉換 (ConvertToBW)、平滑化 (Smooth)、遮罩處理 (Mask)、浮水印列印 (PrintImg)。
ImageProcessor.anchorAnalyzer (特徵定位與 OMR 分析)：包含了分析黑點密度的 GetSiteOMR。

TransportManager (傳輸與網路管理模組)，新增了：

TransportManager.apiClient (RESTful / Servlet 參數與組態拉取)
TransportManager.fileTransfer (大檔、影像、FTP 實體傳輸)
TransportManager.certificateManager (HTTPS 與 SSL 憑證驗證)
TransportManager.payloadArchiver (ZIP 壓縮、解壓縮與進匯出封裝)

BusinessLogic

BusinessLogic.systemInternal': 系統參數與組態儲存庫 (Config & Parameter Repository),
BusinessLogic.configRepository: 系統參數與組態儲存庫 (Config & Parameter Repository),
BusinessLogic.ormRuleEngine': OMR 與業務規則檢核引擎 (OMR & Business Rule Engine),
BusinessLogic.entityMapping: 領域實體對映與結構管理器 (Entity Mapping & Structure Manager),
BusinessLogic.entityModel: 領域實體對映與結構管理器 (Entity Mapping & Structure Manager),
BusinessLogic.fileManager': 案件異動與舊案引用處理器 (Case Modification & Legacy Handler),
BusinessLogic.caseManager': 案件異動與舊案引用處理器 (Case Modification & Legacy Handler),
BusinessLogic.activeXWrapper': 處理 ActiveX 相關,

UIView

UIView.treeView：樹狀結構呈現與操作 (如 TreeView 的節點刷新、拖曳、點擊)
UIView.listView：清單結構呈現 (如 PageLV, AttListBox)
UIView.imageScrollBox：影像預覽與捲動 (對應 EnImgScr / TImageScrollBox 相關的視覺控制與預覽)
UIView.toolBar：互動工具與面板按鈕 (如各類 BtnClick、FC 分類按鈕)
UIView.popupMenu：快顯選單控制 (各類 PMxxxClick 或是 PopupMenuPopup)
UIView.i18n：多國語言與翻譯載入
UIView.feedback：系統狀態與進度回饋 (包含 Timer、DataLoading、StatusBar)

B1.1.5. 輸出格式：

JSON 輸出的結構應該類似這樣：
json [ { "matcher": "procedure TCB_IMGPSScanX.OnAcquire( const DibHandle : THandle;", "tags": [ "ScannerController", "ScannerController.acquisitionHandler" ], "deps": [], "lIndex": "4444", "rIndex": "4476", "description": "" } ]
盡量將相同 tags 的 items 群組在一個 block 內。
deps 保持空陣列

B1.2 分類結果生成：

B1.2.1 生成分類結果 json - tags 說明:

透過 B1.1 取得的結果將各個方法名進行分類，分類時請合於 @Delphi_套件相依.md
的分類方法，並依 "B1.1.5 方法分類 tags 說明" 判定其 tags 屬性

example:
pascal // CB_IMGPSScanImp.pas, 假定該分類為 ImageProcessor.anchorAnalyzer function TCB_IMGPSScanX.GetSiteOMR(FileName,Site:String;bt: Integer): Integer;

{
  "matcher": "function TCB_IMGPSScanX.GetSiteOMR(FileName,Site:String;bt: Integer): Integer;",
  "tags": [
    "ImageProcessor",
    "ImageProcessor.anchorAnalyzer"
  ],
  "deps": [],
  "lIndex": "5173",
  "rIndex": "5226",
  "description": ""
}

B1.2.2 生成分類結果 json - 輸出位置說明:

B1.2.2.1 - 若 tag 名其一綴包含 ScannerController:
> output: {{base_path}}/scanimpl_annalysis.ScannerController.json
B1.2.2.2 - 若 tag 名其一綴包含 BusinessLogic:
> output: {{base_path}}/scanimpl_annalysis.BusinessLogic.json
B1.2.2.3 - 若 tag 名其一綴包含 ImageProcessor:
> output: {{base_path}}/scanimpl_annalysis.ImageProcessor.json
B1.2.2.4 - 若 tag 名其一綴包含 TransportManager:
> output: {{base_path}}/scanimpl_annalysis.TransportManager.json
B1.2.2.5 - 若 tag 名其一綴包含 UIView:
> output: {{base_path}}/scanimpl_annalysis.UIView.json

B1.3 生成分類結果 json 驗證腳本

生成腳本，以驗證 "B1.2 分類結果生成" 是否正確，該腳本檔針對 @CB_IMGPSScanImp.pas.bk
與 '"B1.2 分類結果生成" 生成之 json'(以下簡程 [B1.2Jsons] ) 進行驗證

B1.3.1 驗證原則說明：

B1.3.1.1: [B1.2Jsons] 其方法名(matcher) 必須等於 @CB_IMGPSScanImp.pas 所對應的 lIndex
B1.3.1.2: [B1.2Jsons] 裡的 rIndex, lIndex 不可能為 -1, 因為該值必須正確映射 @CB_IMGPSScanImp.pas.bk 的行號
B1.3.1.3: 移除 @CB_IMGPSScanImp.pas 中於 [B1.2Jsons] 所標示之區段另存為文字檔，並於腳本結束時，顯其文字檔路徑，我想人工審核
> output: {{base_path}}/scanimpl_annalysis.remainings.txt

B1.3.2 驗證腳本路徑：

output: {{script_path}}/scanimpl_annalysis_json.test.js