Що має містити технічне завдання на розробку програмного забезпечення?

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

Завантажити: шаблон технічного завдання (Word, .docx). У ньому всі дванадцять розділів із підказками й прикладом, готових до заповнення. Файл англійською, розділи ті самі, що описані нижче, тож заповнювати його можна українською.

З 2019 року ми оцінюємо й виконуємо проєкти з фіксованою ціною для компаній у США, Великій Британії та ЄС. Найкращий провісник гладкого проєкту в наших записах: чітко записаний обсяг до договору, бо нечіткий обсяг спричинив майже всі суперечки про бюджет. Цей шаблон: структура, яку ми хотіли б бачити в кожного замовника на першій розмові.

Навіщо проєкту з фіксованою ціною технічне завдання?

Фіксована ціна: це обіцянка здати визначений обсяг за визначену суму. Якщо обсяг розмитий, трапляється одне з трьох: виконавець закладає в ціну великий запас ризику, виконавець називає низьку ціну й надолужує різницю через запити на зміни, або обидві сторони сперечаються на прийманні про те, що малося на увазі. Добре технічне завдання прибирає більшість цієї невизначеності, тож пропозиції різних виконавців стають порівнянними, а ціна, яку ви підписуєте, і є ціною, яку ви платите. Про те, коли фіксована ціна взагалі правильна модель, читайте в нашому матеріалі про MVP за фіксованою ціною.

Дванадцять розділів і що писати в кожному

# Розділ Що писати Типовий обсяг
1 Мета й метрики успіху Навіщо проєкт і числа, які покажуть, що він спрацював Пів сторінки
2 Користувачі та ролі Кожен тип користувача, що йому можна бачити й робити Пів сторінки
3 Обсяг і що поза обсягом Які функції входять і прямо що не входить Одна сторінка
4 Користувацькі сценарії Основні шляхи крок за кроком, від тригера до результату 1-3 сторінки
5 Функціональні вимоги По кожній функції: що може користувач і що робить система 2-8 сторінок
6 Бізнес-правила Розрахунки, статуси, погодження, ліміти, винятки 1-3 сторінки
7 Дані й міграція Основні сутності, дані, що є сьогодні, що треба перенести 1 сторінка
8 Інтеграції Кожна зовнішня система, напрям даних, хто надає доступ 1 сторінка
9 Нефункціональні вимоги Користувачі й обсяги, швидкість, доступність, безпека, мови, пристрої Пів сторінки
10 Критерії приймання Як перевірятиметься кожна функція перед прийняттям 1-2 сторінки
11 Припущення й відкриті питання Що ви припускаєте, що ще не вирішено і хто вирішує Пів сторінки
12 Етапи й передача Етапи, що здається на кожному і як слідує оплата Пів сторінки

1. Мета й метрики успіху

Два-три речення про бізнес-проблему, потім числа. "Введення замовлення займає 12 хвилин на замовлення й дає 4 відсотки помилок, після запуску має займати менше 3 хвилин із менш ніж 1 відсотком помилок." Виконавець, який знає мету, може запропонувати дешевший шлях до неї.

2. Користувачі та ролі

Перелічіть кожну роль із кількістю людей і правами: "Диспетчер (6 осіб): бачить усі замовлення, призначає кур'єрів, не може змінювати ціни." Ролі формують дивовижно велику частку вартості, бо кожне правило доступу це код і тест.

3. Обсяг і що поза обсягом

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

4. Користувацькі сценарії

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

5. Функціональні вимоги

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

6. Бізнес-правила

Розрахунки, зміни статусів, ланцюжки погодження, знижки, округлення, часові пояси, терміни. До кожного правила дайте приклад із реальними числами: приклади ловлять непорозуміння, які ховають визначення.

7. Дані й міграція

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

8. Інтеграції

