Versions Compared

Key

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

...

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

...

Назва

Збереження чернетки з генерацією альтернативного опису лоту
Актори

Основний: Організатор / Балансоутримувач.

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

Передумови

  1. Користувач авторизований в кабінеті акредитованого майданчика.
  2. Створюється або редагується чернетка процедури/реєстру/ІП.
  3. Заповнені поля title та/або description

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

  1. Користувач натискає елемент "Зберегти чернетку".
  2. Система ЕТМ формує запит до Сервісу покращення опису лоту з полями title, description, images.
  3. Сервіс покращення опису лоту обробляє дані та генерує titleAlt, descriptionAlt (та за потреби imagesEnhanced).
  4. Сервіс повертає результат у систему ЕТМ.
  5. Система ЕТМ зберігає альтернативні значення у метаполях чернетки та показує повідомлення: "Система згенерувала альтернативний текст... Ознайомитись?".
  6. Якщо користувач обирає "Так", система виводить оригінальні та альтернативні значення title/description.
  7. Користувач може натиснути "Замінити", щоб зробити альтернативний варіант основним.
  8. Після підтвердження система ЕТМ зберігає чернетку з оновленими значеннями .та поля alternativeTitle = true та alternativeDescription = true

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

  1. Користувач обирає "Ні": чернетка зберігається без змін полів title/description, але з titleAlt/descriptionAlt у метаполях та поля alternativeTitle = false та alternativeDescription =false.
  2. Сервіс покращення опису лоту недоступний: система ЕТМ зберігає чернетку без альтернативних значень та показує інфо-повідомлення.
  3. Поля title/description порожні: сервіс повертає відповідь без альтернативи, ЕТМ зберігає чернетку без змін

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

  1. Чернетка збережена.
  2. Альтернативні значення titleAlt, descriptionAlt збережені (якщо були згенеровані).

Інші вимоги


...

Назва

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

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


Актори

Основний: Організатор / Балансоутримувач.

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

Передумови

  1. Існує збережена чернетка з полями title, description та, за наявності, titleAlt, descriptionAlt

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

  1. Користувач відкриває чернетку та ініціює публікацію процедури.
  2. Система ЕТМ визначає, які поля необхідно відправити до ЦБД/порталу (title, description).
  3. Якщо користувач раніше прийняв альтернативний текст — у полях title/description вже міститься покращена версія та поля alternativeTitle = true та alternativeDescription = true.
  4. Система ЕТМ відправляє дані до ЦБД.
  5. Портал Prozorro.Sale використовує значення title/description для відображення в загальних списках та протоколах.
  6. У шаблоні "Детальний опис" на порталі та майданчику може відображатися titleAlt/descriptionAlt (якщо передбачено інтерфейсом).

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


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

  1. Процедура успішно опублікована.
  2. Для користувачів порталу доступний як мінімум основний опис лоту, а за потреби — альтернативний детальний опис

Інші вимоги


...

Назва

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

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


Актори

Основний: Організатор / Балансоутримувач.

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

Передумови

  1. Існує чернетка з уже згенерованими titleAlt/descriptionAlt

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

  1. Користувач відкриває чернетку та змінює поля title або description.
  2. При наступному натисканні "Зберегти чернетку" система ЕТМ перевіряє, чи змінилися значення title/description у порівнянні з попереднім збереженням.
  3. Якщо змінилися — ЕТМ повторно викликає сервіс покращення опису лоту.
  4. Сервіс генерує нові titleAlt/descriptionAlt.
  5. Далі сценарій повторює UC-1 (показ повідомлення, можливість прийняти/відхилити альтернативу)

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

  1. Користувач погодився на використання альтернативного тексту в попередній раз відповіднго поля alternativeTitle = true та alternativeDescription = true
  2. Користувач змінює поля title або description
  3. При наступному натисканні "Зберегти чернетку" система ЕТМ не відправляє title/description на повторну перегенерацію

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

Альтернативний опис завжди відповідає актуальній версії оригінального тексту

Інші вимоги


...

Назва

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

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


Актори

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

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

Передумови

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

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

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

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


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

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

Інші вимоги

Use Case n. Збреження чернетки аукціону з викликом "Системи покращення опису лоту"

...

Назва

...

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

...

