Перейти к содержимому
← Все статьи
10 мин чтения

Как составить ТЗ на разработку: структура, сценарии и приёмка

Грамотное техническое задание на разработку ПО отвечает на три вопроса: какую бизнес-проблему решает система, как пользователи взаимодействуют с ней по шагам и как проверить результат перед приёмкой. Для старта проекта не нужен документ на сотни страниц. Достаточно зафиксировать бизнес-цель, роли, пользовательские сценарии, интеграции и точные границы первого релиза. Ниже разбираем структуру рабочего ТЗ, шаблоны формулировок и правила, защищающие бюджет от переделок.

Из чего состоит рабочее ТЗ на разработку ПО: 8 ключевых разделов

Техническое задание — это не юридический щит от разногласий и не попытка переложить ответственность на заказчика. Это общий язык между бизнесом, проектировщиками и разработчиками. Когда в ТЗ написаны размытые формулировки вроде «система должна быть удобной и быстрой», команда разработки трактует их через призму своего опыта, а заказчик — через ожидания своего бизнеса. В результате на этапе сдачи стороны обнаруживают два разных продукта.

Рабочее ТЗ на разработку приложения или веб-сервиса описывает поведение системы в конкретных ситуациях: что происходит при успешном сценарии, как сервис реагирует на ошибку валидации, какие данные передаются внешним системам. Документ структурируется так, чтобы инженер мог спроектировать схему таблиц в Postgres и контракты эндпоинтов, а тестировщик — составить тест-кейсы.

Полноценный документ спецификации состоит из восьми логических блоков, каждый из которых закрывает отдельный пласт неопределённости:

  • Бизнес-цель и контекст: какую проблему решает продукт, для кого создаётся, какие бизнес-метрики определяют успех внедрения.
  • Роли и права доступа: список всех типов пользователей (гость, клиент, оператор, суперадминистратор) с матрицей разрешений для каждого действия.
  • Пользовательские сценарии (User Flows): пошаговое описание пути пользователя от точки входа до целевого результата, включая альтернативные ветки и ошибки.
  • Функциональные требования и правила данных: условия валидации полей, бизнес-логика расчётов, статусные модели сущностей и ограничения на ввод.
  • Интеграции со сторонними сервисами: список внешних API, платежных шлюзов, CRM-систем, протоколы обмена, форматы вебхуков и поведение при недоступности внешнего сервиса.
  • Нефункциональные требования: целевая нагрузка, время отклика, требования к резервному копированию, безопасность персональных данных и поддерживаемые платформы.
  • Критерии приёмки (Acceptance Criteria): однозначные условия, по которым проверяется готовность каждой фичи перед передачей в тестирование.
  • Границы проекта (Out of Scope): явный список функций и сценариев, которые осознанно не входят в текущий релиз и не должны влиять на оценку.

Границы проекта: почему список «что не входит» важнее списка функций

Главная причина срыва бюджета и сроков в заказной разработке — это расползание границ (scope creep). Когда в ТЗ зафиксированы только желаемые функции, у участников проекта неизбежно возникают скрытые допущения. Заказчик предполагает, что кнопка «оплатить заказ» автоматически включает в себя эквайринг трех банков, частичные возвраты, сплитование платежей и фискализацию чеков. Разработчик при этом оценивает только базовый вызов одного метода платежного шлюза.

Чтобы исключить двусмысленность, раздел границ продукта (Out of Scope) должен быть столь же подробным, сколь и функциональная часть. Если вы планируете запускать первую версию продукта, критически важно отсечь все второстепенные модули. Подробный разбор того, как отделять ключевые гипотезы от второстепенных функций, мы описали в статье как определить границы MVP.

В раздел исключений вносятся не абстрактные идеи, а конкретные технические и продуктовые сценарии. Например: автоматический сброс пароля через SMS не реализуется в первой версии, смена пароля выполняется вручную через администратора; интеграция с 1С отсутствует, обмен заказами происходит через выгрузку CSV; мобильное приложение не разрабатывается, интерфейс адаптируется под мобильные браузеры. Такая фиксация защищает обе стороны: заказчик понимает, за что платит, а команда сфокусирована на главном.

