Page History

...

Expand

title	Модель даних beneficiaries

Технічна назва			Бізнес назва (x-legalName)		Тип	Read only	Обовʼязковість (потребує уточнень)	Коментар
Технічна назва			uk_UA	en_US	Тип	Read only	Обовʼязковість (потребує уточнень)	Коментар
beneficiaries			Інформація про кінцевого бенефеціарного влсника	Information about the ultimate beneficial owner	list of objects	true	false
	fallbackstatus		Статус обробки даних		objectstring	true	false	Може бути тільки один в разі відсутності даних про КБВ	enum [processing, complete, error]
	systemReason	Системна причина відсутності даних	Systemic reason for missing data	string	true	false		excluded	Ознака виключення відомостей про КБВ за вказівкою Міністерства юстиції України	true	false
	isMissing		Ознака відсутності КБВ юридичної особи			true	false
	reason		Причина відсутності КБВ юридичної особи		string (multilang)	true	false
	informationDate		Дата отримання даних	Date of information	string ($dateTime)	true	true
	beneficiariesGeneralInfo				object	true	false	Може бути декілька. Якщо хоча б один КБВ невалідний → НЕ записується жоден
		beneficialName	ПІБ кінцевого бенефеціарного власника	Full name of the ultimate beneficial owner	string (multilang)	true	true	В запиті Прізвище це відповідь на один запит, Імʼя та По батькові - відповідь на інший запит
		address	Адреса	Address	model	true	true
		beneficiariesType	Тип бенефіціарного володіння	Type of beneficiaries	string (multilang)	true	true
		role	Роль КБВ по відношенню до пов’язаного суб’єкта		string	true	true	Відповідь на запит текстове відображення ролі (roleText)
		interest	Відсоток частки статутного капіталу або відсоток права голосу		float	true	true
		indirectInterest	Відсоток частки статутного капіталу або відсоток права голосу у разі непрямого впливу		float	true	true
		otherImpact	Інший характер та міру впливу
		beneficiaryFalse	Ознака можливої недостовірності інформації про КБВ

...

Система не повинна виконувати безкінечні повторні запити.
Інтеграція не виконується без умов
Частковий запис даних заборонений
У межах POC система не виконує:
1. Автоматичну ретро-обробку awards, створених під час зупинки інтеграції.
2. Масовий ручний запуск має мати обмеження на кількість awards за одну операцію.
3. Ручний запуск має бути доступний тільки користувачам з відповідними адміністративними правами.
4. Ручний запуск має пріоритет над статусом інтеграції
5. Ручний запуск НЕ залежить від моменту створення award
6. Масовий запуск має виконуватись асинхронно
7. Повторний запуск перезаписує beneficiaries
8. Обмеження на масовий запуск (наприклад, ≤100 awards)

Статуси обробки даних

Статус	Опис
processing	Триває обробка даних
complete	Дані внесено
error	Дані не вдалось отримати

Статуси інтеграції

Статус	Опис
`active`	Запити до ЄДР виконуються
`payment_required`	Отримано 402, запити зупинено
`rate_limit_exceeded`	Отримано 429, запити зупинено
`suspended`	Інтеграцію вручну зупинено адміністратором
auth_error	Проблема з токеном
access_denied	403
invalid_request	400/406

...

User Story 7. Відсутність автоматичної ретро-обробки

Як	ЦБД Prozorro.Sale
я хочу	Не обробляти старі awards після відновлення інтеграції
щоб	Уникнути неочікуваного навантаження та складної логіки в межах POC

USE CASE 19 — Відсутність ретро-обробки

Назва	Обробка перевищення часу очікування відповіді
Актори	ЦБД Адміністратор
Передумови	Інтеграція була в статусі: `payment_required` або `rate_limit_exceeded` або `suspended_manual` Існують awards без КБВ Інтеграцію переведено в `active`
Основний сценарій	Інтеграція відновлюється Система НЕ виконує повторну обробку існуючих awards Нові awards обробляються стандартно
Альтернативний сценарій	Адміністратор запускає ручну обробку → UC21/UC22
Результат	Старі awards залишаються без змін

