Files
mtusi2026lab5/openspec/changes/async-attachments/specs/idempotency/spec.md
T
2026-10-31 04:06:09 +03:00

3.4 KiB

Spec Delta

MODIFIED Requirements

Requirement: Повтор возвращает исходный результат

Повтор от того же пользователя в тот же чат с тем же ключом и тем же телом в пределах срока ключа SHALL возвращать 201 и тот же Message: тот же id, text, attachment_ids и created_at до микросекунды. Новое сообщение MUST NOT создаваться. Тела SHALL сравниваться по смыслу, после разбора JSON. На результат не влияют:

  • запись пробелов и экранирование символов;
  • порядок полей объекта;
  • отсутствующий attachment_ids вместо [];
  • регистр букв в идентификаторах вложений.

Порядок элементов attachment_ids значим: это порядок вложений в сообщении. Ключ, сохранённый версией сервиса без вложений, SHALL повторяться тем же телом и после замены реплик на версию с вложениями.

Повтор MUST NOT зависеть от текущего состояния вложений сообщения: вложение, ставшее failed после отправки, не меняет ответ на повтор.

Scenario: Повтор того же тела

  • WHEN Алиса отправляет текст T с ключом K и повторяет тот же запрос
  • THEN оба ответа 201 с одинаковым JSON, а в истории чата одно сообщение с текстом T

Scenario: Тот же JSON в другой записи

  • WHEN повтор с ключом K несёт то же тело в другой записи: с другими пробелами и с текстом в экранировании \uXXXX
  • THEN ответ 201 с тем же Message, новое сообщение не создано

Scenario: Вложения по умолчанию

  • WHEN Алиса отправила {"text": T} с ключом K и повторяет с K тело {"attachment_ids": [], "text": T}
  • THEN ответ 201 с тем же Message, новое сообщение не создано

Scenario: Повтор сообщения с вложениями

  • WHEN Алиса отправила текст с attachment_ids [A, B] и ключом K, затем повторяет с K то же тело, а потом то же тело с A и B в верхнем регистре
  • THEN оба ответа 201 с тем же Message и attachment_ids [A, B], в истории одно такое сообщение

Scenario: Повтор после failed вложения

  • WHEN Алиса отправила с ключом K сообщение с вложением в queued, вложение стало failed, и она повторяет с K то же тело, а затем с другим ключом
  • THEN повтор с K — 201 с тем же Message, отправка с другим ключом — 409 conflict, а в истории одно такое сообщение