動態法遵硬化 / DYNAMIC COMPLIANCE HARDENING

我們目前正將所有算力集中於法遵 (Compliance) 與商業邏輯 (Commercial Logic) 的動態強化。

在商業端，我們拒絕妥協於模糊的「平均成本」。系統強制執行實質進貨成本與指定批號 (Batch-Specific Costing) 的絕對綁定，與上游報價咬定 (Quote Locking)，還原最真實的毛利結構。

在法遵端，這是為了打造一套「絕對安全系統」。我們保證讓藥局的經營者與藥師們處於絕對不會被核刪、被罰款的防禦工事之中，即使面對每日高強度的稽核也能全身而退。

我們的防禦體系甚至已提前部署，全面鎖定尚未上路的 DET 2.0 與 UDI 新制。

請信任在極限邊界生存的我們所交付出的代碼，這絕對也是能使您生存的極限代碼。

從「被動調劑」轉向「主動獵殺」

藥師只需掃描處方箋上的二維條碼 (QR Code / Data Matrix)，系統即刻解析。

• 精準關聯銷售 (Cross-selling)：系統偵測到病患領取「降血脂藥 (Statin)」，自動提示推薦 Q10；偵測到「骨科用藥」，提示推薦 鈣片。
• 高價值客戶識別 (HVC Identification)：誰是拿了藥就走的過客？誰是會順手帶兩罐保健品的 VIP？系統幫您貼上標籤，將行銷火力集中在對的人身上。

FEFO 戰術 (First Expired, First Out)

我們不只記錄數量，我們追蹤每一批藥的「壽命」。

• 效期警示：30 天內到期的藥品，系統會發出紅色警報。
• 自動扣庫：優先扣除即將到期的批號，將耗損降至數學上的最小值。
• 精準計量：支援多層次單位換算（盒 -> 板 -> 顆），無論怎麼拆賣，庫存永遠準確。
• 採購閉環：從草稿、下單到驗收（含部分收貨），支援匯出裕利 (Yuli) 格式，一鍵對接主流通路。

總倉調撥 (Warehouse Transfer)

連鎖藥局的物流不是搬運，是「戰略部署」。如何讓「彈藥 (庫存)」在最需要的時刻，出現在火線 (門市) 上？

• 據點管理：總倉、門市一目了然。每個據點獨立庫存，統一調度。
• 調撥流程：建立調撥單 → 送出（自動扣庫）→ 收貨（自動入庫）。全程追蹤，絕不漏帳。
• 部分收貨：運送途中破損？短缺？系統支援逐項核對，差異自動記錄。
• 即時取消：調撥取消時，庫存自動回沖。沒有任何黑洞。

影子庫存 (Shadow Inventory)

HIS 只記錄您告訴它的數字。我們記錄「真相」。

• 理論消耗追蹤：解析健保 XML 中的 D07/D05 欄位，根據處方頻次 (TID/BID/QD) 推算每日消耗量。
• 月均消耗速率 (AMC)：滾動三個月統計，自動計算動態安全水位。
• 帳有架無偵測：當理論庫存與實際盤點差異超過 10%，系統發出警報。幻影庫存無所遁形。
• 動態採購建議：基於 AMC 自動產生採購清單，urgent/high/medium 三級優先度排序。

供應商比價 (Supplier Comparison)

藥品的進貨價，是利潤的第一道防線。

• 多供應商整合：久裕、大昌、裕利，三家 API 並行查詢。
• 最佳供應商推薦：有庫存優先、價格最低優先、交期最短優先。自動排序，一鍵下單。
• 訂單 FTP 拋轉：支援 CSV/EDI/XML 多種格式，直接對接供應商系統。
• 主機金鑰管理：SFTP 連線自動驗證，已知主機指紋持久化儲存。

每日戰情視圖 (Daily Dashboard)

指揮官不需要看 Excel 表格。您需要的是「戰場迷霧 (Fog of War) 中的視野」。

• 今日預約 (To Visit)：預測今日回診領藥的慢箋病患清單，提前備藥，不再手忙腳亂。
• 營收透視 (Profit Analysis)：即時計算毛利、毛利率與總成本。不再等到月底結算，每一筆交易的利潤都清晰可見。
• 智慧趨勢 (Trend Prediction)：內建 SMA/WMA 統計模型，自動分析季節性用藥趨勢，讓庫存策略比流感跑得更快。

處方來源分析 (Prescription Source Analysis)

不是所有醫院都值得經營。我們幫您找到「80% 處方來自哪 20% 的醫療機構」。