Acceptance Criteria

1	Given	Інтеграція була зупинена
	And	Існують awards без КБВ
	When	Інтеграція відновлена
	Then	Обробляються тільки нові awards
2	Given	Існують старі awards
2	Then	Вони НЕ обробляються автоматично

...

User Story 8. Ручне керування інтеграцією

Як	Адміністратор ЦБД Prozorro.Sale
я хочу	Мати можливість вручну керувати інтеграцією
щоб	Контролювати її роботу незалежно від автоматичних сценаріїв

USE CASE 20 — Ручна зупинка інтеграції

Назва	Зупинка інтеграції через Адміністративну панель
Актори	ЦБД Адміністратор
Передумови	Статус інтеграції = `active`
Основний сценарій	Адміністратор відкриває адмінку Натискає “Зупинити інтеграцію” Система встановлює статус → `suspended` Нові запити до ЄДР не виконуються
Результат	Інтеграція зупинена вручну

Acceptance Criteria

1	Given	Інтеграція активна
	When	Адміністратор її зупиняє
	Then	Статус = suspended
	And	Запити до ЄДР не виконуються

...

USE CASE 21 — Ручне відновлення інтеграції

Назва	Відновлення інтеграції через Адміністративну панель
Актори	ЦБД Адміністратор
Передумови	Статус: `suspended` або `payment_required` або `rate_limit_exceeded`
Основний сценарій	Адміністратор натискає “Відновити” Система змінює статус → `active` Запити до ЄДР дозволяються
Результат	Інтеграція відновлена

Acceptance Criteria

1

Given

Інтеграція зупинена

When

Адміністратор її відновлює

Then

Статус = active

...

User Story 9. Ручний запуск інтеграції для awards

Як	Адміністратор ЦБД Prozorro.Sale
я хочу	Запускати інтеграцію для конкретних awards
щоб	Обробляти пропущені або проблемні записи

USE CASE 21 — Ручний запуск для одного award

Назва	Зупинка інтеграції через Адміністративну панель
Актори	ЦБД Адміністратор
Передумови	Award існує Користувач має права адміністратора
Основний сценарій	Адміністратор обирає award (id) Натискає “Запустити інтеграцію” Система: ігнорує тригер “тільки при створенні award” формує запит до ЄДР Обробляє відповідь стандартно Оновлює beneficiaries
Альтернативний сценарій	Інтеграція глобально зупинена → ручний запуск дозволений
Результат	beneficiaries оновлено

Acceptance Criteria

1	Given	Обрано award
	When	Адміністратор запускає інтеграцію
	Then	Виконується запит до ЄДР
	And	beneficiaries перезаписуються

...

USE CASE 22 — Масовий запуск інтеграції

Назва	Зупинка інтеграції через Адміністративну панель
Актори	ЦБД Адміністратор
Передумови	Обрано список існуючих awards Користувач має права адміністратора
Основний сценарій	Адміністратор обирає кілька awards (id) Натискає “Запустити для вибраних” Система: формує список задач відправляє їх у чергу Кожен award обробляється окремо
Альтернативний сценарій	перевищено ліміт → операція блокується
Результат	всі awards оброблені асинхронно

Acceptance Criteria

1	Given	Обрано список awards
	When	Запускається обробка
	Then	Кожен award обробляється незалежно
2	Given	Масовий запуск
2	Then	Обробка виконується через чергу

...

Space shortcuts

Page tree

Versions Compared

Old Version 55

New Version 56

Key

Статуси обробки даних

Статуси інтеграції

User Story 7. Відсутність автоматичної ретро-обробки

USE CASE 19 — Відсутність ретро-обробки

Acceptance Criteria

User Story 8. Ручне керування інтеграцією

USE CASE 20 — Ручна зупинка інтеграції

Acceptance Criteria

USE CASE 21 — Ручне відновлення інтеграції

Acceptance Criteria

User Story 9. Ручний запуск інтеграції для awards

USE CASE 21 — Ручний запуск для одного award

Acceptance Criteria

USE CASE 22 — Масовий запуск інтеграції

Acceptance Criteria