Техническое задание и техническое решение

Перед созданием концепции

Основное содержание концепции:

Определить цели. Зачем мы создаем сайт и какие результаты (в цифрах – посещаемость, продажи, звонки) от него ожидаем.
Определить задачи. Что нужно сделать, чтобы достичь указанных выше целей.
Определить целевую аудиторию и действия. Здесь речь идет о регионе, в котором вы работаете, секторе экономики и о том, чего ждете от посетителей на сайте (чтобы оформил заказ, позвонил, написал). Действия нужно определить, чтобы их можно было посчитать в системах аналитики.
Изучить статистику спроса в поисковиках на ваши услуги/продукцию. То, как ищут вас люди, станет основой структуры (списка страниц и разделов) вашего сайта.
Кроме того, объем спроса (популярность) покажет, чему на сайте нужно уделить больше внимания, а чему меньше. К примеру, если отзывы о вашей продукции ищут всего 50 человек в месяц, то хватит для них одной странички, а если их ищет несколько тысяч – имеет смысл создать полноценный раздел, где для каждого отзывы своя страница.
Собрать все материалы для сайта – поймем, чего не хватает и сможем ли подготовить эту информацию для передачи разработчикам. Если нет, корректируем структуру и содержание типовых страниц.
Еще один важный момент, почему информация должна быть готова до создания дизайна. Разработчик почти никогда не представляет, какие именно тексты, видео, фото будут на вашем сайте, а потому делает дизайн так, как считает нужным. В итоге под те же отзывы дизайнер отведет места меньше, чем на самом деле требуется, а сам дизайн «развалится».
Отрисовать все типовые страницы сайта (главная, контакты, отзывы, каталог и его разделы, карточка товара и т.п.) и описать принцип их работы и взаимодействия с посетителем.
Изучить конкурентов. Это поможет дополнить структуру или навести на новые мысли об оформлении страниц сайта.

Когда можно без ТР?

Есть некоторые ситуации когда ТР не нужно. С ходу могу назвать 2 условия:

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

Исключение из п.2 — даже в Agile, если есть большая задача (Epic-project), у которой как правило 3-4 стейкхолдера, ее будут делать 2-3 разработчика на 5-6 месяцев, то не помешает сформулировать ТЗ и потом прописать/согласовать ТР. Чтобы убедиться что Стейкхолдеры (Заказчики) и Разработчики (Исполнители) — поняли друг друга.

Зачем составлять ТЗ для сайта?

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

Какие конкретные преимущества даёт обеим сторонам правильно подготовленное ТЗ для сайта? Мы подготовили для вас несколько аргументов в пользу составления тех.задания.

Что даёт ТЗ заказчику?

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

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

Что даёт ТЗ исполнителю?

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

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

Кто составляет ТЗ для сайта?

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

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

Ещё несколько рекомендаций при составлении техзадания по 44-ФЗ

На самом деле, грамотно подготовить описание объекта закупки, техническое задание по 44-ФЗ, без наличия специальных знаний в конкретной области довольно непросто. Некоторые заказчики даже создают закупку на оказание услуг по подготовке техзаданий. Но и самостоятельно это сделать вполне реально, если внимательно изучить требования к объектам закупки, сопоставить со своими потребностями и точно следовать правилам описания объекта закупки по 44-ФЗ.

Нужно иметь в виду, что в маркировке изделий зашифрованы некоторые характеристики. К примеру, техническим заданием предусмотрен материал «плитка тротуарная» с маркировкой «Классико 1КО.4», техзаданием никаких требований к толщине плитки не предъявлено. Согласно расшифровке маркировки, её толщина составляет 4 см. (последняя цифра маркировки указывает на толщину в смантиметрах). Однако, при исполнении контакта выяснилось, что требовалась плитка толщиной 6 см. От толщины плитки зависит нагрузка, которую она может выдержать. Неграмотно составленное техзадание привело к закупке материала, который не удовлетворяет необходимым требованиям. Поэтому нужно тщательно проверить маркировку всех материалов в техническом задании и указать все основные, важные требования к материалам.

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

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

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

