Сервіс покращення опису лоту POC

Бізнес дані

ТВ

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

Бізнес мета

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

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

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

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

Розробка рішення дозволить:

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

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

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

На формі майданчика - В разі якщо будемо міняти і основний description

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

У БД для альтернативних полів title та description:

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

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

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

Загальна архітектура системи

Створюється окремий middleware-сервіс — “Система покращення опису лоту”, який працює як незалежний компонент

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

1. ЦБД надсилає запит в сервіс з даними (title та description) по опублікованому аукціону в момент його оголошешення (datePublished).
2. Система отримує вхідні дані (title, description) через API - ?.
3. Проганяє їх через набір правил (регулярні вирази, форматування, валідація, ML-моделі).
4. Формує альтернативні версії полів (titleAlt, descriptionAlt).
5. Записує результат обробки даних полів (titleAlt, descriptionAlt) в metaInfo відповідної процедури.

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

1. Вхідний API сервісу покращення опису лоту (REST/HTTP).
2. Модуль обробки текстів (форматування, правила побудови titleAlt, descriptionAlt).

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

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