FHIR

FHIR 환자 리소스 설명: 식별자, 이름, 인구 통계 및 연결 정보, 유효한 예시 포함

환자(Patient)는 다른 모든 임상 리소스가 참조하는 FHIR 리소스입니다. 식별자, 이름, 성별, 생년월일, 주소, 연락처, 언어 및 연결 정보의 의미, US Core 및 IPS와 같은 국가 프로필이 이를 어떻게 제약하는지, 유효한 R4 예시, 그리고 두 시스템이 개인에 대해 동의하지 못하게 만드는 오류에 대해 설명합니다.

작성자 게시일 3분 소요

짧은 답변: Patient는 진료를 받는 사람을 설명하는 FHIR 리소스입니다. 이 리소스는 환자의 행정적인 정보(이름, 연락처, 성별, 생년월일, 주소, 결혼 상태, 언어, 주치의, 관리 조직 등)를 담고 있으며, 동일 인물에 대한 다른 Patient 레코드와의 연결 정보도 포함합니다. 환자의 건강 상태나 질병에 대한 정보는 여기에 포함되지 않습니다. 모든 Observation, Condition, Encounter, MedicationStatement는 subject 또는 patient를 통해 이 리소스를 참조합니다. 임상적인 사실은 Patient 리소스에 저장되지 않고, 이를 참조하는 리소스에 저장됩니다.

유효한 FHIR R4 예시

유효한 FHIR R4 환자 리소스는 resourceType만 있으면 되지만, 실제로는 시스템과 값을 가진 최소한 하나의 식별자, 가족 및 이름 부분을 가진 이름, 행정 성별, 생년월일이 포함됩니다. 아래 예시에서는 meta.profile에 IPS 환자 프로파일을 명시하고, 통신 정보, 주소, 선호 언어, 주치의, 관리 기관을 추가합니다.

{
  "resourceType": "Patient",
  "id": "example",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Patient-uv-ips"]},
  "identifier": [{
    "use": "usual",
    "type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0203", "code": "MR"}]},
    "system": "https://hospital.example.org/mrn",
    "value": "MRN-00012345"
  }],
  "active": true,
  "name": [{"use": "official", "family": "Doe", "given": ["Jane", "Marie"], "prefix": ["Ms"]}],
  "telecom": [{"system": "email", "value": "[email protected]", "use": "home"}],
  "gender": "female",
  "birthDate": "1980-05-23",
  "address": [{"use": "home", "line": ["12 High Street"], "city": "Leeds", "postalCode": "LS1 4AB", "country": "GB"}],
  "communication": [{"language": {"coding": [{"system": "urn:ietf:bcp:47", "code": "en-GB"}]}, "preferred": true}],
  "generalPractitioner": [{"reference": "Practitioner/gp-42"}],
  "managingOrganization": {"reference": "Organization/hospital"}
}

중요한 요소들

