پیشنیازهای کلی
- در ادمین: دسترسی ساخت بروکر و اتصال باشگاه.
- در پنل بروکر: نام کاربری و رمز که هنگام ساخت بروکر تعریف شده.
- ارزهای پایه (ریال، طلا، USDT و ...) از قبل در سیستم تعریف شده باشند.
- باشگاه فقط وقتی از بروکر استفاده میکند که متصل شده باشد.
«بروکر ارز» تأمینکننده نقدینگی و قیمت خرید/فروش ارز برای باشگاهها و اپلیکیشنهای متصل است. فرق آن با «نرخ ارز» داخلی مون\u200cتک این است که یک شخص/third-party مستقل (بروکر) موجودی واقعی نگه میدارد، قیمت میگذارد و معاملات را تأیید میکند. ادمین پلتفرم بروکر را میسازد، ارزها و باشگاههای مجاز را وصل میکند و توکن API یکبار نمایش میدهد. پنل بروکر جایی است که خود بروکر قیمت، موجودی، معاملات و کلاینتهای API را مدیریت میکند. اگر تازه کار هستید، مسیر را اینطور ببینید: ادمین بروکر + ارز + باشگاه → بروکر قیمت و موجودی → (اختیاری) کلاینت API → درخواست خرید/فروش از اپ → معامله pending → بروکر تأیید → تسویه. این راهنما بدون مسیر API و نام فیلد، فقط با منوهای واقعی نوشته شده است.
**پنل مدیریت → بروکر ارز**
جدول بروکرها: نام، شناسه یکتا (slug)، وضعیت (فعال، معلق، در انتظار)، تعداد ارزها، کلاینتهای API، معاملات.
**پنل بروکر → نمای کلی**
کارتها: حجم تسویهشده، معاملات موفق، در انتظار، اعتبار کلاینتهای API. پایین صفحه: ۸ معامله اخیر.
**پنل بروکر → ارزها و قیمتگذاری**
**پنل بروکر → موجودی**
هر کارت: یک ارز + موجودی فعلی + زمان آخرین بهروزرسانی. تغییرات در دفتر موجودی ثبت میشود (۳۰ ردیف آخر در پایین صفحه).
**پنل بروکر → معاملات**
فیلتر: همه، تسویهشده، در انتظار، لغوشده. ستونها: نوع (خرید/فروش)، مقدار، قیمت واحد، ارزش، مشتری، کانال (API، پنل، ...).
**پنل بروکر → کلاینتهای API**
کلاینت برای اتصال اپ یا سرویس دیگر به نرخ و معاملات بروکر با اعتبار پیشپرداخت است.
| عمل | نتیجه |
|---|---|
| شارژ اعتبار | پیشپرداخت کلاینت زیاد میشود |
| غیرفعال | فراخوانی API مسدود |
| حذف | کلاینت و کلید حذف میشود |
**پنل بروکر → تنظیمات**
flowchart LR
A[ادمین: ساخت بروکر] --> B[ادمین: ارز + باشگاه]
B --> C[بروکر: قیمت]
C --> D[بروکر: موجودی]
D --> E[بروکر: کلاینت API]
E --> F[درخواست از اپ]
F --> G{در انتظار?}
G -->|بله| H[تأیید معامله]
G -->|خیر| I[تسویه]
H --> I
| مشکل | کار پیشنهادی |
|---|---|
| ارز در پنل بروکر نیست | ادمین ارز را اضافه کند |
| سقف معامله رد شد | حداکثر را کم کنید یا سقف ادمین را بالا ببرید |
| معامله pending | موجودی شارژ + تأیید دستی |
| توکن گم شد | توکن/کلاینت جدید |
| باشگاه نرخ نمیبیند | اتصال باشگاه در ادمین |