Какие ещё требования важно указать в техзадании:

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

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

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

Во многих вакансиях на позицию системного аналитика или технического писателя можно встретить требование: знание ГОСТ 19 и ГОСТ 34. Что это такое?

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

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

ГОСТ

Не пугайтесь, но ГОСТ 19 введён в 1980 году. Учитывая, что основа и парадигма программного обеспечения на протяжении долгого времени примерно та же, он пока не утратил своей актуальности. Это можно сравнить со строительством зданий. Конечно, меняются материалы и конструкции, но общие понятия — фундамент, стены, перекрытия — сохраняются.

Согласно тексту Постановления, согласно которому принят данный стандарт, назначение его следующее: «Устанавливает порядок построения и оформления технического задания на разработку программы или программного изделия для вычислительных машин, комплексов и систем независимо от их назначения и области применения».

Само техническое задание должно содержать следующие пункты:

Введение;
Основания для разработки;
Назначение разработки;
Требования к программе или программному изделию;
Требования к программной документации;
Технико-экономические показатели;
Стадии и этапы разработки;
Порядок контроля и приемки;
Приложения.

Более новый стандарт — ГОСТ 34, но и здесь присутствует нюанс. Новее он только на 10 лет. То есть, введён с 1 января 1990 года.

Формулировка назначения выглядит так: «Распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания…».

Текст технического задания строится по структуре:

Общие сведения;
Назначение и цели создания (развития) системы;
Характеристика объектов автоматизации;
Требования к системе;
Состав и содержание работ по созданию системы;
Порядок контроля и приемки системы;
Требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие;
Требования к документированию;
Источники разработки.

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

ISO/IEC/IEEE 29148

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

Последняя редакция — ISO/IEC/IEEE 29148:2018, но, к сожалению, она отсутствует в открытом доступе, поэтому возьмём за основу предыдущую, от 2011 года.

По аналогии с ГОСТами, стандарт содержит два раздела. Один из них, SyRS — System Requirements Specification — определяет общие требования к построению систем, их принципам и характеру взаимодействия пользователя с ними. По похожей схеме составлен ГОСТ 34.

SRS — Software Requirements Specifitaion — по аналогии с ГОСТ 19, содержит требования к конечному программному продукту.

Общая схема строится следующим образом:

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

ГОСТ в документации заказчика

С 1 июля 2016 года в Закон № 44-ФЗ внесли изменения, направленные на то, чтобы применение ГОСТов и техрегламентов при госзакупках стало общим правилом. Заметьте — именно общим правилом, а не прямой обязанностью.

Дело в том, что согласно новой редакции п. 2 ч. 1 ст. 33 Закона № 44-ФЗ заказчики, с одной стороны, должны использовать ГОСТы при описании объекта закупки, в то время как раньше такой обязанности на них не возлагалось. C другой стороны, в этом пункте так же как и прежде говорится, что если заказчик не пользуется ГОСТами и техрегламентами, то он должен обосновать необходимость использования других показателей. Выходит, что возможность обойтись без ГОСТа при описании объекта закупки у заказчиков как была, так и осталась.

Судите сами, вот сравнение старой и новой редакций п. 2 ч. 1 ст. 33 Закона № 44-ФЗ.

Старая редакция	Новая редакция
использование, если это возможно, при составлении описания объекта закупки стандартных показателей, требований, условных обозначений и терминологии, касающихся технических и качественных характеристик объекта закупки, установленных в соответствии с техническими регламентами, стандартами и иными требованиями, предусмотренными законодательством РФ о техническом регулировании.Если заказчиком при описании объекта закупки не используются такие стандартные показатели, требования, условные обозначения и терминология, в документации о закупке должно содержаться обоснование необходимости использования других показателей, требований, обозначений и терминологии;	использование при составлении описания объекта закупки показателей, требований, условных обозначений и терминологии, касающихся технических характеристик, функциональных характеристик (потребительских свойств) товара, работы, услуги и качественных характеристик объекта закупки, которые предусмотрены техническими регламентами, принятыми в соответствии с законодательством РФ о техническом регулировании, документами, разрабатываемыми и применяемыми в национальной системе стандартизации, принятыми в соответствии с законодательством РФ о стандартизации, иных требований, связанных с определением соответствия поставляемого товара, выполняемой работы, оказываемой услуги потребностям заказчика.Если заказчиком при составлении описания объекта закупки не используются установленные в соответствии с законодательством РФ о техническом регулировании, законодательством РФ о стандартизации показатели, требования, условные обозначения и терминология, в документации о закупке должно содержаться обоснование необходимости использования других показателей, требований, условных обозначений и терминологии;

