FHIR-tooling landscape

FHIR — это спецификация, не реализация. Поверх неё существует экосистема инструментов: type-libraries для compile-time check, HTTP-клиенты для работы с FHIR-сервером, runtime-валидаторы, server SDKs, профайлинг-tooling. Каждый слой решает свою задачу — некоторые продукты совмещают несколько слоёв, некоторые узкоспециализированные.

Слои

                  Profiling tools (FSH, SUSHI, IG Publisher)
                                    ↓
                        Conformance resources (SDs, VSs)
                                    ↓
       ┌────────────────────────────┼────────────────────────────┐
       ↓                            ↓                            ↓
   Code generation               Runtime validators           Server SDKs
   (types, Zod, classes)         (parse + check)              (persistence + REST)
       ↓                            ↓                            ↓
   Builders / клиентский код   ←   HTTP-клиенты   →   FHIR-сервер

По функциям

Type libraries — compile-time только

Tool	Язык	Что	Maintainer
`@types/fhir`	TypeScript	Pre-generated interfaces для R2–R5 (vanilla base, без profile-awareness)	DefinitelyTyped community (GitHub `DefinitelyTyped/DefinitelyTyped`)
`@reasonhealth/fhir-ts-codegen`	TypeScript	CLI codegen для собственных IGs (FSH-package → TS interfaces + Zod schemas)	`reason-healthcare` org
`fhir-codegen` (бывший `microsoft/fhir-codegen`)	TS / C# / Python / Java / Rust / Swift	Multi-language types generator. Originally от Microsoft (Gino Canessa); ныне в HL7-`FHIR/fhir-codegen` org	FHIR org (HL7)
Firely SDK (types-portion)	C#	Pre-generated POCOs для R2–R5 + любых IGs	Firely

Подробнее — fhir-code-generation.

Runtime validators — parse + check

Tool	Язык	Что	Maintainer
`@reasonhealth/fhir-zod`	TypeScript	Pre-generated Zod schemas для R4/R4B/R5 (можно расширить своими IG’ами через codegen)	`reason-healthcare` org
HL7 FHIR Validator (CLI)	Java jar, multi-platform	Reference официальный валидатор, проверяет ресурс vs profile URL	HL7
Firely .NET SDK validator	C#	Валидация в-line C# с full SD support	Firely
HAPI FHIR Validator	Java	Validator embedded в HAPI-сервер	community + Smile CDR (originally UHN)
Inferno	Ruby	Test-suite-as-validator для HTI-1 / US Core compliance	MITRE (для ONC Health IT Certification)

HTTP-клиенты для FHIR-сервера

Tool	Язык	Что	Maintainer
`fhir-kit-client`	TypeScript	Минималистичный client (read/write/search), без types	Vermonster
Medplum SDK	TypeScript	Client + types + auth + React hooks + caching (full stack)	Medplum (open-source SaaS)
Firely .NET SDK	C#	Client + types + validator + parser	Firely
HAPI FHIR Client	Java	Annotation-driven client + builders + validation	UHN
`fhirclient.js` (SMART)	TypeScript	OAuth/SMART-launch focused (для clinical apps)	SMART Health IT
`@medplum/core`	TypeScript	Совместим с любым FHIR-сервером, не только Medplum	Medplum

Server SDKs / FHIR-серверы

Tool	Тип	Что	Maintainer
HAPI FHIR	Self-hosted Java	Полноценный FHIR-сервер, validator, client (all-in-one). Open-source, commercial backing — Smile CDR (formerly Smile Digital Health)	community + Smile CDR (originally UHN)
Medplum	Self-hosted или SaaS	TypeScript-native FHIR-сервер с дашбордом, IAM, bots	Medplum
Microsoft FHIR Server	Self-hosted .NET	Open-source FHIR-сервер от Microsoft (foundation для Azure FHIR)	Microsoft
Google Healthcare API	Managed cloud	FHIR-as-a-service на GCP — то что используем мы	Google
Azure Health Data Services FHIR	Managed cloud	FHIR-as-a-service на Azure (под капотом Microsoft FHIR Server)	Microsoft
AWS HealthLake	Managed cloud	FHIR-as-a-service на AWS	AWS
Aidbox	Self-hosted / managed	FHIR-сервер от Health Samurai (distributed team, founders из СНГ; продукт международный)	Health Samurai
Firely Server (ранее Vonk)	Self-hosted .NET	Commercial FHIR-сервер	Firely