상호 운용성에서 가장 중요한 환자 요소는 식별자(시스템, 값, 유형 포함), 이름(사용, 가족, 이름 포함), 행정 성별, 생년월일, 사망 여부, 활성 여부, 연락처 및 연결입니다. 식별자와 이름은 시스템 간의 일치를 유도하고, 성별과 생년월일은 행정적 사실이며, 연결은 마스터 환자 색인이 한 사람의 중복 기록을 어떻게 연결했는지 기록합니다.

  • identifier: 각 항목에 system(발급 기관)과 value가 포함된 목록입니다. type은 식별자의 종류를 나타냅니다. 예를 들어, MR은 의료 기록 번호, NI는 국가 식별 번호, PPN은 여권 번호, SS는 사회 보장 번호 등 HL7 테이블 0203에서 정의된 코드입니다. 환자는 보통 여러 개의 식별자를 가지며, 병원의 의료 기록 번호와 국가 식별 번호 모두 유효하며 시스템은 이를 통해 환자를 식별합니다.
  • name: use(official, usual, nickname, maiden, old)가 포함된 목록입니다. family는 성을 나타내는 하나의 문자열이며, given은 이름을 나타내는 목록입니다. 스크립트, 음역, 이름 순서는 국가별 구현 가이드에 따라 달라집니다.
  • gender: 행정적인 성별을 나타내며, male, female, other, unknown의 네 가지 값을 가집니다. 이는 기록에 명시된 성별로, 환자 식별 및 양식 작성에 사용됩니다. 임상적인 성별, 성 정체성, 대명사는 확장 기능(extensions)이나 Observations에 기록되며, FHIR R5와 Gender Harmony 프로젝트에서 이를 공식화했습니다.
  • birthDate: 날짜 형식이며, 정확한 날짜를 알 수 없을 경우 연도만 또는 연도와 월까지만 기록할 수 있습니다. 신생아의 경우 patient-birthTime 확장 기능을 사용하여 출생 시간을 추가할 수 있습니다.
  • deceased[x]: 불리언(boolean) 또는 날짜/시간 값입니다. active가 false로 설정되면 해당 레코드는 삭제하지 않고 더 이상 사용되지 않음을 표시합니다.
  • contact: 연락할 사람(가족, 보호자 등)의 목록이며, 관계 코드가 포함됩니다. 이들은 Patient 리소스 자체가 아닙니다. 환자이기도 한 부모는 RelatedPerson으로 참조되어 두 리소스 모두를 가리킵니다.
  • link: 동일 인물에 대한 Patient 리소스들을 연결합니다. 병합 후에는 replaced-by 및 replaces를 사용하고, 권위 있는 레코드를 refer하며, 다른 시스템의 레코드를 seealso로 참조합니다. 마스터 환자 인덱스(master patient index)가 FHIR에서 결정을 표현하는 방식입니다. 환자 매칭을 참조하십시오.

국가별 프로파일이 추가하는 것

국가 및 국제 FHIR 프로파일은 느슨하게 정의된 기본 환자 리소스를 필수 요소로 만들고 국가별 확장을 추가하여 사용할 수 있도록 만듭니다. US Core는 식별자, 이름, 성별을 요구하고 인종, 민족, 출생 시 성별 확장을 추가합니다. IPS 환자 프로파일은 이름, 성별, 생년월일을 요구하며, 국가별 프로파일은 식별자 시스템과 주소 형식을 정의합니다.

기본 리소스는 거의 모든 요소를 선택 사항으로 둡니다. 프로파일은 이를 유용하게 만듭니다.

프로파일 필수 항목 추가 항목
US Core Patient (6.x) identifier, name, gender 인종, 민족, 출생 시 성별, 성 정체성을 위한 확장 기능; birthDate, address, telecom, communication에 대한 must-support
IPS Patient (uv-ips) name, gender, birthDate 국경 간 요약 정보에 포함되어야 할 항목을 표시; identifier는 권장
국가별 프로파일 (DE Basisprofil, FR, NL nl-core, UK Core…) 국가 식별자 시스템, 주소 형식 보험 번호, 이름 구성 요소, 법적 거주지 등 국가별 확장 기능

국경을 넘나드는 기록은 각 측의 프로파일을 만족해야 하며, 이는 실제적으로 국가 식별자와 의료 기록 번호, 전체 공식 이름과 완전한 생년월일을 모두 포함해야 함을 의미합니다. FHIR 구현 가이드를 참조하십시오.

사용할 수 있는 작업

환자와 함께 가장 많이 사용되는 FHIR 작업은 식별자 또는 인구 통계별 검색(GET /Patient, 식별자, 가족 또는 생년월일 매개변수 사용), 환자 및 해당 환자를 참조하는 모든 리소스를 반환하는 $everything 작업, 서버의 일치 알고리즘에 가능한 중복을 요청하는 $match입니다. FHIR R5에서는 $merge 작업이 표준화되고 있습니다.

  • GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345는 식별자로 환자를 찾습니다. ?family=doe&birthdate=1980-05-23는 인구 통계 정보로 환자를 찾습니다.
  • GET /Patient/{id}/$everything은 환자와 해당 환자를 참조하는 모든 리소스를 페이지별로 반환합니다. 전체 기록을 내보내는 방식입니다.
  • $match(지원되는 경우)는 서버의 매칭 알고리즘에 중복 가능성이 있는 환자를 요청합니다. $merge는 R5에서 표준화되고 있습니다.

환자 기록을 망치는 실수