ТЗ или User Stories: что выбрать для запуска проекта

Среди продуктовых команд и агентств не утихают споры: нужно ли писать монолитное техническое задание по строгим стандартам или достаточно набора User Stories в таск-трекере. На практике противопоставление этих форматов искусственно. Классическое ТЗ по ГОСТу перегружено канцеляритом и бюрократическими разделами («требования к транспортированию и хранению носителей данных»), которые не добавляют ясности коду. В то же время разрозненные пользовательские истории без общего описания архитектуры приводят к фрагментарной разработке, когда бэкенд переписывают на каждом третьем спринте.

Оптимальный подход для коммерческой разработки — гибридный формат. Общая спецификация задает архитектурный каркас: модель данных, глобальные роли, требования к отказоустойчивости и интеграционные протоколы. Внутри этого каркаса конкретные фичи декомпозируются в виде User Stories («Как [роль], я хочу [действие], чтобы [ценность]»), снабженных проверяемыми критериями приёмки в формате «Дано — Когда — Тогда» (Given-When-Then).

  • Классическое ТЗ в виде монолитного документа нужно: для тендеров, государственных контрактов, жестко регламентированных отраслей (медицина, банковский комплаенс) или при передаче проекта на фиксированный бюджет (Fixed Price) стороннему подрядчику.
  • User Stories с критериями приёмки эффективны: при гибкой разработке по спринтам (Scrum, Kanban), когда требования регулярно уточняются по результатам пользовательских интервью и аналитики.
  • Гибридная спецификация идеальна для заказной разработки: единый архитектурный документ описывает схему сущностей и интеграции, а детальные требования к экранам и кнопкам живут в виде историй с понятными чек-листами.

Насколько подробным делать ТЗ для MVP

При запуске первой версии продукта чрезмерная детализация опасна так же, как и полное отсутствие документации. Если заказчик тратит три месяца на составление ТЗ объемом в двести страниц, половина описанных функций устареет еще до написания первой строчки кода. Рынок изменится, первые пользователи потребуют другой сценарий, а бюджет на аналитику уже будет потрачен. В статье процесс разработки MVP мы детально разбираем, как выстроить итеративный цикл запуска без лишних расходов.

Для запуска минимально жизнеспособного продукта ТЗ должно отвечать принципу необходимой достаточности. Нужно детально описать один критический путь пользователя (happy path) — тот самый сценарий, ради которого создается продукт и за который клиент готов платить деньги. Все побочные сценарии (сложные фильтры, реферальные программы, тонкие настройки уведомлений) намеренно упрощаются или выносятся за рамки релиза.

Чтобы ТЗ для MVP принесло максимальную пользу команде, проверьте его по чек-листу минимально необходимого состава:

  • Описан один ключевой бизнес-сценарий: от регистрации до совершения целевого действия (покупка, отправка заявки, генерация отчета).
  • Зафиксированы роли и разграничение доступа: кто видит конфиденциальные данные, кто имеет право удалять записи.
  • Определены внешние точки отказа: какие API используются (оплата, SMS, карты) и что видит пользователь, если внешний сервис временно недоступен.
  • Описаны правила обработки ошибок на критическом пути: что происходит при дублировании платежа, потере соединения или некорректном вводе данных.
  • Определены метрики готовности: минимальная пропускная способность сервиса, допустимое время отклика интерфейса и требования к резервному копированию базы данных.
  • Сознательно исключена микрооптимизация: архитектура проектируется чистой и масштабируемой, но без избыточных распределенных очередей и микросервисов там, где достаточно надежного монолита на Go и Postgres.

Что писать в ТЗ, если вы не знаете технических деталей

Частая проблема предпринимателей и менеджеров без инженерного бэкграунда — страх составить ТЗ «неправильно». Заказчики либо пытаются скопировать из интернета технические термины, в которых не разбираются, либо вовсе отказываются от формулирования требований, надеясь, что «разработчики сами всё поймут». Обе крайности вредны. Если в ТЗ написано «использовать микросервисную архитектуру на Kubernetes и базы данных NoSQL», хотя задаче идеально подходит простой сервис на Go с базой данных Postgres, проект получает искусственное удорожание и технический долг.

