feat(tariffs): automate current year tariff registration and sync service price

2026-06-24 04:54:56 +03:30
parent c189daa860
commit 17f41117f1
3 changed files with 127 additions and 36 deletions
@@ -128,6 +128,8 @@

 **Response 201:** ServiceItem object (شامل `insurance_covered` و `insurance_price_rials`)

+> **قیمت واحد:** هنگام ساخت سرویس، یک تعرفه برای **سال جاری** با همان `price_rials` به‌صورت خودکار ثبت می‌شود. قیمت سرویس = تعرفه‌ی سال جاری است و همه‌جا (صورتحساب، مراجعه، مطالبات) از همین قیمت استفاده می‌شود.
+
 ---

 ## PATCH /api/v1/service-item/{uuid}
@@ -204,6 +206,8 @@

 **Response 200:** `{ success, data: { …tariff } }`

+> اگر `year` برابر **سال جاری** باشد، `ServiceItem.price_rials` هم با همین مقدار همگام می‌شود (قیمت واحد). تعرفه‌ی سال‌های دیگر فقط برای محاسبه‌ی صورتحساب همان سال (`TariffService::resolvePrice`) به‌کار می‌رود و قیمت پایه‌ی سرویس را تغییر نمی‌دهد. هم‌چنین `PATCH /service-item/{uuid}` با تغییر `price_rials`، تعرفه‌ی سال جاری را upsert می‌کند.
+
 **Errors:**
 | Code | HTTP | توضیح |
 |------|------|-------|