소개
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에서 확인할 수 있습니다.
시스템 요구사항
별도의 시스템 요구사항이 등록되지 않았습니다.


