HL7 FHIR Implementation Guide: HealthBank IG Release 0.1.0 - TW | STU1
0.1.0 - ci-build

HL7 FHIR Implementation Guide: HealthBank IG Release 0.1.0 - TW | STU1 - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Home

Official URL: https://ig.dicom.tw/healthbank/ImplementationGuide/HealthBank.MI-TW-2024-WG5 | Version: 0.1.0
Active as of 2024-08-16 | Computable Name: HealthBank

此IG主要用於健康存摺工作流程之資料交換，並繼承於臺灣核心實作指引（Taiwan Core Implementation Guide，以下簡稱Tw Core IG）規則。

### 介紹

在醫療健康照護領域，資料交換能促進病人連續性照護、醫療資料整合和應用。然而，各醫療系統資料格式和標準各異，導致資料交換困難。臺灣採用健保單一給付制度，雖已有既定的架構與規格，但醫療單位間資料交換仍有落差。

為解決此問題，推動統一的FHIR資料架構，定義完善的資料內容和交換項目，能快速萃取所需資料，使用統一介面讀取，並加速資料儲存效率。

此IG為2024年台灣醫學資訊標準聯測工作小組WG5#照護協調之情境二，基於現有健保署健康存摺下載格式，並參考Tw Core IG設計，旨在加速醫療院所和資訊服務提供商的互操作架構開發，提高跨機構資料交換效率。

在醫療照護場域中，如轉診、慢性病照護、癌症治療和長期照護等，需要跨院團隊的連續性照護。此IG旨在促進個人健康識能，幫助民眾了解並持有自身電子健康檔案（PHR），並統一不同格式之電子病歷和健康資料交換規範。

本IG依據既有非FHIR標準設計符合台灣醫療照護應用情境資訊需求之健康存摺FHIR Resource規範與通用系統互通操作應用流程，並相容衛福部Tw Core IG規範。Tw Core IG基於FHIR R4.0.1及國際病人摘要（IPS）1.0.0-CI Build之標準，進一步定義適用於臺灣健康照護資料交換需求的Resources及其資料項目，提供健康照護資訊系統開發與實作者以Tw Core IG為基礎，訂定其專案所需之資料交換格式。

### 背景

#### SDK健康服務連結-衛生福利部中央健康保險署

- SDK健康服務連結

#### 健康存摺-衛生福利部中央健康保險署

- 健康存摺

#### 衛生福利部-電子健康紀錄

- 電子健康紀錄

#### iThome-人工智慧在醫療中的應用

- 人工智慧在醫療中的應用

### 系統角色 System Roles:

- Patient/Agent App:
  - The system that collects existing PHR/EHR data, e.g., Patient App, Patient Portal.
- Existed EHR Source:
  - The system that already exists and holds EHR data in non-FHIR format.
- PHR Repository:
  - The system that stores PHR records, e.g., FHIR Server.

### 交易清單 Transactions:

- Transaction 1: Patient/Agent App Get existed EHR data in non-FHIR format and transfer to FHIR Bundle.
  - SC2: NHI-Health Bank JSON
    - r1 Outpatient Data
    - r2 Inpatient Data
    - r4 Allergy Data
    - r7 Laboratory Results Data
- Transaction 2: Patient/Agent App Create FHIR Document Bundle to PHR Repository.
  - SC2: NHI-Health Bank JSON
    - r1 Outpatient Data LOINC = 34117-2 History and physical note
    - r2 Inpatient Data LOINC = 34130-5 Hospital Progress note
    - r4 Allergy Data LOINC = 48765-2 Allergies and adverse reactions Document
    - r7 Laboratory Results Data LOINC = 30954-2 Relevant diagnostic tests/laboratory data Narrative
- Transaction 3: Patient/Agent App Search FHIR Document Bundle and display content.
  - Search Bundle or Composition by Patient identifier or name
  - Search Bundle or Composition by Patient identifier and date
  - Search Bundle or Composition by Patient identifier and custodian (or managingOrganization)
  - Hint: use https://hl7.org/fhir/R4/composition.html#search

### Sequence Diagram:

Secquence Diagram of Continuouse Prescription |
--- | ---

### Profiles

此為HealthBank所有Profiles規範

#### HealthBank Workflow

