ОПИСАНИЕ ФУНКЦИОНАЛЬНЫХ ХАРАКТЕРИСТИК

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ
«МОДУЛЬ ФОРМИРОВАНИЯ СЭМД ДЛЯ ПЕРЕДАЧИ В ЕГИСЗ НА БАЗЕ ЭСМО» 

ОГЛАВЛЕНИЕ
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При регистрации возникла ошибка. Требуется проверить исходные данные и повторить обработку.
3XML подготовленоСЭМД зарегистрирован, semd_uuid и XML получены. Следующий шаг – отправка XML на подпись.
4XML отправлено на подписьXML передан в WS-канал врачу. Система ожидает подписанный файл.
5XML подписаноПодпись получена и сохранена. Следующий шаг – загрузка подписи в 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 – Пример веб-интерфейса