diff --git a/openspec/changes/close-lab3-second-review-gaps/.openspec.yaml b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/.openspec.yaml similarity index 58% rename from openspec/changes/close-lab3-second-review-gaps/.openspec.yaml rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/.openspec.yaml index 4bfa6709..34e1070a 100644 --- a/openspec/changes/close-lab3-second-review-gaps/.openspec.yaml +++ b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/.openspec.yaml @@ -1,2 +1,4 @@ schema: spec-driven created: 2026-10-30 +archived: 2026-10-30 +lab: 3 diff --git a/openspec/changes/close-lab3-second-review-gaps/design.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/design.md similarity index 100% rename from openspec/changes/close-lab3-second-review-gaps/design.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/design.md diff --git a/openspec/changes/close-lab3-second-review-gaps/proposal.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/proposal.md similarity index 100% rename from openspec/changes/close-lab3-second-review-gaps/proposal.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/proposal.md diff --git a/openspec/changes/close-lab3-second-review-gaps/specs/lab1-service-operability/spec.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab1-service-operability/spec.md similarity index 100% rename from openspec/changes/close-lab3-second-review-gaps/specs/lab1-service-operability/spec.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab1-service-operability/spec.md diff --git a/openspec/changes/close-lab3-second-review-gaps/specs/lab3-idempotent-messages/spec.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab3-idempotent-messages/spec.md similarity index 100% rename from openspec/changes/close-lab3-second-review-gaps/specs/lab3-idempotent-messages/spec.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab3-idempotent-messages/spec.md diff --git a/openspec/changes/close-lab3-second-review-gaps/specs/lab3-load-balancing/spec.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab3-load-balancing/spec.md similarity index 100% rename from openspec/changes/close-lab3-second-review-gaps/specs/lab3-load-balancing/spec.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/specs/lab3-load-balancing/spec.md diff --git a/openspec/changes/close-lab3-second-review-gaps/tasks.md b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/tasks.md similarity index 93% rename from openspec/changes/close-lab3-second-review-gaps/tasks.md rename to openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/tasks.md index 3dc125e9..03849571 100644 --- a/openspec/changes/close-lab3-second-review-gaps/tasks.md +++ b/openspec/changes/archive/2026-10-30-close-lab3-second-review-gaps/tasks.md @@ -22,6 +22,6 @@ ## 4. Доказательства и отчёт -- [ ] 4.1 Уровни «3» и «4» заново на итоговом коде: `checks.txt` (с `git diff --stat upstream/main` контракта и тестов), `student-tests.txt`, стенд, `make retry-check`, `make level4`, чистый clone -- [ ] 4.2 `REPORT.md` и `evidence/README.md` по новым доказательствам; числа отчёта сверены скриптом с `evidence/` -- [ ] 4.3 Проверка группы: `make check`, `make lint`, `make student-test`, `openspec validate --all --strict` +- [x] 4.1 Уровни «3» и «4» заново на итоговом коде: `checks.txt` (с `git diff --stat upstream/main` контракта и тестов), `student-tests.txt`, стенд, `make retry-check`, `make level4`, чистый clone +- [x] 4.2 `REPORT.md` и `evidence/README.md` по новым доказательствам; числа отчёта сверены скриптом с `evidence/` +- [x] 4.3 Проверка группы: `make check`, `make lint`, `make student-test`, `openspec validate --all --strict` diff --git a/openspec/specs/lab1-service-operability/spec.md b/openspec/specs/lab1-service-operability/spec.md index 859ab234..263cf7b2 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` (по умолчанию 6 с), который меньше таймаута хука остановки, `stop_grace_period` контейнера и 10 секунд, чтобы контейнер не убивался по таймауту. Собственный срок ожидания принятых запросов SHALL заканчиваться раньше, чем мастер процесса или контейнер останавливает сервер принудительно, чтобы зависший запрос прерывал сам сервер, а не `SIGKILL`, и SHALL быть не меньше суммы таймаутов ожидания соединения с БД и оператора. Процесс сервера 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: Остановка укладывается в срок @@ -100,7 +100,8 @@ #### Scenario: Зависший запрос не приводит к SIGKILL - **WHEN** во время `SIGTERM` принятый запрос не завершается за собственный срок ожидания сервера (например, клиент так и не дослал тело) -- **THEN** сервер прерывает его сам ответом `500`, и процесс завершается с кодом `0` раньше `SHUTDOWN_TIMEOUT_SECONDS` +- **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: Логи без содержимого сообщений diff --git a/openspec/specs/lab3-idempotent-messages/spec.md b/openspec/specs/lab3-idempotent-messages/spec.md index b5a87bca..21a349d9 100644 --- a/openspec/specs/lab3-idempotent-messages/spec.md +++ b/openspec/specs/lab3-idempotent-messages/spec.md @@ -79,6 +79,16 @@ - **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, лишние поля и типы (`400 invalid_request`), доступ к чату (`404 not_found`), затем текст сообщения (`400 invalid_request`). Ответ постороннему SHALL NOT раскрывать, существует ли чат: `400` по форме запроса отдаётся без обращения к чату и одинаков для существующего и несуществующего чата, а ошибка текста постороннему SHALL быть `404`. @@ -97,3 +107,4 @@ - **WHEN** участник отправляет с корректным ключом текст из пробелов - **THEN** ответ `400` с кодом `invalid_request`, ключ не занят + diff --git a/openspec/specs/lab3-load-balancing/spec.md b/openspec/specs/lab3-load-balancing/spec.md index 0cc58663..67a53deb 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: Реплика недоступна в обход балансировщика