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

Разделите путь на проверяемые операции

  1. Клиент помогает заполнить поля и сохраняет введённое при ошибке.
  2. Сервер проверяет обязательные поля, формат, длины и ограничения запроса.
  3. Заявка сохраняется в основном хранилище.
  4. Создаётся событие или задача доставки в CRM и каналы уведомления.
  5. Результат доставки записывается отдельно и при необходимости повторяется.

Если сохранение зависит от доступности SMTP или внешнего API, временный отказ поставщика способен заблокировать весь сценарий. После записи можно отделить уведомление от ответа. Но задача в памяти процесса не равна надёжной очереди: при завершении процесса она может исчезнуть.

Определите границы успеха

Сообщение «Заявка принята» должно означать понятное проверяемое событие - например, успешную запись. Сообщение «Отправлено в CRM» требует подтверждения соответствующего API. Для важных обращений рассмотрите transactional outbox: запись заявки и события выполняются в одной транзакции, а обработчик отправляет событие отдельно.

Продумайте повтор ещё до первого сбоя

Пользователь может нажать кнопку дважды, сеть - оборвать ответ, а интеграция - прислать webhook повторно. Блокировка кнопки удобна, но не защищает сервер от повторов. Для операции создают идентификатор, сохраняют результат обработки и определяют срок, в течение которого повтор относится к той же операции.

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

Проверьте отказы на изолированном стенде

  • Неверные данные: запись не создаётся, текст формы остаётся.
  • Ошибка базы: форма не показывает принятую заявку.
  • Ошибка уведомления после записи: заявка существует, доставка имеет отдельный статус.
  • Два запроса с одним идентификатором: результат соответствует принятой политике.
  • Таймаут и повтор: не предполагаем, что первая операция автоматически отменена.
  • Перезапуск обработчика: невыполненное событие не теряется, если выбрана постоянная очередь.

Для внешних API ограничьте время ожидания и частоту повторов. Постоянная ошибка авторизации не исправляется бесконечным повтором: нужны сигнал и проверка настройки. В production-аудите Webappmaster была обнаружена SMTP EAUTH; поэтому без отдельного теста нельзя было заявить, что письма доставляются.

Наблюдаемость без лишних данных

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

Если проекту нужны роли и обработка заявок, начните с разработки веб-приложения. Пользовательскую часть проверьте по чек-листу интерфейса.

Первоисточники

Idempotent в MDN и HTTP Semantics, RFC 9110. Идемпотентность бизнес-операции требует реализации в приложении; название HTTP-метода не решает весь сценарий формы.

Вопросы по теме

Означает ли сообщение «успешно» доставку письма?
Зависит от контракта формы. Если сначала сохранена заявка, а уведомление отправляется отдельно, успех может означать только сохранение. Доставку письма подтверждают отдельно.
Почему заявка может продублироваться после таймаута?
Первый запрос мог выполнить запись на сервере, хотя клиент не получил ответ. Повтор без идентификатора операции может создать вторую запись.