Uzbekistan Digital Health Platform - Integrations
0.10.0 - draft
Uzbekistan Digital Health Platform - Integrations
0.10.0 - draft
This page is part of the Uzbekistan Digital Health Platform - Integrations (v0.10.0: Releases Draft) based on FHIR (HL7® FHIR® Standard) v5.0.0. This is the current published version. For a full list of available versions, see the Directory of published versions
На этой странице представлены переводы с языка оригинала, на котором былонаписано руководство. Информацию об этих переводах и инструкции попредоставлению отзывов о переводах можно найти здесь.
Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.
На этой странице описано, как сведения реестра гепатита представляются ресурсами FHIR.
Реестр гепатита содержит сведения о пациентах, эпизодах помощи, посещениях, диагнозах, лабораторных результатах, результатах УЗИ и ответах на анкету. Данные поступают из Системы учёта и мониторинга вирусных гепатитов и добавляются в DHP в виде отдельных атомарных ресурсов FHIR. Каждый раздел содержит ссылки на профиль и примеры, а также сопоставление данных с полями FHIR. Профили гепатита наследуют UZ Core; их опубликованные ограничения являются определяющими.
Condition, EpisodeOfCare и оба профиля Observation требуют один identifier[hepatitisRegistry] с системой https://dhp.uz/fhir/core/sid/reg/uz/hepatitis и значением. Questionnaire требует хотя бы один идентификатор. QuestionnaireResponse фиксирует систему идентификатора, если элемент присутствует. Идентификатор реестра присваивается исходным реестром гепатита соответствующей записи, например диагнозу, эпизоду помощи или результату исследования. system обозначает пространство имён реестра, выдавшего идентификатор, а value содержит идентификатор записи в этом реестре, позволяя сопоставить ресурс FHIR с исходной записью. Это идентификаторы записей, отдельные от персональных идентификаторов пациента.
Эпизод помощи ссылается на пациента и диагноз. Посещение может ссылаться на эпизод, а диагноз — на посещение. Наблюдения и ответы на анкету самостоятельно указывают пациента. Примеры используют одну запись пациента, а посещение связано с эпизодом помощи.
Запись пациента содержит идентификационные, демографические и контактные данные. HepatitisPatient наследует UZ Core Patient и помечает telecom как Must Support; сама по себе эта пометка не делает поле обязательным.
Профиль: HepatitisPatient
Пример: hepatitis-patient-example
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Национальный идентификатор | - | 515050500505 |
identifier[nationalId].value |
| Внутренний паспорт | - | AB1234567 |
identifier[passportLocal].value |
| Номер медицинской карты | - | 01234567890456 |
identifier[healthCardId].value |
| ФИО | - | Xalida Yusupova Maxmudovna |
name |
| Административный пол | AdministrativeGenderVS | female |
gender |
| Дата рождения | - | 1990-02-01 |
birthDate |
| Телефон | - | 998-90-123-45-45 |
telecom.value |
EpisodeOfCare объединяет процесс оказания помощи пациенту, состоящему на учёте по поводу гепатита A, B, C или D. Ресурс связывает пациента, диагноз, ответственную организацию и координатора помощи.
Профиль: HepatitisEpisodeOfCare
Пример: hepatitis-episode-of-care-example
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор реестра | - | 75dcdd0a-5a68-4cc6-8503-5ab15a42c63b |
identifier[hepatitisRegistry].value |
| Статус | EpisodeOfCareStatus | active |
status |
| Вид услуги | EpisodeOfCareTypeVS | episode-of-care-type-cs#mserv-0001-00004 |
type[serviceType] |
| Диагноз | - | example-hepatitis-condition | diagnosis.condition.reference |
| Назначение диагноза | EncounterDiagnosisUse | encounter-diagnosis-use-cs#final |
diagnosis.use |
| Пациент | - | hepatitis-patient-example | patient |
| Ответственная организация | - | samarkand-infectious-hospital | managingOrganization |
| Координатор помощи | - | example-hepatologist-role | careManager |
| Период помощи | - | 2026-09-18T09:00:00+05:00 / 2026-11-10T17:00:00+05:00 |
period |
Пример имеет статус active; дата окончания является ожидаемой. Эпизод ссылается на диагноз острого гепатита C (B17.1).
Encounter описывает отдельное посещение. Обязательное поле subject ссылается на HepatitisPatient; поле episodeOfCare, если заполнено, ссылается на HepatitisEpisodeOfCare.
Профиль: HepatitisEncounter
Пример: hepatitis-encounter-example
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Статус посещения | EncounterStatusVS | completed |
status |
| Класс посещения | EncounterClassVS | v3-ActCode#AMB |
class |
| Вид посещения | EncounterTypeVS | encounter-type-cs#mserv-0001-00004 |
type |
| Пациент | - | hepatitis-patient-example | subject |
| Роль участника | EncounterParticipantTypeVS | v3-ParticipationType#ATND |
participant.type |
| Медицинский работник | - | example-hepatologist-role | participant.actor |
| Организация оказания помощи | - | samarkand-infectious-hospital | serviceProvider |
| Фактический период | - | 2026-09-18T09:45:00+05:00 / 2026-09-18T11:00:00+05:00 |
actualPeriod |
| Плановое начало | - | 2026-09-18T09:30:00+05:00 |
plannedStartDate |
| Эпизод помощи | - | hepatitis-episode-of-care-example | episodeOfCare |
В примере посещение связано с эпизодом помощи через episodeOfCare.
Condition содержит диагноз и клинический статус. Ресурс ссылается на HepatitisPatient и, при наличии связи с посещением, на HepatitisEncounter. Необязательное расширение outcome отражает ответ на лечение отдельно от клинического статуса.
Профиль: HepatitisCondition
Пример: example-hepatitis-condition
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор реестра | - | 69dcdd0a-5a68-4cc6-8503-5ab15a41c63b |
identifier[hepatitisRegistry].value |
| Диагноз | ConditionCodeVS | ICD-10#B17.1 |
code |
| Клинический статус | ClinicalStatusVS | condition-clinical#active |
clinicalStatus |
| Тип диагноза | DiagnosisTypeVS | diagnosis-type-cs#gencl-0001-00003 |
extension[diagnosisType] |
| Исход лечения | ConditionOutcomeCodes | SNOMED CT#1137679005 |
extension[http://hl7.org/fhir/StructureDefinition/condition-outcome].valueCodeableConcept |
| Пациент | - | hepatitis-patient-example | subject |
| Посещение | - | hepatitis-encounter-example | encounter |
| Дата регистрации | - | 2026-09-18T10:45:00+05:00 |
recordedDate |
| Медицинский работник | - | example-hepatologist-role | participant.actor |
Расширение ConditionOutcome отражает результат или последствие состояния, не подразумевая причинно-следственную связь. Его URL — http://hl7.org/fhir/StructureDefinition/condition-outcome. Каждое вхождение содержит одно значение valueCodeableConcept с привязкой уровня example к ConditionOutcomeCodes. Некоторые исходы можно оценить только после того, как состояние перестало быть активным.
Лабораторные наблюдения указывают исследование, результат, время, пациента и исполнителей. Пример содержит отрицательный результат исследования антител IgM к вирусу гепатита A.
Профиль: HepatitisObservationAnalysis
Пример: example-hepatitis-observation-analysis
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор реестра | - | 85dcdd0a-5a68-4cc6-8503-5ab15a42c63b |
identifier[hepatitisRegistry].value |
| Статус результата | ObservationStatusVS | final |
status |
| Исследование | ObservationCodesVS | LOINC#22314-9 |
code |
| Результат | v3-ObservationInterpretation | v3-ObservationInterpretation#NEG |
valueCodeableConcept |
| Пациент | - | hepatitis-patient-example | subject |
| Время наблюдения | - | 2026-09-18T10:00:00+05:00 |
effectiveDateTime |
| Исполнители | - | example-hepatologist-role, samarkand-infectious-hospital | performer |
effective[x] допускает dateTime или Period. value[x] допускает Attachment, Quantity или CodeableConcept; значения компонентов — string, CodeableConcept или Quantity. Компоненты также поддерживают dataAbsentReason и не более одного interpretation. Кодирование результата в таблице взято из примера и не является обязательным набором значений для всех результатов по гепатиту.
Каждое наблюдение УЗИ содержит кодируемую находку и логический результат. В примерах наличие цирроза и отсутствие поражения печени записаны отдельными ресурсами.
Профиль: HepatitisObservationUltraSound
Пример: example-ultrasound-cirrhosis, example-ultrasound-lesion
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор реестра | - | 85dcdd0a-5a68-4cc6-8503-5ab15a42c73b |
identifier[hepatitisRegistry].value |
| Статус результата | ObservationStatusVS | final |
status |
| Находка | HepatitisTypeOfUltraSoundVS | SNOMED CT#19943007 / SNOMED CT#300332007 |
code |
| Наличие находки | - | true / false |
valueBoolean |
| Пациент | - | hepatitis-patient-example | subject |
| Время наблюдения | - | 2026-09-18T10:30:00+05:00 |
effectiveDateTime |
| Исполнители | - | example-hepatologist-role, samarkand-infectious-hospital | performer |
code имеет обязательную привязку к HepatitisTypeOfUltraSoundVS, использующему коды SNOMED CT с локальным дополнением переводов наименований. effective[x] допускает dateTime или Period; value[x] ограничен типом boolean.
Questionnaire определяет вопросы и правила их условного отображения. Пример включает предшествующее лечение гепатита B/C, препараты и триместр беременности.
Профиль: HepatitisQuestionnaire
Пример: hepatitis-questionnaire
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор | - | HCV-HBV-QS-2026 |
identifier.value |
| Статус публикации | PublicationStatus | active |
status |
| Тип субъекта | ResourceType | Patient |
subjectType |
| Идентификатор вопроса | - | hx-tx-hcv-hbv |
item.item.linkId |
| Тип вопроса | QuestionnaireItemType | boolean, string, coding |
item.item.type |
| Условие отображения | QuestionnaireItemOperator | = / true |
item.item.enableWhen.operator / answerBoolean |
| Варианты триместра | SNOMED CT | 255246003, 255247007, 255248002 |
item.item.answerOption.valueCoding |
Канонический URL: https://dhp.uz/fhir/integrations/Questionnaire/hepatitis-questionnaire. Вопрос о препаратах отображается, когда hx-tx-hcv-hbv равен true. Варианты триместра заданы непосредственно в анкете, а не отдельным набором значений.
QuestionnaireResponse связывает заполненную анкету с её определением и пациентом. Значения linkId сохраняют иерархию анкеты и определяют вопросы, на которые даны ответы.
Профиль: HepatitisQuestionnaireResponse
Пример: example-hcv-response
| Что фиксируется | Справочник | Пример кода или значения | Где хранится |
|---|---|---|---|
| Идентификатор | - | 6f9b9d8e-3b7d-4d87-8f6e-123456789abc |
identifier.value |
| Статус ответов | QuestionnaireResponseStatus | completed |
status |
| Анкета | - | hepatitis-questionnaire | questionnaire |
| Пациент | - | hepatitis-patient-example | subject |
| Автор | - | example-hepatologist-role | author |
| Время заполнения | - | 2026-09-18T10:15:00+05:00 |
authored |
| Предшествующее лечение | - | true |
item.item.answer.valueBoolean |
| Лекарственный анамнез | - | Sofosbuvir + Daclatasvir |
item.item.answer.valueString |
| Триместр беременности | SNOMED CT | 255246003 |
item.item.answer.valueCoding |
Профиль ограничивает subject типом HepatitisPatient, author — UZCorePractitionerRole, source — UZCoreRelatedPerson, а partOf — UZCoreSocioeconomicObservation. Пример использует того же пациента и врача, что и эпизод помощи. Ответы вложены в группы (item.item.answer); профиль допускает ответы boolean, string и Coding на обоих уровнях. Названия препаратов являются примером ответа, а не рекомендацией по лечению.
PractitionerRole связывает медицинского работника с организацией. На эти ресурсы ссылаются эпизод помощи, посещение, диагноз и наблюдения.
| Ресурс | Пример | Роль |
|---|---|---|
| PractitionerRole | example-hepatologist-role | Гепатолог в организации оказания помощи |
| Practitioner | example-hepatologist | Врач, указанный в PractitionerRole |
| Organization | samarkand-infectious-hospital | Организация оказания помощи и ведения эпизода |