Files
mtusi2026lab2/evidence/level4.md
T

9.4 KiB
Raw Blame History

Доказательства уровня 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. Автотест проверяет:

  1. неправильный пароль получает 401;
  2. новый Bearer-токен сразу работает;
  3. через 3.25 секунды тот же токен получает 401;
  4. новая сессия создаётся с правильным паролем;
  5. logout возвращает 204;
  6. отозванный токен сразу получает 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 возвращает ограниченный 503 unavailable;
  • запрос без 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.