# 🎯 راهنمای سریع پنل ادمین RMTO

## ✅ کارهای انجام شده

### 1️⃣ منوی RMTO در سایدبار
- یک منوی جدید با عنوان "سامانه RMTO" به سایدبار پنل ادمین اضافه شده
- آیکون: 📄 با عنوان "تست و دمو RMTO"
- مسیر: `/admin/rmto`

### 2️⃣ کنترلر RMTO
**فایل:** `app/Http/Controllers/Admin/RMTOController.php`

**متدهای موجود:**
- ✅ `index()` - نمایش پنل اصلی
- ✅ `getSettings()` - دریافت تنظیمات
- ✅ `updateSettings()` - ذخیره تنظیمات در `.env`
- ✅ `testConnection()` - تست اتصال
- ✅ `testBillOfLading()` - ثبت بارنامه تستی
- ✅ `getDriverInfo()` - استعلام اطلاعات راننده
- ✅ `getFreighterInfo()` - استعلام اطلاعات ناوگان
- ✅ `sendOTP()` - ارسال کد تایید
- ✅ `getCurrentDate()` - دریافت تاریخ سرور
- ✅ `inquiryRealPerson()` - استعلام کد ملی
- ✅ `inquiryPostalCode()` - استعلام کد پستی

### 3️⃣ Route های Web
**فایل:** `routes/web.php`

```php
Route::prefix('admin/rmto')->middleware(['auth', 'admin'])->name('admin.rmto.')->group(function () {
    Route::get('/', [RMTOController::class, 'index'])->name('index');
    Route::get('/settings', [RMTOController::class, 'getSettings'])->name('settings');
    Route::post('/settings', [RMTOController::class, 'updateSettings'])->name('settings.update');
    Route::post('/test-connection', [RMTOController::class, 'testConnection'])->name('test-connection');
    Route::post('/test-bill', [RMTOController::class, 'testBillOfLading'])->name('test-bill');
    Route::post('/driver-info', [RMTOController::class, 'getDriverInfo'])->name('driver-info');
    Route::post('/freighter-info', [RMTOController::class, 'getFreighterInfo'])->name('freighter-info');
    Route::post('/send-otp', [RMTOController::class, 'sendOTP'])->name('send-otp');
    Route::get('/current-date', [RMTOController::class, 'getCurrentDate'])->name('current-date');
    Route::post('/inquiry/real-person', [RMTOController::class, 'inquiryRealPerson'])->name('inquiry.real-person');
    Route::post('/inquiry/postal-code', [RMTOController::class, 'inquiryPostalCode'])->name('inquiry.postal-code');
});
```

### 4️⃣ صفحه View
**فایل:** `resources/views/admin/rmto/index.blade.php`

**تب‌های موجود:**
1. 📊 **داشبورد** - نمایش وضعیت و راهنما
2. ⚙️ **تنظیمات** - مدیریت اطلاعات کاربری RMTO
3. 📄 **ثبت بارنامه** - فرم کامل ثبت بارنامه تستی
4. 👨‍✈️ **اطلاعات راننده** - استعلام با کارت هوشمند یا کد ملی
5. 🚚 **اطلاعات ناوگان** - استعلام با کارت هوشمند
6. 📱 **ارسال OTP** - ارسال کد تایید به موبایل
7. 🔍 **استعلام‌ها** - استعلام کد ملی و کد پستی

---

## 🚀 نحوه استفاده

### مرحله 1: ورود به پنل
```
1. به آدرس http://localhost:8000/admin/login بروید
2. با اطلاعات ادمین login کنید
3. از منوی سمت راست روی "تست و دمو RMTO" کلیک کنید
```

### مرحله 2: تنظیمات اولیه
```
1. روی تب "تنظیمات" کلیک کنید
2. اطلاعات زیر را وارد کنید:
   - نام کاربری RMTO
   - رمز عبور RMTO  
   - محیط (تست یا عملیاتی)
   - کد کلاینت (اختیاری)
3. "ذخیره تنظیمات" را کلیک کنید
4. "تست اتصال" را کلیک کنید تا اتصال بررسی شود
```

