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

RC._Процеси роботи зі зразком біоматеріалу

Owned by Mykhailo Troinin (SoE eHealth) (Unlicensed)
Last updated: Apr 29, 2024 by Vorona Oksana (NHSU)
12 min read

Мета

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

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

Облік сутності Зразок дозволить забезпечити однозначність використання даних зразка у таких процесах:

  • виконання маніпуляції забору (реєстрація зразка, як результат такої маніпуляції);

  • передача інформації про зразок від ЗОЗ до лабораторії;

  • фіксація прийому зразка в лабораторії;

  • фіксація поточного статусу зразка (помилковий, відбракований, використаний);

  • фіксації в діагностичному звіті зразка на основі якого було виконано лабораторне дослідження.

Загальний процес роботи зі Зразком

specimen.drawio.png

 

Source:

Створення Зразка

Створення Зразка при взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

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

Користувач:

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

Система ЕСОЗ:

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

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

  3. Повертає перелік Пацієнтів

2

Заповнити дані зразка та маніпуляції

Користувач:

  1. Обирає необхідного Пацієнта (subject)

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

    1. Отримання даних з довідників, які використовуються при заповненні даних Зразка, виконується на загальних підставах та знаходиться за рамками процесу

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

    3. При заповненні Зразка користувач вказує:

      1. тип (type)

      2. статус (status):

        1. доступний (available), якщо лікар не робить Діагностичний звіт (diagnostic_report) та/чи Спостереження (observation), що посилаються на такий зразок (specimen) в пакеті взаємодії

        2. недоступний (unavailable), якщо лікар робить Діагностичний звіт (diagnostic_report) та/чи Спостереження (observation), що посилаються на такий зразок (specimen) в пакеті взаємодії

      3. батьківський Зразок (parent), якщо поточний Зразок реєструється, як похідний

      4. посилання на Направлення (request), якщо Зразок створюється на його підставі

      5. інформацію про маніпуляцію щодо забору біоматеріалу/ виділення зразка з існуючого (collection):

        1. хто виконав забір (collector)

        2. коли виконано збір (collected_date_time або collected_period)

        3. тривалість збору (duration)

        4. кількість матеріалу (quantity)

        5. в який спосіб виконано збір (method)

        6. з якої частини тіла виконано збір (body_site)

        7. утримання/дієти перед забором (fasting_status_codeable_concept)

        8. посилання на процедуру (procedure), якщо отримання біоматеріалу було отримано в результаті неї

      6. інформацію про контейнер (ємність) в якій зберігається взятий Зразок (container)

        1. ідентифікатор (identifier)

        2. тип контейнеру (type)

        3. об’єм (capacity)

        4. об’єм біоматеріалу в контейнері (specimen_quantity)

        5. додана речовина (additive_codeable_concept)

      7. стан Зразка (condition)

      8. необхідні коментарі щодо Зразка/процесу забору (note)

      9. заклад, в якому створюється Зразок (managing_organization)

      10. взаємодію, за якою створюється Зразок (context)

      11. автор запису (registered_by)

  3. Створення Зразка повинно відбуватися в рамках Encounter Data Package при взаємодії з пацієнтом з виконанням відповідних правил подачі пакету взаємодії. Детальніше див. Реєстрація результатів візиту в ЦК

3

Накласти КЕП та відправити запит на створення
Submit Encounter Package

