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

Что описать в техническом задании до старта разработки, чтобы на приемке не услышать «мы не это имели в виду»: 10 разделов, примеры «плохо / хорошо» и шаблон ТЗ.

Ожидание = результат: размытые требования к системе и те же требования в цифрах, которые можно проверить

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

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

В статье разберем:

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

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

Белый кот и три вопроса к техническому заданию: «А роли прописали?», «А критерии приемки?», «По каким метрикам измерять?»

Содержание

  1. Почему результат разработки не совпадает с ожиданиями
  2. ТЗ и бизнес-постановка: в чем разница и кто что пишет
  3. Что описать до старта: 10 обязательных разделов ТЗ
  4. Типичные ошибки в ТЗ: примеры «плохо» и «хорошо»
  5. Как избежать споров при приемке
  6. Шаблон технического задания на разработку ПО
  7. Когда стоит привлечь бизнес-аналитика
  8. В двух словах
  9. Часто задаваемые вопросы

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

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

Вот что чаще всего стоит за фразой «не то, что хотели»:

  • Размытые требования. «Удобный интерфейс» и «быстрая работа» каждый понимает по-своему. Проверить такое требование нельзя.
  • Одни слова — разный смысл. Для продаж «клиент» — это тот, кто оставил заявку. Для бухгалтерии — тот, с кем подписан договор.
  • Очевидное не записано. Что делать, если платеж не прошел? Кто видит зарплаты сотрудников? Для бизнеса ответы очевидны, для разработчика — нет.
  • Нет критериев приемки. Если заранее не договорились, по каким признакам работа считается выполненной, на приемке не на что опереться. Каждая сторона может оценивать результат по-своему.
  • Не зафиксированы границы. Заказчик ждет мобильную версию, а подрядчик оценивал только веб. Оба уверены, что правы.
  • Цель оторвана от функций. Команда честно делает список функций, но не знает, какую бизнес-задачу они решают. В итоге все работает, а процесс быстрее не стал.
Что думает руководитель Что записано Что сделали
Отчет по продажам с разбивкой по регионам и менеджерам «Система формирует отчеты» Выгрузку всех сделок
Статус заявки обновляется сразу «Интеграция с учетной системой» Обмен раз в сутки ночью
Менеджер видит только своих клиентов Ничего Каждый видит всю базу

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

ТЗ и бизнес-постановка: в чем разница и кто что пишет

Техническое задание — это документ, в котором заказчик и исполнитель фиксируют, что именно должно получиться и как это проверить. Но на практике под «ТЗ» понимают два разных уровня описания, и путаница между ними — одна из причин споров.

Бизнес-постановка (ее еще называют бизнес-функциональными требованиями, или БФТ) отвечает на вопрос «что и зачем нужно бизнесу».

Техническое задание отвечает на вопрос «как это будет реализовано в системе».

Бизнес-постановка (БФТ) Техническое задание
Отвечает на вопрос Что нужно и зачем Как это реализовать
Язык Язык бизнеса: процессы, роли, метрики Язык системы: экраны, данные, интеграции
Кто готовит Заказчик с бизнес-аналитиком Системный аналитик с архитектором
Кто читает Руководители, владельцы процессов Разработчики, тестировщики
Детализация Достаточная, чтобы оценить и принять решение Достаточная, чтобы написать код и тесты

Кто пишет ТЗ: заказчик или разработчик

Если коротко: пишут вместе, но у каждого своя зона ответственности.

Роль За что отвечает
Руководитель продукта или направления Цели, приоритеты, границы бюджета, финальное согласование и приемка
Бизнес-аналитик Интервью с пользователями, описание процессов, бизнес-требования
Системный аналитик Перевод бизнес-требований в технические: данные, интеграции, логика
Разработчики и тестировщики Оценка, проверка реализуемости, вопросы к неясным местам

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

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

Hello We Hire — AI-платформа для подбора персонала