Подробнее — google-healthcare-api для нашего конкретного выбора.

Profiling / IG-tooling

Tool	Что	Maintainer
SUSHI	FSH compiler (FSH → JSON SDs)	FHIR org (HL7, `FHIR/sushi`)
IG Publisher	Compiles IG repo → HTML site + NPM + validation pack	HL7
GoFSH	Reverse: JSON SDs → FSH (для миграции legacy IG’ов на FSH)	FHIR org (HL7)
Firely Forge	GUI editor для SDs (альтернатива FSH)	Firely
Simplifier.net	Public registry IGs + хостинг + validation	Firely

Подробнее — fsh и fhir-implementation-guide.

По стилю — pure-types vs full-stack

Подход	Когда	Tools
Pure-types только	Когда есть свой клиент / валидация / сервер, нужны только TS interfaces для compile-time	`@types/fhir`, `fhir-ts-codegen`
Types + validator	Когда вход непредсказуемый (LLM output, external API), нужен runtime gate	`@reasonhealth/fhir-zod` + types
Types + client (light)	Standard read/write/search на готовый FHIR-сервер	`fhir-kit-client` + `@types/fhir`
Full-stack (SDK)	Хочется типы + клиент + валидация + auth + dashboard в одной поставке	Medplum SDK (TS), Firely .NET SDK (C#)
Full FHIR-server in process	Хочется свой FHIR-сервер с full validation на месте, не managed cloud	HAPI FHIR, Medplum (self-hosted), Aidbox

Чем дальше вниз, тем больше lock-in и тем меньше control. Pure-types — low blast-radius (можно сменить tool); full-stack — high migration cost.

Наш текущий стек

Слой	Что используем
Types	`@types/fhir` (vanilla R4, без profile-awareness)
Validation	runtime — только сервер-side в Google Healthcare API (base R4)
HTTP-клиент	свой `fhir-client.ts` поверх REST endpoints Google Healthcare API
Builders	руками в `narrative-to-fhir/fhir-builders/.ts` + `lib/fhir--builder.ts`
Server	Google Healthcare API (managed, GCP)
Profiling	нет (vanilla R4)

Это в-целом pure-types подход + managed server. Без runtime валидации в коде; check выполняется неявно через Google Healthcare API при write. Builder-логика — наша полностью.

Когда мог бы понадобиться другой стек

fhir-zod добавится — если LLM-output structure становится более сложной и runtime garbage статистически появляется. См. fhir-code-generation и formalize-fhir-profiles.
Medplum SDK заменит свой client — если хотим React-hooks-style работу с FHIR из B2C-приложения и принимаем lock-in.
HAPI FHIR / Medplum self-hosted сервер — если выйдем за пределы GCP (например, на on-prem deployment для госпиталя или для compliance с резиденцией данных). Маловероятно в ближайшие 12 месяцев.
Inferno — если входим в US-рынок и нужно проходить ONC HTI-1 conformance tests.

Открытые вопросы

Между fhir-ts-codegen (only TS) и Microsoft fhir-codegen (multi-target) — что выбрать если планируем поддерживать и TS-pipeline и .NET-pipeline?
Когда runtime валидатор окупится — на каком объёме / сложности custom-profiles это становится net-win?
Какие части Medplum SDK можно взять без adoption Medplum server — @medplum/core standalone работает?

Связано

fhir-conformance-resources — что описывают conformance-ресурсы, на которых работает большая часть tools
fhir-code-generation — детально про codegen-слой
fsh — DSL-слой profiling-tooling
fhir-implementation-guide — IG-packaging
google-healthcare-api — наш текущий FHIR-server
formalize-fhir-profiles — наше решение, влияет на выбор tooling — draft

Quartz 4

Explorer