Files
mtusi2026lab2/evidence/README.md
T
2026-10-10 02:13:35 +03:00

57 lines
5.8 KiB
Markdown

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