Translate README to Russian

README.md

@@ -1,25 +1,25 @@
 # Roblox-Buyer
 
-Telegram bot for validating Roblox cookies, checking donation history, refreshing payable cookies, and crediting sellers through CryptoBot checks.
+Telegram-бот для проверки Roblox-cookie, получения истории донатов, обновления оплачиваемых cookie и начисления средств продавцам через CryptoBot.
 
-## Features
+## Возможности
 
-- Cookie intake from plain text or `.txt` files.
+- Прием cookie обычным текстом или `.txt`-файлом.
-- Concurrent Roblox cookie validation with optional proxies.
+- Параллельная проверка cookie Roblox с поддержкой прокси.
-- Lifetime and yearly donation rate matching.
+- Расчет оплаты по lifetime- и yearly-ставкам.
-- AVG pricing for large batches of donation cookies.
+- AVG-ценообразование для больших партий донатных cookie.
-- Cookie refresh before storage and payout.
+- Обновление cookie перед сохранением и выплатой.
-- User balances, withdrawals, referrals, statistics, and bans.
+- Балансы пользователей, вывод средств, реферальная система, статистика и блокировки.
-- Admin controls for rates, shop/bot toggles, broadcasts, treasury, and user management.
+- Админ-панель для управления ставками, магазином, рассылками, казной и пользователями.
 
-## Requirements
+## Требования
 
-- Python 3.10 or newer.
+- Python 3.10 или новее.
-- Telegram bot token.
+- Токен Telegram-бота.
-- CryptoBot API token for withdrawals and treasury top-ups.
+- API-токен CryptoBot для выплат и пополнения казны.
-- An administrator Telegram user ID.
+- Telegram ID администратора.
 
-Install the runtime dependencies in a virtual environment:
+Установите зависимости в виртуальное окружение:
 
 ```powershell
 python -m venv .venv
@@ -27,83 +27,83 @@ python -m venv .venv
 python -m pip install aiogram aiohttp requests curl-cffi
 ```
 
-On Linux or macOS, use `source .venv/bin/activate` instead of the PowerShell activation command.
+В Linux или macOS вместо команды активации PowerShell используйте `source .venv/bin/activate`.
 
-## Configuration
+## Настройка
 
-Copy [.env.example](.env.example) and set at least:
+Скопируйте [.env.example](.env.example) и укажите как минимум:
 
 ```text
-BOT_TOKEN=your_telegram_bot_token
+BOT_TOKEN=токен_telegram_бота
-ADMIN_ID=your_telegram_user_id
+ADMIN_ID=telegram_id_администратора
-CRYPTO_PAY_TOKEN=your_cryptobot_api_token
+CRYPTO_PAY_TOKEN=api_токен_cryptobot
 ```
 
-The application reads environment variables through `config.py`. It does not load `.env` files automatically, so provide the variables through your shell, process manager, container, or another environment loader.
+Приложение получает переменные окружения через `config.py`. Файлы `.env` автоматически не загружаются, поэтому передавайте переменные через shell, менеджер процессов, контейнер или другой загрузчик окружения.
 
-For PowerShell:
+Пример для PowerShell:
 
 ```powershell
-$env:BOT_TOKEN = "your_telegram_bot_token"
+$env:BOT_TOKEN = "токен_telegram_бота"
 $env:ADMIN_ID = "123456789"
-$env:CRYPTO_PAY_TOKEN = "your_cryptobot_api_token"
+$env:CRYPTO_PAY_TOKEN = "api_токен_cryptobot"
 python main.py
 ```
 
-The default local paths are:
+Основные локальные пути по умолчанию:
 
-- `Users/` for user records.
+- `Users/` - записи пользователей.
-- `filesforcookie/` for temporary cookie files.
+- `filesforcookie/` - временные файлы cookie.
-- `bot_config.json` for rates, treasury, and feature toggles.
+- `bot_config.json` - ставки, казна и переключатели функций.
-- `bot_stats.json` for aggregate statistics.
+- `bot_stats.json` - общая статистика.
-- `proxies.txt` for optional proxy entries.
+- `proxies.txt` - необязательный список прокси.
-- `robsec.txt` for refreshed cookies retained by the bot.
+- `robsec.txt` - сохраненные обновленные cookie.
 
-These runtime files are ignored by Git. Do not commit bot tokens, CryptoBot tokens, Roblox cookies, user records, or proxy credentials.
+Эти runtime-файлы исключены из Git. Не добавляйте в репозиторий токены, CryptoBot-токены, Roblox-cookie, записи пользователей или учетные данные прокси.
 
-## Running
+## Запуск
 
-Start polling with:
+Запустите polling:
 
 ```powershell
 python main.py
 ```
 
-Users can start with `/start`, send cookie text, or upload a `.txt` file. Administrators can open `/admin` to manage the shop.
+Пользователь может выполнить `/start`, отправить текст с cookie или загрузить `.txt`-файл. Администратор открывает панель управления командой `/admin`.
 
-## Project Structure
+## Структура проекта
 
 ```text
-main.py                 Bot bootstrap and polling
+main.py                 Запуск бота и polling
-config.py               Environment settings and defaults
+config.py               Переменные окружения и значения по умолчанию
-db/storage.py           Config, stats, and proxy persistence
+db/storage.py           Хранение конфигурации, статистики и прокси
-db/users.py             User record persistence
+db/users.py             Хранение записей пользователей
-models/                 Typed data models
+models/                 Типизированные модели данных
-services/roblox.py      Roblox validation, donation lookup, refresh
+services/roblox.py      Проверка Roblox, донаты и обновление cookie
-services/pricing.py     Rate matching and payout calculations
+services/pricing.py     Подбор ставок и расчет выплат
-services/withdrawals.py CryptoBot checks and treasury invoices
+services/withdrawals.py CryptoBot-чека и счета казны
-services/referrals.py   Referral payouts
+services/referrals.py   Реферальные выплаты
-services/admin.py       Admin operations
+services/admin.py       Административные операции
-handlers/               Telegram commands, callbacks, and FSM flows
+handlers/               Команды, callback-и и FSM-сценарии
-keyboards/              Inline keyboard builders
+keyboards/              Inline-клавиатуры
-states/admin.py         Admin FSM states
+states/admin.py         Состояния админской FSM
-utils/                  Parsing, logging, and shared helpers
+utils/                  Парсинг, логирование и общие функции
 ```
 
-## Security Notes
+## Безопасность
 
-Roblox cookies are credentials. Treat `robsec.txt`, uploaded files, and the `Users/` directory as sensitive data. Restrict filesystem access, keep backups encrypted, and remove data that is no longer needed.
+Roblox-cookie являются учетными данными. Считайте `robsec.txt`, загруженные файлы и каталог `Users/` конфиденциальными данными. Ограничьте доступ к файловой системе, храните резервные копии в зашифрованном виде и удаляйте ненужные данные.
 
-The CryptoBot integration currently uses the testnet API endpoints in `services/withdrawals.py`. Review and change those endpoints deliberately before handling production funds.
+Интеграция CryptoBot сейчас использует testnet-endpoint-ы в `services/withdrawals.py`. Перед работой с реальными средствами отдельно проверьте и измените эти endpoint-ы.
 
-## Verification
+## Проверка
 
-Run a syntax check with:
+Проверить синтаксис Python можно командой:
 
 ```powershell
-python -m compileall -q .
+python -m compileall -q config.py main.py db handlers keyboards models services states utils
 ```
 
-## License
+## Лицензия
 
-MIT. See [LICENSE](LICENSE).
+MIT. См. [LICENSE](LICENSE).