راهنمای نصب مینی‌اپ V2Ray170
===============================

این نسخه برای هاست اشتراکی دارای Python 3 و پشتیبانی WSGI/cPanel ساخته شده است.
فرانت‌اند HTML/CSS/JS و بک‌اند Flask است. دیتابیس‌ها فقط خوانده می‌شوند تا
مینی‌اپ نتواند موجودی، سفارش‌ها یا اطلاعات مالی ربات را ناخواسته تغییر دهد.

امکانات فعلی:
- ورود امن با اعتبارسنجی Telegram Web App initData
- داشبورد، موجودی و اطلاعات حساب
- فهرست گروه‌ها و سرویس‌های فعال از bot.db
- نمایش سفارش‌ها، وضعیت، کد پیگیری و config_link (در صورت وجود)
- نمایش فیش‌های واریزی
- آمار دعوت و پورسانت از referral.db
- لینک پشتیبانی و ورود به ربات برای انجام خرید/شارژ

نکته: ثبت خرید، کسر موجودی، شارژ و ارسال عکس فیش عمداً در این نسخه انجام نمی‌شود.
این گردش‌های مالی در ربات فعلی پیاده‌سازی شده‌اند؛ برای جلوگیری از دوگانگی و
ناسازگاری مالی، دکمه‌های خرید و شارژ کاربر را به ربات هدایت می‌کنند.

1) آپلود
- از حالت فشرده خارج کنید.
- پوشه miniapp را در هاست آپلود کنید (مثلاً /home/USER/miniapp).
- فایل‌های bot.db و referral.db را در همان پوشه قرار دهید، یا مسیر دقیق‌شان را
  در متغیرهای محیطی BOT_DB_PATH و REFERRAL_DB_PATH تنظیم کنید.
- فایل‌های bot.db-wal و bot.db-shm را به عنوان دیتابیس مستقل کپی نکنید.

2) ساخت Python App در cPanel
- از Setup Python App یک برنامه Python 3.10+ بسازید.
- Application root را روی پوشه miniapp بگذارید.
- Application URL را روی یک دامنه یا زیردامنه HTTPS تنظیم کنید.
- Startup file: passenger_wsgi.py
- Entry point: application
- از بخش پکیج‌ها یا ترمینال محیط مجازی برنامه اجرا کنید:
    pip install -r requirements.txt
- در متغیرهای محیطی برنامه:
    BOT_TOKEN = توکن جدید ربات
    BOT_USERNAME = V2ray170bot
    BOT_DB_PATH = /home/USER/path/to/bot.db
    REFERRAL_DB_PATH = /home/USER/path/to/referral.db
- پس از ذخیره، Restart برنامه را بزنید.

3) اتصال به ربات
در کد ربات، دکمه Web App را با آدرس HTTPS مینی‌اپ بسازید. نمونه aiogram 3:

    from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton, WebAppInfo

    def miniapp_keyboard():
        return InlineKeyboardMarkup(inline_keyboard=[[
            InlineKeyboardButton(
                text="🌐 ورود به پنل کاربری",
                web_app=WebAppInfo(url="https://YOUR-DOMAIN.example/")
            )
        ]])

سپس این کیبورد را به پیام منوی اصلی ربات اضافه کنید. دامنه باید HTTPS معتبر داشته باشد.
در BotFather دامنه مینی‌اپ را با /setdomain ثبت کنید (در صورت درخواست تلگرام).
آدرس YOUR-DOMAIN را با دامنه واقعی خود جایگزین کنید.

4) تست
- آدرس https://YOUR-DOMAIN.example/health باید {"ok":true} بدهد.
- مینی‌اپ را فقط از داخل تلگرام و از دکمه Web App باز کنید.
- اگر خطای احراز هویت می‌بینید، مطمئن شوید BOT_TOKEN همان توکن ربات است و صفحه از
  داخل تلگرام باز شده است.
- اگر خطای دیتابیس می‌بینید، مسیر BOT_DB_PATH و مجوز خواندن فایل‌ها را بررسی کنید.

5) نکات مهم دیتابیس
- دیتابیس اصلی ربات شما SQLite است. این برنامه از مسیرهای مشخص‌شده فقط‌خواندنی
  استفاده می‌کند و به schema موجود دست نمی‌زند.
- بهتر است فایل دیتابیس را در پوشه‌ای خارج از public_html نگه دارید.
- برای تهیه بکاپ، از SQLite backup API یا توقف ربات و کپی سازگار دیتابیس استفاده کنید.
  در زمان اجرای ربات، صرفاً bot.db را بدون WAL کپی نکنید.
- دسترسی فایل دیتابیس را محدود کنید؛ آن را با URL عمومی قابل دانلود نکنید.

6) هشدار امنیتی مهم
آرشیوی که فرستادید حاوی مقدار BOT_TOKEN واقعی در config.py بود. این توکن را افشاشده
فرض کنید: فوراً در BotFather آن را revoke کنید و توکن جدید را فقط در Environment
Variables هاست قرار دهید. توکن را داخل فایل‌های عمومی یا Git قرار ندهید.

این پروژه به ربات polling دست نمی‌زند و نمونه دوم ربات را اجرا نمی‌کند.