Главное правило для нетехнического заказчика: описывайте «что» должна делать система и «почему», а решение «как» оставьте инженерам. Ваша экспертность заключается в понимании бизнес-процессов, логики клиентов и правил предметной области. Опишите поведение системы как последовательность входящих данных, правил их трансформации и исходящих результатов.

Вместо попыток спроектировать базу данных опишите сущности на языке бизнеса. Например: «В системе есть Заказ. Заказ может находиться в одном из пяти статусов: Создан, Оплачен, В сборке, Доставлен, Отменен. Перевести заказ в статус Отменен может только клиент до момента передачи в сборку, либо администратор в любой момент. При отмене оплаченного заказа инициируется процедура возврата средств». Такой формулировки инженеру более чем достаточно, чтобы спроектировать корректную статусную модель, транзакции в базе данных и обработчики событий.

Интеграции и нефункциональные требования: как не упустить критическое

Приложение редко существует в вакууме. В современных сервисах бэкенд связан десятками нитей с внешними системами: платежными шлюзами, CRM, складскими базами, службами доставки и сервисами авторизации. Если в ТЗ просто указать «интеграция с банком», разработчик не сможет оценить объем работ. В технической документации для каждой интеграции фиксируются контракт взаимодействия, способ передачи данных (REST API, вебхуки, очереди) и правила обработки сбоев. Проектирование таких стыков подробно рассмотрено в материале проектирование API для интеграций.

Не менее важны нефункциональные требования (НФТ). Они определяют, как система ведет себя под нагрузкой, как восстанавливается после падений и как защищает информацию. Если не зафиксировать требования к масштабируемости заранее, можно получить сервис, который падает при одновременном входе пятисот пользователей или теряет транзакции при перезагрузке сервера. При передаче проекта подрядчикам вопросы надежности требуют предельного внимания: читайте подробнее о контроле разработки в статье разработка ПО на аутсорсе.

  • Требования к интеграциям: документация внешнего API, тестовые стенды (песочницы), структура вебхуков, требования к повторным попыткам отправки (retries) и проверка идемпотентности запросов.
  • Целевая нагрузка и производительность: ожидаемое количество одновременных пользователей, пиковые часы (RPS — запросов в секунду), допустимое время генерации ответа API (например, до 200 мс на чтение).
  • Отказоустойчивость и непрерывность: требования к регулярности резервного копирования Postgres, допустимое время восстановления после сбоя (RTO) и допустимая потеря данных (RPO).
  • Безопасность и хранение данных: протоколы шифрования трафика (TLS), безопасное хранение паролей (хеширование через bcrypt/argon2), политика хранения логов и разделение контуров тестирования и продакшена.

Как связать ТЗ с договором и моделями оплаты

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

Степень жесткости ТЗ напрямую зависит от выбранной финансовой схемы сотрудничества. Если вы работаете по модели Fixed Price (фиксированная цена и сроки), ТЗ обязано быть предельно детализированным, с жесткими критериями приёмки и фиксацией каждого экрана. Любая недосказанность в таком формате трактуется подрядчиком как повод для увеличения сметы. Напротив, при работе по модели Time & Materials (оплата по затраченным часам) ТЗ выполняет роль ориентира и дорожной карты, где требования уточняются перед началом каждого спринта. Детальное сравнение форматов мы привели в статье модели оплаты разработки ПО.

Чтобы ТЗ защищало ваши интересы и не сковывало команду, зафиксируйте в соглашении прозрачный регламент управления изменениями (Change Management). Опишите процедуру: как инициализируется новая доработка, кто оценивает ее влияние на архитектуру и сроки, и как происходит приоритизация бэклога. О том, как выбрать подрядчика, готового работать по прозрачным инженерным процессам, читайте в статье как выбрать студию разработки.

Вопросы

Частые вопросы

Не нашли ответ — спросите на созвоне или в Telegram.

