# Backend (HTTP)

**Слой:** Backend — оркестрация и REST API. Вычисления выполняет C++ Engine через CLI.

## Роль

- Приём файлов и конфигурации пайплайна
- Пресеты, validate, wizard, demo-облака (Python)
- Запуск `DotsToSurface --cli` и возврат JSON
- Отдача собранного Vue frontend (`frontend/web/dist`)

## Entry point

- [`main.py`](main.py) — FastAPI
- Запуск: `uvicorn main:app --host 0.0.0.0 --port 8080`

## Зависимости

- **`DOTSTOSURFACE_BIN`** — путь к C++ бинарнику
- Без бинарника `/api/run` не работает

## Запуск приложения

Полный Web-стек (frontend + API + engine) — **в Docker**, см. [../docker/README.md](../docker/README.md).

Локальный `uvicorn` ниже — только для разработки backend без пересборки образа:

```bash
cd backend
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
export DOTSTOSURFACE_BIN=/path/to/DotsToSurface
uvicorn main:app --reload --port 8080
```

См. также: [../ARCHITECTURE.md](../ARCHITECTURE.md)