- HealthBank Profiles
  - Bundle-HealthBank 資料交換基本單位
  - AllergyIntolerance-HealthBank 過敏或不耐症
  - Condition-HealthBank 病情、問題或診斷
  - Composition-HealthBank 臨床文件架構
  - Encounter-HealthBank 就醫事件
  - MedicationRequest-HealthBank 用藥請求規範
  - Observation-laboratoryResult-HealthBank 檢驗檢查
  - Organization-HealthBank 機構
  - Patient-HealthBank 病人
  - Procedure-HealthBank 處置或手術

### Examples

#### healthbank_r1 西醫門診範例

- healthbank_r1 西醫門診範例

#### healthbank_r2 住院資料範例

- healthbank_r2 住院資料範例

#### healthbank_r4 過敏資料範例

- healthbank_r4 過敏資料範例

#### healthbank_r7 檢驗 (查) 結果範例

- healthbank_r7 檢驗 (查) 結果範例

### 專有名詞定義

本實作指引基於TW Core IG規則，其部分敘述如下：

#### Profile

英文名 | 中文名 | 說明
--- | --- | ---
Name | 名稱 | resource的資料項目名稱(意即XML元素名稱；JSON或RDF屬性名稱)。 有些名稱末端為[x]，圖示為multipleBirth[x]範例，意即可以選擇適用的資料類型表述該資料項目內容值,故需依據資料類型填入適當的內容值，例如Patient.multipleBirth[x]。
Cards. | 基數 | 此資料項目允許出現在這個resource的最小至最大次數，意即例如某一資料項目的基數若為0..1，表示可不填寫或至多填入1筆；若為1..1，表示必須(只能)填入1筆；若為0..，表示可不填寫或填入多筆(不限筆數)；若為1..，表示至少要填入1筆或填入多筆(不限筆數)。
Type | 資料型別 | 資料項目的資料型別(可超連結至該型別的定義)，例如：boolean、integer、dateTime等。
Description &Constraints | 描述與限制 | 此資料項目的描述及詳細的限制。尤其編碼的資料項目可使用何種代碼填寫，如果有特定需要綁定的的代碼，則會以Binding陳述。

#### 綁定值集(value set)的強度

英文名 | 中文名 | 說明
--- | --- | ---
Required | 要求使用 | 應填入代碼表中的其中一個代碼
Preferred | 鼓勵使用 | 鼓勵使用代碼表中的代碼， 但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example | 範例 | 可參考代碼表，但此代碼表只是針對這個欄位的一個可能值的示例，不預期也不鼓勵使用者一定要使用此代碼表的代碼。
Extensible | 可擴充 | 應填入代碼表中適合的代碼，確定無適合的代碼才可以使用其他代碼中的代碼來表示。

#### 符合度用語(Conformance Language)

FHIR使用RFC 2119中定義的符合度動詞必須(SHALL)、建議應該(SHOULD)和可能可以(MAY)。而FHIR與RFC 2119不同的是，FHIR允許不同的應用程式因使用可選功能的方式而無法達到可互操作性，特別是：

1. 必須(SHALL)：所有實作絕對要符合要求。

2. 必須沒有(SHALL NOT)：所有實作絕對禁止的要求。

3. 建議應該(SHOULD)/建議不應該(SHOULD NOT)：實作者在特定實作的情境下考慮的最佳或建議實作方法；雖然忽略一個項目可能有正當理由，但在選擇不同的程序之前，必須了解並慎重衡量所有含義。

4. 可能可以(MAY)：這是實作者真正可選的要求；可根據實作者的決定使用或不使用，不會造成任何影響。

其餘詳細規則請詳閱TW Core IG網站

### 作者/貢獻者

角色 | 機構名稱 | 姓名 | 所屬單位 | 聯絡方式
--- | --- | --- | --- | ---
作者 | 台灣醫學資訊學會/九日生行動健康科技股份有限公司 | 李祥豪 (Siang Hao Lee) | 台灣醫學資訊學會/九日生行動健康科技股份有限公司 | shvoidlee@gmail.com
作者 | 國立陽明交通大學 | 楊宗翰 (Zong-Han Yang) | 國立陽明交通大學生物醫學資訊所 | a3n7219@gmail.com
作者 | 國立臺北護理健康大學 | 林冠勳 (Kuan-Hsun Lin) | 國立臺北護理健康大學資訊管理系 | a61392003@gmail.com
貢獻者 | 國立陽明交通大學 | 邱奕儒 (Yi-Ju Chiu) | 國立陽明交通大學生物醫學資訊所 |
貢獻者 | 佛教慈濟醫療財團法人花蓮慈濟醫院 | 陳俊勳 (Chun-Hsuan Chen) | 佛教慈濟醫療財團法人花蓮慈濟醫院 |