🌐 第一章:臺灣正體中文與格式除錯防線 (Localization & Encoding)
- 硬性排除簡體編碼: 全系統(含後台資料庫、變數宣告與前端介面)嚴格禁止出現非預期之簡體字元與編碼殘留(如:
个、处、体、将)。
- 臨床醫學術語豁免: 臨床評估常用之標準臺灣正體字(如:「個案」、「處方」、「處置」)屬於常規醫學術語,完全合規,不在禁止與過濾之列。本規範旨在防範底層編碼錯亂,而非限制專業臨床語意。
- 法規術語完整性: 系統輸出或前端介面顯示給使用者看時,禁止使用非標準簡稱。必須精確完整顯示行政官方法定名稱(例如:必須完整呈現
「低收入戶」、「中低收入戶」,禁止在最終 UI 暴露底層簡寫)。
📊 第二章:標準物件模型與精算核心結構 (Data Schema & Separation)
為確保計算核心(JS Core)與輕量化資料庫(ATTRIBUTED_ITEMS_DB)的傳輸與動態索引效能,本系統實施「儲存鍵值與顯示標籤分離原則」:
/* 官方 SSOT 標準資料庫物件模型 (Schema V6.1) */
const ATTRIBUTED_ITEMS_DB = [
{
id: "CC01_01",
category: "轉移位協助大類",
name: "前臂拐杖 / 腋下拐杖 (雙支)",
years: 3,
pwd_raw: { "低收": 500, "中低收": 375, "一般戶": 250 },
ltc_raw: { "低收": 500, "中低收": 375, "一般戶": 250 },
note: "個案上肢及抓握操作能力良好,具備足夠軀幹穩定度時適用。"
}
];
💡 鍵值對齊與渲染防線
- 底層儲存/鍵值 (Key): 內部 JSON 數據物件之身份鍵值統一使用優化輕量化簡寫:
"低收"、"中低收"、"一般戶"。
- 前端渲染/顯示 (Label): 系統將數據輸出至前端 UI 下拉選單(Select Option)、動態收據明細、精算小計與列印區塊時,必須對照轉換為官方標準稱謂:「低收入戶」、「中低收入戶」。
📱 第三章:行動端優先開發規格 (Mobile-First Touch UX)
- 視埠與縮放約束: 必須強制配置並鎖定 Viewport 參數,防止在移動端設備上因捏合造成跑版:
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
- 行動端 44px 觸控幾何學: 所有可點擊之互動元件(如:頂部大類切換按鈕、身分下拉選單、操作核取方塊),其外觀或熱區總高度一律不得低於 44px,以確保第一線治療師在臨床高頻率觸控時的精準度。
- 代碼防爆折行: 行動端環境下,任何顯示純文字數據或 SSOT 資料之區塊,必須強制啟用
white-space: pre-wrap;,確保內容隨螢幕寬度自動換行,禁止橫向溢出。
⚙️ 第四章:動態過濾與狀態容器規格 (DOM & State Management)
- 狀態容器唯一性約束 (SSOT): 系統初始化或經由前端切換追蹤模式(長照/身障/雙軌)時,必須確保
<body> 或主包覆容器之狀態類別(如 show-both-mode、show-ltc-mode)由 JavaScript 計算引擎動態控制為唯一實體。
- 禁止硬編碼衝突: 嚴格禁止於 HTML 靜態標籤中先行硬編碼(Hard-code)相互衝突之初始化類別,以徹底防止樣式疊加與邏輯控制權衝突。
- 智慧過濾演算法: 透過高效
includes 匹配進行非破壞性隱藏。不符資格之品項卡片需加入 filtered-out-level 類別,呈現半透明遮罩並強制綁定 pointer-events: none; 封鎖觸控事件。