FHIR 환자 기록을 가장 자주 손상시키는 실수는 리소스 ID에 식별자 대신 국가 ID를 저장하는 것, 다른 병원의 값이 충돌하도록 identifier.system을 생략하는 것, 가족 및 이름 부분을 없이 전체 이름을 텍스트로 넣는 것, 임상 성별 대신 행정 성별을 사용하는 것, 병합된 기록을 연결하고 비활성화하는 대신 직접 편집하는 것입니다.

  • id 필드에 국가 식별 번호를 넣는 것. 리소스 id는 서버에 속하며 가져올 때 변경될 수 있습니다. 식별자는 identifier 필드에 넣어야 합니다.
  • text 필드에 모든 정보를 넣고 family/given 필드를 사용하지 않아 성으로 검색이 실패하는 name 하나.
  • 임상적인 성별에 gender를 사용하거나, 양식에 해당 필드가 없다는 이유로 unknown으로 설정하는 것.
  • identifier.system을 누락하여 두 병원의 MRN-1 값이 충돌하는 것.
  • 병합이 발생했을 때 Patient를 직접 수정하고 비활성화하지 않는 것.

Anpheros에서

Anpheros는 Anpheros Platform에서 모든 사람, 계정 소유자 및 각 가족 프로파일을 FHIR 환자 리소스로 표현하며, 클리닉이 API를 통해 추가하는 모든 기록은 해당 환자를 참조합니다. 클리닉 식별자는 클리닉 자체 시스템을 가진 추가 식별자로 유지되며, 개인이 입력한 인구 통계 정보는 임상적으로 아무것도 추론되지 않는 행정 데이터로 유지됩니다.

클리닉에서 자체 식별자를 보낼 때, 클리닉 시스템을 가진 추가 identifier로 저장되므로 양쪽에서 동일한 사람을 찾을 수 있습니다. 개인이 앱에 입력한 인구 통계 정보는 usual 이름과 행정 데이터이며, 기록은 이로부터 임상적으로 아무것도 추론하지 않습니다.

관련 페이지

출처

자주 묻는 질문

Patient와 Person은 FHIR에서 같은 건가요?

아니요. Person은 여러 역할(여기서는 Patient, 다른 곳에서는 Practitioner, RelatedPerson 등)에서 동일한 사람을 연결하는 행정 리소스입니다. 임상 리소스는 Person이 아닌 Patient를 참조합니다.

알레르기 및 질병 정보는 어디에 저장되나요?

Patient를 참조하는 AllergyIntolerance 및 Condition 리소스에 저장됩니다. Patient 자체에는 행정 데이터만 포함됩니다.

이름이 없는 신생아는 어떻게 기록하나요?

use가 temporary이거나 비어 있는 이름, patient-birthTime 확장 기능이 있는 birthDate, 그리고 국가별 프로파일에 명시된 대로 RelatedPerson 또는 patient-mothersMaidenName 확장 기능을 통한 어머니의 기록에 대한 link를 사용하여 기록합니다.

하나의 Patient 리소스를 두 병원에서 공유할 수 있나요?

각 시스템은 자체 ID를 가진 자체 Patient 리소스를 유지합니다. 이들은 식별자(국가 식별 번호 등)를 공유하며, 레코드를 연결할 수 있습니다. 시스템 간의 매칭은 리소스 자체의 작업이 아니라 마스터 환자 인덱스의 역할입니다.

Anpheros Platform

샌드박스에서 무료로 사용해 보세요

5분 만에 첫 FHIR 호출. 환자의 동의가 내장된 HL7 FHIR R4 API: 샌드박스에서 먼저 사용해보고, 자체 앱 또는 병원 시스템을 연결하세요.

무료 · 합성 환자 30명 · 카드 불필요

이 가이드는 정보 제공 목적으로 의료 조언을 대체하지 않습니다. 건강 관련 결정은 의사와 상담하십시오. 응급 상황에서는 현지 응급 번호(유럽은 112)로 전화하세요.
작성자
Anpheros 팀

Anpheros는 환자가 직접 관리하고 어떤 병원과도 공유할 수 있는 의료 기록을 EU 기반의 HL7 FHIR R4 플랫폼에서 구축합니다. 이 가이드들은 건강 정보를 이해하고 정리하는 데 도움을 드리며, 의사의 진료를 대체하지 않습니다.

Anpheros 소개 →