Старая редакция

Новая редакция

использование, если это возможно, при составлении описания объекта закупки стандартных показателей, требований, условных обозначений и терминологии, касающихся технических и качественных характеристик объекта закупки, установленных в соответствии с техническими регламентами, стандартами и иными требованиями, предусмотренными законодательством РФ о техническом регулировании.Если заказчиком при описании объекта закупки не используются такие стандартные показатели, требования, условные обозначения и терминология, в документации о закупке должно содержаться обоснование необходимости использования других показателей, требований, обозначений и терминологии;

использование при составлении описания объекта закупки показателей, требований, условных обозначений и терминологии, касающихся технических характеристик, функциональных характеристик (потребительских свойств) товара, работы, услуги и качественных характеристик объекта закупки, которые предусмотрены техническими регламентами, принятыми в соответствии с законодательством РФ о техническом регулировании, документами, разрабатываемыми и применяемыми в национальной системе стандартизации, принятыми в соответствии с законодательством РФ о стандартизации, иных требований, связанных с определением соответствия поставляемого товара, выполняемой работы, оказываемой услуги потребностям заказчика.Если заказчиком при составлении описания объекта закупки не используются установленные в соответствии с законодательством РФ о техническом регулировании, законодательством РФ о стандартизации показатели, требования, условные обозначения и терминология, в документации о закупке должно содержаться обоснование необходимости использования других показателей, требований, условных обозначений и терминологии;

Сказанное подтверждается и в комментариях Минэкономразвития России. Так, по мнению Департамента развития контрактной системы министерства, из п. 2 ч. 1 ст. 33 Закона № 44-ФЗ по-прежнему следует, что при формировании технического задания заказчику предоставлены полномочия по самостоятельному определению параметров и характеристик товара, в наибольшей степени удовлетворяющих его потребностям.

По мнению Департамента, при описании объекта закупки заказчику целесообразно указать ссылку на конкретный ГОСТ. При этом указывать недействующий или несуществующий ГОСТ заказчик не вправе (письмо Минэкономразвития от 16.12.2016 № Д28и-3517).

Готовим заявку на участие в тендере с учетом ГОСТов

На вебинаре разберемся с алгоритмом подачи заявки на участие в тендере
Смотреть

В другом письме Департамент добавляет, что указание в документации об электронном аукционе на конкретные ГОСТы без подробного раскрытия в составе такой документации содержания ГОСТ не противоречит положениям Закона № 44-ФЗ. Но тут же делает оговорку: учитывая, что технические условия утверждаются изготовителем продукции, в документацию об электронном аукционе следует включить подробное описание соответствующих условий (письмо Минэкономразвития России от 01.08.2016 № Д28и-2011).

Таким образом, из всего изложенного можно сделать следующие выводы: ссылаться на ГОСТ заказчик:

а) не обязан;

б) вправе;

в) ему это рекомендуется делать;

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

ТЗ и Бритва Оккама

Бритва Оккама в данном случае говорит о том что наиболее простое решение — наиболее верное. Если нет веских причин для усложнения.

Какое самую простую форму ТЗ можно придумать? Ответ — простой список задач (требования, пожеланий). Чаще всего именно эта форма наиболее адекватна.

Иногда она может расширяться некоторыми полезными артефактами (разделами):

Цели — описать не только то что надо сделать, но и для чего мы это делаем? Чтобы что? Это бывает полезно для повышения качества результатов.
Снимки, фото, звуки, примеры — бывает полезно добавить в задание снимок ошибки (например когда мы делаем сайт) или пример/фото того как это сделано у кого-то еще.

