System Protocol v1.0

薪資計算邏輯核對表
Logic Alignment Protocol

本文件定義了 Google Sheets T4 系統的核心薪資計算邏輯。這是系統運作的「憲法」,確保每一次計算都符合醫療實際場景。

當前核心邏輯 (Current Implementation)

A. 資料讀取 (Data Ingestion)

  • 標題錨定:系統掃描 Row 3,只鎖定包含「醫」的欄位。
  • 病人關聯:自動抓取該欄位「左邊一格」作為病人姓名。
  • 日期映射:自動向左搜尋 Row 1,抓取最近的日期標題 (如 1/1)。

B. 計費引擎 (Billing Engine)

  • 唯一計費點:只有填寫「有效治療師姓名」的格子才產生金額。
  • 佔位符忽略:符號 (; " :) 與合併儲存格視為「延續時段」,只計工時,不計金額。
  • 內容感知 (Content-Aware):優先判定格內關鍵字 (如 徒手, 英特波),而非盲目信任欄位標題。解決「徒手病人在震波區」的計費錯誤。

C. 費率覆寫 (Rate Override)

半節 (Half) 偵測「半」→ $480
整合 (Integration) 偵測「整合」→ $1000
脊側 (Scoliosis) 偵測「脊側」→ $1080
自用 (Self) 偵測「自用」→ $0

T4 系統結構分析

原始 T4 系統依賴視覺位置來定義資料。我們的 GAS 引擎將這種「視覺邏輯」轉化為「結構化數據」。

  • 結構識別:資料成對出現 (左病右醫)。上方標題決定預設類別。
  • 計費黃金法則 (Golden Rules)
    • 1. 只算時間 (Time Only):佔位符、合併格、空名。
    • 2. 算錢 (Money):出現病人姓名 = 計費起點。
    • 3. 整合例外 (Integrated Exception):若為整合治療,當日同一療程內的所有項目綁定為單一費用 ($1000)。
    • 4. 費率修正 (Rate Fix):擴散震波調整為 $250/session。

Logic Flow (v1.1)

graph TD A[讀取 Row] --> B[建立 Raw Event] B --> C{Session 分組} C -- 同病人+連續 --> D[合併為單一療程] D --> E{檢查整合標記} E -- 有 (.整合) --> F[強制鎖定 $1000] E -- 無 --> G[加總獨特項目費率] F --> H[輸出明細] G --> H

Version History

v1.1 (Live) New

Session-Based Billing (防止重複計費) + Integrated Override

v1.0 Deprecated