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

47 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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