Page History

Словник

1. Електронні торгові майданчики (ЕТМ - електронний торгівельний майданчик, майданчики) — приватні онлайн-платформи, інтегровані з Центральною базою даних Prozorro.Sale. Через майданчики користувачі створюють лоти, подають документи, вносять гарантійні внески, роблять біди, беруть участь в аукціонах і отримують підтримку. Майданчики є комерційними партнерами Prozorro.Sale та посередниками між користувачем і ЦБД.

Бізнес дані

ТВ

Бізнес сценарії

Бізнес мета

Метою розробки -  створення окремого сервісу з можливістю взаємодію через АРІ що повертає альтернативну покращену версію лоту на основі інформації, що внесена внесеної у систему організатором.

Обґрунтування

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

При цьому зараз лоти з довгою назвою мають значимо кращий показник успішності. 

...

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

Покращення які необхідно зробити для подальшої корректної роботи

• можливо підвищити конверсію перегляд → участь за рахунок більш зрозумілого та структурованого опису

Техічні вимоги

Технічні вимоги до введення тексту

На формі майданчика:

1. надати користувачу поле description у форматі <textarea>;
2. дозволити як ручне введення з переносами рядків (Enter), так і вставку тексту

   На формі — дати користувачу в полі description <textarea>, щоб він міг:

3. або надрукувати блок з Enter-ами;

або вставити з Word.

У БД:

1. — зберігати це текст як звичайний текст (plain text) без змін .і додаткового форматування

На фронті

...

при відображенні:

1. або контейнер з використовувати CSS-властивість white-space: pre-wrap для збереження переносів рядків;
2. або заміна виконувати заміну символів нового рядка \n → на <br> .при рендері

...

Загальна

...

архітектура системи

Створюємо Створюється окремий сервіс-обробник тексту (middleware), який:

1. Отримує вхідний текст (через HTTP/API, вебхук, з форми тощо).

2. Проганяє його через набір правил (регекс, заміни, форматування, валідація).

3. Повертає відредагований текст як відповідь на запит з іншого сервісу (система ЕТМ).

Тобто всі інші системи не думають “як красиво оформити текст” — вони просто відправляють його в твій сервіс → отримують результат.

Правила:

middleware-сервіс — “Система покращення опису лоту”, який працює як незалежний компонент і може бути викликаний з різних майданчиків (ЕТМ) та інших внутрішніх сервісів.

Основні кроки роботи сервісу:

1. Отримує вхідні дані (title, description, images та інші метадані) через HTTP/API.
2. Проганяє їх через набір правил (регулярні вирази, форматування, валідація, ML-моделі).
3. Формує альтернативні версії полів (titleAlt, descriptionAlt, imagesEnhanced).
4. Повертає результат як відповідь на запит системи ЕТМ.
5. При погодженні Організатором заміни оригінального тексту альтернативним заповнюється meta поля alternativeTitle = true та alternativeDescription = true в залежності яке поле погоджено поля набуваються значення false в разі не погодження Організатором викорисання

Основні компоненти:

1. Вхідний API сервісу покращення опису лоту (REST/HTTP).
2. Модуль обробки текстів (форматування, правила побудови title/description).
3. (2-й етап) Модуль обробки зображень (покращення якості, вирівнювання горизонту тощо).
4. Інтеграція з ЕТМ (синхронна або асинхронна модель взаємодії).

Правила обробки:

1. Робота з полями title та description
   1. Формування структурованих описів із переносами рядків і логічними блоками.
   2. Збереження змісту критично важливих даних (кадастровий номер, площа, адреса тощо).
   3. Генерація альтернативних полів: titleAlt та descriptionAlt.
   4. Контроль максимальної довжини назви та опису (з урахуванням встановленних обмежень ЦБД).
2. Використання альтернативного тексту в інтерфейсах
   1. У
3. Фотографії покращуються кожен раз при завантаженні в систему - Другий етап розробки
   1. Перевертати фотографії в правильне розташування
   2. Покращувати якість фото
   3. Вирівнювати горизонт
4. Робота з полями: title, description
   1. Тільки в шаблоні "Детальний опис" за замовчуванням відображається альтернативний текст (значення полів titleAlt та , descriptionAlt) якщо він є в процедурі/об'єкті та наявний елемент при активації якого можна перемкнутись на оригінальний текст (, якщо він існує, з можливістю перемикання на оригінальний (title, description).
   2. Для інших шаблонів використовується значення полів title та description).
   3. Для інших шаблонів протоколів завжди використовується значення полів title та description.
