Files
mtusi2026lab3/evidence/idempotency/replay.md
T
ricoromaandClaude Opus 5.5 c5840bfaa8 docs: add idempotency and X-Instance-Id evidence to the report
- evidence for replay, conflict, replay through a new API process and
  after restarting API and storages, keys table, key race,
  X-Instance-Id in responses and logs, explicit and invalid
  instance_id and key TTL, test runs
- stand evidence: make wipe_data leaves the lab 2 volume intact, build
  from a fresh git clone passes smoke, bench restore stage sends with
  Idempotency-Key
- REPORT.md: X-Instance-Id, idempotency design, IDEMPOTENCY_TTL_SECONDS
  mapping, limitations and evidence rows
- tasks.md: mark the change tasks done, add follow-ups from verify

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 17:08:47 +03:00

3.4 KiB
Raw Blame History

Повтор, конфликт и неверный ключ через HTTP

Спеки idempotency «Повтор того же тела», «Тот же JSON в другой записи», «Другой текст», «Нет ключа», «Неверный ключ», «Посторонний с чужим ключом», «Другой пользователь»; api-conventions «Instance id в успешном ответе и ошибке»
Change instance-id-idempotency, задача 9.1
Дата 2026-10-08 16:44:53 UTC
Commit af4bca0
Стенд make run_docker: проект mtusi-lab3, postgres, valkey, migrate, один контейнер api (образ mtusi-messenger:lab3 из af4bca0), 127.0.0.1:8080, без балансировщика
Хост Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7,7 GiB RAM; лимиты контейнерам не задавались
Клиент разовый stdlib-скрипт; пароли и токены синтетические и в файл не попадают; ключ K — синтетический evidence-8ee385da82b54c1a8faf2ab3da763230

alice и bob — участники чата, eve — посторонний. Все запросы — POST /api/v1/chats/{chat_id}/messages с Authorization: Bearer.

Шаг Запрос Статус X-Instance-Id Время Проверка
отправка alice, ключ K, Привет из evidence 201 7956d7741a15 7,1 мс
повтор то же тело, тот же K 201 7956d7741a15 4,8 мс JSON совпал целиком: да
повтор то же тело в записи {"text": "П…"} (пробел, \u-экранирование) 201 7956d7741a15 4,2 мс JSON совпал целиком: да
другое тело тот же K, другое 409 7956d7741a15 5,4 мс conflict: Idempotency key was already used with another request
без ключа валидное тело 400 7956d7741a15 3,5 мс header.Idempotency-Key: Field required
неверный ключ Idempotency-Key: a b 400 7956d7741a15 2,7 мс header.Idempotency-Key: String should match pattern '^[A-Za-z0-9._:-]+$' — значение ключа в ответ не попало
посторонний eve, тот же K и тело 404 7956d7741a15 2,6 мс not_found: доступ проверяется и при повторе
другой пользователь bob, тот же K, от Боба 201 7956d7741a15 4,2 мс новое сообщение: область ключа — пользователь и чат

Ответ первой отправки и обоих повторов:

{"id": "090a896a-dc91-4010-8332-3f6d3d97f858", "chat_id": "4b84e4e3-4a26-40d7-89a5-632d19bbbc31", "sender_id": "536d7a14-d489-45b9-b3e3-0f92822b3d62", "text": "Привет из evidence", "created_at": "2026-10-08T16:44:53.810923Z"}

История чата после всех шагов (bob читает): ["Привет из evidence", "от Боба"] — повторы, 409, 400 и 404 сообщений не создали.

Все ответы, включая ошибки, несут X-Instance-Id = 7956d7741a15 — короткий ID контейнера api (docker compose ps -q api).