Files
mtusi2026lab3/openspec/changes/replicas-lb/specs/idempotency/spec.md
T
ricoromaandClaude Opus 5.5 8e15e02898 docs: propose replicas-lb change
HAProxy as the single entry point, API replicas without published
ports, resource limits and per-service secrets, restart and stop-one
hooks, replica tests in student-tests.

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

2.5 KiB

Spec Delta

MODIFIED Requirements

Requirement: Одновременные повторы

Одновременные запросы с одним ключом и одним телом, в том числе через разные процессы API, SHALL создавать ровно одно сообщение. Все ответы SHALL быть 201 с одним и тем же Message.

Scenario: Гонка одного ключа

  • WHEN 10 клиентов по отдельным соединениям одновременно отправляют одно тело с одним ключом
  • THEN все ответы 201 с одинаковым id, а в истории чата ровно одно такое сообщение

Scenario: Гонка одного ключа через реплики

  • WHEN 10 клиентов по отдельным соединениям одновременно отправляют одно тело с одним ключом через балансировщик, и среди ответов есть два пересекающихся по времени запроса, которые обслужили реплики с разными X-Instance-Id
  • THEN все ответы 201 с одинаковым Message, а в истории чата ровно одно такое сообщение

Requirement: Ключ хранится вне процесса API

Ключи и их результаты SHALL храниться в PostgreSQL вместе с сообщениями. Они SHALL переживать рестарт API и хранилищ с сохранёнными volumes. Повтор через другой процесс API SHALL давать тот же результат, что и через исходный.

Scenario: Повтор после рестарта API

  • WHEN сообщение отправлено с ключом K, и процесс API перезапущен
  • THEN повтор с K и тем же телом даёт 201 с тем же Message

Scenario: Повтор через другую реплику

  • WHEN сообщение отправлено с ключом K через балансировщик, а повтор с K и тем же телом обслужила реплика с другим X-Instance-Id
  • THEN повтор даёт 201 с тем же Message, а другое тело с K на любой реплике — 409