Как написать техническое задание: структура, требования, пример

Чтобы написать техническое задание, сначала выясните цель и границы проекта, затем соберите требования, проверьте их на измеримость и опишите этапы и приемку. Готовый документ состоит из общих сведений, целей, требований, состава работ и порядка контроля. Ниже порядок действий, образец пунктов и список ошибок.

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

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

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

Хорошее ТЗ решает три задачи. Оно фиксирует границы работ, чтобы проект не разрастался сам по себе. Оно служит основой для сметы и сроков. И оно дает проверяемые критерии, по которым акт приемки подписывается без споров.

Разработка технического задания начинается не с открытия шаблона, а с вопросов: кто будет пользоваться результатом, какую проблему он решает и что считается успехом. Шаблон только помогает разложить ответы по местам. Готовые формы для информационных систем лежат на сайте: шаблон ТЗ на автоматизированную систему по ГОСТ 34 и шаблон ТЗ на программу по ГОСТ 19.

Структура технического задания и пункты, которые в нем есть

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

РазделЧто в нем описываетсяЧастая ошибка
Общие сведенияНаименование системы, заказчик, исполнитель, основание для работ, сроки, терминыНе указан документ-основание, нет перечня сокращений
Назначение и целиДля чего создается продукт, какие показатели должны улучшитьсяЦель сформулирована как "сделать удобно"
Характеристика объектаКак процесс устроен сейчас, где проходят границы автоматизацииОписан идеальный процесс, а не реальный
ТребованияФункции, интерфейсы, данные, безопасность, производительность, надежностьТребования нельзя проверить измерением
Состав и содержание работЭтапы, результаты каждого этапа, перечень документовЭтапы без видимого результата
Порядок контроля и приемкиВиды испытаний, кто принимает, по каким критериямКритерии заменены словом "удовлетворительно"
Источники разработкиНормативные документы, исходные материалы заказчикаСписок устарел или скопирован из чужого ТЗ

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

Оглавление типового технического задания: шесть разделов от общих сведений до источников разработки.
Оглавление типового технического задания: шесть разделов от общих сведений до источников разработки.

Как написать техническое задание по шагам

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

  1. Выясните цель и заинтересованные стороны. Составьте список тех, кто заказывает, использует и сопровождает продукт, и запишите, что каждый от него ждет.
  2. Опишите текущее состояние. Один-два абзаца и схема процесса помогут отделить автоматизируемое от того, что остается ручным.
  3. Соберите требования в черновик без структуры: пожелания, ограничения, внешние системы, нормативные рамки. Не фильтруйте на этом этапе.
  4. Разнесите требования по группам и проверьте каждое на измеримость. Если требование нельзя проверить, его нужно переписать или убрать.
  5. Определите этапы работ и результат каждого этапа: документ, действующий модуль, отчет об испытаниях.
  6. Пропишите порядок приемки: кто, когда и какими проверками подтверждает результат.
  7. Согласуйте черновик с заказчиком по разделам, а не целиком. Правки по частям обсуждаются быстрее.
  8. Оформите документ, добавьте лист утверждения и зафиксируйте версию.

Самая трудоемкая часть здесь - шаги 3 и 4. Именно на них определяется, получится ли из черновика рабочий документ. Если заказчик не готов к подробным интервью, помогает пилотная версия экранов или прототип: реакция на картинку дает больше сведений, чем ответ на абстрактный вопрос.

Требования к техническому заданию: как формулировать

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

Слабая формулировкаЧто не такРабочий вариант
Система должна работать быстроНет числа и условийОткрытие карточки заявки не дольше 2 секунд при 100 одновременных пользователях
Интерфейс должен быть удобнымНет критерия удобстваНовый сотрудник после 15-минутного инструктажа создает заявку не дольше чем за 5 минут
Система должна быть надежнойНепонятно, что считать отказомДоступность в рабочее время не ниже 99 процентов в месяц, восстановление после сбоя не дольше 4 часов
Возможна интеграция с другими системами"Возможна" не обязывает исполнителяСистема передает заказы в учетную систему заказчика по протоколу HTTPS в формате JSON

Каждое требование лучше писать отдельным пунктом с глаголом "должна", "должен", "обеспечивает". Если в одном предложении три действия, при испытаниях придется проверять три разных вещи, а отметка будет одна. Разницу между функциональными и остальными требованиями подробно разбирает статья про функциональные и нефункциональные требования, а выше по цепочке стоят бизнес-требования, из которых всё вырастает.

Пример технического задания: фрагмент для информационной системы

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

Пункт 1.2 "Назначение системы". Система предназначена для регистрации, распределения и контроля выполнения заявок сотрудников ООО "Вектор" в службу технической поддержки. Целью создания системы является сокращение среднего времени обработки заявки с трех рабочих дней до одного.

Пункт 3.1.1 "Регистрация заявки". Система должна позволять сотруднику создать заявку, указав тему, описание, категорию и срочность. Обязательными являются поля "Тема" и "Категория". После сохранения система присваивает заявке уникальный номер и отправляет подтверждение на электронную почту заявителя в течение одной минуты.

Пункт 3.2.3 "Производительность". Время формирования списка заявок за любой месяц не должно превышать 3 секунд при объеме базы до 200 тысяч записей.

Пункт 5.1 "Приемка". Приемка системы проводится комиссией в составе представителей заказчика и исполнителя по программе и методике испытаний. Система считается принятой при отсутствии незакрытых замечаний критичного уровня.

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

Оформление, согласование и версии документа

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

Обязательно предусмотрите лист утверждения и таблицу изменений. Заказчик почти всегда вносит правки по ходу проекта, и без истории версий невозможно понять, какая редакция действует. Каждое изменение стоит оформлять дополнением или новой редакцией с датой и номером, а не правкой "в тексте тихо".

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

Типичные ошибки при разработке технического задания

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

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

Проверка перед отправкой на согласование

Перед тем как отдать документ заказчику, пройдитесь по короткому списку: у каждого требования есть способ проверки, термины определены, все ссылки на приложения живые, нет пунктов "по согласованию" без указания, с кем и когда согласовать. Автоматизировать часть этой проверки можно инструментом на сайте.

Если документ создается для автоматизированной системы, сверьте состав разделов с текстом ГОСТ 34.602-89 и с обзором новой редакции в статье про ГОСТ 34.602-2020. Для небольших проектов без госрегулирования достаточно взять общую структуру из этой статьи и сократить ее до нужных пунктов.

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

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

Объем определяется масштабом проекта. Для небольшой доработки хватает 5-10 страниц, для информационной системы бывает 40-100. Ориентируйтесь на полноту, а не на объем: если каждое требование проверяемо и ничего не повторяется, документ нужного размера.

Кто должен писать техническое задание, заказчик или исполнитель?

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

Обязательно ли писать ТЗ по ГОСТ?

Не всегда. Для государственных и многих корпоративных проектов стандарт указывается в договоре, и тогда структуру придется соблюдать. В остальных случаях ГОСТ полезен как проверенный перечень разделов.

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

Можно, если изменения оформлены письменно: дополнительным соглашением или новой редакцией с датой, номером и подписями сторон. Устные договоренности в ТЗ не работают.

Чем техническое задание отличается от договора?

Договор регулирует деньги, сроки и ответственность сторон, а ТЗ описывает, что именно создается и как проверяется результат. Обычно ТЗ входит в договор приложением.

Что делать, если заказчик не может сформулировать требования?

Начните с интервью по процессам и прототипа экранов, а требования выводите из реакции пользователей. Допустимо разбить работу на этапы: сначала обследование и концепция, потом ТЗ на основную разработку.

Читайте также