Користувачу необхідно зберегти чернетку процедури/реєстру/ІП перед публікацією в системі

...

Організатор/Балансоутримувач

...

Передумови

...

  1. Користувач авторизований в кабінеті акредитованого майданчика АТ "Прозорро.Продажі"

...

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

...

  1. Користувач активує елемент "Зберегти чернетку"
  2. Система майданчика відправляє запит в "Систему покращення опису лоту"
  3. Система покращення опису лоту опрацьовує поля: title, description, all images
  4. Система покращення опису лоту віддає результат опрацювання системі майданчика
  5. Система майданчика виводить повідомлення Організатору "Система згенерувала альтернативний текст в полях: title та description. Ви можете ознайомитись та прийняти його як основний, в разі не прийняття запропонований текст буде збережений як альтернативний. Ознайомитись ?"
    1. Якщо коритстувач активує елемент "Так"→ :
      1. Cистема майданчика виводить дві варіації інформації в полях: title та description
      2. Система майданчика виводить активний елемент "Замінити"
        1. Якщо користувач активує елемент "Замінити"
          1. Система майданчика замінює теста в полях процедури title та description
          2. Користувач активує елемент "Зберегти чернетку"
          3. Система майданчика зберігає чернетку процедури/реєстру/ІП
        2. Якщо користувач не активував елемент "Замінити" але активував елемент "Зберегти чернетку" 
          1. Система майданчика не вносить зміни в поля процедури/реєстру/ІП title та description
          2. Система майданчика зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП: titleAlt та descriptionAlt
    2. Якщо користувач активує елемент "Ні" → Cистема закриває повідомлення та зберігає дані в полях процедури/реєстру/ІП title та description без змін та зберігає альтернативні значення в мета полях процедури/реєстру/ІП titleAlt та descriptionAlt

...

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

...

  1. Користувач редагує та повторно зберігає чернетку процедури та вже має альтернативно згенерований текст (Заповнені поля: title,description, titleAlt та descriptionAlt )
    1. Система майданчика повинна виділити чи були внесені зміни в полях title та description
      1. Якщо Так →Система майданчика відправляє запит в "Сервіс покращення опису лоту" і виконує дії відповідно до основного шляху користувача
      2. Якщо Ні → Система майданчика не відправляє запит в "Сервіс покращення опису лоту" та зберігає внесені зміни до полів процедури/реєстру/ІП
  2. Користувач редагує чернетку процедури та вже прийняв альтернативно згенерований текст (Заповнені поля: title,description та Незаповнені поля - titleAlt та descriptionAlt) можливо зробимо мета поле і по ньому майданчик перевіряє чи треба відправляти запит в "Систему покращення опису лота"
    1. Система майданчика не перевіряє які поля були змінені та не відправляє запит в "Систему покращення опису лота" а збегіє чернетку в виправленому варіанті

...

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

...

Зребежена чернета має альтернативні значення title та description

...

Інші вимоги

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

Назва

Збереження чернетки процедури/реєстру/ІП

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

Користувачу необхідно зберегти чернетку процедури/реєстру/ІП перед публікацією в системі

Актори

Організатор/Балансоутримувач, 

Передумови

  1. Користувач авторизований в кабінеті акредитованого майданчика АТ "Прозорро.Продажі"

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

  1. Користувач активує елемент "Зберегти чернетку"
  2. Система майданчика відправляє запит в "Систему покращення опису лоту"
  3. Система покращення опису лоту опрацьовує поля: title, description, all images
  4. Система покращення опису лоту віддає результат опрацювання системі майданчика
  5. Система майданчика виводить сповіщення Організатору "Система згенерувала альтернативний текст в полях: title та description. Ви можете ознайомитись та прийняти його як основний, в разі не прийняття запропонований текст буде збережений як альтернативний"
  6. Система виводить повідомлення "Дана дія є незворотньою. Підтверджуєте ?"
    1. Якщо коритстувач активує елемент "Так"→ :
      1. Cистема змінює статус користувача на inactive
    2. Якщо користувач активує елемент "Ні" → Cистема закриває повідомлення і не змінює статус користувача

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

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

Користувач деактивував Адміністратора Факторингу/Адміністратора компанії Брокера

Інші вимоги

Система зберігає історію дій