• 熱點圖 (Heatmap)：基於 HHI 集中度指數，識別核心處方來源。
• 醫師藥品偏好：原廠藥 vs 學名藥比例，依 ATC 分類統計。
• 病患用藥演進：偵測糖尿病用藥階段進展，從口服藥到胰島素的轉變軌跡。
• 智慧照護建議：根據診斷碼自動推薦衛教內容與相關耗材。

藥價風險管理 (Drug Price Risk)

健保藥價調整 (DET) 是每年固定的損失。但損失可以被「預見」。

• 歷史藥價表：Valid From/To 時序管理，精確毛利回測。
• DET 跌價預警：批次匯入健保署藥價異動公告，計算庫存 × 跌幅 = 損失金額。
• 申報檔價格提取：自動從 D 段 p8 欄位抓取藥價，建立時序資料。
• 待生效藥價掃描：排程預警，在藥價調整前完成庫存調節。

重複用藥攔截 (Drug Overlap Blocker)

健保署的核刪大刀，砍向的是「餘藥重疊」。我們在調劑前攔截，而不是在核刪通知後哭泣。

• ATC5 碼比對：同成分、同類藥品即時檢測。
• 雲端藥歷整合：串接 GetMedPrtData API，查詢病患過去 180 天用藥記錄。
• 餘藥日數計算：根據雲端藥歷精確計算餘藥天數，分級阻擋。
• 四級阻擋機制：info (< 3天)、warning (3-7天)、critical (8-14天)、block (> 14天)。

健保核刪預測 (Claim Risk Prediction)

與其事後挨打，不如事前預警。

• D+P+T 完整解析：申報檔 50 欄藥品明細、10 欄費用、20 欄案頭，完整結構化。
• 就醫序號索引：以 d7 欄位為唯一索引，財務落點精準還原。
• 核刪樣態學習：診斷碼 + 藥品 + 醫院三重組合特徵分析。
• 風險金額試算：在調劑前估算這張處方的核刪風險金額。

管制藥品管理 (Controlled Substances)

一至四級管制藥品的進出登記，是藥局的法定義務。

• 分級進出登記：依管制藥品分級，完整追蹤進銷存。
• FDA 申報格式：一鍵產出符合管制藥品管理系統的申報資料。
• GTIN/批號追蹤：符合 UDI 規範的序號管理。
• 日劑量檢核：超過限量自動警示，避免不當處方。

讀卡機 Web API 封裝

不再需要古老的 VB 元件。我們用 Go 語言重新定義讀卡機的使用方式。

• localhost:5066 代理：統一 API Wrapper，完整封裝健保署 v1 介面。
• SAM 卡認證：Token 管理與憑證載入。
• 錯誤重試邏輯：5005/5006/6001 可重試錯誤自動指數退避。
• 70+ 錯誤代碼對照：健保署官方錯誤代碼完整翻譯。
• LAN 代理模式：支援 iPad/Android 行動櫃台跨裝置存取。

虛擬健保卡全流程自動化

實體卡與虛擬卡，對藥師應該是「透明的」。

• 雙模式掃描：自動偵測實體卡條碼 vs 虛擬健保卡 QR Code。
• Token 快取：vhcCloudToken 時效性管理，記憶體 + SQLite 雙層持久化。
• 無感切換：實體卡/虛擬卡狀態機切換，對藥師完全透明。
• 異常代碼處理：J000~J004 備援流程，5005 逾時自動重試。
• SSE 即時推送：服務狀態變化即時通知前端。

申報作業自動化

每日上傳與月申報，不該是月底的噩夢。

• XML Format 30 封裝：MB1/MB2 區段自動產生。
• 邏輯檢核引擎：藥碼/慢箋/劑量驗證，送出前攔截錯誤。
• D3/P1 申報檔產生：Fixed-Width Big5 格式，符合健保署規範。
• TOTFA.zip 打包：AES-256-CBC 加密，一鍵產出申報壓縮檔。

POS 收銀整合

• OTC + 處方合併結帳：健保處方與自費商品同一張發票。
• 會員點數系統：累積、兌換、VIP 識別。
• 部分負擔計算：自動套用健保規則，慢箋/一般處方差異計算。

電子發票整合

• 財政部大平台 API：AES-CBC 加密，直連電子發票系統。
• 發票字軌管理：使用量監控、餘量預警。
• B2C/B2B 開立：手機條碼載具、自然人憑證、捐贈碼、買方統編。
• 作廢/折讓處理：完整發票生命週期管理。

多元支付閘道

• LINE Pay API v3：請款/確認/退款完整流程。
• 信用卡收單：授權/請款/退款，支援分期付款。
• 統一支付抽象層：PaymentService 介面，未來擴充悠遊付、街口無痛接入。
• 拆帳支付：單筆交易多種支付方式並用。

