Москва
Кемерово

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

сложность:  

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

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

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

Что такое техническое задание на разработку сайта

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

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

Зачем составлять техническое задание

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

Любой функциональный элемент сайта связан со множеством вопросов, которые возникнут во время разработки. Как будет выстроен интерфейс, как будут реализованы функции, какие пользовательские сценарии необходимо учесть, каким техническим требованиям должен соответствовать сайт — все это нужно понятно описать в ТЗ. Дело в том, что когда система уже создана, менять в ней что-то сложно и дорого. На этапе проектирования это делается легко — достаточно закрепить новые договоренности и уже после этого приступать к разработке.

Илья Горбаров

CEO

digital-агентство «Атвинта»

Польза технического задания для заказчика:

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

Простота и скорость работы. Подробное ТЗ облегчает исполнителю разработку — четкие описания помогают быстрее справиться с задачей.

На каком этапе составлять ТЗ 

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

Кто должен составлять техническое задание

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

Исполнитель

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

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

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

Когда будут начисляться бонусы: в момент покупки или поступления денег в биллинговой системе? Что происходит с бонусами при возврате? Когда бонусы сгорают? И так по каждой функции сайта — нужно учесть и расписать все сценарии и условия.

Представим наглядно, как это будет выглядеть в ТЗ.

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

Заказчик 

Как мы уже писали выше, техзадания, составленные клиентом, обычно больше походят на набросок, чем конечный вариант технического задания. К такому документу у исполнителя возникнут вопросы и уточнения, придется вносить много правок. Это затянет процесс разработки сайта. Лучше сразу положиться на опытного исполнителя и доверить ему разработку ТЗ с учетом ваших требований.

Совместная работа

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

Разработка техзадания происходит в ходе обсуждения. Исполнитель может предложить разные варианты реализации идей и поможет заказчику определиться в неуверенных моментах.

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

Правила составления ТЗ

Разберем правила, которые помогут составить удобное и полезное техзадание.

Точность

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

Детальное описание

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

Пример описания элемента главной страницы из ТЗ по одному из наших проектов:

Оформление

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

На изображении ниже — часть содержания ТЗ по одному из наших проектов. Документ оформлен в Google Docs, навигация по нему реализована через заголовки.

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

Примеры

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

Примеры могут быть и текстовые. Если вам понравился tone of voice какого-либо блога, прикрепите его как пример. Ценными будут и антипримеры в духе «как делать не надо».

Объем

Вас не должен заботить объем технического задания — здесь нет «правильного» количества страниц. Помните: чем подробнее ТЗ, тем лучше.

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

Что включает в себя техническое задание

Сложные термины

Техзадание должно быть понятным для всех участников работы. Профессиональные термины и сокращения нужно раскрыть доступным языком — для этого используйте инфостиль. Составьте из них словарь и вынесите его в начало документа.

Пример описания терминов из ТЗ по одному из наших проектов:

Общие положения

Здесь надо кратко и конкретно рассказать о компании, ее продукте или услуге:

  • название
  • девиз, если есть
  • направление деятельности
  • история компании
  • услуги и/или продукция по категориям
  • УТП
  • достижения компании
  • ссылка на сайт, если есть
  • ссылки на соцсети
  • партнеры
  • конкуренты и их сайты

Назначение и цели создания сайта

Исполнительная команда должна знать ЦА и род деятельности компании, чтобы понимать, для кого и зачем они разрабатывают сайт.

Цели создания сайта:

  • продвижение услуг и/или продукции
  • привлечение новых клиентов
  • повышение лояльности
  • повышение среднего чека
  • информирование о проведении акций
  • формирование базы клиентов
  • другое

Сценарий использования сайта

Все действия пользователя на сайте должны приводить к поставленным целям — именно им подчиняется функционал всех разделов.

Основные целевые действия пользователя на сайте:

  1. Совершить покупку
  2. Оставить заявку на звонок/выезд специалиста
  3. Подписаться на рассылку
  4. Связаться с менеджером
  5. Запросить каталог товаров

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

  1. Какое действие клиент совершает на сайте?
  2. Какой ответ сайт дает на это действие?
  3. Какой конечный результат всей цепочки?

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

