GANG STRATEGY BOT — نسخه ارتقایافته PHP برای cPanel
====================================================

محتویات بسته
- index.php: ربات PHP با وب‌هوک تلگرام
- game-data.json: اطلاعات کشورها، گروه‌ها، فروشگاه و شرکت‌ها
- .htaccess: جلوگیری از فهرست‌شدن پوشه و دسترسی مستقیم به فایل دیتابیس/لاگ/داده
- CHANGELOG-fa.txt: تغییرات این نسخه

نیازمندی‌ها
- PHP 8.0 یا جدیدتر (توصیه: PHP 8.2 یا 8.3)
- افزونه‌های cURL، PDO و PDO_SQLite فعال
- دامنه با HTTPS معتبر
- امکان نوشتن در پوشه برنامه برای SQLite و gang-error.log
- ربات تلگرام ساخته‌شده با BotFather

نصب تازه
1) از فایل ZIP استخراج کن و فایل‌های داخل پوشه gang-next-package را در پوشه‌ای مثل public_html/gang/ آپلود کن.
2) در ابتدای index.php مقدار BOT_TOKEN را با توکن واقعی و ADMIN_ID را با آیدی عددی مدیر جایگزین کن. توکن را به هیچ‌کس نده.
3) CRON_SECRET را با یک رشته تصادفی طولانی (حداقل 32 نویسه) جایگزین کن. آن را در پیام عمومی نفرست.
4) برای امنیت وب‌هوک، یک WEBHOOK_SECRET تصادفی شامل حروف انگلیسی، عدد، _ یا - تعیین کن. اگر آن را تنظیم می‌کنی، حتماً پیش از راه‌اندازی وب‌هوک همان مقدار را در فایل قرار بده.
5) مطمئن شو game-data.json کنار index.php قرار دارد و PHP اجازه نوشتن در پوشه را دارد.
6) برای تشخیص وضعیت، آدرس زیر را باز کن:
   https://YOUR-DOMAIN/gang/index.php?diag=YOUR_CRON_SECRET
   این آدرس اطلاعات فنی می‌دهد؛ آن را منتشر نکن.
7) برای تنظیم وب‌هوک، یک بار این آدرس را باز کن:
   https://YOUR-DOMAIN/gang/index.php?setup_webhook=YOUR_CRON_SECRET
   باید پاسخ Telegram شامل ok=true باشد. سپس پارامتر setup_webhook را دوباره به دیگران نده.
8) در تلگرام /start را به ربات بفرست. مدیر می‌تواند از پنل، «سلامت سیستم و لاگ» را ببیند.

ارتقا از نسخه قبلی
1) قبل از هر چیز از index.php، game-data.json و به‌ویژه game.db نسخه پشتیبان بگیر.
2) برای حفظ اطلاعات، فایل game.db را حذف یا جایگزین نکن.
3) index.php جدید را آپلود کن؛ game-data.json را فقط اگر نسخه فعلی خودت سفارشی نشده، جایگزین کن.
4) پس از آپلود، diag و سپس /start را بررسی کن.

مهم
- این پروژه PHP است؛ requirements.txt و pip لازم نیست.
- آدرس setup_webhook و diag باید محرمانه بماند؛ CRON_SECRET پیش‌فرض را حتماً تغییر بده.
- اگر WEBHOOK_SECRET فعال است، وب‌هوک فقط درخواست دارای هدر امنیتی معتبر را می‌پذیرد.
- اگر ربات پاسخ نداد، فایل gang-error.log را از File Manager هاست بررسی کن. فایل لاگ شامل اطلاعات فنی است و نباید عمومی شود.
- اجرای درآمد روزانه از طریق cron اختیاری است؛ آدرس cron فقط پس از تنظیم CRON_SECRET معتبر قابل فراخوانی است. در cPanel زمان‌بندی را روزی یک‌بار قرار بده و آدرس محرمانه را در اختیار دیگران نگذار.
- از ساخت چند Cron هم‌زمان برای درآمد روزانه خودداری کن تا درآمد دوبار پرداخت نشود.
- اتصال زنده به توکن واقعی و هاست شما از محیط ساخت قابل آزمایش نیست؛ پیش از انتشار عمومی، با حساب آزمایشی بررسی کن.

مدیریت کاربران و موجودی در پنل مدیر:
1. از پنل مدیریت گزینه «مشاهده همه کاربران» را بزن.
2. فهرست صفحه‌بندی‌شده کاربران نمایش داده می‌شود؛ روی هر کاربر بزن تا کارت او باز شود.
3. در کارت کاربر از «افزودن موجودی» یا «کم‌کردن موجودی» استفاده کن و مبلغ را به صورت عدد صحیح مثبت بفرست.
4. کم‌کردن موجودی فقط وقتی انجام می‌شود که کاربر به اندازه مبلغ واردشده بودجه داشته باشد.
5. برای لغو هر ورودی، /cancel را بفرست. عملیات افزودن/کسر موجودی در گزارش اقدامات مدیر ثبت می‌شود.