5. Обробка фотографій (2-й етап розробки)
   1. Перевертати фотографії в правильне розташування (орієнтація).
   2. Покращувати якість фото (контраст, різкість, яскравість у межах допустимого).
   3. Вирівнювати горизонт (особливо для фото об’єктів нерухомості).
   4. Позначати зображення як оброблені (флаг enhanced = true) для уникнення повторної обробки.

Додаткові технічні аспекти:

1. Інтеграція та безпека
   1. Аутентифікація майданчиків через API ключі / OAuth2 / mTLS.
   2. Обмеження доступу до сервісу (whitelist IP, rate limiting).
   3. Логування запитів та відповідей (без розкриття чутливих даних).
2. Версіонування правил
   1. Введення версії ruleset (наприклад, "land_description:v1").
   2. Можливість A/B-тестування різних версій правил для різних майданчиків.
3. Логування та аудит
   1. Збереження інформації про факт звернення до сервісу, результат, помилки.
   2. Можливість відтворити історію змін опису лоту.

UseCase

Use Case 1.

...

Збереження чернетки

...

з генерацією альтернативного опису лоту

...

Назва	Збереження чернетки процедури/реєстру/ІП	Обґрунтування	Користувачу необхідно зберегти чернетку процедури/реєстру/ІП перед публікацією в системіз генерацією альтернативного опису лоту
Актори	Основний: Організатор / Балансоутримувач. Системні: ЕТМ (майданчик), Сервіс покращення опису лоту
Передумови	Користувач авторизований в кабінеті акредитованого майданчика АТ "Прозорро.Продажі". Створюється або редагується чернетка процедури/реєстру/ІП. Заповнені поля title та/або description
Основний хід подій (дій)	Користувач активує натискає елемент "Зберегти чернетку". Система майданчика відправляє запит в "Систему ЕТМ формує запит до Сервісу покращення опису лоту "Система покращення опису лоту опрацьовує поля: з полями title, description, all images.Система Сервіс покращення опису лоту віддає результат опрацювання системі майданчикаобробляє дані та генерує titleAlt, descriptionAlt (та за потреби imagesEnhanced). Сервіс повертає результат у систему ЕТМ. Система ЕТМ зберігає альтернативні значення у метаполях чернетки та показує повідомлення: Система майданчика виводить повідомлення Організатору "Система згенерувала альтернативний текст в полях: title та description. Ви можете ознайомитись та прийняти його як основний, в разі не прийняття запропонований текст буде збережений як альтернативний... Ознайомитись?". Якщо коритстувач активує елемент користувач обирає "Так"→ : Cистема майданчика виводить дві варіації інформації в полях: title та description Система майданчика виводить активний елемент "Замінити" Якщо користувач активує елемент "Замінити" Система майданчика замінює теста в полях процедури title та description Користувач активує елемент "Зберегти чернетку" Система майданчика зберігає чернетку процедури/реєстру/ІП Якщо користувач не активував елемент "Замінити" але активував елемент "Зберегти чернетку"  Система майданчика не вносить зміни в поля процедури/реєстру/ІП title та description Система майданчика зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП: titleAlt та descriptionAlt Якщо користувач активує елемент "Ні" → Cистема закриває повідомлення та зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП titleAlt та descriptionAlt, система виводить оригінальні та альтернативні значення title/description. Користувач може натиснути "Замінити", щоб зробити альтернативний варіант основним. Після підтвердження система ЕТМ зберігає чернетку з оновленими значеннями та поля alternativeTitle = true та alternativeDescription = true
Альтернативні шляхи, помилки, крайові випадки	Користувач обирає "Ні": чернетка зберігається без змін полів title/description, але з titleAlt/descriptionAlt у метаполях та поля alternativeTitle = false та alternativeDescription =false. Сервіс покращення опису лоту недоступний: система ЕТМ зберігає чернетку без альтернативних значень та показує інфо-повідомлення. Поля title/description порожні: сервіс повертає відповідь без альтернативи, ЕТМ зберігає чернетку без змін
Результат (Постумови)	Чернетка збережена. Альтернативні значення titleAlt, descriptionAlt збережені (якщо були згенеровані).
Інші вимоги

Use Case 2. Публікація процедури з використанням альтернативного опису на порталі/майданчику

Use Case 3. Перегляд лоту з можливістю перемикання між оригінальним та альтернативним описом

Use Case 2. Збреження чернетки аукціону

Use Case 4. Повторна генерація альтернативного опису при редагуванні чернетки

Use Case 5. Завантаження та обробка фотографій лоту (2-й етап)

Use Case 6. Масова генерація альтернативних описів для існуючих лотів (в разі batch-обробки)

Use Case 7. Обробка помилок та недоступності сервісу покращення опису лоту (fallback-сценарії)

Use Case 8. Моніторинг та адміністрування сервісу покращення опису лоту