Files
mtusi2026lab2/openspec/changes/forward-lab5-published-fixes/specs/lab2-session-cache/spec.md
T

3.3 KiB
Raw Blame History

MODIFIED Requirements

Requirement: Выход инвалидирует кэш

Отзыв сессии SHALL инвалидировать кэш до фиксации удаления в PostgreSQL. Отозванный токен SHALL получать 401 и при гонке «чтение заполнило кэш после выхода», включая потерю или смену состояния кэша. Если инвалидация невозможна, выход SHALL отвечать 503 и SHALL NOT фиксировать удаление сессии. Если транзакция удаления не завершилась, выход SHALL отвечать 503 и SHALL снимать отметку отзыва: сессия остаётся действующей. Основание: contracts/README.md, выход и абсолютный TTL; README.md, уровень «3», сохранение минимума lab2.

Scenario: Отозванный токен не оживает из кэша

  • WHEN токен закэширован, после чего пользователь выполняет DELETE /api/v1/auth/sessions/current
  • THEN ответ 204, а следующий запрос с этим токеном получает 401

Scenario: Выход при недоступном кэше

  • 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

Scenario: Запоздавшее чтение после выхода и потери кэша

  • WHEN чтение действующей сессии задержалось, другая реплика завершила logout с 204, затем очистка или вытеснение удалили отметку отзыва и задержанное чтение продолжилось
  • THEN новый GET /api/v1/users/me с тем же токеном получает 401 с WWW-Authenticate: Bearer realm="messenger" и телом общей ошибки, даже если другая проверка успела заново обратиться к кэшу

Scenario: Очистка кэша до завершения выхода

  • WHEN кэш очищен после инвалидации, но до COMMIT удаления сессии, и параллельно начинается новая проверка токена
  • THEN эта проверка не оставляет действующую сессию в кэше после успешного logout, следующие запросы получают 401