Визначення:

Survey - конструктор для форми зворотнього зв’язку з можливістю відслідковувати результати на дашборді

Особливості:

1. Відображається лише одна форма опитування (статус in published). (Наявний механізм який дозволяє розширити кількість)
2. Один тип процедури - одна форма опитування.
3. Опитування можна застосувати як для Учасників аукціонів так і Спостерігачів (При активації Public survey).
4. При редагуванні форми опитування для користувача стає це новим опитуванням, для контент менеджера - тим самим
5. В відповідях користувача відображаються номер питання на які він відповідав
6. При видаленні форми опитування - контент менеджер має можливість обрати видаляти відповіді на питання (якщо вони були) чи ні.
7. Пошук за розміром угоди (кінцева вартість) - сума максимальної ставки для аукціону (Для всіх awards виводиться однакова сума)

Словник:

• Site - де буде відображатися форма
• Name - назва форми фітбеку
• Public survey - даний пункт відповідає за форму лише для Спостерігача, не відмічати для Учасника
• Is published - чи опублікована форма
• Publication date - дата публікації
• Expiration date - дата завершення активності форми
• Title - заголовок форми
• Subtitle - підзаголовок форми
• Thanks title - заголовок вікна подяки після заповнення форми
• Thanks text - текст для вікна подяки після заповнення форми
• Cancel button title - текст кнопки, для приховування форми
• Submit button title - текст кнопки, для відправки форми
• Close button title - текст кнопки, для закриття вікна подяки
• Language - мова інтерфейсу, де буде відображено форму

Доступні панелі(сторінки) в адмінці:

1. General window
   1. Dashboard
2. Autentification and Autorization
   1. Group
   2. Users
3. Axes
   1. Access attempts
   2. Access failures
   3. Access logs
4. Celery Results
   1. Group results
   2. Task results
5. Forms
   1. Answers
   2. Questions
   3. Sites
   4. Surveys

Опис панелей(сторінок)

Dashboard

Опис - панель (швидкого доступу/дії) до всіх сторінок адмін компоненти

Доступні дії:

1. Перехід на сторінку додавання/зміни налаштувань користувачів
2. Перехід на сторінку додавання/зміни налаштувань груп користувачів
3. Перехід на сторінку зміни можливостей доступу
4. Перехід на сторінку зміни помилок доступу
5. Перехід на сторінку зміни журналів доступу
6. Перехід на сторінку додавання/зміни результатів оборобки групових результатів
7. Перехід на сторінку додавання/зміни результатів обробки позадачних результатів
8. Перехід на сторінку зміни форми відповідей
9. Перехід на сторінку додавання/зміни результатів форми питань
10. Перехід на сторінку додавання/зміни результатів форми переліку сайтів 
11. Перехід на сторінку додавання/зміни результатів форми  survey

Groups

Опис - панель відображення вже наявних груп користувачів адмін компоненти та створення нових

Доступні дії:

1. Створення нової групи користувачів 
2. Пошук через форму пошуку/вибір з переліку групу користувачів
3. Редагування/зміна/перегляд доступних дій (тільки для існуючих записів)
4. Видалення групи через сторінку групи або вибору через форму для швидкого видалення (тільки для існуючих записів)
5. Перегляд історії змін сторінки групи користувачів (тільки для існуючих записів)

Users

Опис - панель відображення/редагування вже наявних користувачів адмін компоненти та створення нових

Доступні дії:

1. Створення нового користувача
2. Пошук через форму/вибір з переліку користувача.
3. Редагування/внесення додаткової інформації про користувача/додання до групи коричтувачів (тільки для існуючих записів)
4. Видалення користувача через сторінку користувача або вибору через форму для швидкого видалення (тільки для існуючих записів)
5. Перегляд історії змін сторінки користувача (тільки для існуючих записів)

Access attempts

Опис - сторінка відображення/пошуку запитів доступу до адмін панелі

Доступні дії:

1. Пошук по часу спроби доступу
2. Пошук по шляху (Path)
3. Пошук по назві користувача адмін панелі
4. Видалення інформації про запит доступу через сторінку запиту доступу або через форму для швидкого видалення (тільки для існуючих записів)

Access failures

Опис - сторінка відображення/пошуку помилок доступа до адмін панелі

Доступні дії:

