Визначення:

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

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

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

  5. Для створення опитування користувач повинен мати відповідні права

  6. Де саме буде відображатись форма опитування залежить від того в яку частину коду сторінки його вбудували. 
  7. При видаленні форми опитування, відповіді користувачів на неї зберігаються

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

  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

Типи прав користувачів:

PermissionДія яку може робити користувач з наявністю прав

admin | log entry | Can add log entry

Додавання логу дії користувача

admin | log entry | Can change log entry

Зміна логу дії користувача

admin | log entry | Can delete log entry

Видалення логу дії користувача
admin | log entry | Can view log entryПерегляд логу дії користувача
auth | group | Can add groupДодавання групи користувачів
auth | group | Can change groupЗміна групи користувачів
auth | group | Can delete groupВидалення групи користувачів
auth | group | Can view groupПерегляд групи користувачів
auth | permission | Can add permissionДодавання дозволу

auth | permission | Can change permission

Зміна дозволу

auth | permission | Can delete permission

Видалення дозволу
auth | permission | Can view permissionПерегляд дозволу

auth | user | Can add user

Додавання користувача

auth | user | Can change user

Зміна користувача

auth | user | Can delete user

Видалення користувача

auth | user | Can view user

Перегляд користувача

axes | acess attempt | Can add access attempt

Додавання прав(дозволів) користувачам/групам

axes | acess attempt | Can change access attempt

Зміна прав(дозволів) користувачам/групам

axes | acess attempt | Can delete access attempt

Видалення прав(дозволів) користувачам/групам
axes | acess attempt | Can view access attemptПерегляд прав(дозволів) користувачей/груп

axes | acess failure | Can add access failure

Додавання помилку доступу

axes | acess failure | Can change access failure

Зміна помилки доступу

axes | acess failure | Can delete access failure

Видалення помилки доступу
axes | acess failure | Can view access failureПерегляд помилки доступу

axes | acess log | Can add access log

Додавання лога

axes | acess log | Can change access log

Зміна лога

axes | acess log | Can delete access log

Видалення лога
axes | acess log | Can view access logПерегляд лога
contenttypes | content type | Can add content type
contenttypes | content type | Can change content type
contenttypes | content type | Can delete content type
contenttypes | content type | Can view content type
forms | answer | Can add answerДодавання відповіді
forms | answer | Can change answerЗміна відповіді
forms | answer | Can delete answerВидалення відповіді
forms | answer | Can export answerВивантаження відповідей
forms | answer | Can view answerПерегляд відповіді
forms | question | Can add questionДодавання питання
forms | question | Can change questionЗміна питання
forms | question | Can delete questionВидалення питання
forms | question | Can view questionПерегляд питання
forms | site | Can add siteДодавання сайту
forms | site | Can change siteЗміна сайту
forms | site | Can delete siteВидалення сайту
forms | site | Can view siteПерегляд сайту
forms | survey | Can add surveyДодавання форми опитування
forms | survey | Can change surveyЗміна форми опитування
forms | survey | Can delete surveyВидалення форми опитування
forms | survey | Can view surveyПерегляд форми опитування
sessions | session | Can add session
sessions | session | Can change session
sessions | session | Can delete session
sessions | session | Can view session


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

Dashboard

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

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

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

Groups

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

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

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

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. Пошук по даті/часу завершення
  2. Текстовий пошук по співпадінню з полем Group ID
  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. Текстовий пошук по співпадінню з полем Task ID
  8. Створення нового результату виконання завдання
  9. Видалення результату виконання завдання через сторінку результатів виконання завдання або вибору через форму для швидкого видалення (тільки для існуючих записів)
  10. Перегляд історії результатів виконання завдання (тільки для існуючих записів)

Answers

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

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

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

Questions

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

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

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

Sites

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

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

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

Surveys

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

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

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

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

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

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

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

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

ДатаТип опитуванняВідповідь на питання №1Відповідь на питання №2Відповідь на питання №3Напрямок роботиТип аукціонуОчікувана вартістьРозмір угоди Статус учасника Кількість участей (не реалізовано)Контакти (не реалізовано)Майданчик пропозиції













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

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

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

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

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

Обмеження:

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

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

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

Механіка створення результату задачі (можливо для користувачів з певним переліком доступів)

 Технічна задача яка виконується при опрацюванні відповідей на форму опитування

Після відправки опитування на якийсь сайт, збільшується счетчик Showing number (без різниці чи бачила людина дане опитування чи ні, система віддала опитування і зробила +1) - фоновая celery задача.
Після прийняття відповіді на опитування, посинається процес отримання додаткової інформації, якщо в переданих нам даних наявний auction_id - фоновая celery задача.

Редагування відповідей (наразі доступно користувачів з певним переліком доступів, потрібно прибрати в майбутньому)

  1. Переходимо на сторінку Answers
  2. Обираємо відповідь для внесення змін або перегляду
  3. Змінюємо інформацію в полі Survey 
  4. Змінюємо інформацію у вкладці Auction Data:
  5. Підтверджуємо дію:

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

  1. Переходимо на сторінку Questions
  2. Натискаємо елемент «Add question»
  3. Вносимо коректну інформацію в поля:
  4. Підтверджуємо дію:

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

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

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

  1. Переходимо на сторінку Sites
  2. Натискаємо елемент «Add site»
  3. Вносимо коректну інформацію в поля:
  4. Підтверджуємо дію:

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

  1. Переходимо на сторінку Sites
  2. Обираємо сайт для внесення змін або перегляду
  3. Змінюємо 
  4. Підтверджуємо дію:

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

  1. Переходимо на сторінку Surveys
  2. Натискаємо елемент «Add survey»
  3. Вносимо коректну інформацію в поля на вкладці General:
  4. Вносимо коректну інформацію в поля на вкладці Question
  5. Натискаємо елемент «New question»
  6. Вносимо коректну інформацію в поля:
  7. Підтверджуємо дію:

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

  1. Переходимо на сторінку Surveys
  2. Обираємо форму опитування для внесення змін або перегляду
  3. Вносимо зміни в поля на вкладці General (якщо необхідно):
  4. Вносимо зміни в поля на вкладці Question (якщо необхідно):
  5. Підтверджуємо дію:

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

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

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

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

}]