Словник
- Електронні торгові майданчики (ЕТМ, майданчики) — приватні онлайн-платформи, інтегровані з Центральною базою даних Prozorro.Sale. Через майданчики користувачі створюють лоти, подають документи, вносять гарантійні внески, роблять біди, беруть участь в аукціонах і отримують підтримку. Майданчики є комерційними партнерами Prozorro.Sale та посередниками між користувачем і ЦБД.
Бізнес дані
ТВ
Бізнес сценарії
Метою розробки - створення окремого сервісу з можливістю взаємодію через АРІ що повертає альтернативну покращену версію лоту на основі інформації, що внесена у систему організатором.
Обґрунтування
Через те, що інформація про лот створюється організатором, якість опису лоту, його відображення на порталі та на сайтах майданчиків, залежить від спроможності організатора такий опис створити. Як наслідок, можуть використовуватись неякісні зображення (особливо в якості титульного), може використовуватись довга назва.
При цьому зараз лоти з довгою назвою мають значимо кращий показник успішності.
Розробка нового рішення дозволить:
- спростити для організатора процес публікації інформації про лот
- спростити відображення інформації про лот в інтерфейсах порталу та майданчиків
Покращення які необхідно зробити для подальшої корректної роботи
На формі — дати користувачу полі description в форматі <textarea>, щоб він міг:
У БД — зберігати це як звичайний текст без змін.
На фронті — при відображенні:
1. Загальна ідея системи
Створюємо окремий сервіс-обробник тексту (middleware), який:
Отримує вхідний текст (через HTTP/API, вебхук, з форми тощо).
Проганяє його через набір правил (регекс, заміни, форматування, валідація).
Повертає відредагований текст як відповідь на запит з іншого сервісу (система ЕТМ).
Тобто всі інші системи не думають “як красиво оформити текст” — вони просто відправляють його в твій сервіс → отримують результат.
2. Основні компоненти
- Вхідний API за якиим будуть надходити запити від системи ЕТМ
- Сервіс обробки текстів
- Треба зрозуміти який варіант є кращім:
- Вхідний API за яким системи ЕТМ будуть забирати відповідь
- Синхронна/асинхронна інтеграція
Правила:
- Фотографії покращуються кожен раз при завантаженні в систему - Другий етап розробки
- Перевертати фотографії в правильне розташування
- Покращувати якість фото
- Вирівнювати горизонт
- Робота з полями: title, description
- Тільки в шаблоні "Детальний опис" за замовчуванням відображається альтернативний текст (значення полів titleAlt та descriptionAlt) якщо він є в процедурі/об'єкті та наявний елемент при активації якого можна перемкнутись на оригінальний текст (значення полів title та description)
- Для інших шаблонів використовується значення полів title та description
- Для протоколів використовується значення полів title та description
UseCase
Use Case 1. Збреження чернетки аукціону з викликом "Системи покращення опису лоту"
Назва | Збереження чернетки процедури/реєстру/ІП |
Обґрунтування | Користувачу необхідно зберегти чернетку процедури/реєстру/ІП перед публікацією в системі |
| Актори | Організатор/Балансоутримувач |
Передумови | - Користувач авторизований в кабінеті акредитованого майданчика АТ "Прозорро.Продажі"
|
Основний хід подій (дій) | - Користувач активує елемент "Зберегти чернетку"
- Система майданчика відправляє запит в "Систему покращення опису лоту"
- Система покращення опису лоту опрацьовує поля: title, description, all images
- Система покращення опису лоту віддає результат опрацювання системі майданчика
- Система майданчика виводить повідомлення Організатору "Система згенерувала альтернативний текст в полях: title та description. Ви можете ознайомитись та прийняти його як основний, в разі не прийняття запропонований текст буде збережений як альтернативний. Ознайомитись ?"
- Якщо коритстувач активує елемент "Так"→ :
- Cистема майданчика виводить дві варіації інформації в полях: title та description
- Система майданчика виводить активний елемент "Замінити"
- Якщо користувач активує елемент "Замінити"
- Система майданчика замінює теста в полях процедури title та description
- Користувач активує елемент "Зберегти чернетку"
- Система майданчика зберігає чернетку процедури/реєстру/ІП
- Якщо користувач не активував елемент "Замінити" але активував елемент "Зберегти чернетку"
- Система майданчика не вносить зміни в поля процедури/реєстру/ІП title та description
- Система майданчика зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП: titleAlt та descriptionAlt
- Якщо користувач активує елемент "Ні" → Cистема закриває повідомлення та зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП titleAlt та descriptionAlt
|
Альтернативні шляхи, помилки, крайові випадки | - Користувач редагує та повторно зберігає чернетку процедури та вже має альтернативно згенерований текст (Заповнені поля: title,description, titleAlt та descriptionAlt )
- Система майданчика повинна виділити чи були внесені зміни в полях title та description
- Якщо Так →Система майданчика відправляє запит в "Сервіс покращення опису лоту" і виконує дії відповідно до основного шляху користувача
- Якщо Ні → Система майданчика не відправляє запит в "Сервіс покращення опису лоту" та зберігає внесені зміни до полів процедури/реєстру/ІП
- Користувач редагує чернетку процедури та вже прийняв альтернативно згенерований текст (Заповнені поля: title,description та Незаповнені поля - titleAlt та descriptionAlt) можливо зробимо мета поле і по ньому майданчик перевіряє чи треба відправляти запит в "Систему покращення опису лота"
- Система майданчика не перевіряє які поля були змінені та не відправляє запит в "Систему покращення опису лота" а збегіє чернетку в виправленому варіанті
|
Результат (Постумови) | Зребежена чернета має альтернативні значення title та description |
Інші вимоги |
|
Use Case 2. Збреження чернетки аукціону
Назва | Збереження чернетки процедури/реєстру/ІП |
Обґрунтування | Користувачу необхідно зберегти чернетку процедури/реєстру/ІП перед публікацією в системі |
| Актори | Організатор/Балансоутримувач, |
Передумови | - Користувач авторизований в кабінеті акредитованого майданчика АТ "Прозорро.Продажі"
|
Основний хід подій (дій) | - Користувач активує елемент "Зберегти чернетку"
- Система майданчика відправляє запит в "Систему покращення опису лоту"
- Система покращення опису лоту опрацьовує поля: title, description, all images
- Система покращення опису лоту віддає результат опрацювання системі майданчика
- Система майданчика виводить сповіщення Організатору "Система згенерувала альтернативний текст в полях: title та description. Ви можете ознайомитись та прийняти його як основний, в разі не прийняття запропонований текст буде збережений як альтернативний"
- Система виводить повідомлення "Дана дія є незворотньою. Підтверджуєте ?"
- Якщо коритстувач активує елемент "Так"→ :
- Cистема змінює статус користувача на inactive
- Якщо користувач активує елемент "Ні" → Cистема закриває повідомлення і не змінює статус користувача
|
Альтернативні шляхи, помилки, крайові випадки |
|
Результат (Постумови) | Користувач деактивував Адміністратора Факторингу/Адміністратора компанії Брокера |
Інші вимоги | Система зберігає історію дій |