Compare commits
8 Commits
21beb456e0
...
02e4da8050
| Author | SHA1 | Date |
|---|---|---|
 ІО-23 Шмуляр Олег
|
02e4da8050 | |
|
ІО-23 Шмуляр Олег
|
53734e9998 | |
 rhinemann
|
b1b595e61b | |
|
rhinemann
|
fd12ac3cd4 | |
|
ІО-23 Шмуляр Олег
|
6ed051bf95 | |
|
ІО-23 Шмуляр Олег
|
ba7444fc49 | |
|
ІО-23 Шмуляр Олег
|
4607ce75cd | |
|
ІО-23 Шмуляр Олег
|
47f3cbc26c |
|
|
@ -1,221 +1,4 @@
|
|||
# Розроблення вимог до системи
|
||||
# Розроблення загальних вимог до системи
|
||||
|
||||
## Вступ
|
||||
У даному розділі проводиться аналіз предметної області, пов'язаної з системою організації та управління експертними опитуваннями. Представлені такі категорії:
|
||||
|
||||
- [Основні визначення](#основні-визначення), котрі можна зустріти в сфері експертних опитувань
|
||||
- [Підходи та способи вирішення завдання](#підходи-та-способи-вирішення-завдання) опитування експертів
|
||||
- [Порівняльна характеристика наявних засобів вирішення завдання](#порівняльна-характеристика-існуючих-засобів-вирішення-завдання) опитування експертів
|
||||
- [Висновки](#висновки) щодо доцільності розробки нової системи
|
||||
- [Література](#література), де наведені посилання на джерела інформації
|
||||
|
||||
## Основні визначення
|
||||
### Технічні визначення
|
||||
**База даних** [](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/)
|
||||
- [Аналіз предметної області](state-of-the-art.md)
|
||||
- [Запити зацікавлених осіб](stakeholders-needs.md)
|
||||
|
|
|
|||
|
|
@ -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/)
|
||||
|
|
@ -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>
|
||||
|
|
@ -34,6 +34,27 @@ def convert_usecase_v1(filename, data):
|
|||
|
||||
return generate_table(merged_lines)
|
||||
|
||||
def convert_activity_v1(filename, data):
|
||||
split_raw_lines_from_file = [i.split(" | ") for i in data.split("\n") if i]
|
||||
|
||||
if '/' in filename:
|
||||
use_case_name = filename.rsplit("/", 1)[1].upper()
|
||||
elif '\\' in filename:
|
||||
use_case_name = filename.rsplit("\\", 1)[1].upper()
|
||||
else:
|
||||
use_case_name = filename.upper()
|
||||
|
||||
split_raw_lines = [["ID", use_case_name]] + split_raw_lines_from_file
|
||||
|
||||
merged_lines = []
|
||||
for i in split_raw_lines:
|
||||
if i[0].replace(" ", "") == "":
|
||||
merged_lines[-1][1] += "<br>" + i[1]
|
||||
else:
|
||||
merged_lines.append(i)
|
||||
|
||||
return generate_table_with_activity_diagram(merged_lines)
|
||||
|
||||
def generate_table(raw_table_data):
|
||||
table_lines = raw_table_data
|
||||
transposed_table = list(zip(*table_lines))
|
||||
|
|
@ -60,15 +81,101 @@ def generate_table(raw_table_data):
|
|||
|
||||
return "\n".join(formatted_table_lines)
|
||||
|
||||
def convert_line_to_activity_diagram(line):
|
||||
split_line = line[1].split("<br>")
|
||||
|
||||
result = "@startuml\n %PLACEHOLDER%\nstop\n@enduml"
|
||||
|
||||
last_swimline_name = ""
|
||||
initiator_name = ""
|
||||
|
||||
for i in split_line:
|
||||
clear_line = i.lstrip("1234567890. ")
|
||||
swimline_label, combined_action = clear_line.split(" ", 1)
|
||||
|
||||
action_and_exceptions = combined_action.split(" (")
|
||||
|
||||
if len(action_and_exceptions) > 1:
|
||||
action = action_and_exceptions[0].strip().capitalize()
|
||||
exceptions = action_and_exceptions[1].strip(") ").capitalize()
|
||||
else:
|
||||
action = action_and_exceptions[0].strip().capitalize()
|
||||
exceptions = ""
|
||||
|
||||
# запам'ятовуємо назву користувача системи
|
||||
# (він завжди починає взаємодію, а, отже,
|
||||
# перша дія завжди належить йому)
|
||||
if not initiator_name:
|
||||
initiator_name = swimline_label
|
||||
|
||||
# змінюємо swinline, якщо керування перейшло до іншого актора
|
||||
if last_swimline_name != swimline_label:
|
||||
result = result.replace("%PLACEHOLDER%", f"|{swimline_label}|\n %PLACEHOLDER%")
|
||||
|
||||
# якщо це перша дія, то вказуємо start
|
||||
if not last_swimline_name:
|
||||
result = result.replace("%PLACEHOLDER%", f"start\n %PLACEHOLDER%")
|
||||
|
||||
# зберігаємо нове ім'я актора
|
||||
last_swimline_name = swimline_label
|
||||
|
||||
# прописуємо поточну дію актора
|
||||
result = result.replace("%PLACEHOLDER%", f": {action};\n %PLACEHOLDER%")
|
||||
|
||||
# якщо є виключні ситуації, додаємо інформацію про них
|
||||
if exceptions:
|
||||
result = result.replace("%PLACEHOLDER%", f"note right #lightpink\n <b>{exceptions}</b>\n end note\n %PLACEHOLDER%")
|
||||
|
||||
# впенюємося, що взаємодія закінчується на swinline користувача
|
||||
if last_swimline_name != initiator_name:
|
||||
result = result.replace("%PLACEHOLDER%", f"|{initiator_name}|\n %PLACEHOLDER%")
|
||||
|
||||
# видаляємо мітку %PLACEHOLDER%
|
||||
result = result.replace("%PLACEHOLDER%\n", "")
|
||||
return result
|
||||
|
||||
|
||||
def generate_table_with_activity_diagram(raw_table_data):
|
||||
table_lines = raw_table_data[:-1]
|
||||
activity_line = raw_table_data[-1]
|
||||
|
||||
transposed_table = list(zip(*table_lines))
|
||||
|
||||
field_sizes = [max([max([len(k)+2 for k in j.split("\n")]) for j in i]) for i in transposed_table]
|
||||
|
||||
formatted_table_lines = []
|
||||
|
||||
l = "|"
|
||||
for i, field in enumerate(table_lines[0]):
|
||||
l += field.center(field_sizes[i])
|
||||
l += "|"
|
||||
|
||||
formatted_table_lines.append(l)
|
||||
formatted_table_lines.append(f"|{'|'.join([':'+'-'*(i-2)+':' for i in field_sizes])}|")
|
||||
|
||||
for line in table_lines[1:]:
|
||||
l = "|"
|
||||
for i, field in enumerate(line):
|
||||
l += field.center(field_sizes[i])
|
||||
l += "|"
|
||||
|
||||
formatted_table_lines.append(l)
|
||||
|
||||
activity_diagram = convert_line_to_activity_diagram(activity_line)
|
||||
|
||||
return "\n".join(formatted_table_lines) + "\n" + activity_diagram
|
||||
|
||||
|
||||
if __name__=="__main__":
|
||||
# parse args
|
||||
files = []
|
||||
|
||||
write_to_file = AUTO
|
||||
write_to_stdout = AUTO
|
||||
usecase_formatting = AUTO
|
||||
verbose = AUTO
|
||||
process_table_files = AUTO
|
||||
convert_to_activity_diagram = AUTO
|
||||
file_output_path = None
|
||||
|
||||
# 1 pass (argument harvest)
|
||||
|
|
@ -104,6 +211,12 @@ if __name__=="__main__":
|
|||
elif i in ["-nt", "--no-process-table"]:
|
||||
process_table_files = NO
|
||||
|
||||
# перетворює останню клітинку таблиці в діаграму активностей
|
||||
if i in ["-a", "--convert-to-activity-diagram"]:
|
||||
convert_to_activity_diagram = YES
|
||||
elif i in ["-na", "--no-convert-to-activity-diagram"]:
|
||||
convert_to_activity_diagram = NO
|
||||
|
||||
# задає папку, в яку необхідно зберігати конвертовані таблиці
|
||||
elif i in ["-d", "--destination"]:
|
||||
file_output_path = sys.argv[n+2]
|
||||
|
|
@ -133,7 +246,14 @@ if __name__=="__main__":
|
|||
elif (name.endswith(".usecase") or name.endswith(".uc")) and usecase_formatting >= AUTO:
|
||||
if verbose == YES:
|
||||
print(f"Auto-detected use-case in file {name}\n")
|
||||
formatted_table_data = convert_usecase_v1(name.rsplit(".", 1)[0], data)
|
||||
|
||||
if convert_to_activity_diagram == YES:
|
||||
if verbose == YES:
|
||||
print(f"Converting file {name} to activity diagram\n")
|
||||
|
||||
formatted_table_data = convert_activity_v1(name.rsplit(".", 1)[0], data)
|
||||
else:
|
||||
formatted_table_data = convert_usecase_v1(name.rsplit(".", 1)[0], data)
|
||||
else:
|
||||
formatted_table_data = convert_generic_v1(data)
|
||||
|
||||
|
|
@ -162,7 +282,14 @@ if __name__=="__main__":
|
|||
elif (name.endswith(".usecase") or name.endswith(".uc")) and usecase_formatting >= AUTO:
|
||||
if verbose >= AUTO:
|
||||
print(f"Auto-detected use-case in file {name}")
|
||||
formatted_table_data = convert_usecase_v1(name.rsplit(".", 1)[0], data)
|
||||
|
||||
if convert_to_activity_diagram == YES:
|
||||
if verbose == YES:
|
||||
print(f"Converting file {name} to activity diagram\n")
|
||||
|
||||
formatted_table_data = convert_activity_v1(name.rsplit(".", 1)[0], data)
|
||||
else:
|
||||
formatted_table_data = convert_usecase_v1(name.rsplit(".", 1)[0], data)
|
||||
else:
|
||||
formatted_table_data = convert_generic_v1(data)
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,13 @@
|
|||
#!/bin/sh
|
||||
|
||||
mkdir -p activities/
|
||||
./convert.py use-cases/* -a -nv -d activities/
|
||||
|
||||
if [ -f activities.md ]; then
|
||||
rm activities.md
|
||||
fi
|
||||
|
||||
for i in activities/*; do
|
||||
cat $i >> activities.md
|
||||
echo "" >> activities.md
|
||||
done
|
||||
Reference in New Issue