Решили взять аналитика в штат? Hello We Hire берет на себя первичный отбор: над вакансией одновременно работают несколько рекрутеров, а AI сверяет опыт кандидатов с требованиями, проверяет ответы на профессиональные вопросы и 15-минутное видеоинтервью.

Платформа может проанализировать 300+ откликов на одну вакансию, а заказчику передает 5 % самых подходящих кандидатов. Оплата привязана к результату подбора.

Узнать больше о Hello We Hire

Что описать до старта: 10 обязательных разделов ТЗ

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

1. Цели и метрики успеха

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

2. Пользователи и роли

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

3. Бизнес-процессы «как есть» и «как должно быть»

Как процесс устроен сейчас (AS IS), где в нем теряются время и деньги и как он должен выглядеть после внедрения (TO BE). Достаточно схемы из десятка шагов с ответственными, например в Business Process Model and Notation (BPMN) — нотации для описания бизнес-процессов в виде схем.

Именно с разбора процессов начинается цифровизация процессов в КПР: сначала находим точки для автоматизации, потом проектируем решение.

Бизнес- и системный анализ, цифровизация бизнес-процессов

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

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

Обсудить задачу

4. Функциональные требования

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

5. Нефункциональные требования

Как система работает: скорость, нагрузка, надежность, безопасность.

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

Внедрение и сопровождение банковских систем Диасофт и ЦФТ

Работаем с продуктами ЦФТ и Диасофт и знаем АБС изнутри. Перевели банк с Диасофт на ЦФТ без остановки операций, с учетом требований Банка России. Автоматизировали сверку отчетности по РСБУ и МСФО 9.

Наша AML-модель нашла 24 950 подозрительных операций там, где финмониторинг вручную нашел 1 500.

Обсудить задачу

6. Интеграции и данные

С какими системами нужен обмен, каким способом (например, через API или файлами), какие данные передаются, в какую сторону и как часто. Кто владеет каждой системой и даст доступ.

7. Ограничения и допущения

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

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

При этом система работает с данными около 5 млн налогоплательщиков и 50 млн налоговых документов в год.

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

Finum.NDFL — автоматизация налогового учета в банках

Годовая отчетность НДФЛ по всем налогоплательщикам банка из ТОП-5 формируется за 3 часа.

Finum.NDFL собирает доходы клиентов и сотрудников из 25+ банковских систем и источников, рассчитывает налог по главе 23 НК РФ, находит расхождения до отправки и формирует 6-НДФЛ. В промышленной эксплуатации система обслуживает 5 млн налогоплательщиков и обрабатывает 50 млн документов в год.

Стек: Java, Spring Boot, PostgreSQL. Сопровождать может ваша команда, без привязки к вендору.

Узнать больше о Finum.NDFL

8. Приоритеты

Не все требования одинаково важны. Проще всего расставить приоритеты по методу MoSCoW:

  • Must — без этого запуск не имеет смысла;
  • Should — важно, но можно запуститься без этого;
  • Could — хорошо бы, если останутся время и бюджет;
  • Won’t — сознательно откладываем на потом.

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

9. Критерии приемки

Как именно вы проверите, что требование выполнено. Удобный формат — «дано — когда — тогда»:

  • Дано: у клиента есть просроченная задолженность более 30 дней;
  • Когда: менеджер создает новую заявку;
  • Тогда: система показывает предупреждение и не дает отправить заявку без согласования руководителя.

10. Что не входит в объем работ

Например: мобильное приложение, миграция архива за 10 лет, английская версия интерфейса.

  • Цели и измеримые метрики успеха
  • Пользователи, роли и права доступа
  • Процессы AS IS и TO BE
  • Функциональные требования в формате «кто — что — зачем»
  • Нефункциональные требования с цифрами
  • Интеграции: с кем, что, как часто
  • Ограничения и допущения
  • Приоритеты по MoSCoW
  • Критерии приемки по каждому ключевому требованию
  • Список того, что не входит в объем

Типичные ошибки в ТЗ: примеры «плохо» и «хорошо»

Плохое требование легко узнать: прочитайте его и спросите себя, как именно тестировщик проверит его выполнение. Если ответ «по ощущениям», требование нужно переписать.

