Зачем нужно техническое задание
Техническое задание (ТЗ) — это общий язык заказчика и разработчика. Оно отвечает на вопрос «что именно мы делаем и как поймём, что сделали». Без ТЗ каждая сторона держит в голове свою версию продукта, и расхождение вылезает на приёмке — когда исправлять дороже всего.
ТЗ не обязано быть томом на 80 страниц. Для небольшого проекта достаточно 5–10 страниц, для сложной системы — больше, но главное не объём, а проверяемость каждого требования.
Чем ТЗ отличается от «хотелки»
Сравните две формулировки:
- «Сделайте удобный личный кабинет».
- «Пользователь после входа по телефону и коду видит список своих заказов со статусами, может открыть заказ и скачать счёт в PDF».
Первая не поддаётся проверке: удобно — для кого? Вторая описывает сценарий, и её можно принять или отклонить. Хорошее требование отвечает на вопросы: кто, что делает, в каких условиях, что получает на выходе.
Структура рабочего ТЗ
- Цель и контекст. Зачем нужен продукт, какую проблему решает, какие метрики успеха.
- Пользователи и роли. Кто работает в системе и какие права у каждой роли.
- Сценарии и функции. Основной блок: что система умеет, по ролям и сценариям.
- Данные и интеграции. Какие сущности хранятся, с какими внешними системами нужен обмен (платежи, учётная система, почта, мессенджеры).
- Нефункциональные требования. Скорость, доступность, безопасность, поддерживаемые браузеры и устройства.
- Дизайн. Ссылка на макеты или требования к стилю.
- Этапы и приёмка. Как делится работа и по каким признакам принимается каждый этап.
- Что не входит в проект. Явный список исключений.
Последний пункт часто упускают, хотя именно он спасает от споров: «мобильное приложение — в следующей версии», «аналитика — позже».
Как писать требования
Практические правила:
- Один абзац — одно требование. Так проще оценивать и принимать.
- Пишите в формате «Роль может сделать действие, чтобы получить результат».
- Добавляйте критерии приёмки: «заказ отображается в списке не позднее чем через минуту после оформления».
- Описывайте не только «счастливый путь», но и ошибки: что видит пользователь, если оплата не прошла или поле заполнено неверно.
- Избегайте слов без измерения: «быстро», «современно», «удобно». Замените на проверяемое значение или пример.
Таблица: слабое и сильное требование
| Слабая формулировка | Сильная формулировка | |---------------------|----------------------| | Быстрая загрузка | Главная открывается за 2–3 секунды на обычном мобильном интернете | | Интеграция с CRM | При новой заявке с сайта в CRM создаётся сделка с именем, телефоном и источником | | Админка для менеджера | Менеджер может изменить статус заказа и оставить комментарий, история изменений сохраняется | | Красивый дизайн | Макеты утверждены заказчиком, реализация соответствует им с точностью до согласованных отклонений |
Кто должен участвовать в написании
Если заказчик пишет ТЗ в одиночку, обычно получается либо слишком общо, либо технически неверно. Если разработчик пишет без заказчика — получается удобное команде, но не бизнесу. Рабочая схема: заказчик описывает цели и процессы, аналитик подрядчика превращает их в сценарии, затем обе стороны вместе вычитывают итог. Проверка простая: человек, который будет пользоваться системой, должен понять свои сценарии из документа.
Альтернативы классическому ТЗ
Не каждому проекту нужен формальный документ. Допустимы облегчённые форматы:
- Пользовательские истории с критериями приёмки, собранные в бэклог.
- Кликабельный прототип с комментариями к экранам.
- Описание процессов в схемах: как сейчас работает бизнес и как должно стать.
Для проектов, где требования меняются по ходу, гибкий бэклог удобнее. Для проектов с фиксированной ценой и жёсткой приёмкой лучше полноценное ТЗ или хотя бы подробная спецификация первого этапа. Часто работает комбинация: детальное ТЗ на ближайший этап и крупные блоки на последующие.
Типичные ошибки
- Описывают решение, а не задачу. «Сделайте выпадающее меню» вместо «пользователь должен быстро найти нужный раздел».
- Игнорируют роли и права. Потом выясняется, что бухгалтеру нужен доступ, о котором не подумали.
- Забывают про данные. Откуда берутся начальные данные, кто их загружает, нужна ли миграция из старой системы.
- Не фиксируют версию. Документ ходит в чатах в пяти вариантах. Используйте один источник и историю изменений.
- Не проверяют на реальных людях. Покажите сценарии будущим пользователям до начала разработки.
Как использовать ТЗ после старта
ТЗ — живой документ. Изменения вносятся письменно, с датой и согласованием обеих сторон; к каждому изменению оцениваются срок и стоимость. Тогда разговор о «мы же договаривались» превращается в рабочую проверку по тексту. На приёмке этапа берите список требований и отмечайте выполненные — так приёмка не зависит от настроения.
Условный пример
Условный пример: компания заказывает систему заявок на обслуживание оборудования. Вместо абзаца «нужна система учёта заявок» в ТЗ описаны три роли (клиент, диспетчер, инженер), шесть статусов заявки, правила перехода между ними, уведомления в Telegram и список отчётов. Каждое требование имеет проверку: «диспетчер назначает инженера — инженер получает уведомление». Разработчик может точно оценить объём, а заказчик — принять результат по списку.
Чек-лист перед подписанием ТЗ
Перед утверждением документа пройдитесь по списку:
- Понятно ли любому участнику проекта, зачем он нужен и в чём цель?
- У каждой роли описаны сценарии, а не только список «кнопок»?
- Указаны ли все интеграции и источники данных?
- Есть ли критерии приёмки хотя бы для ключевых функций?
- Прописано ли, что не входит в проект?
- Согласованы ли этапы и порядок внесения изменений?
- Утверждён ли документ обеими сторонами письменно, с указанием версии?
Если на три и более вопроса ответ «нет», документ не готов, и спешка в этот момент обойдётся дороже, чем лишняя неделя на доработку.
Как оценивать ТЗ глазами заказчика
Не обязательно разбираться в технологиях, чтобы проверить документ. Прочитайте его как пользователь и задайте вопросы: «Что произойдёт, если я нажму сюда?», «Где я увижу результат?», «Что случится при ошибке?». Каждое место, где нет ответа, — дыра в описании, которую иначе придётся закрывать в процессе разработки уже за деньги.
Итог
Хорошее ТЗ экономит время и деньги на всех этапах: даёт точную оценку, снижает число споров и делает приёмку предсказуемой. Начните с целей и сценариев, добавляйте критерии проверки, явно записывайте границы проекта и держите документ в порядке.
Если у вас есть набросок или даже идея на бумаге, мы можем вместе превратить её в структурированное описание и честно оценить объём работы — без обязательств по продолжению.
Frog Studios помогает собрать ТЗ или спецификацию первого этапа ещё до старта разработки.