# Индекс доказательств Санитизированные доказательства по лабораторной 2 (трек 1, оценка 5). | Файл | Что доказывает | | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`track1-cache-consistency.md`](track1-cache-consistency.md) | Трек 1: окружение, методика, счётчики и латентность по каждой повторности для naive и protected, сравнение, read-after-write, восстановление после рестарта Redis, план запроса, хеши артефактов, ограничения. | | [`level3-4-verification.md`](level3-4-verification.md) | Проверки уровня 3/4 с наблюдаемым выводом команд: контракт, сборка и тесты, миграции, публичный smoke, persistence-перезапуск, чёрно-белый интеграционный набор, истечение TTL, гонка username, rollback, отказы зависимостей, `EXPLAIN`, endpoint метрик, а также дефекты, найденные этим аудитом. | | [`track1-explain.md`](track1-explain.md) | Тексты анализируемых SQL-запросов, подготовка 10 000 синтетических строк и сырой `EXPLAIN (ANALYZE, BUFFERS)`: `Index Scan using messages_chat_created_id_idx` для первой страницы и для продолжения по keyset-cursor. | | [`../bruno/README.md`](../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. | ## Полная регенерация ```sh # 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@:5432/messenger \ REDIS_URL=redis://: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/` не изменялись.