VPN 智慧路由

同時使用 VPN (查詢雲端藥歷) 和 Internet (視訊通話)，不再二選一。

• 靜態路由自動配置：10.x.x.x / medcloudws2.nhi.gov.tw 走 VPN，其餘走預設閘道。
• 跨平台支援：macOS/Linux/Windows 路由表操作。

行動簽章服務

外勤藥師使用平板 + 藍牙讀卡機，實現真正的「行動調劑」。

• 藍牙讀卡機代理：BLE 通訊層，行動裝置讀取健保卡基本資料。
• SAM 卡遠端簽章：簽章請求回傳藥局端，SAM 卡完成簽章後回傳外勤裝置。
• 行動裝置 SDK：iOS (Swift)、Android (Kotlin)、Web (WebBluetooth) 三平台支援。

遠距會話管理

• 居家照護：確診者居家調劑記錄。
• 機構訪視：長照/護理之家，GPS 定位 + 服務記錄。
• 視訊問診：與醫師端視訊整合，遠距處方調劑。

長照耗材管理

機構住民的耗材，不是倉庫裡的雜物。是「照護品質」的具體呈現。

• 類別與品項管理：尿布、管路、敷料，依類別分層管理。
• 住民配發追蹤：誰用了什麼、用了多少、何時補充。
• 消耗計畫：依住民需求自動產生配發計畫。
• 統計報表：消耗趨勢、成本分析、採購建議。

門市與總倉

• 據點管理：總倉、門市一目了然。每個據點獨立庫存，統一調度。
• 調撥流程：建立調撥單 → 送出（自動扣庫）→ 收貨（自動入庫）。全程追蹤。
• 部分收貨：運送途中破損？短缺？逐項核對，差異自動記錄。

總部統一採購

• 集中訂購：各門市需求彙整，總部統一向供應商下單。
• 分配到店：入庫後依門市需求自動分配。
• 成本分攤：運費、折扣依比例分攤至各門市。

業績比較與同步

• 門市排行：營收、毛利、客單價，門市間透明比較。
• 分散式同步：各門市獨立運作，定期同步至總部。斷網也能正常營業。

CRM 客戶管理

• VIP 識別：消費金額、來店頻率、處方類型，自動分級。
• 生日提醒：節日行銷、生日優惠，精準觸及。
• 用藥關懷：慢性病患定期關懷，提升回購率。

簡訊通知

• 領藥提醒：慢箋到期前自動發送提醒簡訊。
• 到貨通知：預訂藥品到貨，即時通知取藥。
• 行銷推播：促銷活動、健康資訊，精準投遞。

雲端藥歷查詢

病患的用藥史，是調劑安全的第一道防線。

• 健保署雲端藥歷整合：查詢病患過去 180 天完整用藥記錄。
• 快取與預取：常見病患藥歷預先載入，加速調劑流程。
• 過敏史標註：藥物過敏、禁忌症一目了然。

存取控制 (RBAC)

• 角色分級：管理員、老闆、藥師、助理、訪客，五種預設角色。
• 權限矩陣：20+ 資源 × 6 動作 (read/create/update/delete/export/admin)。
• 完整審計日誌：誰、何時、對哪筆資料做了什麼操作，全程記錄。

資料保護

• 快取式處理：身分證、健保卡號僅存 RAM，AES-256-GCM 加密。持久化僅存 SHA-256 雜湊索引。
• 加密備份：AES-256 加密，勒索軟體防禦。
• 異地備援：Cloudflare R2 雲端同步。
• 資料遮罩：匯出時自動去識別化。

Mock Server 開發環境

沒有 VPN 也能開發。我們為開發者準備了完整的模擬環境。

• 測試病患：5 位預設病患（糖尿病/心臟病/重複用藥/管制藥/新生兒）。
• 虛擬健保卡 Token：含 5 分鐘過期機制。
• 錯誤情境模擬：逾時重試、VPN 斷線、SAM 過期、虛擬卡錯誤序列。
• 一鍵啟動：設定 `SAKIMED_MOCK_MODE=true` 即可切換。

Docker 容器化與離線交付

無論是末日地堡裡的離線主機，還是現代化的私有雲，Saki Pharmacy OS 都能生存。

• 完全容器化：提供標準 Docker Image，環境變數配置端口 (Ports) 與路徑。
• 離線交付能力：不依賴外部 PyPI/NPM 鏡像，單一映像檔 (Image) 即可部署。
• 基礎設施無關 (Infrastructure Agnostic)：不管是 Synology NAS、Raspberry Pi 還是高階伺服器，只要有 Docker 就能跑。