Технічне завдання на мобільний застосунок рідко «погане» цілком. Зазвичай воно добре описує те, що замовник бачить щодня: екрани, кнопки, кольори. І майже мовчить про те, що з'їдає бюджет: стани помилок, ролі й права, офлайн, адмінку, міграції даних, вимоги App Store і Google Play. Через це дві студії називають за тим самим документом оцінки, що різняться втричі, і обидві формально мають рацію.

У цій статті ми розбираємо структуру ТЗ, з якою команда може оцінити проєкт із похибкою ±20–30%, а не «від трьох до дев'яти місяців». Тут є шаблон розділів, приклади формулювань, таблиця типових прогалин і чекліст перед тим, як надсилати документ підрядникам.

Поширене заперечення: «У нас Scrum, вимоги все одно зміняться». Зміняться, але ТЗ не є контрактом на кожну кнопку. Це спільна модель продукту, яка відповідає на три запитання: що ми будуємо, для кого і як зрозуміємо, що функцію зроблено. Agile скасовує спробу передбачити все наперед, а не потребу домовитися про межі.

У наших проєктах ми бачимо просту закономірність: що менше визначено на старті, то ширший діапазон оцінки і то більше часу йде на уточнення вже під час розробки, коли кожне питання блокує дизайнера, бекенд і мобільних розробників одночасно.

Міжнародний стандарт ISO/IEC/IEEE 29148 описує вимоги до якісних вимог: кожна має бути однозначною, перевірною, здійсненною і простежуваною. Для мобільного стартапу не потрібен документ на 200 сторінок за стандартом, але ці чотири властивості варто перевіряти в кожному пункті.

Структура ТЗ: дев'ять розділів, які реально потрібні

Нижче структура, яку ми рекомендуємо для MVP і застосунків середньої складності. Обсяг такого документа зазвичай 15–40 сторінок разом із user flow, без урахування макетів.

  1. Контекст і цілі. Яку проблему вирішує застосунок, для кого, яка бізнес-модель, які 2–3 метрики успіху (наприклад, частка користувачів, що завершили першу покупку). Окремо: що свідомо не входить у першу версію.
  2. Ролі користувачів і права. Гість, зареєстрований користувач, преміум, модератор, адміністратор. Матриця «роль × дія» знімає половину питань до бекенду.
  3. Функціональні вимоги. Користувацькі історії з критеріями приймання, згруповані за модулями (реєстрація, каталог, кошик, профіль).
  4. User flow і карта екранів. Схема переходів, включно з тим, що відбувається після push-сповіщення, deep link чи повторного входу.
  5. Стани і крайові випадки. Порожні списки, помилки мережі, відсутній доступ до камери, протермінована сесія.
  6. Нефункціональні вимоги. Платформи й мінімальні версії ОС, швидкодія, офлайн, локалізація, доступність, безпека.
  7. Інтеграції. Платежі, карти, аналітика, CRM, push-провайдер, зовнішні API: хто надає доступи, чи є sandbox, ліміти запитів.
  8. Адмінпанель і контент. Хто й як керує даними, модерує, відповідає користувачам.
  9. Вимоги магазинів і юридичні умови. Політика приватності, видалення акаунта, вікові обмеження, підписки.

Як писати функціональні вимоги, щоб їх можна було оцінити

Користувацька історія + критерії приймання

Формат «Як [роль], я хочу [дія], щоб [цінність]» корисний не сам по собі, а тому що змушує назвати роль і мету. Гарна історія відповідає критеріям INVEST: незалежна, обговорювана, цінна, оцінювана, мала і тестована. Якщо історію неможливо оцінити, вона або завелика, або неясна.

До кожної історії додавайте критерії приймання у форматі Given / When / Then. Порівняйте:

Погано: «Користувач може відновити пароль».

Добре: «Дано: користувач на екрані входу ввів e-mail, що існує в системі. Коли він натискає „Забули пароль?“, тоді на e-mail протягом 1 хвилини надходить лист із посиланням, дійсним 30 хвилин; посилання відкриває застосунок (якщо встановлено) або вебсторінку; після зміни пароля всі інші сесії завершуються».

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

