개발자를 위한

백엔드로서의 FHIR 플랫폼: FHIR 백엔드 서비스가 제공하는 것과 제공하지 않는 것

FHIR 플랫폼은 FHIR 서버 그 이상입니다. 관리형 FHIR 백엔드에 포함되어야 하는 것(동의, 출처, 쌍별 ID, 웹훅, EU 거주), Anpheros Platform이 어떻게 구축되는지, 그리고 언제 직접 서버를 운영해야 하는지에 대한 내용입니다.

작성자 게시일 2분 소요

FHIR 서버는 FHIR 리소스를 저장하고 제공합니다. FHIR 플랫폼은 실제로 건강 제품을 출시하는 데 필요한 것으로, 서버와 함께 ID, 동의, 출처, 고객 간 격리, 웹훅, 문서, 용어 등이 포함되며 GDPR 하에서 이를 운영하는 사람이 필요합니다. 이 가이드에서는 그 차이점을 설명하고 Anpheros 플랫폼이 각 부분을 어떻게 채우는지 설명하여, 플랫폼 위에서 구축할지 자체적으로 운영할지 결정하는 데 도움을 드립니다.

개발자를 위한 기술 버전: Healthcare API 플랫폼 · FHIR 서버 비교 (developers.anpheros.com에서 요청, 응답 및 제한 사항 포함). 이 페이지는 일반 언어 버전입니다.

서버 대 플랫폼

오픈 소스 FHIR 서버(예: HAPI)는 FHIR 부분, 즉 리소스, 검색, 유효성 검사, 기록에 탁월합니다. 하지만 그 주변의 모든 것은 사용자가 직접 처리해야 합니다.

필요 사항 FHIR 서버 FHIR 플랫폼
리소스 저장, 검색, 기록 예 예
누가 어떤 환자 정보를 읽을 수 있는지 직접 코드 작성 동의 기능 내장
누가 각 값을 작성했는지 직접 코드 작성 모든 쓰기에 출처 기록
단일 시스템에서 여러 고객 직접 코드 작성 프로젝트 격리, 쌍별 ID
환자 대상 동의 화면 직접 코드 작성 OAuth 2.1 + SMART on FHIR
앱으로의 알림 폴링 방식 서명된 웹훅
현실적인 테스트 데이터 직접 설정 샌드박스당 30명의 합성 환자
호스팅, 백업, GDPR, DPA 직접 운영팀 포함됨

운영팀, 규정 준수 담당자, 그리고 6개월의 시간이 있다면 자체 서버를 운영하는 것도 좋은 선택입니다. 하지만 제품을 출시해야 한다면 플랫폼을 사용하는 것이 더 빠릅니다.

Anpheros 플랫폼 구축 방식

환자당 하나의 FHIR R4 레코드. 26가지 리소스 유형으로, LOINC, ICD-10 및 ATC로 코딩되며 쓰기 시 유효성이 검사됩니다. 엄격한 FHIR API는 /fhir/R4에 있으며, /fhir/R4/metadata에 CapabilityStatement가 있습니다. /v1의 일반 REST API는 동일한 ID로 동일한 데이터를 제공합니다.

프로젝트 격리 및 쌍별 ID. 프로젝트(API 키)는 자신이 생성한 환자 정보만 볼 수 있습니다. 각 프로젝트는 동일한 사람에 대해 자체 ID를 받으며, 내부 ID는 플랫폼 외부로 나가지 않습니다. 범위 외부의 환자에 대한 참조는 프로젝트별 불투명 토큰으로 마스킹됩니다.

동의는 읽기를 결정하고, 소유권은 쓰기를 결정합니다. 환자의 동의가 있으면 조직은 다른 병원에서 작성한 정보까지 포함하여 전체 기록을 볼 수 있지만, 자신이 작성한 것만 변경하거나 삭제할 수 있습니다. 모든 리소스의 각 버전은 작성한 프로젝트를 기록하며, 다른 프로젝트의 쓰기는 설명과 함께 거부됩니다.

모든 쓰기에 대한 출처 및 감사. Provenance.agent.onBehalfOf는 작성 시점의 병원 또는 조직 이름을 명시하며, 감사 행은 누가, 무엇을, 언제, 어떤 권한으로, 어떤 애플리케이션에서 작성했는지 기록합니다. 환자는 FHIR AuditEvent 리소스로 자신의 액세스 로그를 읽을 수 있습니다.

