Формат данных медицинских карт

Данные медицинских карт хранятся в формате HL7 FHIR.

Медицинские карты поддерживают следующие версии FHIR (Fast Healthcare Interoperability Resources):

Типы медицинских ресурсов

FHIR состоит из набора модульных компонентов, называемых ресурсами. Поддерживаемый набор ресурсов FHIR и соответствующие категории примерно основаны на разделах Международной сводки о пациенте.

Эти ресурсы сопоставляются с категориями данных на платформе "Здоровье и спорт", которые в API называются типами медицинских ресурсов. Ресурсы Observation сопоставляются на основе контента, например кодов LOINC и категорий FHIR.

Наблюдения, не относящиеся ни к одной из этих категорий, не записываются в сервис "Здоровье и спорт".

Таблица 1. Типы медицинских ресурсов в приложении "Здоровье и спорт"
Тип медицинского ресурса в Здоровье и спорте Ресурсы FHIR Декларация разрешений для платформы "Здоровье и спорт"
Аллергия AllergyIntolerance android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
Условия Условие android.permission.health.READ_MEDICAL_DATA_CONDITIONS
Лаборатория

Наблюдения

  • Категория FHIR: laboratory
 android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
медикаменты; Medication, MedicationRequest, MedicationStatement android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
Личные данные Пациент android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
Информация о специалистах Practitioner, PractitionerRole android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
Беременность

Наблюдения

  • Коды LOINC для беременности
 android.permission.health.READ_MEDICAL_DATA_PREGNANCY
процедуры; Процедура android.permission.health.READ_MEDICAL_DATA_PROCEDURES
социальный анамнез;

Наблюдения

  • Коды LOINC для социального анамнеза
  • Категория FHIR: social-history
 android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
Вакцинация вакцинации; android.permission.health.READ_MEDICAL_DATA_VACCINES
посещения специалистов; Encounter, Location, Organization android.permission.health.READ_MEDICAL_DATA_VISITS
жизненные показатели.

Наблюдения

  • Коды LOINC для жизненных показателей
  • Категория FHIR: vital-signs
 android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS

Ресурсы для пациентов

В настоящее время платформа "Здоровье и спорт" предназначена для хранения медицинских карт только одного человека. Поэтому все записанные ресурсы FHIR должны принадлежать одному и тому же человеку.

Нередко в системе существует несколько ресурсов FHIR Patient для одного человека. Рекомендуется, чтобы приложения согласовывали данные и записывали один ресурс Patient в Здоровье и спорт. Однако это не является обязательным, чтобы учесть различные организационные структуры, которые могут существовать.

Проверка данных

Medical Records API принимает действительные ресурсы FHIR поддерживаемых версий. Платформа "Здоровье и спорт" выполняет проверку, чтобы убедиться, что спецификация FHIR соблюдается для каждой поддерживаемой версии.

Проверки, помеченные как Скоро, пока не выполняются, но будут добавлены в будущих выпусках. Рекомендуем разрабатывать креативы с учетом всех перечисленных проверок, чтобы обеспечить совместимость с будущими выпусками.

Таблица 2. Проверка данных FHIR в платформе "Здоровье и спорт"
Уровень Проверка
Допустимый JSON Данные соответствуют формату JSON.
Поддерживаемые FHIR

Версия FHIR, заявленная приложением для записи, поддерживается. Платформа "Здоровье и спорт" поддерживает следующие версии FHIR:

  • 4.0.1
  • 4.3.0
Поддерживаемые FHIR

Тип ресурса FHIR, записанный в экземпляре ресурса, поддерживается. Платформа "Здоровье и спорт" поддерживает следующие типы ресурсов FHIR:

  • AllergyIntolerance
  • Условие
  • Сближение
  • вакцинации;
  • Местоположение
  • Медицинские препараты
  • MedicationRequest
  • MedicationStatement
  • Наблюдения
  • Организация
  • Пациент
  • специалисты;
  • PractitionerRole
  • Процедура
