Frog StudiosFrog Studios
Quote
Разработка

ТЗ на разработку: как написать техническое задание, которое работает

12 мая 20268 мин
Разработка
ТЗ

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

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

ТЗ не обязано быть томом на 80 страниц. Для небольшого проекта достаточно 5–10 страниц, для сложной системы — больше, но главное не объём, а проверяемость каждого требования.

Чем ТЗ отличается от «хотелки»

Сравните две формулировки:

  • «Сделайте удобный личный кабинет».
  • «Пользователь после входа по телефону и коду видит список своих заказов со статусами, может открыть заказ и скачать счёт в PDF».

Первая не поддаётся проверке: удобно — для кого? Вторая описывает сценарий, и её можно принять или отклонить. Хорошее требование отвечает на вопросы: кто, что делает, в каких условиях, что получает на выходе.

Структура рабочего ТЗ

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

Последний пункт часто упускают, хотя именно он спасает от споров: «мобильное приложение — в следующей версии», «аналитика — позже».

Как писать требования

Практические правила:

  • Один абзац — одно требование. Так проще оценивать и принимать.
  • Пишите в формате «Роль может сделать действие, чтобы получить результат».
  • Добавляйте критерии приёмки: «заказ отображается в списке не позднее чем через минуту после оформления».
  • Описывайте не только «счастливый путь», но и ошибки: что видит пользователь, если оплата не прошла или поле заполнено неверно.
  • Избегайте слов без измерения: «быстро», «современно», «удобно». Замените на проверяемое значение или пример.

Таблица: слабое и сильное требование

| Слабая формулировка | Сильная формулировка | |---------------------|----------------------| | Быстрая загрузка | Главная открывается за 2–3 секунды на обычном мобильном интернете | | Интеграция с CRM | При новой заявке с сайта в CRM создаётся сделка с именем, телефоном и источником | | Админка для менеджера | Менеджер может изменить статус заказа и оставить комментарий, история изменений сохраняется | | Красивый дизайн | Макеты утверждены заказчиком, реализация соответствует им с точностью до согласованных отклонений |

Кто должен участвовать в написании

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

Альтернативы классическому ТЗ

Не каждому проекту нужен формальный документ. Допустимы облегчённые форматы:

  • Пользовательские истории с критериями приёмки, собранные в бэклог.
  • Кликабельный прототип с комментариями к экранам.
  • Описание процессов в схемах: как сейчас работает бизнес и как должно стать.

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

Типичные ошибки

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

Как использовать ТЗ после старта

ТЗ — живой документ. Изменения вносятся письменно, с датой и согласованием обеих сторон; к каждому изменению оцениваются срок и стоимость. Тогда разговор о «мы же договаривались» превращается в рабочую проверку по тексту. На приёмке этапа берите список требований и отмечайте выполненные — так приёмка не зависит от настроения.

Условный пример

Условный пример: компания заказывает систему заявок на обслуживание оборудования. Вместо абзаца «нужна система учёта заявок» в ТЗ описаны три роли (клиент, диспетчер, инженер), шесть статусов заявки, правила перехода между ними, уведомления в Telegram и список отчётов. Каждое требование имеет проверку: «диспетчер назначает инженера — инженер получает уведомление». Разработчик может точно оценить объём, а заказчик — принять результат по списку.

Чек-лист перед подписанием ТЗ

Перед утверждением документа пройдитесь по списку:

  1. Понятно ли любому участнику проекта, зачем он нужен и в чём цель?
  2. У каждой роли описаны сценарии, а не только список «кнопок»?
  3. Указаны ли все интеграции и источники данных?
  4. Есть ли критерии приёмки хотя бы для ключевых функций?
  5. Прописано ли, что не входит в проект?
  6. Согласованы ли этапы и порядок внесения изменений?
  7. Утверждён ли документ обеими сторонами письменно, с указанием версии?

Если на три и более вопроса ответ «нет», документ не готов, и спешка в этот момент обойдётся дороже, чем лишняя неделя на доработку.

Как оценивать ТЗ глазами заказчика

Не обязательно разбираться в технологиях, чтобы проверить документ. Прочитайте его как пользователь и задайте вопросы: «Что произойдёт, если я нажму сюда?», «Где я увижу результат?», «Что случится при ошибке?». Каждое место, где нет ответа, — дыра в описании, которую иначе придётся закрывать в процессе разработки уже за деньги.

Итог

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

Если у вас есть набросок или даже идея на бумаге, мы можем вместе превратить её в структурированное описание и честно оценить объём работы — без обязательств по продолжению.


Frog Studios помогает собрать ТЗ или спецификацию первого этапа ещё до старта разработки.

Tags
ТЗТребованияЗаказная разработкаПриёмка

Read Also

Related Articles

All Articles

Start a project

Ready to discuss the project?

Leave a request — we'll respond within an hour. At the first meeting we'll break down the task and show relevant cases.

✓ Response within 1 hour on business days✓ NDA on request✓ First meeting — no upfront payment: task framing, cases, budget and timeline ballpark

Leave a Request

First meeting — 30–45 minutes, no upfront payment. Next: a proposal with price and timeline, fixed in the contract.