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>
47 lines
2.5 KiB
Markdown
47 lines
2.5 KiB
Markdown
# 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
|