> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedolagam.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Разработка

> Руководство для разработчиков

## Подготовка окружения

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

* Python 3.13+
* [uv](https://docs.astral.sh/uv/) — менеджер пакетов
* PostgreSQL 18
* Redis (опционально)

### Установка

```bash theme={null}
git clone https://github.com/BEDOLAGA-DEV/remnawave-bedolaga-telegram-bot.git
cd remnawave-bedolaga-telegram-bot

# Установка зависимостей
uv sync --group dev

# Копирование конфигурации
cp .env.example .env
# Заполните .env вашими значениями
```

## Код-стайл

| Параметр | Значение |
| - | - |
| Линтер/Форматтер | ruff |
| Длина строки | 120 символов |
| Кавычки | Одинарные (inline), двойные (docstrings) |
| Импорты | Только абсолютные |
| Типизация | Обязательна (Python 3.13 features) |

```bash theme={null}
# Проверка
make lint

# Автоисправление
make fix

# Форматирование
make format
```

## Тестирование

Тесты используют `pytest` + `pytest-asyncio`:

```bash theme={null}
# Все тесты
make test

# Конкретный файл
uv run pytest -v tests/services/test_payment_service_yookassa.py

# По паттерну
uv run pytest -v -k "test_calculate"
```

## Docker разработка

```bash theme={null}
make up              # Запуск контейнеров
make up-follow       # Запуск с логами
make down            # Остановка
make reload          # Перезапуск
```

## Структура тестов

```
tests/
├── conftest.py              # Глобальные фикстуры
├── external/                # Тесты внешних клиентов
├── services/                # Тесты сервисов
└── utils/                   # Тесты утилит
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.