added AGENTS.md and docs for BalanceServer

BalanceServer/docs/DEVELOPMENT.md

@@ -0,0 +1,107 @@
+# Разработка и запуск
+
+## Требования
+
+Проект использует Go 1.25.0.
+
+Проверить локальную версию:
+
+```bash
+go version
+```
+
+## Установка зависимостей
+
+```bash
+go mod download
+```
+
+## Сборка
+
+```bash
+go build ./...
+```
+
+## Тесты
+
+```bash
+go test ./...
+```
+
+С race detector:
+
+```bash
+go test -race ./...
+```
+
+## Static checks
+
+```bash
+go vet ./...
+```
+
+Если в проекте есть Makefile/CI, его команды имеют приоритет как canonical build pipeline.
+
+## Локальный запуск
+
+Перед запуском изучите конфигурацию в коде и `.env`/deployment files.
+
+Не коммитьте реальные credentials.
+
+Пример общего workflow:
+
+```bash
+go mod download
+go test ./...
+go build ./...
+./<server-binary>
+```
+
+Имя binary и обязательные env vars определяются текущей entrypoint/config реализацией.
+
+## Database
+
+Перед первым запуском:
+1. поднять требуемую БД;
+2. применить migrations, если проект их использует;
+3. задать connection settings;
+4. проверить health/startup logs.
+
+## Production
+
+Рекомендуемый pipeline:
+
+```text
+source
+  ↓
+go test ./...
+  ↓
+go vet ./...
+  ↓
+go build ./...
+  ↓
+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 на другом устройстве.