From 0756bf12d10cf1b7f78c571de0a9ad69cbaeb7ca Mon Sep 17 00:00:00 2001
From: curtis <curtis@i-mps.com>
Date: 星期一, 30 三月 2026 14:24:17 +0800
Subject: [PATCH] fix: 更新內部引用方法參照
---
doc/curtis/prompt/scanimpl_analysis/01/scanimpl_annalysis_step_ver.md | 145 ++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 145 insertions(+), 0 deletions(-)
diff --git a/doc/curtis/prompt/scanimpl_analysis/01/scanimpl_annalysis_step_ver.md b/doc/curtis/prompt/scanimpl_analysis/01/scanimpl_annalysis_step_ver.md
new file mode 100644
index 0000000..d2eb174
--- /dev/null
+++ b/doc/curtis/prompt/scanimpl_analysis/01/scanimpl_annalysis_step_ver.md
@@ -0,0 +1,145 @@
+
+
+### 0.1.1. 專案背景與目標
+本文件定義了將大型實體檔案 `CB_IMGPSScanImp.pas.bk` 進行解耦與重構的標準流程。
+核心策略在於「步驟間解耦（Step Decoupling）」，透過引入中介產出物，確保流程中斷時可從失敗步驟直接重試，無需重複耗時的掃描作業。
+
+### 0.1.2. 環境變數定義
+- {{base_path}} = "doc/curtis/prompt/scanimpl_analysis"
+- {{script_path}} = "script"
+- {{source_file}} = "CB_IMGPSScanImp.pas.bk"
+
+### 0.1.3. 四階段執行程序規格
+
+### 0.1.3.1 階段一：原始碼結構提取 (Physical Extraction)
+- **目標**：識別所有 `TCB_IMGPSScanX` 類別的方法實體邊界，建立物理行號索引。
+- **輸入**：{{source_file}}。
+- **處理邏輯**：
+ 1. 執行逐行掃描。
+ 2. 匹配正則表達式：`^(procedure|function)\s+TCB_IMGPSScanX\.`。
+ 3. 紀錄 `lIndex`：該方法宣告所在的起始行號（從 1 開始計算）。
+ 4. 紀錄 `matcher`：該行的完整原始碼字串。
+ 5. 計算 `rIndex`：將「下一個方法」的 `lIndex - 1` 作為當前方法的結束行；若為最後一個方法，則 `rIndex` 為檔案總行數。
+- **中介輸出**：`{{base_path}}/step1_raw_methods.json`
+- **中介輸出腳本**： `{{script_path}}/scanimpl_annalysis_extract_methods.js`
+- **結構範例**：`[{"matcher": "...", "lIndex": 120, "rIndex": 150}]`
+
+### 0.1.3.2 階段二：特徵比對與標籤分類 (Semantic Tagging)
+- **目標**：讀取邊界索引，根據關鍵字字典規則賦予業務分類標籤 (Tags)。
+- **輸入**：`{{base_path}}/step1_raw_methods.json`。
+- **處理邏輯**：
+ 1. 遍歷中介 JSON 中的所有項目。
+ 2. 依據 `matcher` 內容進行關鍵字匹配（分類規則詳見第 4 節）。
+ 3. 賦予對應的主標籤（如 `UIView`）與次標籤（如 `UIView.treeView`）。
+ 4. 統一初始化 `deps: []` 與 `description: ""` 欄位。
+- **中介輸出**：`{{base_path}}/step2_classified_methods.json`
+- **中介輸出腳本**：`{{base_path}}/scanimpl_annalysis_classify.js`
+
+### 0.1.3.3 階段三：模組分流實體化 (Module Disaggregation)
+- **目標**：將分類完成的總集合，物理性地拆分為五個符合專案規範的正式模組 JSON。
+- **輸入**：`{{base_path}}/step2_classified_methods.json`。
+- **處理邏輯**：
+ 1. 依據項目中的主標籤（ScannerController, BusinessLogic, ImageProcessor, TransportManager, UIView）進行分流。
+ 2. 格式化 JSON：使用 UTF-8 編碼，縮排為 2 個空格。
+- **目標產出**：
+ - `{{base_path}}/scanimpl_annalysis.ScannerController.json`
+ - `{{base_path}}/scanimpl_annalysis.BusinessLogic.json`
+ - `{{base_path}}/scanimpl_annalysis.ImageProcessor.json`
+ - `{{base_path}}/scanimpl_annalysis.TransportManager.json`
+ - `{{base_path}}/scanimpl_annalysis.UIView.json`
+- **目標產出腳本**： `{{script_path}}/scanimpl_annalysis_disaggregate.js`
+
+### 0.1.3.4 階段四：邊界驗證與死角萃取 (Validation & Dead Zone Analysis)
+- **目標**：產出並執行驗證腳本，確保 JSON 數據與原始碼 100% 對齊。
+- **輸入**：上述 5 個模組 JSON 與 {{source_file}}。
+- **驗證腳本規格** (`{{script_path}}/scanimpl_annalysis_json.test.js`)：
+ 1. **字串對齊斷言**：斷言 JSON 裡的 `matcher` 必須精確等於原檔在 `lIndex` 行的內容。
+ 2. **範圍合法性斷言**：斷言所有 `lIndex` 與 `rIndex` 均 > 0，嚴禁出現 -1。
+ 3. **覆蓋率分析**：標記所有被捕捉的行區段，將未被標記的代碼區塊（如全域變數、Type 定義區）匯出至 `remainings.txt`。
+- **驗證產出**：
+ - `{{script_path}}/dist/scanimpl_annalysis.remainings.txt` (死角清單)
+
+### 0.1.4. 方法分類 Tags 映射規則
+請根據以下關鍵字進行簡單的字串比對分類 (如果不在此列表內，則預設分類到 `"UIView"` / `"UIView.misc"`), tags 應允許多組:
+* **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.layouts`
+ * `DataLoading`, `Timer2Timer`, `StatusBar1DblClick` -> `UIView.statusMessenger`
+
+
+**example:**
+```pascal
+// CB_IMGPSScanImp.pas, 假定該分類為 ImageProcessor.anchorAnalyzer
+function TCB_IMGPSScanX.GetSiteOMR(FileName,Site:String;bt: Integer): Integer;
+```
+
+```json
+{
+ "matcher": "function TCB_IMGPSScanX.GetSiteOMR(FileName,Site:String;bt: Integer): Integer;",
+ "tags": [
+ "ImageProcessor",
+ "ImageProcessor.anchorAnalyzer"
+ ],
+ "deps": [],
+ "lIndex": "5173",
+ "rIndex": "5226",
+ "description": ""
+}
+```
+
+#### 0.1.4.1 ScannerController (掃描硬體控制模組)
+- ScannerController.twainWrapper (TWAIN 介面與硬體初始化)
+- ScannerController.acquisitionHandler (硬體取像非同步回呼與後處理)
+
+#### 0.1.4.2 ImageProcessor
+- ImageProcessor.transformer (影像幾何與物理變換)：如各種縮放 (ReSize)、裁切 (CheckNeedCrop)、旋轉 (Rotate)、去斜 (Deskew) 及所有 UI 比例變換等。
+- ImageProcessor.converter (影像色彩與品質轉換)：包含黑白轉換 (ConvertToBW)、平滑化 (Smooth)、遮罩處理 (Mask)、浮水印列印 (PrintImg)。
+- ImageProcessor.anchorAnalyzer (特徵定位與 OMR 分析)：包含了分析黑點密度的 GetSiteOMR。
+
+#### 0.1.4.3 TransportManager (傳輸與網路管理模組)，新增了：
+- TransportManager.apiClient (RESTful / Servlet 參數與組態拉取)
+- TransportManager.fileTransfer (大檔、影像、FTP 實體傳輸)
+- TransportManager.certificateManager (HTTPS 與 SSL 憑證驗證)
+- TransportManager.payloadArchiver (ZIP 壓縮、解壓縮與進匯出封裝)
+
+#### 0.1.4.4 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 相關,
+
+#### 0.1.4.5 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)
--
Gitblit v1.8.0