# ارتقای پنل وب همیار به سبک فاکسیما — مرحله ۱

## فایل‌های تغییرکرده
- `assets/css/panel.css` — @font-face محلی وزیرمتن، سایدبار هم‌تم با صفحه، دسته‌های تاشو، کارت‌های آمار جدید، استایل نمودار
- `assets/js/panel.js` — دسته‌های تاشو (ذخیره‌ی وضعیت)، جست‌وجوی منو با دسته‌ها، نمودار جدید (منحنی نرم، گرادیان، لمس)
- `admin/_header.php` — منوی دسته‌بندی‌شده + آیکن SVG
- `admin/index.php` — داشبورد با آیکن SVG و کارت‌های جدید
- `admin/appearance.php` — اصلاح دکمه‌ی تم (دیگر آیکن SVG را پاک نمی‌کند)

## فایل‌های جدید
- `admin/_icons.php` — تابع `panel_icon('نام')` با ~60 آیکن خطی
- `assets/fonts/Vazirmatn-{Regular,Medium,Bold}.woff2`

## نکته‌ی نصب
بدون نیاز به مهاجرت دیتابیس. فایل‌ها را روی نسخه‌ی فعلی جایگزین کن و کش مرورگر را پاک کن.

## مرحله ۲ — حساب کاربری و کیف پول ربات (سبک فاکسیما)
- `bot/account.php` — صفحه‌ی حساب: شناسه کاربری، نام، یوزرنیم، شماره تماس، زمان ثبت‌نام (شمسی)، موجودی، اشتراک فعال، پیام‌های اضافه، تعداد محصولات/فاکتورها/تیکت‌های باز؛ «📑 تراکنش‌های من» (۲۴ساعت/۳روز/۷روز/۳۰روز + صفحه‌بندی)؛ «🎫 تیکت‌های پشتیبانی» (لیست، جزئیات، پاسخ ادمین، ثبت تیکت جدید)
- `bot/index.php` — مسیر callbackهای جدید: account:tx، account:tickets، account:ticket:ID
- `includes/button_styles.php` — دکمه‌های جدید در بخش رنگ‌بندی دکمه‌ها
- بدون تغییر دیتابیس.

## مرحله ۳ — ادغام «پشتیبانی» و «سوالات متداول» (سبک فاکسیما)
- منوی اصلی ربات: دکمه‌ی «🆘 پشتیبانی» حالا صفحه‌ای با دکمه‌های «❓ سوالات متداول»، «🎟 پیام پشتیبانی» و «🎫 تیکت‌های من» باز می‌کنه.
- `bot/support.php` (هاب)، `bot/index.php` (مسیرها: menu:support → هاب، support:start → شروع پشتیبانی)، `includes/bot_text_catalog.php` (متن هاب از «متن‌های ربات» قابل ویرایشه).
- `includes/migrate.php`: دکمه‌ی جدای «سوالات متداول» یک‌بار مخفی می‌شه (از «منوی اصلی ربات» قابل فعال‌سازی دوباره). برای اجرا یک‌بار «بروزرسانی دیتابیس» در پنل رو بزن.

## مرحله ۴ — گزارش پشتیبانی AI داخل گروه گزارشات
- فیلد «آیدی عددی گروه/کانال گزارش پشتیبانی AI» از «وضعیت قابلیت‌ها» (ربات) و تنظیمات پنل وب حذف شد.
- دسته‌ی جدید `support_ai` در `includes/report_group.php` → تاپیک «🤖 گفتگوی پشتیبانی AI» در همون گروه گزارشات (موقع اولین گزارش خودکار ساخته می‌شه؛ با «🧪 پیام آزمایشی» هم همین الان ساخته می‌شه).
- تاپیک «🆘 پشتیبانی» حالا فقط مخصوص تیکت‌ها و پشتیبان انسانیه. هر دو دسته از «گزارشات ربات» قابل روشن/خاموش‌ان.
- مقدار قدیمی `support_report_chat_id` در جدول settings دیگه خونده نمی‌شه (بی‌اثر؛ می‌تونی پاکش کنی).

## مرحله ۵ — انتقال درگاه‌های پرداخت از فاکسیما
- قبلاً فقط زرین‌پال، تون‌پی و اطلس‌پی درایور واقعی داشتن؛ بقیه فقط اسمشون توی فهرست بود (🚧 به‌زودی).
- حالا چهار درگاه تومانی هم فعاله: **بلوپال، کیوب‌پی، آبان‌گیت‌وی، واریزا** (`includes/gateways.php`).
- تایید همه سمت سرور و بدون اعتماد به پارامتر مرورگره (استعلام + تطبیق شماره سفارش و مبلغ؛ مغایرت مبلغ → «بررسی دستی» برای ادمین).
- واریزا فقط وب‌هوک داره: فایل جدید `bot/pay_webhook.php` (امضای HMAC-SHA256 روی بدنه‌ی خام). آدرس رو توی پنل واریزا ثبت کن: `https://دامنه/bot/pay_webhook.php?gw=variza`
- هنوز 🚧: فقط «ارزی آفلاین» (جریان دستی با رسید/هش).
- ⚠️ هیچ‌کدوم با درگاه واقعی تست نشده؛ قبل از فروش واقعی با مبلغ کم تست کن. تست دودی: `php tests/gateways_smoke_test.php`

## مرحله ۶ — درگاه‌های ارزی و Telegram Stars
- **Plisio** (TRX، استعلام سمت سرور)، **NowPayments** (IPN امضاشده HMAC-SHA512 + تطبیق مبلغ دلاری)، **ترونادو** (وب‌هوک امضاشده X-Tronado-Sig؛ آدرس ولت/کلید IPN/کارمزد)، **Telegram Stars**.
- نرخ دلار/ترون از SwapWallet (همون منبع فاکسیما) با کش ۲ دقیقه (`gw_market_rates` در `includes/gateways.php`).
- `bot/pay_webhook.php` حالا واریزا + NowPayments + ترونادو رو پوشش می‌ده؛ `bot/stars_pay.php` برای `pre_checkout_query` و `successful_payment`.
- ⚠️ Stars: برخلاف فاکسیما (که روی pre_checkout پرداخت‌شده ثبت می‌کنه)، اینجا فقط با `successful_payment` واقعی تایید می‌شه.
- ⚠️ تست‌نشده با سرویس‌های واقعی؛ هر درگاه رو با مبلغ کم امتحان کن.