Индекс доказательств
Санитизированные доказательства по лабораторной 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/ не изменялись.