Представим, что вы планируете разработать большой проект: сайт, блог или приложение. Чего вы боитесь как заказчик? Что подрядчик пообещает золотые горы, возьмёт деньги, но не сделает, что вы хотели.
А как подрядчик? Что в начале работы вас попросят сделать одно, а в процессе — всё переделать (причём раз десять), в итоге вы потратите кучу времени и уйдёте в минус. Проект большой, поэтому надо принять меры. И поможет в этом спецификация (в простонародье — спека).
Что такое спецификация?
Спецификация — это документ с набором требований, которым должен соответствовать разрабатываемый продукт. Весомый плюс этого документа — в экономии времени при разработке и гарантия спокойствия при согласовании.
Спека похожа на список продуктов перед походом в магазин. Запишите и структурируйте всё, чтобы не забыть «купить». Это, по сути, договор между вами и заказчиком, который регулирует объём будущих выполненных работ
.
Подготовку спецификации можно разделить на пять шагов.
Закрытая или открытая?
Открытая спецификация описывает требования к исполнению, но не указывает, как эти требования должны быть достигнуты. Такой формат удобен исполнителю: он свободен в выборе инструментов и в процессе может менять подходы.
Закрытая спецификация описывает не только способы достижения требований, но и инструменты/технологии, которые нужны при создании продукта. У закрытой спецификации больше плюсов для заказчика: весь процесс разработки становится прозрачным и более контролируемым.
Содержание
По структуре спецификация похожа на дипломную работу: элементы вроде содержания, введения или списка источников точно напомнят о студенческих временах.
С содержанием всё просто — укажите примерный план задач от заказчика, который надо сделать. А чтобы понять, как это сделать, созвонитесь со специалистами и добавьте их комментарии к плану
Разделы
Спецификация должна быть понятной, чтобы любой открывший её сразу понял, что и как нужно делать. Ниже приведу обязательные разделы, которые понадобятся при описании любого проекта. Если нужно, их можно пополнить подразделами.
1. Введение
1.1 Обзор: цель спецификации.
1.2 Объём проекта: краткое описание проекта.
1.3 Глоссарий: расшифровка терминов.
1.4 Ссылки: список источников.
1.5 Обзор продукта: краткое описание каждого раздела
Функциональные и нефункциональные требования
Это основная и самая подробная часть спецификации. Ей нужно уделить особое внимание. Функциональные требования — то, как должна вести себя система, чтобы удовлетворить ожидания пользователя.
Если функциональные требования определяют, что делает система, нефункциональные требования описывают, как она это делает. Это либо свойства, которые система должна демонстрировать, либо ограничения, которые она должна соблюдать. Например, сайт не должен загружаться более 3 секунд.
Согласование
Для начала поставьте себя на место заказчика и прочитайте спецификацию его глазами. Скорректируйте текст, если нашли слабые или непонятные места.
Далее отдайте спеку заказчику на первую оценку. Возможно, согласование займёт несколько итераций, но это неотъемлемая часть работы.
Заключение
Спецификация может показаться сложным документом, но без неё будет намного сложнее в самой разработке.