INFO_page: Зміни по процесам з Преперсонами для MVP неонатального скринінгу (CR-164)

Доопрацювання зроблено за CR https://e-health-ua.atlassian.net/browse/CR-164

Опис по змінах в документації:

1. Зміни функціоналу ЕСОЗ
1.1. Забезпечено введення конфігураційного параметра PREPERSON_SERVICE_REQUEST_ALLOWED_CATEGORIES. Його може змінювати адміністратор Системи.

PREPERSON_SERVICE_REQUEST_ALLOWED_CATEGORIES визначає категорії направлення, доступні для преперсони. В даному параметрі вказуються категорії направлення згідно словників "eHealth/SNOMED/service_request_categories", та перераховуються через кому, без пробілів. Даний параметр і його значення мають виглад:
PREPERSON_SERVICE_REQUEST_ALLOWED_CATEGORIES: "transfer_of_care,laboratory_procedure"

1.2. ЦБД ЕСОЗ дозволяє виписувати направлення для осіб, які зареєстровані в ЦБД ЕСОЗ за методологією неідентифікованої персони.

1.2.1. Додано відповідну валідацію в методі API CreateServiceRequest (розділ Validate service request):

4. Patient must be active

1. $.patient.identifier.type.coding[*].system == "eHealth/resources"

2. $.patient.identifier.type.coding[*].code == "patient"

3. $.patient.identifier.value refer to active MPI (is_active == true and status == 'active')

4. check if patients.preperson == true

   1. check PREPERSON_SERVICE_REQUEST_ALLOWED_CATEGORIES (values from dictionary: eHealth/SNOMED/service_request_categories) configuration according allowed categories for prepersons

      1. in case of error return 422 (Category of service request is not allowed for prepersons)

1.2.2. Додано відповідну валідацію в методі API PreQualify Service Request (розділ Validate service request):

5. Patient must be active

1. $.patient.identifier.type.coding[*].system == "eHealth/resources"

2. $.patient.identifier.type.coding[*].code == "patient"

3. $.patient.identifier.value refer to active MPI (is_active == true and status == 'active')

4. in case patients.preperson == true

   1. check PREPERSON_SERVICE_REQUEST_ALLOWED_CATEGORIES (values from dictionary: eHealth/SNOMED/service_request_categories) configuration according allowed categories for prepersons

      1. in case of error return 422 (Category of service request is not allowed for prepersons)

1.3. Забезпечено введення конфігураційного параметра SUBMIT_DIAGNOSTIC_REPORT_PACKAGE_ALLOWED_PERIOD_MINUTES. Його може змінювати адміністратор Системи.

SUBMIT_DIAGNOSTIC_REPORT_PACKAGE_ALLOWED_PERIOD_MINUTES визначає проміжок часу, протягом якого дозволено створювати діагностичний звіт пацієнту, у якого статус inactive. Валідація при створенні діагностичного звіту проходить по даті в updated_at не активної персони. Значення даного параметру мають бути представлені в хвилинах. Тобто, якщо потрібно зазначити 90 днів, то значення параметру має бути: 129600. Параметр та значення мають вигляд: SUBMIT_DIAGNOSTIC_REPORT_PACKAGE_ALLOWED_PERIOD_MINUTES: "129600"

1.4. В методі Submit Diagnostic Report Package додано валідацію, що якщо запис про пацієнта не є активний, то різниця в датах між поточним значенням дати/часу і значенням параметру updated_at запису про пацієнта повинна бути менша ніж передбачено конфігурацією.

14. Patient must be active

1. check that patients.status == active

   1. in case patients.status == inactive

      1. check mpi.persons(or mpi.prepersons if patients.preperson == true).updated_at and validate that now() - updated_at<=SUBMIT_DIAGNOSTIC_REPORT_PACKAGE_ALLOWED_PERIOD_MINUTES configuration (in minutes)

         1. in case of error return 409 (Person is not active more that the allowed time for data submitting)

1.5. Оновлено довідники :

1.5.1https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583402009/Medical+Events+Dictionaries+and+configurations#eHealth%2FLOINC%2Fobservation_codes

code name
29572-5 Фенілаланін (масова концентрація) в сухій краплі крові
38473-5 17-Гідроксипрогестерон (масова концентрація) в сухій краплі крові
48633-2 Трипсиноген I. вільний (масова концентрація) в сухій краплі крові
29575-8 Тиреотропний гормон (одиниці/об'єм) в сухій краплі крові

1.5.2 https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583402009/Medical+Events+Dictionaries+and+configurations#observation_categories-vs-observation_codes