Підсистема симуляції API зовнішніх систем

🌐 Цей документ доступний українською та англійською мовами. Використовуйте перемикач у правому верхньому куті, щоб змінити версію.

1. Загальний опис

Підсистема симуляції API зовнішніх систем забезпечує можливості по розробці та тестуванню реєстру в ізоляції від зовнішніх систем.

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

2. Функції підсистеми

  • Симуляція API зовнішніх систем в рамках виконання бізнес-процесів

  • Симуляція віджету підпису даних в функціональних сценаріях накладання підпису та автентифікації користувачів кабінетів

3. Технічний дизайн підсистеми

На даній діаграмі зображено компоненти, які входять в Підсистема симуляції API зовнішніх систем та їх взаємодію з іншими підсистемами в рамках реалізації функціональних сценаріїв.

ext systems simulation design

Підсистема симуляції API зовнішніх систем представлена двома компонентами, які відповідають за мокування основних інтеграційних сценаріїв реєстру з зовнішніми системами:

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

  • Сервер симуляції API зовнішніх систем - сервер симуляції API на базі Wiremock, який підтримує REST та SOAP протоколи інтеграції.

4. Складові підсистеми

Назва компоненти Представлення в реєстрі Походження Репозиторій Призначення

Віджет симуляції підпису даних

sign-widget-mock

origin

gerrit:/mdtu-ddm/low-code-platform/mock/sign-widget-mock

Статична копія віджету підпису

Сервер симуляції API зовнішніх систем

wiremock

3rd-party

gerrit:/mdtu-ddm/general/wiremock

Сервер мокування API зовнішніх систем з підтримкою декларативного підходу до опису контрактів

Мок-сервіс інтеграції з ЄДР

trembita-edr-registry-mock

origin [deprecated]

gerrit:/mdtu-ddm/low-code-platform/mock/trembita-edr-registry-mock

Сервіс мокування SOAP API реєстру ЄДР

Мок-сервіс інтеграції з ДРАЦС

trembita-dracs-registry-mock

origin [deprecated]

gerrit:/mdtu-ddm/low-code-platform/mock/trembita-dracs-registry-mock

Сервіс мокування SOAP API реєстру ДРАЦС

Мок-сервіс інтеграції з ЄІБДВПО

trembita-idp-mock-server

origin [deprecated]

gerrit:/mdtu-ddm/low-code-platform/mock/trembita-idp-mock-server

Сервіс мокування SOAP API ЄІБДВПО

5. Технологічний стек

При проектуванні та розробці підсистеми, були використані наступні технології:

6. Атрибути якості підсистеми

6.1. Testability

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