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

ساختار فایل‌ها:
----------------
config/config.php      -> تنظیمات (توکن، ادمین، دیتابیس)
sql/database.sql        -> اسکریپت ساخت دیتابیس و جداول
includes/Database.php   -> اتصال به دیتابیس
includes/BaleAPI.php    -> ارتباط با API بله
includes/functions.php  -> توابع مشترک و کیبوردهای شیشه‌ای
bot/webhook.php          -> ورودی اصلی ربات (باید در setWebhook ثبت شود)
cron/renew_check.php    -> کرون روزانه (کم کردن روز باقی‌مانده هر ربات)
cron/broadcast.php      -> کرون هر دقیقه (ارسال همگانی، ۱۰۰ نفر در هر اجرا)
setup_webhook.php       -> برای ثبت آدرس وبهوک (یک‌بار مصرف)

مراحل نصب:
----------------
1) پروژه را روی هاست/سرور خود آپلود کنید (باید SSL/HTTPS فعال باشد).

2) فایل sql/database.sql را با phpMyAdmin یا دستور زیر ایمپورت کنید:
   mysql -u root -p < sql/database.sql

3) فایل config/config.php را باز کرده و مقادیر زیر را تنظیم کنید:
   - BOT_TOKEN     : توکن ربات که از بله دریافت کرده‌اید
   - ADMIN_IDS     : آیدی عددی (chat_id) حساب بله خودتان (می‌توانید چند نفر اضافه کنید)
   - DB_HOST / DB_NAME / DB_USER / DB_PASS : اطلاعات دیتابیس که در مرحله ۲ ساختید

   نکته برای گرفتن chat_id خودتان:
   می‌توانید موقتاً یک خط لاگ در ابتدای bot/webhook.php اضافه کنید:
       error_log(print_r($update, true));
   سپس یک بار به ربات پیام /start بدهید و مقدار chat.id را از لاگ سرور بردارید.

4) فایل setup_webhook.php را باز کرده و آدرس واقعی bot/webhook.php روی هاست
   خودتان را در متغیر $webhookUrl قرار دهید. سپس این فایل را یک‌بار از طریق
   مرورگر باز کنید تا وبهوک ثبت شود. خروجی باید شامل "ok": true باشد.
   بعد از این مرحله، بهتر است فایل setup_webhook.php را از روی سرور حذف کنید.

5) دو کرون‌جاب زیر را در پنل هاست (مثلاً cPanel > Cron Jobs) تعریف کنید:

   الف) کرون کاهش روزانه‌ی روزهای باقی‌مانده (یک‌بار در روز - نزدیک نیمه‌شب):
        1 0 * * * php /path/to/bale-bot/cron/renew_check.php >> /path/to/bale-bot/cron/renew_check.log 2>&1

   ب) کرون ارسال همگانی (هر دقیقه):
        * * * * * php /path/to/bale-bot/cron/broadcast.php >> /path/to/bale-bot/cron/broadcast.log 2>&1

   مسیر "/path/to/bale-bot" را با مسیر واقعی پروژه روی سرور جایگزین کنید.

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

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

* راهنما: متنی که از پنل مدیریت تنظیم کرده‌اید نمایش داده می‌شود.

* پشتیبانی: اگر یوزرنیم پشتیبانی را از پنل مدیریت تنظیم کرده باشید،
  دکمه‌ی شیشه‌ای «ارتباط با پشتیبانی» مستقیم به پی‌وی همان یوزرنیم لینک می‌شود.

* پنل مدیریت (فقط برای ADMIN_IDS): با دستور /start یا /admin باز می‌شود،
  کاملاً با دکمه‌های شیشه‌ای کار می‌کند:
  - افزودن ربات: یوزرنیم را می‌پرسد سپس تعداد روز باقی‌مانده تا تمدید را می‌پرسد
  - حذف ربات: یوزرنیم را می‌پرسد و در صورت وجود حذف می‌کند
  - لیست ربات‌ها: تمام ربات‌های ثبت‌شده + روز باقی‌مانده را نشان می‌دهد
  - تنظیم متن راهنما
  - تنظیم یوزرنیم پشتیبانی
  - ارسال همگانی: ابتدا متن، سپس در صورت تمایل متن و لینک دکمه، سپس تأیید نهایی
    (توسط کرون broadcast.php هر دقیقه ۱۰۰ نفر ارسال می‌شود)
  - آمار: تعداد کاربران، تعداد ربات‌های ثبت‌شده، تعداد ربات‌های منقضی‌شده

نکات امنیتی:
----------------
- حتماً بعد از نصب، فایل setup_webhook.php را حذف یا با htaccess محدود کنید.
- دسترسی مستقیم به پوشه‌های config/ و includes/ و sql/ را در وب‌سرور
  (با .htaccess یا تنظیمات Nginx) مسدود کنید تا کسی نتواند مستقیم این فایل‌ها
  را در مرورگر باز کند.
- توکن ربات را در جایی عمومی (گیت‌هاب عمومی و ...) قرار ندهید.
