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