Files
mtusi2026lab2/openspec/specs/lab2-dependency-failures/spec.md
T
ArtyomandClaude Opus 5.5 0ec2f9dae3 Carry over the agent context and openspec history from lab 2
Bring the Claude Code settings, the lint hook, the opsx commands and
skills, the architecture notes, the lab 1 and lab 2 specs and the
archived lab 1 and lab 2 changes into the lab 3 skeleton, so lab 3
continues the same spec history instead of starting from scratch.

Rewrite AGENTS.md and the openspec context and rules for lab 3:
HAProxy in front of several stateless API replicas, X-Instance-Id on
every response, a mandatory Idempotency-Key for messages shared by all
replicas through PostgreSQL, explicit stop-one and restart hooks, Out
of scope moved to labs 4-7 plus Swarm and HA storage, and rules on
retry policy, timeout chains and replica-local state.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-28 11:23:53 +03:00

2.7 KiB
Raw Blame History

lab2-dependency-failures Specification

Purpose

Определяет поведение API при отказе PostgreSQL и при исчерпании пула соединений: ограниченная по времени ошибка 503 вместо зависания, 500 или анонимного доступа, и восстановление без рестарта процесса.

Requirements

Requirement: Отказ PostgreSQL даёт ограниченную ошибку

При недоступном PostgreSQL защищённые endpoint и /health/ready SHALL отвечать 503 с кодом unavailable в общем формате ошибки быстрее 2 секунд. Проверка сессии, которая не смогла обратиться к БД, SHALL давать 503, а не 401, и SHALL NOT пропускать запрос. /health/live SHALL отвечать 200.

Scenario: PostgreSQL остановлен

  • WHEN сервис postgres остановлен
  • THEN GET /health/ready и GET /api/v1/users/me отвечают 503 unavailable быстрее 2 с, GET /health/live — 200, ни один ответ не 500

Scenario: Неизвестный токен при остановленной БД

  • WHEN PostgreSQL остановлен и приходит запрос с неизвестным токеном
  • THEN ответ 503, а не 200

Requirement: Восстановление без рестарта API

После возвращения PostgreSQL API SHALL восстанавливать обслуживание без перезапуска своего процесса за счёт переподключения пула.

Scenario: PostgreSQL снова запущен

  • WHEN сервис postgres запущен после остановки
  • THEN в течение 30 с /health/ready отвечает 200, а прежний токен читает свои данные

Requirement: Ограниченный пул соединений

Каждый процесс API SHALL держать не больше заданного числа соединений с PostgreSQL. Запрос, не получивший соединение за заданное время, SHALL получать 503 и SHALL NOT ждать бесконечно. Все SQL-запросы SHALL быть параметризованными.

Scenario: Пул исчерпан

  • WHEN все соединения пула заняты и приходит запрос, требующий БД
  • THEN ответ 503 unavailable за время ожидания соединения