# تنظیم نرخ تبدیل ریال و دلار

انتخاب تک‌مرجع یا میانگین چند مرجع برای نرخ مبتنی بر تتر.

وضعیت: پیاده‌سازی‌شده | مخاطب: مالک پنل
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## معنای نرخ

نرخ مرجع مبلغ دلاری در سرمایه‌گذاری هوشمند بر مبنای قیمت تتر است و معادل قیمت دلار نقدی نیست. پیش‌فرض ذخیره‌نشده، حالت یک مرجع با انتخاب والکس است.

هر تومان همیشه برابر ۱۰ ریال است. انتخاب مرجع، قیمت تتر به ریال را تعیین می‌کند و ضریب تومان را تغییر نمی‌دهد.

## روش‌های انتخاب

انتخاب تکراری یا نام ناشناخته پذیرفته نمی‌شود. افزودن ارائه‌دهنده جدید به اتصال و پشتیبانی کد نیاز دارد و با وارد کردن یک URL در فرم انجام نمی‌شود.

| روش | قاعده |
| --- | --- |
| یک مرجع / single | دقیقاً یک گزینه: والکس یا نوبیتکس |
| میانگین / average | حداقل دو مرجع متمایز؛ فعلاً والکس و نوبیتکس |
| وزن‌ها | میانگین ساده با وزن برابر |
| تازگی | میانگین نیازمند نرخ تازه تمام انتخاب‌ها است |

## تنظیم در پنل

تنظیم فقط برای مالک واردشده قابل ذخیره است. کنترل‌های پیش‌نمایش و نقش‌های دیگر امکان ذخیره واقعی ندارند.

- در اتصال‌ها کارت «نرخ تبدیل ریال و دلار» را باز کنید.
- یک مرجع یا میانگین چند مرجع را انتخاب کنید.
- گزینه‌های موردنظر را تعیین و روش محاسبه را ذخیره کنید.
- در صورت تغییر هم‌زمان محتوا یا تنظیمات، تازه‌سازی و انتخاب را دوباره بررسی کنید.

## حفظ سایر تنظیمات

سیاست در فیلد exchange_rate داده محتوای سایت ذخیره می‌شود. ذخیره سایر محتوا را حفظ می‌کند و نسخه زمانی مانع بازنویسی تغییر هم‌زمان می‌شود.

خواندن در نبود رکورد فقط پیش‌فرض برمی‌گرداند. اولین ذخیره صریح، محتوای پیش‌فرض همراه سیاست را ایجاد می‌کند.

ویرایش معمولی محتوا، سیاست فعلی را حفظ می‌کند؛ مقدار قدیمی یا متفاوت باقی‌مانده در فرم محتوا آن را جایگزین نمی‌کند.

## قرارداد و مرز نتیجه

| مسیر یا فیلد | قرارداد |
| --- | --- |
| GET /api/integrations/exchange-rate | {policy, expectedUpdatedAt, configured} |
| PUT /api/integrations/exchange-rate | {policy, expectedUpdatedAt} |
| policy | mode: single یا average؛ sources: آرایه شناسه‌ها |
| configured | سیاست صریح ذخیره شده؛ به معنی سلامت لحظه‌ای مرجع نیست |

> دریافت نرخ زنده: این API سیاست را مدیریت می‌کند. دریافت نرخ زنده و بررسی تازگی در مارکت‌پلیس انجام می‌شود؛ ذخیره سیاست به‌تنهایی موفقیت دریافت از ارائه‌دهنده را ثابت نمی‌کند.

## مراجع پیاده‌سازی

- planck-admin/components/exchange-rate-settings.tsx
- planck-admin/lib/exchange-rate-settings.ts
- planck-admin/app/api/integrations/exchange-rate/route.ts
- planck-admin/app/api/content/route.ts
- planck-admin/tests/exchange-rate-settings.test.mjs