Користувач:

  1. Накладає КЕП на відповідний запит для створення Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Подати пакет взаємодії з пацієнтом з обліком Зразка може медичний працівник за наявності прав “encounter:write”

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

    1. Пацієнт, якому створюється Зразок, повинен бути активним (acive) та не неверифікованим (не NOT_VERIFIED)

    2. Посилання на батьківський Зразок (за наявності):

      1. має статус доступний (available)

      2. відноситься до того ж Пацієнта, що і поточний Зразок

    3. Посилання на Направлення (request) (за наявності):

      1. має статус активне (active)

      2. має статус обробки активне (active) або в роботі (in_progress), але в рамках поточного закладу

      3. відноситься до того ж Пацієнта, що і Зразок

    4. Усі параметри Зразку, які заповнюються з довідників повинні містити значення, що відповідають можливим кодам відповідних довідників (Детальніше див. RC._Specimen dictionaries and configurable parameters_EN)

    5. Статус (status):

      1. доступний (available), якщо лікар не робить Діагностичний звіт (diagnostic_report) та/чи Спостереження (observation), що посилаються на такий зразок (specimen) в пакеті взаємодії

      2. недоступний (unavailable), якщо лікар робить Діагностичний звіт (diagnostic_report) та/чи Спостереження (observation), що посилаються на такий зразок (specimen) в пакеті взаємодії

    6. Значення параметру collected_date_time (або collected_period.start) може дорівнювати поточній даті або бути менше поточної відповідно конфігурації ENCOUNTER_MAX_DAYS_PASSED

    7. Значення параметру received_time (якщо лікар проводить діагностику та/чи обстеження, що посилаються на такий зразок у пакеті взаємодії) може дорівнювати поточній даті та не бути менше collected_date_time (або collected_period.start)

    8. Кількість, що вказана в параметрі collection.quantity в сумі по всім контейнерам не може бути більша ніж вказано в параметрі container.specimen_quantity та може бути тільки додатньою та відмінною від нуля

    9. Кількість, що вказана в параметрі container.specimen_quantity може бути тільки додатньою та відмінною від нуля

    10. Кількість, що вказана в параметрі container.capacity може бути тільки додатньою та відмінною від нуля

    11. Ідентифікатор, який вказаний, в параметрі context має існувати в ЦБД, відноситись до того ж Пацієнта, належати ресурсу Взаємодія і бути в статусі відмінним від entered_in_error.

    12. Ідентифікатор, який вказаний, в параметрі collection.procedure має існувати в ЦБД, відноситись до того ж Пацієнта, належати ресурсу Процедура і бути в статусі відмінним від entered_in_error.

    13. Тривалість (duration) (за наявності), може вимірюватись тільки у хвилинах (minutes), годинах (hours), днях (days), а значення можуть бути тільки додатніми та відмінними від нуля

    14. Хто зібрав (collection.collector) біоматеріал може містити посилання на ресурс Співробітник або Пацієнт.

    15. Автор запису (registered_by) має підтверджений (approved) статус, належить до Закладу (managing_organization) та відноситься до користувача, що виконує запит

    16. Заклад має активний (ACTIVE) або призупинений (SUSPENDED) статус та співпадає з клієнтом користувача, що виконує запит

  3. Якщо передані дані валідні, підписаний контент зберігається в сховище даних та система створює запис у статусі available чи unavailable (залежно від умов пункту 2.e):

    1. Повертає до визиваючої сторони ідентифікатор завдання із створення Зразка

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

    2. Генерує унікальний людиночитаємий ідентифікатор (accession_identifier)

Створення Зразка без взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

Отримати ідентифікатор пацієнта

Користувач:

  1. Отримує ідентифікатор пацієнта

2

Заповнити дані зразка та маніпуляції

Користувач:

  1. Обирає необхідного Пацієнта (subject)

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

    1. Отримання даних з довідників, які використовуються при заповненні даних Зразка, виконується на загальних підставах та знаходиться за рамками процесу

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

    3. При заповненні Зразка користувач вказує:

      1. тип (type)

      2. статус (status):

        1. доступний (available)

      3. батьківський Зразок (parent), якщо поточний Зразок реєструється, як похідний

      4. посилання на Направлення (request), якщо Зразок створюється на його підставі

      5. інформацію про маніпуляцію щодо забору біоматеріалу/ виділення зразка з існуючого (collection):

        1. хто виконав забір (collector)

        2. коли виконано збір (collected_date_time або collected_period)

        3. тривалість збору (duration)

        4. кількість матеріалу (quantity)

        5. в який спосіб виконано збір (method)

        6. з якої частини тіла виконано збір (body_site)

        7. утримання/дієти перед забором (fasting_status_codeable_concept)

      6. інформацію про контейнер (ємність) в якій зберігається взятий Зразок (container)

        1. ідентифікатор (identifier)

        2. тип контейнеру (type)

        3. об’єм (capacity)

        4. об’єм біоматеріалу в контейнері (specimen_quantity)

        5. додана речовина (additive_codeable_concept)

      7. стан Зразка (condition)

      8. необхідні коментарі щодо Зразка/процесу забору (note)

      9. заклад, в якому створюється Зразок (managing_organization)

      10. автор запису (registered_by)

