# راهنمای اجرای لوکال و تست

## ۱) نصب اولیه

```bash
composer install
cp .env.example .env
php artisan key:generate
```

در `.env` لوکال:

```env
APP_ENV=local
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000

DB_CONNECTION=mysql
# یا برای تست سریع: sqlite (نیاز به pdo_sqlite)

QUEUE_CONNECTION=database
# یا redis اگر نصب دارید

BOT_WEBHOOK_BASE_URL=http://127.0.0.1:8000
ADMIN_SEED_PASSWORD=local-admin-password

OTP_LOCAL_FAKE_DELIVERY=true
OTP_LOCAL_EXPOSE_CODE=true
CAPTCHA_DISABLE=true
```

```bash
php artisan migrate --force
php artisan db:seed --force
php artisan storage:link
php artisan system:doctor
```

---

## ۲) اجرای سرویس‌ها

**ترمینال ۱ — وب:**

```bash
php artisan serve --host=127.0.0.1 --port=8000
```

**ترمینال ۲ — صف:**

```bash
php artisan queue:work --queue=bot-webhooks,default,bot-heavy,inventory,ai,manual-runs --sleep=1 --tries=1
```

**ترمینال ۳ — asset (اختیاری):**

```bash
npm install
npm run dev
```

---

## ۳) آدرس‌های پنل

| بخش | URL |
|-----|-----|
| ورود کاربر (OTP) | http://127.0.0.1:8000/ |
| ورود ادمین | http://127.0.0.1:8000/dashboard |
| پنل کاربر | http://127.0.0.1:8000/panel |
| پنل ادمین | http://127.0.0.1:8000/admin |

---

## ۴) حساب‌های تست (بعد از seed)

### ادمین

- ایمیل: مقدار `ADMIN_SEED_EMAIL` (پیش‌فرض `superadmin@example.com`)
- رمز: مقدار `ADMIN_SEED_PASSWORD` در `.env`
- کپچا: در لوکال با `CAPTCHA_DISABLE=true` غیرفعال است

### کاربر پنل

- موبایل seed: `09123456789`
- نام: `کاربر تست`
- OTP: با `OTP_LOCAL_EXPOSE_CODE=true` کد روی صفحه لاگین نمایش داده می‌شود

---

## ۵) مسیر تست پنل کاربر

1. باز کردن `/`
2. وارد کردن `09123456789` → دریافت OTP
3. وارد کردن کد → ورود به `/panel`
4. تست بخش‌ها:
   - داشبورد
   - کدهای فنی (افزودن / حذف / export)
   - فایل‌ها (آپلود CSV)
   - خروجی‌های اکسل (`/panel/exports`)
   - گفتگوهای AI
   - پروفایل
   - toggle ربات

---

## ۶) مسیر تست پنل ادمین

1. ورود از `/dashboard`
2. بررسی بخش‌ها:
   - ربات‌ها + ثبت webhook
   - کاربران / جستجوی سراسری (`/admin/search`)
   - تنظیمات OTP
   - AI Providers
   - پایش جاب‌ها + retry failed
   - لاگ تطبیق / ممیزی (با فیلتر)

---

## ۷) تست خودکار

```bash
php artisan test
```

۳۳ تست شامل: پنل کاربر، پنل ادمین، webhook، OTP، captcha، AI resolver.

---

## ۸) دستورات مفید توسعه

```bash
php artisan system:doctor
php artisan queue:failed
php artisan queue:retry all
php artisan bots:health-check
php artisan config:clear && php artisan cache:clear
```