# 🦊 Red Fox — ربات هوشمند فروش VPN

> **Red Fox** یک ربات تلگرامی **فروش خودکار VPN** است.
> این پروژه یک **فورکِ بازطراحی‌شده، بهینه‌سازی‌شده و اصلاح‌شده** از پروژه‌ی متن‌باز
> [Faoxima](https://github.com/Mmd-Amir/Faoxima) (که خودش برگرفته از ربات میرزاست) می‌باشد.

<p align="center"><strong>زبان:</strong> PHP 8.2 / 8.3 &nbsp;•&nbsp; <strong>نیاز:</strong> Cron Job (اجباری) &nbsp;•&nbsp; <strong>لایسنس:</strong> GPLv3</p>

---

## ⚖️ اعتبار و لایسنس (مهم)

- این پروژه تحت **GNU General Public License v3 (GPLv3)** منتشر شده است —
  همان لایسنس پروژه‌ی بالادستی (Faoxima). استفاده، تغییر و بازنشر مجاز است،
  **به‌شرطی که نسخه‌ی مشتق‌شده نیز GPLv3 بماند و منبع اصلی ذکر شود.**
- با تشکر و قدردانی از:
  - پروژه‌ی **[Faoxima](https://github.com/Mmd-Amir/Faoxima)** (ریفکتورکننده‌ی اصلی)
  - و ربات **[میرزا (Mirza)](https://github.com/mahdiMGF2/mirzabot)**

---

## ✨ تفاوت Red Fox با نسخه‌ی پایه

علاوه بر تمام امکانات Faoxima، در Red Fox موارد زیر انجام/اصلاح شده‌اند:

- 🏷️ **بازنویسی کامل برند** — تغییر نام، شناسه‌ها، کلاس‌ها و متون از Faoxima به Red Fox (فارسی: رد فاکس).
- 🐛 **رفع باگ واقعی** — برای نمونه باگ `api/statbot.php` که بدنه‌ی JSON درخواست را اصلاً نمی‌خواند (متغیر `$data` تعریف‌نشده بود → لاگ همیشه null و هشدار PHP).
- 🔒 **سخت‌گیری امنیتی** — حذف رمز پیش‌فرض ضعیف phpMyAdmin در نصب‌کننده و جایگزینی با یک رمز تصادفیِ قوی در زمان نصب.
- ✅ **بازرسی کامل نحوی** — تمام فایل‌های PHP (۲۰۳ فایل) با `php -l` و تحلیل استاتیک PHPStan بررسی شده‌اند.

---

## 🧩 پنل‌های پشتیبانی‌شده

| پنل | پشتیبانی |
|-----|----------|
| Marzban (مرزبان) / Marzneshin / پاسارگاد | ✅ |
| x-ui / Alireza / s-ui | ✅ |
| Hiddify (هیدی‌فای) | ✅ |
| Mikrotik (میکروتیک) | ✅ |
| IBSng | ✅ |
| WGDashboard (WireGuard) | ✅ |

کانفیگ‌ها به‌صورت خودکار ساخته می‌شوند و با تمام پروتکل‌های رایج (V2ray/Xray و …) سازگارند.

---

## 💳 درگاه‌های پرداخت

- 💵 کارت به کارت (دستی + تأیید رسید)
- 🪙 رمزارز: NowPayments, Plisio, Tronado
- 🇮🇷 درگاه ایرانی: زرین‌پال، آقای‌پرداخت، ایران‌پی
- 🆕 TetraPay (داخل خود ربات)

---

## 🛒 امکانات فروش و فروشگاه

- فروش خودکار VPN همراه با ساخت خودکار کانفیگ
- اکانت تست/رایگان برای کاربران جدید
- QR کد برای ایمپورت سریع کانفیگ
- خرید حجم دلخواه + خرید حجم و زمان اضافه
- تمدید سرویس (چند روش)
- مدیریت انبار/موجودی پیشرفته (فروش عمده‌ی دستی، پنل اضطراری)

---

## 👤 امکانات سمت کاربر

- مینی‌اپ تلگرام (Telegram Mini App) با رابط مدرن
- کیف پول و موجودی، مدیریت سرویس‌ها (تمدید، خرید حجم، دریافت کانفیگ)
- تأیید با شماره تلفن، عضویت اجباری در کانال
- بخش پشتیبانی، سوالات متداول و آموزش‌های قابل‌سفارشی‌سازی
- کارت رنگی مشاهده‌ی حجم

---

## 📈 رشد و بازاریابی

- سیستم زیرمجموعه‌گیری (افیلیت) و نمایندگی (Reseller)
- کش‌بک، کد تخفیف، کد هدیه، قرعه‌کشی

---

## 🛠️ پنل مدیریت تحت وب

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

---

## ⏰ خودکارسازی (Cron Job)

یادآوری انقضای سرویس، تأیید خودکار پرداخت و محاسبه‌ی کش‌بک، ارسال پیام انبوه
صف‌بندی‌شده، پایش آپ‌تایم پنل‌ها، و بکاپ‌گیری خودکار.

---

## 🌐 امکانات فنی

- **پشتیبانی از پروکسی خروجی** برای هاست‌های ایران (ترافیک تلگرام و پنل، جداگانه پیکربندی‌پذیر با HTTP/SOCKS).
- اجرا روی هاست اشتراکی (CyberPanel / aaPanel) یا سرور اوبونتو ۲۲.

---

## 🚀 نصب

### روی سرور (اوبونتو ۲۲)
```bash
bash install.sh
```

### مستندات بیشتر
- [آموزش نصب روی هاست (CyberPanel / aaPanel)](host.md)
- [آموزش نصب روی سرور (Ubuntu 22)](server.md)

---

## 📊 اطلاعات کلی

| مورد | نسخه |
|------|------|
| Red Fox | `1.0.0-redfox` |
| PHP | 8.2 / 8.3 |
| Cron Job | اجباری |
| لایسنس | GPLv3 |

---

## 🤝 مشارکت

این یک پروژه‌ی متن‌باز است. Pull Request و گزارش باگ به‌دلیل بهبود پروژه خوش‌آمد است؛
لطفاً توجه داشته باشید که پروژه باید تحت GPLv3 باقی بماند.

---

*Red Fox بر پایه‌ی کار متن‌باز جامعه‌ی Faoxima و Mirza ساخته شده است. با تشکر از آن‌ها.* 🦊