Пример описания сценариев функции «Поиск» из ТЗ по одному из наших проектов:

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

Требования к сайту и к хостингу

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

Структура сайта

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

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

Примеры основных разделов:

  • главная;
  • о компании;
  • кейсы;
  • каталог;
  • контакты;

Помимо разделов в структуре сайта надо отметить сквозные элементы: название, лого, поиск, номер телефона.

Языковые версии сайта

Если продукты, услуги или материалы на сайте будут предназначены для разных стран, то и адаптировать их придется под языки этих стран. Это важная информация для разработчиков, ведь им придется использовать разные URL и задавать атрибуты hreflang. 

Это позволит отображать при поиске сразу нужную версию страницы и не даст поисковой системе подумать, что версии сайта — это дубли контента, что плохо скажется на SEO.

Описание прототипов каждой уникальной страницы

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

Например, так выглядит прототип страницы, который мы создали для сайта курорта «Яровое».

Навигация по сайту

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

Навигация бывает нескольких видов:

  1. Основная. Ссылки из основного меню или с главной страницы.
  2. Глобальная. Линки, доступные с любой страницы.
  3. Языковая. Переключает языковые версии сайта.
  4. Рекламная. Кликабельные рекламные блоки.
  5. Тематическая. Ссылки на страницы с похожей тематикой.
  6. Поисковая. Ввод информации в строку поиска.

Выбор вида навигации зависит от функциональности и сценариев использования будущего сайта. Но главным остается ее удобство — надо продумать шаги пользователей, чтобы сделать путь от задачи до решения максимально простым и коротким. 

Несколько вариантов улучшения навигации по сайту:

  • лаконичный дизайн меню
  • ссылка на логотипе на главную страницу
  • фиксированное меню
  • контрастная полоса загрузки страницы
  • контрастное выделение предпочтительных кнопок
  • кнопка «Наверх»

Пример навигации по разделам на сайте «Ярового»:

Функциональность сайта

В техническом задании необходимо прописать все функциональные элементы, которые будут на сайте. Иначе может возникнуть ситуация, что компания ждет писем от пользователей, а форму обратной связи на сайт не поместили. Все функции должны создаваться на основе сценариев поведения пользователей.

Что может понадобиться на сайте:

  • корзина
  • форма обратной связи
  • каталог продукции
  • фильтр
  • поиск
  • избранное

Технические требования

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

  • под какие устройства надо оптимизировать сайт
  • в каких браузерах сайт будет открываться
  • скорость загрузки сайта
  • на каком сервере делать сайт
  • какие будут разграничения доступа к сайту

Пример технического требования из ТЗ по одному из наших проектов:

Чем вредит неверно составленное ТЗ?

Очевидный минус непроработанного ТЗ — постоянные правки и доработки во время проекта. За этим следует:

  • увеличение времени на разработку
  • траты сверх бюджета
  • сайт, который не соответствует ожиданиям

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

  1. Никаких дедлайнов. Нужно указывать сроки разработки, чтобы у команды и заказчика было понимание о том, как двигается проект и когда он будет завершен.
  2. Потерянные данные доступа. У клиента обязательно должны остаться данные для доступа на сайт. Они пригодятся, если на сайте что-то пойдет не так.
  3. «Пусть разработчик разберется». Каким бы прокачанным не был специалист, лучше не отдавать ему создание проекта «на свой вкус» — клиенту может просто не понравиться результат. Лучше обсуждать все заранее.

Вывод 

Составлять техническое задание перед работой необходимо. Это основа, «скелет» будущего сайта и инструкция для разработчиков. Не имеет значения объем ТЗ, важны детали, их однозначность и точность.

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

Оцените пост:
7
Не очень

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

Читать весь блог
Разработка удобного личного кабинета: рекомендации и примеры

Как разработать удобный личный кабинет для сайта: рекомендации и примеры

В этой статье мы расскажем, как создать личный кабинет, который не будет раздражать клиентов, а наоборот, поможет им легко оформить заказ или получить услугу.

17 сентября 2021
Разработка сайта-визитки курорт «Яровое» для туристов

Курорт «Яровое» — сайт-визитка для туристов

Создание сайта для российского курорта «Яровое» в Алтайском крае