Как составить ТЗ на разработку программного обеспечения без опыта?

Сфокусируйтесь на бизнес-логике, а не на техническом коде. Опишите, какую проблему решает продукт, перечислите роли пользователей и опишите по шагам их сценарии: откуда пользователь приходит, что вводит, какую кнопку нажимает и какой результат должен получить. Укажите правила расчетов, статусы заказов и список внешних систем. Архитектуру базы данных, язык программирования и структуру API поручите разработать инженерам.

Как составить ТЗ на разработку приложения для стадии MVP?

Для MVP спецификация должна содержать только один главный пользовательский путь (happy path), приносящий ценность клиенту. Опишите регистрацию, целевое действие (например, оформление заявки или оплату) и интерфейс администратора для обработки данных. Откажитесь от второстепенных функций, сложных интеграций и микросервисной архитектуры. Обязательно включите раздел «Что не входит в релиз», чтобы удержать бюджет в запланированных рамках.

Что выбрать: классическое техническое задание или User Stories?

Используйте гибридный подход. Для описания общей архитектуры, ролей доступа, моделей сущностей, интеграций и требований к безопасности создайте структурированный документ верхнего уровня. Для конкретных экранных форм, интерфейсных сценариев и пользовательских задач используйте User Stories с четкими критериями приёмки. Это сохранит целостность системы и даст команде гибкость в спринтах.

Какие нефункциональные требования обязательно включать в ТЗ?

Обязательно зафиксируйте целевую нагрузку (количество активных пользователей и пиковый RPS), требования к скорости отклика интерфейса и API, политику резервного копирования базы данных, протоколы защиты персональных данных и требования к доступности сервиса (SLA). Также укажите платформы, браузеры и минимальные разрешения экранов, которые продукт обязан официально поддерживать.

Как сформулировать критерии приёмки в техническом задании?

Формулируйте критерии приёмки как однозначно проверяемые утверждения. Избегайте субъективных оценок вроде «быстрая загрузка» или «интуитивный интерфейс». Используйте формат условий: «При вводе некорректного email под полем отображается подсказка с текстом ошибки», «Время ответа эндпоинта поиска не превышает 300 мс при базе в 100 тысяч записей», «После нажатия кнопки Оплатить пользователю отправляется квитанция на почту».

Можно ли менять техническое задание в процессе разработки проекта?

Да, требования неизбежно меняются по мере проверки продуктовых гипотез. Однако изменения должны вноситься по согласованной процедуре. При модели Time & Materials новые требования просто приоритизируются в бэклоге на следующий спринт. При модели Fixed Price любые изменения оформляются через анализ влияния на архитектуру, пересчет сметы и подписание дополнительного соглашения к договору.

Связанная услуга

Разработка MVP для проверки бизнес-идеи

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

Об услуге
Другие статьи
6 мин чтения

Как определить объём MVP: что делать первым, а что отложить

Как определить объём MVP: гипотеза, один пользователь и один сценарий, что можно отложить, а что нельзя, и критерии приёмки.

Читать статью: Как определить объём MVP: что делать первым, а что отложить →
6 мин чтения

Разработка MVP: этапы создания и ключевые факторы стоимости

Разработка MVP от проектирования до релиза: как объём функций, интеграции, дизайн и поддержка формируют стоимость и как устроен процесс.

Читать статью: Разработка MVP: этапы создания и ключевые факторы стоимости →
6 мин чтения

Как выбрать студию разработки: вопросы подрядчику, права и красные флаги

Как выбрать студию разработки: договор, права на код, доступы к репозиторию и серверам, критерии приёмки и красные флаги при поиске подрядчика.

Читать статью: Как выбрать студию разработки: вопросы подрядчику, права и красные флаги →
Контакт

Обсудим вашу задачу?

Тридцать минут созвона — и у вас есть понимание архитектуры, сроков и формата работы. Без обязательств.

Или напишите в Telegram →Читайте наш канал в Telegram →

Укажите Telegram или email, чтобы мы могли ответить.

Отвечаем в течение 15 минут.