Плохо Хорошо
Система должна быстро работать Список заказов открывается не дольше 2 секунд при 500 одновременных пользователях
Удобный поиск клиентов Поиск по ФИО, ИНН и номеру телефона, подсказки после третьего символа
Интеграция с 1С Из 1С в систему каждые 15 минут передаются остатки по складам, в обратную сторону — подтвержденные заказы
Нужны отчеты Руководитель отдела раз в неделю получает отчет по воронке с разбивкой по менеджерам
Система должна быть безопасной Вход через корпоративный SSO, журнал действий пользователей хранится 1 год
Как в старой системе, только лучше Список сценариев старой системы, которые нужно сохранить, и тех, которые меняются

Есть и ошибки другого рода — не в формулировках, а в подходе:

  • ТЗ на сто страниц, которое никто не читает. Объем не равен качеству. Документ, в котором трудно найти нужное, работает так же плохо, как ТЗ с размытыми формулировками.
  • Форма вместо содержания. Все разделы ГОСТа на месте, но в них общие слова, скопированные из прошлого проекта.
  • Требования без приоритетов. Если важно все, значит, ничего не важно.
  • ТЗ пишет один человек за всех. Если с пользователями никто не поговорил, в документе окажется то, как процесс выглядит в глазах одного сотрудника, а не то, как он работает на самом деле.

Узнали свой проект? Аналитики КПР помогут описать задачу так, чтобы результат совпал с ожиданиями. Пришлите текущую постановку — подскажем, где в ней риски.

Обсудить задачу

Как избежать споров при приемке

Причина споров при приемке почти всегда кроется в начале проекта: о чем-то не договорились или поняли по-разному. Как их избежать:

  • Договоритесь о критериях приемки до старта. Не на демонстрации, а в момент согласования ТЗ. В КПР это часть старта любого проекта: вместе с заказчиком согласуем состав результата, роли сторон и критерии приемки еще до начала разработки.
  • Составьте глоссарий. 20–30 ключевых терминов с одним согласованным значением. Так «клиент», «сделка» и «закрытие периода» будут означать одно и то же для бизнеса и для разработки. Для старта пригодится и глоссарий ИТ-терминов КПР.
  • Показывайте, а не только пишите. Прототип экрана за один день выявит больше расхождений, чем неделя чтения текста. Наглядный пример помогает договориться быстрее.
  • Опишите сценарии проверки. Пошаговые истории: что делает пользователь и что должен увидеть. По ним тестировщики проводят функциональное тестирование, а вы принимаете работу.
  • Зафиксируйте порядок изменений. Требования меняются — это нормально. Важно, чтобы каждое изменение проходило через запрос на изменение с переоценкой сроков, а не через сообщение в мессенджере. Что еще прописать в договоре, мы разобрали в статье о выборе ИТ-подрядчика и моделях оплаты.
  • Принимайте по частям. Например, через промежуточные демонстрации результата раз в две недели. Как прописать поэтапную приемку, лимит правок и SLA в договоре, мы разобрали в статье «5 шагов приемки и 3 метрики SLA».

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

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

Техническое задание: [название проекта]

  1. Общие сведения и границы проекта. Назначение системы, цели со ссылкой на бизнес-постановку, что входит в работу и что не входит.
  2. Роли и права доступа. Кто работает с системой и что каждая роль может смотреть, менять и удалять. Удобнее всего свести это в одну таблицу.
  3. Сценарии использования. Пошаговые действия пользователя и ответы системы: основной путь, отклонения, ошибки и бизнес-правила.
  4. Данные. Какие объекты хранит система, из каких полей они состоят, откуда берутся данные, какие у объектов статусы и сколько хранятся данные.
  5. Интерфейс. Перечень экранов: для кого каждый, что на нем видно и что можно сделать. К экранам прикладываются ссылки на согласованные макеты.
  6. Интеграции. С какими системами идет обмен, какие данные и в какую сторону передаются, как часто и в каком формате, что делать при сбое и кто дает доступ.
  7. Требования к работе системы. Скорость, нагрузка, доступность, резервное копирование и безопасность. Каждое требование — в цифрах и со способом проверки.
  8. Инфраструктура и перенос данных. Где размещается система, какие технологии обязательны, какие нужны среды, кому принадлежит исходный код и как переносятся старые данные.
  9. Испытания и приемка. Тестовые сценарии в формате «дано — когда — тогда», уровни серьезности дефектов, кто принимает работу и в какой срок дает замечания.
  10. Этапы, документация и поддержка. Что заказчик получает на каждом этапе и что от него нужно. Какие инструкции готовятся, как проходит обучение, на каких условиях поддержка после запуска.

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

