Fix: Username generation, RTL button layout, and Cron file paths

README.md

@@ -1,135 +1,75 @@
-ربات تلگرام ویزارد پنل (Wizard Panel) - مدیریت فروش اکانت مرزبان
+# WizardPanel Pro (Enhanced Web Edition) 🚀
 
-ویزارد پنل (Wizard Panel) یک سورس ربات تلگرام پیشرفته و قدرتمند برای مدیریت و فروش خودکار اکانت‌های پنل مرزبان (Marzban) است. این ربات که با PHP و پایگاه داده MySQL توسعه یافته، به شما اجازه می‌دهد تا به راحتی چندین سرور مرزبان را مدیریت کرده و فرآیند فروش کانفیگ‌های V2Ray را به طور کامل اتوماتیک کنید.
+> **نسخه پیشرفته و توسعه‌یافته WizardPanel با پنل مدیریت وب و مینی‌اپ تلگرام**
 
-هدف اصلی ویزارد پنل، فراهم کردن یک ابزار حرفه‌ای، امن و با قابلیت شخصی‌سازی بالا برای مدیران سرورهای VPN است تا بتوانند کسب‌وکار خود را بدون دغدغه و به سادگی مدیریت کنند.
+این پروژه یک فورک اساسی و توسعه‌یافته از [WizardPanel](https://github.com/webwizards-team/wizardpanel) است. در حالی که نسخه اصلی صرفاً یک ربات تلگرام CLI بود، این نسخه با افزودن **رابط کاربری تحت وب (Web Interface)**، قدرت مدیریت و کاربری را به سطح کاملاً جدیدی ارتقا داده است.
 
-![Wizard Panel](https://raw.githubusercontent.com/webwizards-team/wizardpanel/e67cc64f01ef7808c9c65850f91606ea56451cfb/wizardpanel.png)
+---
 
-✨ ویژگی‌های کلیدی ویزارد پنل (Wizard Panel)
+## ✨ ویژگی‌های جدید و متمایز (New Features)
 
-🚀 مدیریت چند سرور مرزبان: به راحتی چندین سرور مرزبان را اضافه، مدیریت و حذف کنید. هنگام ساخت پلن، انتخاب کنید که روی کدام سرور ساخته شود.
+تغییر اصلی در این نسخه، اضافه شدن پوشه `web/` است که شامل دو بخش مجزا و قدرتمند می‌باشد:
 
-🔐 پنل مدیریت قدرتمند و با دسترسی طبقه‌بندی شده:
+### 1. 🌐 پنل مدیریت تحت وب (Web Admin Panel)
+دیگر نیازی نیست همه کارها را با دستورات تلگرام انجام دهید! اکنون یک پنل مدیریت کامل در اختیار دارید:
+- **مدیریت داشبورد:** مشاهده آمار فروش، کاربران آنلاین و وضعیت سرورها به صورت گرافیکی.
+- **مدیریت کاربران:** مشاهده لیست کامل کاربران، موجودی، سرویس‌ها و ویرایش اطلاعات آنها.
+- **مدیریت سرورها:** افزودن و ویرایش سرورهای Marzban/Sanaei/Marzneshin از طریق وب.
+- **مدیریت پلن‌ها و دسته‌بندی‌ها:** تعریف قیمت، حجم و مدت زمان سرویس‌ها با رابط کاربری آسان.
+- **مدیریت مالی:** مشاهده و تایید/رد درخواست‌های افزایش موجودی و کارت‌به‌کارت.
+- **سیستم تیکتینگ:** پاسخگویی به تیکت‌های پشتیبانی کاربران از محیط وب.
+- **ارسال همگانی:** ارسال پیام به همه کاربران با سرعت بالا.
 
-مدیریت کامل سرورها، دسته‌بندی‌ها و پلن‌های فروش.
+### 2. 📱 مینی‌اپ تلگرام (User Mini App)
+تجربه کاربری مدرن برای مشتریان شما با استفاده از Telegram Web App:
+- **خرید و تمدید آسان:** رابط کاربری گرافیکی برای انتخاب سرور و پلن.
+- **کیف پول پیشرفته:** امکان افزایش موجودی، آپلود رسید کارت‌به‌کارت و مشاهده تراکنش‌ها.
+- **مشاهده سرویس‌ها:** نمایش وضعیت سرویس، حجم باقی‌مانده و تاریخ انقضا با گرافیک زیبا.
+- **پشتیبانی:** ارسال تیکت و دریافت پاسخ در محیط چت‌مانند.
+- **احراز هویت امن:** لاگین خودکار و ایمن با استفاده از داده‌های تلگرام.
 
-قابلیت ویرایش کامل اطلاعات پلن‌ها (نام، قیمت، حجم، مدت، سرور و...).
 
-مدیریت کاربران (افزایش/کاهش موجودی، ارسال پیام، مسدود/آزاد کردن).
+---
 
-عملیات همگانی روی تمام سرویس‌ها (افزایش حجم یا زمان انقضا).
+## 📂 ساختار فایل‌ها (File Structure)
 
-مشاهده آمار دقیق کاربران و درآمد (روزانه، هفتگی، ماهانه).
+```
+src/
+├── api/                # ارتباط با پنل‌های مرزبان و ...
+├── includes/           # توابع و تنظیمات اصلی (هسته ربات)
+├── web/                # <--- بخش جدید اضافه شده
+│   ├── assets/         # فایل‌های CSS, JS, Images
+│   ├── pages/          # صفحات پنل ادمین (Users, Plans, Servers...)
+│   ├── user/           # صفحات مینی‌اپ کاربر (Wallet, Shop, Renew...)
+│   ├── login.php       # صفحه ورود ادمین
+│   └── index.php       # داشبورد اصلی
+├── bot.php             # هسته ربات تلگرام
+└── install.php         # اسکریپت نصب خودکار
+```
 
-مدیریت روش‌های پرداخت و درگاه‌ها.
+---
 
-سیستم مدیریت ادمین‌ها با قابلیت تعریف دسترسی‌های مختلف (فقط برای ادمین اصلی).
+## 🛠 نصب و راه‌اندازی (Installation)
 
-🛒 فرآیند خرید کاملاً خودکار برای کاربر:
+1. **آپلود فایل‌ها:** کل محتویات پوشه `src` را در هاست خود آپلود کنید.
+2. **نصب:** فایل `install.php` را در مرورگر اجرا کنید تا دیتابیس ساخته شود.
+3. **تنظیم وبهوک:** وبهوک ربات را به فایل `bot.php` ست کنید.
+4. **تنظیم وب‌اپ:** در BotFather، آدرس `https://your-domain.com/web/user/` را به عنوان Menu Button URL تنظیم کنید.
 
-مشاهده دسته‌بندی‌ها و پلن‌های هر سرور.
+#
 
-شارژ حساب از طریق کارت به کارت و تایید توسط ادمین.
+---
 
-خرید آنی سرویس و دریافت کانفیگ بلافاصله پس از خرید.
+## 📸 اسکرین‌شات‌ها
 
-مشاهده و مدیریت سرویس‌های فعال.
+*پنل ادمین*
+![توضیح عکس](web-admin.png)
 
-دریافت کانفیگ تست رایگان (با قابلیت محدودسازی توسط ادمین).
 
-سیستم تیکتینگ برای پشتیبانی.
+*پنل مینی اپ*
+![توضیح عکس](mini-app.jpg)
 
-🔔 سیستم اعلان‌های هوشمند (Cron Job):
+---
 
-ارسال هشدار خودکار به کاربران قبل از اتمام حجم یا زمان سرویس.
-
-ارسال پیام یادآوری به کاربران غیرفعال.
-
-🔗 عضویت اجباری در کانال (Force Join):
-
-قابلیت فعال/غیرفعال‌سازی و تنظیم کانال تلگرام.
-
-دکمه هوشمند "✅ عضو شدم" برای تجربه کاربری بهتر.
-
-✅ سیستم احراز هویت کاربران:
-
-امکان فعال‌سازی تایید هویت کاربران جدید (از طریق شماره تماس یا دکمه شیشه‌ای) قبل از استفاده از ربات.
-
-🎁 ابزارهای بازاریابی:
-
-سیستم مدیریت کدهای تخفیف (درصدی و مبلغی).
-
-قابلیت تعریف هدیه خوش‌آمدگویی (شارژ اولیه) برای کاربران جدید.
-
-⚙️ نصب و ارتقا آسان:
-
-دارای اسکریپت نصب خودکار (install.php) که جداول دیتابیس را ساخته و وبهوک را تنظیم می‌کند.
-
-🔧 راهنمای نصب و راه‌اندازی
-
-نصب ویزارد پنل بسیار ساده است و در چند مرحله انجام می‌شود:
-
-دانلود سورس: ابتدا سورس کامل پروژه را از این مخزن گیت‌هاب دانلود کنید.
-
-آپلود در هاست: فایل‌های دانلود شده را در هاست خود (در یک پوشه مانند bot یا روت اصلی) آپلود کنید.
-
-ساخت دیتابیس: یک پایگاه داده (Database) جدید از نوع MySQL یا MariaDB در هاست خود ایجاد کنید. اطلاعات دیتابیس (نام، نام کاربری و رمز عبور) را یادداشت کنید.
-
-ساخت ربات در تلگرام:
-
-به ربات @BotFather در تلگرام بروید.
-
-یک ربات جدید بسازید و توکن (Token) آن را کپی کنید.
-
-شناسه عددی اکانت تلگرام خودتان را که می‌خواهید ادمین اصلی باشد، از ربات‌هایی مانند @userinfobot دریافت کنید.
-
-اجرای اسکریپت نصب:
-
-فایل install.php را در مرورگر خود باز کنید. (مثال: https://yourdomain.com/bot/install.php)
-
-فرم نصب نمایش داده می‌شود. اطلاعات زیر را با دقت وارد کنید:
-
-توکن ربات: توکنی که از BotFather گرفتید.
-
-آیدی عددی ادمین اصلی: شناسه عددی اکانت تلگرام خودتان.
-
-اطلاعات دیتابیس: اطلاعاتی که در مرحله ۳ ایجاد کردید.
-
-روی دکمه "نصب و راه‌اندازی" کلیک کنید. اسکریپت به صورت خودکار جداول را ساخته، فایل config.php را آپدیت کرده و وبهوک (Webhook) را برای ربات شما تنظیم می‌کند.
-
-⚠️ مرحله امنیتی بسیار مهم:
-
-پس از مشاهده پیام موفقیت‌آمیز، بلافاصله فایل install.php را از روی هاست خود حذف کنید. باقی ماندن این فایل یک حفره امنیتی بزرگ محسوب می‌شود.
-
-شروع کار با ربات: به ربات خود در تلگرام رفته و دستور /start را ارسال کنید. منوی مدیریت باید برای شما نمایش داده شود.
-
-cron.php - تنظیم کرون جاب (Cron Job)
-
-برای اینکه سیستم اعلان‌های خودکار (هشدار انقضا و یادآوری به کاربران غیرفعال) کار کند، باید یک کرون جاب در هاست خود تنظیم کنید.
-
-وارد کنترل پنل هاست خود (cPanel, DirectAdmin, etc.) شوید و به بخش Cron Jobs بروید.
-
-یک کرون جاب جدید با تنظیمات زیر ایجاد کنید (توصیه می‌شود هر ۵ دقیقه یکبار اجرا شود):
-
-code
-Bash
-download
-content_copy
-expand_less
-
-*/5 * * * * /usr/bin/php /home/your_username/public_html/botsql/cron.php
-
-توجه: مسیر /usr/bin/php و /home/your_username/... ممکن است در هاست شما متفاوت باشد. مسیر صحیح را از پشتیبانی هاست خود سوال کنید.
-
-🔑 کلمات کلیدی برای جستجو
-
-سورس ربات تلگرام ویزارد پنل، Wizard Panel, ربات پنل مرزبان, سورس ربات فروش v2ray, ربات فروش کانفیگ تلگرام, ربات مرزبان چند سروره, سورس ربات PHP, ربات فروش VPN, ربات مدیریت مرزبان, Marzban panel bot, Marzban multi server bot, Telegram VPN sales bot source.
-
-🤝 مشارکت در پروژه
-
-از مشارکت شما در توسعه و بهبود ویزارد پنل استقبال می‌کنیم. می‌توانید از طریق Pull Request تغییرات خود را ارسال کنید یا با ثبت Issue مشکلات و پیشنهادات خود را با ما در میان بگذارید.
-
-📜 مجوز (License)
-
-این پروژه تحت مجوز MIT منتشر شده است.
+## ❤️ تقدیر و تشکر
+این پروژه بر پایه هسته قدرتمند [WizardPanel](https://github.com/webwizards-team/wizardpanel) بنا شده و با هدف ارائه تجربه کاربری بهتر توسعه یافته است.