가볍고 서명된 웹훅. 이벤트는 ID와 버전을 전달하며, 임상 콘텐츠는 포함하지 않습니다. 리소스는 API를 통해 읽습니다. 전송은 HMAC-SHA256으로 서명되며 최대 24시간 동안 재시도됩니다.

샌드박스와 프로덕션은 별도의 데이터베이스입니다. sk_test_ 키는 실제 환자 정보에 접근할 수 없습니다. 샌드박스는 무료이며 셀프 서비스로 이용 가능합니다.

EU 거주. europe-west4의 Cloud Run에서 운영되며, 프로덕션 조직을 위한 데이터 처리 계약이 포함됩니다.

의도적으로 포함되지 않은 것들

  • 임상 의사 결정 지원 기능 없음. 플랫폼은 저장, 코딩 및 공유를 담당하며, 진단이나 치료 권장 사항을 제공하지 않습니다.
  • 상호 작용이 포함된 완전한 약물 데이터베이스 없음. 약물은 ATC로 코딩되며, ATC 및 LOINC의 번들 하위 집합을 조회할 수 있지만, 상호 작용 확인은 사용자의 구성 요소 또는 라이선스 서비스에 의해 처리됩니다.
  • 병원 등급의 HL7 v2 메시징 버스 없음. 검사 보고서를 위한 HL7 v2 ORU^R01 가져오기는 가능하지만, ADT 또는 주문 관리는 지원하지 않습니다.

이러한 제한 사항을 미리 알면 1주의 시간을 절약할 수 있습니다.

자체 서버를 대신 실행해야 하는 경우

  • 외부 프로세서 없이 자체 병원 네트워크 내에서 호스팅해야 하는 경우.
  • 플랫폼에서 구현되지 않은 FHIR R5 또는 프로필이 필요한 경우.
  • 제품 자체가 FHIR 서버인 경우.

그 외의 모든 경우에는 샌드박스에서 시작하여 측정하고 데이터를 기반으로 결정하십시오. 첫 시간 사용법은 developers.anpheros.com/guides/first-hour에서 설명하며, 전체 API 참조는 platform.anpheros.com/docs에서 확인할 수 있습니다.

자주 묻는 질문

Anpheros는 FHIR 서버인가요?

FHIR 서버 기능을 포함하고 있습니다. 26가지 리소스 유형, 검색, 기록, $everything, $summary, $validate 및 용어 작업을 지원하는 FHIR R4 API가 있습니다. 이 외에도 동의, 출처, 격리, 웹훅 및 호스팅 기능이 통합되어 있어 플랫폼으로 작동합니다.

어떤 FHIR 버전인가요?

FHIR R4 (4.0.1) 버전입니다. EU 및 미국 규정에서 요구하며 대부분의 시스템에서 구현된 버전입니다. Inferno로 적합성을 확인했으며, IPS 적합성 참고 자료를 참조하십시오.

여러 병원에서 환자의 기록을 공유할 수 있나요?

네, 그것이 핵심입니다. 환자의 동의 하에 각 병원은 전체 기록을 읽고 자신의 리소스를 작성하며, 각 리소스는 해당 출처 정보와 함께 표시됩니다. 어떤 병원도 다른 병원에서 작성한 내용을 변경할 수 없습니다.

개발을 위한 무료 FHIR 백엔드가 있나요?

네. 샌드박스는 무료이며 셀프 서비스로 이용 가능하며, 프로젝트당 30명의 합성 환자를 제공합니다. 무료 FHIR 서버: 샌드박스를 참조하십시오.

필요시 어떻게 마이그레이션할 수 있나요?

모든 것이 FHIR R4이며 내보내기 가능합니다. Patient/{id}/$everything은 환자의 전체 기록을 Bundle로 반환합니다. 해독해야 할 독점적인 형식은 없습니다.

이 가이드는 정보 제공 목적으로 의료 조언을 대체하지 않습니다. 건강 관련 결정은 의사와 상담하십시오. 응급 상황 시 112로 전화하십시오.
저자 소개
Adrian Kereky

Founder of Anpheros. An electronics engineer, he spent six years in autonomous driving, on automotive projects run in partnership with Samsung and NVIDIA, designing the architecture of driver-assistance and AI systems that run on NVIDIA chips with CUDA. He then built Anpheros: the patient-controlled medical record and the HL7 FHIR R4 platform it runs on.

Anpheros 및 저자에 대해 더 알아보기 →

건강 기록을 항상 소지하세요

Anpheros Daily는 증상, 검사 결과, 복용 중인 약 및 문서를 표준 형식으로 한곳에 모아 관리합니다. 기본 플랜은 무료입니다.

Anpheros Daily 시작하기