Самая неприятная ошибка формы - потерять обращение, которое человек уже написал. Вторая - показать успех там, где запись не сохранилась. Подключение CRM начинается с определения контракта: какие данные принимаем, что считаем завершением и как действуем при повторе запроса.
Разделите путь на проверяемые операции
- Клиент помогает заполнить поля и сохраняет введённое при ошибке.
- Сервер проверяет обязательные поля, формат, длины и ограничения запроса.
- Заявка сохраняется в основном хранилище.
- Создаётся событие или задача доставки в CRM и каналы уведомления.
- Результат доставки записывается отдельно и при необходимости повторяется.
Если сохранение зависит от доступности SMTP или внешнего API, временный отказ поставщика способен заблокировать весь сценарий. После записи можно отделить уведомление от ответа. Но задача в памяти процесса не равна надёжной очереди: при завершении процесса она может исчезнуть.
Определите границы успеха
Сообщение «Заявка принята» должно означать понятное проверяемое событие - например, успешную запись. Сообщение «Отправлено в CRM» требует подтверждения соответствующего API. Для важных обращений рассмотрите transactional outbox: запись заявки и события выполняются в одной транзакции, а обработчик отправляет событие отдельно.
Продумайте повтор ещё до первого сбоя
Пользователь может нажать кнопку дважды, сеть - оборвать ответ, а интеграция - прислать webhook повторно. Блокировка кнопки удобна, но не защищает сервер от повторов. Для операции создают идентификатор, сохраняют результат обработки и определяют срок, в течение которого повтор относится к той же операции.
Нельзя считать любой запрос с тем же email дублем: человек может обратиться с другой задачей. Для одного ключа с изменившимися данными требуется отдельное правило - например, отказ из-за несовпадения. Политику повторов проверяют на сервере и хранилище, а не только в компоненте формы.
Проверьте отказы на изолированном стенде
- Неверные данные: запись не создаётся, текст формы остаётся.
- Ошибка базы: форма не показывает принятую заявку.
- Ошибка уведомления после записи: заявка существует, доставка имеет отдельный статус.
- Два запроса с одним идентификатором: результат соответствует принятой политике.
- Таймаут и повтор: не предполагаем, что первая операция автоматически отменена.
- Перезапуск обработчика: невыполненное событие не теряется, если выбрана постоянная очередь.
Для внешних API ограничьте время ожидания и частоту повторов. Постоянная ошибка авторизации не исправляется бесконечным повтором: нужны сигнал и проверка настройки. В production-аудите Webappmaster была обнаружена SMTP EAUTH; поэтому без отдельного теста нельзя было заявить, что письма доставляются.
Наблюдаемость без лишних данных
Связывайте запись, попытку доставки и ответ внешнего API идентификатором. Для диагностики обычно нужны время, тип операции, статус и код ошибки. Не выводите токены, пароли и полное содержание обращения в обычный журнал. Административный доступ к заявкам и настройкам должен проверяться отдельно.
Если проекту нужны роли и обработка заявок, начните с разработки веб-приложения. Пользовательскую часть проверьте по чек-листу интерфейса.
Первоисточники
Idempotent в MDN и HTTP Semantics, RFC 9110. Идемпотентность бизнес-операции требует реализации в приложении; название HTTP-метода не решает весь сценарий формы.