
Документ із вимогами до застосунку, або специфікація застосунку, — це короткий письмовий план, складений до початку розробки: хто користуватиметься застосунком, які екрани бачитиме кожен користувач, яку інформацію він зберігатиме, з якими сервісами буде пов’язаний, що поки не входить до роботи та скільки щонайбільше може коштувати створення. Ви читаєте його, ставите запитання та вносите зміни й затверджуєте лише тоді, коли він описує саме той застосунок, який вам потрібен.
Спочатку ви затверджуєте специфікацію, бо саме на цьому етапі найдешевше знайти помилку. Перемістити рядок на сторінці нічого не коштує. Якщо вже після створення з’ясується, що репетитори бачать номери телефонів усіх батьків або що оплату не можна вносити частинами, застосунок доведеться переробляти.
Що таке специфікація програмного забезпечення простими словами?
У розробці програмного забезпечення специфікація (у великих проєктах її часто називають документом із вимогами, або SRS — специфікацією вимог до програмного забезпечення) — це домовленість між людиною, якій потрібен застосунок, і тим, хто його створює. У ній зазначено, що має робити застосунок, а не як це реалізовано в коді. Для магазину, клубу чи школи зазвичай достатньо однієї сторінки, якщо все викладено конкретно й простими словами.
Перевірити специфікацію просто: чи зможуть два різні розробники прочитати її та створити приблизно однаковий застосунок? Якщо на сторінці написано учні можуть бачити свої результати, це лише побажання. А якщо написано учень входить за номером телефону й бачить оцінки за власні тести, згруповані за предметами, поруч із середнім балом групи, це вже вимога, яку можна реалізувати й перевірити.
Що має бути в односторінковому документі з вимогами до застосунку?
Візьмімо навчальний центр, якому потрібен застосунок для занять, обліку відвідуваності та оплат. Корисна односторінкова специфікація для нього містить такі частини:
| Частина специфікації | Що в ній зазначено | Приклад для навчального центру |
|---|---|---|
| Хто ним користується | Кожен тип користувачів, які входять у застосунок, і що їм дозволено робити | Власник, викладачі, учні та батьки; лише власник бачить загальні суми оплат |
| Екрани за ролями | Сторінки, які бачить кожна роль, і дії, які на них виконує | Викладач: сьогоднішні заняття, відмітити відвідуваність, внести оцінки за тести. Батьки: відвідуваність, оцінки, сума до сплати |
| Збережені дані | Записи, які зберігає застосунок, і дані в кожному з них | Учні, заняття, відвідуваність кожного заняття, тести й оцінки, внески за навчання та квитанції |
| Інтеграції | Зовнішні сервіси, до яких він підключається, і спосіб підключення | Онлайн-оплата навчання через платіжний шлюз із квитанцією за кожен внесок |
| Відкладено на потім | Чого не буде в цій версії | Без перевірки накладок у розкладі; без імпорту записів за минулий рік |
| Гранична вартість | Найбільша можлива вартість створення | Максимальна сума, показана до затвердження, а не оцінка після виконання роботи |
Розділ з екранами за ролями зазвичай лише швидко переглядають, хоча він найважливіший. Насправді один застосунок — це кілька застосунків зі спільним набором даних: окремі подання для власника, викладача й батьків. Читаючи опис екранів для кожної ролі, можна помітити, наприклад, що викладач може відмітити відвідуваність, але виправити помилку не може ніхто.
Рядок не входить у поточну версію не менш важливий. Він пояснює, чого ви не отримаєте, адже саме через це найчастіше виникає розчарування після створення застосунку. Короткий і чесний список винятків — ознака хорошої, а не слабкої специфікації.
Коли ви описуєте потрібний застосунок у Deployflix, створена специфікація має таку структуру: хто користується застосунком, які в ньому є екрани, які дані він зберігає, що поки не входить до версії та скільки щонайбільше може коштувати створення. Усе це — мовою вашого опису. Якщо щось незрозуміло, Deployflix спочатку ставить запитання й лише потім складає план. На сторінці Як це працює показано місце специфікації серед усіх етапів.
Як читати специфікацію застосунку та що в ній перевіряти?
Не читайте специфікацію як договір — від початку до кінця. Читайте її як опис звичайного дня у вашому бізнесі.
- Пройдіть типовий день у ролі кожного користувача. На що він натискає, що бачить і що вводить? Потім зробіть те саме для всіх інших ролей.
- Простежте шлях одного запису від початку до кінця. Виберіть одного учня, замовлення або бронювання. Хто створює цей запис, хто змінює, хто може видалити та куди він зрештою потрапляє?
- Перевірте проблемні сценарії. Скасоване бронювання, повернення коштів, помилковий запис, невдалий платіж, вихід учасника. Якщо специфікація описує лише успішні сценарії, запитайте, що станеться, коли щось піде не так.
- Перевірте кожне число й слово, яке плануєте друкувати. Формат рахунків, внески, рядки з податками й номери квитанцій мають відповідати вашим поточним процесам. Якщо в рахунках потрібно вказувати податок, як-от GST, VAT або податок із продажу, уточніть деталі у свого бухгалтера.
- Запитуйте про все нечітке. За словами на кшталт керувати, відстежувати, просто і звіти приховуються невирішені питання. Запитайте: який саме звіт, що в ньому показано й для кого він призначений?
Які прогалини слід знайти до затвердження?
Більшість проблемних специфікацій не помилкові, а неповні. Ось прогалини, які трапляються найчастіше.
Хто що може бачити
Ролі легко назвати, але так само легко описати нечітко. Перевірте не лише те, що може робити кожна роль, а й те, що вона може бачити. Чи бачить викладач оплати? Чи можуть одні батьки бачити оцінки чужої дитини? Чи може працівник завантажити список клієнтів? Якщо застосунок зберігає персональні дані, відразу визначте, хто матиме до них доступ.
Редагування, скасування та повернення змін
Рано чи пізно кожен запис доведеться виправити. Переконайтеся, що в специфікації зазначено, хто може редагувати або скасовувати запис і чи зберігається його попереднє значення.
Гроші
Якщо застосунок приймає платежі, специфікація має показувати кроки оплати: як клієнти можуть платити (картками та місцевими способами оплати), за що саме, чи дозволена часткова оплата, що клієнт отримує після неї та що відбувається, якщо оплату не здійснено або платіж не пройшов. Правила повернення коштів визначає бізнес, тож запишіть свої. Шлюзи зазвичай стягують відсоток від транзакції, а в багатьох країнах ще й фіксовану комісію, тому перевірте сторінку тарифів вашого шлюзу. Застосунки Deployflix приймають платежі через платіжний шлюз, як-от Razorpay чи Cashfree; міжнародні шлюзи з’являться незабаром. Наша сторінка інтеграцій показує, що можна підключити вже зараз.
Повідомлення й нагадування
Якщо вам потрібні нагадування, зазначте, як вони мають надходити людям: електронною поштою, у застосунку чи іншим способом. Якщо в специфікації канал не вказано, вважайте, що його немає.
Ваші наявні дані
Дані з електронних таблиць і старих журналів часто потрібно перенести до нового застосунку. Запитайте, чи входить їх перенесення до специфікації, чи зазначене у списку не входить у поточну версію.
Пристрої та мови
Люди користуватимуться застосунком на телефоні, комп’ютері біля прилавка чи на обох пристроях? Чи має він бути доступний іспанською, арабською, французькою або іншою мовою, крім англійської? Від цього залежить вигляд екранів, тому визначтеся до початку створення. Deployflix пише тексти вашого застосунку потрібною вам мовою, а його власний інтерфейс доступний 41 мовою.
Навіщо затверджувати специфікацію до початку створення?
Тому що змінити речення дешевше, ніж застосунок. До початку створення додати роль батьків або внесок за навчання означає лише відредагувати сторінку. Після завершення тієї самої зміни можуть потребувати вже готові екрани, дані та дозволи.
Затверджена специфікація також дає змогу перевірити готовий застосунок. Після завершення створення відкрийте її та послідовно перевірте кожну роль, кожен екран і кожен тип даних. Якщо чогось бракує, ви цілком слушно можете на це вказати.
Специфікація також визначає вартість ще до того, як ви дасте згоду. Коли в ній зазначено максимальну вартість створення, ви ухвалюєте рішення, знаючи конкретну суму. У Deployflix цю межу показують до вашого затвердження, а ви платите лише за фактично використані під час створення ресурси, як пояснено на сторінці цін.
Як планувати зміни після створення застосунку?
Роботу над застосунком рідко можна вважати остаточно завершеною. Новий курс, друга філія, новий спосіб приймання оплат — кожна така зміна потребує тієї самої уваги, що й початкове створення.
Плануйте кожну зміну як окрему невелику специфікацію: що змінюється, яких ролей та екранів це стосується, які дані додаються або змінюються, що залишається без змін і скільки це може коштувати. Перевірте її за тими самими питаннями й затвердьте до початку роботи. Збережіть попередню версію, щоб у разі невдалої зміни повернутися до робочого варіанта.
Ось як Deployflix вносить зміни: ви пояснюєте, що потрібно змінити, сервіс планує це як наступну версію, і до її затвердження нічого не створюється. Усі попередні версії зберігаються. В організації затверджувати їх можуть лише люди, чиї ролі це дозволяють, як описано на сторінці про безпеку.
Шаблон специфікації застосунку
Якщо ви самі пишете специфікацію, скопіюйте ці заголовки й заповніть кожен простими реченнями:
- Застосунок одним реченням: для кого він призначений і яке завдання виконує.
- Ролі: кожен тип користувачів і що вони можуть бачити та робити.
- Екрани за ролями: екрани для кожної ролі й дії, що виконуються на кожному з них.
- Збережені дані: кожен тип запису та відомості, які він містить.
- Інтеграції: платежі, ваш домен, магазини застосунків, місце зберігання коду й усі інші підключення.
- Правила: оплати, обмеження, строки, скасування та повернення коштів.
- Не входить у поточну версію: чого ця версія не робитиме.
- Гранична вартість і затвердження: максимальна вартість і особа, яка дає остаточну згоду.
Щоб побачити докладні приклади ролей, екранів і даних, перегляньте систему керування навчальними групамиEN або застосунок для запису на прийом до клінікиEN. Засновник, який перевіряє ідею, може зробити специфікацію ще коротшою: одна роль, кілька екранів і чіткий список того, що не входить до версії, як у випадку з MVP-вебзастосунком для стартапуEN.
Запитання
Чим специфікація застосунку відрізняється від документа з вимогами?
Переважно обсягом і рівнем формальності. Документ із вимогами до великого проєкту може містити багато сторінок пронумерованих вимог. Специфікація застосунку для малого бізнесу охоплює ті самі питання — хто ним користується, що він робить і які дані зберігає — на одній сторінці простими словами.
Хто має писати специфікацію застосунку?
Людина, яка знає бізнес, надає зміст: ролі, щоденні процеси й правила. Розробник може перетворити це на структуровану специфікацію, але лише ви можете визначити, чи все в ній правильно.
Чи можна змінити специфікацію після затвердження?
Так. Оформіть це як зміну: опишіть, що має відрізнятися, прочитайте оновлений план і знову його затвердьте. Збережіть попередню версію, щоб мати змогу порівняти їх або повернутися до неї.
Якого обсягу має бути специфікація застосунку?
Достатньо докладною, щоб важливі речі не доводилося вгадувати, і достатньо короткою, щоб ви прочитали її повністю. Для більшості застосунків малого бізнесу достатньо однієї сторінки. Якщо текст значно довший, варто розділити створення на етапи.
Опишіть свій застосунок
Опишіть своїми словами, що вам потрібно. Deployflix підготує односторінковий план із вартістю та почне створення лише після вашого затвердження.
Скопійовано. Після входу вставте це в Deployflix.