Начните с наблюдаемой проблемы
Фраза «исправить каталог» не показывает, кто сталкивается с проблемой, на каком шаге и как должен работать исправленный сценарий. Для первого обращения не требуется полное техническое задание. Достаточно описать наблюдаемый факт, желаемое поведение и известные ограничения. Если причина неизвестна, её поиск становится отдельным этапом работы.
Что включить в заявку
| Пункт | Что написать |
|---|---|
| Страница | Точный адрес и место, где возникает проблема. |
| Действие | Последовательность шагов пользователя. |
| Сейчас | Фактическое поведение, включая сообщение об ошибке. |
| Нужно | Ожидаемое поведение для посетителя и сотрудника. |
| Условия | Устройство, браузер, роль пользователя и пример данных без секретов. |
| Ограничения | Что должно сохраниться: адреса, данные, связанные функции и интеграции. |
Пример понятной формулировки
Вместо «переделать форму»: «После заполнения обязательных полей и нажатия „Отправить“ кнопка остаётся активной, подтверждение не появляется. Проблема повторяется на телефоне. Ожидаем понятное сообщение о результате и доставку тестовой заявки в согласованный канал. Текущие поля формы нужно сохранить». Это условный пример описания задачи, а не рассказ о выполненном проекте.
Как согласовать проверяемый результат
- 01
Отделите симптом от предполагаемой причины
Опишите то, что видите. Не требуйте заранее заменить конкретный модуль, если связь между ним и ошибкой не проверена.
- 02
Назовите критерий приёмки
Запишите сценарий: действие пользователя, ожидаемый ответ сайта и место, где должен появиться результат. Так обе стороны смогут проверить изменение одинаково.
- 03
Укажите зависимости
Сообщите о CRM, почте, оплате и других системах, которых касается изменение. Доступы передавайте только согласованным безопасным способом.
- 04
Определите порядок выпуска
Для работающего сайта заранее обсудите тестовую среду, проверку соседних функций и способ вернуться к прежней версии при ошибке.
Что приложить, если материалы уже есть
- Ссылку на действующий сайт и страницу с проблемой.
- Скриншот или запись экрана с воспроизводимым сценарием.
- Документацию по платформе, интеграциям и связанным ограничениям.
- Контакт человека, который принимает результат и отвечает на вопросы по процессу.
Частые вопросы
Нужно ли готовое ТЗ для обращения?
Нет. Для начала достаточно описать задачу и ограничения; состав работ уточняется после знакомства с проектом.
Можно ли оценить всё по скриншоту?
Скриншот показывает проявление проблемы, но не устройство сайта и зависимые функции. При неизвестном коде сначала может понадобиться обследование.
Опишите задачу
Пришлите адрес сайта, текущий и желаемый сценарий, а также доступную документацию.
Обсудить доработку