Files
mtusi2026lab4/openspec/changes/attachments/specs/idempotency/spec.md
T
2026-10-20 23:44:50 +03:00

3.8 KiB

Spec Delta

MODIFIED Requirements

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

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

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

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

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], в истории одно такое сообщение

Requirement: Другое тело с тем же ключом

Если ключ в своей области уже использован с другим телом и срок не истёк, сервис SHALL отвечать 409 conflict. Новое сообщение MUST NOT создаваться, сохранённый результат ключа MUST NOT меняться. Другие вложения или их другой порядок — другое тело.

Scenario: Другой текст

  • WHEN Алиса отправила T1 с ключом K, затем отправляет T2 с тем же ключом в тот же чат
  • THEN второй ответ 409 conflict, в истории только T1, а повтор T1 с K по-прежнему возвращает исходный Message

Scenario: Другие вложения

  • WHEN Алиса отправила текст с attachment_ids [A, B] и ключом K, затем шлёт с K тот же текст с [B, A], а потом без вложений
  • THEN оба ответа 409 conflict, в истории одно сообщение с [A, B]