Files
mtusi2026lab2/RUN.md
T

68 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Запуск лабораторной 2
Автор: Медведев Андрей Михайлович, БПИ2303. Исходное задание и контракт сохранены в README.md и contracts/. Реализация находится в backend/, дополнительные проверки в student-tests/.
Нужны Docker Engine с Compose, Bun 1.4 и Python 3.9+. Для Go-тестов на хосте нужен Go 1.27.2 или новее. Проверенный стенд: Linux x86_64, Docker 29.9.2, Compose 5.6.1, Bun 1.4.4; образ компилируется Go 1.27.2. Образы PostgreSQL 18.6 и Valkey 9 закреплены digest в compose.yaml.
Команды выполняются из этого каталога. scripts/compose.sh закрепляет manifest и имя vp-lab2-medvedev, чтобы переменные другого проекта не перенаправили операции.
```sh
bun --no-env-file scripts/bootstrap.ts
./scripts/compose.sh up -d --build
BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/wait.ts
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
make check
make validate PYTHON=.venv/bin/python
make test BASE_URL=http://127.0.0.1:28202
BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/acceptance.ts
make test-persistence BASE_URL=http://127.0.0.1:28202 ACTION_SCRIPT=scripts/restart.sh
cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...
```
Bootstrap создаёт отдельные случайные учебные credentials в .local/ и не печатает их. Каталог исключён из git и Docker context. Существующие файлы не перезаписываются. Миграции запускает отдельный service migrate; API не выполняет их конкурентно.
HTTP доступен только через localhost. Все данные тестов синтетические; публичные тесты сохраняют свой набор данных для демонстрации, дополнительные acceptance-тесты удаляют только свой случайный набор. Пароли и сессии не выводятся в отчёты.
Обычная остановка сохраняет volumes:
```sh
./scripts/compose.sh stop
```
Повторный запуск с сохранением данных:
```sh
./scripts/compose.sh up -d
```
Только для намеренного полного сброса собственных учебных данных:
```sh
./scripts/compose.sh down --volumes
```
Проверка отказов БД/кэша и короткого срока сессии:
```sh
FAILURES=1 BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/acceptance.ts
```
Исследование трека 2 запускается на omarchy без игры после обычного bootstrap и сборки. Скрипт сам проверяет game-running, останавливает API на время снимка, использует отдельный PostgreSQL для восстановления и возвращает API после очистки своего набора. Публичные демонстрационные данные сохраняются.
```sh
bun --no-env-file student-tests/research.ts
```
Новый результат появляется в evidence/research/run-*/summary.json. Для графика установите requirements-plots.txt в .venv и передайте файл конкретного завершённого запуска:
```sh
.venv/bin/pip install -r requirements-plots.txt
.venv/bin/python student-tests/plot_research.py evidence/research/run-16q3rN/summary.json
```
Последняя команда воспроизводит приложенный график; для нового эксперимента подставьте его каталог. Подтверждённые результаты и ограничения перечислены в REPORT.md. Автоматические проверки не выставляют оценку преподавателя.