9.4 KiB
Доказательства уровня 4
Состояние: полный уровень 4 в ветке solution/bvt2301-churilin на базе commit
уровня 3 158fed1; результаты ниже получены перед публикацией изменений.
Все созданные пользователи, чаты и сообщения синтетические. Пароли, Bearer tokens, database URL и содержимое secret-файлов не сохранялись в evidence.
Проверенное окружение
Ubuntu 26.04 LTS, WSL2, x86_64
Intel Core i5-1135G7, 4 cores / 8 logical CPU
Docker-visible RAM: 3.724 GiB
Docker Engine 29.7.2, Docker Compose 5.5.0
Go 1.27.1, Python 3.14.4
PostgreSQL 16.15
Redis 8.10.2, go-redis/v9 v9.23.0
Redis Insight 3.8.0
API и PostgreSQL не имеют отдельных Compose CPU/RAM quotas и используют лимиты
Docker Desktop/WSL. Redis дополнительно ограничен maxmemory=64mb. Все
контейнерные образы закреплены точным тегом и digest.
Полная команда
После запуска стенда все накопительные проверки объединены целью:
make test-level4 PYTHON=.venv/bin/python
Она последовательно запускает Go tests/race/vet, offline check, OpenAPI validation, Compose validation, public smoke, транзакционные сценарии, короткий session TTL, отказ Redis, отказ PostgreSQL, полный restart и SQL EXPLAIN.
Cache-aside и TTL
Ключ:
chat:v1:<chat_uuid>
Значение — JSON domain.Chat с полями id, title, member_ids и
created_at. Наблюдаемый TTL после чтения был 243 секунды из настроенных 300:
db0: keys=1, expires=1
maxmemory=67108864
maxmemory-policy=allkeys-lru
save=""
appendonly=no
PostgreSQL остаётся источником истины. RDB/AOF и Redis volume намеренно отключены, так как потерянная карточка лениво восстанавливается из PostgreSQL. Unit-тесты подтверждают miss → source → fill, hit без второго source read, проверку членства на hit и игнорирование ошибки best-effort cache write.
Отказ Redis
make test-cache-fallback
Stopping only Redis; hook output is suppressed.
PASS: Redis outage used PostgreSQL fallback; readiness, session,
authorization and writes remained correct.
Сценарий прогревает карточку, останавливает только Redis, тем же Bearer-токеном проверяет readiness, читает существующий чат и создаёт новый. Запрос без корректного токена остаётся 401. После запуска Redis чтение нового чата снова заполняет кеш.
Наблюдаемые времена отдельного запуска:
cache hit GET: 0.84 ms
fallback GET: 254.46 ms
POST during outage: 254.31 ms
first GET after recovery: 3.10 ms
Redis timeout равен 250 ms. После сетевой ошибки чтения в том же запросе не выполняется вторая cache write, поэтому fallback не платит второй timeout.
Конкурентная регистрация и rollback
make test-level4-transactions
PASS: concurrent username race produced one winner; failed composite chat
creation rolled back and the connection remained usable.
Четыре параллельных запроса регистрируют один и тот же уникальный username.
Тест требует ровно один HTTP 201 и три HTTP 409. Решение принимает окончательное
решение по ограничению users_username_unique, а не по небезопасной схеме
check-then-insert.
Для rollback тест создаёт чат с существующим вызывающим и несуществующим UUID
второго участника. Код успевает вставить строку chats и первого участника,
затем получает RowsAffected() == 0 на INSERT ... SELECT FROM users.
Deferred rollback отменяет обе вставки. Чат не появляется в списке пользователя,
а следующая составная операция через тот же API успешно завершается.
Короткий expiry, неверный пароль и logout
make test-session-security
PASS: deployed short SESSION_TTL_SECONDS expired the token; wrong password
and logout remained enforced.
Action hook временно пересоздаёт API с SESSION_TTL_SECONDS=2. Автотест
проверяет:
- неправильный пароль получает 401;
- новый Bearer-токен сразу работает;
- через 3.25 секунды тот же токен получает 401;
- новая сессия создаётся с правильным паролем;
- logout возвращает 204;
- отозванный токен сразу получает 401.
Блок finally пересоздаёт API с обычной конфигурацией. После теста внутри
контейнера подтверждено SESSION_TTL_SECONDS=3600.
Отказ обязательной PostgreSQL
make test-database-failure
Stopping only PostgreSQL; hook output is suppressed.
PASS: PostgreSQL outage returned bounded 503 responses, anonymous access
stayed rejected, and the existing session recovered.
Во время остановки только PostgreSQL:
/health/liveвозвращает 200;/health/readyвозвращает ограниченный 503unavailable;- запрос без Bearer отклоняется 401 до обращения к БД;
- запрос с ранее действующим Bearer возвращает 503, а не считается доверенным;
- запись пользователя возвращает 503 без деталей драйвера/SQL.
После запуска PostgreSQL существующий пул соединений восстанавливается, а прежний Bearer-токен снова получает исходного пользователя.
План истории на 10 000 сообщений
make explain-history
Сценарий создаёт данные внутри транзакции, выполняет ANALYZE и в конце делает
ROLLBACK. Постоянные таблицы после измерения не засоряются.
synthetic_message_count
-----------------------
10000
Первая страница:
Limit (actual time=0.019..0.043 rows=101 loops=1)
-> Index Scan using messages_chat_created_at_id_idx
(actual time=0.018..0.037 rows=101 loops=1)
Index Cond: (chat_id = ...)
Buffers: shared hit=5
Execution Time: 0.068 ms
Страница после курсора на позиции 5000:
Limit (actual time=0.013..0.046 rows=101 loops=1)
-> Index Scan using messages_chat_created_at_id_idx
(actual time=0.012..0.040 rows=101 loops=1)
Index Cond: chat_id = ... AND ROW(created_at, id) > ROW(...)
Buffers: shared hit=6
Execution Time: 0.111 ms
Оба запроса используют индекс (chat_id, created_at, id), не выполняют
Seq Scan и возвращают только limit + 1 = 101 строку. Времена относятся к
описанному локальному стенду и не объявляются production-бенчмарком.
Полный restart
make test-persistence ACTION_SCRIPT=scripts/restart.sh
PASS: persistence preserved confirmed data and existing session.
Hook перезапускает PostgreSQL и Redis, ждёт оба healthcheck и перезапускает API. PostgreSQL volume сохраняет данные и сессию. Redis стартует пустым и лениво заполняется после следующего чтения.
Redis Insight
make compose-tools-up
curl http://127.0.0.1:5540/api/health/
{"status":"up"}
Для ручного подключения внутри UI: host redis, port 6379, database 0,
без TLS и пароля. Такая конфигурация допустима только для изолированного
локального учебного стенда: Redis не публикует host-port, а UI привязан к
127.0.0.1.
Границы доказательства
Проверки подтверждают обязательные критерии уровня 4 в указанном одноузловом стенде. Они не доказывают HA PostgreSQL, поведение при произвольном network partition, максимальную пропускную способность или критерии выбранного Track 2 уровня 5.