Versions Compared

Old Version 2

changes.mady.by.user Kateryna Haleta (SoE eHealth)

Saved on

compared with

New Version Current

changes.mady.by.user Kateryna Haleta (SoE eHealth)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published
Table of Contents
stylenone

...

  • У випадку відсутності значення конфігураційного параметра для типу МВ і категорії МВ, що передані в МВ, який створюється - така валідація пропускається і не виконується.

  • Під час виконання валідацій параметрів, які стосуються різниці між двома датами:

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

    • різниця задається мінімальним та(або) максимальним значеннями

  • Під час виконання валідацій параметрів, які стосуються значення з довідника - в конфігураційному параметрі вказується не лише еталонне значення, але і довідник до якого це значення відноситься. Конфігураційні параметри можуть за потреби містити масив значень.

  • Номер медичного висновку (composition.title) повинен бути згенерований перед відправкою запиту на створення МВ. У відповідь на запит створення номеру МВ користувач отримає: номер МВ та дату і час, до якої цей номер буде валідним. Після настання зазначеної дати і часу, створити МВ з таким номером буде неможливо і користуваче користувачу необхідно буде отримати номер МВ заново.

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

 

Крок

Опис

1

Здійснити пошук пацієнта (персони або преперсони)
Search for a person v3

Передумови:

  1. Повинен існувати запис про пацієнта для якого створюється МВ

  2. Повинна бути створена\знайдена взаємодія з пацієнтом (encounter) в рамках якої створюється МВ

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

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

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

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

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

  3. Повертає перелік пацієнтів, що відповідають запиту

2

Пошук в довідниках:

  • типу МВ,

  • категорії МВ

  • кодів секцій

  • причин незаповнення секцій

  • типів сортування ЕМЗ

  • статусів допуску

  • кодів додаткових умов допуску

  • буквенних позначень для додаткових умов допуску

Get dictionaries v2

Користувач:

  1. Виконує пошук типу, категорії, кодів секцій, причин незаповнення секцій, типів сортування ЕМЗ, статусів допуску, додаткових умов допуску з використанням необхідних пошукових параметрів

    1. Назва (name)

    2. Код (value_code)

    3. Опис (value_description)

    4. Статус (is_active)

Система e-Health:

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

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

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

3

Генерація номеру медичного висновку

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1809291681218200789016

Користувач:

  1. Виконує запит на отримання номеру медичного висновку

Система e-Health:

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

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

  3. Перевіряє, що користувач, для якого генерується номер МВ існує в БД і є активним.

  4. Генерує унікальний номер МВ

  5. Повертає користуваче номер МВ, дату і час, до якого цей номер медичного висновку буде валідним

4

Отримання правил заповнення секцій[NEW] Get Composition Rules

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/18214387715

Користувач:

  1. Виконує запит на отримання правил заповнення секцій, передаючи

    1. Тип МВ

    2. Категорію МВ

Система e-Health:

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

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

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

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

    1. Тип МВ

    2. Категорія МВ

  3. Повертає перелік правил заповнення секцій МВ, або причину відхилення запиту

5

Збереження мед. висновку

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806093521818200002584

Користувач:

  1. Має можливість заповнити параметри медичного висновку:

    1. Номер МВ (title)

    2. Тип МВ (type)

    3. Категорія МВ (category)

    4. Взаємодія (encounter)

    5. Автор МВ (author)

    6. Підписант МВ (attester)

    7. ЗОЗ де створюється МВ (custodian)

    8. МВ який заміняється (relates_to)

    9. Метод аутентифікації, для відправки смс (authorize_with)

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

    1. Статус допуску (event.code)

    2. Період дії статусу допуску (event.period)

      1. Початок періоду з якого діє статус допуску (event.period.start)

      2. Закінчення періоду дії статусу допуску (event.period.end)

    3. Може зазначити додаткові умови допуску (extentions)

      1. Обирає код додаткової умови допуску з довідника

      2. Обирає буквенне позначення додаткової умови допуску з довідника (якщо це необхідно)

      3. Вводить числове значення для обраної додаткової умови допуску (якщо це необхідно)

  3. Має можливість заповнити розділ секції медичного висновку

    1. Код секції (section.code)

    2. Назва секції (section.title)

    3. Автори секції (section.author) (можливий масив значень)

    4. Коментар (section.text)
      ТА

    5. Наповнення секції:

      1. Посилання на ЕМЗ (section.entry) (можливий масив значень)

      2. Тип сортування ЕМЗ (section.orderedBy)
        АБО

      3. Причина незаповнення секції (section.emptyReason)
        АБО

      4. Підсекція секції (section.section)

  4. Підписує запис про медичний висновок кваліфікованим електронним підписом.