3

Накласти КЕП та відправити запит на створення

RC._Create Specimen_EN

Користувач:

  1. Накладає КЕП на відповідний запит для створення Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Подати пакет взаємодії з пацієнтом з обліком Зразка може медичний працівник за наявності прав “specimen:write”

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

    1. Пацієнт, якому створюється Зразок, повинен бути активним (acive) та не неверифікованим (не NOT_VERIFIED)

    2. Посилання на батьківський Зразок (за наявності):

      1. має статус доступний (available)

      2. відноситься до того ж Пацієнта, що і поточний Зразок

    3. Посилання на Направлення (request) (за наявності):

      1. має статус активне (active)

      2. має статус обробки активне (active) або в роботі (in_progress), але в рамках поточного закладу

      3. відноситься до того ж Пацієнта, що і Зразок

    4. Усі параметри Зразку, які заповнюються з довідників повинні містити значення, що відповідають можливим кодам відповідних довідників (Детальніше див. RC._Specimen dictionaries and configurable parameters_EN)

    5. Значення параметру collected_date (або collected_period.start) може дорівнювати поточній даті або бути менше поточної відповідно конфігурації SPECIMEN_MAX_DAYS_PASSED

    6. Кількість, що вказана в параметрі collection.quantity в сумі по всім контейнерам не може бути більша ніж вказано в параметрі container.specimen_quantity та може бути тільки додатньою та відмінною від нуля

    7. Кількість, що вказана в параметрі container.specimen_quantity може бути тільки додатньою та відмінною від нуля

    8. Кількість, що вказана в параметрі container.capacity може бути тільки додатньою та відмінною від нуля

    9. Тривалість (duration) (за наявності), може вимірюватись тільки у хвилинах (minutes), годинах (hours), днях (days), а значення можуть бути тільки додатніми та відмінними від нуля

    10. Хто зібрав (collection.collector) біоматеріал може містити посилання на ресурс Співробітник або Пацієнт.

    11. Автор запису (registered_by) має підтверджений (approved) статус, належить до Закладу (managing_organization) та відноситься до користувача, що виконує запит

    12. Заклад має активний (ACTIVE) або призупинений (SUSPENDED) статус та співпадає з клієнтом користувача, що виконує запит

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

    1. Повертає до визиваючої сторони ідентифікатор завдання із створення Зразка

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

    2. Генерує унікальний людиночитаємий ідентифікатор (accession_identifier)

Отримання Зразка

Отримання інформації Зразка при взаємодії з пацієнтом

 

Source:

Крок

Опис

Крок

Опис

1

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

Користувач:

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

Система ЕСОЗ:

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

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

  3. Повертає перелік Пацієнтів

2

Отримати Зразки за пошуковими параметрами
RC._Get Specimen by search params_EN

Користувач:

  1. Обирає необхідного Пацієнта

  2. Виконує пошук Зразків

Система ЕСОЗ:

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

    1. Доступ до інформації Зразків відбувається з використанням існуючої системи надання доступів до даних Пацієнта.

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

    1. Статус (status)

    2. Тип матеріалу (type)

    3. Автор запису (registered_by)

    4. Хто виконав забір (collection.collector)

    5. Дата-час виконання забору (collected_date_time або collected_period)

    6. Ідентифікатор контейнера (сontainer.identifier)

    7. Тип контейнера (сontainer.type)

    8. Ідентифікатор батьківського Зразку (parent)

    9. Ідентифікатор Направлення (request)

    10. Ідентифікатор Взаємодії (encounter)

  3. Повертає перелік Зразків

3

Отримати деталі Зразка за його ідентифікатором
RC._Get Specimen details_EN

Користувач:

  1. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

    1. Доступ до інформації Зразка відбувається з використанням існуючої системи надання доступів до даних Пацієнта

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

  3. Повертає деталі Зразка

Отримання інформації Зразка без взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

Отримати Зразки за людиночитаємим ідентифікатором
RC._Get Specimen by accession identifier_EN

Користувач:

  1. Виконує пошук Зразків

