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>
2.7 KiB
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за время ожидания соединения