Files
mtusi2026lab2/SOLUTION.md
T

45 lines
3.2 KiB
Markdown

# Лабораторная 2 на Python
Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление.
Нужны Docker Compose, Python 3.11+ и make. PostgreSQL/Valkey устанавливаются контейнерами из этого репозитория. Рабочий HTTP-порт по умолчанию 8082; первая лабораторная может продолжать работать на 8080.
```sh
make up
# bootstrap автоматически создаст .env и secrets/ только при их отсутствии.
# up дождётся Docker healthcheck.
make check test student-test
make infra-test
```
`make infra-test` намеренно останавливает PostgreSQL и Valkey текущего проекта, проверяет 503/cache fallback/expiry и затем запускает публичный полный restart-сценарий. Учебные данные и именованный volume сохраняются.
```sh
# Отдельно публичная проверка сохранности:
make test-persistence ACTION_SCRIPT=scripts/restart.sh
# Повторяемое исследование на изолированных синтетических БД:
make research
# Полная проверка схемы:
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make validate PYTHON=.venv/bin/python
# Необязательный рисунок по сохранённым данным:
.venv/bin/python -m pip install -r research/requirements.txt
.venv/bin/python research/summarize.py
```
Для другого порта: задать `HOST_PORT` в `.env`, пересоздать API командой `docker compose up -d`, передавать тестам `BASE_URL=http://localhost:<порт>`. `APP_PORT=8080` — внутренний порт контейнера. Для короткого TTL используется отдельный тестовый контейнер; обычный стенд оставляет SESSION_TTL_SECONDS=3600.
```sh
# Корректная остановка с сохранением данных:
docker compose down
# Повторный запуск с тем же volume:
docker compose up -d --wait
# Только если нужно намеренно уничтожить все учебные данные этого проекта:
docker compose down --volumes
```
Секреты не печатаются и не коммитятся. Не удалять secrets/ при сохранённом volume: смена пароля в файлах не меняет пароль уже инициализированной PostgreSQL. `make clean-clone-test` проверяет именно текущий commit в отдельном clone, со своими секретами, портом и временными volumes; незакоммиченные изменения в этот clone не попадают.
Схема до реализации запросов: [infra/SCHEMA.md](infra/SCHEMA.md). Подробный отчёт: [REPORT.md](REPORT.md). Методика исследования: [research/README.md](research/README.md).