Translate README to Russian

2026-07-20 08:17:51 +05:00
parent 37faf04b67
commit b6c372b35a
1 changed files with 59 additions and 59 deletions
@@ -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.
- Concurrent Roblox cookie validation with optional proxies.
- Lifetime and yearly donation rate matching.
- AVG pricing for large batches of donation cookies.
- Cookie refresh before storage and payout.
- User balances, withdrawals, referrals, statistics, and bans.
- Admin controls for rates, shop/bot toggles, broadcasts, treasury, and user management.
+- Прием cookie обычным текстом или `.txt`-файлом.
+- Параллельная проверка cookie Roblox с поддержкой прокси.
+- Расчет оплаты по lifetime- и yearly-ставкам.
+- AVG-ценообразование для больших партий донатных cookie.
+- Обновление cookie перед сохранением и выплатой.
+- Балансы пользователей, вывод средств, реферальная система, статистика и блокировки.
+- Админ-панель для управления ставками, магазином, рассылками, казной и пользователями.

-## Requirements
+## Требования

- Python 3.10 or newer.
- Telegram bot token.
- CryptoBot API token for withdrawals and treasury top-ups.
- An administrator Telegram user ID.
+- Python 3.10 или новее.
+- Токен Telegram-бота.
+- API-токен CryptoBot для выплат и пополнения казны.
+- 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
-ADMIN_ID=your_telegram_user_id
-CRYPTO_PAY_TOKEN=your_cryptobot_api_token
+BOT_TOKEN=токен_telegram_бота
+ADMIN_ID=telegram_id_администратора
+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.
- `filesforcookie/` for temporary cookie files.
- `bot_config.json` for rates, treasury, and feature toggles.
- `bot_stats.json` for aggregate statistics.
- `proxies.txt` for optional proxy entries.
- `robsec.txt` for refreshed cookies retained by the bot.
+- `Users/` - записи пользователей.
+- `filesforcookie/` - временные файлы cookie.
+- `bot_config.json` - ставки, казна и переключатели функций.
+- `bot_stats.json` - общая статистика.
+- `proxies.txt` - необязательный список прокси.
+- `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
-config.py               Environment settings and defaults
-db/storage.py           Config, stats, and proxy persistence
-db/users.py             User record persistence
-models/                 Typed data models
-services/roblox.py      Roblox validation, donation lookup, refresh
-services/pricing.py     Rate matching and payout calculations
-services/withdrawals.py CryptoBot checks and treasury invoices
-services/referrals.py   Referral payouts
-services/admin.py       Admin operations
-handlers/               Telegram commands, callbacks, and FSM flows
-keyboards/              Inline keyboard builders
-states/admin.py         Admin FSM states
-utils/                  Parsing, logging, and shared helpers
+main.py                 Запуск бота и polling
+config.py               Переменные окружения и значения по умолчанию
+db/storage.py           Хранение конфигурации, статистики и прокси
+db/users.py             Хранение записей пользователей
+models/                 Типизированные модели данных
+services/roblox.py      Проверка Roblox, донаты и обновление cookie
+services/pricing.py     Подбор ставок и расчет выплат
+services/withdrawals.py CryptoBot-чека и счета казны
+services/referrals.py   Реферальные выплаты
+services/admin.py       Административные операции
+handlers/               Команды, callback-и и FSM-сценарии
+keyboards/              Inline-клавиатуры
+states/admin.py         Состояния админской FSM
+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).