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

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

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

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

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

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

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

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

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

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

ext systems simulation design

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

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

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

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

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

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

sign-widget-mock

origin

github:/epam/edp-ddm-sign-widget-mock

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

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

wiremock

3rd-party

github:/epam/edp-ddm-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 зовнішніх систем забезпечує можливості тестування реєстру з симуляцією різних сценаріїв поведінки зовнішніх систем та проводити перевірку коректності опрацювання результатів, помилок, тимчасової недоступності зовнішніх систем, сповільнення їх швидкодії, тощо.