Compare commits
30 Commits
shmuliar-t
...
shved
| Author | SHA1 | Date | |
|---|---|---|---|
| b1b595e61b | |||
| fd12ac3cd4 | |||
| 6ed051bf95 | |||
| ba7444fc49 | |||
| 4607ce75cd | |||
| 47f3cbc26c | |||
| 21beb456e0 | |||
| 1ec1bbbfed | |||
| 02394beba0 | |||
| b253eb8f0f | |||
| 68500e9451 | |||
| 3bdaf3674f | |||
| 1c31f64954 | |||
| e9ea10d36e | |||
| fbbaeb9c3f | |||
| a912a73926 | |||
| 5aaf3ce928 | |||
| c00659062c | |||
| f5abbf5274 | |||
| 1600aa6653 | |||
| ef0ebef4c3 | |||
| c3bbc47f6b | |||
| 86f27e99fd | |||
| 0f68887e2f | |||
| 5da6368aae | |||
| f2751a8604 | |||
| a53cdb334d | |||
| 05f9376a90 | |||
| efe128fd59 | |||
| 9f296dcccd |
4
.gitignore
vendored
4
.gitignore
vendored
@@ -102,3 +102,7 @@ dist
|
|||||||
|
|
||||||
# TernJS port file
|
# TernJS port file
|
||||||
.tern-port
|
.tern-port
|
||||||
|
|
||||||
|
# utils/table-generator generated files
|
||||||
|
utils/table-generator/tables/
|
||||||
|
utils/table-generator/tables.md
|
||||||
|
|||||||
@@ -1,221 +1,4 @@
|
|||||||
# Розроблення вимог до системи
|
# Розроблення загальних вимог до системи
|
||||||
|
|
||||||
## Вступ
|
- [Аналіз предметної області](state-of-the-art.md)
|
||||||
У даному розділі проводиться аналіз предметної області, пов'язаної з системою організації та управління експертними опитуваннями. Представлені такі категорії:
|
- [Запити зацікавлених осіб](stakeholders-needs.md)
|
||||||
|
|
||||||
- [Основні визначення](#основні-визначення), котрі можна зустріти в сфері експертних опитувань
|
|
||||||
- [Підходи та способи вирішення завдання](#підходи-та-способи-вирішення-завдання) опитування експертів
|
|
||||||
- [Порівняльна характеристика наявних засобів вирішення завдання](#порівняльна-характеристика-існуючих-засобів-вирішення-завдання) опитування експертів
|
|
||||||
- [Висновки](#висновки) щодо доцільності розробки нової системи
|
|
||||||
- [Література](#література), де наведені посилання на джерела інформації
|
|
||||||
|
|
||||||
## Основні визначення
|
|
||||||
### Технічні визначення
|
|
||||||
**База даних** [](https://uk.wikipedia.org/wiki/База_даних)
|
|
||||||
|
|
||||||
База даних (англ. database) – сукупність даних, організованих відповідно до концепції, яка описує характеристику цих даних і взаємозв'язки між їх елементами; ця сукупність підтримує щонайменше одну з областей застосування (за стандартом ISO/IEC 2382:2015). В загальному випадку база даних містить схеми, таблиці, подання, збережені процедури та інші об'єкти. Дані у базі організовують відповідно до моделі організації даних. Таким чином, сучасна база даних, крім самих даних, містить їх опис та може містити засоби для їх обробки.
|
|
||||||
|
|
||||||
**SQL** [](https://uk.wikipedia.org/wiki/SQL)
|
|
||||||
|
|
||||||
SQL (англ. Structured query language — мова структурованих запитів) — декларативна мова програмування для взаємодії користувача з базами даних, що застосовується для формування запитів, оновлення і керування реляційними БД, створення схеми бази даних та її модифікації, системи контролю за доступом до бази даних. Сама по собі SQL не є ані системою керування базами даних, ані окремим програмним продуктом. На відміну від дійсних мов програмування (C або Pascal), SQL може формувати інтерактивні запити або, бувши вбудованою в прикладні програми, виступати як інструкції для керування даними. Окрім цього, стандарт SQL містить функції для визначення зміни, перевірки та захисту даних.
|
|
||||||
|
|
||||||
### Загальні визначення
|
|
||||||
**Опитування** [](https://uk.wikipedia.org/wiki/Опитування)
|
|
||||||
|
|
||||||
Опи́тування — це метод збору соціологічної інформації про досліджуваний об'єкт під час безпосереднього (усне опитування, інтерв'ю) або опосередкованого (письмове опитування, анкетування) спілкування того хто опитує з респондентом. Опитування бувають соціологічні, політологічні, маркетингові, психологічні — залежно від предмету дослідження. Залежно від кількості опитуваних (вибірки, вибіркової сукупності) вони також можуть бути масовими, вибірковими, індивідуальними, експертними. Також використовується для вимірювання «громадської думки» з різних питань.
|
|
||||||
|
|
||||||
**Експерт** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
Експертом називають людину, що є фахівцем (спеціалістом) у певній предметній області (ПО) і може пояснити свої дії та міркування. Предметною областю називають будь-яку галузь діяльності людини, наприклад, “Технічні засоби автоматизації”, “Охорона довкілля”, “Системи штучного інтелекту” тощо.
|
|
||||||
**Експертне опитування**
|
|
||||||
Експертне опитування або опитування фахівців — це особливий метод маркетингового (і/або соціологічного) дослідження. В рамках такого опитування досліджувана тема обговорюється з експертами, компетентними в даній сфері.
|
|
||||||
### Методи експертного опитування
|
|
||||||
#### Активні методи
|
|
||||||
Активні методи передбачають спілкування між організаторами та експертами. Можливі два напрямки активної роботи з експертами: індивідуальна робота з експертом (анонімна чи відкрита) та робота з групою в цілому.
|
|
||||||
***
|
|
||||||
#### До індивідуальних активних методів належать анкетування, інтерв’ю, діалог з експертом, ігри з експертом.
|
|
||||||
|
|
||||||
**Інтерв’ю** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
Інтерв’ю – це форма спілкування між дослідником та експертом, при якій дослідник ставить заздалегідь підготовлену чергу запитань. Можна замінити ці запитання на інші у відповідності до ситуації.
|
|
||||||
|
|
||||||
**Діалог** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
Діалог – це метод отримання знань у формі бесіди між дослідником та експертом, коли немає жорстко регламентованого плану проведеня і визначеного заздалегідь переліку запитань.
|
|
||||||
|
|
||||||
**Ігри з експертом** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
Ігри з експертом (експертні ігри) – це експерименти, у яких фахівцю пропонують важливі ситуації з предметної області. Фахівець повинен запропонувати рішення по виходу з цих ситуацій на основі свого життєвого досвіду, спеціальних знань та уявлень.
|
|
||||||
***
|
|
||||||
#### До методів активної роботи з групою в цілому належать методи круглого столу, мозкового штурму та рольові ігри.
|
|
||||||
|
|
||||||
**Круглий стіл** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
“Круглий стіл” передбачає обговорення певної проблеми, у якому приймають участь експерти з однаковими правами. Задача дискусії – вивчити проблему всебічно, тому слід запрошувати експертів, які належать до різних наукових напрямків, мають різний вік, стать і т.ін. Цей метод не передбачає терміновості прийняття рішення.
|
|
||||||
|
|
||||||
**Мозковий штурм** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
“Мозковий штурм (атака)” – один із найбільш поширених методів активізації думок. Його застосовують у тих випадках, коли потрібно знайти вирішення певної проблеми за дуже короткий час. Під час такого обговоренння кожний експерт повинен запропонувати свій шлях розвязання задачі або розвинути думку іншого учасника.
|
|
||||||
|
|
||||||
**Рольові ігри** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
Рольові ігри (експертні ігри) – це експерименти, у яких колективу спеціалістів пропонують складні ситуації з предметної області. Спеціалісти у процесі відкритого обговорення приймають рішення про шляхи виходу з цих ситуацій.
|
|
||||||
***
|
|
||||||
#### Пасивні методи
|
|
||||||
До пасивних методів належать спостереження за діяльністю експертів, запис їхніх міркувань у процесі роботи (так звані *“думки вголос”*), лекції, які вони можуть прочитати. [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
|
|
||||||
|
|
||||||
## Підходи та способи вирішення завдання
|
|
||||||
|
|
||||||
[Методисти виділяють методи **заочного** та **очного** експертного опитування.](http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html)
|
|
||||||
|
|
||||||
До методів **заочного** опитування відносять:
|
|
||||||
- письмове опитування («збір думок»);
|
|
||||||
- анкетування;
|
|
||||||
- дельфійська техніка;
|
|
||||||
|
|
||||||
До **очних** методів належать:
|
|
||||||
- «мозкова атака».
|
|
||||||
|
|
||||||
Письмове опитування (або «збір думок») – вважається найпростішим методом заочного опитування експертів. Він полягає в тому, що експертам надають спеціально підготовлені опитувальні листи, в яких вони повинні викласти свою думку по суті поставлених питань. При складанні експертного опитувальника від 50 до 90% використовуються відкриті питання. Збір думок подібний вільному інтерв'ю і відрізняється від нього лише письмовою формою опитування.
|
|
||||||
|
|
||||||
Плюси: дає можливість залучити велику кількість експертів.
|
|
||||||
|
|
||||||
Мінуси: заочний опитування пов'язане з організаційними труднощами, зумовленими низьким рівнем повернення анкет.
|
|
||||||
|
|
||||||
Анкетування – даний тип опитування може бути сформований як у відкритій, так і в закритій формі. Сильно відрізняється від письмового збору думок, оскільки спрямоване на з’ясування оцінок фахівцями тих чи інших аспектів готового рішення.
|
|
||||||
|
|
||||||
Плюси: можливість анонімного збору даних; значно спрощує можливість збору даних; стандартизація.
|
|
||||||
|
|
||||||
Мінуси: учасники можуть відмовитися від відповідей або дати неправильні відповіді через обмежену варіативність; негнучкість методу (негативна сторона стандартизованості).
|
|
||||||
|
|
||||||
Метод Дельфі – опитування експертної групи в кілька турів з узгодженням думок експертів. Суть цього методу в тому, щоб за допомогою серії послідовних дій - опитувань, інтерв'ю, мозкових штурмів - домогтися максимального консенсусу при визначенні правильного рішення. Метод передбачає опитування експертів в кілька турів (зазвичай 2-3), обробку результатів кожного туру, інформування їх про ці результати і знову повторення такої ж процедури. У першому турі відповіді даються без аргументації. Після обробки виділяються крайні і середні судження і повідомляються експертам. У другому турі опитувані знову звертаються до своїх оцінок. Так як вони мали досить часу на роздуми і дізналися про існування інших позицій з цього приводу, вони можуть переглянути свої погляди або, навпаки, посилити їх аргументацію. Після другого туру обробляються нові оцінки - крайні і середні думки узагальнюються, підсумки знову доповідають експертам. Так повторюється 3-4 рази. Практика показує, що після третього або четвертого туру думки експертів не змінюються. В ході подібної процедури виробляється узгоджена оцінка, причому дослідник не повинен нехтувати громадською думкою тих, хто після неодноразових опитувань залишився на своїй позиції.
|
|
||||||
|
|
||||||
Плюси: подібна техніка дозволяє зменшити вплив недостатньо компетентних експертів на групову оцінку, як це спостерігається при простому анкетуванні. Воно досягається за рахунок отриманої цінної інформації від більш компетентних експертів.
|
|
||||||
|
|
||||||
Мінуси: часові витрати; можливість втрати мотивації учасників.
|
|
||||||
|
|
||||||
Метод «мозкового штурму (атаки)»
|
|
||||||
|
|
||||||
Плюси: стимулювання творчості; розширення горизонтів.
|
|
||||||
|
|
||||||
Мінуси: відсутність структури; можливість домінування деяких учасників.
|
|
||||||
|
|
||||||
## Порівняльна характеристика існуючих засобів вирішення завдання
|
|
||||||
|
|
||||||
Розглядатимемо такі найпопулярніші інструменти для проведення анкетувань:
|
|
||||||
|
|
||||||
[Google Forms](https://uk.wikipedia.org/wiki/Google_Форми)
|
|
||||||
|
|
||||||
Google Forms — програмне забезпечення для адміністрування опитування,
|
|
||||||
що входить до складу безкоштовного веб-пакету Google Docs Editors,
|
|
||||||
пропонованого Google. Послуга також включає Google Docs, Google Sheets,
|
|
||||||
Google Slides, Google Drawings, Google Sites і Google Keep. Google Форми
|
|
||||||
доступні лише як веб-додаток. Додаток дозволяє користувачам створювати та
|
|
||||||
редагувати опитування в Інтернеті, співпрацюючи з іншими користувачами
|
|
||||||
в режимі реального часу. Зібрану інформацію можна автоматично внести в
|
|
||||||
електронну таблицю.
|
|
||||||
|
|
||||||
[SurveyMonkey](https://en.wikipedia.org/wiki/SurveyMonkey)
|
|
||||||
|
|
||||||
SurveyMonkey - це служба як для створення простих і невеликих опитувань,
|
|
||||||
так і для масової розсилки анкет, виявлення тенденцій і складання більших
|
|
||||||
досліджень. Сервіс дозволяє швидко створювати опитування, налаштовувати
|
|
||||||
їх зовнішній вигляд, змінювати місцями питання, проводити А/Б-тестування,
|
|
||||||
вставляти опитування на сайти та соціальні мережі, складати дуже детальні
|
|
||||||
та наочні звіти, захищати дані та інтегрувати засоби з MailChimp,
|
|
||||||
GroSocial та іншими сервісами.
|
|
||||||
|
|
||||||
[Responsly](https://www.responsly.com)
|
|
||||||
|
|
||||||
Responsly - платформа, яка дозволяє створювати онлайн-опитування та
|
|
||||||
анкети всього за кілька секунд і надсилати їх тисячам одержувачів одним
|
|
||||||
натисканням кнопки. Також є вбудована технологія штучного інтелекту, яка
|
|
||||||
надає широкий вибір типів питань для опитувань, вибраних спеціально для
|
|
||||||
певної аудиторії.
|
|
||||||
|
|
||||||
[Jotform](https://en.wikipedia.org/wiki/Jotform)
|
|
||||||
|
|
||||||
Jotform — це потужна онлайн програма, яка дозволяє будь-кому швидко
|
|
||||||
створювати власні онлайн форми. Інтуїтивно зрозумілий інтерфейс
|
|
||||||
конструктора форм робить створення форм неймовірно простим, без написання
|
|
||||||
жодного рядка коду. За допомогою Jotform користувачі можуть створювати та
|
|
||||||
публікувати форми, інтегрувати їх у свій веб-сайт та отримувати відповіді
|
|
||||||
електронною поштою. Jotform дозволяє створювати онлайн форми, отримувати
|
|
||||||
відповіді безпосередньо в електронних листах та створювати PDF форми для
|
|
||||||
заповнення.
|
|
||||||
|
|
||||||
[QuestionPro](https://questionpro.com/)
|
|
||||||
|
|
||||||
QuestionPro — це програмне забезпечення для створення та розповсюдження
|
|
||||||
опитувань. Воно складається з інтуїтивно зрозумілого інтерфейсу для
|
|
||||||
створення запитань для опитувань, інструментів для їх розповсюдження
|
|
||||||
електронною поштою або на веб-сайті та інструментів для аналізу та
|
|
||||||
перегляду результатів.
|
|
||||||
|
|
||||||
[Fillout](https://www.fillout.com/)
|
|
||||||
|
|
||||||
Fillout — це платформа для створення форм, опитувань і тестів. Fillout
|
|
||||||
інтегрується з інструментами, які вже використовує користувач, щоб
|
|
||||||
допомогти автоматизувати робочі процеси та масштабувати операції. Час
|
|
||||||
безперебійної роботи платформи та безпека додатків є двома пріоритетами
|
|
||||||
Fillout. Для компаній із суворими вимогами щодо резидентності даних та
|
|
||||||
іншими вимогами Fillout пропонує корпоративне рішення для безпечного
|
|
||||||
отримання даних у будь-якому масштабі.
|
|
||||||
|
|
||||||
Порівняймо наведені вище сервіси із нашим проєктом.
|
|
||||||
|
|
||||||
Умовні позначення в таблиці порівняння:
|
|
||||||
- 🔴 засіб не відповідає критерію
|
|
||||||
- 🟡 засіб частково відповідає критерію або вимагає коштів для повноцінного функціоналу
|
|
||||||
- 🟢 засіб цілком відповідає критерію в безкоштовній версії
|
|
||||||
- ⚪ засіб частково або повністю не надав інформацію щодо критерію
|
|
||||||
|
|
||||||
| Критерій |Xpertise (наш проєкт)|Google Forms|SurveyMonkey|Responsly|Jotform|QuestionPro|Fillout|
|
|
||||||
|:-----------:|:-------------------:|:----------:|:----------:|:-------:|:-----:|:---------:|:-----:|
|
|
||||||
|**Functionality**| | | | | | | |
|
|
||||||
|Мобільна версія| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
|
||||||
|Типи відповідей| 4 шт. |⚪ |4 шт. (до 13 шт.)|⚪ |⚪|30 шт. (до 52 шт.)|40+ шт.|
|
|
||||||
|К-ть запитань в одній формі|50|безліч|10 (до безмежності)| безліч |100 (до 1 тис.)|безліч|безліч|
|
|
||||||
|К-ть форм | 50 (до 10 тис.) |безліч | безліч |3| 5 (до 100)|10 (до безмежності)| безліч |
|
|
||||||
|Макс. к-ть опитаних|10 тис. (до 10 млн.)|безліч | 25/міс. (до 40 тис./рік) |10/міс. (до 10 тис./міс.)|100/міс. (до 10 тис./міс.)|200/форму (до 100 тис./рік)|1 тис./міс. (до 10 тис./міс.)|
|
|
||||||
|Випадкова послідовність запитань|🟢| 🔴 | €99/міс. | $79/міс. | ⚪ | 🟡 | ⚪ |
|
|
||||||
|Умовні переходи| 🟢 | 🔴 | €39/міс. | 🟡 | ⚪ | 🟡 | 🟢 |
|
|
||||||
|Квота відповідей| 🟢 | ⚪ | €432/рік | $79/міс. | ⚪ | ⚪ | ⚪ |
|
|
||||||
|Таймер закінчення опитування| 🟢 | 🟢 | ⚪ | ⚪ | ⚪ | $1188/рік | $15/місяць |
|
|
||||||
|Перегляд недозаповнених форм| 🟢 | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | $75/міс. |
|
|
||||||
|Завантаження файлів| 🟢 | 🟢 | €432/рік | ⚪ | 🟢 | ⚪ | 🟢 |
|
|
||||||
|Доступне файлове сховище| 2 Гб (до 1 Тб) | 15 Гб (до 5 Тб) | без меж | - | 100 Мб (до 100 Гб) | - | 20 Мб/файл (до 1 Гб/файл |
|
|
||||||
|**Usability**|||||||||
|
|
||||||
|Простий будівельник форм|🟢|🟢|🟢|🟢|🟢|🟢|🟢|
|
|
||||||
|AI-помічник| 🔴 | 🔴 | 🔴 | $49/міс. | 🔴 | 🔴 | 🟢 |
|
|
||||||
|Заміна брендингу на власний|🟢 | $12/міс. | €1188/рік. | $159/міс. | 🟡 | $1188/рік | $40/міс. |
|
|
||||||
|Налаштування кольорової палітри|🟢 | 🟢 | €432/рік | $159/міс. | ⚪ | $15/міс. | $40/міс. |
|
|
||||||
|Перегляд аналітики в реальному часі| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟡 |
|
|
||||||
|**Reliability**||||||||
|
|
||||||
|Автоматичні резервні копії| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
|
||||||
|Шифрування з'єднань| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
|
||||||
|**Performance**||||||||
|
|
||||||
|Оптимальне використання мережі| 🟢 | 🔴 | 🟡 | 🟢 | 🔴 | 🟡 | 🟡 |
|
|
||||||
|**Supportability**||||||||
|
|
||||||
|Інструкція з використання| 🟢 | ⚪ | ⚪ | 🟢 | 🟢 | 🟢 | 🟢 |
|
|
||||||
|Онлайн-підтримка| 🟢 | $72/рік | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
|
||||||
|
|
||||||
## Висновки
|
|
||||||
Завдяки проведеному дослідженню ринку бачимо, що більшість сучасних платформ не надають безкоштовної можливості налаштовувати умовні переходи між сторінками опитування, а також значно обмежують максимальну кількість зібраних відповідей. Комбінація цих функцій у безкоштовній версії нашого сервісу може стати вагомою перевагою для певних груп користувачів.
|
|
||||||
|
|
||||||
Також додаткові функції (такі як квоти відповідей або перегляд недозаповнених форм), що наявні в безкоштовній версії продукту, можуть привабити додаткових користувачів, що бажають отримати такі інструменти, проте не хочуть віддавати чималі гроші за коштовні сервіси. З огляду на це вважаємо, що розробка такого проєкту має сенс.
|
|
||||||
|
|
||||||
## Література
|
|
||||||
|
|
||||||
1. [https://uk.wikipedia.org/wiki/База_даних](https://uk.wikipedia.org/wiki/База_даних)
|
|
||||||
2. [https://uk.wikipedia.org/wiki/SQL](https://uk.wikipedia.org/wiki/SQL)
|
|
||||||
3. [https://uk.wikipedia.org/wiki/Опитування](https://uk.wikipedia.org/wiki/Опитування)
|
|
||||||
4. [https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
|
||||||
5. [http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html](http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html)
|
|
||||||
6. [https://uk.wikipedia.org/wiki/Google_Форми](https://uk.wikipedia.org/wiki/Google_Форми)
|
|
||||||
7. [https://en.wikipedia.org/wiki/SurveyMonkey](https://en.wikipedia.org/wiki/SurveyMonkey)
|
|
||||||
8. [https://www.responsly.com](https://www.responsly.com)
|
|
||||||
9. [https://en.wikipedia.org/wiki/Jotform](https://en.wikipedia.org/wiki/Jotform)
|
|
||||||
10. [https://questionpro.com/](https://questionpro.com/)
|
|
||||||
11. [https://www.fillout.com/](https://www.fillout.com/)
|
|
||||||
|
|||||||
@@ -2,85 +2,250 @@
|
|||||||
|
|
||||||
## Вступ
|
## Вступ
|
||||||
|
|
||||||
*[Вступ повинен містити короткий огляд всього документу.]*
|
У даному розділі розкриваються ключові терміни та процеси, пов'язані з розробкою високоякісного програмного забезпечення. Ці матеріали надаються для зацікавлених користувачів, які прагнуть отримати глибше розуміння суті проекту та його основних завдань.
|
||||||
|
|
||||||
### Мета
|
### Мета
|
||||||
|
|
||||||
*[Визначення мети цієї сукупності вимог. Зазвичай такою метою є створення та впровадження
|
Метою є формування стратегії подальшого розвитку проекту на основі аналізу запитів цільової аудиторії, функціональних потреб та досягнення оптимальної продуктивності для створення якісного програмного забезпечення.
|
||||||
інформаційної системи відповідного призначення.]*
|
|
||||||
|
|
||||||
### Контекст
|
### Контекст
|
||||||
|
|
||||||
*[Короткий опис того, з якими проектами пов'язаний цей документ, на що він впливає.]*
|
Даний документ містить теоретичні відомості, визначення та загальний огляд функціональності, які допоможуть розробникам розуміти напрямок роботи над програмним продуктом, а клієнтам - зрозуміти очікування від нього.
|
||||||
|
|
||||||
|
|
||||||
### Основні визначення та скорочення
|
### Основні визначення та скорочення
|
||||||
|
|
||||||
*[Розділ містить визначення всіх термінів та скорочень, необхідних для правильного
|
[Зацікавлені сторони (особи)](https://uk.wikipedia.org/wiki/Зацікавлені_сторони) - фізичні та юридичні особи, які мають легітимний інтерес у діяльності організації, тобто певною мірою залежать від неї або можуть впливати на її діяльність.
|
||||||
тлумачення вимог. Можна зробити посилання на документ, в якому поданий аналіз предметної області.]*
|
|
||||||
|
[FURPS](https://en.wikipedia.org/wiki/FURPS) - абревіатура, що репрезентує модель класифікації якостей програмного забезпечення (функціональні і нефункціональні вимоги):
|
||||||
|
- *Functionality* (Функціональність) - можливості (розмір та загальний набір функцій), повторне використання (сумісність, інтероперабельність, портативність), безпека (безпека та можливість експлуатації);
|
||||||
|
- *Usability* (Використовуваність) (UX) - людський фактор, естетика, узгодженість, документація, швидкість реагування;
|
||||||
|
- *Reliability* (Надійність) - доступність (частота відмов (надійність/довговічність/стійкість), ступінь і тривалість відмов (відновлюваність/живучість)), передбачуваність (стабільність), точність (частота/серйозність помилок);
|
||||||
|
- *Perfomance* (Продуктивність) - швидкість, ефективність, споживання ресурсів (живлення, оперативна пам'ять, кеш і т.д.), пропускна здатність, ємність, масштабованість;
|
||||||
|
- *Supportability* (Підтримка) (ремонтопридатність, підтримуваність, стійкість, швидкість відновлення) - тестуємість, гнучкість (модифікованість, конфігурованість, адаптованість, розширюваність, модульність), встановлюваність, локалізованість.
|
||||||
|
|
||||||
|
[API](https://uk.wikipedia.org/wiki/Прикладний_програмний_інтерфейс) (з англ. application programming interface “прикладни́й програ́мний інтерфе́йс”) - підхід до архітектури мережевих протоколів, які надають доступ до інформаційних ресурсів.
|
||||||
|
|
||||||
|
[REST](https://uk.wikipedia.org/wiki/REST) (з англ. Representational State Transfer, «передача репрезентативного стану») — підхід до архітектури мережевих протоколів, які надають доступ до інформаційних ресурсів.
|
||||||
|
|
||||||
|
[MVC](https://en.wikipedia.org/wiki/Model–view–controller#Components) (з англ. Model-view-controller) - це патерн проектування програмного забезпечення, який зазвичай використовується для розробки користувацьких інтерфейсів, що розділяє відповідну програмну логіку на три взаємопов'язані елементи. Це робиться для того, щоб відокремити внутрішнє представлення інформації від способів її представлення користувачеві та отримання від нього.
|
||||||
|
|
||||||
|
[SOLID](https://en.wikipedia.org/wiki/SOLID) - це мнемонічна абревіатура для п'яти принципів проектування, призначених для того, щоб зробити об'єктно-орієнтовані проекти більш зрозумілими, гнучкими та зручними в обслуговуванні.
|
||||||
|
- *Принцип єдиної відповідальності*: "Ніколи не повинно бути більше однієї причини для зміни класу”. Іншими словами, кожен клас повинен мати лише одну відповідальність.
|
||||||
|
- *Принцип відкритості-закритості*: "Сутності програмного забезпечення ... повинні бути відкритими для розширення, але закритими для модифікації.
|
||||||
|
- *Принцип заміщення Ліскова*: "Функції, які використовують вказівники або посилання на базові класи, повинні мати можливість використовувати об'єкти похідних класів, не знаючи про це.
|
||||||
|
- *Принцип розділення інтерфейсів*: "Клієнти не повинні бути змушені залежати від інтерфейсів, якими вони не користуються".
|
||||||
|
- *Принцип інверсії залежності*: "Покладайтеся на абстракції, а не на конкретику".
|
||||||
|
|
||||||
|
[DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)(з англ. don’t repeat yourself - “не повторюйся”) - це принцип розробки програмного забезпечення, спрямований на зменшення повторення інформації, яка може змінитися, заміну її абстракціями, які менш схильні до змін, або використання нормалізації даних, яка дозволяє уникнути надмірності в першу чергу.
|
||||||
|
|
||||||
|
[ORM](https://uk.wikipedia.org/wiki/Об%27єктно-реляційне_відображення) - (англ. Object-relational mapping, Об'єктно-реляційна проекція) — технологія програмування, яка зв'язує бази даних з концепціями об'єктно-орієнтованих мов програмування, створюючи «віртуальну об'єктну базу даних».
|
||||||
|
|
||||||
|
|
||||||
### Посилання
|
### Посилання
|
||||||
|
|
||||||
*[Розділ містить повний список всіх документів, про які згадується.]*
|
1. [https://uk.wikipedia.org/wiki/Зацікавлені_сторони](https://uk.wikipedia.org/wiki/Зацікавлені_сторони)
|
||||||
|
2. [https://en.wikipedia.org/wiki/FURPS](https://en.wikipedia.org/wiki/FURPS)
|
||||||
|
3. [https://uk.wikipedia.org/wiki/Прикладний_програмний_інтерфейс](https://uk.wikipedia.org/wiki/Прикладний_програмний_інтерфейс)
|
||||||
|
4. [https://uk.wikipedia.org/wiki/REST](https://uk.wikipedia.org/wiki/REST)
|
||||||
|
5. [https://en.wikipedia.org/wiki/Model–view–controller#Components](https://en.wikipedia.org/wiki/Model–view–controller#Components)
|
||||||
|
6. [https://en.wikipedia.org/wiki/SOLID](https://en.wikipedia.org/wiki/SOLID)
|
||||||
|
7. [https://en.wikipedia.org/wiki/Don%27t_repeat_yourself](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)
|
||||||
|
8. [https://uk.wikipedia.org/wiki/Об%27єктно-реляційне_відображення](https://uk.wikipedia.org/wiki/Об%27єктно-реляційне_відображення)
|
||||||
|
|
||||||
|
|
||||||
## Короткий зміст
|
## Короткий зміст
|
||||||
|
|
||||||
*[Розділ містить опис того, про що йдеться в еій частині цього документу, що залишилася.
|
- [Характеристика ділових процесів](#характеристика-ділових-процесів)
|
||||||
Також тут описана структура документу.]*
|
- [Короткий огляд продукту](#короткии-огляд-продукту)
|
||||||
|
- [Функціональність](#функціональність)
|
||||||
|
- [Практичність](#практичність)
|
||||||
|
- [Надійність](#надіиність)
|
||||||
|
- [Продуктивність](#продуктивність)
|
||||||
|
- [Експлуатаційна придатність](#експлуатаціина-придатність)
|
||||||
|
|
||||||
## Характеристика ділових процесів
|
## Характеристика ділових процесів
|
||||||
|
|
||||||
*[В цьому розділі визначаються зовнішні фактори, що впливають на бізнес (бізнес-актори),
|
| ID | ACCOUNT.CREATE |
|
||||||
та внутрішні фактори (робітники), дається загальна характеристика діяльності бізнес-акторів
|
|:-----------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
та робітників, яка здійснюється за допомогою бізнесу.*
|
| Назва | Створити обліковий запис |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Відсутні |
|
||||||
|
| Результат | Обліковий запис користувача |
|
||||||
|
| Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму<br>001.002 Ідентичний псевдонім вже існує |
|
||||||
|
| Основний сценарій | 1. Користувач вводить бажаний псевдонім у поле вводу псевдоніму<br>2. Користувач вводить пароль у поле вводу паролю<br>3. Користувач натискає на кнопку створення облікового запису<br>4. Система створює обліковий запис користувача (можливі 001.001, 001.002) |
|
||||||
|
|
||||||
*Дається опис бізнес-сценаріїв взаємодії бізнес-акторів, робітників і, можливо, інформаційної системи за допомогою наступної
|
| ID | ACCOUNT.DELETE |
|
||||||
специфікації:*
|
|:-----------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Видалити обліковий запис |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі |
|
||||||
|
| Результат | Відсутність облікового запису користувача |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку видалення облікового запису<br>2. Система виводить кнопку-запит на підтвердження видалення облікового запису<br>3. Користувач натискає на кнопку підтвердження видалення облікового запису<br>4. Система видаляє обліковий запис (можлива 001.005) |
|
||||||
|
|
||||||
|
| ID | ACCOUNT.MODIFY |
|
||||||
|
|:-----------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Змінити властивості облікового запису |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі |
|
||||||
|
| Результат | Зміна властивостей облікового запису |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку редагування облікового запису<br>2. Система виводить інтерфейс для редагування облікового запису (можлива 001.005)<br>3. Користувач вказує бажані зміни властивостей облікового запису<br>4. Користувач натискає на кнопку внесення змін до властивостей облікового запису<br>5. Система змінює властивості облікового запису |
|
||||||
|
|
||||||
***ID:***
|
| ID | USER.CREATE_SURVEY |
|
||||||
|
|:-----------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Створити опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі |
|
||||||
|
| Результат | Створене опитування |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.007 Користувач ввів неприпустимі символи в назві опитування |
|
||||||
|
| Основний сценарій | 1. Користувач переходить на сторінку створення опитування (можлива 001.005)<br>2. Система виводить інтерфейс створення опитування<br>3. Користувач задає інформацію про запитання та тип опитування<br>4. Користувач натискає кнопку збереження опитування<br>5. Система створює опитування (можлива 001.007)<br>6. Система виводить посилання на проходження опитування |
|
||||||
|
|
||||||
***НАЗВА:***
|
| ID | USER.DELETE_SURVEY |
|
||||||
|
|:-----------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Видалити опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі, користувач є власником опитування |
|
||||||
|
| Результат | Відсутність опитування |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.006 Запитане опитування не існує<br>001.008 Користувач не є власником опитування |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку видалення опитування<br>2. Система виводить запит на підтвердження видалення опитування<br>3. Користувач натискає на кнопку підтвердження видалення опитування<br>4. Система видаляє опитування (можливі 001.005, 001.006, 001.008) |
|
||||||
|
|
||||||
***УЧАСНИКИ:***
|
| ID | USER.GET_SURVEY_RESULT |
|
||||||
|
|:-----------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Переглянути відповіді на опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі, користувач є власником опитування |
|
||||||
|
| Результат | Інформація про відповіді на опитування |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.006 Запитане опитування не існує<br>001.008 Користувач не є власником опитування |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку перегляду відповідей на опитування<br>2. Система виводить інформацію про відповіді на опитування (можливі 001.005, 001.006, 001.008) |
|
||||||
|
|
||||||
***ПЕРЕДУМОВИ:***
|
| ID | USER.LOGIN |
|
||||||
|
|:-----------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Пройти ідентифікацію в системі |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач має обліковий запис |
|
||||||
|
| Результат | Користувач ідентифікований в системі |
|
||||||
|
| Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму<br>001.003 Користувач ввів псевдонім, якого не існує в системі<br>001.004 Користувач ввів неправильний пароль до облікового запису |
|
||||||
|
| Основний сценарій | 1. Користувач вводить псевдонім у поле вводу псевдоніму<br>2. Користувач вводить пароль у поле вводу паролю<br>3. Користувач натискає кнопку ідентифікації<br>4. Система ідентифікує користувача (можливі 001.001, 001.003, 001.004) |
|
||||||
|
|
||||||
***РЕЗУЛЬТАТ:***
|
| ID | USER.LOGOUT |
|
||||||
|
|:-----------------:|:-------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Скинути дані про ідентифікацію в системі |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі |
|
||||||
|
| Результат | Користувач не ідентифікований в системі |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку виходу з облікового запису<br>2. Система скидає інформацію про ідентифікацію користувача (можлива 001.005) |
|
||||||
|
|
||||||
***ВИКЛЮЧНІ СИТУАЦІЇ:***
|
| ID | USER.MODIFY_SURVEY |
|
||||||
|
|:-----------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Редагувати опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі, користувач є власником опитування |
|
||||||
|
| Результат | Змінене опитування |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.006 Запитане опитування не існує<br>001.008 Користувач не є власником опитування |
|
||||||
|
| Основний сценарій | 1. Користувач переходить на сторінку редагування опитування<br>2. Система виводить інтерфейс редагування опитування (можливі 001.005, 001.006, 001.008)<br>3. Користувач задає інформацію про зміни в опитуванні<br>4. Користувач натискає кнопку збереження змін в опитуванні<br>5. Система змінює опитування |
|
||||||
|
|
||||||
***ОСНОВНИЙ СЦЕНАРІЙ:***
|
| ID | USER.STAT_SURVEY |
|
||||||
|
|:-----------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Переглянути властивості опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі, користувач є власником опитування |
|
||||||
|
| Результат | Інформація про властивості опитування |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.006 Запитане опитування не існує<br>001.008 Користувач не є власником опитування |
|
||||||
|
| Основний сценарій | 1. Користувач натискає на кнопку перегляду інформації про опитування<br>2. Система виводить інформацію про опитування (можливі 001.005, 001.006, 001.008) |
|
||||||
|
|
||||||
*Кількість сценаріїв визначається у відповідності до специфіки завдання та необхідного
|
| ID | USER.TAKE_ANON_SURVEY |
|
||||||
рівня деталізації (зазвичай, 5-6 сценаріїв).*
|
|:-----------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Пройти анонімне опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Відсутні |
|
||||||
|
| Результат | Запис відповідей на опитування |
|
||||||
|
| Виключні ситуації | 001.006 Запитане опитування не існує |
|
||||||
|
| Основний сценарій | 1. Користувач переходить на сторінку проходження опитування<br>2. Система виводить перелік запитань опитування (можлива 001.006)<br>3. Користувач вводить відповіді на запитання<br>4. Користувач натискає кнопку надсилання відповідей<br>5. Система записує відповіді на опитування (можлива 001.006)<br>6. Система виводить прощальне повідомлення |
|
||||||
|
|
||||||
|
| ID | USER.TAKE_NAMED_SURVEY |
|
||||||
|
|:-----------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|
||||||
|
| Назва | Пройти поіменне опитування |
|
||||||
|
| Учасники | Користувач, система |
|
||||||
|
| Передумови | Користувач ідентифікований в системі |
|
||||||
|
| Результат | Запис відповідей на опитування та відомості про користувача |
|
||||||
|
| Виключні ситуації | 001.005 Користувач не ідентифікований<br>001.006 Запитане опитування не існує |
|
||||||
|
| Основний сценарій | 1. Користувач переходить на сторінку проходження опитування<br>2. Система виводить перелік запитань опитування (можливі 001.005, 001.006)<br>3. Користувач вводить відповіді на запитання<br>4. Користувач натискає кнопку надсилання відповідей<br>5. Система записує відповіді на опитування та відомості про користувача (можлива 001.006)<br>6. Система виводить прощальне повідомлення |
|
||||||
|
|
||||||
## Короткий огляд продукту
|
## Короткий огляд продукту
|
||||||
|
|
||||||
*[Визначається границя системи та категорії її користувачів. Дається загальна характеристика категорій користувачів
|
<center>
|
||||||
системи]*
|
<img width=60% src="http://139.162.162.130:16660/img/logo2-web.svg">
|
||||||
|
</center>
|
||||||
*[Нижче йде опис FURPS:]*
|
|
||||||
|
|
||||||
|
Xpertise - це система для проведення будь-яких опитувань.
|
||||||
|
Вона дозволяє користувачам створювати опитування, збирати відповіді на них та переглядати докладну й узагальнену статистику.
|
||||||
|
У користувачів є можливість створювати не лише анонімні, але й поіменні опитування, тому платформа також задовольнить потреби в проведенні голосувань для прийняття спільних рішень у командах.
|
||||||
|
|
||||||
## Функціональність
|
## Функціональність
|
||||||
|
|
||||||
*[Functionality (функциональні вимоги)]*
|
Наша система спрямована, в першу чергу, на взаємодію з користувачами.
|
||||||
|
|
||||||
|
***Користувач** - це особа, що взаємодіє із системою.*
|
||||||
|
|
||||||
|
Cистема розділяє користувачів на дві категорії:
|
||||||
|
- гість
|
||||||
|
- авторизований користувач
|
||||||
|
|
||||||
|
***Гість** - це користувач, що не пройшов ідентифікацію в системі. Такого користувача не можна зіставити з жодним обліковим записом.*
|
||||||
|
|
||||||
|
Гість може:
|
||||||
|
- створити обліковий запис
|
||||||
|
- пройти ідентифікацію в системі
|
||||||
|
- пройти анонімне опитування
|
||||||
|
|
||||||
|
***Зареєстрований користувач** - це користувач, котрий успішно пройшов ідентифікацію в системі. Такого користувача можна однозначно зіставити з обліковим записом, що наявний у системі.*
|
||||||
|
|
||||||
|
Зареєстрований користувач може:
|
||||||
|
- редагувати властивості свого облікового запису
|
||||||
|
- видалити свій обліковий запис
|
||||||
|
- скинути дані про ідентицікацію в системі
|
||||||
|
- створити опитування
|
||||||
|
- відредагувати своє опитування
|
||||||
|
- видалити своє опитування
|
||||||
|
- призупинити своє опитування
|
||||||
|
- продовжити своє опитування
|
||||||
|
- переглянути властивості свого опитування
|
||||||
|
- переглянути результати свого опитування
|
||||||
|
- пройти анонімне опитування
|
||||||
|
- пройти поіменне опитування
|
||||||
|
|
||||||
|
*[Респондент](https://slovnyk.ua/index.php?swrd=%D1%80%D0%B5%D1%81%D0%BF%D0%BE%D0%BD%D0%B4%D0%B5%D0%BD%D1%82) - той, хто відповідає на питання анкети; опитуваний.*
|
||||||
|
|
||||||
|
***Опитування** - це перелік запитань, кожне з яких передбачає обов'язкову або необов'язкову відповідь. Кожна відповідь має визначений тип.*
|
||||||
|
|
||||||
|
***Анонімне опитування** - це опитування, відповідь на яке може не містити інформації про обліковий запис респондента (*респондент все одно може вирішити надати таку інформацію).*
|
||||||
|
|
||||||
|
***Поіменне опитування** - це опитування, відповідь на яке обов'язково містить дані про обліковий запис респондента.*
|
||||||
|
|
||||||
## Практичність
|
## Практичність
|
||||||
|
|
||||||
*[Usability (вимоги до зручності роботи)]*
|
- Наявність зручного інструменту для побудови опитувань
|
||||||
|
- Можливість легко замінити брендинг та кольорову палітру
|
||||||
|
- Перегляд аналітики в реальному часі
|
||||||
|
- Формування статистики відповідей у зручному інтерфейсі
|
||||||
|
- Можливість експорту результатів опитування через API
|
||||||
|
- Підтримка програмування реакцій на події (hooks)
|
||||||
|
|
||||||
## Надійність
|
## Надійність
|
||||||
|
|
||||||
*[Reliability (вимоги до надійності)]*
|
- Шифрування з'єднань (TLS)
|
||||||
|
- Автоматичне резервне копіювання
|
||||||
|
- Автоматичне відновлення з резервних копій
|
||||||
|
|
||||||
## Продуктивність
|
## Продуктивність
|
||||||
|
|
||||||
*[Performance (вимоги до продуктивності)]*
|
- Низьке використання мережі базовим протоколом
|
||||||
|
- Незалежність від сторонніх веб-хостингів
|
||||||
|
|
||||||
## Експлуатаційна придатність
|
## Експлуатаційна придатність
|
||||||
|
|
||||||
*[Supportability (вимоги до підтримки)]*
|
- Наявність докладної документації для користувачів, адміністраторів та розробників
|
||||||
|
- Доступність онлайн-підтримки
|
||||||
|
|||||||
221
docs/requirements/state-of-the-art.md
Normal file
221
docs/requirements/state-of-the-art.md
Normal file
@@ -0,0 +1,221 @@
|
|||||||
|
# Розроблення вимог до системи
|
||||||
|
|
||||||
|
## Вступ
|
||||||
|
У даному розділі проводиться аналіз предметної області, пов'язаної з системою організації та управління експертними опитуваннями. Представлені такі категорії:
|
||||||
|
|
||||||
|
- [Основні визначення](#основні-визначення), котрі можна зустріти в сфері експертних опитувань
|
||||||
|
- [Підходи та способи вирішення завдання](#підходи-та-способи-вирішення-завдання) опитування експертів
|
||||||
|
- [Порівняльна характеристика наявних засобів вирішення завдання](#порівняльна-характеристика-існуючих-засобів-вирішення-завдання) опитування експертів
|
||||||
|
- [Висновки](#висновки) щодо доцільності розробки нової системи
|
||||||
|
- [Література](#література), де наведені посилання на джерела інформації
|
||||||
|
|
||||||
|
## Основні визначення
|
||||||
|
### Технічні визначення
|
||||||
|
**База даних** [](https://uk.wikipedia.org/wiki/База_даних)
|
||||||
|
|
||||||
|
База даних (англ. database) – сукупність даних, організованих відповідно до концепції, яка описує характеристику цих даних і взаємозв'язки між їх елементами; ця сукупність підтримує щонайменше одну з областей застосування (за стандартом ISO/IEC 2382:2015). В загальному випадку база даних містить схеми, таблиці, подання, збережені процедури та інші об'єкти. Дані у базі організовують відповідно до моделі організації даних. Таким чином, сучасна база даних, крім самих даних, містить їх опис та може містити засоби для їх обробки.
|
||||||
|
|
||||||
|
**SQL** [](https://uk.wikipedia.org/wiki/SQL)
|
||||||
|
|
||||||
|
SQL (англ. Structured query language — мова структурованих запитів) — декларативна мова програмування для взаємодії користувача з базами даних, що застосовується для формування запитів, оновлення і керування реляційними БД, створення схеми бази даних та її модифікації, системи контролю за доступом до бази даних. Сама по собі SQL не є ані системою керування базами даних, ані окремим програмним продуктом. На відміну від дійсних мов програмування (C або Pascal), SQL може формувати інтерактивні запити або, бувши вбудованою в прикладні програми, виступати як інструкції для керування даними. Окрім цього, стандарт SQL містить функції для визначення зміни, перевірки та захисту даних.
|
||||||
|
|
||||||
|
### Загальні визначення
|
||||||
|
**Опитування** [](https://uk.wikipedia.org/wiki/Опитування)
|
||||||
|
|
||||||
|
Опи́тування — це метод збору соціологічної інформації про досліджуваний об'єкт під час безпосереднього (усне опитування, інтерв'ю) або опосередкованого (письмове опитування, анкетування) спілкування того хто опитує з респондентом. Опитування бувають соціологічні, політологічні, маркетингові, психологічні — залежно від предмету дослідження. Залежно від кількості опитуваних (вибірки, вибіркової сукупності) вони також можуть бути масовими, вибірковими, індивідуальними, експертними. Також використовується для вимірювання «громадської думки» з різних питань.
|
||||||
|
|
||||||
|
**Експерт** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
Експертом називають людину, що є фахівцем (спеціалістом) у певній предметній області (ПО) і може пояснити свої дії та міркування. Предметною областю називають будь-яку галузь діяльності людини, наприклад, “Технічні засоби автоматизації”, “Охорона довкілля”, “Системи штучного інтелекту” тощо.
|
||||||
|
**Експертне опитування**
|
||||||
|
Експертне опитування або опитування фахівців — це особливий метод маркетингового (і/або соціологічного) дослідження. В рамках такого опитування досліджувана тема обговорюється з експертами, компетентними в даній сфері.
|
||||||
|
### Методи експертного опитування
|
||||||
|
#### Активні методи
|
||||||
|
Активні методи передбачають спілкування між організаторами та експертами. Можливі два напрямки активної роботи з експертами: індивідуальна робота з експертом (анонімна чи відкрита) та робота з групою в цілому.
|
||||||
|
***
|
||||||
|
#### До індивідуальних активних методів належать анкетування, інтерв’ю, діалог з експертом, ігри з експертом.
|
||||||
|
|
||||||
|
**Інтерв’ю** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
Інтерв’ю – це форма спілкування між дослідником та експертом, при якій дослідник ставить заздалегідь підготовлену чергу запитань. Можна замінити ці запитання на інші у відповідності до ситуації.
|
||||||
|
|
||||||
|
**Діалог** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
Діалог – це метод отримання знань у формі бесіди між дослідником та експертом, коли немає жорстко регламентованого плану проведеня і визначеного заздалегідь переліку запитань.
|
||||||
|
|
||||||
|
**Ігри з експертом** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
Ігри з експертом (експертні ігри) – це експерименти, у яких фахівцю пропонують важливі ситуації з предметної області. Фахівець повинен запропонувати рішення по виходу з цих ситуацій на основі свого життєвого досвіду, спеціальних знань та уявлень.
|
||||||
|
***
|
||||||
|
#### До методів активної роботи з групою в цілому належать методи круглого столу, мозкового штурму та рольові ігри.
|
||||||
|
|
||||||
|
**Круглий стіл** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
“Круглий стіл” передбачає обговорення певної проблеми, у якому приймають участь експерти з однаковими правами. Задача дискусії – вивчити проблему всебічно, тому слід запрошувати експертів, які належать до різних наукових напрямків, мають різний вік, стать і т.ін. Цей метод не передбачає терміновості прийняття рішення.
|
||||||
|
|
||||||
|
**Мозковий штурм** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
“Мозковий штурм (атака)” – один із найбільш поширених методів активізації думок. Його застосовують у тих випадках, коли потрібно знайти вирішення певної проблеми за дуже короткий час. Під час такого обговоренння кожний експерт повинен запропонувати свій шлях розвязання задачі або розвинути думку іншого учасника.
|
||||||
|
|
||||||
|
**Рольові ігри** [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
Рольові ігри (експертні ігри) – це експерименти, у яких колективу спеціалістів пропонують складні ситуації з предметної області. Спеціалісти у процесі відкритого обговорення приймають рішення про шляхи виходу з цих ситуацій.
|
||||||
|
***
|
||||||
|
#### Пасивні методи
|
||||||
|
До пасивних методів належать спостереження за діяльністю експертів, запис їхніх міркувань у процесі роботи (так звані *“думки вголос”*), лекції, які вони можуть прочитати. [](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
|
||||||
|
|
||||||
|
## Підходи та способи вирішення завдання
|
||||||
|
|
||||||
|
[Методисти виділяють методи **заочного** та **очного** експертного опитування.](http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html)
|
||||||
|
|
||||||
|
До методів **заочного** опитування відносять:
|
||||||
|
- письмове опитування («збір думок»);
|
||||||
|
- анкетування;
|
||||||
|
- дельфійська техніка;
|
||||||
|
|
||||||
|
До **очних** методів належать:
|
||||||
|
- «мозкова атака».
|
||||||
|
|
||||||
|
Письмове опитування (або «збір думок») – вважається найпростішим методом заочного опитування експертів. Він полягає в тому, що експертам надають спеціально підготовлені опитувальні листи, в яких вони повинні викласти свою думку по суті поставлених питань. При складанні експертного опитувальника від 50 до 90% використовуються відкриті питання. Збір думок подібний вільному інтерв'ю і відрізняється від нього лише письмовою формою опитування.
|
||||||
|
|
||||||
|
Плюси: дає можливість залучити велику кількість експертів.
|
||||||
|
|
||||||
|
Мінуси: заочний опитування пов'язане з організаційними труднощами, зумовленими низьким рівнем повернення анкет.
|
||||||
|
|
||||||
|
Анкетування – даний тип опитування може бути сформований як у відкритій, так і в закритій формі. Сильно відрізняється від письмового збору думок, оскільки спрямоване на з’ясування оцінок фахівцями тих чи інших аспектів готового рішення.
|
||||||
|
|
||||||
|
Плюси: можливість анонімного збору даних; значно спрощує можливість збору даних; стандартизація.
|
||||||
|
|
||||||
|
Мінуси: учасники можуть відмовитися від відповідей або дати неправильні відповіді через обмежену варіативність; негнучкість методу (негативна сторона стандартизованості).
|
||||||
|
|
||||||
|
Метод Дельфі – опитування експертної групи в кілька турів з узгодженням думок експертів. Суть цього методу в тому, щоб за допомогою серії послідовних дій - опитувань, інтерв'ю, мозкових штурмів - домогтися максимального консенсусу при визначенні правильного рішення. Метод передбачає опитування експертів в кілька турів (зазвичай 2-3), обробку результатів кожного туру, інформування їх про ці результати і знову повторення такої ж процедури. У першому турі відповіді даються без аргументації. Після обробки виділяються крайні і середні судження і повідомляються експертам. У другому турі опитувані знову звертаються до своїх оцінок. Так як вони мали досить часу на роздуми і дізналися про існування інших позицій з цього приводу, вони можуть переглянути свої погляди або, навпаки, посилити їх аргументацію. Після другого туру обробляються нові оцінки - крайні і середні думки узагальнюються, підсумки знову доповідають експертам. Так повторюється 3-4 рази. Практика показує, що після третього або четвертого туру думки експертів не змінюються. В ході подібної процедури виробляється узгоджена оцінка, причому дослідник не повинен нехтувати громадською думкою тих, хто після неодноразових опитувань залишився на своїй позиції.
|
||||||
|
|
||||||
|
Плюси: подібна техніка дозволяє зменшити вплив недостатньо компетентних експертів на групову оцінку, як це спостерігається при простому анкетуванні. Воно досягається за рахунок отриманої цінної інформації від більш компетентних експертів.
|
||||||
|
|
||||||
|
Мінуси: часові витрати; можливість втрати мотивації учасників.
|
||||||
|
|
||||||
|
Метод «мозкового штурму (атаки)»
|
||||||
|
|
||||||
|
Плюси: стимулювання творчості; розширення горизонтів.
|
||||||
|
|
||||||
|
Мінуси: відсутність структури; можливість домінування деяких учасників.
|
||||||
|
|
||||||
|
## Порівняльна характеристика існуючих засобів вирішення завдання
|
||||||
|
|
||||||
|
Розглядатимемо такі найпопулярніші інструменти для проведення анкетувань:
|
||||||
|
|
||||||
|
[Google Forms](https://uk.wikipedia.org/wiki/Google_Форми)
|
||||||
|
|
||||||
|
Google Forms — програмне забезпечення для адміністрування опитування,
|
||||||
|
що входить до складу безкоштовного веб-пакету Google Docs Editors,
|
||||||
|
пропонованого Google. Послуга також включає Google Docs, Google Sheets,
|
||||||
|
Google Slides, Google Drawings, Google Sites і Google Keep. Google Форми
|
||||||
|
доступні лише як веб-додаток. Додаток дозволяє користувачам створювати та
|
||||||
|
редагувати опитування в Інтернеті, співпрацюючи з іншими користувачами
|
||||||
|
в режимі реального часу. Зібрану інформацію можна автоматично внести в
|
||||||
|
електронну таблицю.
|
||||||
|
|
||||||
|
[SurveyMonkey](https://en.wikipedia.org/wiki/SurveyMonkey)
|
||||||
|
|
||||||
|
SurveyMonkey - це служба як для створення простих і невеликих опитувань,
|
||||||
|
так і для масової розсилки анкет, виявлення тенденцій і складання більших
|
||||||
|
досліджень. Сервіс дозволяє швидко створювати опитування, налаштовувати
|
||||||
|
їх зовнішній вигляд, змінювати місцями питання, проводити А/Б-тестування,
|
||||||
|
вставляти опитування на сайти та соціальні мережі, складати дуже детальні
|
||||||
|
та наочні звіти, захищати дані та інтегрувати засоби з MailChimp,
|
||||||
|
GroSocial та іншими сервісами.
|
||||||
|
|
||||||
|
[Responsly](https://www.responsly.com)
|
||||||
|
|
||||||
|
Responsly - платформа, яка дозволяє створювати онлайн-опитування та
|
||||||
|
анкети всього за кілька секунд і надсилати їх тисячам одержувачів одним
|
||||||
|
натисканням кнопки. Також є вбудована технологія штучного інтелекту, яка
|
||||||
|
надає широкий вибір типів питань для опитувань, вибраних спеціально для
|
||||||
|
певної аудиторії.
|
||||||
|
|
||||||
|
[Jotform](https://en.wikipedia.org/wiki/Jotform)
|
||||||
|
|
||||||
|
Jotform — це потужна онлайн програма, яка дозволяє будь-кому швидко
|
||||||
|
створювати власні онлайн форми. Інтуїтивно зрозумілий інтерфейс
|
||||||
|
конструктора форм робить створення форм неймовірно простим, без написання
|
||||||
|
жодного рядка коду. За допомогою Jotform користувачі можуть створювати та
|
||||||
|
публікувати форми, інтегрувати їх у свій веб-сайт та отримувати відповіді
|
||||||
|
електронною поштою. Jotform дозволяє створювати онлайн форми, отримувати
|
||||||
|
відповіді безпосередньо в електронних листах та створювати PDF форми для
|
||||||
|
заповнення.
|
||||||
|
|
||||||
|
[QuestionPro](https://questionpro.com/)
|
||||||
|
|
||||||
|
QuestionPro — це програмне забезпечення для створення та розповсюдження
|
||||||
|
опитувань. Воно складається з інтуїтивно зрозумілого інтерфейсу для
|
||||||
|
створення запитань для опитувань, інструментів для їх розповсюдження
|
||||||
|
електронною поштою або на веб-сайті та інструментів для аналізу та
|
||||||
|
перегляду результатів.
|
||||||
|
|
||||||
|
[Fillout](https://www.fillout.com/)
|
||||||
|
|
||||||
|
Fillout — це платформа для створення форм, опитувань і тестів. Fillout
|
||||||
|
інтегрується з інструментами, які вже використовує користувач, щоб
|
||||||
|
допомогти автоматизувати робочі процеси та масштабувати операції. Час
|
||||||
|
безперебійної роботи платформи та безпека додатків є двома пріоритетами
|
||||||
|
Fillout. Для компаній із суворими вимогами щодо резидентності даних та
|
||||||
|
іншими вимогами Fillout пропонує корпоративне рішення для безпечного
|
||||||
|
отримання даних у будь-якому масштабі.
|
||||||
|
|
||||||
|
Порівняймо наведені вище сервіси із нашим проєктом.
|
||||||
|
|
||||||
|
Умовні позначення в таблиці порівняння:
|
||||||
|
- 🔴 засіб не відповідає критерію
|
||||||
|
- 🟡 засіб частково відповідає критерію або вимагає коштів для повноцінного функціоналу
|
||||||
|
- 🟢 засіб цілком відповідає критерію в безкоштовній версії
|
||||||
|
- ⚪ засіб частково або повністю не надав інформацію щодо критерію
|
||||||
|
|
||||||
|
| Критерій |Xpertise (наш проєкт)|Google Forms|SurveyMonkey|Responsly|Jotform|QuestionPro|Fillout|
|
||||||
|
|:-----------:|:-------------------:|:----------:|:----------:|:-------:|:-----:|:---------:|:-----:|
|
||||||
|
|**Functionality**| | | | | | | |
|
||||||
|
|Мобільна версія| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
||||||
|
|Типи відповідей| 4 шт. |⚪ |4 шт. (до 13 шт.)|⚪ |⚪|30 шт. (до 52 шт.)|40+ шт.|
|
||||||
|
|К-ть запитань в одній формі|50|безліч|10 (до безмежності)| безліч |100 (до 1 тис.)|безліч|безліч|
|
||||||
|
|К-ть форм | 50 (до 10 тис.) |безліч | безліч |3| 5 (до 100)|10 (до безмежності)| безліч |
|
||||||
|
|Макс. к-ть опитаних|10 тис. (до 10 млн.)|безліч | 25/міс. (до 40 тис./рік) |10/міс. (до 10 тис./міс.)|100/міс. (до 10 тис./міс.)|200/форму (до 100 тис./рік)|1 тис./міс. (до 10 тис./міс.)|
|
||||||
|
|Випадкова послідовність запитань|🟢| 🔴 | €99/міс. | $79/міс. | ⚪ | 🟡 | ⚪ |
|
||||||
|
|Умовні переходи| 🟢 | 🔴 | €39/міс. | 🟡 | ⚪ | 🟡 | 🟢 |
|
||||||
|
|Квота відповідей| 🟢 | ⚪ | €432/рік | $79/міс. | ⚪ | ⚪ | ⚪ |
|
||||||
|
|Таймер закінчення опитування| 🟢 | 🟢 | ⚪ | ⚪ | ⚪ | $1188/рік | $15/місяць |
|
||||||
|
|Перегляд недозаповнених форм| 🟢 | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | $75/міс. |
|
||||||
|
|Завантаження файлів| 🟢 | 🟢 | €432/рік | ⚪ | 🟢 | ⚪ | 🟢 |
|
||||||
|
|Доступне файлове сховище| 2 Гб (до 1 Тб) | 15 Гб (до 5 Тб) | без меж | - | 100 Мб (до 100 Гб) | - | 20 Мб/файл (до 1 Гб/файл |
|
||||||
|
|**Usability**|||||||||
|
||||||
|
|Простий будівельник форм|🟢|🟢|🟢|🟢|🟢|🟢|🟢|
|
||||||
|
|AI-помічник| 🔴 | 🔴 | 🔴 | $49/міс. | 🔴 | 🔴 | 🟢 |
|
||||||
|
|Заміна брендингу на власний|🟢 | $12/міс. | €1188/рік. | $159/міс. | 🟡 | $1188/рік | $40/міс. |
|
||||||
|
|Налаштування кольорової палітри|🟢 | 🟢 | €432/рік | $159/міс. | ⚪ | $15/міс. | $40/міс. |
|
||||||
|
|Перегляд аналітики в реальному часі| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟡 |
|
||||||
|
|**Reliability**||||||||
|
||||||
|
|Автоматичні резервні копії| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
||||||
|
|Шифрування з'єднань| 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
||||||
|
|**Performance**||||||||
|
||||||
|
|Оптимальне використання мережі| 🟢 | 🔴 | 🟡 | 🟢 | 🔴 | 🟡 | 🟡 |
|
||||||
|
|**Supportability**||||||||
|
||||||
|
|Інструкція з використання| 🟢 | ⚪ | ⚪ | 🟢 | 🟢 | 🟢 | 🟢 |
|
||||||
|
|Онлайн-підтримка| 🟢 | $72/рік | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
|
||||||
|
|
||||||
|
## Висновки
|
||||||
|
Завдяки проведеному дослідженню ринку бачимо, що більшість сучасних платформ не надають безкоштовної можливості налаштовувати умовні переходи між сторінками опитування, а також значно обмежують максимальну кількість зібраних відповідей. Комбінація цих функцій у безкоштовній версії нашого сервісу може стати вагомою перевагою для певних груп користувачів.
|
||||||
|
|
||||||
|
Також додаткові функції (такі як квоти відповідей або перегляд недозаповнених форм), що наявні в безкоштовній версії продукту, можуть привабити додаткових користувачів, що бажають отримати такі інструменти, проте не хочуть віддавати чималі гроші за коштовні сервіси. З огляду на це вважаємо, що розробка такого проєкту має сенс.
|
||||||
|
|
||||||
|
## Література
|
||||||
|
|
||||||
|
1. [https://uk.wikipedia.org/wiki/База_даних](https://uk.wikipedia.org/wiki/База_даних)
|
||||||
|
2. [https://uk.wikipedia.org/wiki/SQL](https://uk.wikipedia.org/wiki/SQL)
|
||||||
|
3. [https://uk.wikipedia.org/wiki/Опитування](https://uk.wikipedia.org/wiki/Опитування)
|
||||||
|
4. [https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content](https://ela.kpi.ua/server/api/core/bitstreams/8a8030cf-bfc1-4586-b197-1c7e3bf02700/content)
|
||||||
|
5. [http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html](http://elbib.in.ua/vidi-ekspertnogo-opituvannya-metodologiya-ta-metodi-sotsiologichnih-doslidjen.html)
|
||||||
|
6. [https://uk.wikipedia.org/wiki/Google_Форми](https://uk.wikipedia.org/wiki/Google_Форми)
|
||||||
|
7. [https://en.wikipedia.org/wiki/SurveyMonkey](https://en.wikipedia.org/wiki/SurveyMonkey)
|
||||||
|
8. [https://www.responsly.com](https://www.responsly.com)
|
||||||
|
9. [https://en.wikipedia.org/wiki/Jotform](https://en.wikipedia.org/wiki/Jotform)
|
||||||
|
10. [https://questionpro.com/](https://questionpro.com/)
|
||||||
|
11. [https://www.fillout.com/](https://www.fillout.com/)
|
||||||
47
docs/use-cases/README.md
Normal file
47
docs/use-cases/README.md
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
# Модель прецедентів
|
||||||
|
|
||||||
|
## Загальна схема
|
||||||
|
|
||||||
|
<center style="
|
||||||
|
border-radius: 4px;
|
||||||
|
border: 1px solid #cfd7e6;
|
||||||
|
box-shadow: 0 1px 3px 0 rgba(89,105,129,.05), 0 1px 1px 0 rgba(0,0,0,.025);
|
||||||
|
padding: 1em;
|
||||||
|
">
|
||||||
|
|
||||||
|
@startuml
|
||||||
|
|
||||||
|
:Гість: as Guest
|
||||||
|
:Зареєстрований користувач: as AuthorisedUser
|
||||||
|
|
||||||
|
(<b>ACCOUNT.CREATE</b>\nСтворити обліковий запис) as CreateAccount
|
||||||
|
(<b>ACCOUNT.DELETE</b>\nВидалити обліковий запис) as DeleteAccount
|
||||||
|
(<b>ACCOUNT.MODIFY</b>\nЗмінити властивості облікового запису) as ModifyAccount
|
||||||
|
(<b>USER.CREATE_SURVEY</b>\nСтворити опитування) as CreateSurvey
|
||||||
|
(<b>USER.DELETE_SURVEY</b>\nВидалити опитування) as DeleteSurvey
|
||||||
|
(<b>USER.GET_SURVEY_RESULT</b>\nПереглянути відповіді на опитування) as GetSurveyResult
|
||||||
|
(<b>USER.LOGIN</b>\nПройти ідентифікацію в системі) as LogIn
|
||||||
|
(<b>USER.LOGOUT</b>\nСкинути дані про ідентифікацію в системі) as LogOut
|
||||||
|
(<b>USER.MODIFY_SURVEY</b>\nРедагувати опитування) as ModifySurvey
|
||||||
|
(<b>USER.STAT_SURVEY</b>\nПереглянути властивості опитування) as StatSurvey
|
||||||
|
(<b>USER.TAKE_ANON_SURVEY</b>\nПройти анонімне опитування) as TakeAnonSurvey
|
||||||
|
(<b>USER.TAKE_NAMED_SURVEY</b>\nПройти поіменне опитування) as TakeNamedSurvey
|
||||||
|
|
||||||
|
Guest -u-> CreateAccount
|
||||||
|
Guest --> LogIn
|
||||||
|
Guest -r-> TakeAnonSurvey
|
||||||
|
|
||||||
|
AuthorisedUser -r-> ModifyAccount
|
||||||
|
AuthorisedUser -u-> DeleteAccount
|
||||||
|
AuthorisedUser -u-> LogOut
|
||||||
|
AuthorisedUser --> CreateSurvey
|
||||||
|
AuthorisedUser -u-> DeleteSurvey
|
||||||
|
AuthorisedUser --> StatSurvey
|
||||||
|
AuthorisedUser --> ModifySurvey
|
||||||
|
AuthorisedUser --> GetSurveyResult
|
||||||
|
AuthorisedUser -l-> TakeAnonSurvey
|
||||||
|
AuthorisedUser -d-> TakeNamedSurvey
|
||||||
|
|
||||||
|
@enduml
|
||||||
|
|
||||||
|
</center>
|
||||||
@@ -1,6 +1,7 @@
|
|||||||
#!/bin/python3
|
#!/bin/python3
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
|
import os
|
||||||
|
|
||||||
# magic values
|
# magic values
|
||||||
NO = 0
|
NO = 0
|
||||||
@@ -26,7 +27,7 @@ def convert_usecase_v1(filename, data):
|
|||||||
|
|
||||||
merged_lines = []
|
merged_lines = []
|
||||||
for i in split_raw_lines:
|
for i in split_raw_lines:
|
||||||
if i[0] == "":
|
if i[0].replace(" ", "") == "":
|
||||||
merged_lines[-1][1] += "<br>" + i[1]
|
merged_lines[-1][1] += "<br>" + i[1]
|
||||||
else:
|
else:
|
||||||
merged_lines.append(i)
|
merged_lines.append(i)
|
||||||
@@ -68,9 +69,10 @@ if __name__=="__main__":
|
|||||||
usecase_formatting = AUTO
|
usecase_formatting = AUTO
|
||||||
verbose = AUTO
|
verbose = AUTO
|
||||||
process_table_files = AUTO
|
process_table_files = AUTO
|
||||||
|
file_output_path = None
|
||||||
|
|
||||||
# 1 pass (argument harvest)
|
# 1 pass (argument harvest)
|
||||||
for i in sys.argv[1:]:
|
for n, i in enumerate(sys.argv[1:]):
|
||||||
if i.startswith("-"):
|
if i.startswith("-"):
|
||||||
# записувати таблицю в файл
|
# записувати таблицю в файл
|
||||||
if i in ["-f", "--file"]:
|
if i in ["-f", "--file"]:
|
||||||
@@ -96,11 +98,17 @@ if __name__=="__main__":
|
|||||||
elif i in ["-nv", "--no-verbose"]:
|
elif i in ["-nv", "--no-verbose"]:
|
||||||
verbose = NO
|
verbose = NO
|
||||||
|
|
||||||
|
# дозволити обробку файлів .table
|
||||||
elif i in ["-t", "--process-table"]:
|
elif i in ["-t", "--process-table"]:
|
||||||
process_table_files = YES
|
process_table_files = YES
|
||||||
elif i in ["-nt", "--no-process-table"]:
|
elif i in ["-nt", "--no-process-table"]:
|
||||||
process_table_files = NO
|
process_table_files = NO
|
||||||
|
|
||||||
|
# задає папку, в яку необхідно зберігати конвертовані таблиці
|
||||||
|
elif i in ["-d", "--destination"]:
|
||||||
|
file_output_path = sys.argv[n+2]
|
||||||
|
sys.argv.remove(sys.argv[n+2])
|
||||||
|
|
||||||
# 2 pass (filename harvest)
|
# 2 pass (filename harvest)
|
||||||
for i in sys.argv[1:]:
|
for i in sys.argv[1:]:
|
||||||
if not i.startswith("-"):
|
if not i.startswith("-"):
|
||||||
@@ -133,12 +141,17 @@ if __name__=="__main__":
|
|||||||
print(formatted_table_data)
|
print(formatted_table_data)
|
||||||
|
|
||||||
if write_to_file > AUTO:
|
if write_to_file > AUTO:
|
||||||
open(name + ".table", 'w', encoding = "utf-8").write(formatted_table_data+"\n")
|
if file_output_path:
|
||||||
|
open(os.path.join(file_output_path, os.path.basename(name)) \
|
||||||
|
+ ".table", 'w', encoding = "utf-8") \
|
||||||
|
.write(formatted_table_data+"\n")
|
||||||
|
else:
|
||||||
|
open(name + ".table", 'w', encoding = "utf-8").write(formatted_table_data+"\n")
|
||||||
|
|
||||||
exit(0)
|
exit(0)
|
||||||
|
|
||||||
for no, name in enumerate(files):
|
for no, name in enumerate(files):
|
||||||
print(f"Converting {no+1}/{len(files)}")
|
print(f"Converting {no+1:02d}/{len(files)}: {name}")
|
||||||
|
|
||||||
data = open(name, encoding = "utf-8").read()
|
data = open(name, encoding = "utf-8").read()
|
||||||
|
|
||||||
@@ -157,4 +170,9 @@ if __name__=="__main__":
|
|||||||
print(formatted_table_data)
|
print(formatted_table_data)
|
||||||
|
|
||||||
if write_to_file >= AUTO:
|
if write_to_file >= AUTO:
|
||||||
open(name + ".table", 'w', encoding = "utf-8").write(formatted_table_data+"\n")
|
if file_output_path:
|
||||||
|
open(os.path.join(file_output_path, os.path.basename(name)) \
|
||||||
|
+ ".table", 'w', encoding = "utf-8") \
|
||||||
|
.write(formatted_table_data+"\n")
|
||||||
|
else:
|
||||||
|
open(name + ".table", 'w', encoding = "utf-8").write(formatted_table_data+"\n")
|
||||||
|
|||||||
5
utils/table-generator/list-exceptions.sh
Executable file
5
utils/table-generator/list-exceptions.sh
Executable file
@@ -0,0 +1,5 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
|
||||||
|
grep -E '\|\ [0-9]{3}\.[0-9]{3}' use-cases/*.uc \
|
||||||
|
| cut -d '|' -f 2 \
|
||||||
|
| sort | uniq -c
|
||||||
13
utils/table-generator/update-tables.sh
Executable file
13
utils/table-generator/update-tables.sh
Executable file
@@ -0,0 +1,13 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
|
||||||
|
mkdir -p tables/
|
||||||
|
./convert.py use-cases/* -nv -d tables/
|
||||||
|
|
||||||
|
if [ -f tables.md ]; then
|
||||||
|
rm tables.md
|
||||||
|
fi
|
||||||
|
|
||||||
|
for i in tables/*; do
|
||||||
|
cat $i >> tables.md
|
||||||
|
echo "" >> tables.md
|
||||||
|
done
|
||||||
10
utils/table-generator/use-cases/account.create.uc
Normal file
10
utils/table-generator/use-cases/account.create.uc
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
Назва | Створити обліковий запис
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Відсутні
|
||||||
|
Результат | Обліковий запис користувача
|
||||||
|
Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму
|
||||||
|
| 001.002 Ідентичний псевдонім вже існує
|
||||||
|
Основний сценарій | 1. Користувач вводить бажаний псевдонім у поле вводу псевдоніму
|
||||||
|
| 2. Користувач вводить пароль у поле вводу паролю
|
||||||
|
| 3. Користувач натискає на кнопку створення облікового запису
|
||||||
|
| 4. Система створює обліковий запис користувача (можливі 001.001, 001.002)
|
||||||
9
utils/table-generator/use-cases/account.delete.uc
Normal file
9
utils/table-generator/use-cases/account.delete.uc
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
Назва | Видалити обліковий запис
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі
|
||||||
|
Результат | Відсутність облікового запису користувача
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку видалення облікового запису
|
||||||
|
| 2. Система виводить кнопку-запит на підтвердження видалення облікового запису
|
||||||
|
| 3. Користувач натискає на кнопку підтвердження видалення облікового запису
|
||||||
|
| 4. Система видаляє обліковий запис (можлива 001.005)
|
||||||
10
utils/table-generator/use-cases/account.modify.uc
Normal file
10
utils/table-generator/use-cases/account.modify.uc
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
Назва | Змінити властивості облікового запису
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі
|
||||||
|
Результат | Зміна властивостей облікового запису
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку редагування облікового запису
|
||||||
|
| 2. Система виводить інтерфейс для редагування облікового запису (можлива 001.005)
|
||||||
|
| 3. Користувач вказує бажані зміни властивостей облікового запису
|
||||||
|
| 4. Користувач натискає на кнопку внесення змін до властивостей облікового запису
|
||||||
|
| 5. Система змінює властивості облікового запису
|
||||||
12
utils/table-generator/use-cases/user.create_survey.uc
Normal file
12
utils/table-generator/use-cases/user.create_survey.uc
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
Назва | Створити опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі
|
||||||
|
Результат | Створене опитування
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.007 Користувач ввів неприпустимі символи в назві опитування
|
||||||
|
Основний сценарій | 1. Користувач переходить на сторінку створення опитування (можлива 001.005)
|
||||||
|
| 2. Система виводить інтерфейс створення опитування
|
||||||
|
| 3. Користувач задає інформацію про запитання та тип опитування
|
||||||
|
| 4. Користувач натискає кнопку збереження опитування
|
||||||
|
| 5. Система створює опитування (можлива 001.007)
|
||||||
|
| 6. Система виводить посилання на проходження опитування
|
||||||
11
utils/table-generator/use-cases/user.delete_survey.uc
Normal file
11
utils/table-generator/use-cases/user.delete_survey.uc
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
Назва | Видалити опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
|
||||||
|
Результат | Відсутність опитування
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.006 Запитане опитування не існує
|
||||||
|
| 001.008 Користувач не є власником опитування
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку видалення опитування
|
||||||
|
| 2. Система виводить запит на підтвердження видалення опитування
|
||||||
|
| 3. Користувач натискає на кнопку підтвердження видалення опитування
|
||||||
|
| 4. Система видаляє опитування (можливі 001.005, 001.006, 001.008)
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
Назва | Переглянути відповіді на опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
|
||||||
|
Результат | Інформація про відповіді на опитування
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.006 Запитане опитування не існує
|
||||||
|
| 001.008 Користувач не є власником опитування
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку перегляду відповідей на опитування
|
||||||
|
| 2. Система виводить інформацію про відповіді на опитування (можливі 001.005, 001.006, 001.008)
|
||||||
12
utils/table-generator/use-cases/user.login.uc
Normal file
12
utils/table-generator/use-cases/user.login.uc
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
Назва | Пройти ідентифікацію в системі
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач має обліковий запис
|
||||||
|
Результат | Користувач ідентифікований в системі
|
||||||
|
Виключні ситуації | 001.001 Користувач ввів заборонені символи в поле псевдоніму
|
||||||
|
| 001.003 Користувач ввів псевдонім, якого не існує в системі
|
||||||
|
| 001.004 Користувач ввів неправильний пароль до облікового запису
|
||||||
|
Основний сценарій | 1. Користувач вводить псевдонім у поле вводу псевдоніму
|
||||||
|
| 2. Користувач вводить пароль у поле вводу паролю
|
||||||
|
| 3. Користувач натискає кнопку ідентифікації
|
||||||
|
| 4. Система ідентифікує користувача (можливі 001.001, 001.003, 001.004)
|
||||||
|
|
||||||
7
utils/table-generator/use-cases/user.logout.uc
Normal file
7
utils/table-generator/use-cases/user.logout.uc
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
Назва | Скинути дані про ідентифікацію в системі
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі
|
||||||
|
Результат | Користувач не ідентифікований в системі
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку виходу з облікового запису
|
||||||
|
| 2. Система скидає інформацію про ідентифікацію користувача (можлива 001.005)
|
||||||
12
utils/table-generator/use-cases/user.modify_survey.uc
Normal file
12
utils/table-generator/use-cases/user.modify_survey.uc
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
Назва | Редагувати опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
|
||||||
|
Результат | Змінене опитування
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.006 Запитане опитування не існує
|
||||||
|
| 001.008 Користувач не є власником опитування
|
||||||
|
Основний сценарій | 1. Користувач переходить на сторінку редагування опитування
|
||||||
|
| 2. Система виводить інтерфейс редагування опитування (можливі 001.005, 001.006, 001.008)
|
||||||
|
| 3. Користувач задає інформацію про зміни в опитуванні
|
||||||
|
| 4. Користувач натискає кнопку збереження змін в опитуванні
|
||||||
|
| 5. Система змінює опитування
|
||||||
9
utils/table-generator/use-cases/user.stat_survey.uc
Normal file
9
utils/table-generator/use-cases/user.stat_survey.uc
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
Назва | Переглянути властивості опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі, користувач є власником опитування
|
||||||
|
Результат | Інформація про властивості опитування
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.006 Запитане опитування не існує
|
||||||
|
| 001.008 Користувач не є власником опитування
|
||||||
|
Основний сценарій | 1. Користувач натискає на кнопку перегляду інформації про опитування
|
||||||
|
| 2. Система виводить інформацію про опитування (можливі 001.005, 001.006, 001.008)
|
||||||
11
utils/table-generator/use-cases/user.take_anon_survey.uc
Normal file
11
utils/table-generator/use-cases/user.take_anon_survey.uc
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
Назва | Пройти анонімне опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Відсутні
|
||||||
|
Результат | Запис відповідей на опитування
|
||||||
|
Виключні ситуації | 001.006 Запитане опитування не існує
|
||||||
|
Основний сценарій | 1. Користувач переходить на сторінку проходження опитування
|
||||||
|
| 2. Система виводить перелік запитань опитування (можлива 001.006)
|
||||||
|
| 3. Користувач вводить відповіді на запитання
|
||||||
|
| 4. Користувач натискає кнопку надсилання відповідей
|
||||||
|
| 5. Система записує відповіді на опитування (можлива 001.006)
|
||||||
|
| 6. Система виводить прощальне повідомлення
|
||||||
12
utils/table-generator/use-cases/user.take_named_survey.uc
Normal file
12
utils/table-generator/use-cases/user.take_named_survey.uc
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
Назва | Пройти поіменне опитування
|
||||||
|
Учасники | Користувач, система
|
||||||
|
Передумови | Користувач ідентифікований в системі
|
||||||
|
Результат | Запис відповідей на опитування та відомості про користувача
|
||||||
|
Виключні ситуації | 001.005 Користувач не ідентифікований
|
||||||
|
| 001.006 Запитане опитування не існує
|
||||||
|
Основний сценарій | 1. Користувач переходить на сторінку проходження опитування
|
||||||
|
| 2. Система виводить перелік запитань опитування (можливі 001.005, 001.006)
|
||||||
|
| 3. Користувач вводить відповіді на запитання
|
||||||
|
| 4. Користувач натискає кнопку надсилання відповідей
|
||||||
|
| 5. Система записує відповіді на опитування та відомості про користувача (можлива 001.006)
|
||||||
|
| 6. Система виводить прощальне повідомлення
|
||||||
Reference in New Issue
Block a user