1. Пошук по часу спроби доступу (Attempt Time)
2. Пошук по блокуванню доступу (Access lock out)
3. Пошук по шляху (Path)
4. Пошук по назві користувача адмін панелі
5. Видалення інформації про помилку доступу через сторінку помилки доступу або через форму для швидкого видалення (тільки для існуючих записів)

Access logs

Опис - сторінка відображення/пошуку логірування дій користувачів адмін панелі

Доступні дії:

1. Пошук по роках
2. Пошук по часу логірування (Attempt Time)
3. Пошук по періоду розлогірування (Logout Time)
4. Пошук по шляху (Path)
5. Пошук по назві користувача адмін панелі
6. Видалення інформації про логування через сторінку логування або через форму для швидкого видалення (тільки для існуючих записів)

Group results

Опис - сторінка відображення вже наявних груп результатів опитування та створення нових

Доступні дії:

1. Пошук по даті/часу завершення
2. Пошук по всім полям
3. Створення нової групи результатів
4. Видалення групи результатів через сторінку групи результатів або через форму для швидкого видалення (тільки для існуючих записів)
5. Перегляд історії змін для групи результатів (тільки для існуючих записів)

Task results

Опис - сторінка відображення вже наявних результатів виконання завдання та створення нових

Доступні дії:

1. Пошук по роках
2. Пошук по статусу задачі:
   1. FAILURE
   2. PENDING
   3. RECEIVED
   4. RETRY
   5. REVOKED
   6. STARTED
   7. SUCCES
3. Пошук по даті завершення задачі
4. Пошук по назві періодичного завдання
5. Пошук по назві завдання
6. Пошук по співробітнику
7. Пошук по всім полям
8. Створення нового результату виконання завдання
9. Видалення результату виконання завдання через сторінку результатів виконання завдання або вибору через форму для швидкого видалення (тільки для існуючих записів)
10. Перегляд історії результатів виконання завдання (тільки для існуючих записів)

Answers

Опис - сторінка відображення/редагуавння/пошуку вже існуючих відповідей на форми опитувань

Доступні дії:

1. Пошук по роках
2. Пошук по даті створення
3. Пошук по типу процедури
4. Пошук по типу аукціону
5. Пошук по статусу учасника аукціону
6. Пошук по owner
7. Пошук по всім полям
8. Видалення форми відповіді через сторінку відповіді виконання завдання або вибору через форму для швидкого видалення (тільки для існуючих записів)
9. Вивантаження відповедей
10. Редагування полів відповідей
11. Перегляд meta data 
12. Перегляд історії змін форми відповіді (тільки для існуючих записів)

Questions

Опис - сторінка відображення/радагування/пошуку вже існуючих питань та створення нових

Доступні дії:

1. Пошук по типу питання
2. Пошук по назві питання
3. Пошук по всім полям
4. Створення нового питання
5. Редагування питання
6. Видалення форми питання через сторінку питання або через форму для швидкого видалення (тільки для існуючих записів)
7. Перегляд історії змін форми питання (тільки для існуючих записів)

Sites

Опис - сторінка відображення/створення/редагування вже існуючих сторінок сайту для опитування та створення нових

Доступні дії:

1. Пошук по статусу опублікування
2. Пошук по всім полям
3. Створення нового сайту (сторінки для відображення опитування)
4. Редагування сайту (сторінки для відображення опитування)
5. Видалення сайту з переліку через сторінку сайту або через форму для швидкого видалення (тільки для існуючих записів)
6. Перегляд історії змін сайту (тільки для існуючих записів)

Surveys

Опис - сторінка відображення/створення/редагування вже існуючих сторінок опитувань та створення нових

Доступні дії:

1. Пошук опублікуванню
2. Пошук по назві сайту
3. Пошук по публікації для учасників аукціону або спостерігача
4. Cтворення нової форми опитування
5. Редагування форми опитування
6. Видалення форми опитуваання з переліку через сторінку опитування або через форму для швидкого видалення (тільки для існуючих записів)

Конфігурації опитувань

Типи опитувань

• Questions with answer multiple options - питання з багатьма виборами відповіді. Потрібно вказати мінімальну та максимальну кількість обраних варіантів відповіді.
• Open question - питання з відкритою формою відповіді. Потрібно вказати мінімальне та максимальне значення символів у полі
• Short open question - питання з короткою відкритою відповіддю. Потрібно вказати мінімальне та максимальне значення символів у полі
• Questions to determine NPS - питання з вибором оцінки від...до. Потрібно вказати мінімальне та максимальне значення оцінки. Користувач може обрати лише одне значення.
• Questions with answer options - питання з вибором одного варіанту відповіді. 

