ЕСОЗ - публічна документація

RC_Процеси роботи з обліком наявного в медичному закладі обладнання

Owned by Oleksandr Zhuk (SoE eHealth)
Last updated: Oct 09, 2024
7 min read

Мета

Облік наявного медичного обладнання у ЗОЗ з метою перевірки відповідності закладів вимогам умов закупівлі медичних послуг ПМГ та облік використання наявного обладнання при наданні допомоги пацієнту.

Нижче наведені ключові моменти, на яких побудовано процес обліку наявного в медичному закладі обладнання:

  1. Реєстрація наявного обладнання виконується адміністративним персоналом закладу.

    1. При наявності даних з Державного реєстру медичних виробів запис про наявний у закладі екземпляр обладнання повинен посилатися на відповідний запис у реєстрі.

    2. Для певних типів обладнання (перелік яких буде задано конфігурацією) необхідно вказати заводський/серійний номер екземпляру обладнання, що реєструється.

  2. Медичний персонал може виконати пошук записів про обладнання для вказання його використання при наданні медичної допомоги пацієнту або для зазначення, що таке обладнання вийшло з ладу і не є більше доступним для надання послуг.

    1. Користувач може не знати конкретних характеристих необхідного йому обладнання і тому виконує пошук за параметрами.

    2. Користувач може мати ідентифікатор необхідного йому запису про обладнання та виконати пошук за таким ідентифікатором.

    3. Якщо користувач пройшов необхідні валідації, то у відповідь йому повертаються записи, що відповідають параметрам пошуку, та відносяться лише до його закладу.

  3. Для управління записами про обладнання є можливість працівникам закладу вказувати про пошкодження/знищення/втрату обладнання, а також про доступність конкретного екземпляру обладнання для використання при наданні допомоги пацієнту.

Концептуальна схема бізнес-процесів

Схема бізнес процесів

Source:

Створення запису про обладнання в ЗОЗ

Схема бізнес процесу

 

CreateEquipment.png

 

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Пошук типу обладнання в довіднику Національного класифікатора медичних виробів

Get dictionaries v2

Користувач:

  1. Виконує пошук типу обладнання з використанням необхідних пошукових параметрів

    1. Назва класифікатора (name = device_definition_classification_type)

    2. Код (value_code)

    3. Опис (value_description)

    4. Статус (is_active)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік типів медичних виробів відповідно до критеріїв пошуку

2

Пошук моделі обладнання в довіднику Device Definition

Get Device definitions

