Files
2026-10-10 02:13:35 +03:00

5.8 KiB

Индекс доказательств

Санитизированные доказательства по лабораторной 2 (трек 1, оценка 5).

Файл Что доказывает
track1-cache-consistency.md Трек 1: окружение, методика, счётчики и латентность по каждой повторности для naive и protected, сравнение, read-after-write, восстановление после рестарта Redis, план запроса, хеши артефактов, ограничения.
level3-4-verification.md Проверки уровня 3/4 с наблюдаемым выводом команд: контракт, сборка и тесты, миграции, публичный smoke, persistence-перезапуск, чёрно-белый интеграционный набор, истечение TTL, гонка username, rollback, отказы зависимостей, EXPLAIN, endpoint метрик, а также дефекты, найденные этим аудитом.
track1-explain.md Тексты анализируемых SQL-запросов, подготовка 10 000 синтетических строк и сырой EXPLAIN (ANALYZE, BUFFERS): Index Scan using messages_chat_created_id_idx для первой страницы и для продолжения по keyset-cursor.
../bruno/README.md Коллекция ручных запросов Bruno ко всем эндпоинтам (29 запросов / 58 проверок, все зелёные) — удобно для разбора API вручную.
track1-raw/naive.json (в Git не попадает) Сырой вывод бенчмарка для CACHE_MODE=naive.
track1-raw/protected.json (в Git не попадает) Сырой вывод бенчмарка для CACHE_MODE=protected.
track1-raw/redis-restart.json (в Git не попадает) Сырой вывод проверки рестарта Redis.

Полная регенерация

# 1. Стенд
cp .env.example .env
password=$(openssl rand -hex 32)
sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env
sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env
sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env
docker compose --env-file .env up -d --build
curl -fsS http://localhost:8080/health/ready

# 2. Приёмка и сохранность
make check && make validate
make test BASE_URL=http://localhost:8080
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh

# 3. Тесты приложения
(cd app && npm run build && npm test && npx tsc --noEmit)

# 4. Интеграционный набор (реальные PostgreSQL/Redis; порты наружу не публикуются)
docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mtusi2026lab2-postgres-1 mtusi2026lab2-redis-1
(cd app && API_BASE_URL=http://localhost:8080 \
  DATABASE_URL=postgresql://messenger:$password@<pg-ip>:5432/messenger \
  REDIS_URL=redis://<redis-ip>:6379 npx vitest run --config ./vitest.config.e2e.ts)

# 5. Трек 1
printf '%s' "$METRICS_TOKEN" > /tmp/track1-metrics-token   # METRICS_TOKEN из .env
CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api
python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode naive \
  --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \
  --output evidence/track1-raw/naive.json
CACHE_MODE=protected docker compose --env-file .env up -d api
python3 scripts/track1_cache_benchmark.py --base-url http://localhost:8080 --mode protected \
  --concurrency 32 --repetitions 5 --metrics-token-file /tmp/track1-metrics-token \
  --output evidence/track1-raw/protected.json
python3 scripts/track1_verify.py --restart-redis --evict-cache \
  --output evidence/track1-raw/redis-restart.json

Точки входа для ревьюера: README.md (задание), REPORT.md (решение), этот индекс. Публичные contracts/ и tests/ не изменялись.