Для кожної зовнішньої системи: назва, які дані в якому напрямку, як часто, чи є API і хто надає облікові дані та тестовий акаунт. Інтеграція без тестового акаунта: найчастіша причина затримок у наших проєктах. Для українського продукту це типово Нова пошта, платіжний сервіс на кшталт LiqPay чи monobank, облікова система на кшталт 1С: запишіть для кожної, хто саме надасть доступ і коли.

9. Нефункціональні вимоги

Кількість користувачів і записів, очікуване пікове навантаження, потрібний час відповіді ключових екранів, очікування щодо доступності, резервні копії й зберігання даних, регіон хостингу, вимоги до безпеки чи відповідності, підтримувані браузери й пристрої, мови.

10. Критерії приймання

Для кожної функції: перевірки, які ви проведете перед прийняттям, записані як "дано, коли, тоді". Дивіться приклад нижче.

11. Припущення й відкриті питання

Кожне припущення, яке ви робите, і кожне питання, на яке ще немає відповіді, з іменем людини, що відповість, і датою. Відкриті питання нормальні, а приховані ламають фіксовану ціну.

12. Етапи й передача

Етапи з результатами, вікно приймання на кожен і те, як оплата йде за прийнятими етапами. Додайте коротке правило контролю змін: зміни описують письмово, оцінюють і затверджують до того, як їх планують.

Заповнений приклад: одна функція

Ось як виглядають розділи 5, 6 і 10 для однієї функції системи керування замовленнями.

Text
Функція: погодження великих замовлень

Функціональні вимоги
5.1 Система позначає замовлення "Потребує погодження", коли його сума
    перевищує ліміт погодження клієнта.
5.2 Менеджер із продажів може погодити або відхилити позначене замовлення
    і мусить додати коментар, якщо відхиляє.
5.3 Система сповіщає власника замовлення листом упродовж 1 хвилини
    після рішення.

Бізнес-правила
6.1 Ліміт погодження за замовчуванням 5 000 USD; менеджер із продажів може
    встановити інший ліміт для кожного клієнта.
6.2 Ліміт порівнюється із сумою замовлення з урахуванням податку.
    Приклад: ліміт 5 000 USD, замовлення 4 600 USD + 10% податку = 5 060 USD
    -> потребує погодження.

Критерії приймання
10.1 Дано клієнта з лімітом 5 000 USD, коли зберігається замовлення на
     5 060 USD з податком, тоді його статус "Потребує погодження".
10.2 Дано позначене замовлення, коли менеджер із продажів відхиляє його без
     коментаря, тоді система відмовляє й показує "Потрібен коментар".
10.3 Дано погоджене замовлення, тоді власник замовлення отримує лист
     упродовж 1 хвилини з іменем того, хто погодив.

Кожен рядок може перевірити людина, яка ніколи не бачила коду, і кожен рядок може оцінити розробник. Це і є тест гарної вимоги. Для українського продукту той самий підхід працює для, наприклад, інтеграції з Новою поштою: "Дано замовлення з типом доставки Нова пошта, коли менеджер натискає "Створити ТТН", тоді система зберігає номер накладної й показує його в картці замовлення". Або для оплати через LiqPay: "Дано незавершену оплату, коли платіжний сервіс повертає відмову, тоді замовлення лишається "Очікує оплати" і клієнт бачить повідомлення".

Як писати критерії приймання, що витримують перевірку?

  • Робіть їх спостережуваними. Описуйте те, що бачить людина або як змінюються дані, а не що робить код усередині.
  • Беріть реальні числа. "Понад ліміт" запрошує до суперечки, а "5 060 USD проти ліміту 5 000 USD" ні.
  • Охопіть сумний шлях. Відсутні дані, відхилена оплата, API партнера, що не відповідає.
  • Погодьте тестові дані. Назвіть зразкових клієнтів, замовлення чи документи, на яких проходитиме приймання.
  • Задайте вікно приймання. Наприклад, 5 робочих днів на етап, після яких здана робота вважається прийнятою, якщо не повідомлено про дефекти.

