ОПИСАНИЕ ФУНКЦИОНАЛЬНЫХ ХАРАКТЕРИСТИК
ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ
«МОДУЛЬ ФОРМИРОВАНИЯ СЭМД ДЛЯ ПЕРЕДАЧИ В ЕГИСЗ НА БАЗЕ ЭСМО»
ОГЛАВЛЕНИЕ
1 Общие сведения о программном продукте
2 Назначение ПО
3 Нормативно-правовые аспекты
4 Доступ к ПО
5 Эксплуатационное назначение ПО
6 Функциональные возможности ПО
6.1 Формирование СЭМД
6.2 Передача СЭМД в ЕГИСЗ через N3Health
6.3 Управление режимом работы и параметрами соединения
6.4 Планировщик задач
6.5 Журнал сессий СЭМД
6.6 Ручные действия по сессии
6.7 Архивирование, учет и отчетность
6.8 Контроль полноты и целостности данных
6.9 Управление правами доступа
7 Графический интерфейс ПО
8 Доступ к панели управления ПО
9 Информация, необходимая для работы ПО
9.1 Входные данные
9.2 Выходные данные
9.3 Требования к системному программному обеспечению
9.4 Требования по техническому обеспечению системы
9.5 Требования к клиентскому рабочему месту
10 Выполнение ПО
Список иллюстраций
1. ОБЩИЕ СВЕДЕНИЯ О ПРОГРАММНОМ ПРОДУКТЕ
Полное наименование программного продукта: Программное обеспечение «Модуль формирования СЭМД для передачи в ЕГИСЗ на базе ЭСМО» (далее по тексту – ПО, Модуль СЭМД).
Языки программирования: PHP, JavaScript, SQL
Область применения: Медицина, здравоохранение, электронный документооборот, информационное взаимодействие с ЕГИСЗ, автоматизация медицинских осмотров
Модуль СЭМД используется в составе программной среды ЭСМО и обеспечивает формирование, учет, подписание, передачу и контроль статуса структурированных электронных медицинских документов, сформированных по результатам медицинских осмотров, приемов цехового терапевта и иных медицинских исследований, проведенных с использованием ЭСМО.
2. НАЗНАЧЕНИЕ ПО
Программное обеспечение предназначено для формирования в системе ЭСМО структурированных электронных медицинских документов (СЭМД) и их дальнейшей передачи в Единую государственную информационную систему в сфере здравоохранения (ЕГИСЗ).
СЭМД формируются в автоматическом режиме на основании данных, внесенных и обработанных в ЭСМО. Источником формирования являются результаты проведенных медицинских осмотров, приемов цехового терапевта и иных медицинских исследований, выполненных с использованием ЭСМО.
Назначение Модуля СЭМД состоит в обеспечении непрерывного цикла обработки электронного медицинского документа: от выявления подходящего медицинского осмотра до подготовки XML, подписания ЭЦП, отправки в N3Health и получения финального подтверждения о принятии документа.
3. НОРМАТИВНО-ПРАВОВЫЕ АСПЕКТЫ
Модуль СЭМД применяется в процессах формирования электронных медицинских документов и информационного взаимодействия с ЕГИСЗ. Эксплуатация ПО должна выполняться с учетом требований законодательства Российской Федерации в области охраны здоровья граждан, медицинской документации, защиты информации, обработки персональных данных и применения электронной подписи.
Передача СЭМД в ЕГИСЗ выполняется только при наличии корректных исходных данных медицинской организации, медицинского работника, пациента и медицинского осмотра, а также при корректной настройке параметров соединения с тестовым или продуктивным сервисом N3Health.
4. ДОСТУП К ПО
Доступ к программному обеспечению осуществляется через веб-интерфейс. Для работы пользователю необходимо устройство с доступом к сети Интернет или корпоративной сети, операционная система с графическим интерфейсом и современный веб-браузер.
Пользователь переходит по предоставленному URL-адресу и выполняет вход с использованием учетных данных. Набор доступных разделов и действий определяется ролью пользователя и назначенными правами доступа.
5. ЭКСПЛУАТАЦИОННОЕ НАЗНАЧЕНИЕ ПО
Модуль СЭМД предназначен для эксплуатации медицинскими организациями и предприятиями, использующими ЭСМО для проведения медицинских осмотров и последующей передачи структурированных электронных медицинских документов в ЕГИСЗ.
ПО обеспечивает автоматизацию повторяющихся операций, связанных с формированием СЭМД, контролем статусов, подписанием XML-документов, повторной отправкой при сбоях, архивированием и отчетностью.
Категории конечных пользователей:
• администратор системы – выполняет настройку параметров соединения, режима работы, планировщика и прав доступа;
• фельдшер или врач – проводит медицинский осмотр и подписывает сформированные XML-документы ЭЦП;
• оператор или специалист технической поддержки – контролирует состояние сессий, просматривает ошибки и инициирует ручные действия в пределах назначенных прав;
• медицинский руководитель или ответственное лицо организации – контролирует показатели передачи СЭМД, количество подтвержденных документов и отчетность.
Ролевая и правовая системы внутри ЭСМО гибкие и настраиваемые. Конкретные сценарии создания ролей и распределения прав настраиваются по требованию заказчика.
6. ФУНКЦИОНАЛЬНЫЕ ВОЗМОЖНОСТИ ПО
Функциональные возможности Модуля СЭМД сгруппированы по основным процессам жизненного цикла структурированного электронного медицинского документа.
6.1. ФОРМИРОВАНИЕ СЭМД
• автоматическое формирование СЭМД в ЭСМО на основании завершенных медицинских осмотров и иных медицинских исследований;
• создание сессии СЭМД для медицинского осмотра, подлежащего передаче;
• подготовка структурированного набора данных для регистрации документа в N3Health;
• получение и сохранение XML-документа СЭМД после успешной регистрации;
• проверка полноты обязательных данных перед отправкой.
6.2. ПЕРЕДАЧА СЭМД В ЕГИСЗ ЧЕРЕЗ N3HEALTH
• передача подготовленных СЭМД из ЭСМО в ЕГИСЗ через промежуточный компонент n3health-adapter;
• поддержка тестового и продуктивного режимов работы;
• использование URL-адресов и токенов авторизации для соответствующих стендов;
• загрузка электронной подписи в сервис N3Health;
• получение финального подтверждения принятия СЭМД.
6.3. УПРАВЛЕНИЕ РЕЖИМОМ РАБОТЫ И ПАРАМЕТРАМИ СОЕДИНЕНИЯ
• отображение текущего режима работы: тестовый или продуктивный;
• проверка доступности тестового и продуктивного сервисов;
• настройка адреса продуктивного сервиса СЭМД;
• настройка токена авторизации для продуктивного сервиса;
• настройка адреса тестового сервиса СЭМД;
• настройка токена авторизации для тестового сервиса;
• переключение активного режима работы с учетом готовности интеграции.
6.4. ПЛАНИРОВЩИК ЗАДАЧ
Модуль поддерживает автоматический запуск регламентных операций через планировщик задач. Планировщик обеспечивает выполнение всех этапов обработки без постоянного ручного участия пользователя.
• подготовка СЭМД, регистрация и отправка XML на подпись;
• повторная отправка отклоненных СЭМД;
• повторная отправка XML на подпись;
• отправка подписи СЭМД в N3Health;
• проверка принятия подписи и финального статуса;
• периодическая проверка доступности сервисов СЭМД;
• ручной запуск заданий вне расписания при необходимости.
6.5. ЖУРНАЛ СЕССИЙ СЭМД
Каждый медицинский осмотр, подлежащий передаче, образует отдельную сессию СЭМД. Журнал сессий предназначен для мониторинга, диагностики и ручного управления процессом передачи.
В журнале отображаются идентификатор сессии, дата и время создания, идентификатор медицинской организации, сведения о пациенте и медицинском работнике, режим работы, текущий статус, регистрационные сведения СЭМД, наличие XML, состояние подписи, результат загрузки подписи и финальное подтверждение принятия.
| Статус | Наименование | Функциональное значение | |
| 1 | Новая | Сессия создана для медицинского осмотра. Следующий шаг – регистрация СЭМД в N3Health. | |
| 2 | Подготовка XML | При регистрации возникла ошибка. Требуется проверить исходные данные и повторить обработку. | |
| 3 | XML подготовлено | СЭМД зарегистрирован, semd_uuid и XML получены. Следующий шаг – отправка XML на подпись. | |
| 4 | XML отправлено на подпись | XML передан в WS-канал врачу. Система ожидает подписанный файл. | |
| 5 | XML подписано | Подпись получена и сохранена. Следующий шаг – загрузка подписи в N3Health. | |
| 6 | Подпись отправлена | Подпись принята сервисом. Система ожидает финальное подтверждение added_to_n3health. | |
| 7 | Отправка подтверждена | СЭМД принят N3Health. Это финальный успешный статус передачи. |
6.6. РУЧНЫЕ ДЕЙСТВИЯ ПО СЕССИИ
В зависимости от текущего статуса сессии пользователю с соответствующими правами доступны ручные операции:
• «Подготовить XML» – повторная регистрация СЭМД после исправления исходных данных;
• «Отправить на подпись» – повторная отправка XML-документа в WS-канал врачу;
• «Отправить подпись в n3health» – загрузка полученной подписи в N3Health;
• «Проверить принятие СЭМД» – немедленный запрос статуса принятия документа;
• «Посмотреть отправляемые данные» – просмотр payload, отправленного в N3Health;
• «Посмотреть XML пакета» – просмотр содержимого сформированного XML-документа.
6.7. АРХИВИРОВАНИЕ, УЧЕТ И ОТЧЕТНОСТЬ
• хранение информации о переданных СЭМД в архиве;
• ведение учета переданных записей для подсчета общего количества СЭМД;
• фиксация даты и времени факта передачи;
• отображение информации о переданных и подтвержденных СЭМД;
• формирование отчетов по переданным СЭМД;
• отображение информационных сообщений при сбоях передачи.
6.8. КОНТРОЛЬ ПОЛНОТЫ И ЦЕЛОСТНОСТИ ДАННЫХ
Перед успешной передачей СЭМД должны быть заполнены обязательные сведения по медицинской организации, врачу или фельдшеру, пациенту и медицинскому осмотру. Ошибки на этапе подготовки XML чаще всего связаны с неполными или некорректными исходными данными.
• проверка СНИЛС пациента и медицинского работника;
• проверка ФИО, даты рождения и пола пациента;
• проверка должности медицинского работника по справочнику;
• проверка OID, ОГРН, ОКПО, ОКАТО и адресных данных медицинской организации;
• проверка договора медицинской организации и срока его действия;
• проверка времени начала и окончания медицинского осмотра;
• проверка часового пояса в настройках группы медицинского работника.
6.9. УПРАВЛЕНИЕ ПРАВАМИ ДОСТУПА
Модуль поддерживает ролевую модель доступа. Администратор может назначать пользователям права на просмотр и выполнение отдельных операций: доступ к вкладкам, настройкам, журналам, диагностическим действиям, управлению планировщиком и ручным операциям по сессиям.
7. ГРАФИЧЕСКИЙ ИНТЕРФЕЙС ПО
Графический интерфейс Модуля СЭМД доступен через веб-браузер после авторизации. Язык интерфейса – русский.
Основные вкладки интерфейса представлены в таблице.
| Вкладка | Назначение | |
| СЭМД | Главная страница модуля: отображение режима работы, статусов СЭМД и заданий планировщика. | |
| Сессии | Журнал всех сессий формирования и передачи СЭМД, фильтрация, диагностика и ручные операции. | |
| Тестовый СЭМД | Диагностические запросы к тестовому стенду N3Health без изменения состояния сессий. | |
| Продуктивный СЭМД | Диагностические запросы к продуктивному стенду N3Health. | |
| Настройки | Параметры соединения, режим работы, токены, адреса сервисов и настройки планировщика. | |
| БД | Раздел администрирования, доступный пользователям с соответствующими правами. |
На главной странице отображаются блоки «Режим работы», «Статусы СЭМД» и «Задания планировщика». Эти блоки используются для оперативного контроля доступности сервисов, текущего режима и объема документов на стадиях обработки.
Рисунок 1 – Пример веб-интерфейса
8. ДОСТУП К ПАНЕЛИ УПРАВЛЕНИЯ ПО
Доступ к панели управления предоставляется пользователю с ролью администратора или другой ролью, которой назначены необходимые права.
1. Войдите в систему под учетной записью администратора.
2. Откройте Модуль СЭМД через доступное меню или прямой URL-адрес раздела.
3. Перейдите на вкладку «Настройки» для изменения параметров соединения и режима работы.
4. При необходимости перейдите в раздел «Права доступа» для назначения или отзыва прав роли.
5. После изменения критичных настроек проверьте доступность сервиса на вкладке «СЭМД» и убедитесь, что текущий режим соответствует ожидаемому.
Переключение в продуктивный режим означает, что документы будут отправляться в реальную систему ЕГИСЗ. Перед переключением необходимо проверить адрес продуктивного сервиса, токен авторизации, доступность канала связи и результаты тестовой передачи.
9. ИНФОРМАЦИЯ, НЕОБХОДИМАЯ ДЛЯ РАБОТЫ ПО
Для корректной работы Модуля СЭМД необходимы исходные данные, параметры интеграции, сведения для подписания и технические условия эксплуатации.
9.1. ВХОДНЫЕ ДАННЫЕ
| Группа данных | Обязательные сведения | |
| Медицинская организация | uid, OID, официальное наименование, ОГРН, ОКПО, ОКАТО, юридический адрес, регион, индекс, номер и сроки действия договора. | |
| Врач / фельдшер | uid, полное ФИО, СНИЛС, должность из утвержденного справочника, табельный номер, группа, часовой пояс, настроенный клиент ЭЦП. | |
| Пациент / сотрудник | uid, фамилия, имя, отчество, дата рождения, пол, СНИЛС. | |
| Медицинский осмотр | exam_uuid, тип осмотра, заключение, время начала и окончания, признак допуска, сведения о группе и часовом поясе. | |
| Параметры интеграции | URL тестового и продуктивного сервисов, токены авторизации, активный режим работы, расписание планировщика. |
9.2. ВЫХОДНЫЕ ДАННЫЕ
В результате выполнения операций Модуль СЭМД формирует и хранит следующие выходные данные:
• сессию СЭМД с уникальным идентификатором;
• структурированный XML-документ СЭМД;
• уникальный идентификатор СЭМД в N3Health (semd_uuid);
• файл электронной подписи;
• статус регистрации, подписания, загрузки подписи и принятия документа;
• сообщения об ошибках и диагностические данные;
• архив переданных СЭМД;
• отчеты по переданным, загруженным и подтвержденным документам.
9.3. ТРЕБОВАНИЯ К СИСТЕМНОМУ ПРОГРАММНОМУ ОБЕСПЕЧЕНИЮ
Модуль СЭМД функционирует как веб-приложение и серверный компонент интеграции в составе среды ЭСМО. Серверная часть должна обеспечивать выполнение PHP/JavaScript/SQL-компонентов, хранение данных, обработку планировщика, взаимодействие с адаптером n3health-adapter и передачу данных в N3Health.
| Компонент | Требование / назначение | |
| Операционная система | Linux; при клиентском доступе поддерживаются рабочие станции на Linux, Windows, OS X. | |
| Веб-сервер / сервер приложений | Apache/Nginx или иной совместимый веб-сервер, обеспечивающий выполнение серверной части ПО. | |
| Среда выполнения | PHP, JavaScript-компоненты, необходимые библиотеки приложения. | |
| СУБД | SQL-совместимая СУБД для хранения сессий, статусов, настроек, журналов и архивных данных. | |
| Криптографические средства | Средства ЭЦП и компоненты подписания XML-документов на рабочем месте медицинского работника. | |
| Сетевой доступ | Доступ к сервисам N3Health, тестовому и продуктивному стендам, а также к защищенному каналу связи при его использовании. |
9.4. ТРЕБОВАНИЯ ПО ТЕХНИЧЕСКОМУ ОБЕСПЕЧЕНИЮ СИСТЕМЫ
Минимальные требования к техническому обеспечению зависят от выбранной схемы развертывания, количества пользователей, объема медицинских осмотров и интенсивности передачи СЭМД. Рекомендуемые базовые параметры приведены в таблице.
| Компонент | Минимальные параметры | |
| Сервер приложений | 1 CPU, 8 ГБ ОЗУ, от 200 ГБ дискового пространства, сетевой адаптер от 1 Гбит/с. | |
| Сервер базы данных | 1 CPU, 8 ГБ ОЗУ, от 200 ГБ дискового пространства, производительная дисковая подсистема, сетевой адаптер от 1 Гбит/с. | |
| Сетевое хранилище / архив | От 1000 ГБ дискового пространства при значительном объеме архивируемых XML-документов, подписей и логов. | |
| Сетевой канал | Стабильное подключение к внутренней сети и внешним сервисам интеграции, достаточное для регулярной передачи СЭМД. | |
| Резервное копирование | Регламентное резервное копирование базы данных, файлов подписей, XML-документов, настроек и журналов. |
9.5. ТРЕБОВАНИЯ К КЛИЕНТСКОМУ РАБОЧЕМУ МЕСТУ
• персональный компьютер или ноутбук с доступом к сети;
• операционная система Linux, Windows или OS X;
• современный веб-браузер;
• для медицинского работника, подписывающего XML-документы, – настроенное средство электронной подписи и необходимые браузерные компоненты;
• стабильное сетевое соединение с веб-интерфейсом ЭСМО;
• учетная запись с назначенными правами доступа.
10. ВЫПОЛНЕНИЕ ПО
Перед использованием Модуля СЭМД конечному пользователю не требуется устанавливать отдельное клиентское приложение, если рабочее место не выполняет функции подписания. Работа с ПО осуществляется через веб-браузер после авторизации.
Типовой автоматический поток обработки СЭМД:
1. По завершенному медицинскому осмотру создается сессия СЭМД.
2. Система отправляет СЭМД в ЕГИСЗ.
Если автоматическая обработка не завершилась успешно, пользователь с соответствующими правами выполняет диагностику по статусу сессии, проверяет исходные данные и при необходимости инициирует ручное действие или ожидает повторной обработки планировщиком.
СПИСОК ИЛЛЮСТРАЦИЙ
Рисунок 1 – Пример веб-интерфейса