Пріоритизація за MoSCoW

Позначайте кожну вимогу як Must, Should, Could або Won't (цього разу). Корисне правило з практики: якщо Must займає понад 60% обсягу, пріоритизації фактично немає. Won't-список так само важливий: він фіксує, від чого ви свідомо відмовилися, і захищає від повернення до цих тем у кожному спринті.

Нефункціональні вимоги: де ховається половина бюджету

Фраза «застосунок має працювати швидко і стабільно» не є вимогою, бо її неможливо перевірити. Нефункціональну вимогу формулюйте з числом і способом вимірювання.

КатегоріяРозмите формулюванняПеревірне формулювання
ПлатформиiOS і AndroidiOS 17+ та Android 9+ (API 28); телефони, планшети без окремої верстки
ШвидкодіяШвидкий запускХолодний старт до головного екрана ≤ 2 с на референсному пристрої середнього класу
СтабільністьБез падіньCrash-free users ≥ 99,5%; частка збоїв у межах порогів Android vitals (1,09% user-perceived crash rate, 0,47% ANR)
ОфлайнПрацює без інтернетуПерегляд останніх 50 замовлень і чернетки форм офлайн; синхронізація після відновлення мережі
ЛокалізаціяКілька мовUK та EN на старті; тексти винесені в ресурси; формати дат і валют за локаллю
ДоступністьЗручно для всіхПідтримка динамічного шрифту, VoiceOver/TalkBack, контраст тексту за WCAG 2.2 AA (4,5:1)
БезпекаДані захищеніТокени в Keychain / Android Keystore, TLS 1.2+, вимоги рівня MASVS-L1

Пороги Android vitals Google використовує для видимості застосунку в Google Play, тож це не «бажання», а продуктовий ризик. Контраст 4,5:1 для звичайного тексту визначено у WCAG 2.2, а базовий набір вимог безпеки зручно брати з OWASP MASVS.

Вимоги магазинів, які варто вписати одразу

Частина вимог не залежить від ваших бажань, але змінює обсяг робіт. Якщо їх немає в ТЗ, вони з'являться перед першим релізом.

  • Видалення акаунта. Якщо застосунок дозволяє створити акаунт, Apple вимагає можливість ініціювати його видалення в самому застосунку (App Review Guidelines, 5.1.1(v)), а Google Play — у застосунку і через вебпосилання (політика Google Play). Це окремий потік, екран і логіка на бекенді.
  • Сторонній вхід. Якщо є вхід через Google чи Facebook, перевірте вимоги пункту 4.8 Guidelines щодо альтернативного способу входу з захистом приватності.
  • Target API. З 31 серпня 2026 року нові застосунки й оновлення в Google Play мають націлюватися на Android 16 (API 36) (Android Developers). Це стосується і всіх сторонніх SDK.
  • Privacy manifest. Apple вимагає privacy manifest для застосунку та поширених сторонніх SDK, а в App Store Connect потрібно заповнити «етикетку приватності»; у Google Play — розділ Data safety.
  • Закрите тестування. Нові особисті акаунти розробника Google Play мають провести закрите тестування з щонайменше 12 тестувальниками протягом 14 днів поспіль, перш ніж відкрити продакшн-доступ (довідка Play Console). Закладайте ці два тижні в план.
  • Цифрові товари. Підписки й розблокування функцій зазвичай мають продаватися через In-App Purchase / Google Play Billing; це впливає на економіку і на бекенд.

Типові прогалини в ТЗ і скільки вони коштують

Ось перелік того, що ми найчастіше дописуємо разом із замовником на етапі discovery. Оцінки трудомісткості — досвід нашої студії для застосунку середньої складності на дві платформи; ваші цифри можуть відрізнятися.

