ШАБЛОН

Шаблон технического задания (SOW) на разработку ПО

ТЗ на разработку ПО с критериями приёмки пользовательских историй, определением готовности, окружениями разработки, staging и продакшена, вехами спринтов и уровнями серьёзности ошибок.

Обновлено

Начать бесплатно в COLO

Это не юридическая консультация. Шаблоны предоставляются «как есть», без каких-либо гарантий — адаптируйте шаблон под свою ситуацию и покажите его квалифицированному специалисту в вашей юрисдикции, прежде чем полагаться на него. Условия использования

Текст статьи

Проект по разработке ПО — движущаяся цель. Клиент видит первый работающий экран и тут же предлагает три новые идеи, 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 и проблемы, вызванные изменениями, внесёнными другими, обычно исключаются.

Частые вопросы

Чем техническое задание на разработку ПО отличается от других SOW?

Объём ПО меняется по мере использования, поэтому в SOW нужны критерии приёмки для каждой функции, определение готовности, названные окружения, шкала серьёзности ошибок и чёткое правило того, как новые истории попадают в бэклог. Количества страниц и списка результатов недостаточно.

Что выбрать для SOW на ПО: фиксированную цену или оплату по фактическим затратам?

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

Как написать критерии приёмки для пользовательской истории?

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

Кому принадлежит код по окончании проекта?

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

Какой гарантийный срок обычен для заказного ПО?

Многие фриланс-разработчики предлагают 30–90 дней исправления дефектов относительно принятых критериев. Новые требования, изменения сторонних API и проблемы, вызванные изменениями, внесёнными другими, обычно исключаются.

Хватит переписывать один и тот же документ

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

Начать бесплатно в COLO Сравнить тарифы