# FHIR의 국제 환자 요약 (IPS)

> IPS 섹션 및 LOINC 코드, FHIR 문서 번들 구성 방법, 플랫폼에서 생성된 실제 발췌본, 그리고 검증된 IPS를 생성하기 위한 한 번의 호출에 대해 설명합니다.

Source: https://developers.anpheros.com/ko/guides/international-patient-summary-fhir

**국제 환자 요약 (IPS)은 표준화된 최소한의 건강 요약으로 — 알레르기, 복용 중인 약물, 건강 문제, 그리고 사용 가능한 경우 예방 접종, 검사 결과 및 활력 징후 — FHIR 문서 번들로 패키징되어 어느 나라에서든 읽을 수 있습니다.** 이는 HL7 FHIR [IPS 구현 가이드](https://hl7.org/fhir/uv/ips/)에 의해 정의되며 유럽 건강 데이터 공간에서 국경 간 진료에 사용됩니다. Anpheros는 FHIR R4 레코드에서 환자의 데이터를 사용하여 단 한 번의 호출 `Patient/{id}/$summary`로 IPS를 생성하며, 그 결과는 공식 HL7 검증기에서 0개의 오류로 검증됩니다.

## 섹션

<!-- visual:ips-sections -->

## 문서 빌드 방식

FHIR IPS는 `document` 유형의 `Bundle`이며, `Bundle-uv-ips` 프로파일을 따릅니다. 첫 번째 항목은 `Composition` (LOINC 60591-5 "Patient summary Document")이며, 해당 항목의 섹션들은 Bundle 내의 후속 리소스들을 참조합니다: Patient, AllergyIntolerance, MedicationStatement, Condition, Immunization, Observation 리소스, 그리고 작성자(author)와 관리자(custodian)입니다. 각 섹션에는 생성된 XHTML 내러티브가 포함되어 있어, 소프트웨어 없이도 문서를 읽을 수 있습니다.

이 발췌문은 합성 환자를 위해 플랫폼에서 생성된 실제 문서에서 가져온 것입니다 (ID는 축약됨):

```json
{
  "resourceType": "Bundle",
  "type": "document",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Bundle-uv-ips"]},
  "entry": [
    {"resource": {
      "resourceType": "Composition",
      "status": "final",
      "type": {"coding": [{"system": "http://loinc.org", "code": "60591-5", "display": "Patient summary Document"}]},
      "title": "International Patient Summary",
      "author": [{"reference": "Device/…", "display": "Anpheros Platform"}],
      "custodian": {"reference": "Organization/…", "display": "Anpheros"},
      "section": [
        {"title": "Allergies", "code": {"coding": [{"system": "http://loinc.org", "code": "48765-2"}]},
         "entry": [{"reference": "AllergyIntolerance/…"}]},
        {"title": "Medications", "code": {"coding": [{"system": "http://loinc.org", "code": "10160-0"}]},
         "entry": [{"reference": "MedicationStatement/…"}]}
      ]
    }},
    {"resource": {"resourceType": "Patient"}},
    {"resource": {"resourceType": "AllergyIntolerance"}},
    {"resource": {"resourceType": "MedicationStatement"}}
  ]
}
```

## 하나 생성하기

```bash
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" \
  -H "Authorization: Bearer $KEY" -o ips.json
```

- 필수 섹션은 비어 있지 않습니다. 기록된 내용이 없을 경우 IPS absent-or-unknown 코드로 표시되며, 애플리케이션은 명시적으로 "알려진 알레르기 없음"이라고 기록할 수 있습니다.
- 잘못된 코드가 포함된 리소스는 제외되며 응답 헤더에 보고되므로, 하나의 잘못된 레코드가 문서를 망가뜨리지 않습니다.
- `?lang=en` 또는 `?lang=ro`는 내러티브의 언어를 설정합니다.
- 액세스 권한이 없는 환자는 `404`을 반환합니다.

## 자주 묻는 질문

### 국제 환자 요약(International Patient Summary)이란 무엇인가요?
HL7에서 FHIR 문서로 표준화한, 국경을 넘어 공유될 수 있는 최소한의 전문 분야에 구애받지 않는 개인의 건강 요약(알레르기, 약물 및 문제, 예방 접종, 결과 및 활력 징후(사용 가능한 경우))입니다.

### IPS에 어떤 섹션이 필수인가요?
알레르기 및 불내증 (LOINC 48765-2), 약물 요약 (10160-0), 문제 목록 (11450-4)입니다. 예방 접종, 결과 및 활력 징후는 권장됩니다.

### FHIR 데이터에서 IPS를 어떻게 생성하나요?
환자 리소스를 수집하고, IPS 섹션 및 서술을 포함하는 Composition을 빌드한 다음, 모든 것을 문서 Bundle로 패키징합니다. Anpheros를 사용하면 이 과정이 한 번의 요청으로 처리됩니다: `GET /fhir/R4/Patient/{id}/$summary`.

### Anpheros IPS는 유효성이 검증되었나요?
네. 생성된 문서는 IPS 구현 가이드에 대해 공식 HL7 FHIR 검증 도구에서 0개의 오류로 유효성이 검증됩니다.

### 유럽에서 IPS는 무엇에 사용되나요?
European Health Data Space는 환자 요약을 유럽 형식으로 교환되어야 하는 우선 순위 범주 중 하나로 나열합니다.

<!-- visual:cta-ips -->

## 관련 자료

- [FHIR 플랫폼](https://developers.anpheros.com/ko/guides/fhir): `$summary`, `$everything` 및 26가지 리소스 유형
- [개발자를 위한 유럽 건강 데이터 공간(EHDS)](https://developers.anpheros.com/ko/guides/ehds-for-developers)
- [종단 환자 데이터 API](https://developers.anpheros.com/ko/guides/longitudinal-patient-data-api)
- [의료 데이터 상호 운용성](https://developers.anpheros.com/ko/guides/interoperability)
- [환자를 위한 국제 환자 요약(IPS)](https://anpheros.com/guides/international-patient-summary)