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.
Скрининг рака шейки матки и молочной железы охватывает лабораторные результаты, данные визуализации, патоморфологические заключения, ответы на опросники и клинические наблюдения, полученные в рамках программы скрининга. Данные поступают из системы Cervical Cancer Screening Quality Assessment and Monitoring and Early Breast Cancer Detection Information System и добавляются в DHP в виде отдельных, атомарных FHIR-ресурсов. Ресурсы соответствуют профилям скрининга, ссылки на которые приведены в каждом разделе, где они доступны, а в остальных случаях - UZ Core или стандартным профилям FHIR.
В каждом разделе указан справочник для использования, пример кода, управляющий профиль и конкретный пример ресурса. Рост, вес и ИМТ используют стандартные профили витальных показателей FHIR.
Кодируемые значения используют SNOMED CT или LOINC везде, где существует эквивалентное понятие. Локальные коды остаются только там, где стандартного понятия нет; они публикуются в CodeSystem screening-*-cs с обозначениями на узбекском, русском и английском языках.
Тип программы скрининга. Второй identifier, система https://dhp.uz/fhir/core/sid/prg/uz/program, указывающий код SNOMED CT программы скрининга, к которой относится ресурс, - например, 171149006 (скрининг шейки матки) или 268547008 (скрининг рака молочной железы). По соглашению указывается в Observation, DiagnosticReport, ServiceRequest, Condition, Consent, Specimen, Composition, а также в Questionnaire/QuestionnaireResponse, если опросник целиком относится к одной программе, - но не в Patient, Practitioner или PractitionerRole, которые являются общими для обеих программ. Опросник Осмотр женщины и ответ на него содержат оба кода программы, так как опросник охватывает обе программы.
Система-источник. meta.source указывает, какая система создала ресурс: https://dhp.uz/fhir/source/screening (данная информационная система скрининга рака шейки матки и молочной железы) либо https://dhp.uz/fhir/source/dmed (ДМЕД). Обязательное поле, проверяется инвариантом в профилях ScreeningObservation, ScreeningServiceRequest, ScreeningDiagnosticReport, ScreeningDocumentReference и ScreeningComposition. Не пытайтесь определить систему-источник по наличию идентификатора из системы https://dhp.uz/fhir/core/sid/doc/uz/screening - эта система идентификаторов не указывает, какая система создала ресурс.
Установите ServiceRequest.code в назначаемый тест или процедуру.
Профиль: ScreeningServiceRequest
Примеры: ServiceRequest-cytology, ServiceRequest-hpv, ServiceRequest-colposcopy, ServiceRequest-mammography
| Что назначается | Справочник | Пример кода |
|---|---|---|
| Цитологический мазок | ScreeningLaboratoryVS | LOINC#18500-9 |
| Тест на ВПЧ | ScreeningLaboratoryVS | LOINC#82675-0 |
| Кольпоскопия | ScreeningDiagnosticProcedureVS | SNOMED CT#392003006 |
| Маммография | ScreeningDiagnosticProcedureVS | SNOMED CT#71651007 |
Установите DiagnosticReport.code в процедуру (те же коды, что и в направлении). Отчёт о маммографии может также содержать общее заключение в conclusionCode. Отчёт по патоморфологии переносит историю специального лечения через supportingInfo, а не через направление.
Профиль: ScreeningDiagnosticReport
Примеры: DiagnosticReport-cytology, DiagnosticReport-colposcopy, DiagnosticReport-mammography, DiagnosticReport-breast-pathology
| Записываемая информация | Справочник | Пример кода |
|---|---|---|
| Тип отчёта | ScreeningLaboratoryVS / ScreeningDiagnosticProcedureVS | LOINC#18500-9 (цитология)SNOMED CT#392003006 (кольпоскопия)SNOMED CT#71651007 (маммография) |
| Общее заключение BI-RADS (маммография) | ScreeningBiradsVS | screening-birads-cs#src-birads-2 (BI-RADS 2) |
| Дополнительная клиническая информация (патоморфология) | supportingInfo.type из http://terminology.hl7.org/CodeSystem/v2-0936 |
v2-0936#SCI (Supporting Clinical Information) → Observation по профилю ScreeningSpecialTreatmentObservation |
Записывает степень цитологического мазка.
Профиль: ScreeningObservation
Пример: cytology-result (вариант с ИИ: cytology-ai-analysis, результат которого хранится в виде свободного текста в Observation.value)
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | ScreeningLaboratoryVS | LOINC#18500-9 (цитологический мазок) |
Observation.code |
| Степень цитологии | ScreeningCervicalCytologyVS | screening-cervical-cytology-cs#scr-cyt-3 (LSIL) |
Observation.value |
Записывает результат ДНК ВПЧ высокого риска.
Профиль: ScreeningObservation
Пример: hpv-result
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код теста | ScreeningLaboratoryVS | LOINC#82675-0 (тест на ВПЧ) |
Observation.code |
| Результат ВПЧ | ScreeningHPVVS | screening-hpv-cs#scr-hpv-3 (Positive) |
Observation.value |
Записывает заключение кольпоскопии и зону трансформации шейки матки.
Профиль: ScreeningObservation
Пример: colposcopy-result
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код процедуры | ScreeningDiagnosticProcedureVS | SNOMED CT#392003006 (кольпоскопия) |
Observation.code |
| Заключение кольпоскопии | ScreeningColposcopyVS | screening-colposcopy-cs#scr-colpo-2 (LSIL) |
Observation.value |
| Тип зоны трансформации | ScreeningTransformationZoneVS | screening-transformation-zone-cs#scr-tz-2 (Type 2) |
component (код SNOMED CT#1285652007) |
Структурированная оценка маммографии. Код процедуры SNOMED CT#71651007 (Маммография) идентифицирует наблюдение; каждое измерение ниже записывается как компонент.
Профиль: ScreeningMammographyObservation
Примеры: ScreeningMammographyObservationExample, mammography-summary
| Записываемая информация | Справочник | Пример кода | Где хранится (код компонента) |
|---|---|---|---|
| Категория BI-RADS | ScreeningBiradsVS | screening-birads-cs#src-birads-2 (BI-RADS 2) |
SNOMED CT#1348266008 |
| Плотность молочной железы | ScreeningBreastFormVS | screening-breast-form-cs#src-breast-density-4 (тип D) |
SNOMED CT#129793001 |
| Качество снимка | ScreeningImageQualityVS | screening-image-quality-cs#src-img-quality-3 (умеренное) |
SNOMED CT#246646005 |
| Номер чтения (1-3) | - | 2 |
screening-specialized-observation-parameter-cs#scrn-0073-00026 |
| Выбрано как консенсусный результат | - | true |
screening-specialized-observation-parameter-cs#scrn-0073-00027 |
| Результат третьего, арбитражного чтения | - | true |
screening-specialized-observation-parameter-cs#scrn-0073-00028 |
Двойное чтение моделируется как отдельное Observation на каждое чтение, каждое со своим номером чтения. Чтение, выбранное как окончательное, устанавливает признак консенсуса; третье, арбитражное чтение вместо этого устанавливает признак арбитража.
Для каждой находки, выявленной на маммографии, записывается, что это, в какой молочной железе и квадранте и что она присутствует. code наблюдения - это SNOMED CT#71651007 (Маммография).
Профиль: ScreeningObservation
Примеры: mammography-right-breast-finding, mammography-left-breast-finding
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
Находка (присутствует = true) |
ScreeningBreastFindingVS | SNOMED CT#400096001 (меланоцитарный невус)SNOMED CT#17417006 (утолщение кожи) |
component.code (значение = boolean) |
| Молочная железа | ScreeningBodySiteVS | SNOMED CT#73056007 (Right)SNOMED CT#80248007 (Left) |
Observation.bodySite |
| Квадрант | ScreeningBreastQuadrantVS | screening-breast-quadrant-cs#src-breast-quadrant-2 (UE)screening-breast-quadrant-cs#src-breast-quadrant-1 (UI) |
расширение квадранта в bodySite |
Структурированное ультразвуковое исследование молочных желёз. Observation.code - это SNOMED CT#47079000 (УЗИ молочной железы), а bodySite фиксирует исследуемую сторону. Параметры всей железы и характеристики очагового образования записываются как компоненты.
Профиль: ScreeningBreastUltrasoundObservation
Пример: ScreeningBreastUltrasoundObservationExample
| Записываемая информация | Справочник | Где хранится (код компонента) |
|---|---|---|
| Исследуемая сторона | ScreeningUltrasoundBreastSideVS | Observation.bodySite |
| Симметричность молочных желёз | ScreeningUltrasoundBreastSymmetryVS | screening-ultrasound-parameter-cs#scrn-0052-00004 |
| Состав по ACR | ScreeningUltrasoundAcrCompositionVS | screening-ultrasound-parameter-cs#scrn-0052-00005 |
| Состояние кожи и соска | ScreeningUltrasoundSkinNippleStatusVS | screening-ultrasound-parameter-cs#scrn-0052-00006 |
| Состояние протоков | ScreeningUltrasoundDuctStatusVS | screening-ultrasound-parameter-cs#scrn-0052-00012 |
| Состояние подмышечных лимфоузлов | ScreeningUltrasoundAxillaryNodeStatusVS | screening-ultrasound-parameter-cs#scrn-0052-00017 |
| Форма очагового образования | ScreeningUltrasoundLesionShapeVS | screening-ultrasound-parameter-cs#scrn-0052-00027 |
| Ориентация очагового образования | ScreeningUltrasoundLesionOrientationVS | screening-ultrasound-parameter-cs#scrn-0052-00028 |
| Контур очагового образования | ScreeningUltrasoundLesionContourVS | screening-ultrasound-parameter-cs#scrn-0052-00029 |
| Эхогенность очагового образования | ScreeningUltrasoundLesionEchogenicityVS | screening-ultrasound-parameter-cs#scrn-0052-00030 |
| Размер, положение и расстояние от соска | - | от scrn-0052-00022 до scrn-0052-00026 |
Полный перечень параметров приведён на странице профиля; каждый кодируемый параметр имеет собственный справочник в составе ScreeningUltrasoundParameterVS.
Заявка на гистологическое, цитологическое или иммуногистохимическое исследование. code фиксирован как SNOMED CT#714797009 (Гистологическое исследование); то, что фактически направлено в лабораторию, передаётся в orderDetail.parameter.
Профиль: ScreeningPathologyServiceRequest
Пример: ScreeningPathologyRequestExample
| Параметр | Справочник | Код параметра |
|---|---|---|
| Класс материала | ScreeningBreastMaterialClassVS | screening-histology-order-parameter-cs#scrn-0069-00001 |
| Подтип биопсии | ScreeningBreastBiopsySubtypeVS | screening-histology-order-parameter-cs#scrn-0069-00002 |
| Тип хирургической операции | ScreeningBreastSurgicalProcedureTypeVS | screening-histology-order-parameter-cs#scrn-0069-00003 |
| Тип цитологического материала молочной железы | ScreeningBreastCytologyMaterialTypeVS | screening-histology-order-parameter-cs#scrn-0069-00004 |
| Тип материала шейки матки | ScreeningCervicalMaterialTypeVS | screening-histology-order-parameter-cs#scrn-0069-00005 |
Четыре инварианта делают второй параметр зависимым от класса материала: биопсия требует подтип биопсии, хирургический материал — вид операции, цитологический — вид цитологии, а профиль в целом требует ровно одну основную ветку (класс материала РМЖ либо тип материала РШМ). Виды, дата и другое лечение к этой заявке не относятся — они фиксируются отдельным Observation, см. следующий раздел.
История ранее проведённого специального лечения (виды, дата, произвольный текст), относящаяся к патоморфологическому исследованию. Хранится отдельно от заявки и связывается с итоговым отчётом, а не с самим исследованием.
Профиль: ScreeningSpecialTreatmentObservation
Пример: ScreeningSpecialTreatmentObservationExample
| Параметр | Справочник | Код компонента |
|---|---|---|
| Вид специального лечения (повторяемый) | ScreeningSpecialTreatmentTypeVS | screening-histology-order-parameter-cs#scrn-0069-00006 |
| Дата или период лечения | Period |
screening-histology-order-parameter-cs#scrn-0069-00007 |
| Другое лечение | string |
screening-histology-order-parameter-cs#scrn-0069-00008 |
Инвариант профиля требует текст другого лечения тогда и только тогда, когда среди видов специального лечения выбрано «Другое». Одна дата лечения представляется как Period с одинаковыми значениями start и end; если дата лечения неизвестна, опциональный компонент не передаётся. Этот исторический период лечения отличается от ServiceRequest.occurrencePeriod патоморфологической заявки, который обозначает плановое время выполнения запрошенного исследования. Ресурс связывается с итоговым DiagnosticReport через DiagnosticReport.supportingInfo (тип http://terminology.hl7.org/CodeSystem/v2-0936#SCI), а не с ServiceRequest.
Материал, к которому относится заявка на патоморфологическое исследование.
Профиль: ScreeningSpecimen (на основе UZCoreSpecimen)
Пример: ScreeningSpecimenExample
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Тип образца | ScreeningPathologySpecimenTypeVS | SNOMED CT#258415003 (биопсийный материал) |
Specimen.type |
| Пациент | - | - | Specimen.subject |
| Как и когда получен | - | - | Specimen.collection |
И заявка на биопсию, и фактически выполненная биопсия указывают подтип в code.
Профили: ScreeningBreastBiopsyServiceRequest, ScreeningBreastBiopsyProcedure
Примеры: ScreeningBreastBiopsyRequestExample, ScreeningBreastBiopsyProcedureExample
| Записываемая информация | Справочник | Пример кода |
|---|---|---|
| Подтип биопсии | ScreeningBreastBiopsySubtypeVS | SNOMED CT#9911007 (кор-биопсия) |
Гистологическое заключение по молочной железе, включая патоморфологическую стадию TNM. Observation.code - это SNOMED CT#394597005 (Гистопатология); каждая находка записывается как компонент.
Профиль: ScreeningBreastHistologyObservation
Пример: ScreeningBreastHistologyObservationExample
| Записываемая информация | Справочник | Где хранится (код компонента) |
|---|---|---|
| Класс материала (обязательно) | ScreeningBreastMaterialClassVS | SNOMED CT#371439000 |
| Гистологический тип | ScreeningBreastHistologicTypeVS | screening-specialized-observation-parameter-cs#scrn-0073-00006 |
| Баллы по Ноттингему (тубулярные структуры, ядерный полиморфизм, митозы) | - | LOINC#85321-8, LOINC#44645-0, LOINC#85300-2 |
| Наибольший инвазивный очаг (мм) | - | LOINC#44635-1 |
| Степень злокачественности DCIS | ScreeningDCISMalignancyGradeVS | screening-specialized-observation-parameter-cs#scrn-0073-00009 |
| Архитектурный тип DCIS | ScreeningHistologyDCISArchitecturalPatternVS | LOINC#85302-8 |
| Лимфоваскулярная инвазия | ScreeningHistologyLymphovascularInvasionVS | LOINC#59544-7 |
| Модификатор стадии | ScreeningStageModifierVS | screening-specialized-observation-parameter-cs#scrn-0073-00010 |
| Патоморфологические T / N / M | ScreeningPathologicalTVS, ScreeningPathologicalNVS, ScreeningPathologicalMVS | scrn-0073-00011, scrn-0073-00012, scrn-0073-00013 |
| Состояние краёв резекции (инвазивный компонент, DCIS) | ScreeningResectionMarginStatusVS | scrn-0073-00038, scrn-0073-00039 |
| Класс остаточной опухолевой нагрузки (RCB) | ScreeningResidualCancerBurdenClassVS | SNOMED CT#444987009 |
| Фокальность опухоли | - | SNOMED CT#396199003 |
Категории TNM используют понятия патоморфологического стадирования AJCC (например, SNOMED CT#1228957006 pT1, SNOMED CT#1229947003 pN0). В AJCC не определена патоморфологическая категория M0, поэтому ScreeningPathologicalMVS использует SNOMED CT#1229901006 (cM0) вместе с SNOMED CT#1229916009 (pM1).
Гистологическое заключение по шейке матки. Observation.code - это SNOMED CT#394597005 (Гистопатология), bodySite фиксирован как SNOMED CT#71252005 (Структура шейки матки), а морфологический диагноз записывается в Observation.value.
Профиль: ScreeningCervicalHistologyObservation
Пример: ScreeningCervicalHistologyObservationExample
| Записываемая информация | Справочник | Где хранится |
|---|---|---|
| Морфологический диагноз | ScreeningCervicalHistologyMorphologyVS | Observation.value |
| Степень дифференцировки | ScreeningCervicalHistologicGradeVS | LOINC#33732-9 |
| Глубина инвазии в строму | - | SNOMED CT#396235003 |
| Лимфоваскулярная инвазия | ScreeningHistologyLymphovascularInvasionVS | LOINC#59544-7 |
| Состояние краёв резекции | ScreeningResectionMarginStatusVS | screening-specialized-observation-parameter-cs#scrn-0073-00019 |
| Вовлечение других органов | ScreeningOtherOrganInvolvementVS | screening-specialized-observation-parameter-cs#scrn-0073-00020 |
| Тип метастазирования | ScreeningMetastasisTypeVS | screening-specialized-observation-parameter-cs#scrn-0073-00022 |
| Исследование сторожевого лимфоузла | ScreeningSentinelLymphNodeExaminationVS | SNOMED CT#396487001 |
| Макро- и микроскопическое описание | - | LOINC#22634-0, LOINC#22635-7 |
Цитологическое заключение по молочной железе по системе Yokohama.
Профиль: ScreeningBreastCytologyObservation
Пример: ScreeningBreastCytologyObservationExample
| Записываемая информация | Справочник | Где хранится |
|---|---|---|
| Код исследования | - | Observation.code = screening-specialized-observation-parameter-cs#scrn-0073-00029 |
| Категория Yokohama | ScreeningYokohamaCategoryVS | Observation.value |
| Класс материала | ScreeningBreastMaterialClassVS | SNOMED CT#371439000 |
Результаты ER, PR, Ki-67, HER2 и p16 одного иммуногистохимического исследования. Observation.code - это SNOMED CT#117617002 (Иммуногистохимическое исследование).
Профиль: ScreeningImmunohistochemistryObservation
Пример: ScreeningImmunohistochemistryObservationExample
| Записываемая информация | Справочник | Где хранится (код компонента) |
|---|---|---|
| Балл Allred, ER | - | screening-specialized-observation-parameter-cs#scrn-0073-00002 |
| Балл Allred, PR | - | screening-specialized-observation-parameter-cs#scrn-0073-00003 |
| Балл HER2 по ИГХ | ScreeningHer2IhcScoreVS | см. профиль |
| Результат p16 | ScreeningP16ResultVS | см. профиль |
Публикуются три опросника. Ответы возвращаются в виде QuestionnaireResponse, иерархия item которого повторяет опросник, а каждый linkId точно совпадает с опубликованным вопросом. Кодируемые ответы привязываются через answerValueSet.
| Опросник | Каноническая ссылка | Пример ответа |
|---|---|---|
| Риск рака молочной железы | https://dhp.uz/fhir/integrations/Questionnaire/screening-breast-risk |
ScreeningBreastRiskResponseExample |
| Риск рака шейки матки | https://dhp.uz/fhir/integrations/Questionnaire/screening-cervical-risk |
ScreeningCervicalRiskResponseExample |
| Медицинский осмотр женщины | https://dhp.uz/fhir/integrations/Questionnaire/screening-woman-exam |
ScreeningWomanExamResponse128 |
Итоговый документ скрининга собирает всё, что зафиксировано в рамках одного цикла скрининга, в один скачиваемый документ. Он может быть сформирован на любом этапе цикла: то, что ещё не внесено, просто не попадает в документ, поэтому сформированный на раннем этапе документ содержит только ответы на опросники.
Отдельные этапы не получают собственный Composition - каждый результат остаётся Observation, а этот документ ссылается на них.
Профиль: ScreeningComposition
Примеры: ScreeningCompositionExample, ScreeningCompositionDocumentExample
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Тип документа | - | LOINC#34133-9 (Summary of episode note) |
Composition.type |
| Опросники | - | LOINC#74465-6 |
section[questionnaire].entry (QuestionnaireResponse) |
| Результаты всех выполненных этапов | - | LOINC#30954-2 |
section[results].entry (Observation) |
| Окончательный диагноз по МКБ-10 | - | LOINC#29308-4 |
section[diagnosis].entry (Condition) |
| Автор | - | - | Composition.author (PractitionerRole) |
| Ответственная организация | - | - | Composition.custodian |
| Документируемые направления и процедуры | - | - | Composition.event.detail |
Чтобы передать итоговый документ как неизменяемый, поместите его в Bundle с type = document, где Composition является первой записью, а все ресурсы, на которые он ссылается - Patient, Condition, Observation, QuestionnaireResponse и прочие - находятся в том же Bundle.
Рост, вес и ИМТ - это стандартные витальные показатели FHIR, каждый из которых записывается как отдельное Observation - они не относятся к скринингу. Используйте для каждого свой профиль FHIR; код фиксируется профилем.
Профили: bodyheight, bodyweight, bmi
Примеры: body-height, body-weight, body-mass-index
| Измерение | Профиль FHIR | Код | Пример значения |
|---|---|---|---|
| Рост | bodyheight |
LOINC#8302-2 |
160 см |
| Вес | bodyweight |
LOINC#29463-7 |
52 кг |
| Индекс массы тела | bmi |
LOINC#39156-5 |
20.3 кг/м2 |
Эти наблюдения содержат свободный текст, а не кодированные значения; установите Observation.code в тип записи.
Профиль: ScreeningObservation
| Observation | Observation.code | Что содержит |
|---|---|---|
| gynecological-physical-exam | SNOMED CT#5880005 (физикальный осмотр) |
Акушерский и гинекологический анамнез, в note |
| gynecological-complaints | SNOMED CT#1269489004 (главная жалоба) |
Жалобы, сообщённые пациентом, в note |
| oncogynecological-followup | SNOMED CT#281036007 (контрольная консультация) |
Результаты наблюдения, в component |
Установите PractitionerRole.code из ScreeningRolesVS.
Профиль: UZCorePractitionerRole
Примеры: practitioner-role-laborant, practitioner-role-gynecologist, practitioner-role-radiologist, practitioner-role-nurse
| Роль | Пример кода |
|---|---|
| Лаборант | screening-roles-cs#his_laboratory_laborant |
| Акушер-гинеколог | screening-roles-cs#his_centre_obgyn_obstetrician_gynecologist |
| Радиолог | screening-roles-cs#his_ris_ragiologist_head |
| Патронажная медсестра | screening-roles-cs#his_poliklinika_patronage_nurse |