Что это
Документ, где написано, что именно делаем, что в результате получает заказчик и как проверить, что готово. Без него спор «я думал, это входит» неизбежен.
Как используем
Пишем ТЗ после бесплатного аудита, сроки называем после его утверждения. Тот же документ становится README проекта при сдаче.
Где ТЗ нужно бизнесу
- Вы заказываете сайт, бота или автоматизацию и хотите заранее понимать, что получите и как это проверить.
- Над проектом работают несколько человек, и у каждого своё представление о результате.
- Через год придёт другой разработчик, и ему нужно понять, как всё устроено.
Как мы это используем
- Бесплатный аудит. Разбираем задачу: кто пользуется, какие действия нужны, откуда берутся данные, что уже есть.
- ТЗ. Пишем, что именно делаем, что получает заказчик и по каким критериям проверить готовность. Например, у ботов это описание диалогов и прав ролей: что видит клиент, сотрудник, администратор.
- Сроки — после утверждения. Называем их, когда ТЗ согласовано, а не «на глаз» до него.
- ТЗ становится README. При сдаче тот же документ превращается в README проекта: назначение, функции, стек, установка, переменные окружения, критерии приёмки, известные ограничения. Рядом — CHANGELOG с историей версий.
Критерии приёмки из README — то, по чему проверяют результат. Например, у инструкций по подключению VPN это пять пунктов: страницы открываются без ошибок в консоли, раскрываются на весь экран в Telegram, ссылка ведёт в бота, вёрстка читается на телефоне, шаги совпадают с интерфейсом клиента.
Как составить ТЗ самому
Писать ТЗ заказчику не обязательно: достаточно описать задачу своими словами, а документ мы
составим вместе после аудита. Если хотите прийти подготовленным, мы написали
простую инструкцию по ТЗ на сайт с примерами и шаблоном
в Word. Она подходит и для ботов, и для автоматизации: разделы те же.
Что бывает без ТЗ
- «Я думал, это входит». Заказчик ждёт одно, разработчик сделал другое, и спорить не о чем, потому что ничего не записано.
- Сроки ни о чём. Срок без состава работ — обещание, которое невозможно выполнить или проверить.
- Ограничения выясняются в продакшене. То, что честно записано в «Известных ограничениях», без ТЗ всплывает жалобой клиента.
Когда это не нужно
Для мелкой правки — поменять текст, добавить поле — отдельное ТЗ избыточно: хватит описания задачи в сообщении. ТЗ нужно, когда есть что проверять при сдаче.