Система e-Health:

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

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

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

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

    1. Номер МВ (title)

    2. Тип МВ (type)

    3. Категорія МВ (category)

    4. Працівник, що створює МВ (author)

    5. Підписант (attester)

    6. Взаємодія (encounter_id)

    7. Статус МВ (status)

    8. ЗОЗ в якому створюється МВ (custodian)

    9. Статус допуску пацієнта (event.code)

    10. Період дії допуску пацієнта (event.period)

  3. Перевіряє, що передане значення номеру МВ (title) є унікальним серед:

    1. Медичних висновків МВВ та МВКУМедичних висновків тимчасової непрацездатності та новонароджених

  4. Перевіряє, що передане значення номеру МВ (title)

    1. Було згенероване для того ж пацієнта для якого створюється медичний висновок

    2. Термін дії згенерованого номеру МВ не закінчився

  5. Перевіряє валідність заповнених полів розділу секцій мед.висновку згідно шаблону МВ залежно від типу і категорії МВ

    1. Обов'язкові секції присутні в розділі секції МВ

    2. В розділі секції МВ присутні лише секції вказані в шаблоні як обов'язкові або опційні

  6. Перевіряє валідність заповнених полів розділу секцій мед.висновку згідно таблиці валідацій: https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806152501218211078193

    1. Валідації параметрів МВ (Composition)

    2. Валідації структури розділу секцій МВ (Composition.section)

    3. Валідації контенту в розділі секцій МВ Composition.section (виконується для кожної секції)

    Генерує значення для номеру медичного висновку

    1. Номер документа (title)

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

  8. Надсилає користувачеві СМС-повідомлення з номером створеного медичного висновку відповідно до шаблону що залежить від типу медичного висновку

...

  • Генерація (МІСом) друкованої форми медичного висновку (інформаційної довідки) відбувається за шаблоном, що залежить від типу МВ і категорії МВ

  • Генерація друкованої форми медичного висновку може використовуватися лише користувачами які мають доступ до МВ за правилами АВАС. Система надання доступів (ABAC):

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор і підписант) (composition.custodian)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутність медичного висновку. (Composition)

...

 

Крок

Опис

1

Пошук медичного висновку

 

Користувач:

  1. Виконує пошук і отримання медичного висновку, що був створений раніше

2

Надсилання запиту на отримання друкованої форми медичного висновку

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806159054918215272464

Користувач:

  1. Обирає медичний висновок, для якого потрібно створити друковану форму

  2. Відправляє запит на отримання друкованної форми медичного висновку, вказуючи

    1. Ідентифікатор медичного висновку

    2. Ідентифікатор пацієнта

Система e-Health:

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

    1. Валідність токену доступу

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

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

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

  3. Перевіряє валідність переданих даних відповідно до бізнес правил:

    1. Ідентифікатор МВ стосується персони, що передана в параметрі Ідентифікатор персони

  4. Повертає результати успішного виконання запиту (з друкованою формою згенерованою за шаблоном залежно від типу МВ COMPOSITION_MVV_PRINTFORM_TEMPLATE \COMPOSITION_MVKU_PRINTFORM_TEMPLATE) або причину його відхилення

...

 

Крок

Опис

1

Пошук медичного висновку

 

Користувач:

  1. Виконує пошук медичного висновку, що був створений раніше

2

Відправка запиту на повторне відправлення SMS пацієнту[NEW] Resend SMS on Composition Create

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/18217467908

Користувач:

  1. Обирає медичний висновок, для якого потрібно повторно відправити SMS-повідомлення з інформацією про створення

Система e-Health:

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

    1. Валідність токену доступу

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

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

  3. Перевіряє валідність переданих даних відповідно до бізнес правил:

    1. Виконати повторну відправку SMS з інформацією про створення медвисновку можна лише для МВ в статусі FINAL

  4. Перевіряє наявність у пацієнта відповідного типу аутентифікації (OTP)

  5. Перевіряє, чи не перевищено користувачем ліміт запитів на повторне відправлення SMS-повідомлень

    1. У разі, якщо ліміт запитів на даний момент перевищено, Система повертає причину відхилення запиту з указанням часу (UTC), коли користувачу буде доступна наступна спроба

  6. Надсилає SMS-повідомлення відповідно до шаблону що залежить від типу МВ

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