Да, если проект реально большой, у вас есть 10-20 человек заинтересованных в результате, ТЗ согласовывается с ними пол года, а потом есть 100-200 человек, которые будут реализовать этот проект — тогда можно взять ГОСТ или сделать какой-то большой документ. Иначе — у вас не хватит ресурсов сделать качественную постановку задачи, а потом те кто будут делать — не осилят изучение. И один лишь контроль приемки работ по такому ТЗ превратится в ад.

ISO/IEC/ IEEE 29148-2011

Стандарт IEEE 29148-2011

1. Назначение системы
2. Содержание системы (границы системы)
3. Обзор системы
- 1. Содержание системы
- 2. Функции системы
- 3. Характеристики пользователей
4. Термины и определения

1. Функциональные требования
2. Требования к юзабилити
3. Требования к производительности
4. Интерфейс (взаимодействие) системы
5. Операции системы
6. Состояния системы
7. Физические характеристики
8. Условия окружения
9. Требования к безопасности
10. Управление информацией
11. Политики и правила
12. Требования к обслуживанию системы на протяжении ее жизненного цикла
13. Требования к упаковке, погрузке-разгрузки, доставке и транспортировке

1. Предположения и зависимости
2. Аббревиатуры и сокращений

1. Назначение
2. Содержание (границы)
- 3. Обзор продукта
- 1. Взаимодействие продукта (с другими продуктами и компонентами)
- 2. Функции продукта (краткое описание)
- 3. Характеристики пользователей
- 4. Ограничения
4. Термины и определения

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

1. Предположения и зависимости
2. Аббревиатуры и сокращений

Состав ТЗ: требования к функциональности

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

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

К функциональной составляющей.
Для параметров безопасности (для автоматических систем и программного обеспечения).
К квалификационному уровню специалистов.
К внешнему виду.
К используемым материалам.

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

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

Для чего нужно техническое задание

Чтобы ставить задачу исполнителям.
Чтобы подробно описать то, что хочется получить в конце.
Чтобы согласовать порядок работ.
Чтобы оценить и принять работу после реализации.
Чтобы…(добавьте свои варианты в комментариях).

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

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

По факту, это серьезный документ, который составляется заказчиком и исполнителем. Вплоть до того, что прописываются неустойки и обязательства сторон. Существует целый ряд ГОСТ-ов, более подробно читайте на Хабре.

Особенности техзадания

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

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

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

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

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

Техническое задание проекта дает четкое описание следующей важной информации:

Обоснование нужды в проведении проекта
Предлагаемая методология управления проектами наряду с планами и графиками деятельности
Ожидаемые потребности в ресурсах
Правила и требования к отчетности.

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

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

Из чего состоит ТЗ

Общая информация

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

Статус текущего документа и конфиденциальность.

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

Цели создания и задачи, которые должен решить ресурс.С одной стороны это довольно короткий раздел, но по важности проработки он занимает первое место. Если цели и задачи поставлены не четко и неизмеримо, то может быть довольно сложно им следовать.

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

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

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

Информационная архитектура и интерфейс

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

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

Не жалейте места. Старайтесь располагать блоки так, чтобы они были отделены друг то друга. Это поможет читабельности карты.
Не мельчите. Прочитать текст, напечатанный 4 кеглем, в принципе можно, но это уже причина для ненависти.
Выравнивайте «квадратики» страниц относительно друг друга, выстраивая в линии. Это улучшит восприятие уровней вложенности страниц.
Не пересекайте линии. Старайтесь избегать большого количества пересечений линий связей. Если они пересекаются, то должны «перескакивать» одна над другой. Кто занимался черчением функциональных схем в университете, меня поймет.
Подписывайте карту. Подпишите саму карту, а также отдельные блоки. Это позволит меньше путаться в дальнейшем.
Почаще сохраняйте файл. Банально, но надо просто помнить об этом. Не стоит лишний раз вспоминать родственников разработчиков программы Visio, в сущности, они ни в чем не виноваты.