Помилки, через які фіксована ціна перетворюється на запити на зміни

  1. Немає списку поза обсягом. Кожне невисловлене очікування стає суперечкою.
  2. Інтеграції названі, але не описані. "Синхронізація з нашою ERP" може означати нічний файл або двосторонній API в реальному часі.
  3. Правила без прикладів. Виконавець реалізує правило, як написано, а бізнес мав на увазі інше.
  4. Міграцію залишили на потім. Десять років неохайних записів переносять наприкінці, під тиском часу.
  5. Дизайн за прикметниками. "Сучасний і зручний" це побажання щодо стилю, а екрани чи еталонний продукт це вимога.
  6. Один гігантський етап. Оплата й приймання наприкінці роблять кожну незгоду дорогою.
  7. Копіювання іншого продукту. "Як Salesforce, тільки простіше" не має меж. Опишіть власні сценарії.

Перетворення технічного завдання на фіксовану ціну

Добрий виконавець читає документ, ставить запитання щодо прогалин і повертає пропозицію, розбиту на етапи з виписаними припущеннями. Якщо виконавець називає фіксовану ціну без жодного запитання, вважайте, що ризик уже закладено в ціну або відкладено до запитів на зміни. Які запитання варто ставити на цьому етапі, читайте в матеріалі де знайти технічного партнера, а типові діапазони за типами проєктів дивіться у вартості розробки MVP і на сторінці послуги розробки індивідуального ПЗ.

У Lytvynov Production проєкти починаються від 10 000 USD, а фіксовану ціну ми даємо після короткої розмови для оцінки обсягу. Якщо обсяг ще формується, формат з обмеженим часом знімає проблему: наш AI Sprint це фіксовані 10 000 USD за 4 тижні з метою, погодженою заздалегідь.

Як ми використовуємо технічні завдання у своїх проєктах

Ми компанія з розробки програмного забезпечення, заснована у 2019 році, що створює CRM, ERP, SaaS-продукти й функції ШІ для компаній у США, Великій Британії та ЄС. В ERP для американської компанії з обслуговування літаків обсяг охоплював керування клієнтами й замовленнями, планування сервісу, зміни персоналу, складські залишки та облік відповідності. А під час ребрендингу французького маркетплейсу IT-фрилансерів ми виконали фіксований обсяг у фіксованому бюджеті.

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

Наші гайди про ШІ та розробку вгорі вашого Google?

Додайте Lytvynov Production як бажане джерело, і Google показуватиме наші нові гайди про ШІ-агентів, вартість MVP і розробку на замовлення вище у видачі.

Кейси

Часті запитання

Технічне завдання, англійською software requirements specification або SRS, це документ, що описує, що саме має робити програма, для кого, за якими правилами і як ви перевірите, що вона це робить. Воно є основою для оцінки, договору й приймальних випробувань. Воно описує поведінку й обмеження, а технічне рішення залишає команді, яка будує програму.

Для типового бізнес-застосунку, як-от CRM, клієнтський портал чи MVP, достатньо від 5 до 20 сторінок. Довші документи рідко читають повністю, і вони схильні собі суперечити. Деталі пишіть там, де гроші й ризик: бізнес-правила, інтеграції, міграція даних і критерії приймання.

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

Ні. Ці стандарти описують ґрунтовну структуру для регульованих і великих проєктів, а шаблон бере з них основні ідеї. Для бізнес-застосунку з фіксованою ціною корисніший коротший документ, що чітко охоплює обсяг, правила, інтеграції й критерії приймання, ніж повний формальний стандарт.

Лише для невеликого, добре зрозумілого обсягу або коли ціна купує фіксований проміжок часу, а не фіксований список функцій. Так працює наш AI Sprint: фіксовані 10 000 USD за 4 тижні з метою, погодженою заздалегідь. Для фіксованого списку функцій ціна надійна рівно настільки, наскільки надійне технічне завдання за нею.

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

Почнімо ваш проєкт
Записатися на дзвінок