Користувач:

  1. Виконує пошук моделі обладнання з указанням необхідних пошукових параметрів

    1. Назва (name)

    2. Тип назви (name_type)

    3. Тип (classification_type)

    4. Статус (is_active)

    5. Номер моделі (model_number)

    6. Медична програма (medical_program_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік моделей обладнання відповідно до критеріїв пошуку

3

Створення запису про обладнання

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221663

Користувач:

  1. Обирає та заповнює необхідну інформацію:

    1. Посилання на тип обладнання з Національного класифікатора МВ (див. крок 1) - обов'язковий параметр (type)

    2. Посилання на модель обладнання з довідника Device Definition (див. крок 2) (device_definition_id)

    3. Назва виробу - (names (name + type) - обов'язковий параметр

    4. Номер моделі обладнання (model_number)

    5. Виробник (manufacturer)

    6. Дата виробництва (manufacture_date)

    7. Опис виробу (note)

    8. Інвентарний номер (inventory_number)

    9. серійний номер (serial_number)

    10. Місце розташування обладнання (division_id)

    11. Додаткові властивості обладнання (properties (type + value_integer\value_decimal\value_boolean\ value_string)

    12. Посилання на батьківський виріб (parent_id)

    13. Статус виробу (status) - обов'язковий параметр

    14. Статус доступності  (availability_status) - обов'язковий параметр

    15. Працівник що створив запис (recorder) - обов'язковий параметр value_string

    16. Номер закупівлі (lot_number)

    17. Термін придатності (expiration_date)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

    1. Назва обладнання -names (name + type),

    2. Тип обладнання - Type,

    3. Статус запису про обладнання - Status,

    4. Статус доступності обладнання - Availability_status,

    5. Власник обладнаня (Legal_Entity) - (legal_entity_id) - отримується з token-у користувача, яким створюється обладнання;

  3. Виконує необхідні валідації введених параметрів запиту

    1. Перевірка статусу Legal Entity до якого належить працівник 

      1. Legal Entity працівника має статус = “Active” або “Suspended”;

    2. Перевірка на наявність активного запису для вказаного типу в довіднику типів

      1. Запис в довіднику типів (device_definition_classification_type) на який посилається створюваний запис має бути у статусі “активний”

    3. Якщо для обладнання заповнене значення “посилання на довідник device_definition”

      1. запис в довіднику device_definitions на який посилається створюваний запис має бути у статусі “активний”

      2. виконується перевірка на збіг вибраного для обладнання типу (з довідника типів) та типу який зазначений в довіднику device_definition.

      3. Якщо в довіднику device_definition для вибраного запису не вказаний тип - перевірка не виконується.

    4. Перевірка наявності серійного номера обладнання (якщо його потрібно заповнювати згідно з обраним типом)

      1. Перевірка чи в конфігураційному параметрі, який містить перелік типів обладнання, для яких потрібне вказання серійного номеру, міститься вказаний тип обладнання

      2. Якщо такий тип є в конфігураційному параметрі - перевірка заповненості серійного номеру.

    5. Перевірка статусу і статусу доступності обладнання

      1. Статус запису створюваного обладнання має бути “Активний” (status = “active“)

      2. Статус доступності створюваного обладнання має бути “Доступний” (availability status=”available”)

    6. Перевірка звʼязку обладнання з батьківським

      1. Якщо є посилання на батьківське обладнання (parent), то запис про це батьківське обладнання повинен бути активним (status = “active“)

    7. Перевірка значення посилання на підрозділ де розташоване обладнання (Division)

      1. Якщо заповнено параметр Division тоді запис підрозділу для якого створюється обладнання має бути активним.

      2. Має бути співпадіння Legal entity для значень вказаних в параметрах Legal_entity_id i Division

    8. Перевірка чи дата вказана в manufacture_date не перевищує сьогоднішню

    9. Якщо список property містить хоч одне значення то для кожного елементу списку виконуються такі валідації:

      1. Перевірка чи заповнені значення properties (type та value_integer\value_decimal\value_boolean\ value_string

      2. Перевірка чи відповідає вибране значення property_type довіднику еталонних “типів властивостей”

      3. Якщо тип даних вказаний у еталонному довіднику “типів властивостей” = “список” тоді перевірка співпадінь вибраних значень в атрибуті property_value з відповідним еталонним довідником. Співставлення значення з довідника “типів властивостей” і можливих значень атрибуту property_value задається відповідною конфігурацією

    10. Перевірка унікальності інвентарного номеру

      1. Якщо передане значення інвентарного номеру (Inventory_Number), то воно має бути унікальним серед активного обладнання (status=Active) в рамках Legal_entity в якому створюється обладнання

    11. Перевірки дати вказаної в параметрі термін придатності (expiration_date)

      1. Якщо передане значення терміну придатності то вказана дата повинна бути більшою за поточну дату.

    12. Перевірка працівника медичного закладу (recorder)

      1. Обліковий запис співробітника не є неверифікований

  4. Повертає інформацію про створений екземпляр обладнання

Пошук обладнання в ЗОЗ за параметрами

Схема бізнес процесу

 

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Пошук обладнання в ЗОЗ за параметрами
https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221681

Користувач:

  1. Вводить набір параметрів за якими хоче знайти обладнання в ЗОЗ:

    1. Тип обладнання (type)

    2. Посилання на Device Definition (device_definition_id)

    3. Підрозділ де знаходиться обладнання (division_id)

    4. Номер моделі обладнання (model_number)

    5. Виробник (manufacturer)

    6. Статус доступності обладнання (availability_status)

    7. Статус виробу (status)

    8. Працівник що створив запис (recorder)

    9. Інвентариний номер обладнання (inventory_number)

    10. Серійний номер обладнання (serial_number)

    11. Назва обладнання (names.name)

    12. Дата створення обладнання (inserted_at) - дата задається періодом від\до з включенням вказаних дат в інтервал пошуку. Напр. DD.MM.YYYY 00:00:00 - DD.MM.YYYY 23:59:59

Для кожного параметру є можливість вказати тільки одне значення

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Повертає результати успішного виконання запиту (Ідентифікатор обладнання та інформація про обладнання) або причину його відхилення. У відповіді на запит користувача буде повернути лише те обладнання, яке належить до того ж ЗОЗ, що і користувач, який виконує запит

Пошук обладнання в ЗОЗ за ідентифікатором

Cхема бізнес процесу

 

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Пошук обладнання в ЗОЗ за збереженим раніше ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221697

Користувач:

  1. Вводить збережений раніше ідентифікатор обладнання. (id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Перевіряє, що обладнання, для якого змінюється пошук, існує в системі

  4. Перевіряє що користувач, що виконує пошук обладнання, стосується того ж ЗОЗ, що й саме обладнання

  5. Повертає результати успішного виконання запиту (інформація про обладнання) або причину його відхилення.

Зміна статусу обладнання

Cхема бізнес процесу

 

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Пошук обладнання в ЗОЗ (за збереженим раніше ідентифікатором або за параметрами)

Користувач:

  1. Вводить збережений раніше ідентифікатор обладнання або набір параметрів для пошуку)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Повертає результати успішного виконання запиту (інформація про обладнання) або причину його відхилення.

2

Зміна статусу обладнання
https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221713

Користувач:

  1. Обирає новий статус обладнання з переліку відповідно до https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221635

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Перевіряє, що обладнання, для якого змінюється статус, існує в системі

  4. Перевіряє що користувач, що виконує зміну статусу обладнання, стосується того ж ЗОЗ, що й саме обладнання статус якого змінюється

  5. Перевіряє що поточний статус обладнання відповідає значенню state=“active“ або “inactive“ (змінювати обладнання в статусі “entered-in-error“ неможливо)

    1. Якщо поточний статус обладнання state=“inactive“ то новий статус обладнання дорівнює “entered-in-error“

  6. У випадку якщо статус обладнання змінюється на “entered-in-error” додатково фіксується причина Device.ErrorReason=Error_record

  7. У випадку якщо статус обладнання змінюється на state=“inactive“ перевіряється що статус доступності обладнання не дорівнює “Available“

  8. Повертає результати успішного виконання запиту або причину його відхилення

Зміна статусу доступності обладнання

Cхема бізнес процесу

 

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Пошук обладнання в ЗОЗ (за збереженим раніше ідентифікатором або за параметрами)

Користувач:

  1. Вводить збережений раніше ідентифікатор обладнання або набір параметрів для пошуку)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Повертає результати успішного виконання запиту (інформація про обладнання) або причину його відхилення.

2

Зміна статусу доступності обладнання
https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221731

Користувач:

  1. Обирає новий статус доступності обладнання з переліку відповідно до https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17679221635

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  3. Перевіряє, що обладнання, для якого змінюється статус, існує в системі

  4. Перевіряє що користувач, що виконує зміну статусу обладнання, стосується того ж ЗОЗ, що й саме обладнання статус якого змінюється

  5. Перевіряє що поточний статус обладнання відповідає значенню state=“active“ (змінювати доступність обладнання в статусах “inactive“ або “entered-in-error“ неможливо)

  6. Повертає результати успішного виконання запиту або причину його відхилення

 

ЕСОЗ - публічна документація