### مرحله 3: تست قابلیت‌ها
از تب‌های مختلف استفاده کنید:

#### 📄 ثبت بارنامه
- فرم با داده‌های نمونه پر شده است
- می‌توانید تغییرات دلخواه ایجاد کنید
- "ثبت بارنامه" را کلیک کنید
- نتیجه در باکس پاسخ نمایش داده می‌شود

#### 👨‍✈️ استعلام راننده
- نوع جستجو را انتخاب کنید (کارت هوشمند یا کد ملی)
- شماره مورد نظر را وارد کنید
- "استعلام" را کلیک کنید

#### 🚚 استعلام ناوگان
- شماره کارت هوشمند ناوگان را وارد کنید
- "استعلام" را کلیک کنید

#### 📱 ارسال OTP
- شماره موبایل و کد ملی راننده را وارد کنید
- "ارسال کد تایید" را کلیک کنید

#### 🔍 استعلام‌ها
- **کد ملی:** کد ملی 10 رقمی را وارد کنید
- **کد پستی:** کد پستی 10 رقمی را وارد کنید

---

## 📋 ویژگی‌های رابط کاربری

✅ **طراحی مدرن و زیبا**
- سازگار با طراحی کلی پنل ادمین
- استفاده از Bootstrap 5 RTL
- آیکون‌های Font Awesome

✅ **Tab Navigation**
- دسترسی سریع به بخش‌های مختلف
- نمایش نام و آیکون هر بخش

✅ **نمایش نتایج**
- Alert های رنگی برای موفق/ناموفق
- نمایش JSON زیبا در باکس پاسخ
- قابلیت scroll برای پاسخ‌های طولانی

✅ **Loading Indicator**
- نمایش وضعیت بارگذاری در هنگام درخواست

✅ **Form Validation**
- اعتبارسنجی سمت کلاینت
- فیلدهای الزامی مشخص شده

---

## 🎨 کدهای شهرها (برای تست)

| کد | شهر |
|----|-----|
| 117 | تهران |
| 166 | مشهد |
| 70 | اصفهان |
| 253 | شیراز |

## 🚛 نوع بارگیر

| کد | نوع |
|----|-----|
| 1 | کامیون |
| 2 | کامیونت |
| 3 | تریلی |

---

## 📁 ساختار فایل‌ها

```
temp-laravel/
├── app/
│   └── Http/
│       └── Controllers/
│           └── Admin/
│               └── RMTOController.php ✅ کنترلر اصلی
├── resources/
│   └── views/
│       └── admin/
│           ├── layouts/
│           │   └── app.blade.php ✅ منوی RMTO اضافه شده
│           └── rmto/
│               └── index.blade.php ✅ صفحه اصلی
└── routes/
    └── web.php ✅ route های RMTO اضافه شده
```

---

## 🔄 تفاوت با پنل قبلی (HTML)

### پنل HTML (`rmto-admin-panel.html`)
- ❌ مستقل و جدا از پنل ادمین
- ❌ نیاز به توکن دستی در localStorage
- ❌ عدم یکپارچگی با سیستم

### پنل جدید (Blade در پنل ادمین)
- ✅ یکپارچه با پنل ادمین Laravel
- ✅ احراز هویت خودکار از session
- ✅ دسترسی از منوی سایدبار
- ✅ استفاده از layout مشترک
- ✅ middleware برای امنیت
- ✅ CSRF protection

---

## 🎯 خلاصه

**همه چیز آماده است!** 

1. ✅ منو به سایدبار اضافه شد
2. ✅ کنترلر با تمام متدها ساخته شد
3. ✅ Route ها تعریف شدند
4. ✅ صفحه view با تمام تب‌ها و فرم‌ها آماده است
5. ✅ JavaScript برای تمام عملیات نوشته شد

**برای شروع:**
```bash
# اطمینان از اجرای Laravel
php artisan serve

# مرورگر
http://localhost:8000/admin/login
```

سپس از منوی سمت راست روی **"تست و دمو RMTO"** کلیک کنید! 🚀