Скачайте полную версию шаблона в Word. В ней есть вопросы-подсказки к каждому разделу, примеры заполнения и типичные ошибки, а в конце — чек-лист проверки перед отправкой документа подрядчику.

Скачать шаблон

Когда стоит привлечь бизнес-аналитика

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

  • В процессе участвуют несколько подразделений, и у каждого свои интересы.
  • Нужны интеграции с учетными системами или внешними сервисами.
  • Есть требования регулятора или службы безопасности.
  • В команде нет своего аналитика, и ТЗ досталось руководителю «по остаточному принципу».
  • Прошлый проект уже закончился спорами при приемке.
  • Подрядчики дают оценки, которые отличаются в разы. Это верный знак, что задачу все поняли по-разному.

Что дает этап анализа

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

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

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

Как это устроено в КПР

В рамках услуги «Бизнес- и системный анализ, цифровизация процессов» мы разбираемся, как устроены процессы и системы, находим точки для автоматизации и проектируем, как все должно работать. На выходе — понятная основа для разработки: от требований до технической документации. Старт обычно выглядит так:

  1. Контекст. Фиксируем бизнес-задачу, ограничения, сроки и текущий ИТ-контур.
  2. Экспертиза. Подключаем профильного аналитика, архитектора или руководителя практики.
  3. Формат. Предлагаем проект, отдельный этап обследования или выделенную команду.
  4. Следующий шаг. Согласуем состав результата, роли сторон и критерии приемки.

После анализа документы можно передать своей команде или другому подрядчику. Можно и продолжить с КПР: мы берем на себя разработку и сопровождение информационных систем или подключаем аналитиков к вашей команде в формате ИТ-аутсорсинга. Как выбрать между своей командой и внешней, мы разобрали в статье «Аутсорсинг разработки или своя IT-команда».

Поможем описать задачу

Техническое задание на разработку ПО: в двух словах

  • Результат разработки определяется еще до старта. Если задачу описали так, что ее можно понять по-разному, разработчик с высокой вероятностью сделает не то, что ждали.
  • Хорошее ТЗ — понятное, а не объемное. Каждое требование в нем можно проверить: вместо «быстро» — «за 2 секунды», вместо «удобно» — конкретные действия пользователя.
  • Критерии приемки и границы проекта нужно согласовать заранее. Если до старта договориться, по каким признакам работа считается выполненной и что в нее не входит, на приемке будет не о чем спорить.
  • Когда в проекте много участников, интеграций или требований регулятора, лучше привлечь аналитика. Это дешевле, чем переделывать готовую систему.

Часто задаваемые вопросы

Кто должен писать ТЗ: заказчик или исполнитель?

Оба. Заказчик отвечает за цели, приоритеты и критерии приемки. Аналитик — свой или подрядчика — переводит их в требования, а разработчики проверяют их на реализуемость. Подписывают документ обе стороны.

Чем ТЗ отличается от бизнес-требований (БФТ)?

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

Нужно ли ТЗ, если команда работает по Agile?

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

Можно ли менять ТЗ после старта разработки?

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

Обязательно ли оформлять ТЗ по ГОСТ?

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

Сколько времени занимает подготовка ТЗ?

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

Как проверить, что ТЗ написано хорошо?

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

Выбираете модель разработки?

Обсудим
ваш проект

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