Визначення:

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

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

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

Users

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

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

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

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. Обрати групу результат для зміни:
   1. По даті/часу завершення
   2. По назві користувачів
2. Додати нову групу результатів
3. Видалити групу результатів через сторінку групи результатів або вибору через форму для швидкого видалення (тільки для існуючих записів)
4. Подивитись історію змін групи результатів (тільки для існуючих записів)

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

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

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

Questions

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

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

Sites

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

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

Surveys

Опис - панель керування, яка дозволяє створювати та редагувати опитування, налаштовувати зовнішній вигляд (при редизайну миодулю аукціону потрібна можливість привести форму зворотнього зв’язку у відповідний вигляд) і умови показу опитування

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

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

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

• 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-3 питання, (будь-яких з доступних типів)
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. Створити новий запис на сторінці Sites
2. Створити новий запис на сторінці Surveys (де вказати назву створеного запису на сторінці Sites)
3. Створити новий запис на сторінці Questions (де вказати назву створеного запису на сторінці Surveys)
   1. Вказати назву створеного запису на сторінці Surveys
   2. Вказати чи є питання обов’язковим для заповнення
   3. Вказати тип питання
   4. Вказати опис питання
   5. Вказати мінімальну/максимальну кількість знаків для введення в разі коли користувач обирає відкриту відповідь
   6. Підтверджуємо дію:

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

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

ТЗ - 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>

}]