# Mirza Pro 4.0 Merged — راهنمای ارتقا

این بسته بر پایه نسخه پرو ساخته شده است؛ امکانات قبلی حذف نشده‌اند و فروش
محصولات متنی از همان چرخه محصول، فاکتور، کیف پول و درگاه‌های پرداخت ربات
استفاده می‌کند.

پنل وب مدرن، فایل‌های اختصاصی و Mini App نسخه `mirzabot-0.3` نیز روی هسته
گسترده‌تر `mirza_pro-3.8-Stable` ادغام شده‌اند. سیستم زبان جدید در کنار
کلیدهای قدیمی و اختصاصی Pro کار می‌کند.

سازگاری API پنل‌های جدید مرزبان (`proxy_settings` و `group_ids`) حفظ شده و
نرخ‌های ارز موفق تا دو ساعت cache می‌شوند تا قطعی کوتاه API باعث توقف کامل
پرداخت نشود. نرخ منقضی‌شده برای پرداخت استفاده نمی‌شود.

## ارتقا روی نصب موجود

1. پیش از جایگزینی فایل‌ها از دیتابیس و `config.php` نسخه پشتیبان بگیرید.
2. فایل‌های بسته را روی فایل‌های برنامه جایگزین کنید، اما اطلاعات اتصال موجود
   در `config.php` را حفظ کنید.
3. `table.php` را فقط یک‌بار با روش استاندارد نصب‌کننده اجرا کنید تا ستون‌های
   جدید دکمه‌ها و جدول فهرست ایموجی پرمیوم ساخته شوند.
4. در پنل وب، بخش «اکانت و محصول متنی» را باز کنید و بخش فروش، محصول و موجودی
   را بسازید.
5. برای استفاده از ایموجی پرمیوم، متن دکمه را همراه همان ایموجی از حساب ادمین
   برای ربات بفرستید. شناسه به‌صورت خودکار تشخیص داده و روی دکمه اعمال می‌شود؛
   همان ایموجی برای انتخاب در پنل وب نیز به فهرست اضافه خواهد شد.

## رفتار دکمه‌ها

- رنگ‌های واقعی مطابق Telegram Bot API 9.4 عبارت‌اند از آبی، سبز، قرمز و
  حالت پیش‌فرض. مقادیر قدیمی رنگ به این مقادیر تبدیل می‌شوند.
- `icon_custom_emoji_id` بدون نیاز به افزودن ایموجی عادی قبل از عنوان دکمه
  ارسال می‌شود.
- برای هر بخش فروش متنی می‌توان دکمه مستقل، ردیف، ترتیب، رنگ و ایموجی تعریف
  کرد. تعداد بخش‌ها محدودیت داخلی ندارد.
- نام خود بخش، عنوان دکمه و مشخصات هر محصول از پنل وب قابل ویرایش است. تغییر
  نام بخش، محصولات و فاکتورهای وابسته را در یک تراکنش هماهنگ می‌کند.

## موجودی متنی

- حالت «هر خط یک آیتم» برای نام‌کاربری/رمز یا کدهای یک‌خطی است.
- برای آیتم چندخطی، بین هر دو آیتم یک خط شامل `---ITEM---` قرار دهید.
- هر آیتم در تراکنش خرید فقط یک‌بار رزرو و با وضعیت فروخته‌شده ثبت می‌شود.
- حذف موجودی از پنل وب فقط آیتم‌های فروخته‌نشده را حذف می‌کند.

## ویرایش متن‌ها

صفحه «ویرایش همه متن‌ها» هم ردیف‌های قدیمی `textbot` و هم تمام کلیدهای
چندلایه فایل زبان فارسی را پوشش می‌دهد. تغییر متن‌های پیش‌فرض به‌صورت override
در دیتابیس ذخیره می‌شود تا فایل اصلی زبان و امکان ارتقای بعدی حفظ شود.

## کنترل نهایی این بسته

- فایل‌های API اصلی پنل (`category`, `panels`, `utils`, `log`, `statbot`) با
  نسخه جدید میرزا بات همسان شده‌اند و قابلیت‌های گسترده‌تر نسخه Pro حفظ شده‌اند.
- توابع سازگاری `rate_arze`، `outputlink` و `parseConfigs` برای کدهای جدید نیز
  در دسترس‌اند.
- خرید هم‌زمان موجودی متنی با قفل ردیف و تراکنش انجام می‌شود تا یک آیتم به دو
  خریدار تحویل نشود.
