Versions Compared

Old Version 5

changes.mady.by.user valeriia denysenko

Saved on

compared with

New Version Current

changes.mady.by.user Filip Kuzmin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Бізнес дані

ТВ

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

...

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

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

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

...

  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.

UseCase

Use Case 1. Відправка запиту на створення альтернативної версії полів через сервіс покращення опису лоту

Назва

Відправка запиту на створення альтернативної версії полів через сервіс покращення опису лоту

Актори

Системні: ЦБД (майданчик), Сервіс покращення опису лоту

Передумови

  1. Процедура опублікована в ЦБД

Основний хід подій (дій)

  1. Як тільки процедура публікується організатором в ЦБД, ЦБД відправляє запит в систему покращення опису лоту з полями title, description.
  2. Сервіс покращення опису лоту обробляє дані та генерує titleAlt, descriptionAlt.
  3. Сервіс записує результати опрацювання (значення полів  titleAlt, descriptionAlt) в metaInfo процедури.

Альтернативні шляхи, помилки, крайові випадки

  1. Система покращення опису лоту не створила альтернативні варіанти
  2. Система покращення опису лоту не відповідає

Результат (Постумови)

  1. Альтернативні значення titleAlt, descriptionAlt збережені  в metaInfo процедури.

Інші вимоги


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

Назва

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

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


Актори

Системні: ЕТМ (майданчик), Портал Prozorro.Sale

Передумови

  1. Існує процедура з полями title, description - в процедурі та titleAlt, descriptionAlt - в metaInfo

Основний хід подій (дій)

  1. Портал Prozorro.Sale використовує значення title/description для відображення в загальних списках та протоколах.
  2. У шаблоні "Детальний опис"
    1. на порталі ПП за замовченням відображаться альтернативна версія titleAlt/descriptionAlt 
    2. майданчику може відображатися або оригінальна версія або альтернативна (якщо це передбачено інтерфейсом).

Альтернативні шляхи, помилки, крайові випадки

  1. В разі відсутності полів titleAlt/descriptionAlt необхідно відображати значення з полів title/description без можливості перемикання на альтернативний текст

Результат (Постумови)

  1. Для користувачів порталу доступний альтернативний та основний title та description

Інші вимоги


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

Назва

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

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


Актори

Основний: Учасник, гість порталу, Організатор.

Системні: Портал Prozorro.Sale, ЕТМ

Передумови

  1. Для лоту існують поля title/description та альтернативні titleAlt/descriptionAlt

Основний хід подій (дій)

  1. Користувач відкриває сторінку лоту в шаблоні "Детальний опис".
  2. Система перевіряє наявність titleAlt/descriptionAlt.
  3. Якщо альтернативний опис є — за замовчуванням відображається він.
  4. Користувачу доступний перемикач "Альтернативний / Оригінальний опис".
  5. При перемиканні інтерфейс оновлює відображувані поля без додаткових запитів до бекенду (якщо всі дані вже отримані)

Альтернативні шляхи, помилки, крайові випадки


Результат (Постумови)

Користувач має прозорий доступ до обох версій опису лоту

Інші вимоги


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

Назва

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

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


Актори

Основний: Адміністратор Prozorro.Sale або відповідальний аналітик.

Системні: Внутрішній сервіс/скрипт, Сервіс покращення опису лоту

Передумови

  1. Існує масив уже опублікованих або активних лотів без альтернативного опису

Основний хід подій (дій)

  1. Адміністратор ініціює масову обробку (через внутрішній інструмент або планове завдання).
  2. Система по черзі або пакетами відправляє дані лотів до сервісу покращення опису лоту.
  3. Сервіс повертає згенеровані titleAlt/descriptionAlt.
  4. Результати зберігаються у metaInfo лотів.
  5. Інтерфейси порталу/майданчиків автоматично починають використовувати альтернативні|jосновні описи в "Детальному описі" (за потреби — після додаткового схвалення)

Альтернативні шляхи, помилки, крайові випадки


Результат (Постумови)

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

Інші вимоги

Не робимо перегенерацію всіх старих  title/description тільки для тих на яких буде вчитись система

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

Назва

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

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


Актори

Основний: Адміністратор / DevOps / Підтримка.

Системні: Сервіс покращення опису лоту, системи моніторингу

Передумови

  1. Сервіс покращення опису лоту розгорнутий у промисловому середовищі

Основний хід подій (дій)

  1. Адміністратор переглядає дашборди стану сервісу (доступність, час відповіді, кількість помилок).
  2. За потреби вмикає/вимикає окремі версії ruleset або інтеграцію для окремих майданчиків.
  3. Аналізує логи проблемних запитів та, за потреби, передає інформацію команді розробки

Альтернативні шляхи, помилки, крайові випадки


Результат (Постумови)

Сервіс покращення опису лоту підтримується у стабільному та контрольованому стані

Інші вимоги