Проект по разработке ПО — движущаяся цель. Клиент видит первый работающий экран и тут же предлагает три новые идеи, API, от которого зависит приложение, меняет лимиты запросов, а определение «готово» смещается с каждой демонстрацией. Техническое задание (SOW) на разработку ПО ничего из этого не останавливает, но даёт вам фиксированный способ с этим справляться: функции записываются как пользовательские истории с критериями приёмки, работа идёт нумерованными спринтами, а всё новое попадает в бэклог с ценой, прежде чем попасть в разработку.
Этот шаблон подходит фриланс-разработчикам и небольшим командам, которые создают веб-приложения, внутренние инструменты, бэкенды мобильных приложений и интеграции в рамках договора на разработку программного обеспечения.
Кратко
Шаблон технического задания на разработку ПО охватывает цель продукта, бэклог пользовательских историй с критериями приёмки, определение готовности, окружения разработки, staging и продакшена, вехи спринтов, правила демонстрации и приёмки, шкалу серьёзности ошибок, сведения о репозитории и лицензиях, а также гарантийный срок. Отправьте его до первого спринта. Ключевая практика — писать проверяемые критерии приёмки для каждой истории, потому что именно они решают, когда вам заплатят.
Что внутри
- Обзор продукта — проблема, пользователи и чего должен достичь первый релиз.
- Бэклог и критерии приёмки — пользовательские истории, приоритет и критерии «дано — когда — тогда» для каждой.
- Определение готовности — проверки, которые проходит каждая история перед демонстрацией.
- Окружения — разработка, staging и продакшен: кто размещает каждое и кто может деплоить.
- Спринты и вехи — длина спринта, запланированный объём на спринт и привязанный к каждому платёж.
- Демонстрация и приёмка — как клиент проверяет каждый спринт и окно для сообщения о дефектах.
- Уровни серьёзности ошибок — от критического до низкого, со временем реакции во время разработки и гарантии.
- Репозиторий, лицензии и передача — где находится код, сторонние лицензии и передаваемая документация.
- Управление изменениями — как новые истории оцениваются и заменяют другие.
Когда использовать
Используйте его для любой разработки, где клиент по ходу работы будет взаимодействовать с работающим ПО: MVP, клиентский портал, внутренний дашборд, API мобильного приложения. Он предполагает, что юридические условия находятся в договоре, и охватывает только механику поставки.
Техническое задание на консалтинг рассчитано на консультационные этапы, завершающиеся отчётом, поэтому в нём нет понятий окружений, спринтов или серьёзности ошибок. Для сайта-визитки проще техническое задание на веб-разработку, которое измеряет объём в страницах, а не в историях. Если требования ещё размыты, сначала продайте техническое задание на этап исследования и напишите это ТЗ по его итогам.
Критерии приёмки и окружения на практике
Пишите критерии, которые сможет проверить посторонний. «Пользователи могут сбросить пароль» — это функция, а не критерий. Лучше: дано: зарегистрированный email; когда пользователь запрашивает сброс; тогда в течение пяти минут приходит письмо с одноразовой ссылкой, ссылка истекает через [N] часов, а повторное использование показывает ошибку. Три–шесть критериев на историю — рабочий диапазон.
Определение готовности. Короткий общий чек-лист, применяемый к каждой истории: код прошёл ревью, автотесты проходят, задеплоено на staging, критерии проверены, нет открытых критических или серьёзных ошибок. Он не позволяет истории быть «готовой» на вашем ноутбуке и сломанной на staging.
Три окружения, чёткие правила. Разработка — ваша. Staging повторяет продакшен, и именно там тестирует клиент. Продакшен — рабочая система. Укажите, кто платит за каждое, в чьём облачном аккаунте оно находится и кому разрешено деплоить в продакшен. Многие разработчики деплоят в продакшен только по письменному согласованию после демонстрации спринта.
Данные. Укажите, используются ли на staging реальные данные клиентов, анонимизированные данные или тестовые. Реальные данные на staging — частая проблема конфиденциальности.
Приёмка спринта. После каждой демонстрации у клиента есть фиксированное окно, часто 3–5 рабочих дней, чтобы сообщить о дефектах относительно критериев. После этого спринт считается принятым и наступает срок оплаты счёта по вехе. Новые идеи, высказанные на демонстрации, идут в бэклог, а не в текущий спринт.
Настройте его в рабочем пространстве COLO
Создайте разработку как проект в управлении проектами COLO и добавьте каждую пользовательскую историю как задачу с приоритетом, статусом и исполнителем. Вы можете выбрать, какие задачи клиент видит в клиентском портале, чтобы он следил за прогрессом спринта, не видя внутренних рутинных задач, и использовать чат проекта для обсуждений после демонстрации.
Учитывайте время по каждой истории с помощью таймера. Если бюджет проекта задан по вашей оценке, COLO предупреждает вас на 80% и останавливает оплачиваемые таймеры на 100%, предлагая запросить обновление договора, продолжить как неоплачиваемую работу или поставить на паузу. Так разрастающийся бэклог превращается в разговор о цене, а не в молчаливую неоплаченную работу.
Частые ошибки
- Критерии, написанные после разработки. Если приёмка определяется во время демонстрации, каждая демонстрация превращается в переговоры.
- Продакшен в вашем собственном облачном аккаунте. Переносить его позже долго и рискованно. Начинайте в аккаунте клиента.
- Нет шкалы серьёзности. Без неё опечатку на странице настроек воспринимают как сбой оформления заказа.
- Замена историй без замены оценок. Новая история может заменить старую, только если её оценка вписывается.
- Бессрочная гарантия. «Мы будем исправлять ошибки» без даты окончания становится поддержкой, которую вы не оценили.
Часто задаваемые вопросы
В: Чем техническое задание на разработку ПО отличается от других SOW?
Объём ПО меняется по мере использования, поэтому в SOW нужны критерии приёмки для каждой функции, определение готовности, названные окружения, шкала серьёзности ошибок и чёткое правило того, как новые истории попадают в бэклог. Количества страниц и списка результатов недостаточно.
В: Что выбрать для SOW на ПО: фиксированную цену или оплату по фактическим затратам?
Фиксированная цена подходит для хорошо описанных небольших разработок. Для всего, где есть реальная неопределённость, многие разработчики используют оплату по фактическим затратам с ограниченной оценкой на спринт или этап исследования по фиксированной цене с последующими спринтами по согласованной цене.
В: Как написать критерии приёмки для пользовательской истории?
Используйте наблюдаемые условия, часто в форме «дано — когда — тогда»: дано: пользователь вошёл в систему; когда он отправляет форму без email; тогда он видит ошибку и ничего не сохраняется. Если тестировщик не может это проверить, это не критерий приёмки.
В: Кому принадлежит код по окончании проекта?
Это определяется договором, но в SOW должно быть указано, где находится репозиторий, что он размещён в аккаунте клиента и какие сторонние лицензии и лицензии open source используются. Права на код обычно переходят после финальной оплаты.
В: Какой гарантийный срок обычен для заказного ПО?
Многие фриланс-разработчики предлагают 30–90 дней исправления дефектов относительно принятых критериев. Новые требования, изменения сторонних API и проблемы, вызванные изменениями, внесёнными другими, обычно исключаются.