Что должно содержать техническое задание на разработку программного обеспечения?
Техническое задание для проекта с фиксированной ценой содержит двенадцать разделов: цель и метрики успеха, пользователи и роли, объём и что вне объёма, пользовательские сценарии, функциональные требования по функциям, бизнес-правила, данные и миграция, интеграции, нефункциональные требования, критерии приёмки, допущения и открытые вопросы, этапы. Каждое требование пишите как наблюдаемое поведение с чётким тестом пройдено или нет, список исключённого описывайте так же тщательно, как список включённого, а сам документ держите в пределах от 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 для одной функции системы управления заказами.
Функция: согласование крупных заказов
Функциональные требования
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 рабочих дней на этап, после которых сданная работа считается принятой, если не сообщено о дефектах.
Ошибки, из-за которых фиксированная цена превращается в запросы на изменения
- Нет списка вне объёма. Каждое невысказанное ожидание становится спором.
- Интеграции названы, но не описаны. "Синхронизация с нашей ERP" может означать ночной файл или двусторонний API в реальном времени.
- Правила без примеров. Исполнитель реализует правило, как написано, а бизнес имел в виду другое.
- Миграцию оставили на потом. Десять лет неаккуратных записей переносят в конце, под давлением времени.
- Дизайн по прилагательным. "Современный и удобный" это пожелание по стилю, а экраны или эталонный продукт это требование.
- Один гигантский этап. Оплата и приёмка в конце делают любое разногласие дорогим.
- Копирование другого продукта. "Как Salesforce, только проще" не имеет границ. Опишите собственные сценарии.
Превращение технического задания в фиксированную цену
Хороший исполнитель читает документ, задаёт вопросы по пробелам и возвращает предложение, разбитое на этапы с выписанными допущениями. Если исполнитель называет фиксированную цену без единого вопроса, считайте, что риск уже заложен в цену или отложен до запросов на изменения. Какие вопросы стоит задавать на этом этапе, читайте в материале где найти технического партнёра, а типичные диапазоны по типам проектов смотрите в стоимости разработки MVP и на странице услуги разработки индивидуального ПО.
В Lytvynov Production проекты начинаются от 10 000 USD, а фиксированную цену мы даём после короткого разговора для оценки объёма. Если объём ещё формируется, формат с ограниченным временем снимает проблему: наш AI Sprint это фиксированные 10 000 USD за 4 недели с целью, согласованной заранее.
Как мы используем технические задания в своих проектах
Мы компания по разработке программного обеспечения, основанная в 2019 году, которая создаёт CRM, ERP, SaaS-продукты и функции ИИ для компаний в США, Великобритании и ЕС. В ERP для американской компании по обслуживанию самолётов объём охватывал управление клиентами и заказами, планирование сервиса, смены персонала, складские остатки и учёт соответствия. А при ребрендинге французского маркетплейса IT-фрилансеров мы выполнили фиксированный объём в фиксированном бюджете.
Отправьте нам заполненный шаблон или грубый черновик, и мы вернёмся с вопросами, планом этапов и фиксированной ценой. Также можно начать с нашей формы оценки, чтобы получить первый диапазон за несколько минут.