Система ЕСОЗ:

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

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

    1. Людиночитаємий ідентифікатор Зразка (accession_identifier)

  3. Повертає Зразок

Облік дати та часу отримання Зразка

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані дати та часу отримання Зразка

Користувач:

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

  2. Вказує дату та час отримання Зразка (received_time)

3

Відправити запит на позначення дати та часу отримання Зразка
RC._Process Specimen_EN

Користувач:

  1. Відправити запит для вказання дати та часу отримання Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Позначити дату отримання в лабораторії може медичний працівник за наявності прав “specimen:process”

  2. Перевіряє поточний стан Зразка (available)

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

    1. Значення received_time може дорівнювати поточній даті та не бути менше collected_date_time (або collected_period.start)

  4. Якщо передані дані валідні, система зберігає запис із вказаним значенням received_time

    1. Повертає до визиваючої сторони ідентифікатор завдання із створення Зразка

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

Позначення Зразка помилковим

Позначення Зразка помилковим при взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані та вказати причину відміни

Користувач:

  1. Обирає Зразок, який необхідно позначити помилковим (відмінити)

  2. Вказує причину відміни Зразка

3

Накласти КЕП та відправити запит на відміну
Cancel Encounter Package

Користувач:

  1. Накладає КЕП на відповідний запит для відміни Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

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

  2. Перевіряє поточний стан Зразка (available, unavailable або unsatisfactory)

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

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

Позначення Зразка помилковим без взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані та вказати причину відміни

Користувач:

  1. Обирає Зразок, який необхідно позначити помилковим (відмінити)

  2. Вказує причину відміни Зразка

3

Накласти КЕП та відправити запит на відміну
https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629119338

Користувач:

  1. Накладає КЕП на відповідний запит для відміни Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Відкликати Зразок може медичний працівник за наявності прав “specimen:cancel”, що:

    1. автор запису (вказаний в параметрі recorded_by)

    2. адміністратор медичних даних (MED_ADMIN)

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

  2. Перевіряє поточний стан Зразка (available, unavailable або unsatisfactory)

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

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

Позначення Зразка бракованим

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані та вказати причину бракування

Користувач:

  1. Обирає Зразок, який необхідно позначити бракованим

  2. Вказує причину відбраковки Зразка

3

Відправити запит на бракування
https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629119322

Користувач:

  1. Відправити запит для бракування Зразка

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Відбракувати Зразок може медичний працівник за наявності прав “specimen:reject”

  2. Перевіряє поточний стан Зразка (available)

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

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

Позначення Зразка недоступним

Позначення Зразка недоступним без взаємодії з пацієнтом

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані та вказати причину відміни

Користувач:

  1. Обирає Зразок, який необхідно позначити недоступним

  2. Вказує причину позначення Зразка недоступним

3

Відправити запит на позначення запиту недоступним
https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629119354

Користувач:

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

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

  1. Перевіряє наявність прав на виконання запиту. Позначити Зразок недоступним може медичний працівник за наявності прав “specimen:invalidate”

  2. Перевіряє поточний стан Зразка (available)

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

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

Позначення Зразка недоступним (автоматично)

 

 

Source:

Крок

Опис

Крок

Опис

1

Здійснити пошук Зразка та обрати необхідний

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915#Отримання-Зразка

Користувач:

  1. Виконує пошук Зразка

  2. Обирає та переглядає деталі необхідного Зразка

Система ЕСОЗ:

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

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

  3. Повертає перелік Зразків

  4. Повертає деталі Зразка

2

Заповнити дані про дослідження

Користувач:

  1. Обирає Зразок, який потрібно вказати в дослідженні

  2. Заповнює інформацію в Діагностичному звіті (та/чи Спостереженні)

3

Накласти КЕП та відправити запит
Submit Encounter Package

 

Користувач:

  1. Накладає КЕП на відповідний запит створення Діагностичного звіту (та/чи Спостереження) в рамках взаємодії з пацієнтом чи без нього

  2. Переглядає результати обробки запиту

Система ЕСОЗ:

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

  2. Перевіряє, чи Діагностичний звіт (та/чи Спостереження) в рамках взаємодії з пацієнтом посилаються на Зразок

    1. поточний стан Зразка (available)

    2. відноситись до того ж Пацієнта (subject)

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

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

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