# ماژول فرم، کلوپ و ثبت درخواست

این نسخه، ربات دوم فرم/رایان را داخل همان پنل وب آورده است.

## آدرس دریافت فرم

اگر پروژه را در روت هاست گذاشتی:

```text
https://YOUR-DOMAIN.com/form-hook-rayan.php
```

اگر داخل پوشه نصب کردی:

```text
https://YOUR-DOMAIN.com/YOUR-FOLDER/form-hook-rayan.php
```

این آدرس را در تنظیمات endpoint فرم‌افزار بگذار. هر payload که با ساختار قبلی `form` برسد، داخل دیتابیس ذخیره می‌شود و در صفحه «درخواست‌های فرم» نمایش داده می‌شود.

## صفحه‌های جدید پنل

- `درخواست‌های فرم`: جدول فرم‌های ورودی، تفکیک بر اساس نوع کلوپ، وضعیت‌ها، ثبت، تلاش مجدد و ثبت OTP.
- `استعلام کلوپ`: همان استعلام قبلی ربات بله، اما داخل سایت.

## وضعیت‌های جدول

- `آماده ثبت`: فرم تایید شده و آماده اجرای ثبت است.
- `منتظر کد تایید`: ثبت شروع شده و باید OTP را در همان ردیف وارد کنی.
- `تکمیل شده`: فرایند ثبت کامل شده است.
- `ناموفق`: خطا خورده و می‌توانی «تلاش مجدد» بزنی.
- `اطلاعات ناقص`: فیلدهای لازم مثل موبایل، کد ملی، آدرس یا مبلغ کامل نیست.
- `نادیده گرفته شده`: فرم با فیلترهای config همخوان نبوده یا نوع کلوپ مسیر ندارد.

## تنظیمات اصلی

فایل زیر را حتماً بررسی کن:

```text
config/rayan_config.php
```

موارد مهم:

- اطلاعات دیتابیس
- یوزر/پسورد رایان
- تنظیمات مینی‌پی قسطانو و سطح ۲
- تنظیمات حسابان‌وب
- فیلتر تایید نهایی و فروشنده
- مسیرهای نوع کلوپ

## امنیت endpoint

برای جلوگیری از ارسال فرم جعلی، در `config/rayan_config.php` مقدار زیر را پر کن:

```php
'endpoint_secret' => 'یک_رمز_سخت_و_طولانی',
```

بعد آدرس endpoint را این‌طوری در فرم‌افزار بگذار:

```text
https://YOUR-DOMAIN.com/form-hook-rayan.php?secret=یک_رمز_سخت_و_طولانی
```

## حالت خودکار یا دستی

در این نسخه پیش‌فرض این است که فرم فقط وارد جدول شود و تو از داخل پنل دکمه «ثبت» بزنی:

```php
'auto_process_on_webhook' => false,
```

اگر خواستی به محض دریافت فرم، خودش ثبت را هم شروع کند، مقدار را `true` کن. پیشنهاد فعلی: برای کنترل بهتر همان `false` بماند.

## دسترسی فایل‌ها

پوشه‌های زیر باید writable باشند:

```text
storage/rayan_runtime
storage/rayan_logs
```

