forked from mtusi2026/mtusi2026lab2
57 lines
5.8 KiB
Markdown
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/` не изменялись.
|