# # Запити зацікавлених осіб

## # Вступ

У даному розділі розкриваються ключові терміни та процеси, пов'язані з розробкою високоякісного програмного забезпечення. Ці матеріали надаються для зацікавлених користувачів, які прагнуть отримати глибше розуміння суті проекту та його основних завдань.

### # Мета

Метою є формування стратегії подальшого розвитку проекту на основі аналізу запитів цільової аудиторії, функціональних потреб та досягнення оптимальної продуктивності для створення якісного програмного забезпечення.

### # Контекст

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

### # Основні визначення та скорочення

Зацікавлені сторони (особи)
(opens new window) - фізичні та юридичні особи, які мають легітимний інтерес у діяльності організації, тобто певною мірою залежать від неї або можуть впливати на її діяльність.

FURPS
(opens new window) - абревіатура, що репрезентує модель класифікації якостей програмного забезпечення (функціональні і нефункціональні вимоги):

- Functionality (Функціональність) - можливості (розмір та загальний набір функцій), повторне використання (сумісність, інтероперабельність, портативність), безпека (безпека та можливість експлуатації);
- Usability (Використовуваність) (UX) - людський фактор, естетика, узгодженість, документація, швидкість реагування;
- Reliability (Надійність) - доступність (частота відмов (надійність/довговічність/стійкість), ступінь і тривалість відмов (відновлюваність/живучість)), передбачуваність (стабільність), точність (частота/серйозність помилок);
- Perfomance (Продуктивність) - швидкість, ефективність, споживання ресурсів (живлення, оперативна пам'ять, кеш і т.д.), пропускна здатність, ємність, масштабованість;
- Supportability (Підтримка) (ремонтопридатність, підтримуваність, стійкість, швидкість відновлення) - тестуємість, гнучкість (модифікованість, конфігурованість, адаптованість, розширюваність, модульність), встановлюваність, локалізованість.

API
(opens new window) (з англ. application programming interface “прикладни́й програ́мний інтерфе́йс”) - підхід до архітектури мережевих протоколів, які надають доступ до інформаційних ресурсів.

REST
(opens new window) (з англ. Representational State Transfer, «передача репрезентативного стану») — підхід до архітектури мережевих протоколів, які надають доступ до інформаційних ресурсів.

MVC
(opens new window) (з англ. Model-view-controller) - це патерн проектування програмного забезпечення, який зазвичай використовується для розробки користувацьких інтерфейсів, що розділяє відповідну програмну логіку на три взаємопов'язані елементи. Це робиться для того, щоб відокремити внутрішнє представлення інформації від способів її представлення користувачеві та отримання від нього.

SOLID
(opens new window) - це мнемонічна абревіатура для п'яти принципів проектування, призначених для того, щоб зробити об'єктно-орієнтовані проекти більш зрозумілими, гнучкими та зручними в обслуговуванні.

- Принцип єдиної відповідальності: "Ніколи не повинно бути більше однієї причини для зміни класу”. Іншими словами, кожен клас повинен мати лише одну відповідальність.
- Принцип відкритості-закритості: "Сутності програмного забезпечення ... повинні бути відкритими для розширення, але закритими для модифікації.
- Принцип заміщення Ліскова: "Функції, які використовують вказівники або посилання на базові класи, повинні мати можливість використовувати об'єкти похідних класів, не знаючи про це.
- Принцип розділення інтерфейсів: "Клієнти не повинні бути змушені залежати від інтерфейсів, якими вони не користуються".
- Принцип інверсії залежності: "Покладайтеся на абстракції, а не на конкретику".

DRY
(opens new window)(з англ. don’t repeat yourself - “не повторюйся”) - це принцип розробки програмного забезпечення, спрямований на зменшення повторення інформації, яка може змінитися, заміну її абстракціями, які менш схильні до змін, або використання нормалізації даних, яка дозволяє уникнути надмірності в першу чергу.

ORM
(opens new window) - (англ. Object-relational mapping, Об'єктно-реляційна проекція) — технологія програмування, яка зв'язує бази даних з концепціями об'єктно-орієнтованих мов програмування, створюючи «віртуальну об'єктну базу даних».

### # Посилання

1. https://uk.wikipedia.org/wiki/Зацікавлені_сторони
   (opens new window)
2. https://en.wikipedia.org/wiki/FURPS
   (opens new window)
3. https://uk.wikipedia.org/wiki/Прикладний_програмний_інтерфейс
   (opens new window)
4. https://uk.wikipedia.org/wiki/REST
   (opens new window)
5. https://en.wikipedia.org/wiki/Model–view–controller#Components
   (opens new window)
6. https://en.wikipedia.org/wiki/SOLID
   (opens new window)
7. https://en.wikipedia.org/wiki/Don%27t_repeat_yourself
   (opens new window)
8. https://uk.wikipedia.org/wiki/Об%27єктно-реляційне_відображення
   (opens new window)

## # Короткий зміст

- Характеристика ділових процесів
- Короткий огляд продукту
- Функціональність
- Практичність
- Надійність
- Продуктивність
- Експлуатаційна придатність

## # Характеристика ділових процесів

ID | ACCOUNT.CREATE
--- | ---
Назва | Створити обліковий запис
Учасники | Користувач, система
Передумови | Відсутні
Результат | Обліковий запис користувача
Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму 001.002 Ідентичний псевдонім вже існує
Основний сценарій | 1. Користувач вводить бажаний псевдонім у поле вводу псевдоніму 2. Користувач вводить пароль у поле вводу паролю 3. Користувач натискає на кнопку створення облікового запису 4. Система створює обліковий запис користувача (можливі 001.001, 001.002)

ID | ACCOUNT.DELETE
--- | ---
Назва | Видалити обліковий запис
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі
Результат | Відсутність облікового запису користувача
Виключні ситуації | 001.005 Користувач не ідентифікований
Основний сценарій | 1. Користувач натискає на кнопку видалення облікового запису 2. Система виводить кнопку-запит на підтвердження видалення облікового запису 3. Користувач натискає на кнопку підтвердження видалення облікового запису 4. Система видаляє обліковий запис (можлива 001.005)

ID | ACCOUNT.MODIFY
--- | ---
Назва | Змінити властивості облікового запису
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі
Результат | Зміна властивостей облікового запису
Виключні ситуації | 001.005 Користувач не ідентифікований
Основний сценарій | 1. Користувач натискає на кнопку редагування облікового запису 2. Система виводить інтерфейс для редагування облікового запису (можлива 001.005) 3. Користувач вказує бажані зміни властивостей облікового запису 4. Користувач натискає на кнопку внесення змін до властивостей облікового запису 5. Система змінює властивості облікового запису

ID | SURVEY.LINK.CREATE
--- | ---
Назва | Додати посилання на опитування
Учасники | Користувач, система
Передумови | Користувач авторизований у системі
Результат | Нове посилання на опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування
Основний сценарій | 1. Користувач натискає кнопку створення посилання на опитування 2. Система виводить налаштування для нового посилання (можливі 001.005, 001.006, 001.008) 3. Користувач вводить налаштування для нового посилання 4. Користувач натискає на кнопку створення посилання 5. Система створює нове посилання

ID | SURVEY.LINK.DELETE
--- | ---
Назва | Видалити посилання на опитування
Учасники | Користувач, система
Передумови | Користувач авторизований у системі
Результат | Видалення посилання на опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування 001.009 Запитане посилання на існує
Основний сценарій | 1. Користувач натискає кнопку видалення посилання 2. Система виводить кнопку підтвердження видалення посилання 3. Користувач натискає на кнопку підтвердження видалення посилання 4. Система видаляє посилання (можливі 001.005, 001.006, 001.008, 001.009)

ID | SURVEY.LINK.MODIFY
--- | ---
Назва | Змінити властивості посилання на опитування
Учасники | Користувач, система
Передумови | Користувач авторизований у системі
Результат | Зміна властивостей посилання на опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування 001.009 Запитане посилання на існує
Основний сценарій | 1. Користувач натискає кнопку редагування властивостей посилання 2. Система виводить налаштування для обраного посилання (можливі 001.005, 001.006, 001.008, 001.009) 3. Користувач вводить юажані зміни властивостей посилання 4. Користувач натискає на кнопку збереження властиностей посилання 5. Система змінює властивості посилання

ID | USER.CREATE_SURVEY
--- | ---
Назва | Створити опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі
Результат | Створене опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.007 Користувач ввів неприпустимі символи в назві опитування
Основний сценарій | 1. Користувач переходить на сторінку створення опитування (можлива 001.005) 2. Система виводить інтерфейс створення опитування 3. Користувач задає інформацію про запитання та тип опитування 4. Користувач натискає кнопку збереження опитування 5. Система створює опитування (можлива 001.007) 6. Система виводить посилання на проходження опитування

ID | USER.DELETE_SURVEY
--- | ---
Назва | Видалити опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
Результат | Відсутність опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування
Основний сценарій | 1. Користувач натискає на кнопку видалення опитування 2. Система виводить запит на підтвердження видалення опитування 3. Користувач натискає на кнопку підтвердження видалення опитування 4. Система видаляє опитування (можливі 001.005, 001.006, 001.008)

ID | USER.GET_SURVEY_RESULT
--- | ---
Назва | Переглянути відповіді на опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
Результат | Інформація про відповіді на опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування
Основний сценарій | 1. Користувач натискає на кнопку перегляду відповідей на опитування 2. Система виводить інформацію про відповіді на опитування (можливі 001.005, 001.006, 001.008)

ID | USER.LOGIN
--- | ---
Назва | Пройти ідентифікацію в системі
Учасники | Користувач, система
Передумови | Користувач має обліковий запис
Результат | Користувач ідентифікований в системі
Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму 001.003 Користувач ввів псевдонім, якого не існує в системі 001.004 Користувач ввів неправильний пароль до облікового запису
Основний сценарій | 1. Користувач вводить псевдонім у поле вводу псевдоніму 2. Користувач вводить пароль у поле вводу паролю 3. Користувач натискає кнопку ідентифікації 4. Система ідентифікує користувача (можливі 001.001, 001.003, 001.004)

ID | USER.LOGOUT
--- | ---
Назва | Скинути дані про ідентифікацію в системі
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі
Результат | Користувач не ідентифікований в системі
Виключні ситуації | 001.005 Користувач не ідентифікований
Основний сценарій | 1. Користувач натискає на кнопку виходу з облікового запису 2. Система скидає інформацію про ідентифікацію користувача (можлива 001.005)

ID | USER.MODIFY_SURVEY
--- | ---
Назва | Редагувати опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
Результат | Змінене опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування
Основний сценарій | 1. Користувач переходить на сторінку редагування опитування 2. Система виводить інтерфейс редагування опитування (можливі 001.005, 001.006, 001.008) 3. Користувач задає інформацію про зміни в опитуванні 4. Користувач натискає кнопку збереження змін в опитуванні 5. Система змінює опитування

ID | USER.STAT_SURVEY
--- | ---
Назва | Переглянути властивості опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
Результат | Інформація про властивості опитування
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує 001.008 Користувач не є власником опитування
Основний сценарій | 1. Користувач натискає на кнопку перегляду інформації про опитування 2. Система виводить інформацію про опитування (можливі 001.005, 001.006, 001.008)

ID | USER.TAKE_ANON_SURVEY
--- | ---
Назва | Пройти анонімне опитування
Учасники | Користувач, система
Передумови | Відсутні
Результат | Запис відповідей на опитування
Виключні ситуації | 001.006 Запитане опитування не існує
Основний сценарій | 1. Користувач переходить на сторінку проходження опитування 2. Система виводить перелік запитань опитування (можлива 001.006) 3. Користувач вводить відповіді на запитання 4. Користувач натискає кнопку надсилання відповідей 5. Система записує відповіді на опитування (можлива 001.006) 6. Система виводить прощальне повідомлення

ID | USER.TAKE_NAMED_SURVEY
--- | ---
Назва | Пройти поіменне опитування
Учасники | Користувач, система
Передумови | Користувач ідентифікований в системі
Результат | Запис відповідей на опитування та відомості про користувача
Виключні ситуації | 001.005 Користувач не ідентифікований 001.006 Запитане опитування не існує
Основний сценарій | 1. Користувач переходить на сторінку проходження опитування 2. Система виводить перелік запитань опитування (можливі 001.005, 001.006) 3. Користувач вводить відповіді на запитання 4. Користувач натискає кнопку надсилання відповідей 5. Система записує відповіді на опитування та відомості про користувача (можлива 001.006) 6. Система виводить прощальне повідомлення

## # Короткий огляд продукту

Xpertise - це система для проведення будь-яких опитувань. Вона дозволяє користувачам створювати опитування, збирати відповіді на них та переглядати докладну й узагальнену статистику. У користувачів є можливість створювати не лише анонімні, але й поіменні опитування, тому платформа також задовольнить потреби в проведенні голосувань для прийняття спільних рішень у командах.

## # Функціональність

Наша система спрямована, в першу чергу, на взаємодію з користувачами.

Користувач - це особа, що взаємодіє із системою.

Cистема розділяє користувачів на дві категорії:

- гість
- авторизований користувач

Гість - це користувач, що не пройшов ідентифікацію в системі. Такого користувача не можна зіставити з жодним обліковим записом.

Гість може:

- створити обліковий запис
- пройти ідентифікацію в системі
- пройти анонімне опитування

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

Зареєстрований користувач може:

- редагувати властивості свого облікового запису
- видалити свій обліковий запис
- скинути дані про ідентицікацію в системі
- створити опитування
- відредагувати своє опитування
- видалити своє опитування
- створити посилання на своє опитування
- редагувати властивості посилання на своє опитування
- видалити посилання на своє опитування
- призупинити своє опитування
- продовжити своє опитування
- переглянути властивості свого опитування
- переглянути результати свого опитування
- пройти анонімне опитування
- пройти поіменне опитування

Респондент
(opens new window) - той, хто відповідає на питання анкети; опитуваний.

Опитування - це перелік запитань, кожне з яких передбачає обов'язкову або необов'язкову відповідь. Кожна відповідь має визначений тип.

Анонімне опитування - це опитування, відповідь на яке може не містити інформації про обліковий запис респондента (*респондент все одно може вирішити надати таку інформацію).

Поіменне опитування - це опитування, відповідь на яке обов'язково містить дані про обліковий запис респондента.

## # Практичність

- Наявність зручного інструменту для побудови опитувань
- Можливість легко замінити брендинг та кольорову палітру
- Перегляд аналітики в реальному часі
- Формування статистики відповідей у зручному інтерфейсі
- Можливість експорту результатів опитування через API
- Підтримка програмування реакцій на події (hooks)

## # Надійність

- Шифрування з'єднань (TLS)
- Автоматичне резервне копіювання
- Автоматичне відновлення з резервних копій

## # Продуктивність

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

## # Експлуатаційна придатність

- Наявність докладної документації для користувачів, адміністраторів та розробників
- Доступність онлайн-підтримки