Механіка відображення опитувань

Для Учасника аукціону та Спостерігача (При активації Public survey)

• якщо учасник взяв участь в опитуванні - після оновлень форма більше не відображається.
• якщо цей же учасник, що відправив відповіді у одному браузері, відкриє цей самий аукціон в іншому браузері - форма буде активна для нього.
• якщо учасник згортає форму, перезавантажує сторінку, закриває сторінку з непройденим опитуванням - при наступному відкритті сторінки форма активна
• через три години після завершення аукціону, форма доступна учаснику, що НЕ брав участь у опитуванні.
• через три години після завершення аукціону, форма НЕ доступна учаснику, що брав участь у опитуванні.

• Для МА показ відбувається після завершення аукціону.

Експорт сирих даних 

• Експорт сирих даних у форматі excel/csv у вигляді таблиці з наступними полями

Вид відображення форми опитування

1. Формат показу: модальне вікно_, _блок у нижньому правому куті
2. Заголовок форми опитування
3. Підзаголовок форми опитування
4. 1-n питання, (будь-яких з доступних типів)
5. Вікно з заголовком та текстом подяки після заповнення форми
6. Кнопка для відправлення форми опитування
7. Кнопка для приховання форми опитування
8. Кнопка для закриття форми подяки

Функціональні можливості

Створення нового користувача

1. Переходимо на сторінку Users
2. Натискаємо елемент «Add user»
3. Заповнюємо форму «Username» (латиниця, без пробілів)
4. Заповнюємо форму «Пароль»

Обмеження:

• Пароль не може бути дуже схожим на вашу іншу особисту інформацію.
• Пароль має містити не менше 8 символів.
• Пароль не може бути типовим паролем.
• Пароль не може бути повністю цифровим.

1. Заповнюємо форму «Підтвердження паролю» (повторно вводимо пароль з попередньої форми)
2. Підтверджуємо дію:

• • • • Зберегти
      • Видалити (доступно тільки для попередньо збережених елементів)
      • Зберегти і додати інші
      • Зберегти і подовжити редагування
      • Подивитись історію редагування (доступно тільки для попередньо збережених елементів)

Редагування інформації про користувача

1. Переходимо на сторінку Users
2. Обираємо необхідного користувача з переліку
3. Переходимо на сторінку користувача
4. Переходимо на вкладку Personal Info
5. Вносимо коректну інформацію в поля:

• • • • First Name
      • Last Name
      • Email Address

1. Переходимо на вкладку Permission та налаштовуємо доступ і права користувачу
2. Підтверджуємо дію:

• • • • Зберегти
      • Видалити
      • Зберегти і додати інші
      • Зберегти і подовжити редагування
      • Подивитись історію редагування

Створення нової групи користувачів

1. Переходимо на сторінку Groups
2. Натискаємо елемент «Add group»
3. Заповнюємо форму «Name»
4. Додаємо необхідні права для користування адмін компонентою
5. Підтверджуємо дію:

• • • • Зберегти
      • Зберегти і додати інші
      • Зберегти і подовжити редагування

Редагування/зміна/перегляд доступних дій для групи користувачів

1. Переходимо на сторінку Groups
2. Обираємо групу користувачів для внесення змін або перегляду
3. Змінюємо назву (якщо потрібно)
4. Переносимо доступні дії (якщо потрібно)
5. Підтверджуємо дію:

• • • • Зберегти
      • Видалити
      • Зберегти і додати інші
      • Зберегти і подовжити редагування
      • Подивитись історію редагування

Створення групового результату

