# راهنمای به‌روزرسانی سیستم

## قابلیت‌های جدید اضافه شده

### 1. مانیتورینگ نمایندگان
- صفحه مانیتورینگ کلی برای مدیر
- صفحه مانیتورینگ اختصاصی برای هر نماینده
- نمایش آمار ترافیک، کاربران، و وضعیت

### 2. محدودیت‌های نمایندگان
- تعیین حد ترافیک کل برای هر نماینده
- تعیین تاریخ انقضا برای دسترسی نماینده
- ردیابی ترافیک مصرفی نماینده

### 3. مدیریت Inbound های مجاز
- انتخاب inbound های مجاز برای هر نماینده
- نماینده فقط می‌تواند از inbound های تعریف شده استفاده کند
- اگر هیچ inbound تعریف نشود، نماینده به همه دسترسی دارد

### 4. لاگ فعالیت‌ها
- ثبت تمام فعالیت‌های نمایندگان (ایجاد، ویرایش، حذف کاربر)
- نمایش IP و زمان هر فعالیت

## نصب به‌روزرسانی

### اگر از قبل سیستم را نصب کرده‌اید:

1. **Import کردن فایل به‌روزرسانی:**
   ```sql
   -- فایل database_upgrade.sql را import کنید
   ```

2. **یا استفاده از فایل کامل:**
   - فایل `database_cpanel_complete.sql` را import کنید (اگر دیتابیس خالی است)

### اگر سیستم جدید نصب می‌کنید:

1. فایل `database_cpanel_complete.sql` را import کنید
2. فایل `setup.php` یا `fix_password.php` را اجرا کنید

## تغییرات در دیتابیس

### جدول representatives (جدول نمایندگان)
- `traffic_limit` - حد ترافیک کل نماینده (بایت)
- `used_traffic` - ترافیک مصرف شده نماینده (بایت)
- `expiry_date` - تاریخ انقضای دسترسی نماینده

### جدول جدید: representative_inbounds
- ذخیره inbound های مجاز برای هر نماینده
- هر نماینده فقط می‌تواند از inbound های تعریف شده استفاده کند

### جدول جدید: representative_logs
- ثبت تمام فعالیت‌های نمایندگان
- شامل: ایجاد کاربر، ویرایش کاربر، حذف کاربر

## استفاده از قابلیت‌های جدید

### برای مدیر:

1. **افزودن نماینده با محدودیت:**
   - در صفحه "مدیریت نمایندگان"
   - هنگام افزودن نماینده، می‌توانید:
     - حد ترافیک کل را تعیین کنید
     - تاریخ انقضا را تعیین کنید
     - inbound های مجاز را انتخاب کنید

2. **ویرایش محدودیت‌ها:**
   - روی آیکون ویرایش نماینده کلیک کنید
   - محدودیت‌ها را تغییر دهید

3. **مدیریت Inbound های مجاز:**
   - روی آیکون "مدیریت Inbound ها" کلیک کنید
   - inbound های مجاز را اضافه/حذف کنید

4. **مانیتورینگ:**
   - از منوی "مانیتورینگ" وارد شوید
   - یا روی آیکون مانیتورینگ هر نماینده کلیک کنید

### برای نماینده:

1. **مشاهده محدودیت‌ها:**
   - در صفحه "مدیریت کاربران" محدودیت‌های شما نمایش داده می‌شود

2. **استفاده از inbound های مجاز:**
   - فقط inbound های تعریف شده توسط مدیر را می‌بینید
   - اگر هیچ inbound تعریف نشود، همه inbound ها را می‌بینید

3. **هشدارها:**
   - اگر دسترسی منقضی شده باشد، هشدار نمایش داده می‌شود
   - اگر ترافیک تمام شده باشد، هشدار نمایش داده می‌شود

## نکات مهم

1. **همگام‌سازی ترافیک:**
   - برای به‌روزرسانی خودکار ترافیک نمایندگان، اسکریپت `sync_traffic.php` را به‌روزرسانی کنید
   - باید `used_traffic` نماینده را از مجموع ترافیک کاربرانش محاسبه کند

2. **بررسی انقضا:**
   - سیستم به صورت خودکار وضعیت نمایندگان را بررسی می‌کند
   - نمایندگان منقضی شده نمی‌توانند کاربر جدید بسازند

3. **محدودیت ترافیک:**
   - اگر ترافیک نماینده تمام شود، نمی‌تواند کاربر جدید بسازد
   - اما کاربران موجود همچنان فعال می‌مانند

## پشتیبانی

در صورت بروز مشکل:
1. لاگ خطاها را بررسی کنید
2. دیتابیس را بررسی کنید
3. مطمئن شوید تمام جداول ایجاد شده‌اند