Уникальный идентификатор ресурса Ресурс содержит поле ID со значением, которое соответствует требованиям к регулярным выражениям.
Уникальный идентификатор ресурса Ресурс не имеет общего идентификатора с другим ресурсом FHIR того же типа из того же MedicalDataSource.
Бизнес-правила Не включает вложенный ресурс FHIR. Вложенные ресурсы – это ресурсы FHIR, которые находятся внутри родительского ресурса. Они используются, когда родительскому ресурсу нужно сослаться на другой ресурс, но у системы недостаточно информации, чтобы создать его как отдельный ресурс с независимым существованием.
Действительный базовый FHIR Поля верхнего уровня в FHIR JSON существуют в спецификации FHIR для данного типа ресурса.
Действительный базовый FHIR Поля верхнего уровня не имеют нулевых значений JSON.
Действительный базовый FHIR Все обязательные поля верхнего уровня заполнены.
Действительный базовый FHIR Поля верхнего уровня, определенные как повторяющиеся элементы в FHIR, имеют тип данных JSON array.
Действительный базовый FHIR Поля верхнего уровня (включая элементы в array JSON), определенные как сложные типы в FHIR, имеют тип данных object JSON.
Действительный базовый FHIR Поля верхнего уровня (включая элементы в JSON-объектах array), определенные как примитивные типы в FHIR, имеют правильный тип данных JSON.
Тип данных FHIR Тип данных JSON
integer, unsignedInt, positiveInt, decimal число
Логическое значение Логическое значение
instant, time, date, dateTime, string, code, markdown, id uri, url, oid, uuid, canonical, integer64, base64Binary число
Скоро
Действительный базовый FHIR Поля верхнего уровня, определенные как примитивные типы в FHIR, соответствуют требованиям к регулярным выражениям. Скоро
Действительный базовый FHIR Расширения примитивных типов существуют в спецификации FHIR и имеют тип данных JSON object.
Действительный базовый FHIR Для полей с выбором (fieldname[x]) записывается не более одного поля. Например, effectiveDateTime и effectivePeriod не могут одновременно присутствовать в одном экземпляре ресурса.
Действительный базовый FHIR Сложные типы данных содержат поля и типы данных, которые соответствуют спецификации FHIR. Скоро
Действительный базовый FHIR Элементы Backbone (и элементы в сложных типах) содержат поля и типы данных, которые соответствуют спецификации FHIR. Скоро
Действительный базовый FHIR Элемент Extensions Поля value[x] имеют допустимый тип и содержат контент, соответствующий этому типу данных. Элементы расширения могут быть включены в любой ресурс для представления дополнительной информации, не являющейся частью базовой спецификации. Они содержат поле url, которое ссылается на определение расширения, и поле value[x], которое содержит значение расширения. value[x] должно быть из списка допустимых типов данных. Скоро

Преобразованные данные FHIR

Некоторые приложения преобразуют данные FHIR в соответствии со своими требованиями. Пример:

  • Объединение данных из разных источников (обычно FHIR API).
  • Сопоставление кодов с глобальными терминологиями (например, SNOMED, LOINC, ICD) и стандартизация единиц измерения.
  • Объединение данных и удаление дубликатов.
  • Исправление форматирования или других проблем с качеством данных.
  • Фильтрация записей на основе бизнес-правил, относящихся к приложению.

На платформу "Здоровье и спорт" можно записывать как преобразованные, так и непреобразованные данные FHIR, если они соответствуют спецификации FHIR R4. Рекомендуем по возможности записывать преобразованные данные. Однако учитывайте следующее:

  • Приложения с узкой специализацией могут отфильтровывать значительное количество записей, которые могли бы быть полезны пользователям других приложений в экосистеме. В таких ситуациях может быть полезно записать непреобразованный FHIR, который является более полным. Однако не забудьте сообщить пользователям, что вы передаете расширенный набор данных.
  • Если вы объединяете данные из разных источников, то можете записать их в один MedicalDataSource на платформе "Здоровье и спорт". Чтобы избежать конфликтов, каждому ресурсу необходимо назначить новый идентификатор и обновить ссылки на ресурсы, чтобы они указывали на новые идентификаторы.
  • Объединение данных из нескольких источников в один MedicalDataSource может затруднить определение происхождения данных. Поскольку потребителям данных часто полезно знать их происхождение, мы рекомендуем заполнять поле meta.source для каждого ресурса, указывая исходный источник записи (обычно это базовый URL-адрес FHIR).
Назад
Обзор
Далее
Напишите медицинские данные