1. Переходимо на сторінку Group results
2. Натискаємо елемент «Add group results»
3. Вносимо коректну інформацію в поля:
   • • • Group ID* (обов'язкове поле)
       • Result Content Type * (обов'язкове поле)
       • Result Encoding * (обов'язкове поле)
4. Підтверджуємо дію:

• • • • Зберегти
      • Зберегти і додати інші
      • Зберегти і подовжити редагування

Створення результату задачі

1. Переходимо на сторінку Task results
2. Натискаємо елемент «Add task results»
3. Не зрозумілі дії
4. Підтверджуємо дію:

• • • • Зберегти
      • Зберегти і додати інші
      • Зберегти і подовжити редагування

Редагування відповідей

1. Переходимо на сторінку Answers
2. Обираємо відповідь для внесення змін або перегляду
3. Змінюємо інформацію в полі Survey 
4. Змінюємо інформацію у вкладці Auction Data:
   • • • Auction ID
         
       • Auction Type
         
       • Procedure Type
         
       • Bid counts
       • Owner
       • Value
       • Award value
       • Bid status * (обов'язкове поле)
       • Auction terminated
       • Procedure terminated
5. Підтверджуємо дію:

• • • • Зберегти
      • Видалити
      • Зберегти і додати інші
      • Зберегти і подовжити редагування
      • Подивитись історію редагування

Створення нового питання

1. Переходимо на сторінку Questions
2. Натискаємо елемент «Add question»
3. Вносимо коректну інформацію в поля:
   • • • Survey * (обов'язкове поле) - обираємо з переліку запропонованих
       • Required - чи є питання обов’язковим для заповнення
       • Type * (обов'язкове поле) - обираємо з переліку запропонованих
       • Description * (обов'язкове поле)
       • Order * (обов'язкове поле)
       • Config * (обов'язкове поле) заповнюється відповідно до типу питання
4. Підтверджуємо дію:
   • • • Зберегти
       • Зберегти і додати інші
       • Зберегти і подовжити редагування

Редагування питання

1. Переходимо на сторінку Questions
2. Обираємо питання для внесення змін або перегляду
3. Вносимо зміни в поля (якщо необхідно):
   • • • Survey * (обов'язкове поле) - обираємо з переліку запропонованих
       • Required - чи є питання обов’язковим для заповнення
       • Type * (обов'язкове поле) - обираємо з переліку запропонованих
       • Description * (обов'язкове поле)
       • Order * (обов'язкове поле)
       • Config * (обов'язкове поле) заповнюється відповідно до типу питання
4. Підтверджуємо дію:

• • • Зберегти
    • Видалити
    • Зберегти і додати інші
    • Зберегти і подовжити редагування
    • Подивитись історію редагування

Створення нового сайту (сторінки для відображення опитування)

1. Підтверджуємо дію:

• • • Зберегти
    • Зберегти і додати інші
    • Зберегти і подовжити редагування

Редагування сайту (сторінки для відображення опитування)

1. Підтверджуємо дію:

• • • Зберегти
    • Видалити 
    • Зберегти і додати інші
    • Зберегти і подовжити редагування
    • Подивитись історію редагування

Додавання нової форми опитування

1. Підтверджуємо дію:

• • • Зберегти
    • Зберегти і додати інші 
    • Зберегти і подовжити редагування

Редагування форми опитування

1. Підтверджуємо дію:

• • • Зберегти
    • Видалити
    • Зберегти і додати інші питання
    • Зберегти і подовжити редагування
    • Подивитись історію редагування

Додавання опитування на сторінку:

1. Створити новий запис на сторінці Sites
2. Створити новий запис на сторінці Surveys (де вказати назву створеного запису на сторінці Sites)
3. Створити новий запис на сторінці Questions (де вказати назву створеного запису на сторінці Surveys)

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

ТЗ - https://gitlab.prozorro.sale/public-projects/documentations/-/blob/master/Product_requirements/Feedback_form_auction-module/MA-feedback-form.md

Swagger - https://auction-sandbox.prozorro.sale/api/survey/doc/

Дизайн Figma -https://www.figma.com/file/Rci9mTmSsjWSq0QBZPVQXo/Prozorro.Sale-Redesign?type=design&node-id=7640-73199&mode=design&t=84NYIkNSDttMPEqu-0

Endpoint to bi:

GET /api/survey/answers

[{

    "id": <id>,

    "survey_id": <survey_id>,

    "site_id": <site_id>

    "questions": [

        "answer": <data from answers value>,

        "type": <question_type>,

        "description": <description>

    ],

    "auction_data": {

       "auction_id": <auction_id>,

       "auction_type": <auction_type>,

      "procedure_type": <procedure_type>,

       "value": <value>,

       "owner": <owner>,

       "bid_status": <bid_status>,

       "bid_id": <bid_id>

    },

    "created_at": <created_at>

}]