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

Get dictionaries v2

Користувач:

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

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

   2. Код (value_code)

   3. Опис (value_description)

   4. Статус (is_active)

Система e-Health:

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

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

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

Пошук моделі обладнання в довіднику 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. Повертає перелік моделей обладнання відповідно до критеріїв пошуку

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

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. Повертає інформацію про створений екземпляр обладнання

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

Користувач:

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

Система e-Health:

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

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

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

Зміна статусу обладнання
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. Повертає результати успішного виконання запиту або причину його відхилення