Пример карты сайта.Шаблоны страниц

Перечень шаблонов. Выявляются основные типы страниц и описывается их использование.
Типовой шаблон. Основные блоки. Описываются основные блоки страниц с целью уменьшить повторяемость информации.
Описание каждого шаблона согласно перечня. Шаблоны отрисовываются в любом графическом пакете (Adobe Illustrator, Adobe InDesign, MS Visio и др.), а затем дополняются кратким описанием.

ОговоркаПример разворота из ТЗ с описанием шаблона интерфейса (вайрфрейма).Описание контента

Требования

Технические требования к системе;
Требования к персоналу;
Требования к надежности;
Требования к эргономике и технической эстетике;
Требования к защите информации от НСД;
Требования по сохранности информации при авариях;
Требования к видам обеспечения;
Требования к программным средствам;
Требования к информационному обеспечению;
Требования к техническим средствам;

Техническое решение или ТР

А вот та самая часть, которую многие совсем не понимают. Кроме технического задания (в котором может быть просто 3-4 пункта пожеланий на салфетке из кафе), может быть еще техническое решение. Оно чаще всего гораздо важнее чем ТЗ и сильнее влияет на конечный результат.

Техническое решение — пишет как раз Разработчик, где описывает то как он видит решение, что предлагает.

Зачем это нужно? Чтобы исключить разное понимание условий и снизить риски расхождения ожиданий.

Пример для понимания. Заказчик дает ТЗ «Я хочу есть», а Исполнитель предлагает ТР «На вот яблоко». Далее может быть 3 сценария: Заказчик соглашается, корректирует/просит предложить что-то еще или отказывается от дальнейшего общения ?

Чаще всего Заказчик либо принимает решение, либо просит что-то поправить и затем принимает решение.

В сухом остатке.

Общую информацию о документе и его составителях;
Цели и задачи сайта;
Описание пользователей сайта, их цели и задачи;
Рамки проекта;
Информационная архитектура (ИА) сайта: карта сайта, шаблоны, описание интерфейса;
Описание контента сайта;
Описание функционала сайта;
Описание процесса и майлстоунов, если требуется;
Перечень всевозможных требований при разработке сайта и верификации полученной работы.

Полезные ссылки:

ГОСТ 34.602-89.
Нотация Гарретта.

Юрий Шиляевпроектировщик сайтов, консультант.
Директор минского офиса компании Artics Internet Solutions.yuri.shilyaev.com/archives/2007/03/21/356/chto-takoe-%c2%abhoroshee%c2%bb-tz-na-sayt.html

Для чего нужно техническое задание?

Техническое задание не менее значимо, чем юридический акт, в деле закрепления прав и обязанностей сторон — заказчика и исполнителя.

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

Когда каждая мелочь регламентирована, всё на своих местах, все при своих полномочиях и обязанностях, остаётся мало пространства для нечестного манёвра и недопонимания. Идеально, когда его вообще не остаётся.

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

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

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

Выводы

Плюсы нового подхода:Минусы:

Внесение доработок. На одном из проектов было необходимо ввести статусы товаров. В итоге получилось огромное количество доработок по 2-3 строчки. Нельзя это назвать явным минусом, т.к. полното требований в приоритете, но и идеальным данных подход назвать нельзя.
Сложность восприятия при автоматизации бизнес-процессов. Если взять бизнес-процессы некоторых компаний от момента продажи до получения товара покупателем, не всегда есть возможность (или необходимость на первых этапах) покрыть весь процесс за счет Статики, Динамики и АП, т.к. многие задачи выполняются вручную, обсуждаются с клиентами по телефону и т.д. Это немного усложняет восприятие ТЗ в чистом виде, и требует дополнительного описания процессов.
Стоимость и время разработки. Продавать ТЗ, конечно, стало сложнее, ведь далеко не все при первом контакте с разработкой готовы платить за него 10-20% от проекта при том что многие наши конкуренты берут за него 10-20 тыс. Но подобная работа сполна окупается при реализации, снижая риски проекта и улучшая качество.