From b6c372b35af18c5311a72c8933e1d9f2ac0af0ad Mon Sep 17 00:00:00 2001 From: root Date: Mon, 20 Jul 2026 08:17:51 +0500 Subject: [PATCH] Translate README to Russian --- README.md | 118 +++++++++++++++++++++++++++--------------------------- 1 file changed, 59 insertions(+), 59 deletions(-) diff --git a/README.md b/README.md index b017602..e11c3be 100644 --- a/README.md +++ b/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. -- 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).