feat(resource): resource calendars, exceptions and national holidays
Section 9 of the design document builds free time by subtracting seven layers. Four existed and all of them hung off the doctor. This adds the missing ones and puts them on the resource: branch hours ∩ resource shifts − national holidays − resource exceptions Booked appointments and holds are deliberately NOT subtracted here — those are tasks 06/07, as is intersecting several resources. The method is called rawAvailability() so nobody mistakes the output for bookable time. Nothing in this change calls SlotCalculatorService; the existing slot path stays frozen. Four types of exception (leave, absence, maintenance, ad-hoc closure) share one table because all four are "an interval subtracted from a resource's calendar"; splitting them would mean four queries per availability lookup instead of one. Holiday overrides work in both directions: a clinic that opens on a public holiday, and a clinic that closes on an ordinary day. Every empty day carries a reason (national_holiday, no_shift, branch_closed, outside_branch_hours, exception, …). Without it an empty response is indistinguishable from a bug and the first person debugging has to read four tables by hand. Three real defects found on the way: JalaliDateService.gregorianToJalali() was wrong — it returned [3006, 7, 3] for 2026-07-30 instead of [1405, 5, 8], roughly 1601 years off. jalaliYear(), jalaliMonth(), jalaliMonthRange() and jalaliYearRange() all inherit that, so the representation reports built on them have been filtering by nonsense ranges. The class's own formatDateTime() was already correct because it used IntlDateFormatter, so both conversions now go through the same mechanism, and JalaliDateServiceTest pins Nowruz and the 6/31→7/1 boundary. There were no tests before, which is why nobody noticed. TimeInterval added a seconds-based midnight to a minutes-based interval, turning an eight-hour shift into eight seconds. The conversion is now an explicitly named minutesToAbsolute() so the unit change cannot happen silently again. HolidayService.upsertNational() persisted but left flushing to the caller. Every HTTP request reboots the kernel, so the caller often held a different EntityManager: persist landed on one, flush on the other, and nothing was written with no error at all. The write is now self-contained. 119 tests across tests/Resource, tests/Branch and tests/Representation. phpstan clean on both touched domains. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
@@ -0,0 +1,43 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace DoctrineMigrations;
|
||||
|
||||
use Doctrine\DBAL\Schema\Schema;
|
||||
use Doctrine\Migrations\AbstractMigration;
|
||||
|
||||
/**
|
||||
* Resource calendars, exceptions and the national holiday table.
|
||||
*
|
||||
* These are the missing layers of the availability subtraction in section 9 of the
|
||||
* design document. They sit on the *resource*, parallel to the existing per-doctor
|
||||
* WeeklySchedule/DateOverride/Holiday path, which stays untouched in this phase.
|
||||
*/
|
||||
final class Version20260730143130 extends AbstractMigration
|
||||
{
|
||||
public function getDescription(): string
|
||||
{
|
||||
return 'Add resource calendars, resource exceptions, national holidays and tenant holiday overrides';
|
||||
}
|
||||
|
||||
public function up(Schema $schema): void
|
||||
{
|
||||
$this->addSql('CREATE TABLE national_holidays (id INT AUTO_INCREMENT NOT NULL, uuid VARCHAR(36) NOT NULL, date INT NOT NULL, jalali_date VARCHAR(10) NOT NULL, jalali_year SMALLINT NOT NULL, title VARCHAR(200) NOT NULL, created_at INT NOT NULL, UNIQUE INDEX UNIQ_8262602CD17F50A6 (uuid), INDEX idx_holiday_year (jalali_year), UNIQUE INDEX uniq_holiday_date (date), PRIMARY KEY (id)) DEFAULT CHARACTER SET utf8mb4');
|
||||
$this->addSql('CREATE TABLE resource_calendars (id INT AUTO_INCREMENT NOT NULL, day_of_week SMALLINT NOT NULL, sequence SMALLINT DEFAULT 0 NOT NULL, start_minute SMALLINT NOT NULL, end_minute SMALLINT NOT NULL, active TINYINT DEFAULT 1 NOT NULL, resource_id INT NOT NULL, INDEX IDX_2C16D19089329D25 (resource_id), INDEX idx_rc_resource_day (resource_id, day_of_week, active), UNIQUE INDEX uniq_rc_resource_day_seq (resource_id, day_of_week, sequence), PRIMARY KEY (id)) DEFAULT CHARACTER SET utf8mb4');
|
||||
$this->addSql('CREATE TABLE resource_exceptions (id INT AUTO_INCREMENT NOT NULL, uuid VARCHAR(36) NOT NULL, type VARCHAR(20) NOT NULL, starts_at INT NOT NULL, ends_at INT NOT NULL, reason VARCHAR(200) DEFAULT NULL, created_at INT NOT NULL, updated_at INT NOT NULL, entity_type VARCHAR(10) NOT NULL, entity_id INT NOT NULL, resource_id INT NOT NULL, UNIQUE INDEX UNIQ_486A5CE6D17F50A6 (uuid), INDEX IDX_486A5CE689329D25 (resource_id), INDEX idx_rex_tenant (entity_type, entity_id), INDEX idx_rex_resource_range (resource_id, starts_at, ends_at), PRIMARY KEY (id)) DEFAULT CHARACTER SET utf8mb4');
|
||||
$this->addSql('CREATE TABLE tenant_holiday_overrides (id INT AUTO_INCREMENT NOT NULL, uuid VARCHAR(36) NOT NULL, date INT NOT NULL, is_working TINYINT NOT NULL, note VARCHAR(200) DEFAULT NULL, created_at INT NOT NULL, entity_type VARCHAR(10) NOT NULL, entity_id INT NOT NULL, UNIQUE INDEX UNIQ_DB0B49E4D17F50A6 (uuid), UNIQUE INDEX uniq_tho_tenant_date (entity_type, entity_id, date), PRIMARY KEY (id)) DEFAULT CHARACTER SET utf8mb4');
|
||||
$this->addSql('ALTER TABLE resource_calendars ADD CONSTRAINT FK_2C16D19089329D25 FOREIGN KEY (resource_id) REFERENCES clinic_resources (id) ON DELETE CASCADE');
|
||||
$this->addSql('ALTER TABLE resource_exceptions ADD CONSTRAINT FK_486A5CE689329D25 FOREIGN KEY (resource_id) REFERENCES clinic_resources (id) ON DELETE CASCADE');
|
||||
}
|
||||
|
||||
public function down(Schema $schema): void
|
||||
{
|
||||
$this->addSql('ALTER TABLE resource_calendars DROP FOREIGN KEY FK_2C16D19089329D25');
|
||||
$this->addSql('ALTER TABLE resource_exceptions DROP FOREIGN KEY FK_486A5CE689329D25');
|
||||
$this->addSql('DROP TABLE national_holidays');
|
||||
$this->addSql('DROP TABLE resource_calendars');
|
||||
$this->addSql('DROP TABLE resource_exceptions');
|
||||
$this->addSql('DROP TABLE tenant_holiday_overrides');
|
||||
}
|
||||
}
|
||||
@@ -7,38 +7,32 @@ namespace App\Representation\Service;
|
||||
*/
|
||||
class JalaliDateService
|
||||
{
|
||||
public const TIMEZONE = 'Asia/Tehran';
|
||||
|
||||
public function toJalali(\DateTimeInterface $date): array
|
||||
{
|
||||
[$gy, $gm, $gd] = [(int)$date->format('Y'), (int)$date->format('m'), (int)$date->format('d')];
|
||||
return $this->gregorianToJalali($gy, $gm, $gd);
|
||||
}
|
||||
|
||||
/** Returns [year, month, day] in Jalali */
|
||||
/**
|
||||
* @return array{0: int, 1: int, 2: int} [سال، ماه، روز] شمسی
|
||||
*
|
||||
* پیادهسازی دستیِ قبلی غلط بود: `gregorianToJalali(2026, 7, 30)` مقدار
|
||||
* `[3006, 7, 3]` میداد بهجای `[1405, 5, 8]` (مبدأ روزشمار ~۱۶۰۱ سال جابهجا
|
||||
* بود). چون `formatDateTime()` همین کلاس از قبل با `IntlDateFormatter` درست کار
|
||||
* میکرد، هر دو تبدیل هم به همان منتقل شدند تا یک منبع حقیقت بماند.
|
||||
*/
|
||||
public function gregorianToJalali(int $gy, int $gm, int $gd): array
|
||||
{
|
||||
$g_d_no = 365 * $gy + (int)(($gy + 3) / 4) - (int)(($gy + 99) / 100) + (int)(($gy + 399) / 400);
|
||||
$g_days = [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334];
|
||||
for ($i = 1; $i < $gm; $i++) $g_d_no += $g_days[$i];
|
||||
if ($gm > 2 && (($gy % 4 === 0 && $gy % 100 !== 0) || ($gy % 400 === 0))) $g_d_no++;
|
||||
// ساعت ۱۲ ظهر عمدی است: نیمهشب در روزهای تغییر ساعت میتواند یک روز عقب/جلو بیفتد.
|
||||
$date = (new \DateTimeImmutable(
|
||||
sprintf('%04d-%02d-%02d 12:00:00', $gy, $gm, $gd),
|
||||
new \DateTimeZone(self::TIMEZONE),
|
||||
))->getTimestamp();
|
||||
|
||||
$j_d_no = $g_d_no - 79;
|
||||
$j_np = (int)($j_d_no / 12053);
|
||||
$j_d_no %= 12053;
|
||||
$jy = 979 + 33 * $j_np + 4 * (int)($j_d_no / 1461);
|
||||
$j_d_no %= 1461;
|
||||
|
||||
if ($j_d_no >= 366) {
|
||||
$jy += (int)(($j_d_no - 1) / 365);
|
||||
$j_d_no = ($j_d_no - 1) % 365;
|
||||
}
|
||||
|
||||
$j_days = [0, 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29];
|
||||
$jm = 0;
|
||||
for ($i = 1; $i <= 12; $i++) {
|
||||
if ($j_d_no < $j_days[$i]) { $jm = $i; break; }
|
||||
$j_d_no -= $j_days[$i];
|
||||
}
|
||||
$jd = $j_d_no + 1;
|
||||
$formatted = $this->persianFormatter('yyyy-MM-dd')->format($date);
|
||||
[$jy, $jm, $jd] = array_map('intval', explode('-', $formatted));
|
||||
|
||||
return [$jy, $jm, $jd];
|
||||
}
|
||||
@@ -51,7 +45,7 @@ class JalaliDateService
|
||||
'fa_IR@calendar=persian',
|
||||
\IntlDateFormatter::NONE,
|
||||
\IntlDateFormatter::NONE,
|
||||
'Asia/Tehran',
|
||||
self::TIMEZONE,
|
||||
\IntlDateFormatter::TRADITIONAL,
|
||||
$pattern,
|
||||
);
|
||||
@@ -101,27 +95,31 @@ class JalaliDateService
|
||||
];
|
||||
}
|
||||
|
||||
/** @return array{0: int, 1: int, 2: int} [سال، ماه، روز] میلادی */
|
||||
public function jalaliToGregorian(int $jy, int $jm, int $jd): array
|
||||
{
|
||||
$jy += 1595;
|
||||
$days = -355779 + 365 * $jy + (int)($jy / 33) * 8 + (int)((($jy % 33) + 3) / 4) + $jd;
|
||||
$jm_days = [0, 31, 62, 93, 124, 155, 186, 216, 246, 276, 306, 336];
|
||||
$days += $jm_days[$jm - 1];
|
||||
$calendar = \IntlCalendar::createInstance(
|
||||
new \DateTimeZone(self::TIMEZONE),
|
||||
'fa_IR@calendar=persian',
|
||||
);
|
||||
$calendar->clear();
|
||||
$calendar->set($jy, $jm - 1, $jd, 12, 0, 0);
|
||||
|
||||
$gy = 400 * (int)($days / 146097);
|
||||
$days %= 146097;
|
||||
if ($days > 36524) { $gy += 100 * (int)(--$days / 36524); $days %= 36524; if ($days >= 365) $days++; }
|
||||
$gy += 4 * (int)($days / 1461);
|
||||
$days %= 1461;
|
||||
if ($days > 365) { $gy += (int)(($days - 1) / 365); $days = ($days - 1) % 365; }
|
||||
$gd = $days + 1;
|
||||
$gm_days = [0, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
|
||||
$gm = 0;
|
||||
for ($i = 1; $i <= 12; $i++) {
|
||||
if ($gd <= $gm_days[$i]) { $gm = $i; break; }
|
||||
$gd -= $gm_days[$i];
|
||||
$date = (new \DateTimeImmutable('@' . intdiv((int) $calendar->getTime(), 1000)))
|
||||
->setTimezone(new \DateTimeZone(self::TIMEZONE));
|
||||
|
||||
return [(int) $date->format('Y'), (int) $date->format('n'), (int) $date->format('j')];
|
||||
}
|
||||
|
||||
return [$gy, $gm, $gd];
|
||||
private function persianFormatter(string $pattern): \IntlDateFormatter
|
||||
{
|
||||
return new \IntlDateFormatter(
|
||||
'en_US@calendar=persian',
|
||||
\IntlDateFormatter::NONE,
|
||||
\IntlDateFormatter::NONE,
|
||||
self::TIMEZONE,
|
||||
\IntlDateFormatter::TRADITIONAL,
|
||||
$pattern,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,106 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Command;
|
||||
|
||||
use App\Resource\Service\HolidayService;
|
||||
use Symfony\Component\Console\Attribute\AsCommand;
|
||||
use Symfony\Component\Console\Command\Command;
|
||||
use Symfony\Component\Console\Input\InputInterface;
|
||||
use Symfony\Component\Console\Input\InputOption;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
use Symfony\Component\Console\Style\SymfonyStyle;
|
||||
|
||||
/**
|
||||
* تعطیلات رسمی یک سال شمسی را وارد میکند.
|
||||
*
|
||||
* تعطیلات **ثابتِ** تقویم (مناسبتهای شمسی) درون خود دستور است، چون هر سال تکرار
|
||||
* میشوند و وابسته به منبع بیرونی نیستند. مناسبتهای **قمری** (مثل عید فطر) هر سال
|
||||
* جابهجا میشوند و اینجا نمیآیند: حدس زدنشان بدتر از نداشتنشان است — با
|
||||
* `--extra` یا از پنل دستی اضافه میشوند.
|
||||
*/
|
||||
#[AsCommand(
|
||||
name: 'app:holiday:import',
|
||||
description: 'Import the fixed Jalali national holidays for a year',
|
||||
)]
|
||||
class ImportHolidayCommand extends Command
|
||||
{
|
||||
/** مناسبتهای ثابتِ شمسی: [ماه, روز, عنوان] */
|
||||
private const FIXED = [
|
||||
[1, 1, 'نوروز'],
|
||||
[1, 2, 'نوروز'],
|
||||
[1, 3, 'نوروز'],
|
||||
[1, 4, 'نوروز'],
|
||||
[1, 12, 'روز جمهوری اسلامی'],
|
||||
[1, 13, 'روز طبیعت'],
|
||||
[3, 14, 'رحلت امام خمینی'],
|
||||
[3, 15, 'قیام ۱۵ خرداد'],
|
||||
[11, 22, 'پیروزی انقلاب اسلامی'],
|
||||
[12, 29, 'روز ملی شدن صنعت نفت'],
|
||||
];
|
||||
|
||||
public function __construct(
|
||||
private readonly HolidayService $holidays,
|
||||
) {
|
||||
parent::__construct();
|
||||
}
|
||||
|
||||
protected function configure(): void
|
||||
{
|
||||
$this->addOption('year', null, InputOption::VALUE_REQUIRED, 'Jalali year, e.g. 1405');
|
||||
$this->addOption('force', null, InputOption::VALUE_NONE, 'Actually write; without it the command only reports');
|
||||
$this->addOption(
|
||||
'extra',
|
||||
null,
|
||||
InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY,
|
||||
'Extra holiday as month/day/title, e.g. --extra=10/12/عید فطر',
|
||||
);
|
||||
}
|
||||
|
||||
protected function execute(InputInterface $input, OutputInterface $output): int
|
||||
{
|
||||
$io = new SymfonyStyle($input, $output);
|
||||
$force = (bool) $input->getOption('force');
|
||||
|
||||
$year = $input->getOption('year');
|
||||
|
||||
if (!is_numeric($year)) {
|
||||
$io->error('گزینهٔ --year الزامی است، مثلاً --year=1405');
|
||||
|
||||
return Command::INVALID;
|
||||
}
|
||||
|
||||
$year = (int) $year;
|
||||
$entries = self::FIXED;
|
||||
|
||||
foreach ((array) $input->getOption('extra') as $extra) {
|
||||
$parts = explode('/', (string) $extra, 3);
|
||||
|
||||
if (count($parts) !== 3 || !is_numeric($parts[0]) || !is_numeric($parts[1])) {
|
||||
$io->error(sprintf('قالب --extra باید ماه/روز/عنوان باشد؛ «%s» خوانده نشد.', $extra));
|
||||
|
||||
return Command::INVALID;
|
||||
}
|
||||
|
||||
$entries[] = [(int) $parts[0], (int) $parts[1], $parts[2]];
|
||||
}
|
||||
|
||||
if (!$force) {
|
||||
$io->note('Dry run — nothing will be written. Re-run with --force to apply.');
|
||||
}
|
||||
|
||||
$rows = [];
|
||||
|
||||
foreach ($entries as [$month, $day, $title]) {
|
||||
$rows[] = [sprintf('%04d-%02d-%02d', $year, $month, $day), $title];
|
||||
|
||||
if ($force) {
|
||||
$this->holidays->upsertNational($year, $month, $day, $title);
|
||||
}
|
||||
}
|
||||
|
||||
$io->table(['تاریخ شمسی', 'مناسبت'], $rows);
|
||||
$io->success(sprintf('%s — %d تعطیل رسمی سال %d', $force ? 'ثبت شد' : 'ثبت میشود', count($rows), $year));
|
||||
|
||||
return Command::SUCCESS;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Controller;
|
||||
|
||||
use App\Auth\Entity\User;
|
||||
use App\Resource\Entity\NationalHoliday;
|
||||
use App\Resource\Entity\TenantHolidayOverride;
|
||||
use App\Resource\Repository\TenantHolidayOverrideRepository;
|
||||
use App\Resource\Service\HolidayService;
|
||||
use App\Resource\Service\ResourceContext;
|
||||
use App\Shared\Constant\ErrorCodes;
|
||||
use App\Shared\Controller\BaseController;
|
||||
use App\Shared\Tenant\TenantOwnershipChecker;
|
||||
use OpenApi\Attributes as OA;
|
||||
use Symfony\Component\HttpFoundation\JsonResponse;
|
||||
use Symfony\Component\HttpFoundation\Request;
|
||||
use Symfony\Component\Routing\Attribute\Route;
|
||||
use Symfony\Component\Security\Http\Attribute\CurrentUser;
|
||||
use Symfony\Component\Security\Http\Attribute\IsGranted;
|
||||
|
||||
#[OA\Tag(name: 'Resource')]
|
||||
#[IsGranted('IS_AUTHENTICATED_FULLY')]
|
||||
class HolidayController extends BaseController
|
||||
{
|
||||
use ResourcePermissionTrait;
|
||||
|
||||
public function __construct(
|
||||
private readonly HolidayService $holidays,
|
||||
private readonly ResourceContext $context,
|
||||
private readonly TenantHolidayOverrideRepository $overrides,
|
||||
private readonly TenantOwnershipChecker $ownership,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* تعطیلات رسمی سراسریاند و به محیط بستگی ندارند؛ هر کاربر واردشده میتواند
|
||||
* ببیندشان (فقط `view` سنجیده میشود).
|
||||
*/
|
||||
#[Route('/api/v1/national-holidays', name: 'national_holidays_list', methods: ['GET'])]
|
||||
public function nationalHolidays(#[CurrentUser] User $user, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'view');
|
||||
|
||||
$year = $this->holidays->assertJalaliYear($request->query->get('year'));
|
||||
|
||||
[$entityType, $entityId] = $this->context->pair($user);
|
||||
$overrides = $this->holidays->overridesForYear($entityType, $entityId, $year);
|
||||
|
||||
$overrideByDate = [];
|
||||
foreach ($overrides as $override) {
|
||||
$overrideByDate[$override->getDate()] = $override;
|
||||
}
|
||||
|
||||
return $this->success([
|
||||
'year' => $year,
|
||||
'holidays' => array_map(
|
||||
static function (NationalHoliday $h) use ($overrideByDate): array {
|
||||
$row = $h->toArray();
|
||||
// «این محیط آن روز باز است» کنار خودِ تعطیلی میآید تا UI مجبور
|
||||
// نباشد دو فهرست را خودش تطبیق دهد.
|
||||
$row['overridden_working'] = ($overrideByDate[$h->getDate()] ?? null)?->isWorking();
|
||||
|
||||
return $row;
|
||||
},
|
||||
$this->holidays->forYear($year),
|
||||
),
|
||||
'overrides' => array_map(
|
||||
static fn (TenantHolidayOverride $o): array => $o->toArray(),
|
||||
$overrides,
|
||||
),
|
||||
]);
|
||||
}
|
||||
|
||||
#[Route('/api/v1/holiday-overrides', name: 'holiday_override_create', methods: ['POST'])]
|
||||
public function createOverride(#[CurrentUser] User $user, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$data = json_decode($request->getContent(), true);
|
||||
|
||||
if (!is_array($data) || !is_numeric($data['date'] ?? null)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_002, 'فیلد date الزامی است', 422, 'date');
|
||||
}
|
||||
|
||||
if (!array_key_exists('is_working', $data)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_002, 'فیلد is_working الزامی است', 422, 'is_working');
|
||||
}
|
||||
|
||||
[$entityType, $entityId] = $this->context->pair($user);
|
||||
|
||||
$override = $this->holidays->setOverride(
|
||||
$entityType,
|
||||
$entityId,
|
||||
(int) $data['date'],
|
||||
(bool) $data['is_working'],
|
||||
is_string($data['note'] ?? null) && trim($data['note']) !== '' ? trim($data['note']) : null,
|
||||
);
|
||||
|
||||
return $this->success($override->toArray(), 201);
|
||||
}
|
||||
|
||||
#[Route('/api/v1/holiday-override/{uuid}', name: 'holiday_override_delete', methods: ['DELETE'])]
|
||||
public function deleteOverride(#[CurrentUser] User $user, string $uuid): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$override = $this->overrides->findByUuid($uuid);
|
||||
[$entityType, $entityId] = $this->context->pair($user);
|
||||
|
||||
if ($override === null || !$this->ownership->belongsToPair($entityType, $entityId, $override)) {
|
||||
return $this->error(ErrorCodes::ERR_NOT_FOUND_001, 'استثنای تعطیلی یافت نشد', 404);
|
||||
}
|
||||
|
||||
$this->holidays->deleteOverride($override);
|
||||
|
||||
return $this->success(null);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,192 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Controller;
|
||||
|
||||
use App\Auth\Entity\User;
|
||||
use App\Resource\Entity\ResourceException;
|
||||
use App\Resource\Repository\ResourceExceptionRepository;
|
||||
use App\Resource\Service\ResourceAvailabilityService;
|
||||
use App\Resource\Service\ResourceCalendarService;
|
||||
use App\Resource\Service\ResourceContext;
|
||||
use App\Resource\ValueObject\DayAvailability;
|
||||
use App\Shared\Constant\ErrorCodes;
|
||||
use App\Shared\Controller\BaseController;
|
||||
use App\Shared\Exception\AppException;
|
||||
use App\Shared\Tenant\TenantOwnershipChecker;
|
||||
use OpenApi\Attributes as OA;
|
||||
use Symfony\Component\HttpFoundation\JsonResponse;
|
||||
use Symfony\Component\HttpFoundation\Request;
|
||||
use Symfony\Component\Routing\Attribute\Route;
|
||||
use Symfony\Component\Security\Http\Attribute\CurrentUser;
|
||||
use Symfony\Component\Security\Http\Attribute\IsGranted;
|
||||
|
||||
#[OA\Tag(name: 'Resource')]
|
||||
#[IsGranted('IS_AUTHENTICATED_FULLY')]
|
||||
class ResourceCalendarController extends BaseController
|
||||
{
|
||||
use ResourcePermissionTrait;
|
||||
|
||||
public function __construct(
|
||||
private readonly ResourceContext $context,
|
||||
private readonly ResourceCalendarService $calendar,
|
||||
private readonly ResourceAvailabilityService $availability,
|
||||
private readonly ResourceExceptionRepository $exceptions,
|
||||
private readonly TenantOwnershipChecker $ownership,
|
||||
) {}
|
||||
|
||||
#[Route('/api/v1/resource/{uuid}/calendar', name: 'resource_calendar_show', methods: ['GET'])]
|
||||
public function show(#[CurrentUser] User $user, string $uuid): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'view');
|
||||
|
||||
$resource = $this->context->resource($user, $uuid);
|
||||
|
||||
return $this->success([
|
||||
'resource_uuid' => $resource->getUuid(),
|
||||
'timezone' => $resource->getAddress()->getTimezone(),
|
||||
'defined' => $this->calendar->isDefined($resource),
|
||||
'days' => (object) $this->calendar->read($resource),
|
||||
]);
|
||||
}
|
||||
|
||||
/** جایگزینی کامل هفت روز؛ آرایهٔ خالی یعنی منبع هیچ شیفتی ندارد. */
|
||||
#[Route('/api/v1/resource/{uuid}/calendar', name: 'resource_calendar_replace', methods: ['PUT'])]
|
||||
public function replace(#[CurrentUser] User $user, string $uuid, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$data = json_decode($request->getContent(), true);
|
||||
|
||||
if (!is_array($data) || !is_array($data['days'] ?? null)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_002, 'فیلد days الزامی است', 422, 'days');
|
||||
}
|
||||
|
||||
$resource = $this->context->resource($user, $uuid);
|
||||
$days = $this->calendar->replace($resource, $data['days']);
|
||||
|
||||
return $this->success([
|
||||
'resource_uuid' => $resource->getUuid(),
|
||||
'timezone' => $resource->getAddress()->getTimezone(),
|
||||
'defined' => $days !== array_fill_keys(ResourceCalendarService::DAYS, []),
|
||||
'days' => (object) $days,
|
||||
]);
|
||||
}
|
||||
|
||||
#[Route('/api/v1/resource/{uuid}/exceptions', name: 'resource_exceptions_list', methods: ['GET'])]
|
||||
public function listExceptions(#[CurrentUser] User $user, string $uuid, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'view');
|
||||
|
||||
$resource = $this->context->resource($user, $uuid);
|
||||
$from = $request->query->get('from');
|
||||
$to = $request->query->get('to');
|
||||
|
||||
// بدون بازه، همهٔ استثناها از ابتدای زمان تا انتهای آن — عمداً محدود نمیشود
|
||||
// چون فهرست مرخصیِ یک منبع کوچک است و صفحهبندیاش سود ندارد.
|
||||
$rows = $this->exceptions->findOverlapping(
|
||||
$resource,
|
||||
is_numeric($from) ? (int) $from : 0,
|
||||
is_numeric($to) ? (int) $to : PHP_INT_MAX,
|
||||
);
|
||||
|
||||
return $this->success(array_map(
|
||||
static fn (ResourceException $e): array => $e->toArray(),
|
||||
$rows,
|
||||
));
|
||||
}
|
||||
|
||||
#[Route('/api/v1/resource/{uuid}/exception', name: 'resource_exception_create', methods: ['POST'])]
|
||||
public function createException(#[CurrentUser] User $user, string $uuid, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$data = json_decode($request->getContent(), true);
|
||||
|
||||
if (!is_array($data)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_001, 'بدنهٔ درخواست نامعتبر است', 422);
|
||||
}
|
||||
|
||||
$resource = $this->context->resource($user, $uuid);
|
||||
$exception = $this->calendar->createException($resource, $data);
|
||||
|
||||
return $this->success($exception->toArray(), 201);
|
||||
}
|
||||
|
||||
#[Route('/api/v1/resource-exception/{uuid}', name: 'resource_exception_update', methods: ['PATCH'])]
|
||||
public function updateException(#[CurrentUser] User $user, string $uuid, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$data = json_decode($request->getContent(), true);
|
||||
|
||||
if (!is_array($data)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_001, 'بدنهٔ درخواست نامعتبر است', 422);
|
||||
}
|
||||
|
||||
return $this->success($this->calendar->updateException($this->requireException($user, $uuid), $data)->toArray());
|
||||
}
|
||||
|
||||
#[Route('/api/v1/resource-exception/{uuid}', name: 'resource_exception_delete', methods: ['DELETE'])]
|
||||
public function deleteException(#[CurrentUser] User $user, string $uuid): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'update');
|
||||
|
||||
$this->calendar->deleteException($this->requireException($user, $uuid));
|
||||
|
||||
return $this->success(null);
|
||||
}
|
||||
|
||||
/**
|
||||
* ساعت آزاد **خام**: ساعت شعبه ∩ شیفت منبع − تعطیلات − استثناها.
|
||||
* نوبتهای ثبتشده اینجا کسر نمیشوند — آن کارِ تسک ۰۶/۰۷ است.
|
||||
*/
|
||||
#[Route('/api/v1/resource/{uuid}/availability', name: 'resource_availability', methods: ['GET'])]
|
||||
public function availabilityFor(#[CurrentUser] User $user, string $uuid, Request $request): JsonResponse
|
||||
{
|
||||
$this->denyUnlessGranted($user, 'view');
|
||||
|
||||
$resource = $this->context->resource($user, $uuid);
|
||||
$from = $request->query->get('from');
|
||||
$to = $request->query->get('to');
|
||||
|
||||
if (!is_numeric($from) || !is_numeric($to)) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_002, 'پارامترهای from و to الزامیاند', 422, 'from');
|
||||
}
|
||||
|
||||
if ((int) $to < (int) $from) {
|
||||
return $this->error(ErrorCodes::ERR_VALIDATION_001, 'to باید بعد از from باشد', 422, 'to');
|
||||
}
|
||||
|
||||
$days = intdiv((int) $to - (int) $from, ResourceAvailabilityService::DAY_SECONDS) + 1;
|
||||
|
||||
if ($days > ResourceAvailabilityService::MAX_DAYS) {
|
||||
return $this->error(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
sprintf('بازهٔ درخواستی حداکثر %d روز است', ResourceAvailabilityService::MAX_DAYS),
|
||||
422,
|
||||
'to',
|
||||
);
|
||||
}
|
||||
|
||||
return $this->success([
|
||||
'resource_uuid' => $resource->getUuid(),
|
||||
'timezone' => $resource->getAddress()->getTimezone(),
|
||||
'days' => array_map(
|
||||
static fn (DayAvailability $d): array => $d->toArray(),
|
||||
$this->availability->rawAvailability($resource, (int) $from, (int) $to),
|
||||
),
|
||||
]);
|
||||
}
|
||||
|
||||
private function requireException(User $user, string $uuid): ResourceException
|
||||
{
|
||||
$exception = $this->exceptions->findByUuid($uuid);
|
||||
[$entityType, $entityId] = $this->context->pair($user);
|
||||
|
||||
if ($exception === null || !$this->ownership->belongsToPair($entityType, $entityId, $exception)) {
|
||||
throw new AppException(ErrorCodes::ERR_NOT_FOUND_001, 'استثنا یافت نشد', 404);
|
||||
}
|
||||
|
||||
return $exception;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Entity;
|
||||
|
||||
use App\Resource\Repository\NationalHolidayRepository;
|
||||
use Doctrine\ORM\Mapping as ORM;
|
||||
use Symfony\Component\Uid\Uuid;
|
||||
|
||||
/**
|
||||
* تعطیل رسمی کشور. عمداً سراسری است و به هیچ محیطی تعلق ندارد — امروز هر پزشک باید
|
||||
* ۱۳ فروردین را دستی ثبت کند، که هم تکرار است و هم منبع خطا.
|
||||
*
|
||||
* محیطی که خلافش کار میکند با {@see TenantHolidayOverride} استثنا میزند؛ خودِ این
|
||||
* جدول per محیط نمیشود، وگرنه «تعطیل کشوری» معنایش را از دست میدهد.
|
||||
*
|
||||
* `date` نیمهشبِ همان روز به وقت تهران است (int، مثل بقیهٔ زمانهای پروژه) و
|
||||
* `jalali_date` فقط برای نمایش و import.
|
||||
*/
|
||||
#[ORM\Entity(repositoryClass: NationalHolidayRepository::class)]
|
||||
#[ORM\Table(name: 'national_holidays')]
|
||||
#[ORM\UniqueConstraint(name: 'uniq_holiday_date', columns: ['date'])]
|
||||
#[ORM\Index(columns: ['jalali_year'], name: 'idx_holiday_year')]
|
||||
class NationalHoliday
|
||||
{
|
||||
#[ORM\Id]
|
||||
#[ORM\GeneratedValue]
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private ?int $id = null;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 36, unique: true)]
|
||||
private string $uuid;
|
||||
|
||||
/** نیمهشب همان روز به وقت تهران */
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private int $date;
|
||||
|
||||
#[ORM\Column(name: 'jalali_date', type: 'string', length: 10)]
|
||||
private string $jalaliDate;
|
||||
|
||||
#[ORM\Column(name: 'jalali_year', type: 'smallint')]
|
||||
private int $jalaliYear;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 200)]
|
||||
private string $title;
|
||||
|
||||
#[ORM\Column(name: 'created_at', type: 'integer')]
|
||||
private int $createdAt;
|
||||
|
||||
public function __construct(int $date, string $jalaliDate, int $jalaliYear, string $title)
|
||||
{
|
||||
$this->uuid = Uuid::v4()->toRfc4122();
|
||||
$this->date = $date;
|
||||
$this->jalaliDate = $jalaliDate;
|
||||
$this->jalaliYear = $jalaliYear;
|
||||
$this->title = $title;
|
||||
$this->createdAt = time();
|
||||
}
|
||||
|
||||
public function getId(): ?int { return $this->id; }
|
||||
public function getUuid(): string { return $this->uuid; }
|
||||
public function getDate(): int { return $this->date; }
|
||||
public function getJalaliDate(): string { return $this->jalaliDate; }
|
||||
public function getJalaliYear(): int { return $this->jalaliYear; }
|
||||
public function getTitle(): string { return $this->title; }
|
||||
|
||||
public function setTitle(string $v): self { $this->title = $v; return $this; }
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return [
|
||||
'uuid' => $this->uuid,
|
||||
'date' => $this->date,
|
||||
'jalali_date' => $this->jalaliDate,
|
||||
'jalali_year' => $this->jalaliYear,
|
||||
'title' => $this->title,
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Entity;
|
||||
|
||||
use App\Resource\Repository\ResourceCalendarRepository;
|
||||
use Doctrine\ORM\Mapping as ORM;
|
||||
|
||||
/**
|
||||
* شیفت تکرارشوندهٔ هفتگی یک منبع — لایهٔ دومِ کسرِ بند ۹ مستند.
|
||||
*
|
||||
* فرزند aggregate با ریشهٔ {@see ClinicResource} که خودش جفت محیط دارد و uuid این
|
||||
* ردیف هرگز از request نمیآید (تنها راهش `PUT /resource/{uuid}/calendar` است).
|
||||
*
|
||||
* عمداً `WeeklySchedule` را بازاستفاده نمیکند: آن JSON per جفت (پزشک، کلینیک) است و
|
||||
* دست زدن به شکلش یعنی دست زدن به مسیر اسلاتی که در این فاز قفل است
|
||||
* ({@see docs/new_feture/taskes/_shared/red-lines.md}). این جدول مسیر موازیِ منبع است.
|
||||
*/
|
||||
#[ORM\Entity(repositoryClass: ResourceCalendarRepository::class)]
|
||||
#[ORM\Table(name: 'resource_calendars')]
|
||||
#[ORM\UniqueConstraint(name: 'uniq_rc_resource_day_seq', columns: ['resource_id', 'day_of_week', 'sequence'])]
|
||||
#[ORM\Index(columns: ['resource_id', 'day_of_week', 'active'], name: 'idx_rc_resource_day')]
|
||||
class ResourceCalendar
|
||||
{
|
||||
public const MINUTES_IN_DAY = 1440;
|
||||
|
||||
#[ORM\Id]
|
||||
#[ORM\GeneratedValue]
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private ?int $id = null;
|
||||
|
||||
#[ORM\ManyToOne(targetEntity: ClinicResource::class)]
|
||||
#[ORM\JoinColumn(name: 'resource_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
|
||||
private ClinicResource $resource;
|
||||
|
||||
/** ۰=شنبه … ۶=جمعه — همان قرارداد SlotCalculatorService و ساعت کاری شعبه */
|
||||
#[ORM\Column(name: 'day_of_week', type: 'smallint')]
|
||||
private int $dayOfWeek;
|
||||
|
||||
#[ORM\Column(type: 'smallint', options: ['default' => 0])]
|
||||
private int $sequence = 0;
|
||||
|
||||
#[ORM\Column(name: 'start_minute', type: 'smallint')]
|
||||
private int $startMinute;
|
||||
|
||||
#[ORM\Column(name: 'end_minute', type: 'smallint')]
|
||||
private int $endMinute;
|
||||
|
||||
#[ORM\Column(type: 'boolean', options: ['default' => true])]
|
||||
private bool $active = true;
|
||||
|
||||
public function __construct(
|
||||
ClinicResource $resource,
|
||||
int $dayOfWeek,
|
||||
int $startMinute,
|
||||
int $endMinute,
|
||||
int $sequence = 0,
|
||||
) {
|
||||
$this->resource = $resource;
|
||||
$this->dayOfWeek = $dayOfWeek;
|
||||
$this->startMinute = $startMinute;
|
||||
$this->endMinute = $endMinute;
|
||||
$this->sequence = $sequence;
|
||||
}
|
||||
|
||||
public function getId(): ?int { return $this->id; }
|
||||
public function getResource(): ClinicResource { return $this->resource; }
|
||||
public function getDayOfWeek(): int { return $this->dayOfWeek; }
|
||||
public function getSequence(): int { return $this->sequence; }
|
||||
public function getStartMinute(): int { return $this->startMinute; }
|
||||
public function getEndMinute(): int { return $this->endMinute; }
|
||||
public function isActive(): bool { return $this->active; }
|
||||
|
||||
public function setActive(bool $v): self { $this->active = $v; return $this; }
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return [
|
||||
'sequence' => $this->sequence,
|
||||
'start_minute' => $this->startMinute,
|
||||
'end_minute' => $this->endMinute,
|
||||
'start_time' => self::formatMinute($this->startMinute),
|
||||
'end_time' => self::formatMinute($this->endMinute),
|
||||
'active' => $this->active,
|
||||
];
|
||||
}
|
||||
|
||||
/** ۱۴۴۰ به «۲۴:۰۰» تبدیل میشود، نه «۰۰:۰۰» — پایان روز است نه آغازش. */
|
||||
public static function formatMinute(int $minute): string
|
||||
{
|
||||
return sprintf('%02d:%02d', intdiv($minute, 60), $minute % 60);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Entity;
|
||||
|
||||
use App\Resource\Repository\ResourceExceptionRepository;
|
||||
use App\Shared\Tenant\TenantOwnedTrait;
|
||||
use Doctrine\ORM\Mapping as ORM;
|
||||
use Symfony\Component\Uid\Uuid;
|
||||
|
||||
/**
|
||||
* بازهای که منبع در آن در دسترس نیست — مرخصی، غیبت، سرویس دورهای دستگاه، تعطیلی موردی.
|
||||
*
|
||||
* چهار نوع، یک جدول: هر چهار «یک بازهٔ کسرشونده از تقویم منبع»اند و جدا کردنشان یعنی
|
||||
* چهار کوئری در محاسبهٔ ساعت آزاد بهجای یکی. `reason` فقط برای نمایش و گزارش است.
|
||||
*
|
||||
* جفت محیط دارد چون uuidش از request میآید (`PATCH/DELETE /resource-exception/{uuid}`).
|
||||
*
|
||||
* زمانها **timestamp مطلق**اند نه دقیقهاز-نیمهشب: یک مرخصی میتواند چندروزه باشد و
|
||||
* بیانش با دقیقهی روز، هر مصرفکننده را مجبور میکرد خودش روزها را بشکافد.
|
||||
*/
|
||||
#[ORM\Entity(repositoryClass: ResourceExceptionRepository::class)]
|
||||
#[ORM\Table(name: 'resource_exceptions')]
|
||||
#[ORM\Index(columns: ['entity_type', 'entity_id'], name: 'idx_rex_tenant')]
|
||||
#[ORM\Index(columns: ['resource_id', 'starts_at', 'ends_at'], name: 'idx_rex_resource_range')]
|
||||
class ResourceException
|
||||
{
|
||||
use TenantOwnedTrait;
|
||||
|
||||
public const TYPE_LEAVE = 'leave'; // مرخصی
|
||||
public const TYPE_ABSENCE = 'absence'; // غیبت
|
||||
public const TYPE_MAINTENANCE = 'maintenance'; // سرویس دورهای دستگاه
|
||||
public const TYPE_CLOSURE = 'closure'; // تعطیلی موردی
|
||||
|
||||
public const TYPES = [
|
||||
self::TYPE_LEAVE => 'مرخصی',
|
||||
self::TYPE_ABSENCE => 'غیبت',
|
||||
self::TYPE_MAINTENANCE => 'سرویس دورهای',
|
||||
self::TYPE_CLOSURE => 'تعطیلی موردی',
|
||||
];
|
||||
|
||||
#[ORM\Id]
|
||||
#[ORM\GeneratedValue]
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private ?int $id = null;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 36, unique: true)]
|
||||
private string $uuid;
|
||||
|
||||
#[ORM\ManyToOne(targetEntity: ClinicResource::class)]
|
||||
#[ORM\JoinColumn(name: 'resource_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
|
||||
private ClinicResource $resource;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 20)]
|
||||
private string $type;
|
||||
|
||||
#[ORM\Column(name: 'starts_at', type: 'integer')]
|
||||
private int $startsAt;
|
||||
|
||||
#[ORM\Column(name: 'ends_at', type: 'integer')]
|
||||
private int $endsAt;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 200, nullable: true)]
|
||||
private ?string $reason = null;
|
||||
|
||||
#[ORM\Column(name: 'created_at', type: 'integer')]
|
||||
private int $createdAt;
|
||||
|
||||
#[ORM\Column(name: 'updated_at', type: 'integer')]
|
||||
private int $updatedAt;
|
||||
|
||||
public function __construct(ClinicResource $resource, string $type, int $startsAt, int $endsAt)
|
||||
{
|
||||
if (!array_key_exists($type, self::TYPES)) {
|
||||
throw new \InvalidArgumentException(sprintf('Unknown resource exception type "%s".', $type));
|
||||
}
|
||||
|
||||
if ($endsAt <= $startsAt) {
|
||||
throw new \InvalidArgumentException('Exception end must be after its start.');
|
||||
}
|
||||
|
||||
$this->uuid = Uuid::v4()->toRfc4122();
|
||||
$this->resource = $resource;
|
||||
$this->type = $type;
|
||||
$this->startsAt = $startsAt;
|
||||
$this->endsAt = $endsAt;
|
||||
$this->createdAt = time();
|
||||
$this->updatedAt = time();
|
||||
|
||||
$this->assignTenantPair($resource->getEntityType(), $resource->getEntityId());
|
||||
}
|
||||
|
||||
public function getId(): ?int { return $this->id; }
|
||||
public function getUuid(): string { return $this->uuid; }
|
||||
public function getResource(): ClinicResource { return $this->resource; }
|
||||
public function getType(): string { return $this->type; }
|
||||
public function getStartsAt(): int { return $this->startsAt; }
|
||||
public function getEndsAt(): int { return $this->endsAt; }
|
||||
public function getReason(): ?string { return $this->reason; }
|
||||
public function getCreatedAt(): int { return $this->createdAt; }
|
||||
public function getUpdatedAt(): int { return $this->updatedAt; }
|
||||
|
||||
public function setReason(?string $v): self { $this->reason = $v; $this->touch(); return $this; }
|
||||
|
||||
/** @throws \InvalidArgumentException روی بازهٔ وارونه */
|
||||
public function reschedule(int $startsAt, int $endsAt): self
|
||||
{
|
||||
if ($endsAt <= $startsAt) {
|
||||
throw new \InvalidArgumentException('Exception end must be after its start.');
|
||||
}
|
||||
|
||||
$this->startsAt = $startsAt;
|
||||
$this->endsAt = $endsAt;
|
||||
$this->touch();
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
private function touch(): void { $this->updatedAt = time(); }
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return [
|
||||
'uuid' => $this->uuid,
|
||||
'resource_uuid' => $this->resource->getUuid(),
|
||||
'resource_name' => $this->resource->getName(),
|
||||
'type' => $this->type,
|
||||
'type_label' => self::TYPES[$this->type],
|
||||
'starts_at' => $this->startsAt,
|
||||
'ends_at' => $this->endsAt,
|
||||
'reason' => $this->reason,
|
||||
'created_at' => $this->createdAt,
|
||||
'updated_at' => $this->updatedAt,
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Entity;
|
||||
|
||||
use App\Resource\Repository\TenantHolidayOverrideRepository;
|
||||
use App\Shared\Tenant\TenantOwnedTrait;
|
||||
use Doctrine\ORM\Mapping as ORM;
|
||||
use Symfony\Component\Uid\Uuid;
|
||||
|
||||
/**
|
||||
* استثنای یک محیط روی تقویم تعطیلات.
|
||||
*
|
||||
* دو جهت دارد و هر دو لازماند:
|
||||
* • `is_working = true` → کلینیکی که آن روزِ تعطیلِ رسمی باز است
|
||||
* • `is_working = false` → روزی که رسمی نیست ولی این محیط تعطیل است (تعطیلی هفتگی
|
||||
* یا مناسبت داخلی)
|
||||
*
|
||||
* جهت دوم `ResourceException` نیست: آن روی **یک منبع** است و این روی **کل محیط**.
|
||||
*/
|
||||
#[ORM\Entity(repositoryClass: TenantHolidayOverrideRepository::class)]
|
||||
#[ORM\Table(name: 'tenant_holiday_overrides')]
|
||||
#[ORM\UniqueConstraint(name: 'uniq_tho_tenant_date', columns: ['entity_type', 'entity_id', 'date'])]
|
||||
#[ORM\Index(columns: ['entity_type', 'entity_id', 'date'], name: 'idx_tho_tenant_date')]
|
||||
class TenantHolidayOverride
|
||||
{
|
||||
use TenantOwnedTrait;
|
||||
|
||||
#[ORM\Id]
|
||||
#[ORM\GeneratedValue]
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private ?int $id = null;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 36, unique: true)]
|
||||
private string $uuid;
|
||||
|
||||
/** نیمهشب همان روز به وقت تهران */
|
||||
#[ORM\Column(type: 'integer')]
|
||||
private int $date;
|
||||
|
||||
#[ORM\Column(name: 'is_working', type: 'boolean')]
|
||||
private bool $isWorking;
|
||||
|
||||
#[ORM\Column(type: 'string', length: 200, nullable: true)]
|
||||
private ?string $note = null;
|
||||
|
||||
#[ORM\Column(name: 'created_at', type: 'integer')]
|
||||
private int $createdAt;
|
||||
|
||||
public function __construct(string $entityType, int $entityId, int $date, bool $isWorking)
|
||||
{
|
||||
$this->uuid = Uuid::v4()->toRfc4122();
|
||||
$this->date = $date;
|
||||
$this->isWorking = $isWorking;
|
||||
$this->createdAt = time();
|
||||
|
||||
$this->assignTenantPair($entityType, $entityId);
|
||||
}
|
||||
|
||||
public function getId(): ?int { return $this->id; }
|
||||
public function getUuid(): string { return $this->uuid; }
|
||||
public function getDate(): int { return $this->date; }
|
||||
public function isWorking(): bool { return $this->isWorking; }
|
||||
public function getNote(): ?string { return $this->note; }
|
||||
|
||||
public function setNote(?string $v): self { $this->note = $v; return $this; }
|
||||
public function setWorking(bool $v): self { $this->isWorking = $v; return $this; }
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return [
|
||||
'uuid' => $this->uuid,
|
||||
'date' => $this->date,
|
||||
'is_working' => $this->isWorking,
|
||||
'note' => $this->note,
|
||||
'created_at' => $this->createdAt,
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Repository;
|
||||
|
||||
use App\Resource\Entity\NationalHoliday;
|
||||
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
|
||||
use Doctrine\Persistence\ManagerRegistry;
|
||||
|
||||
/**
|
||||
* @extends ServiceEntityRepository<NationalHoliday>
|
||||
*/
|
||||
class NationalHolidayRepository extends ServiceEntityRepository
|
||||
{
|
||||
public function __construct(ManagerRegistry $registry)
|
||||
{
|
||||
parent::__construct($registry, NationalHoliday::class);
|
||||
}
|
||||
|
||||
/** @return NationalHoliday[] */
|
||||
public function findForYear(int $jalaliYear): array
|
||||
{
|
||||
return $this->createQueryBuilder('h')
|
||||
->where('h.jalaliYear = :year')
|
||||
->setParameter('year', $jalaliYear)
|
||||
->orderBy('h.date', 'ASC')
|
||||
->getQuery()
|
||||
->getResult();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<int, NationalHoliday> کلید = نیمهشب همان روز
|
||||
*/
|
||||
public function mapForRange(int $from, int $to): array
|
||||
{
|
||||
$rows = $this->createQueryBuilder('h')
|
||||
->where('h.date >= :from')
|
||||
->andWhere('h.date <= :to')
|
||||
->setParameter('from', $from)
|
||||
->setParameter('to', $to)
|
||||
->getQuery()
|
||||
->getResult();
|
||||
|
||||
$map = [];
|
||||
foreach ($rows as $holiday) {
|
||||
$map[$holiday->getDate()] = $holiday;
|
||||
}
|
||||
|
||||
return $map;
|
||||
}
|
||||
|
||||
public function findByDate(int $date): ?NationalHoliday
|
||||
{
|
||||
return $this->findOneBy(['date' => $date]);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Repository;
|
||||
|
||||
use App\Resource\Entity\ClinicResource;
|
||||
use App\Resource\Entity\ResourceCalendar;
|
||||
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
|
||||
use Doctrine\Persistence\ManagerRegistry;
|
||||
|
||||
/**
|
||||
* @extends ServiceEntityRepository<ResourceCalendar>
|
||||
*/
|
||||
class ResourceCalendarRepository extends ServiceEntityRepository
|
||||
{
|
||||
public function __construct(ManagerRegistry $registry)
|
||||
{
|
||||
parent::__construct($registry, ResourceCalendar::class);
|
||||
}
|
||||
|
||||
/** @return ResourceCalendar[] */
|
||||
public function findForResource(ClinicResource $resource): array
|
||||
{
|
||||
return $this->createQueryBuilder('c')
|
||||
->where('c.resource = :resource')
|
||||
->setParameter('resource', $resource)
|
||||
->orderBy('c.dayOfWeek', 'ASC')
|
||||
->addOrderBy('c.sequence', 'ASC')
|
||||
->getQuery()
|
||||
->getResult();
|
||||
}
|
||||
|
||||
public function deleteForResource(ClinicResource $resource): int
|
||||
{
|
||||
return (int) $this->createQueryBuilder('c')
|
||||
->delete()
|
||||
->where('c.resource = :resource')
|
||||
->setParameter('resource', $resource)
|
||||
->getQuery()
|
||||
->execute();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int[] $resourceIds
|
||||
* @return array<int, int> شناسهٔ منبع => تعداد شیفت
|
||||
*/
|
||||
public function countByResourceIds(array $resourceIds): array
|
||||
{
|
||||
if ($resourceIds === []) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$rows = $this->createQueryBuilder('c')
|
||||
->select('IDENTITY(c.resource) AS resource_id, COUNT(c.id) AS total')
|
||||
->where('c.resource IN (:ids)')
|
||||
->setParameter('ids', $resourceIds)
|
||||
->groupBy('c.resource')
|
||||
->getQuery()
|
||||
->getArrayResult();
|
||||
|
||||
$counts = [];
|
||||
foreach ($rows as $row) {
|
||||
$counts[(int) $row['resource_id']] = (int) $row['total'];
|
||||
}
|
||||
|
||||
return $counts;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Repository;
|
||||
|
||||
use App\Resource\Entity\ClinicResource;
|
||||
use App\Resource\Entity\ResourceException;
|
||||
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
|
||||
use Doctrine\Persistence\ManagerRegistry;
|
||||
|
||||
/**
|
||||
* @extends ServiceEntityRepository<ResourceException>
|
||||
*/
|
||||
class ResourceExceptionRepository extends ServiceEntityRepository
|
||||
{
|
||||
public function __construct(ManagerRegistry $registry)
|
||||
{
|
||||
parent::__construct($registry, ResourceException::class);
|
||||
}
|
||||
|
||||
public function findByUuid(string $uuid): ?ResourceException
|
||||
{
|
||||
return $this->findOneBy(['uuid' => $uuid]);
|
||||
}
|
||||
|
||||
/**
|
||||
* استثناهایی که با بازهٔ [from, to) **تداخل** دارند — نه فقط آنهایی که کاملاً
|
||||
* درونشاند. مرخصیِ سهروزهای که وسطش این بازه است باید برگردد.
|
||||
*
|
||||
* @return ResourceException[]
|
||||
*/
|
||||
public function findOverlapping(ClinicResource $resource, int $from, int $to): array
|
||||
{
|
||||
return $this->createQueryBuilder('e')
|
||||
->where('e.resource = :resource')
|
||||
->andWhere('e.startsAt < :to')
|
||||
->andWhere('e.endsAt > :from')
|
||||
->setParameter('resource', $resource)
|
||||
->setParameter('from', $from)
|
||||
->setParameter('to', $to)
|
||||
->orderBy('e.startsAt', 'ASC')
|
||||
->getQuery()
|
||||
->getResult();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Repository;
|
||||
|
||||
use App\Resource\Entity\TenantHolidayOverride;
|
||||
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
|
||||
use Doctrine\Persistence\ManagerRegistry;
|
||||
|
||||
/**
|
||||
* @extends ServiceEntityRepository<TenantHolidayOverride>
|
||||
*/
|
||||
class TenantHolidayOverrideRepository extends ServiceEntityRepository
|
||||
{
|
||||
public function __construct(ManagerRegistry $registry)
|
||||
{
|
||||
parent::__construct($registry, TenantHolidayOverride::class);
|
||||
}
|
||||
|
||||
public function findByUuid(string $uuid): ?TenantHolidayOverride
|
||||
{
|
||||
return $this->findOneBy(['uuid' => $uuid]);
|
||||
}
|
||||
|
||||
public function findForDate(string $entityType, int $entityId, int $date): ?TenantHolidayOverride
|
||||
{
|
||||
return $this->findOneBy(['entityType' => $entityType, 'entityId' => $entityId, 'date' => $date]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<int, TenantHolidayOverride> کلید = نیمهشب همان روز
|
||||
*/
|
||||
public function mapForRange(string $entityType, int $entityId, int $from, int $to): array
|
||||
{
|
||||
$rows = $this->createQueryBuilder('o')
|
||||
->where('o.entityType = :type')
|
||||
->andWhere('o.entityId = :id')
|
||||
->andWhere('o.date >= :from')
|
||||
->andWhere('o.date <= :to')
|
||||
->setParameter('type', $entityType)
|
||||
->setParameter('id', $entityId)
|
||||
->setParameter('from', $from)
|
||||
->setParameter('to', $to)
|
||||
->getQuery()
|
||||
->getResult();
|
||||
|
||||
$map = [];
|
||||
foreach ($rows as $override) {
|
||||
$map[$override->getDate()] = $override;
|
||||
}
|
||||
|
||||
return $map;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,141 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Service;
|
||||
|
||||
use App\Representation\Service\JalaliDateService;
|
||||
use App\Resource\Entity\NationalHoliday;
|
||||
use App\Resource\Entity\TenantHolidayOverride;
|
||||
use App\Resource\Repository\NationalHolidayRepository;
|
||||
use App\Resource\Repository\TenantHolidayOverrideRepository;
|
||||
use App\Shared\Constant\ErrorCodes;
|
||||
use App\Shared\Exception\AppException;
|
||||
use Doctrine\ORM\EntityManagerInterface;
|
||||
|
||||
/**
|
||||
* تعطیلات رسمی کشور و استثناهای هر محیط رویشان.
|
||||
*
|
||||
* تبدیل شمسی از {@see JalaliDateService} میآید و اینجا دوباره پیاده نمیشود — آن
|
||||
* سرویس از فاز نمایندگی موجود است و درست کار میکند. (نامِ فضایش
|
||||
* `App\Representation` است که برای مصرف مشترک جای درستی نیست؛ جابهجا کردنش یک
|
||||
* تغییر مکانیکی در کل کدبیس است و به این تسک ربطی ندارد.)
|
||||
*/
|
||||
final class HolidayService
|
||||
{
|
||||
/** تهران مرجع «روز» است: تعطیل رسمی کشوری است، نه محلیِ شعبه. */
|
||||
public const NATIONAL_TIMEZONE = 'Asia/Tehran';
|
||||
|
||||
public function __construct(
|
||||
private readonly NationalHolidayRepository $holidays,
|
||||
private readonly TenantHolidayOverrideRepository $overrides,
|
||||
private readonly JalaliDateService $jalali,
|
||||
private readonly EntityManagerInterface $em,
|
||||
) {}
|
||||
|
||||
/** نیمهشبِ یک تاریخ شمسی به وقت تهران. */
|
||||
public function jalaliToMidnight(int $jy, int $jm, int $jd): int
|
||||
{
|
||||
[$gy, $gm, $gd] = $this->jalali->jalaliToGregorian($jy, $jm, $jd);
|
||||
|
||||
return (new \DateTimeImmutable(
|
||||
sprintf('%04d-%02d-%02d 00:00:00', $gy, $gm, $gd),
|
||||
new \DateTimeZone(self::NATIONAL_TIMEZONE),
|
||||
))->getTimestamp();
|
||||
}
|
||||
|
||||
/**
|
||||
* یک تعطیل رسمی را ثبت یا بهروز میکند. idempotent: تکیهگاهش `date` است که
|
||||
* یکتاست، پس import دوباره ردیف تکراری نمیسازد.
|
||||
*
|
||||
* خودش flush میکند و این عمدی است: سپردنِ flush به فراخوان یعنی اگر او
|
||||
* EntityManager دیگری در دست داشته باشد، persist روی یکی و flush روی دیگری
|
||||
* میافتد و **هیچ ردیفی نوشته نمیشود، بیهیچ خطایی**. همین در تستها اتفاق افتاد،
|
||||
* چون هر درخواست HTTP کرنل را از نو میسازد و سرویس از کانتینر تازه میآید.
|
||||
*/
|
||||
public function upsertNational(int $jy, int $jm, int $jd, string $title): NationalHoliday
|
||||
{
|
||||
$date = $this->jalaliToMidnight($jy, $jm, $jd);
|
||||
$existing = $this->holidays->findByDate($date);
|
||||
|
||||
if ($existing !== null) {
|
||||
$existing->setTitle($title);
|
||||
$this->em->flush();
|
||||
|
||||
return $existing;
|
||||
}
|
||||
|
||||
$holiday = new NationalHoliday(
|
||||
$date,
|
||||
sprintf('%04d-%02d-%02d', $jy, $jm, $jd),
|
||||
$jy,
|
||||
$title,
|
||||
);
|
||||
|
||||
$this->em->persist($holiday);
|
||||
$this->em->flush();
|
||||
|
||||
return $holiday;
|
||||
}
|
||||
|
||||
/** @return NationalHoliday[] */
|
||||
public function forYear(int $jalaliYear): array
|
||||
{
|
||||
return $this->holidays->findForYear($jalaliYear);
|
||||
}
|
||||
|
||||
/**
|
||||
* استثنای محیط. روی همان تاریخ دوباره فرستادن، همان ردیف را عوض میکند — وگرنه
|
||||
* کلید یکتا با خطای خام دیتابیس میشکست.
|
||||
*/
|
||||
public function setOverride(string $entityType, int $entityId, int $date, bool $isWorking, ?string $note): TenantHolidayOverride
|
||||
{
|
||||
$midnight = $this->midnightTehran($date);
|
||||
$existing = $this->overrides->findForDate($entityType, $entityId, $midnight);
|
||||
|
||||
if ($existing !== null) {
|
||||
$existing->setWorking($isWorking)->setNote($note);
|
||||
$this->em->flush();
|
||||
|
||||
return $existing;
|
||||
}
|
||||
|
||||
$override = new TenantHolidayOverride($entityType, $entityId, $midnight, $isWorking);
|
||||
$override->setNote($note);
|
||||
|
||||
$this->em->persist($override);
|
||||
$this->em->flush();
|
||||
|
||||
return $override;
|
||||
}
|
||||
|
||||
public function deleteOverride(TenantHolidayOverride $override): void
|
||||
{
|
||||
$this->em->remove($override);
|
||||
$this->em->flush();
|
||||
}
|
||||
|
||||
/** @return TenantHolidayOverride[] */
|
||||
public function overridesForYear(string $entityType, int $entityId, int $jalaliYear): array
|
||||
{
|
||||
$from = $this->jalaliToMidnight($jalaliYear, 1, 1);
|
||||
$to = $this->jalaliToMidnight($jalaliYear + 1, 1, 1);
|
||||
|
||||
return array_values($this->overrides->mapForRange($entityType, $entityId, $from, $to));
|
||||
}
|
||||
|
||||
public function assertJalaliYear(mixed $value): int
|
||||
{
|
||||
if (!is_numeric($value) || (int) $value < 1300 || (int) $value > 1500) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'سال شمسی نامعتبر است', 422, 'year');
|
||||
}
|
||||
|
||||
return (int) $value;
|
||||
}
|
||||
|
||||
private function midnightTehran(int $timestamp): int
|
||||
{
|
||||
return (new \DateTimeImmutable('@' . $timestamp))
|
||||
->setTimezone(new \DateTimeZone(self::NATIONAL_TIMEZONE))
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,256 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Service;
|
||||
|
||||
use App\Branch\Repository\BranchWorkingHoursRepository;
|
||||
use App\Resource\Entity\ClinicResource;
|
||||
use App\Resource\Entity\ResourceException;
|
||||
use App\Resource\Repository\NationalHolidayRepository;
|
||||
use App\Resource\Repository\ResourceCalendarRepository;
|
||||
use App\Resource\Repository\ResourceExceptionRepository;
|
||||
use App\Resource\Repository\TenantHolidayOverrideRepository;
|
||||
use App\Resource\ValueObject\DayAvailability;
|
||||
use App\Resource\ValueObject\TimeInterval;
|
||||
|
||||
/**
|
||||
* «ساعت آزادِ خامِ یک منبع در یک بازه» — لایههای ۱ تا ۴ از کسرِ بند ۹ مستند:
|
||||
*
|
||||
* ساعت کاری شعبه ∩ شیفت منبع − تعطیلات رسمی − استثناهای منبع
|
||||
*
|
||||
* **نوبتهای ثبتشده و رزروهای موقت اینجا کسر نمیشوند** — آنها تسک ۰۶/۰۷ هستند و
|
||||
* تقاطع چند منبع هم همانجاست. اسم متد `rawAvailability` عمدی است تا کسی این خروجی
|
||||
* را «وقت قابل رزرو» نپندارد.
|
||||
*
|
||||
* این سرویس هیچ ارتباطی با `SlotCalculatorService` ندارد و آن را صدا نمیزند: مسیر
|
||||
* اسلاتیِ موجود در این فاز قفل است ({@see docs/new_feture/taskes/_shared/red-lines.md}).
|
||||
*/
|
||||
final class ResourceAvailabilityService
|
||||
{
|
||||
/** حداکثر بازهٔ قابل پرسوجو — بیحد گذاشتنش یعنی یک درخواست میتواند سالها را بسازد. */
|
||||
public const MAX_DAYS = 92;
|
||||
|
||||
public const DAY_SECONDS = 86400;
|
||||
|
||||
public function __construct(
|
||||
private readonly ResourceCalendarRepository $calendars,
|
||||
private readonly ResourceExceptionRepository $exceptions,
|
||||
private readonly BranchWorkingHoursRepository $branchHours,
|
||||
private readonly NationalHolidayRepository $holidays,
|
||||
private readonly TenantHolidayOverrideRepository $overrides,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* @param int $from نیمهشبِ روز آغاز (به وقت محلی شعبه)
|
||||
* @param int $to نیمهشبِ روز پایان — خودِ این روز هم شامل است
|
||||
* @return DayAvailability[]
|
||||
*/
|
||||
public function rawAvailability(ClinicResource $resource, int $from, int $to): array
|
||||
{
|
||||
$timezone = new \DateTimeZone($resource->getAddress()->getTimezone());
|
||||
$startDay = $this->midnight($from, $timezone);
|
||||
$endDay = $this->midnight($to, $timezone);
|
||||
|
||||
// شیفتها و ساعت شعبه یک بار خوانده میشوند، نه per روز.
|
||||
$shiftsByDay = $this->shiftsByDay($resource);
|
||||
$branchByDay = $this->branchHoursByDay($resource);
|
||||
|
||||
$holidayMap = $this->holidays->mapForRange($startDay, $endDay);
|
||||
$overrideMap = $this->overrides->mapForRange(
|
||||
$resource->getEntityType(),
|
||||
$resource->getEntityId(),
|
||||
$startDay,
|
||||
$endDay,
|
||||
);
|
||||
|
||||
$exceptions = $this->exceptions->findOverlapping(
|
||||
$resource,
|
||||
$startDay,
|
||||
$endDay + self::DAY_SECONDS,
|
||||
);
|
||||
|
||||
$days = [];
|
||||
|
||||
for ($day = $startDay; $day <= $endDay; $day = $this->nextMidnight($day, $timezone)) {
|
||||
$days[] = $this->buildDay(
|
||||
$resource,
|
||||
$day,
|
||||
$timezone,
|
||||
$shiftsByDay,
|
||||
$branchByDay,
|
||||
$holidayMap,
|
||||
$overrideMap,
|
||||
$exceptions,
|
||||
);
|
||||
}
|
||||
|
||||
return $days;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<int, list<TimeInterval>> $shiftsByDay
|
||||
* @param array<int, list<TimeInterval>>|null $branchByDay
|
||||
* @param array<int, \App\Resource\Entity\NationalHoliday> $holidayMap
|
||||
* @param array<int, \App\Resource\Entity\TenantHolidayOverride> $overrideMap
|
||||
* @param ResourceException[] $exceptions
|
||||
*/
|
||||
private function buildDay(
|
||||
ClinicResource $resource,
|
||||
int $midnight,
|
||||
\DateTimeZone $timezone,
|
||||
array $shiftsByDay,
|
||||
?array $branchByDay,
|
||||
array $holidayMap,
|
||||
array $overrideMap,
|
||||
array $exceptions,
|
||||
): DayAvailability {
|
||||
$reasons = [];
|
||||
$dayOfWeek = $this->dayOfWeek($midnight, $timezone);
|
||||
|
||||
if (!$resource->isActive()) {
|
||||
return new DayAvailability($midnight, $dayOfWeek, [], ['resource_inactive']);
|
||||
}
|
||||
|
||||
if (!$resource->getAddress()->isActive()) {
|
||||
return new DayAvailability($midnight, $dayOfWeek, [], ['branch_inactive']);
|
||||
}
|
||||
|
||||
$override = $overrideMap[$midnight] ?? null;
|
||||
$holiday = $holidayMap[$midnight] ?? null;
|
||||
|
||||
// استثنای محیط بر تقویم رسمی مقدم است — در هر دو جهت.
|
||||
$closedByHoliday = $override !== null ? !$override->isWorking() : $holiday !== null;
|
||||
|
||||
if ($closedByHoliday) {
|
||||
$reasons[] = $override !== null ? 'tenant_holiday' : 'national_holiday';
|
||||
|
||||
return new DayAvailability($midnight, $dayOfWeek, [], $reasons);
|
||||
}
|
||||
|
||||
$shifts = $shiftsByDay[$dayOfWeek] ?? [];
|
||||
|
||||
if ($shifts === []) {
|
||||
return new DayAvailability($midnight, $dayOfWeek, [], ['no_shift']);
|
||||
}
|
||||
|
||||
// شعبهٔ بدون ساعت کاری = «تعریفنشده»، نه «بسته»: شیفت منبع بیقید اعمال
|
||||
// میشود تا دادهٔ موجود دقیقاً مثل امروز کار کند (قرارداد تسک ۰۱).
|
||||
if ($branchByDay !== null) {
|
||||
$branchWindows = $branchByDay[$dayOfWeek] ?? [];
|
||||
|
||||
if ($branchWindows === []) {
|
||||
return new DayAvailability($midnight, $dayOfWeek, [], ['branch_closed']);
|
||||
}
|
||||
|
||||
$intersected = TimeInterval::intersectAll($shifts, $branchWindows);
|
||||
|
||||
// شیفت هست ولی تقاطعش با ساعت شعبه خالی شد — این با «شیفتی نیست» فرق دارد
|
||||
// و بدون دلیل صریح، پاسخِ خالی از یک باگ قابل تشخیص نیست.
|
||||
if ($intersected === []) {
|
||||
$reasons[] = 'outside_branch_hours';
|
||||
}
|
||||
|
||||
$shifts = $intersected;
|
||||
}
|
||||
|
||||
$absolute = array_map(
|
||||
static fn (TimeInterval $i): TimeInterval => $i->minutesToAbsolute($midnight),
|
||||
$shifts,
|
||||
);
|
||||
|
||||
$blocking = [];
|
||||
foreach ($exceptions as $exception) {
|
||||
if ($exception->getStartsAt() < $this->endOfDay($midnight, $timezone)
|
||||
&& $exception->getEndsAt() > $midnight
|
||||
) {
|
||||
$blocking[] = new TimeInterval($exception->getStartsAt(), $exception->getEndsAt());
|
||||
}
|
||||
}
|
||||
|
||||
if ($blocking !== []) {
|
||||
$before = $absolute;
|
||||
$absolute = TimeInterval::subtractAll($absolute, $blocking);
|
||||
|
||||
if ($absolute !== $before) {
|
||||
$reasons[] = 'exception';
|
||||
}
|
||||
}
|
||||
|
||||
return new DayAvailability($midnight, $dayOfWeek, $absolute, $reasons);
|
||||
}
|
||||
|
||||
/** @return array<int, list<TimeInterval>> روز هفته => بازههای دقیقهای */
|
||||
private function shiftsByDay(ClinicResource $resource): array
|
||||
{
|
||||
$byDay = [];
|
||||
|
||||
foreach ($this->calendars->findForResource($resource) as $shift) {
|
||||
if (!$shift->isActive()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$byDay[$shift->getDayOfWeek()][] = new TimeInterval($shift->getStartMinute(), $shift->getEndMinute());
|
||||
}
|
||||
|
||||
return array_map(TimeInterval::mergeAll(...), $byDay);
|
||||
}
|
||||
|
||||
/**
|
||||
* `null` یعنی این شعبه اصلاً ساعت کاری تعریفشده ندارد — که با «همهٔ روزها بسته»
|
||||
* فرق دارد و نباید با آن یکی گرفته شود.
|
||||
*
|
||||
* @return array<int, list<TimeInterval>>|null
|
||||
*/
|
||||
private function branchHoursByDay(ClinicResource $resource): ?array
|
||||
{
|
||||
$rows = $this->branchHours->findForAddress($resource->getAddress());
|
||||
|
||||
if ($rows === []) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$byDay = [];
|
||||
foreach ($rows as $row) {
|
||||
if (!$row->isActive()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$byDay[$row->getDayOfWeek()][] = new TimeInterval($row->getStartMinute(), $row->getEndMinute());
|
||||
}
|
||||
|
||||
return array_map(TimeInterval::mergeAll(...), $byDay);
|
||||
}
|
||||
|
||||
/** ۰=شنبه … ۶=جمعه — همان قرارداد بقیهٔ سامانه، نه `w` استاندارد PHP. */
|
||||
public function dayOfWeek(int $timestamp, \DateTimeZone $timezone): int
|
||||
{
|
||||
$date = (new \DateTimeImmutable('@' . $timestamp))->setTimezone($timezone);
|
||||
|
||||
return ((int) $date->format('w') + 1) % 7;
|
||||
}
|
||||
|
||||
public function midnight(int $timestamp, \DateTimeZone $timezone): int
|
||||
{
|
||||
return (new \DateTimeImmutable('@' . $timestamp))
|
||||
->setTimezone($timezone)
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
|
||||
/**
|
||||
* روز بعد از روی تقویم گرفته میشود نه با `+86400`: در منطقههایی که ساعت تابستانی
|
||||
* دارند، روز ۲۳ یا ۲۵ ساعته میشود و جمعِ ثابت، نیمهشب را جابهجا میکند.
|
||||
*/
|
||||
private function nextMidnight(int $midnight, \DateTimeZone $timezone): int
|
||||
{
|
||||
return (new \DateTimeImmutable('@' . $midnight))
|
||||
->setTimezone($timezone)
|
||||
->modify('+1 day')
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
|
||||
private function endOfDay(int $midnight, \DateTimeZone $timezone): int
|
||||
{
|
||||
return $this->nextMidnight($midnight, $timezone);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,235 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Service;
|
||||
|
||||
use App\Resource\Entity\ClinicResource;
|
||||
use App\Resource\Entity\ResourceCalendar;
|
||||
use App\Resource\Entity\ResourceException;
|
||||
use App\Resource\Repository\ResourceCalendarRepository;
|
||||
use App\Shared\Constant\ErrorCodes;
|
||||
use App\Shared\Exception\AppException;
|
||||
use Doctrine\ORM\EntityManagerInterface;
|
||||
|
||||
final class ResourceCalendarService
|
||||
{
|
||||
public const DAYS = [0, 1, 2, 3, 4, 5, 6];
|
||||
|
||||
public function __construct(
|
||||
private readonly ResourceCalendarRepository $calendars,
|
||||
private readonly EntityManagerInterface $em,
|
||||
) {}
|
||||
|
||||
/** @return array<int, list<array<string, mixed>>> کلیدهای ۰..۶ همیشه هر هفت روز */
|
||||
public function read(ClinicResource $resource): array
|
||||
{
|
||||
$result = array_fill_keys(self::DAYS, []);
|
||||
|
||||
foreach ($this->calendars->findForResource($resource) as $shift) {
|
||||
$result[$shift->getDayOfWeek()][] = $shift->toArray();
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
public function isDefined(ClinicResource $resource): bool
|
||||
{
|
||||
return $this->calendars->findForResource($resource) !== [];
|
||||
}
|
||||
|
||||
/**
|
||||
* جایگزینی کامل هفت روز — همان قرارداد ساعت کاری شعبه، و به همان دلیل:
|
||||
* merge تفاضلی روی هفت روز و چند بازه، دو کلاینت همزمان را ناسازگار میکند.
|
||||
*
|
||||
* @param array<int|string, mixed> $days
|
||||
* @return array<int, list<array<string, mixed>>>
|
||||
*/
|
||||
public function replace(ClinicResource $resource, array $days): array
|
||||
{
|
||||
$normalized = $this->validate($days);
|
||||
|
||||
// اعتبارسنجی کامل پیش از هر حذفی — بازهٔ نامعتبر در روز ششم نباید شش روز
|
||||
// درستِ قبلی را پاک کند و بعد ۴۲۲ برگرداند.
|
||||
$this->calendars->deleteForResource($resource);
|
||||
|
||||
foreach ($normalized as $dayOfWeek => $ranges) {
|
||||
foreach ($ranges as $sequence => $range) {
|
||||
$this->em->persist(new ResourceCalendar(
|
||||
$resource,
|
||||
$dayOfWeek,
|
||||
$range['start_minute'],
|
||||
$range['end_minute'],
|
||||
$sequence,
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
$this->em->flush();
|
||||
|
||||
return $this->read($resource);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<int|string, mixed> $days
|
||||
* @return array<int, list<array{start_minute: int, end_minute: int}>>
|
||||
*/
|
||||
private function validate(array $days): array
|
||||
{
|
||||
$normalized = array_fill_keys(self::DAYS, []);
|
||||
|
||||
foreach ($days as $rawDay => $ranges) {
|
||||
if (!is_numeric($rawDay) || !in_array((int) $rawDay, self::DAYS, true)) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
'روز هفته باید عددی بین ۰ (شنبه) و ۶ (جمعه) باشد',
|
||||
422,
|
||||
'day_of_week',
|
||||
);
|
||||
}
|
||||
|
||||
if (!is_array($ranges)) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'بازههای هر روز باید آرایه باشد', 422, 'shifts');
|
||||
}
|
||||
|
||||
$normalized[(int) $rawDay] = $this->assertRanges((int) $rawDay, $ranges);
|
||||
}
|
||||
|
||||
return $normalized;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<int|string, mixed> $ranges
|
||||
* @return list<array{start_minute: int, end_minute: int}>
|
||||
*/
|
||||
private function assertRanges(int $day, array $ranges): array
|
||||
{
|
||||
$parsed = [];
|
||||
|
||||
foreach ($ranges as $range) {
|
||||
if (!is_array($range)) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'ساختار بازه درست نیست', 422, 'start_minute');
|
||||
}
|
||||
|
||||
$start = $this->assertMinute($range['start_minute'] ?? null, $day, 'start_minute');
|
||||
$end = $this->assertMinute($range['end_minute'] ?? null, $day, 'end_minute');
|
||||
|
||||
if ($end <= $start) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
sprintf('در روز %d، پایان شیفت باید بعد از شروع آن باشد', $day),
|
||||
422,
|
||||
'end_minute',
|
||||
);
|
||||
}
|
||||
|
||||
$parsed[] = ['start_minute' => $start, 'end_minute' => $end];
|
||||
}
|
||||
|
||||
usort($parsed, static fn (array $a, array $b): int => $a['start_minute'] <=> $b['start_minute']);
|
||||
|
||||
foreach ($parsed as $i => $range) {
|
||||
if ($i > 0 && $range['start_minute'] < $parsed[$i - 1]['end_minute']) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
sprintf('شیفتهای روز %d با هم همپوشانی دارند', $day),
|
||||
422,
|
||||
'start_minute',
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
return $parsed;
|
||||
}
|
||||
|
||||
private function assertMinute(mixed $value, int $day, string $field): int
|
||||
{
|
||||
if (!is_numeric($value)) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_002,
|
||||
sprintf('در روز %d مقدار %s الزامی است', $day, $field),
|
||||
422,
|
||||
$field,
|
||||
);
|
||||
}
|
||||
|
||||
$minute = (int) $value;
|
||||
|
||||
if ($minute < 0 || $minute > ResourceCalendar::MINUTES_IN_DAY) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
sprintf('در روز %d مقدار %s باید بین ۰ و ۱۴۴۰ باشد', $day, $field),
|
||||
422,
|
||||
$field,
|
||||
);
|
||||
}
|
||||
|
||||
return $minute;
|
||||
}
|
||||
|
||||
/** @param array<string, mixed> $data */
|
||||
public function createException(ClinicResource $resource, array $data): ResourceException
|
||||
{
|
||||
$type = is_string($data['type'] ?? null) ? $data['type'] : '';
|
||||
$start = $data['starts_at'] ?? null;
|
||||
$end = $data['ends_at'] ?? null;
|
||||
|
||||
if (!array_key_exists($type, ResourceException::TYPES)) {
|
||||
throw new AppException(
|
||||
ErrorCodes::ERR_VALIDATION_001,
|
||||
'نوع استثنا باید یکی از leave/absence/maintenance/closure باشد',
|
||||
422,
|
||||
'type',
|
||||
);
|
||||
}
|
||||
|
||||
if (!is_numeric($start) || !is_numeric($end)) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_002, 'starts_at و ends_at الزامیاند', 422, 'starts_at');
|
||||
}
|
||||
|
||||
try {
|
||||
$exception = new ResourceException($resource, $type, (int) $start, (int) $end);
|
||||
} catch (\InvalidArgumentException) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'پایان استثنا باید بعد از شروع آن باشد', 422, 'ends_at');
|
||||
}
|
||||
|
||||
if (isset($data['reason']) && is_string($data['reason'])) {
|
||||
$exception->setReason(trim($data['reason']) === '' ? null : trim($data['reason']));
|
||||
}
|
||||
|
||||
$this->em->persist($exception);
|
||||
$this->em->flush();
|
||||
|
||||
return $exception;
|
||||
}
|
||||
|
||||
/** @param array<string, mixed> $data */
|
||||
public function updateException(ResourceException $exception, array $data): ResourceException
|
||||
{
|
||||
$start = $data['starts_at'] ?? $exception->getStartsAt();
|
||||
$end = $data['ends_at'] ?? $exception->getEndsAt();
|
||||
|
||||
if (!is_numeric($start) || !is_numeric($end)) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'starts_at و ends_at باید عدد باشند', 422, 'starts_at');
|
||||
}
|
||||
|
||||
try {
|
||||
$exception->reschedule((int) $start, (int) $end);
|
||||
} catch (\InvalidArgumentException) {
|
||||
throw new AppException(ErrorCodes::ERR_VALIDATION_001, 'پایان استثنا باید بعد از شروع آن باشد', 422, 'ends_at');
|
||||
}
|
||||
|
||||
if (array_key_exists('reason', $data)) {
|
||||
$reason = is_string($data['reason']) ? trim($data['reason']) : '';
|
||||
$exception->setReason($reason === '' ? null : $reason);
|
||||
}
|
||||
|
||||
$this->em->flush();
|
||||
|
||||
return $exception;
|
||||
}
|
||||
|
||||
public function deleteException(ResourceException $exception): void
|
||||
{
|
||||
$this->em->remove($exception);
|
||||
$this->em->flush();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\ValueObject;
|
||||
|
||||
/**
|
||||
* ساعت آزادِ خامِ یک منبع در یک روز.
|
||||
*
|
||||
* `reasons` وقتی روز خالی است میگوید **چرا** — بدونش، پاسخِ خالی از یک باگ قابل
|
||||
* تشخیص نیست و اولین کسی که دیباگ میکند باید چهار جدول را دستی بخواند.
|
||||
*/
|
||||
final readonly class DayAvailability
|
||||
{
|
||||
/**
|
||||
* @param list<TimeInterval> $intervals بازههای آزاد، بهصورت timestamp مطلق
|
||||
* @param list<string> $reasons `national_holiday`، `tenant_holiday`، `no_shift`،
|
||||
* `branch_closed`، `outside_branch_hours`، `exception`،
|
||||
* `resource_inactive`، `branch_inactive`
|
||||
*/
|
||||
public function __construct(
|
||||
public int $date,
|
||||
public int $dayOfWeek,
|
||||
public array $intervals,
|
||||
public array $reasons = [],
|
||||
) {}
|
||||
|
||||
public function isEmpty(): bool
|
||||
{
|
||||
return $this->intervals === [];
|
||||
}
|
||||
|
||||
public function totalMinutes(): int
|
||||
{
|
||||
$total = 0;
|
||||
|
||||
foreach ($this->intervals as $interval) {
|
||||
$total += intdiv($interval->end - $interval->start, 60);
|
||||
}
|
||||
|
||||
return $total;
|
||||
}
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return [
|
||||
'date' => $this->date,
|
||||
'day_of_week' => $this->dayOfWeek,
|
||||
'intervals' => array_map(
|
||||
static fn (TimeInterval $i): array => $i->toArray(),
|
||||
$this->intervals,
|
||||
),
|
||||
'total_minutes' => $this->totalMinutes(),
|
||||
'reasons' => $this->reasons,
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,131 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\ValueObject;
|
||||
|
||||
/**
|
||||
* یک بازهٔ نیمباز `[start, end)`.
|
||||
*
|
||||
* واحدش عمداً تعیین نشده: در تقویم هفتگی «دقیقه از نیمهشب» است و بعد از
|
||||
* `shiftedBy()` میشود timestamp مطلق. جبرِ زیر در هر دو حالت یکسان کار میکند، و
|
||||
* همین باعث میشود تقاطع ساعت شعبه با شیفت منبع و کسر مرخصی، یک کد باشند نه دو تا.
|
||||
*/
|
||||
final readonly class TimeInterval
|
||||
{
|
||||
public function __construct(
|
||||
public int $start,
|
||||
public int $end,
|
||||
) {
|
||||
if ($end <= $start) {
|
||||
throw new \InvalidArgumentException(sprintf('Interval end (%d) must be after start (%d).', $end, $start));
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* بازه را از «دقیقه از نیمهشب» به timestamp مطلق میبرد.
|
||||
*
|
||||
* نامش عمداً `shiftedBy` نیست: جمع ساده، دقیقه را با ثانیه قاطی میکرد و بازهٔ
|
||||
* هشتساعته را هشت **ثانیه** میساخت — دقیقاً همان باگی که
|
||||
* ResourceAvailabilityTest اولین بار گرفت.
|
||||
*/
|
||||
public function minutesToAbsolute(int $midnight): self
|
||||
{
|
||||
return new self($midnight + $this->start * 60, $midnight + $this->end * 60);
|
||||
}
|
||||
|
||||
public function toArray(): array
|
||||
{
|
||||
return ['start' => $this->start, 'end' => $this->end];
|
||||
}
|
||||
|
||||
/**
|
||||
* بازههای همپوشان یا چسبیده را یکی میکند. خروجی مرتب است.
|
||||
*
|
||||
* @param list<self> $intervals
|
||||
* @return list<self>
|
||||
*/
|
||||
public static function mergeAll(array $intervals): array
|
||||
{
|
||||
if ($intervals === []) {
|
||||
return [];
|
||||
}
|
||||
|
||||
usort($intervals, static fn (self $a, self $b): int => $a->start <=> $b->start);
|
||||
|
||||
$merged = [array_shift($intervals)];
|
||||
|
||||
foreach ($intervals as $next) {
|
||||
$last = $merged[count($merged) - 1];
|
||||
|
||||
if ($next->start <= $last->end) {
|
||||
// چسبیده هم ادغام میشود: [9,13) و [13,17) یعنی [9,17)، نه دو بازه.
|
||||
$merged[count($merged) - 1] = new self($last->start, max($last->end, $next->end));
|
||||
continue;
|
||||
}
|
||||
|
||||
$merged[] = $next;
|
||||
}
|
||||
|
||||
return $merged;
|
||||
}
|
||||
|
||||
/**
|
||||
* تقاطع دو مجموعه بازه.
|
||||
*
|
||||
* @param list<self> $left
|
||||
* @param list<self> $right
|
||||
* @return list<self>
|
||||
*/
|
||||
public static function intersectAll(array $left, array $right): array
|
||||
{
|
||||
$out = [];
|
||||
|
||||
foreach (self::mergeAll($left) as $a) {
|
||||
foreach (self::mergeAll($right) as $b) {
|
||||
$start = max($a->start, $b->start);
|
||||
$end = min($a->end, $b->end);
|
||||
|
||||
if ($end > $start) {
|
||||
$out[] = new self($start, $end);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return self::mergeAll($out);
|
||||
}
|
||||
|
||||
/**
|
||||
* `$from` منهای `$blocks`. بازهٔ نیمروزه فقط همان تکه را میبُرد و بقیهٔ روز
|
||||
* سرِ جایش میماند.
|
||||
*
|
||||
* @param list<self> $from
|
||||
* @param list<self> $blocks
|
||||
* @return list<self>
|
||||
*/
|
||||
public static function subtractAll(array $from, array $blocks): array
|
||||
{
|
||||
$result = self::mergeAll($from);
|
||||
|
||||
foreach (self::mergeAll($blocks) as $block) {
|
||||
$next = [];
|
||||
|
||||
foreach ($result as $interval) {
|
||||
if ($block->end <= $interval->start || $block->start >= $interval->end) {
|
||||
$next[] = $interval; // بیتداخل
|
||||
continue;
|
||||
}
|
||||
|
||||
if ($block->start > $interval->start) {
|
||||
$next[] = new self($interval->start, $block->start);
|
||||
}
|
||||
|
||||
if ($block->end < $interval->end) {
|
||||
$next[] = new self($block->end, $interval->end);
|
||||
}
|
||||
}
|
||||
|
||||
$result = $next;
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
@@ -38,6 +38,7 @@ final class GlobalTables
|
||||
\App\Sms\Entity\SmsLog::class => 'لاگ ارسال؛ فقط شماره و قالب دارد، مالک ندارد',
|
||||
\App\Shared\Logging\AppLog::class => 'لاگ سراسری برنامه',
|
||||
\App\Blog\Entity\Blog::class => 'محتوای عمومی مارکتپلیس',
|
||||
\App\Resource\Entity\NationalHoliday::class => 'تعطیلات رسمی کشور؛ per محیط کردنش معنای «کشوری» را از بین میبرد — محیطی که خلافش کار میکند TenantHolidayOverride میزند',
|
||||
|
||||
// هویت — یک شخص میتواند در چند محیط حضور داشته باشد
|
||||
\App\Auth\Entity\User::class => 'هویت سراسری؛ رابطهٔ بیمار با محیط از patient_records میآید',
|
||||
@@ -93,6 +94,7 @@ final class GlobalTables
|
||||
// تسک ۰۱)، پس ارثبری اینجا واقعی است. هیچکدام uuid از request نمیگیرند:
|
||||
// تنها راهشان PUT روی /resource/{uuid}/skills و /resource-pool/{uuid}/members است.
|
||||
\App\Resource\Entity\ResourceSkill::class => \App\Resource\Entity\ClinicResource::class,
|
||||
\App\Resource\Entity\ResourceCalendar::class => \App\Resource\Entity\ClinicResource::class,
|
||||
\App\Resource\Entity\ResourcePoolMember::class => \App\Resource\Entity\ResourcePool::class,
|
||||
|
||||
\App\Patient\Entity\SessionAuditLog::class => \App\Patient\Entity\PatientSession::class,
|
||||
|
||||
@@ -0,0 +1,77 @@
|
||||
<?php
|
||||
|
||||
namespace App\Tests\Representation;
|
||||
|
||||
use App\Representation\Service\JalaliDateService;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
/**
|
||||
* تبدیل شمسی ↔ میلادی.
|
||||
*
|
||||
* پیادهسازی دستیِ قبلی غلط بود و کسی متوجه نشده بود چون هیچ تستی نداشت:
|
||||
* `gregorianToJalali(2026, 7, 30)` مقدار `[3006, 7, 3]` میداد. این تست همان
|
||||
* نقطههایی را قفل میکند که آن باگ را لو دادند.
|
||||
*/
|
||||
class JalaliDateServiceTest extends TestCase
|
||||
{
|
||||
private JalaliDateService $service;
|
||||
|
||||
protected function setUp(): void
|
||||
{
|
||||
$this->service = new JalaliDateService();
|
||||
}
|
||||
|
||||
/** نوروز لنگرِ همهچیز است: ۱ فروردین ۱۴۰۵ = ۲۱ مارس ۲۰۲۶. */
|
||||
public function testNowruzAnchor(): void
|
||||
{
|
||||
self::assertSame([2026, 3, 21], $this->service->jalaliToGregorian(1405, 1, 1));
|
||||
self::assertSame([1405, 1, 1], $this->service->gregorianToJalali(2026, 3, 21));
|
||||
}
|
||||
|
||||
public function testRoundTripAcrossTheYear(): void
|
||||
{
|
||||
foreach ([[1405, 1, 1], [1405, 5, 8], [1405, 6, 31], [1405, 7, 1], [1405, 12, 29]] as [$jy, $jm, $jd]) {
|
||||
[$gy, $gm, $gd] = $this->service->jalaliToGregorian($jy, $jm, $jd);
|
||||
|
||||
self::assertSame(
|
||||
[$jy, $jm, $jd],
|
||||
$this->service->gregorianToJalali($gy, $gm, $gd),
|
||||
sprintf('رفتوبرگشت %d/%d/%d', $jy, $jm, $jd),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/** مهر اول نیمسال دوم است و ماههایش ۳۰ روزه — مرز ۶/۳۱ به ۷/۱. */
|
||||
public function testSixthMonthHasThirtyOneDaysAndSeventhStartsNextDay(): void
|
||||
{
|
||||
[$gy, $gm, $gd] = $this->service->jalaliToGregorian(1405, 6, 31);
|
||||
$end = (new \DateTimeImmutable(sprintf('%04d-%02d-%02d', $gy, $gm, $gd)))->modify('+1 day');
|
||||
|
||||
self::assertSame(
|
||||
[1405, 7, 1],
|
||||
$this->service->gregorianToJalali(
|
||||
(int) $end->format('Y'),
|
||||
(int) $end->format('n'),
|
||||
(int) $end->format('j'),
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
public function testJalaliYearOfAKnownTimestamp(): void
|
||||
{
|
||||
$timestamp = (new \DateTimeImmutable('2026-07-30 12:00:00', new \DateTimeZone('Asia/Tehran')))->getTimestamp();
|
||||
|
||||
self::assertSame(1405, $this->service->jalaliYear($timestamp));
|
||||
self::assertSame(5, $this->service->jalaliMonth($timestamp));
|
||||
}
|
||||
|
||||
/** بازهٔ سال باید نوروز تا آخر اسفند باشد، نه چیزی در قرن سیویکم. */
|
||||
public function testYearRangeStartsAtNowruz(): void
|
||||
{
|
||||
[$start, $end] = $this->service->jalaliYearRange(1405);
|
||||
|
||||
self::assertSame('2026-03-21', date('Y-m-d', $start));
|
||||
self::assertGreaterThan($start, $end);
|
||||
self::assertSame(1405, $this->service->jalaliYear($start));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,333 @@
|
||||
<?php
|
||||
|
||||
namespace App\Tests\Resource;
|
||||
|
||||
use App\Auth\Entity\User;
|
||||
use App\Doctor\Entity\DoctorAddress;
|
||||
use App\Resource\Entity\ResourceException;
|
||||
use App\Resource\Service\HolidayService;
|
||||
|
||||
/**
|
||||
* کسرِ لایهها: ساعت شعبه ∩ شیفت منبع − تعطیلات − استثناها.
|
||||
*
|
||||
* زمانها نسبت به «شنبهٔ آیندهٔ» محاسبهشده ساخته میشوند نه یک تاریخ ثابت: تاریخ
|
||||
* ثابت با گذشت زمان معنایش عوض میشود و تست را به مرور دروغگو میکند.
|
||||
*/
|
||||
class ResourceAvailabilityTest extends ResourceTestCase
|
||||
{
|
||||
private const TEHRAN = 'Asia/Tehran';
|
||||
|
||||
/** نیمهشبِ شنبهٔ بعدی به وقت تهران. */
|
||||
private function nextSaturday(): int
|
||||
{
|
||||
return (new \DateTimeImmutable('next saturday', new \DateTimeZone(self::TEHRAN)))
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
|
||||
/**
|
||||
* شنبهای دور، مخصوصِ تستهای تعطیلات رسمی.
|
||||
*
|
||||
* `national_holidays` عمداً سراسری است و `db_test` هرگز ریست نمیشود، پس ردیفی که
|
||||
* اینجا ساخته شود روی **همهٔ** تستهای دیگری که همان روز را میسنجند اثر میگذارد.
|
||||
* فاصله گرفتن از پنجرهٔ یکهفتهایِ بقیه + پاک کردن در tearDown، هر دو لازماند.
|
||||
*/
|
||||
private function farSaturday(): int
|
||||
{
|
||||
return $this->dayAfter($this->nextSaturday(), 210);
|
||||
}
|
||||
|
||||
protected function tearDown(): void
|
||||
{
|
||||
// ردیف سراسری را همان تستی که ساخته پاک میکند؛ وگرنه بدهیاش را تست بعدی میدهد.
|
||||
$this->em->createQuery('DELETE FROM App\Resource\Entity\NationalHoliday h')->execute();
|
||||
|
||||
// بدون clear()، همان ردیفِ حذفشده در identity map میماند و `findByDate()` تستِ
|
||||
// بعدی آن را برمیگرداند؛ آنوقت upsert فکر میکند رکورد هست و چیزی نمینویسد.
|
||||
// این تستها تنها وقتی جدا اجرا میشدند سبز بودند — دقیقاً نشانهٔ همین.
|
||||
$this->em->clear();
|
||||
|
||||
parent::tearDown();
|
||||
}
|
||||
|
||||
private function dayAfter(int $midnight, int $days): int
|
||||
{
|
||||
return (new \DateTimeImmutable('@' . $midnight))
|
||||
->setTimezone(new \DateTimeZone(self::TEHRAN))
|
||||
->modify("+$days day")
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
|
||||
/** @return array{0: User, 1: DoctorAddress, 2: string} کاربر، شعبه، uuid منبع */
|
||||
private function resourceWithShifts(array $days = [0, 1, 2, 3, 4]): array
|
||||
{
|
||||
[$user, , $address] = $this->clinicWithAddress();
|
||||
$type = $this->resourceType($address, 'operator', 'اپراتور');
|
||||
$created = $this->createResource($user, $address, $type, ['name' => 'اپراتور مریم']);
|
||||
$uuid = $created['data']['uuid'];
|
||||
|
||||
$shifts = [];
|
||||
foreach ($days as $day) {
|
||||
$shifts[$day] = [['start_minute' => 540, 'end_minute' => 1020]]; // 09:00-17:00
|
||||
}
|
||||
|
||||
$this->authJson('PUT', "/api/v1/resource/$uuid/calendar", $user, ['days' => $shifts]);
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
return [$user, $address, $uuid];
|
||||
}
|
||||
|
||||
private function availability(User $user, string $uuid, int $from, int $to): array
|
||||
{
|
||||
$body = $this->authJson('GET', "/api/v1/resource/$uuid/availability?from=$from&to=$to", $user);
|
||||
self::assertSame(200, $this->responseCode(), json_encode($body, JSON_UNESCAPED_UNICODE));
|
||||
|
||||
return $body['data']['days'];
|
||||
}
|
||||
|
||||
public function testFiveWorkingDaysAndAnEmptyFriday(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $this->dayAfter($saturday, 6));
|
||||
|
||||
self::assertCount(7, $days);
|
||||
|
||||
$withHours = array_values(array_filter($days, static fn (array $d): bool => $d['intervals'] !== []));
|
||||
self::assertCount(5, $withHours, 'شنبه تا چهارشنبه');
|
||||
|
||||
// ۶ = جمعه در قرارداد ۰=شنبه
|
||||
$friday = $days[6];
|
||||
self::assertSame(6, $friday['day_of_week']);
|
||||
self::assertSame([], $friday['intervals']);
|
||||
self::assertContains('no_shift', $friday['reasons']);
|
||||
|
||||
self::assertSame(480, $days[0]['total_minutes'], '۹ تا ۱۷ یعنی ۴۸۰ دقیقه');
|
||||
}
|
||||
|
||||
public function testAnExceptionEmptiesThatDay(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$tuesday = $this->dayAfter($saturday, 3);
|
||||
|
||||
$this->authJson('POST', "/api/v1/resource/$uuid/exception", $user, [
|
||||
'type' => ResourceException::TYPE_LEAVE,
|
||||
'starts_at' => $tuesday,
|
||||
'ends_at' => $this->dayAfter($tuesday, 1),
|
||||
'reason' => 'مرخصی استحقاقی',
|
||||
]);
|
||||
self::assertSame(201, $this->responseCode());
|
||||
|
||||
$days = $this->availability($user, $uuid, $saturday, $this->dayAfter($saturday, 6));
|
||||
|
||||
self::assertSame([], $days[3]['intervals']);
|
||||
self::assertContains('exception', $days[3]['reasons']);
|
||||
self::assertNotSame([], $days[2]['intervals'], 'روزهای دیگر دستنخوردهاند');
|
||||
}
|
||||
|
||||
/** استثنای نیمروزه فقط همان تکه را میبُرد، نه کل روز. */
|
||||
public function testHalfDayExceptionCutsOnlyItsOwnWindow(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$monday = $this->dayAfter($saturday, 2);
|
||||
|
||||
$this->authJson('POST', "/api/v1/resource/$uuid/exception", $user, [
|
||||
'type' => ResourceException::TYPE_MAINTENANCE,
|
||||
'starts_at' => $monday + 14 * 3600,
|
||||
'ends_at' => $monday + 18 * 3600,
|
||||
]);
|
||||
self::assertSame(201, $this->responseCode());
|
||||
|
||||
$days = $this->availability($user, $uuid, $monday, $monday);
|
||||
|
||||
self::assertCount(1, $days[0]['intervals']);
|
||||
self::assertSame($monday + 9 * 3600, $days[0]['intervals'][0]['start']);
|
||||
self::assertSame($monday + 14 * 3600, $days[0]['intervals'][0]['end']);
|
||||
self::assertSame(300, $days[0]['total_minutes'], '۹ تا ۱۴ یعنی ۳۰۰ دقیقه');
|
||||
}
|
||||
|
||||
/** دو استثنای همپوشان مجازند و اتحاد گرفته میشود، نه خطا. */
|
||||
public function testOverlappingExceptionsAreUnioned(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
|
||||
foreach ([[10, 13], [12, 16]] as [$startHour, $endHour]) {
|
||||
$this->authJson('POST', "/api/v1/resource/$uuid/exception", $user, [
|
||||
'type' => ResourceException::TYPE_ABSENCE,
|
||||
'starts_at' => $saturday + $startHour * 3600,
|
||||
'ends_at' => $saturday + $endHour * 3600,
|
||||
]);
|
||||
self::assertSame(201, $this->responseCode());
|
||||
}
|
||||
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
// ۹-۱۰ و ۱۶-۱۷ باقی میماند؛ ۱۰ تا ۱۶ یکجا بریده میشود.
|
||||
self::assertCount(2, $days[0]['intervals']);
|
||||
self::assertSame(120, $days[0]['total_minutes']);
|
||||
}
|
||||
|
||||
/** تعطیل رسمی بدون هیچ ثبت دستی، روز را برای همهٔ محیطها میبندد. */
|
||||
public function testNationalHolidayClosesTheDayForEveryone(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->farSaturday();
|
||||
$holidays = static::getContainer()->get(HolidayService::class);
|
||||
|
||||
$jalali = static::getContainer()->get(\App\Representation\Service\JalaliDateService::class);
|
||||
[$jy, $jm, $jd] = $jalali->toJalali(
|
||||
(new \DateTimeImmutable('@' . $saturday))->setTimezone(new \DateTimeZone(self::TEHRAN)),
|
||||
);
|
||||
|
||||
$holidays->upsertNational($jy, $jm, $jd, 'تعطیل آزمایشی');
|
||||
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertSame([], $days[0]['intervals']);
|
||||
self::assertContains('national_holiday', $days[0]['reasons']);
|
||||
}
|
||||
|
||||
/** محیطی که آن روز کار میکند با override باز میشود — فقط منابع همان محیط. */
|
||||
public function testTenantOverrideReopensANationalHoliday(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
[$otherUser, , $otherUuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->farSaturday();
|
||||
$holidays = static::getContainer()->get(HolidayService::class);
|
||||
$jalali = static::getContainer()->get(\App\Representation\Service\JalaliDateService::class);
|
||||
|
||||
[$jy, $jm, $jd] = $jalali->toJalali(
|
||||
(new \DateTimeImmutable('@' . $saturday))->setTimezone(new \DateTimeZone(self::TEHRAN)),
|
||||
);
|
||||
$holidays->upsertNational($jy, $jm, $jd, 'تعطیل آزمایشی');
|
||||
|
||||
$this->authJson('POST', '/api/v1/holiday-overrides', $user, [
|
||||
'date' => $saturday,
|
||||
'is_working' => true,
|
||||
'note' => 'کلینیک ما این روز باز است',
|
||||
]);
|
||||
self::assertSame(201, $this->responseCode());
|
||||
|
||||
$mine = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
self::assertNotSame([], $mine[0]['intervals'], 'محیطِ دارای override باز میشود');
|
||||
|
||||
$theirs = $this->availability($otherUser, $otherUuid, $saturday, $saturday);
|
||||
self::assertSame([], $theirs[0]['intervals'], 'محیط دیگر همچنان بسته است');
|
||||
}
|
||||
|
||||
/** جهت دوم: روزی که رسمی نیست ولی این محیط تعطیل است. */
|
||||
public function testTenantOverrideCanCloseANormalDay(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
|
||||
$this->authJson('POST', '/api/v1/holiday-overrides', $user, [
|
||||
'date' => $saturday,
|
||||
'is_working' => false,
|
||||
]);
|
||||
self::assertSame(201, $this->responseCode());
|
||||
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertSame([], $days[0]['intervals']);
|
||||
self::assertContains('tenant_holiday', $days[0]['reasons']);
|
||||
}
|
||||
|
||||
/** شیفت بیرون از ساعت شعبه رد نمیشود — تقاطع گرفته میشود. */
|
||||
public function testShiftIsIntersectedWithBranchHours(): void
|
||||
{
|
||||
[$user, $address, $uuid] = $this->resourceWithShifts([0]);
|
||||
|
||||
// شعبه فقط ۱۰ تا ۱۲ باز است؛ شیفت منبع ۹ تا ۱۷.
|
||||
$this->authJson('PUT', "/api/v1/branch/{$address->getUuid()}/working-hours", $user, [
|
||||
'days' => [0 => [['start_minute' => 600, 'end_minute' => 720]]],
|
||||
]);
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertCount(1, $days[0]['intervals']);
|
||||
self::assertSame(120, $days[0]['total_minutes'], 'تقاطع ۱۰ تا ۱۲');
|
||||
}
|
||||
|
||||
/** تقاطع خالی → روز خالی، با دلیل صریح تا از یک باگ قابل تشخیص باشد. */
|
||||
public function testEmptyIntersectionReportsOutsideBranchHours(): void
|
||||
{
|
||||
[$user, $address, $uuid] = $this->resourceWithShifts([0]);
|
||||
|
||||
$this->authJson('PUT', "/api/v1/branch/{$address->getUuid()}/working-hours", $user, [
|
||||
'days' => [0 => [['start_minute' => 1080, 'end_minute' => 1200]]], // 18:00-20:00
|
||||
]);
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertSame([], $days[0]['intervals']);
|
||||
self::assertContains('outside_branch_hours', $days[0]['reasons']);
|
||||
}
|
||||
|
||||
/** شعبهٔ بدون ساعت کاری = «تعریفنشده»، پس شیفت منبع بیقید اعمال میشود. */
|
||||
public function testBranchWithoutHoursDoesNotConstrainTheShift(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts([0]);
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertSame(480, $days[0]['total_minutes']);
|
||||
}
|
||||
|
||||
/** روزی که شعبه بسته است با «تعریفنشده» یکی نیست. */
|
||||
public function testBranchClosedDayIsDistinctFromUndefined(): void
|
||||
{
|
||||
[$user, $address, $uuid] = $this->resourceWithShifts([0, 1]);
|
||||
|
||||
$this->authJson('PUT', "/api/v1/branch/{$address->getUuid()}/working-hours", $user, [
|
||||
'days' => [0 => [['start_minute' => 540, 'end_minute' => 1020]]],
|
||||
]);
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $this->dayAfter($saturday, 1));
|
||||
|
||||
self::assertNotSame([], $days[0]['intervals']);
|
||||
self::assertSame([], $days[1]['intervals']);
|
||||
self::assertContains('branch_closed', $days[1]['reasons']);
|
||||
}
|
||||
|
||||
public function testInactiveResourceHasNoAvailability(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$this->authJson('PATCH', "/api/v1/resource/$uuid", $user, ['active' => false]);
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$days = $this->availability($user, $uuid, $saturday, $saturday);
|
||||
|
||||
self::assertSame([], $days[0]['intervals']);
|
||||
self::assertContains('resource_inactive', $days[0]['reasons']);
|
||||
}
|
||||
|
||||
public function testRangeLongerThanTheCapIsRejected(): void
|
||||
{
|
||||
[$user, , $uuid] = $this->resourceWithShifts();
|
||||
|
||||
$saturday = $this->nextSaturday();
|
||||
$tooFar = $this->dayAfter($saturday, 200);
|
||||
|
||||
$this->authJson('GET', "/api/v1/resource/$uuid/availability?from=$saturday&to=$tooFar", $user);
|
||||
|
||||
self::assertSame(422, $this->responseCode());
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user