Визначення:

Survey - конструктор для форми зворотнього зв’язку, що демонструється зареєстрованому учаснику ЕТС одразу після аукціону  з можливістю відслідковувати результати на дашборді

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

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

Users

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

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

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

Access attempts

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

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

Access failures

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

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

Access logs

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

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

Group results

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

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

Task results

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

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

Answers

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

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

Questions

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

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

Sites

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

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

Surveys

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

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

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

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

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. Підтверджуємо дію:

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

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

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

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

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

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

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

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

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

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

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>

}]