ПрогалинаЩо забувають описатиТиповий додатковий обсяг
Стани екранівLoading, порожній стан, помилка, частково завантажені дані+10–20% до дизайну та верстки
АдмінпанельХто редагує контент, модерує, бачить замовленняВід 80 до 300+ годин окремо
Ролі та праваЩо бачить гість, чи можна змінити роль, мультиакаунт+5–15% бекенду
Push і deep linksЯкі події, куди веде тап, що коли користувач не авторизований40–120 годин
Офлайн і синхронізаціяКонфлікти даних, черга дій, повториМоже подвоїти обсяг модуля
Міграція данихПеренесення користувачів зі старої системи чи сайтуВід 24 годин до тижнів
АналітикаПлан подій, воронки, хто має доступ16–60 годин + дисципліна в кожній задачі
ЮридичнеЗгоди, видалення акаунта, вікові обмеження20–60 годин

Покроковий процес: від ідеї до ТЗ за 2–4 тижні

  1. Тиждень 1: цілі й межі. Сформулюйте проблему, сегмент, бізнес-модель і метрики успіху. Складіть Won't-список. Якщо ідея ще не перевірена, спершу пройдіть перевірку ідеї.
  2. Тиждень 1–2: ролі та сценарії. Опишіть 3–7 ключових сценаріїв від першого запуску до цільової дії. Для кожного намалюйте user flow, хоча б на папері.
  3. Тиждень 2: історії й критерії. Розбийте сценарії на історії, додайте критерії приймання, пріоритети MoSCoW.
  4. Тиждень 2–3: нефункціональні вимоги та інтеграції. Заповніть таблицю з числами, складіть список зовнішніх сервісів і власників доступів.
  5. Тиждень 3: прототип. Клікабельний wireframe у Figma на ключові сценарії. Покажіть його 5 користувачам: за даними Nielsen Norman Group, п'ять сесій виявляють більшість проблем юзабіліті.
  6. Тиждень 3–4: рев'ю з технічною командою. Розробник і QA проходять документ і ставлять питання. Кожне питання — це або уточнення в ТЗ, або явне припущення в оцінці.

Типові помилки в роботі з ТЗ

  • Дизайн замість вимог. Красиві макети без опису логіки: що відбувається при помилці оплати, скільки разів можна повторити код із SMS.
  • Відсутність власника документа. Коли ТЗ правлять п'ятеро людей без історії змін, ніхто не знає, яка версія актуальна. Ведіть changelog і версіонуйте документ.
  • Технічні рішення від нетехнічних авторів. «Використати MongoDB і мікросервіси» в ТЗ для MVP часто лише обмежує команду. Описуйте вимоги, а рішення залиште архітектору, якщо немає вагомої причини.
  • «Тощо» і «і т. д.». Кожне таке слово — неоцінювана частина обсягу. Замініть його на закритий перелік.
  • Нуль слів про післярелізний період. Хто відповідає за підтримку, оновлення під нові версії ОС, моніторинг збоїв.

Чекліст перед відправкою ТЗ підрядникам

ПеревіркаКритерій готовності
ЦіліНазвано проблему, аудиторію і 2–3 вимірювані метрики успіху
МежіЄ список Won't для першої версії
РоліМатриця «роль × дія» для всіх типів користувачів, включно з адміном
ІсторіїКожна має критерії приймання і пріоритет MoSCoW
СтаниДля ключових екранів описано loading, empty, error
НефункціональніКожна вимога має число і спосіб перевірки
ІнтеграціїСписок сервісів, власник доступу, наявність sandbox
МагазиниВидалення акаунта, приватність, IAP, target API, закрите тестування
ГлосарійКлючові терміни визначені й використовуються однаково
ВерсіяНомер версії, дата, автор, changelog

Якщо 8 із 10 пунктів закрито, ви отримаєте порівнянні оцінки від різних команд і зможете обговорювати підхід, а не вгадувати, хто що мав на увазі. Якщо закрито менше половини, чесніше замовити платний discovery-етап: це 2–4 тижні роботи аналітика, дизайнера й техліда, після яких ТЗ і оцінка з'являються як результат.

Джерела: ISO/IEC/IEEE 29148:2018; Apple App Review Guidelines; Google Play: вимоги до видалення акаунта; Android Developers: target API level; Play Console: вимоги до тестування для нових акаунтів; Android vitals; Apple: privacy manifest files; W3C WCAG 2.2; OWASP MASVS; Bill Wake: INVEST; Cucumber: Gherkin reference; NN/g: Why You Only Need to Test with 5 Users.