Uzbekistan Digital Health Platform - Integrations
0.1.0 - ci-build
Uzbekistan Digital Health Platform - Integrations
0.1.0 - ci-build
Uzbekistan Digital Health Platform - Integrations - Локальная сборка (v0.1.0), построенная FHIR (HL7® FHIR® Стандартные инструменты сборки. Смотрите каталог опубликованных версий
На этой странице представлены переводы с языка оригинала, на котором былонаписано руководство. Информацию об этих переводах и инструкции попредоставлению отзывов о переводах можно найти здесь.
Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.
На этой странице описано, как данные ведения случаев туберкулёза представляются в виде ресурсов FHIR.
Модуль туберкулёза DHIS охватывает регистрацию, диагностику, лабораторное обследование и курс лечения пациентов с туберкулёзом (ТБ). Данные поступают из информационной системы туберкулёза DHIS и добавляются в DHP в виде отдельных, атомарных FHIR-ресурсов. Ресурсы соответствуют профилям DHIS, ссылки на которые приведены в каждом разделе, а в остальных случаях - UZ Core или стандартным профилям FHIR.
Везде, где у концепта есть стандартный эквивалент, ресурсы несут стандартный код напрямую - SNOMED CT для диагнозов, типов образцов, идентифицированных видов и стадий обработки, LOINC для диагностических тестов и препаратов для определения лекарственной чувствительности. Исходная система записывает эти данные собственными локальными кодами; каждый локальный код сохраняется в своей CodeSystem DHIS и сопоставляется с ближайшим стандартным концептом с помощью ConceptMap, так что интегратор всегда может найти стандартный код для имеющегося у него кода. В ресурсах используйте стандартный код везде, где существует точное соответствие (equivalent) - справочник, привязанный к каждому полю, предлагает стандартный код для таких концептов и сохраняет локальный код только там, где точного стандартного эквивалента нет (например, варианты питательных сред, степени мазка/посева и диапазоны лекарственной чувствительности). В каждом разделе ниже приведены управляющий профиль, конкретный пример ресурса и таблица со справочником и примером кода для каждого поля, несущего код.
Типичная запись связывает воедино: пациента, один или несколько диагнозов ТБ, эпизод оказания помощи, группирующий курс лечения, собранные образцы и результаты диагностических тестов, полученные на их основе.
Субъект каждой записи о ТБ. Специфичного для DHIS профиля Patient нет; используйте UZ Core напрямую.
Профиль: UZCorePatient
Пример: example-patient-john
| Записываемая информация | Где хранится |
|---|---|
| Национальный идентификатор | identifier (срез национального идентификатора) |
| Имя, пол, дата рождения | name, gender, birthDate |
| Адрес | address (срез адреса UZ) |
| Ответственное учреждение | managingOrganization → Organization |
Установите Condition.code в диагноз ТБ (или соответствующую сопутствующую патологию). Большинство диагнозов используют SNOMED CT напрямую; немногие, не имеющие соответствия 1:1 в SNOMED CT, используют локальные коды.
Профиль: DHISCondition
Пример: example-tbc-diagnosis
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Диагноз | DHISConditionCodeVS | SNOMED CT#88356006 (Primary tuberculous complex) |
Condition.code |
| Клинический статус | condition-clinical | condition-clinical#active (Active) |
clinicalStatus |
| Статус верификации | condition-ver-status | condition-ver-status#confirmed (Confirmed) |
verificationStatus |
| Категория | condition-category | condition-category#encounter-diagnosis (Encounter Diagnosis) |
category |
| Когда началось | - | 2025-06-03 |
onsetDateTime |
| Субъект | - | ссылка на Patient | subject |
Используйте код SNOMED CT везде, где существует точное соответствие; лишь немногие диагнозы без соответствия 1:1 в SNOMED CT (например, фиброзно-кавернозный туберкулёз и сопутствующие патологии, не связанные с ТБ) сохраняют локальный код. ConceptMap tuberculosis-to-snomed сопоставляет каждый диагностический код DHIS с его концептом SNOMED CT, так что интегратор может найти стандартный код для любого имеющегося у него локального кода.
Эпизод оказания помощи группирует диагноз ТБ пациента, лечение и наблюдение на протяжении всего курса оказания помощи и указывает куратора случая.
Профиль: DHISEpisodeOfCare
Пример: example-dhis-episode-of-care
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Тип эпизода | episode-of-care-type-cs | episode-of-care-type-cs#mserv-0001-00004 (Treatment services) |
type |
| Статус | EpisodeOfCareStatus | active |
status |
| Период оказания помощи | - | 2025-03-12 - 2025-09-12 |
period.start / period.end |
| Диагноз, по которому проводится лечение | - | ссылка на DHISCondition | diagnosis.condition |
| Пациент | - | ссылка на Patient | patient |
| Куратор случая | - | ссылка на PractitionerRole | careManager |
Каждый образец, собранный для лабораторного исследования. Specimen.type записывает, какого рода это образец; Specimen.feature.type записывает его состояние обработки (первичный образец, осадок, изолят культуры).
Профиль: DHISSpecimen
Пример: example-dhis-specimen
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Тип образца | SpecimenTypeVS | SNOMED CT#119334006 (Sputum specimen) |
Specimen.type |
| Состояние обработки | SpecimenFeatureTypeVS | specimen-feature-type-cs#Spec002-0001 (Primary sample) |
feature.type |
| Статус | specimen-status | available |
status |
| Субъект | - | ссылка на Patient | subject |
| Производный от | - | ссылка на родительский Specimen | parent |
Используйте код SNOMED CT везде, где существует точное соответствие; лишь группировки участков и питательные среды без соответствия 1:1 в SNOMED CT сохраняют локальный код. ConceptMap specimen-type-conceptmap сопоставляет каждый тип образца DHIS с его концептом SNOMED CT, а ConceptMap specimen-feature-type-to-snomed делает то же самое для стадий обработки (изолят культуры использует код SNOMED CT; первичный образец и осадок сохраняют локальный код).
Каждый лабораторный результат или результат визуализации - это отдельное Observation. Во всех четырёх профилях ниже Observation.code идентифицирует тест и берётся из DHISObservationCodeVS - LOINC, где существует точный код, иначе локальный код для вариантов питательных сред и анализов. ConceptMap observation-tuberculosis-code сопоставляет каждый код теста DHIS с его концептом LOINC. Различается то, как переносится результат:
POS/NEG),Выберите профиль, соответствующий тесту:
| Тест | Профиль | Как переносится результат |
|---|---|---|
| Микроскопия мазка мокроты | DHISObservationMicroscopy | кодированная степень КУБ в компоненте |
| Посев, идентификация видов, тестирование лекарственной чувствительности (ТЛЧ), линейный зондовый анализ | DHISObservation | кодированное значение и/или компоненты по каждому препарату |
| Рентгенография грудной клетки | DHISObservationXray | boolean (находка присутствует/отсутствует) |
| Тест на ВИЧ | DHISObservationHIV | boolean |
Записывает нагрузку кислотоустойчивых бактерий (КУБ), обнаруженную в окрашенном мазке. Степень хранится в компоненте.
Профиль: DHISObservationMicroscopy
Пример: example-microscopy
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | DHISObservationCodeVS | LOINC#53904-9 (Sputum smear microscopy, fluorescent) |
Observation.code |
| Что сообщает компонент | DHISObservationComponentCodeVS | dhis-observation-component-code-cs#Tub004-0032 (Grading) |
component.code |
| Степень КУБ | DHISObservationCodeableConceptVS | dhis-observation-codeable-concept-cs#Tub003-0008 (3+ / 40 fields) |
component.valueCodeableConcept |
| Исследованный образец | - | ссылка на DHISSpecimen | specimen |
Охватывает посев на плотных/жидких средах, идентификацию видов и тестирование лекарственной чувствительности (ТЛЧ), включая линейные зондовые анализы. Общий результат помещается в valueCodeableConcept; в панели ТЛЧ каждый препарат - это компонент, код которого - это препарат, а значение - это результат чувствительности.
Профиль: DHISObservation
Пример: example-tb-microscopy
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | DHISObservationCodeVS | dhis-observation-code-cs#Tub002-0007 (Phenotypic DST on MGIT) |
Observation.code |
| Общий результат | DHISObservationCodeableConceptVS | SNOMED CT#113858008 (M. tuberculosis complex) |
valueCodeableConcept |
| Тестируемый препарат (ТЛЧ) | DHISObservationComponentCodeVS | dhis-observation-component-code-cs#Tub004-0008 (Isoniazid 0.1 mg/mL) |
component.code |
| Результат чувствительности | DHISObservationCodeableConceptVS | v3-ObservationInterpretation#R (Resistant) |
component.valueCodeableConcept |
| Исследованный образец | - | ссылка на DHISSpecimen | specimen |
Идентифицированные виды и квалификаторы следов и идентификации используют свой код SNOMED CT напрямую; ConceptMap dhis-observation-result-to-snomed фиксирует код результата DHIS, который каждый из них заменяет, тогда как степени мазка/посева и результаты диапазонов устойчивости без стандартного эквивалента сохраняют локальный код.
Для компонентов ТЛЧ агенты с простым названием препарата используют код LOINC <drug> [Susceptibility] напрямую; агенты, несущие концентрацию, сохраняют локальный код (критическая концентрация, которую отбрасывает стандартный код). ConceptMap dhis-observation-component-to-loinc сопоставляет каждый препарат DHIS с его концептом LOINC.
Записывает, была ли обнаружена связанная с ТБ находка на рентгенограмме грудной клетки.
Профиль: DHISObservationXray
Пример: example-observation-xray
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | DHISObservationCodeVS | LOINC#30745-4 (Chest X-ray) |
Observation.code |
| Находка присутствует | - | false |
Observation.value (boolean) |
Записывает результат теста на ВИЧ, выполненного в рамках скрининга на ко-инфекцию ТБ/ВИЧ.
Профиль: DHISObservationHIV
Пример: example-obs-hiv
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | DHISObservationCodeVS | LOINC#56888-1 (HIV testing) |
Observation.code |
| Результат | - | true |
Observation.value (boolean) |
Госпитализация для лечения ТБ. Специфичного для DHIS профиля Encounter нет; используйте UZ Core напрямую. diagnosis.condition связывает госпитализацию с диагнозом ТБ.
Профиль: UZCoreEncounter
Пример: example-dhis-encounter
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Класс | v3-ActCode | v3-ActCode#IMP (inpatient encounter) |
class |
| Статус | EncounterStatus | completed |
status |
| Период госпитализации | - | 2026-02-12 - 2026-02-18 |
actualPeriod |
| Диагноз | - | ссылка на DHISCondition | diagnosis.condition |
| Роль диагноза | encounter-diagnosis-use | encounter-diagnosis-use#final (Final) |
diagnosis.use |
На эти ресурсы ссылаются записи выше, и они используют профили UZ Core напрямую.
| Ресурс | Профиль | Пример | Роль |
|---|---|---|---|
| Organization | UZCoreOrganization | example-organization | Учреждение, проводящее лечение ТБ |
| Practitioner | UZCorePractitioner | example-practitioner | Клиницист, участвующий в оказании помощи |
| PractitionerRole | UZCorePractitionerRole | practitionerrole-001 | Связывает клинициста с учреждением |