قیمت دامنه (انبار پسوند — مثل WHMCS Domain Pricing)

> version: 1.9 | last_updated: 2026-09-26 | audience: admin

مسیر UI

**پنل شرکت** → تنظیمات → **قیمت دامنه** (`/panel/domain-tlds`)

نیاز به لایسنس خانوادهٔ **فروش دامنه** (`domain`).

فروشگاه مشتری (فاز ۲)

`/domains` — جستجو + WHOIS + قیمت ماتریس → [`docs/customer/domain-lookup.md`](../customer/domain-lookup.md)

`/domains/checkout` — ثبت سفارش با `priceIrr` و سال انتخابی

پیش‌نیاز: یک محصول کاتالوگ از نوع **دامنه** (دسته خودکار)

اکشن دسته‌ای روی لیست پسوند

پس از انتخاب چند ردیف:

| اکشن | کار |
|------|-----|
| سرور / ثبت خودکار | `provisioning_server_id` + `auto_register` |
| Grace / Redemption | روز و هزینه (فقط فیلدهای پرشده) |
| فعال / غیرفعال کردن | `is_active` |

هم‌ترازی با WHMCS

| WHMCS Domain Pricing | BSS |
|----------------------|-----|
| لیست TLD | `domain_tlds` |
| Register / Renew / Transfer × ۱–۱۰ سال | `domain_tld_prices.amount` |
| ارز | `domain_tlds.currency` = `IRR` یا `USD` |
| خالی / `-1` = غیرفعال | همان |
| Grace / Redemption | روز + هزینه روی TLD (همان `currency`) |
| Auto Registration | `auto_register` + سرور `domain` |
| DNS / Email / ID Protection | فلگ روی TLD |
| ایجاد دسته‌ای | دکمه **ایجاد دسته‌ای** + **نمونه Excel** |
| Registrar TLD Sync | فاز ۳ (جزئی) — سرور از `DomainTld.provisioning_server_id` + احترام به `auto_register` |
| Lookup / WHOIS / checkout مشتری | فاز ۲ ✅ — ثبت + انتقال + تمدید |

ارز ریال / دلار

روی هر پسوند فیلد **واحد قیمت** (`currency`)

اگر `USD` باشد، اعداد ماتریس **و** هزینه‌های Grace / Redemption دلاری ذخیره می‌شوند (فقط در پنل ادمین)

برای مشتری و فاکتور: همیشه **ریال** از `priceIrr()` / `graceFeeIrr()` / `redemptionFeeIrr()` با `UsdIrrRateService` — مبلغ دلاری خام در فروشگاه نمایش داده نمی‌شود

هنگام **ایجاد/ویرایش** پسوند دلاری: `ensureUsableRate` نرخ روز را در صورت نیاز از TGJU تازه می‌کند؛ اگر نرخ ذخیره‌شده نسبت به خام خراب باشد، از خام ترمیم می‌شود

اگر نرخ دلار تنظیم نباشد، قیمت سال‌ها خالی می‌ماند و پیام «نرخ دلار … تنظیم نشده» دیده می‌شود (نه «رایگان»)

ایجاد دسته‌ای (Excel)

دکمه **نمونه Excel** → فایل `domain-tlds-sample.xlsx`

ستون اجباری: `extension` — ستون `currency` = `IRR` یا `USD`

قیمت‌ها: `register_1y` / `renew_1y` / `transfer_1y` … تا `_10y`

دکمه **ایجاد دسته‌ای** → آپلود یا چسباندن

گزینه‌ها: رد تکراری / به‌روزرسانی موجود

بدون هدر: `extension, register_1y, renew_1y, transfer_1y [, is_active]`

سرویس: [`DomainTldImportService`](../../modules/ProductCatalog/Services/DomainTldImportService.php)

مدل داده

`domain_tlds` — پسوند + `currency`

`domain_tld_prices` — `(action, years, amount)` در واحد همان پسوند

[`DomainPricingService`](../../modules/ProductCatalog/Services/DomainPricingService.php): `price()` خام، `priceIrr()` / `graceFeeIrr()` / `redemptionFeeIrr()` ریال مشتری