==================================================
راهنمای نصب ربات استعلام/تمدید (ویندوز لند)
==================================================

ساختار فایل‌ها:
----------------
config/configs.php     -> توکن، آیدی ادمین‌ها، اتصال دیتابیس
config/updates.php     -> پارس کردن آپدیت ورودی بله
config/keyboards.php   -> کیبوردهای شیشه‌ای
function/functions.php -> توابع کمکی (ارسال پیام، تنظیمات و ...)
bot.php                 -> فایل اصلی که آدرسش را در وبهوک ثبت می‌کنید
commands/               -> دستورات کاربر عادی
admin/admin.php         -> پنل مدیریت شیشه‌ای
crons/renew_check.php   -> کرون روزانه (کم کردن روز باقی‌مانده)
crons/public_message.php-> کرون هر دقیقه (ارسال همگانی، ۱۰۰ نفر در هر اجرا)
db.sql                   -> فایل دیتابیس

مراحل نصب روی هاست اشتراکی (cPanel):
----------------
1) از قسمت MySQL Databases در cPanel یک دیتابیس و یک یوزر بسازید
   و آن یوزر را با تمام دسترسی‌ها (All Privileges) به دیتابیس متصل کنید.
   (روی هاست اشتراکی معمولا اجازه CREATE DATABASE از طریق SQL را ندارید،
   به همین دلیل باید دیتابیس را از خود پنل هاست بسازید، نه از phpMyAdmin)

2) وارد phpMyAdmin شوید، دیتابیسی که ساختید را از سمت چپ انتخاب کنید
   (حتما قبل از ایمپورت باید دیتابیس انتخاب/باز باشد)
   سپس از تب Import فایل db.sql را ایمپورت کنید.

3) کل پوشه پروژه را (با File Manager یا FTP) روی هاست آپلود کنید،
   مثلا در مسیر public_html/windowsland-bot

4) فایل config/configs.php را باز کرده و مقادیر زیر را جایگزین کنید:
   - API_KEY    : توکنی که از پشتیبانی بله دریافت کرده‌اید
   - $adminsList: آیدی عددی حساب بله خودتان، مثال: [123456789]
   - $hostName / $userName / $password / $dbName : اطلاعات دیتابیسی که در مرحله 1 ساختید
     (معمولا hostName روی هاست اشتراکی هم localhost است)

   نکته برای گرفتن آیدی عددی خودتان:
   یک بار به ربات پیام /start بدهید، بعد در جدول users دیتابیس (از phpMyAdmin)
   مقدار ستون chat_id را ببینید و همان را در $adminsList قرار دهید.

5) ثبت وبهوک: کافیست یک بار آدرس زیر را در مرورگر باز کنید
   (TOKEN و آدرس دامنه خودتان را جایگزین کنید):

   https://tapi.bale.ai/botTOKEN/setWebhook?url=https://yourdomain.com/windowsland-bot/bot.php

   اگر خروجی "ok":true را دیدید یعنی وبهوک با موفقیت ثبت شد.

6) از بخش Cron Jobs در cPanel دو کرون‌جاب زیر را اضافه کنید:

   الف) کرون کاهش روزانه (یک‌بار در روز، ساعت 00:01 به وقت سرور):
        دستور:
        php -q /home/USERNAME/public_html/windowsland-bot/crons/renew_check.php

   ب) کرون ارسال همگانی (هر دقیقه):
        دستور:
        php -q /home/USERNAME/public_html/windowsland-bot/crons/public_message.php

   مسیر /home/USERNAME/public_html/windowsland-bot را با مسیر واقعی روی هاست خودتان جایگزین کنید
   (مسیر دقیق را می‌توانید از قسمت File Manager هاست خودتان پیدا کنید).

نحوه‌ی کار ربات:
----------------
* کاربر عادی با /start پیام خوش‌آمد + دکمه‌های شیشه‌ای
  «استعلام ربات»، «راهنما» و «پشتیبانی» را می‌بیند.

* استعلام ربات: یوزرنیم ربات را می‌پرسد؛
  - پیدا نشد: «رباتی با این یوزرنیم یافت نشد»
  - پیدا شد و روز باقی دارد: تعداد روز + دکمه «ورود به ربات»
  - روزهای باقی‌مانده صفر شده: هشدار تمدید + دکمه پشتیبانی (در صورت تنظیم)

* پنل مدیریت (فقط برای آیدی‌های داخل $adminsList): با /start یا /admin باز می‌شود،
  کاملا با دکمه شیشه‌ای کار می‌کند:
  - افزودن ربات (یوزرنیم سپس تعداد روز)
  - حذف ربات (نمایش لیست، سپس گرفتن یوزرنیم برای حذف)
  - لیست ربات‌ها
  - تنظیم متن راهنما
  - تنظیم یوزرنیم پشتیبانی
  - ارسال همگانی (متن، سپس در صورت تمایل دکمه و لینک، سپس تایید نهایی -
    کرون هر دقیقه 100 نفر ارسال می‌کند)
  - آمار ربات

نکات مهم:
----------------
- اگر بعد از نصب ربات هیچ جوابی نداد، احتمالا رنج آیدی سرورهای بله در
  bot.php ($bale_ip_ranges) عوض شده. در این صورت خطوط بررسی IP در ابتدای
  bot.php را کامنت کنید تا مشکل برطرف شود.
- توکن ربات را جایی عمومی (مثلا گیت‌هاب عمومی) قرار ندهید.
- اگر خواستید بعدا امکان مسدودسازی کاربر یا آمار پیشرفته‌تر اضافه کنید،
  همین ساختار به راحتی قابل توسعه است.
