hamedandClaude Opus 5
a70a98769b
The chain the spec asks for, plus the branch level that already has data: resource+option, resource+service, branch override, then the item's own value. Duration and price resolve independently. If they resolved together the first override would silently swallow the other value — a resource that only differs in how long it takes would also drop the branch's tariff. Each resolved value carries where it came from. Without that, the panel cannot label a number "from the branch" or "service default", and "why this number?" becomes a four-table investigation. Two rules worth stating: null means inherit while zero is a real value, so a free service keeps its zero instead of inheriting the parent's price; and an inactive offering is skipped whole, since "this resource does not perform this right now" is not the same as "I have no opinion on the numbers". The parent service is passed in rather than looked up from the item's group. The booking flow already holds both, and a reverse query would be a second way to answer a question that already has an answer in hand. Eight tests: one per level with the other levels populated so the winner is provable, plus independent resolution, the inactive skip, zero, and resolving the service itself without a parent. Suite 1272 green, phpstan at its 14-error baseline. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
99 lines
4.8 KiB
PHP
99 lines
4.8 KiB
PHP
<?php
|
|
|
|
namespace App\ClinicService\Service;
|
|
|
|
use App\ClinicService\Entity\ServiceItem;
|
|
use App\ClinicService\Repository\ServiceBranchOverrideRepository;
|
|
use App\ClinicService\ValueObject\ResolvedServiceSpec;
|
|
use App\Doctor\Entity\DoctorAddress;
|
|
use App\Resource\Entity\ClinicResource;
|
|
use App\Resource\Repository\ResourceServiceOfferingRepository;
|
|
|
|
/**
|
|
* «این سرویس با این منبع چقدر طول میکشد و چقدر میشود؟»
|
|
*
|
|
* زنجیرهٔ خاص به عام، طبق سند مالک محصول بهعلاوهٔ سطح شعبه که از قبل داده دارد:
|
|
*
|
|
* ۱. منبع + گزینه → `ResourceServiceOffering(resource, option)`
|
|
* ۲. منبع + سرویس → `ResourceServiceOffering(resource, parent)`
|
|
* ۳. شعبه + آیتم → `ServiceBranchOverride(item, address)`
|
|
* ۴. پیشفرض آیتم → `ServiceItem`
|
|
*
|
|
* **مدت و قیمت جدا حل میشوند.** منبعی که فقط مدتش فرق دارد نباید قیمتش هم از همان
|
|
* سطح بیاید؛ اگر با هم حل شوند، اولین override باعث میشود تعرفهٔ شعبه بیصدا نادیده گرفته شود.
|
|
*
|
|
* سطحِ والد را **صدازننده** میدهد، نه یک کوئری معکوس روی گروهها: جریان رزرو هر دو را
|
|
* از قبل در دست دارد (سرویس انتخابشده و گزینهاش)، و کوئری معکوس فقط یک راه اضافه برای
|
|
* واگرایی میسازد.
|
|
*/
|
|
final class ResourceServiceResolver
|
|
{
|
|
public function __construct(
|
|
private readonly ResourceServiceOfferingRepository $offerings,
|
|
private readonly ServiceBranchOverrideRepository $branchOverrides,
|
|
) {}
|
|
|
|
/**
|
|
* @param ServiceItem $item آیتمی که قیمت و مدتش را میخواهیم (گزینه یا خودِ سرویس)
|
|
* @param ServiceItem|null $parentService سرویسِ والد وقتی `$item` یک گزینه است
|
|
*/
|
|
public function resolve(
|
|
ClinicResource $resource,
|
|
ServiceItem $item,
|
|
DoctorAddress $address,
|
|
?ServiceItem $parentService = null,
|
|
): ResolvedServiceSpec {
|
|
$optionOffering = $this->offerings->findOneFor($resource, $item);
|
|
|
|
$parentOffering = $parentService !== null && $parentService->getId() !== $item->getId()
|
|
? $this->offerings->findOneFor($resource, $parentService)
|
|
: null;
|
|
|
|
// ردیف غیرفعال یعنی «این منبع فعلاً این را نمیدهد»، نه «مقدارش را نمیدانم» —
|
|
// پس اعدادش هم خوانده نمیشوند و زنجیره از رویش رد میشود.
|
|
$optionOffering = $optionOffering?->isActive() === true ? $optionOffering : null;
|
|
$parentOffering = $parentOffering?->isActive() === true ? $parentOffering : null;
|
|
|
|
$branch = $this->branchOverrides->findOneBy(['item' => $item, 'address' => $address]);
|
|
|
|
[$duration, $durationSource] = $this->first([
|
|
[$optionOffering?->getDurationMinutes(), ResolvedServiceSpec::SOURCE_RESOURCE_OPTION],
|
|
[$parentOffering?->getDurationMinutes(), ResolvedServiceSpec::SOURCE_RESOURCE_SERVICE],
|
|
[$branch?->getSoloDurationMinutes(), ResolvedServiceSpec::SOURCE_BRANCH],
|
|
[$item->getSoloDurationMinutes(), ResolvedServiceSpec::SOURCE_SERVICE_DEFAULT],
|
|
]);
|
|
|
|
[$price, $priceSource] = $this->first([
|
|
[$optionOffering?->getPriceRials(), ResolvedServiceSpec::SOURCE_RESOURCE_OPTION],
|
|
[$parentOffering?->getPriceRials(), ResolvedServiceSpec::SOURCE_RESOURCE_SERVICE],
|
|
[$branch?->getPriceRials(), ResolvedServiceSpec::SOURCE_BRANCH],
|
|
[$item->getPriceRials(), ResolvedServiceSpec::SOURCE_SERVICE_DEFAULT],
|
|
]);
|
|
|
|
return new ResolvedServiceSpec(
|
|
durationMinutes: $duration,
|
|
priceRials: (int) ($price ?? 0),
|
|
durationSource: $duration === null ? null : $durationSource,
|
|
priceSource: $priceSource ?? ResolvedServiceSpec::SOURCE_SERVICE_DEFAULT,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* اولین سطحی که مقدار دارد. `null` یعنی «حرفی برای گفتن ندارم» و رد میشود؛
|
|
* صفر یک مقدارِ واقعی است و **رد نمیشود** — سرویسِ رایگان قیمتش صفر است، نه ارثبر.
|
|
*
|
|
* @param list<array{0: int|null, 1: string}> $levels
|
|
* @return array{0: int|null, 1: string|null}
|
|
*/
|
|
private function first(array $levels): array
|
|
{
|
|
foreach ($levels as [$value, $source]) {
|
|
if ($value !== null) {
|
|
return [$value, $source];
|
|
}
|
|
}
|
|
|
|
return [null, null];
|
|
}
|
|
}
|