# Разработка и запуск

## Требования

Сервер использует Rust 1.90+ и bundled SQLite. Python 3 нужен для `tools/compatibility.py` и используется без сторонних пакетов. Go больше не нужен.

Проверить локальную версию:

```bash
rustc --version
cargo --version
python3 --version
```

## Установка зависимостей

```bash
cargo fetch --locked
```

## Сборка

```bash
cargo build --locked
```

## Тесты

```bash
cargo test --locked
cargo build --locked
python3 tools/compatibility.py
```

`tools/compatibility.py` запускает сервер на временных портах и базах и сравнивает
ответы API и статику с ответами исходного Go-сервера, записанными в
`tools/compatibility_expected.txt`. Расхождение означает изменение, видимое
клиентам. Если изменение намеренное, проверьте diff и перезапишите эталон:

```bash
python3 tools/compatibility.py --update
```

## Static checks

```bash
cargo fmt --check
cargo clippy --locked --all-targets -- -D warnings
```

Если в проекте есть Makefile/CI, его команды имеют приоритет как canonical build pipeline.

## Локальный запуск

Перед запуском изучите конфигурацию в коде и `.env`/deployment files.

Не коммитьте реальные credentials.

Собрать и запустить Rust-сервер:

```bash
cargo build --locked --release
export BALANCE_JWT_SECRET="replace-with-a-long-random-secret"
export BALANCE_DB_PATH="./data/balance.db"
./target/release/balance-server
```

По умолчанию сервер слушает `:8080`. Файл `.env` читает Docker Compose; при
прямом запуске переменные нужно передать процессу через окружение.

## Database

SQLite встроен в executable. При первом запуске сервер создаёт каталог,
таблицы и индексы автоматически. Отдельный процесс БД не нужен. При переходе
с Go сохраните существующий файл БД и `BALANCE_JWT_SECRET`; подробная
процедура и откат описаны в [DEPLOYMENT.md](DEPLOYMENT.md).

## Production

Рекомендуемый pipeline:

```text
source
  ↓
cargo fmt --check && cargo test --locked
  ↓
cargo clippy --locked --all-targets -- -D warnings
  ↓
cargo build --locked --release
  ↓
python3 tools/compatibility.py --binary target/release/balance-server
  ↓
container/package
  ↓
deploy
  ↓
health check
```

Для production нужны:
- TLS termination;
- persistent database;
- backups;
- monitoring;
- log rotation;
- secrets management;
- migration procedure.

## Совместимость

При релизе server проверяйте минимум:
- старый iOS client + новый server;
- новый iOS client + server;
- Android client + server;
- concurrent sync с двух устройств;
- login/refresh после истечения access token;
- delete → pull на другом устройстве.

Production build: `cargo build --locked --release`. Прямой запуск: `BALANCE_JWT_SECRET=<secret> target/release/balance-server`, порт 8080. Docker Compose публикует порт 8123 и сохраняет прежний volume `/data`. Процедура миграции Go → Rust и rollback: [DEPLOYMENT.md](DEPLOYMENT.md).