Что должно содержать техническое задание на разработку программного обеспечения?

Техническое задание для проекта с фиксированной ценой содержит двенадцать разделов: цель и метрики успеха, пользователи и роли, объём и что вне объёма, пользовательские сценарии, функциональные требования по функциям, бизнес-правила, данные и миграция, интеграции, нефункциональные требования, критерии приёмки, допущения и открытые вопросы, этапы. Каждое требование пишите как наблюдаемое поведение с чётким тестом пройдено или нет, список исключённого описывайте так же тщательно, как список включённого, а сам документ держите в пределах от 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 недели с целью, согласованной заранее. Для фиксированного списка функций цена надёжна ровно настолько, насколько надёжно техническое задание за ней.

Они будут меняться, и задание должно сказать как. Короткий раздел о контроле изменений определяет, что изменение описывают письменно, оценивают, утверждают и затем планируют, а небольшие обмены равного размера можно делать в рамках этапа. Так фиксированная цена остаётся фиксированной для согласованного объёма, а место для того, что вы узнаете, остаётся.

Давайте начнем ваш проект
Записаться на звонок