Files
mtusi2026lab2/SOLUTION.md
T

3.2 KiB

Лабораторная 2 на Python

Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление.

Нужны Docker Compose, Python 3.11+ и make. PostgreSQL/Valkey устанавливаются контейнерами из этого репозитория. Рабочий HTTP-порт по умолчанию 8082; первая лабораторная может продолжать работать на 8080.

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 сохраняются.

# Отдельно публичная проверка сохранности:
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.

# Корректная остановка с сохранением данных:
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. Подробный отчёт: REPORT.md. Методика исследования: research/README.md.