...

  • Пошук медичного висновку за параметрами повертає лише коротку інформацію про МВ. Метод може використовуватися користувачами, які не мають доступу на вказаний ресурс Composition, який містить дані по МВ (доступ без АВАС).

  • Отримання деталей медичного висновку за ідентифікатором може використовуватися лише користувачами які мають доступ до МВ за правилами АВАС. Повертається увесь об’єкт Composition включно з секціями та ЕМЗ включеними в секції. Отриманння цих ЕМЗ лікарем можливе за наявності у лікаря доступу згідно правил АВАС (згідно існуючих доступів до forbidden-груп)

  • Доступ до методу отримання деталей за ідентифікатором відбувається з використанням існуючої системи надання доступів (ABAC)

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор і підписант) (composition.custodian)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутність медичного висновку. (Composition)

...

 

Крок

Опис

1

Здійснити пошук пацієнта
Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

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

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

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

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

  3. Повертає перелік пацієнтів, що відповідають запиту

2

Пошук медичного висновку за параметрами

https:/wiki//e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806162331418202820657

Користувач:

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

    1. Особа якої стосується МВ (subject)

    2. Взаємодія (encounter_id)(Необов'язковий параметр)

    3. Епізод (context_episode_id) (Необов'язковий параметр)

    4. Тип медичного висновку (type) (Необов'язковий параметр)

    5. Категорія медичного висновку (category) (Необов'язковий параметр)

    6. Статус медичного висновку (status) (Необов'язковий параметр)

    7. Автор МВ (author) (Необов'язковий параметр)

    8. Підписант МВ (attester) (Необов'язковий параметр)

    9. Заклад де було сформовано МВ (custodian) (Необов'язковий параметр)

    10. Дата підписання МВ (date) (Необов'язковий параметр, задається діапазоном дат)

    11. Номер медичного висновку (title) (Необов'язковий параметр)

Система e-Health:

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

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

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

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

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

    1. id

    2. status

    3. type

    4. category

    5. date

    6. title

    7. encounter

    8. custodian

    9. author

    10. attester

    11. context_episode_id

3

Отримання медичного висновку за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806109904818201772088

Користувач:

  1. Вводить збережений раніше ідентифікатор медичного висновку

Система e-Health:

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

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

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

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

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

  3. Повертає результати успішного виконання запиту або причину його відхилення. Повертається увесь об’єкт Composition включно з секціями та ЕМЗ включеними в секції. Отриманння цих ЕМЗ лікарем можливе за наявності у лікаря доступу згідно правил АВАС (згідно існуючих доступів до forbidden-груп)

4

Отримання деталей ЕМЗ (залежно від типу) за ідентифікатором в контексті медичного висновку
висновку 

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806132840818212978905

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806155777818215338166

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806103350618214551695

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806106629518215108712

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806018173718212978946

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806132841818212978968

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1805890393718214355079

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806159056118215239785

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806149227718215403826

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806145948918214224255

 

Користувач:

  1. Вводить отриманий раніше ідентифікатор ЕМЗ

Система e-Health:

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

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

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

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

    Перевіряє чи активний запис про пацієнта по якому запитується інформація

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

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

...

 

Крок

Опис

1

Пошук МВ за параметрами та отримання МВ за ідентифікатором

Користувач:

  1. В разі потреби виконує пошук облікованого раніше медичного висновку який потрібно позначити помилковими (див. “Пошук медичного висновку за параметрами”)

2

Надсилання запиту на позначення медичного висновку помилковим

https://e-health-ua.atlassian.net/wiki/spaces/emalEH/pages/1806159059118216615976

Користувач:

  1. Обирає МВ, який хоче позначити помилковим

  2. Обирає причину встановлення помилкового статусу

  3. Додає тестовий коментар про причину скасування мед.висновку

  4. Надсилає запит на позначення МВ помилковим з накладанням КЕП.

Система e-Health:

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

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

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

    3. Користувач який позначає запис помилковим належить до того ж закладу (або закладу з якого було реорганізовано цей заклад), де було створено МВ, який позначається помилковими

  2. Перевіряє валідність заповнених значень

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

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

    3. Текстовий коментар про причину скасування мед.висновку не порожній

    4. Період між датою створення МВ і датою позначення його помилковим лежить у вказаному діапазоні. В перевірці застосовується конфігураційний файл “Максимально і мінімально дозволена к-ть днів між датою створення МВ і датою позначення МВ помилковим в залежності від Типу МВ і Категорії МВ

  3. Змінює статус медичного висновку (відповідно до статусної моделі) на Позначений помилковим (ENTERED_IN_ERROR)

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

  5. В разі успішного позначення МВ помилковим надсилає користувачеві СМС-повідомлення з номером позначеного помилковим медичного висновку відповідно до шаблону що залежить від типу медичного висновку

...

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

Визначення актуального стану допуску МВВ https://e-health-ua.atlassian.net/wiki/pages/createpage.action?spaceKey=emal&title=%5BNEW%5D%20Get%20Actual%20Access%20Status%20for%20Drivers&linkCreation=true&fromPageId=18060181712

 

Крок

Опис

1

1

Визначення актуального стану допуску МВВ

 

Користувач:

  1. Заповнює параметри запиту:

    • ПІБ

    • УНЗР

    • РНОКПП

    • Тип документа

    • Реквізити документа (номер і серія)

    • Номер МВ (compositiom.title)

  2. Надсилає запит на визначення актуального стану допуску для медичного висновку водія

Система e-Health:

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

    1. ПІБ пацієнта

    2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

    3. Номер медичного висновку

  2. Перевіряє що медичний висновок з вказаним номером існує і його тип це “Медичний висновок водія”

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

  4. Повертає інформацію про актуальний стану допуску для всіх категорій:

    1. Категорія МВ

    2. Статус допуску

    3. Термін початку дії

    4. Термін закінчення дії (для статусу допуску “Допущено”)

    5. Додаткові умови допуску (для статусу допуску “Допущено”)

...

 

Крок

Опис

1

Визначення актуального стану допуску МВКУ

https://e-health-ua.atlassian.net/wiki/pages/createpage.action?spaceKey=emal&title=%5BNEW%5D%20Get%20Actual%20Access%20Status%20for%20Adopters&linkCreation=true&fromPageId=18060181712

 

Користувач:

  1. Заповнює параметри запиту:

    • ПІБ

    • УНЗР

    • РНОКПП

    • Тип документа

    • Реквізити документа (номер і серія)

    • Номер МВ (compositiom.title)

  2. Надсилає запит на визначення актуального стану допуску для медичного висновку кандидатів в усиновлювачі

Система e-Health:

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

    1. ПІБ пацієнта

    2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

    3. Номер медичного висновку

  2. Перевіряє що медичний висновок з вказаним номером існує і його тип це “Медичний висновок кандидата в усиновлювачі”

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

  4. Повертає інформацію про актуальний стану допуску:

    1. Статус допуску

    2. Термін початку дії

    3. Термін закінчення дії

...

  • Для методів взаємодії з зовнішніми системами правила доступу через АВАС не діють

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

 

Крок

Опис

 

Крок

Опис

1

Отримання даних медвисновку за номером (зовнішня система)/wiki/spaces/emal/pages/18061295657

 

Користувач:

  1. Заповнює параметри запиту:

    • ПІБ

    • УНЗР

    • РНОКПП

    • Тип документа

    • Реквізити документа (номер і серія)

    • Номер МВ (compositiom.title)

    • Тип МВ (type)

  2. Надсилає запит на визначення актуального стану допуску для медичного висновку кандидатів в усиновлювачі та медичного висновку водія

Система e-Health:

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

    1. ПІБ пацієнта

    2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

    3. Номер медичного висновку

    4. Тип МВ

  2. Перевіряє що медичний висновок з вказаним номером існує

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

  4. Повертає інформацію про медичний висновок:

    1. Номер МВ (title)

    2. Тип МВ (type)

    3. Категорія МВ (category)

    4. Статус МВ (status)

    5. Дата створення МВ (date)

    6. ЗОЗ що видав МВ (сustodian)

    7. Статус допуску (event.code)

    8. Період дії (event_period)

    9. Додаткові умови (extentions)