Версия источника: 93129dd470a134cabdf15a353da6633362f2b0fe
Синхронизировано: 2026-11-19T04:53:50.014Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/93129dd470a134cabdf15a353da6633362f2b0fe

<a id="integrations-delivery-evidence"></a>

# Подтверждение заявки и внешнего эффекта

## Коротко

Проверяйте отдельно сохранение обращения, запись в очередь, приём провайдером и достижимый конечный результат. Один ID связывает вывод пользователя, запись и внешний эффект.

## Плохо

```text
Форма вернула 200, значит менеджер получил.
Задание в очереди назвали доставленным.
При тайм-ауте создали вторую заявку.
```

## Хорошо

```text
Видна сохранённая заявка L-02.
Доставку подтверждает ID события у провайдера.
Показан статус именно проверенного шага.
Повтор относится к L-02.
```

## Почему

Интерфейс, локальная база, отправитель и получатель подтверждают разные стадии. Провайдер может принять сообщение после исчезновения ответа. Без стабильного ключа и сверки повтор создаёт лишние действия.

## Когда применять

При приёмке форм, чатов, расчётов, заявок, уведомлений и CRM. Проверки внешнего эффекта выполняются в согласованном тестовом контуре или у разрешённого получателя.

### Требования

- Фиксируйте идентификатор операции, запись источника, исходный контекст и время. Пользователь видит результат сохранения и честный статус доставки. Например, «Заявка принята» при подтверждённой записи, «Уведомление ожидает отправки» по очереди.
- Согласуйте обязательные поля с получателем. Передайте ID каталога, услуги, акции, варианта, даты или источника там, где меняется обработка. Сверяйте как сохранённую запись, так и то, что видит менеджер.
- Свяжите стадии по ID операции, корреляции и внешней квитанции. Учитывайте, что подтверждение приёма провайдером может не подтверждать прочтение или доставку до человека.
- При неизвестном результате сверьте запись или квитанцию. Повтор использует прежний ключ или отдельно подтверждённое новое действие. Журнал сохраняет попытки, результат и причину отказа.
- При переносе опишите переключение входящих и исходящих каналов, исполнителей очереди, назначение секретов и тестовые адреса. Проверьте, что старый и новый обработчики не создают дубли.
- Проверяйте событие сквозным тестом, включая медленную сеть, ошибку валидации, отказ получателя, недоступную интеграцию, возврат и повторную попытку.

## Пример применения

Из страницы акции отправляют тестовую заявку. В админке видны текст, ID акции и URL, а тестовый получатель показывает запись с тем же ID. На стенде без исходящего канала результат отмечается как проверка сохранения.

## Как проверить

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

## Человек

Утверждает поля, адресатов, правила повтора и тестовые условия.

## Агент

Агент проверяет путь по фактическим записям, корреляции и квитанции провайдера.

## Источники

- [OpenTelemetry — трассы сообщений](https://opentelemetry.io/docs/specs/semconv/messaging/messaging-spans/)
- [RFC 9110 — повторы запросов](https://www.rfc-editor.org/rfc/rfc9110.html#section-9.2.2)

Уровень: Обязательно. Опубликовано: 2026-11-19. Проверено: 2026-11-19. Изменено: 2026-11-19.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/93129dd470a134cabdf15a353da6633362f2b0fe/registry/standards/integrations/external/rules/delivery-evidence.md)
