قیمت‌گذاری چنددوره‌ای محصول اصلی

> version: 1.5 | last_updated: 2026-08-16 | audience: admin

هدف

یک محصول recurring می‌تواند هم‌زمان قیمت **ماهانه / سه‌ماهه / شش‌ماهه / سالانه** و در صورت نیاز **دوره‌های سفارشی بر اساس روز** (مثلاً ۲۵ روزه) داشته باشد؛ بدون ساخت چند SKU جدا.

تنظیم در ادمین

تب **قیمت** محصول اصلی با مدل **دوره‌ای**:

| فیلد | نقش |
|------|-----|
| دوره پیش‌فرض | فقط مقادیر استاندارد enum (`monthly` …) — نمایش کاتالوگ + fallback ستون |
| قیمت ماهانه / سه‌ماهه / … | ماتریس `cycle_pricing` — **قیمت صفر = دوره در فروشگاه نیست** |
| دوره‌های سفارشی (Repeater) | روز + برچسب + قیمت + نصب → کلید `custom_{days}` داخل همان JSON |
| فیلدهای تک‌قیمت قدیمی | برای مدل یک‌بار / پیش‌پرداخت |

پس از ذخیره، `price` و `setup_fee` از ردیف دورهٔ پیش‌فرض استاندارد (یا اولین دوره با قیمت > 0) همگام می‌شوند. ستون `billing_cycle` محصول **هرگز** مقدار `custom_*` نمی‌گیرد.

نمونه `cycle_pricing`

```json
{
"monthly": { "price": 1000000, "setup": 0 },
"yearly": { "price": 10000000, "setup": 0 },
"custom_25": { "days": 25, "label": "۲۵ روزه", "price": 850000, "setup": 0 }
}
```

خرید

پورتال و ریسلر: انتخاب دوره (استاندارد یا سفارشی) → مبلغ و `billing_cycle` روی آیتم سفارش و اشتراک (مثلاً `custom_25`)

**گزینه‌های قابل تنظیم** و افزونه‌ها از همان دورهٔ انتخاب‌شدهٔ محصول پیروی می‌کنند:

- دوره استاندارد → ردیف همان دوره روی choice / افزونه
- دوره سفارشی → اگر روی choice قیمت `custom_*` تعریف شده همان؛ وگرنه ماهانه × (روز / ۳۰)
- در فرم ادمین choice: Repeater «دوره‌های سفارشی» کنار ماتریس ماهانه/…

با تغییر رادیو دوره در checkout/ریسلر، برچسب و مبلغ گزینه‌ها در UI هم به‌روز می‌شود

تمدید و زمان‌بندی صورتحساب: `BillingPeriod::addInterval` / `daysFromKey` با همان کلید اشتراک

پروریشن افزونه میان‌دوره: `AddonProrationService::resolveCycleDays` از دورهٔ اشتراک والد

داده

ستون: `product_offerings.cycle_pricing` JSON

سرویس: `ProductCyclePricingService` + `BillingPeriod` + `ConfigurableOptionService::choicePricingForKey`

سازگاری: محصولات قبلی با migration از `price`/`billing_cycle` پر شده‌اند

مرتبط

[create-product.md](./create-product.md)

[product-addons.md](./product-addons.md)

[ADR-034](../DECISIONS.md) — پس‌پرداخت تقویمی **فقط جلالی** (میلادی نداریم)

فاز ۲: [jalali-postpaid-billing.md](./jalali-postpaid-billing.md) — هم‌ترازی تقویم/سالگرد جلالی