臺灣血液透析實作指引 (TW HD IG)
0.0.2 - ci-build Taiwan, Province of China flag

臺灣血液透析實作指引 (TW HD IG) - Local Development build (v0.0.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Logical Models

邏輯模型

本頁以概念性業務邏輯模型規範「透析病例交換」文件應包含哪些內容。邏輯模型描述的是業務層級的資料結構(如:出院病摘、癌症個案追蹤之於各自領域),而非單一資源的線格式;實際交換時以文件型 Bundle 打包。

模型完整欄位與基數(Snapshot Tree Table)請見邏輯模型結構定義: 透析病例交換 (Hemodialysis Case Exchange)

模型架構

一份透析病例交換type = document 的 Bundle,第一筆 entry 為 HemodialysisComposition(文件骨架),其餘 entry 為各章節所參照之 profiled 資源。所有基礎資源皆衍生自 TW Core IG

flowchart LR
  B["Bundle document — HemodialysisDocumentBundle"]:::bundle --> C["Composition 1..1 — HemodialysisComposition"]:::comp

  C --> R["必備角色"]:::grp
  R --> P["Patient 1..1 — HDPatient"]
  R --> O["Organization 1..1 — Organization-twcore"]

  C --> DX["病史與診斷"]:::grp
  DX --> PRD["原發腎臟疾病 0..1 — HDPrimaryRenalDisease"]
  DX --> CM["合併症 0..* — HDComorbidity"]
  DX --> INF["感染 0..* — DialysisInfection"]

  C --> EN["就醫脈絡"]:::grp
  EN --> ENC["住出院 0..* — HDEncounter"]

  C --> TX["透析處方與治療"]:::grp
  TX --> PRE["處方 0..* — HemodialysisPrescription"]
  TX --> SES["治療紀錄 0..* — HemodialysisSession"]
  TX --> VA["血管通路 0..* — HDVascularAccessProcedure / VascularAccessDevice"]
  TX --> DZ["透析器 0..* — Dialyzer"]
  TX --> MED["用藥 0..* — HDMedicationStatement"]

  C --> LAB["檢驗與評估(數值型)"]:::grp
  LAB --> OBS["檢驗 0..* — HDLabObservation"]
  LAB --> BP["血壓 0..* — HDBloodPressure"]
  LAB --> BW["體重 0..* — HDBodyWeight"]
  LAB --> AF["通路血流量 0..* — HDAccessFlow"]
  LAB --> FS["生活活動評估 0..* — HDFunctionalStatus"]
  LAB --> GS["一般狀況評估 0..* — HDGeneralStatus"]

  classDef bundle fill:#1f6feb,color:#fff,font-weight:bold;
  classDef comp fill:#2da44e,color:#fff,font-weight:bold;
  classDef grp fill:#eaeef2,color:#24292f,font-weight:bold;

檢驗數值之記錄建議

KiDiT「檢驗記錄」表中多數欄位為數值型檢驗結果(如 Hb、BUN、Creatinine、intact-PTH…)。這類資料不宜以列舉碼(CodeSystem/ValueSet)展開,而應以 HDLabObservation 逐筆記錄:Observation.codeLOINCObservation.value[x]Quantity(數值 + UCUM 單位) 表述、Observation.effective[x] 記錄採檢時間。透析前/後之項目以 extension dialysisTiming 區分。

建議納入交換之檢驗 Observation(節錄自《資料轉入格式說明.xls》「檢驗記錄」表,LOINC 為建議值,導入前請複核):

KiDiT 欄位 建議 LOINC 單位 (UCUM) 採用 Profile
W.B.C. 6690-2 10*3/uL HDLabObservation
R.B.C. 789-8 10*6/uL HDLabObservation
Hb(血色素) 718-7 g/dL HDLabObservation
Hct(血比容) 4544-3 % HDLabObservation
Platelet 777-3 10*3/uL HDLabObservation
Albumin 1751-7 g/dL HDLabObservation
AST (GOT) 1920-8 U/L HDLabObservation
ALT (GPT) 1742-6 U/L HDLabObservation
Glucose (AC) 1558-6 mg/dL HDLabObservation
Cholesterol 2093-3 mg/dL HDLabObservation
Triglyceride 2571-8 mg/dL HDLabObservation
BUN(透析前 / 後) 3094-0 mg/dL HDLabObservation(+dialysisTiming
Creatinine 2160-0 mg/dL HDLabObservation
Uric acid 3084-1 mg/dL HDLabObservation
Na 2951-2 mmol/L HDLabObservation
K 2823-3 mmol/L HDLabObservation
Cl 2075-0 mmol/L HDLabObservation
全鈣 (Calcium) 17861-6 mg/dL HDLabObservation
P(磷) 2777-1 mg/dL HDLabObservation
Ferritin 2276-4 ng/mL HDLabObservation
Fe(鐵) 2498-4 ug/dL HDLabObservation
intact-PTH 2731-8 pg/mL HDLabObservation
HBsAg 5196-1 (定性) HDLabObservation
Anti-HCV 16128-1 (定性) HDLabObservation
透析前 / 後收縮 / 舒張壓 mm[Hg] HDBloodPressure
透析前體重 8347-7 kg HDBodyWeight
透析後 / 上次透析後體重 8344-4 kg HDBodyWeight
理想乾體重(量測 / 估計) 8341-0 / 8340-2 kg HDBodyWeight
身高 8302-2 cm Observation-body-height-twcore

「自訂一~八」等院所自訂欄位,建議於導入時逐一對應適當 LOINC 後,同樣以 HDLabObservation 記錄;無對應碼者可暫以本地碼搭配 text 表述。EKG 影像建議以對應之診斷報告 / 影像資源表達,不納入數值型 Observation。

各 profiled 資源之可編碼欄位採三層 coding(國際標準必填 > TW Core 選填 > KiDiT 本地碼選填),詳見三層術語對照表

完整構件(含 Profiles、Extensions、術語)請見規範文件