본문으로 건너뛰기
로그인 둘러보기
개발·코딩·데이터베이스 · 윈도우즈 유틸

RH – FHIR CLI

0

Rust Health (rh)는 FHIR 기반 의료 상호운용성과 AI 에이전트 워크플로를 위한 현대적인 고성능 툴킷입니다.

의료패키지 관리

소개

Rust Health (rh)는 FHIR 기반 의료 상호운용성과 AI 에이전트 워크플로를 위한 현대적인 고성능 툴킷입니다. Rust로 구축된 이 도구는 FHIRPath, FHIR Shorthand(FSH), CQL, VCL, 검증, 패키지 관리, 코드 생성 기능을 제공하여 의료 데이터 작업을 자동화하고 스크립트 및 에이전트에서 신뢰성 있게 사용할 수 있도록 설계되었습니다. ReasonHealth에서 개발한 이 크로스플랫폼 CLI는 명령줄에서 구조화된 출력을 생성하며, CI/CD 파이프라인 및 에이전트 지원 개발에 적합합니다.

상세정보

FHIRPath 처리

rh는 FHIRPath 표현식 파싱 및 평가를 지원합니다. rh fhirpath eval "Patient.name.given" -d patient.json 명령으로 FHIR 데이터에 대해 FHIRPath 표현식을 평가할 수 있으며, rh fhirpath repl로 대화형 REPL을 실행할 수 있습니다.

FHIR Shorthand(FSH) 컴파일

FSH 소스를 FHIR JSON으로 컴파일할 수 있습니다. rh fsh compile myprofile.fsh --output output/ 명령으로 프로파일을 컴파일하고 결과를 지정된 디렉터리에 저장할 수 있습니다.

CQL 컴파일 및 평가

CQL을 ELM JSON으로 컴파일하고 평가할 수 있습니다. rh cql compile measure.cql 명령으로 CQL 파일을 컴파일할 수 있습니다.

VCL 번역

ValueSet Compose Language(VCL) 표현식을 FHIR ValueSet.compose로 번역할 수 있습니다. rh vcl translate "http://loinc.org|718-7*" 명령으로 VCL 표현식을 처리할 수 있습니다.

FHIR 리소스 검증

FHIR 리소스의 구조적, 프로파일, 불변, 용어법 및 QuestionnaireResponse 검증을 수행할 수 있습니다. rh validate resource --input patient.json 명령으로 리소스를 검증하고, --report-format operationoutcome 옵션으로 FHIR OperationOutcome 형식의 검증 보고서를 생성할 수 있습니다.

StructureDefinition 스냅샷 생성

FHIR StructureDefinition의 스냅샷을 생성할 수 있습니다. rh snapshot generate http://hl7.org/fhir/StructureDefinition/Patient 명령으로 Patient 프로파일의 스냅샷을 생성할 수 있습니다.

FHIR 패키지 관리

FHIR 패키지의 초기화, 빌드, 패킹을 지원합니다. rh package init --canonical https://example.org/fhir my-package/로 패키지를 초기화하고, rh package build my-package/로 빌드하며, rh package pack my-package/output/로 최종 패키지를 생성할 수 있습니다.

다운로드·설치 방법

Windows에서는 Chocolatey를 통해 rh를 설치할 수 있습니다. 관리자 권한으로 PowerShell 또는 CMD를 열고 choco install rh 명령을 실행하면 됩니다. 또한 GitHub 릴리스 페이지에서 사전 빌드된 바이너리를 다운로드하거나, Cargo를 통해 cargo install rh-cli로 설치할 수 있습니다. Docker를 사용하는 경우 docker pull ghcr.io/reason-healthcare/rh:latest 명령으로 이미지를 받을 수 있습니다.

기본 사용법/명령어

설치 후 rh --help로 전체 명령 목록을 확인할 수 있습니다. 모든 명령은 --format human|json|ndjson 옵션을 지원하며, 스크립트 및 자동화를 위해서는 --format json을 사용하는 것이 권장됩니다. 예를 들어 rh download package hl7.fhir.r4.core 4.0.1로 FHIR 패키지를 다운로드하고, rh fhirpath eval "Patient.name.given" -d patient.json로 특정 데이터에 대해 FHIRPath 표현식을 평가할 수 있습니다. 종료 코드는 다음과 같습니다: 0(성공), 1(입출력/네트워크 오류), 2(인수 파싱 오류), 3(검증 실패), 4(FHIRPath/CQL/FSH/VCL 파싱 오류).

이런 경우에 유용합니다

의료 인터operability 작업을 자동화하는 개발자 및 DevOps 엔지니어에게 유용합니다. 특히 FHIR 리소스 검증, 프로파일 생성, CQL 기반 품질 측정 계산, FHIR 패키지 관리를 스크립트 또는 CI/CD 파이프라인에 통합해야 하는 상황에서 구조화된 JSON 출력을 생성하여 에이전트 및 자동화 워크플로에서 신뢰성 있게 사용할 수 있습니다.

지원 환경·시스템 요구사항

증거에서 특정 운영 체제 버전이나 하드웨어 요구사항에 대한 명시적인 정보는 제공되지 않았습니다. 다만 크로스플랫폼 도구로 Windows, macOS, Linux에서 사용 가능하며, Chocolatey, Homebrew, 설치 스크립트, Docker, Cargo를 통해 설치할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.2.0이며, 자세한 변경 내역은 CHANGELOG.md에서 확인할 수 있습니다.

시스템 요구사항

별도의 시스템 요구사항이 등록되지 않았습니다.