diff --git a/openspec/changes/carry-over-lab3-review-fixes/.openspec.yaml b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/.openspec.yaml similarity index 58% rename from openspec/changes/carry-over-lab3-review-fixes/.openspec.yaml rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/.openspec.yaml index 4bfa6709..7756d6b7 100644 --- a/openspec/changes/carry-over-lab3-review-fixes/.openspec.yaml +++ b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/.openspec.yaml @@ -1,2 +1,4 @@ schema: spec-driven created: 2026-10-30 +archived: 2026-10-30 +lab: 4 diff --git a/openspec/changes/carry-over-lab3-review-fixes/design.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/design.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/design.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/design.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/proposal.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/proposal.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/proposal.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/proposal.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab1-event-publication/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-event-publication/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab1-event-publication/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-event-publication/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab1-messenger-chats/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-messenger-chats/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab1-messenger-chats/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-messenger-chats/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab1-messenger-history/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-messenger-history/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab1-messenger-history/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-messenger-history/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab1-service-operability/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-service-operability/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab1-service-operability/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab1-service-operability/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab2-session-cache/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab2-session-cache/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab2-session-cache/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab2-session-cache/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab3-failover-operations/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-failover-operations/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab3-failover-operations/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-failover-operations/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab3-idempotent-messages/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-idempotent-messages/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab3-idempotent-messages/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-idempotent-messages/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/specs/lab3-load-balancing/spec.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-load-balancing/spec.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/specs/lab3-load-balancing/spec.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/specs/lab3-load-balancing/spec.md diff --git a/openspec/changes/carry-over-lab3-review-fixes/tasks.md b/openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/tasks.md similarity index 100% rename from openspec/changes/carry-over-lab3-review-fixes/tasks.md rename to openspec/changes/archive/2026-10-30-carry-over-lab3-review-fixes/tasks.md diff --git a/openspec/specs/lab1-event-publication/spec.md b/openspec/specs/lab1-event-publication/spec.md index 9834e309..a738b2de 100644 --- a/openspec/specs/lab1-event-publication/spec.md +++ b/openspec/specs/lab1-event-publication/spec.md @@ -1,7 +1,7 @@ # lab1-event-publication Specification ## Purpose -Определяет, как зоны предметной области узнают о произошедшем, не вызывая друг друга напрямую: модель регистрирует факт, шина разводит его по обработчикам. Транспорт доставки заменяем, и его отказ не влияет на обязательный путь данных. +Определяет, как побочные эффекты операции (журнал аудита) выполняются вне её границы согласованности: модель регистрирует факт, шина разводит его по обработчикам. Транспорт доставки заменяем, и его отказ не влияет на обязательный путь данных. Зоны предметной области друг друга не вызывают и не импортируют; их связь — схема БД и порты, которые собирает `main.py`. ## Requirements ### Requirement: Побочные эффекты выполняются через события @@ -62,9 +62,28 @@ - **THEN** его тело содержит идентификаторы сообщения, чата и отправителя и отметку времени - **AND** не содержит текста сообщения -### Requirement: Доменные зоны связаны только событиями +### Requirement: Публикация событий не требует брокера -Зона «чаты и сообщения» SHALL NOT вызывать зону «пользователи» и импортировать её модули, кроме объявления события о регистрации. Существование участника SHALL проверяться внешним ключом схемы БД в той же транзакции, что и запись чата; SQL каждой зоны SHALL читать только таблицы своей зоны. +Публикация событий SHALL выполняться через порт, реализованный внутренней очередью в памяти процесса. Доставка событий SHALL NOT зависеть от внешнего брокера. Из сетевых сервисов путь чтения и записи пользователей, чатов и сообщений SHALL зависеть только от PostgreSQL; загрузка и скачивание байтов вложения SHALL требовать ещё S3 (см. `lab4-object-storage`), а подтверждение отзыва сессии при включённом кэше сессий — Valkey (см. `lab2-session-cache`). + +#### Scenario: События доставляются без брокера + +- **WHEN** стенд поднят без брокера сообщений +- **THEN** весь обязательный API работает, а события доставляются внутренней очередью + +#### Scenario: Публикация скрыта за портом + +- **WHEN** проверяется слой приложения +- **THEN** он обращается к публикации только через порт и не знает её реализации + +#### Scenario: Остановленный Valkey не останавливает чтение и запись + +- **WHEN** при включённом кэше сессий Valkey остановлен +- **THEN** регистрация, вход, чтение и запись чатов и сообщений работают через PostgreSQL, вложения — через PostgreSQL и S3, а только `DELETE /api/v1/auth/sessions/current` отвечает `503` + +### Requirement: Доменные зоны не вызывают друг друга; связь — схема БД и порты сборки + +Зона «чаты и сообщения» SHALL NOT вызывать зону «пользователи» и SHALL NOT импортировать ни одного её модуля, включая объявления событий; зона «пользователи» SHALL NOT импортировать модулей зоны «чаты и сообщения». Зона «вложения» и остальные зоны SHALL NOT импортировать модулей друг друга. Связь зон — схема БД и порты зоны-потребителя, адаптеры которых собирает только `main.py`: существование участника SHALL проверяться внешним ключом схемы в той же транзакции, что и запись чата, принадлежность вложения чату — внешним ключом в той же команде, что и запись сообщения, а членство для зоны «вложения» — портом `ChatMembership`; SQL каждой зоны SHALL читать только таблицы своей зоны. События SHALL оставаться механизмом побочных эффектов внутри зоны и журнала, а не каналом связи зон. #### Scenario: Регистрация видна чатам сразу @@ -81,22 +100,8 @@ - **WHEN** проверяется список зависимостей модулей зоны «пользователи» - **THEN** среди них нет ни одного модуля зоны «чаты и сообщения» -#### Scenario: Обратная связь идёт только через контракт события +#### Scenario: Зона чатов не импортирует зону пользователей - **WHEN** проверяется список зависимостей модулей зоны «чаты и сообщения» -- **THEN** единственная заимствованная у зоны «пользователи» единица — объявление события о регистрации, а SQL зоны не упоминает таблиц `users` и `sessions` - -### Requirement: Публикация событий не требует брокера - -Публикация событий SHALL выполняться через порт, реализованный внутренней очередью в памяти процесса. Доставка событий SHALL NOT зависеть от внешнего брокера; из сетевых сервисов обязательный API зависит только от PostgreSQL. - -#### Scenario: События доставляются без брокера - -- **WHEN** стенд поднят без брокера сообщений -- **THEN** весь обязательный API работает, а события доставляются внутренней очередью - -#### Scenario: Публикация скрыта за портом - -- **WHEN** проверяется слой приложения -- **THEN** он обращается к публикации только через порт и не знает её реализации +- **THEN** среди них нет ни одного модуля зоны «пользователи», а SQL зоны не упоминает таблиц `users` и `sessions` diff --git a/openspec/specs/lab1-messenger-chats/spec.md b/openspec/specs/lab1-messenger-chats/spec.md index 595d35ce..b5418e8f 100644 --- a/openspec/specs/lab1-messenger-chats/spec.md +++ b/openspec/specs/lab1-messenger-chats/spec.md @@ -58,9 +58,14 @@ - **WHEN** `chat_id` в пути не является UUID - **THEN** ответ `400` с кодом `invalid_request` +#### Scenario: Посторонний не ждёт блокировок чужого чата + +- **WHEN** участник держит открытую транзакцию отправки сообщения в чат, а посторонний в это время отправляет `POST /api/v1/chats/{chat_id}/messages` с `Idempotency-Key` в тот же чат +- **THEN** посторонний сразу получает `404` с кодом `not_found`, не дожидаясь завершения транзакции участника + ### Requirement: Список чатов пользователя -Сервис SHALL отдавать по `GET /api/v1/chats` страницу `{"items":[...],"next_cursor":...}` с чатами, в которых состоит вызывающий, упорядоченными по `(created_at, id)` по возрастанию. Параметр `limit` SHALL быть целым в диапазоне 1–100 со значением по умолчанию 50. Список SHALL NOT содержать чатов, недоступных вызывающему. +Сервис SHALL отдавать по `GET /api/v1/chats` страницу `{"items":[...],"next_cursor":...}` с чатами, в которых состоит вызывающий, упорядоченными по `(created_at, id)` по возрастанию. Параметр `limit` SHALL быть целым в диапазоне 1–100 со значением по умолчанию 50. Список SHALL NOT содержать чатов, недоступных вызывающему. Переданный `cursor` SHALL быть непустым ранее выданным сервером курсором списка, иначе ответ SHALL быть `400`. #### Scenario: Участник видит свой чат @@ -83,3 +88,8 @@ - **THEN** страницы идут в порядке `(created_at, id)` по возрастанию, ни один чат не повторяется и не пропускается - **AND** `next_cursor` последней страницы равен `null` +#### Scenario: Испорченный или пустой курсор списка + +- **WHEN** запрос `GET /api/v1/chats` содержит `cursor=` с пустым значением или строку, которую сервер не выдавал +- **THEN** ответ `400` с кодом `invalid_request` + diff --git a/openspec/specs/lab1-messenger-history/spec.md b/openspec/specs/lab1-messenger-history/spec.md index f49594d8..41cfbd89 100644 --- a/openspec/specs/lab1-messenger-history/spec.md +++ b/openspec/specs/lab1-messenger-history/spec.md @@ -87,7 +87,7 @@ ### Requirement: Чтение истории keyset-курсором -Сервис SHALL отдавать по `GET /api/v1/chats/{chat_id}/messages` страницу `{"items":[...],"next_cursor":...}`. Каждый элемент SHALL содержать `attachment_ids` в порядке отправки. Параметр `limit` SHALL быть целым в диапазоне 1–100 со значением по умолчанию 50. `next_cursor` SHALL быть непрозрачной для клиента строкой либо `null`, если на момент чтения следующей записи нет. Курсор SHALL быть привязан к чату: курсор, выданный для другого чата, SHALL приводить к `400`. Обход неизменной истории SHALL NOT повторять и SHALL NOT пропускать записи; `limit` разрешается менять между страницами. +Сервис SHALL отдавать по `GET /api/v1/chats/{chat_id}/messages` страницу `{"items":[...],"next_cursor":...}`. Каждый элемент SHALL содержать `attachment_ids` в порядке отправки. Параметр `limit` SHALL быть целым в диапазоне 1–100 со значением по умолчанию 50. `next_cursor` SHALL быть непрозрачной для клиента строкой либо `null`, если на момент чтения следующей записи нет. Курсор SHALL быть привязан к чату: курсор, выданный для другого чата, SHALL приводить к `400`. Переданный параметр `cursor` SHALL быть непустым: пустое значение SHALL приводить к `400`, а не к первой странице. Обход неизменной истории SHALL NOT повторять и SHALL NOT пропускать записи; `limit` разрешается менять между страницами. #### Scenario: Первая страница отдаёт курсор @@ -120,6 +120,11 @@ - **WHEN** значение `cursor` не является ранее выданным сервером курсором - **THEN** ответ `400` с кодом `invalid_request` +#### Scenario: Пустой курсор + +- **WHEN** запрос истории содержит `cursor=` с пустым значением +- **THEN** ответ `400` с кодом `invalid_request` + #### Scenario: Limit вне допустимого диапазона - **WHEN** запрос содержит `limit=0` или `limit=101` diff --git a/openspec/specs/lab1-service-operability/spec.md b/openspec/specs/lab1-service-operability/spec.md index 1aed9489..a8fd2c4b 100644 --- a/openspec/specs/lab1-service-operability/spec.md +++ b/openspec/specs/lab1-service-operability/spec.md @@ -79,7 +79,7 @@ ### Requirement: Корректное завершение по сигналу -По получении `SIGTERM` сервис SHALL сначала выйти из ротации: на время окна `DRAIN_SECONDS` (по умолчанию 2 с, больше максимального времени обнаружения балансировщиком) `/health/ready` SHALL отвечать `503 unavailable`, а принятые и новые запросы SHALL обслуживаться как обычно. После окна сервис SHALL перестать принимать новые соединения, дождаться завершения принятых запросов и завершить процесс; весь срок, включая окно, SHALL укладываться в `SHUTDOWN_TIMEOUT_SECONDS` (по умолчанию 5 с), который меньше таймаута хука остановки, `stop_grace_period` контейнера и 10 секунд, чтобы контейнер не убивался по таймауту. Процесс сервера SHALL быть основным процессом контейнера и SHALL получать сигналы напрямую. +По получении `SIGTERM` сервис SHALL сначала выйти из ротации: на время окна `DRAIN_SECONDS` (по умолчанию 2 с, больше максимального времени обнаружения балансировщиком) `/health/ready` SHALL отвечать `503 unavailable`, а принятые и новые запросы SHALL обслуживаться как обычно. После окна сервис SHALL перестать принимать новые соединения, дождаться завершения принятых запросов и завершить процесс; весь срок, включая окно, SHALL укладываться в `SHUTDOWN_TIMEOUT_SECONDS` (по умолчанию 6 с), который меньше таймаута хука остановки, `stop_grace_period` контейнера и 10 секунд, чтобы контейнер не убивался по таймауту. Собственный срок ожидания принятых запросов SHALL заканчиваться раньше, чем мастер процесса или контейнер останавливает сервер принудительно, чтобы зависший запрос прерывал сам сервер ответом `503 unavailable` в общем формате ошибки с заголовками `X-Request-Id` и `X-Instance-Id`, а не `SIGKILL`, и SHALL быть не меньше суммы таймаутов ожидания соединения с БД и оператора. Процесс сервера SHALL быть основным процессом контейнера и SHALL получать сигналы напрямую. #### Scenario: Остановка укладывается в срок @@ -97,6 +97,12 @@ - **WHEN** `SIGTERM` приходит во время обработки принятого запроса - **THEN** этот запрос получает ответ до завершения процесса +#### Scenario: Зависший запрос не приводит к SIGKILL + +- **WHEN** во время `SIGTERM` принятый запрос не завершается за собственный срок ожидания сервера (например, клиент так и не дослал тело) +- **THEN** сервер прерывает его сам ответом `503` с кодом `unavailable` в общем формате ошибки (`Content-Type: application/json`, `request_id` равен `X-Request-Id`) и с непустыми `X-Request-Id` и `X-Instance-Id`, а не ответом `500` без заголовков контракта +- **AND** процесс завершается с кодом `0` раньше `SHUTDOWN_TIMEOUT_SECONDS` + ### Requirement: Логи без содержимого сообщений Сервис SHALL писать в stdout/stderr структурированную запись на каждый запрос с методом, шаблоном маршрута, кодом ответа, длительностью и `X-Request-Id`. Логи SHALL NOT содержать текста сообщений, `display_name`, паролей, токенов сессий, значений заголовка `Authorization`, строк подключения к хранилищам и тел запросов. @@ -173,3 +179,22 @@ - **WHEN** запись журнала формируется с полем, отсутствующим в перечне разрешённых - **THEN** это поле в выводе отсутствует +### Requirement: Предел размера тела запроса + +Сервис SHALL ограничивать размер тела запроса настраиваемым пределом маршрута (по умолчанию 1 MiB; у загрузки вложения — `MAX_UPLOAD_BYTES`, см. `lab4-attachments`) и SHALL отвечать `413` с кодом `payload_too_large` в общем формате ошибки, если тело больше предела. Предел SHALL применяться к фактически принятым байтам независимо от способа передачи: и к телу с заголовком `Content-Length`, и к телу `Transfer-Encoding: chunked`. Сервис SHALL NOT дочитывать тело сверх предела. + +#### Scenario: Объявленная длина больше предела + +- **WHEN** приходит запрос с `Content-Length` больше предела +- **THEN** ответ `413` с кодом `payload_too_large` до чтения тела + +#### Scenario: Chunked-тело больше предела + +- **WHEN** тело передано `Transfer-Encoding: chunked` без `Content-Length` и его размер превышает предел +- **THEN** ответ `413` с кодом `payload_too_large`, а не `400` и не `500` + +#### Scenario: Тело в пределах лимита + +- **WHEN** `chunked`-тело меньше предела +- **THEN** запрос обрабатывается штатно + diff --git a/openspec/specs/lab2-session-cache/spec.md b/openspec/specs/lab2-session-cache/spec.md index 700479c7..a7fcb996 100644 --- a/openspec/specs/lab2-session-cache/spec.md +++ b/openspec/specs/lab2-session-cache/spec.md @@ -19,7 +19,7 @@ ### Requirement: Выход инвалидирует кэш -Отзыв сессии SHALL записывать в кэш отметку отзыва на оставшийся срок сессии до удаления строки в БД, а заполнение кэша после промаха SHALL выполняться только при отсутствии ключа. Отозванный токен SHALL получать `401` и при гонке «чтение заполнило кэш после выхода». Если отметку отзыва записать нельзя, выход SHALL отвечать `503` и SHALL NOT удалять сессию. +Отзыв сессии SHALL записывать в кэш отметку отзыва на оставшийся срок сессии до удаления строки в БД, а заполнение кэша после промаха SHALL выполняться только при отсутствии ключа. Отозванный токен SHALL получать `401` и при гонке «чтение заполнило кэш после выхода». Если отметку отзыва записать нельзя, выход SHALL отвечать `503` и SHALL NOT удалять сессию. Если после записи отметки удалить сессию в PostgreSQL не удалось, выход SHALL отвечать `503` и SHALL снимать отметку отзыва: ответ `503` означает, что сессия осталась действующей и в БД, и для проверки токена. #### Scenario: Отозванный токен не оживает из кэша @@ -31,6 +31,12 @@ - **WHEN** Valkey остановлен и пользователь выполняет `DELETE /api/v1/auth/sessions/current` - **THEN** ответ `503` с кодом `unavailable`, а после запуска Valkey повторный выход отвечает `204` +#### Scenario: Выход при сбое PostgreSQL + +- **WHEN** отметка отзыва записана, но удаление сессии в PostgreSQL завершилось ошибкой +- **THEN** выход отвечает `503` с кодом `unavailable`, токен по-прежнему получает `200`, отметки отзыва в кэше нет +- **AND** после возвращения PostgreSQL повторный выход отвечает `204`, а токен затем получает `401` + ### Requirement: Недоступный кэш обходится, но не открывает доступ При ошибке или таймауте Valkey проверка сессии SHALL выполняться по PostgreSQL за ограниченное время, а повторные попытки обращения к кэшу SHALL приостанавливаться на короткий интервал. Недействительный токен SHALL получать `401`; запрос SHALL NOT приниматься как анонимный. Недоступность Valkey SHALL NOT переводить `/health/ready` в `503`. diff --git a/openspec/specs/lab3-failover-operations/spec.md b/openspec/specs/lab3-failover-operations/spec.md index c1d5a4fa..8312558e 100644 --- a/openspec/specs/lab3-failover-operations/spec.md +++ b/openspec/specs/lab3-failover-operations/spec.md @@ -15,7 +15,7 @@ #### Scenario: Обнаружение измерено по каждому виду отказа - **WHEN** выполняется `make detection` -- **THEN** для `SIGTERM` через `scripts/stop-one.sh`, `docker kill`, `docker pause` и остановки PostgreSQL в `evidence/detection/*.json` записаны время обнаружения, заявленный максимум и время возврата в ротацию, и каждое время обнаружения не больше заявленного максимума +- **THEN** три прогона подряд для `SIGTERM`, `docker kill`, `docker pause` и остановки PostgreSQL записывают в `evidence/detection/run/*.json` время обнаружения, заявленный максимум и время возврата в ротацию, и каждое время обнаружения не больше заявленного максимума плюс допуск замера 0,25 с (запуск docker CLI до сигнала и опрос статистики LB раз в 50 мс); в отчёте приводится диапазон трёх прогонов #### Scenario: Остановка по сигналу не теряет запросы @@ -34,12 +34,12 @@ ### Requirement: Поочерёдный отказ под нагрузкой -Оператор SHALL одной командой останавливать каждую реплику по очереди под открытой нагрузкой (постоянная интенсивность запросов, 80 % отправок сообщений и 20 % чтений истории) и возвращать её до остановки следующей. Для каждой реплики SHALL фиксироваться интенсивность и доля ошибок нагрузки, задержки p50/p95/p99, время обнаружения, время возврата в ротацию, ошибки и время восстановления записи зонда, повторяющего неудачную запись с тем же ключом, и счётчики повторов и перенаправлений балансировщика. +Оператор SHALL одной командой останавливать каждую реплику по очереди под открытой нагрузкой (постоянная интенсивность запросов, 80 % отправок сообщений и 20 % чтений истории) и возвращать её до остановки следующей. Для каждой реплики SHALL фиксироваться состояние реплик после остановки (`docker ps -a`), интенсивность и доля ошибок нагрузки, задержки p50/p95/p99, время обнаружения, время возврата в ротацию, ошибки и время восстановления записи зонда, повторяющего неудачную запись с тем же ключом, и счётчики повторов и перенаправлений балансировщика. #### Scenario: Каждая реплика по очереди - **WHEN** выполняется `make failover-each` -- **THEN** `evidence/failover-each/summary.json` содержит запись на каждую реплику; в каждой хук завершился кодом 0, доля ошибок нагрузки не больше 1 %, запись восстановилась не позже 10 с, пока реплика была исключена, её `X-Instance-Id` не встречался, а после возврата она снова обслуживает запросы +- **THEN** `evidence/failover-each/summary.json` содержит запись на каждую реплику; в каждой хук завершился кодом 0, доля ошибок нагрузки не больше 1 %, запись восстановилась не позже 10 с, пока реплика была исключена, её `X-Instance-Id` не встречался, а после возврата она снова обслуживает запросы; в `evidence/failover-each//action.txt` после хука записан `docker ps -a` реплик, где остановлена именно эта реплика ### Requirement: Общая идемпотентность под параллельными запросами diff --git a/openspec/specs/lab3-idempotent-messages/spec.md b/openspec/specs/lab3-idempotent-messages/spec.md index 0982b9cd..0aabacb3 100644 --- a/openspec/specs/lab3-idempotent-messages/spec.md +++ b/openspec/specs/lab3-idempotent-messages/spec.md @@ -89,3 +89,32 @@ - **WHEN** во время `make test-failover` запрос не получил ответа и повторён с тем же ключом и текстом - **THEN** в истории нет дублей по `id` и `text`, а каждый подтверждённый ответ совпадает с записью истории байт-в-байт +#### Scenario: Потерянный ответ на живой реплике + +- **WHEN** запрос `POST /api/v1/chats/{chat_id}/messages` с ключом ждёт блокировку строки чата дольше таймаута клиента, клиент не получает ответа и после снятия блокировки повторяет запрос с тем же ключом и текстом через LB +- **THEN** реплика, принявшая первую попытку, фиксирует сообщение и отвечает `201` уже без клиента, повтор получает `201` с тем же `Message`, а в истории чата ровно одно такое сообщение + +#### Scenario: Потерянный ответ на убитой реплике + +- **WHEN** реплику, чей запрос с ключом ждёт блокировку строки чата, убивают (`docker kill`) и после снятия блокировки клиент повторяет запрос с тем же ключом и текстом через LB +- **THEN** повтор обслуживает другая реплика и отвечает `201`, а в истории чата ровно одно такое сообщение с тем же `id`, что в ответе на повтор, — независимо от того, успела ли зафиксироваться первая попытка + +### Requirement: Порядок проверок отправки сообщения + +`POST /api/v1/chats/{chat_id}/messages` SHALL проверять запрос в таком порядке: сессия (`401`), форма запроса — заголовок `Idempotency-Key`, malformed JSON, лишние поля и типы, включая элемент `attachment_ids` не в формате UUID (`400 invalid_request`), доступ к чату (`404 not_found`), затем текст и список вложений — пустой без вложений или пробельный текст, больше 10 или повторяющиеся `attachment_ids` (`400 invalid_request`), затем принадлежность вложений чату (`404 not_found`). Ответ постороннему SHALL NOT раскрывать, существует ли чат: `400` по форме запроса отдаётся без обращения к чату и одинаков для существующего и несуществующего чата, а ошибка текста или списка вложений постороннему SHALL быть `404`. + +#### Scenario: Посторонний без ключа + +- **WHEN** аутентифицированный посторонний отправляет в существующий чат запрос без `Idempotency-Key` +- **THEN** ответ `400` с кодом `invalid_request`, такой же, как для несуществующего чата + +#### Scenario: Посторонний с невалидным текстом или списком вложений + +- **WHEN** посторонний отправляет с корректным ключом текст из пробелов или 11 вложений +- **THEN** ответ `404` с кодом `not_found`, а не `400` + +#### Scenario: Участник с невалидным текстом + +- **WHEN** участник отправляет с корректным ключом текст из пробелов +- **THEN** ответ `400` с кодом `invalid_request`, ключ не занят + diff --git a/openspec/specs/lab3-load-balancing/spec.md b/openspec/specs/lab3-load-balancing/spec.md index f5852c69..cfc0a1d4 100644 --- a/openspec/specs/lab3-load-balancing/spec.md +++ b/openspec/specs/lab3-load-balancing/spec.md @@ -11,6 +11,7 @@ - **WHEN** выполняется `make up`, затем `docker compose ps` - **THEN** работают ≥2 контейнера сервиса `api` в состоянии `healthy`, у них нет опубликованных портов, а единственные опубликованные порты принадлежат сервису `lb` +- **AND** к завершению `make up` статистика балансировщика показывает `UP` у всех запущенных реплик, поэтому следующая команда (например, `make test-failover`) сразу видит ≥2 `X-Instance-Id` #### Scenario: Реплика недоступна в обход балансировщика