Перейти к содержимому
Кирилл ПетровFull-stack-разработчик

Руководство

Техническое задание на разработку приложения: структура, пример и советы

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

Один разработчик на весь циклДоговор и этапы работУдалённо по России, встречи в Перми

Основы

Зачем нужно техническое задание

Техническое задание (ТЗ) нужно для трёх вещей. Первое: согласовать ожидания, чтобы заказчик и исполнитель понимали результат одинаково. Второе: получить сопоставимые оценки от разных подрядчиков. Третье: иметь основу для приёмки работ: что считается готовым.

Есть крайности, которых стоит избегать. Слишком короткое описание вроде «нужно приложение как у такси» оставляет простор для недопонимания и споров. Слишком подробный документ, написанный до проектирования, устаревает раньше, чем начнётся разработка. Золотая середина: описание задач, ролей, сценариев и ограничений, без попытки расписать каждый экран заранее.

Разделы

Структура ТЗ

Хорошее ТЗ состоит из нескольких разделов, каждый из которых отвечает на конкретный вопрос.

  1. Цель и контекст. Зачем нужен продукт, какую проблему решает, кто заказчик и аудитория.
  2. Роли пользователей. Кто пользуется приложением (клиент, исполнитель, администратор) и что делает каждый.
  3. Сценарии. Пошаговые описания ключевых действий: как клиент делает заказ, как исполнитель его принимает.
  4. Функциональные требования. Список функций по модулям с приоритетами.
  5. Нефункциональные требования. Платформы, нагрузка, безопасность, скорость, доступность.
  6. Интеграции. С какими системами и сервисами связывается продукт.
  7. Дизайн и интерфейс. Требования к стилю, наличие готовых материалов, адаптивность.
  8. Этапы и приёмка. Из чего состоят этапы, что считается результатом и как он проверяется.
  9. Термины и допущения. Что означают ключевые слова, что принято за исходное.

Пример

Пример фрагмента: модуль заказа

ФункцияОписаниеПриоритет
Выбор адресовПассажир вводит адрес отправления и назначения, подсказки появляются при вводе, точку можно выбрать на картеОбязательно
Расчёт ценыЦена рассчитывается на сервере по расстоянию, времени и классу автомобиля и показывается до заказаОбязательно
Выбор способа оплатыКарта, СБП или наличныеОбязательно
Предварительный заказЗаказ на дату и время с напоминаниями за сутки и за часЖелательно
ПромокодВвод промокода и пересчёт ценыПозже
Отмена заказаБесплатная отмена до назначения водителя, дальше по правиламОбязательно

Советы

Как формулировать требования

Пишите от задач

Вместо «кнопка в правом углу» напишите «пользователь может быстро повторить прошлый заказ». Решение найдёт дизайнер.

Указывайте приоритеты

Разделяйте на обязательное, желательное и позже. Это помогает уложиться в бюджет и срок.

Давайте измеримые критерии

Не «быстро работает», а «экран заказа открывается быстрее двух секунд на среднем устройстве».

Описывайте исключения

Что происходит, если нет связи, оплата не прошла, водитель отказался. Здесь скрыта половина сложности.

Ошибки

Чего не нужно в ТЗ

Расписанных на месяцы экранов

Макеты делают в процессе проектирования. Заранее прорисованные экраны устаревают и ограничивают решения.

Технических деталей без нужды

Выбор баз данных и серверов лучше доверить исполнителю, если у вас нет особых требований.

Всего сразу

Описание второго и третьего этапов подробно не имеет смысла, пока не готов первый.

Термины

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

Бриф — это короткий документ о задаче, который вы даёте подрядчику для первой оценки: цель, аудитория, основные функции, бюджет и сроки. Описание продукта (PRD) подробнее брифа: оно объясняет, что и зачем делается, но не обязательно как. Техническое задание ещё детальнее: оно служит основой договора и приёмки.

Для небольших и средних проектов достаточно брифа и ТЗ в упрощённой форме. Для крупных проектов ТЗ может быть большим, но тогда его пишут поэтапно, с участием исполнителя.

Шаблон

Шаблон ТЗ на одну страницу

Для первой оценки и небольшого проекта достаточно одной страницы. Скопируйте структуру и заполните своими словами.

  1. Продукт. Что это и для кого, одним-двумя предложениями.
  2. Проблема. Как пользователи решают задачу сейчас и что в этом неудобно.
  3. Роли. Кто пользуется системой и что делает каждый.
  4. Главные сценарии. Три-пять действий шаг за шагом.
  5. Обязательно в первой версии. Список функций, без которых продукт не нужен.
  6. Потом. Что можно отложить.
  7. Интеграции. С какими сервисами и системами нужен обмен данными.
  8. Ограничения. Платформы, сроки, бюджет, требования к данным.
  9. Как поймём, что всё работает. Критерии приёмки первой версии.

Такая страница помогает получить сопоставимые оценки от разных исполнителей, а дальше её превращают в полноценное ТЗ на этапе проектирования.

Приёмка

Как принимать работу по ТЗ

Проверяйте сценарии, а не экраны

Пройдите главные сценарии от начала до конца так, как это сделает пользователь.

Используйте реальные данные

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

Проверяйте на нескольких устройствах

Старый телефон, маленький экран, медленный интернет и разные версии Android.

Фиксируйте замечания письменно

Список с шагами воспроизведения и снимками экрана, а не сообщения в разных чатах.

Отделяйте ошибки от новых пожеланий

Ошибка исправляется в рамках этапа, новое пожелание оценивается отдельно. Так проще соблюдать сроки и бюджет.

Вопросы

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

Нужно ли ТЗ для небольшого проекта?

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

Кто должен писать ТЗ: заказчик или исполнитель?

Лучше вместе. Заказчик объясняет бизнес-задачу, исполнитель помогает перевести её в понятные требования и предупредить о подводных камнях.

Сколько времени занимает подготовка ТЗ?

Зависит от проекта. Для небольшого продукта достаточно нескольких встреч и недели доработок. Для крупной системы это отдельный этап проектирования.

Что делать, если требования меняются?

Изменения неизбежны. Важно иметь порядок их согласования: что меняется, как влияет на срок и бюджет и кто принимает решение.

Можно ли обойтись без ТЗ?

Для очень маленьких задач можно, но тогда вся ответственность за понимание на исполнителе, а приёмка основана на ощущениях. Для проектов с бюджетом лучше зафиксировать хотя бы краткое описание.

Как начать, если у меня только идея?

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

Помогу описать задачу

Если ТЗ ещё нет, начнём с короткого описания: что нужно сделать, для кого и в каком порядке. Напишите в Telegram.

Обсудить проект