[self::STATUS_CONFIRMED, self::STATUS_FOLLOWING_UP, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_EXPIRED], self::STATUS_CONFIRMED => [self::STATUS_COMPLETED, self::STATUS_FOLLOWING_UP, self::STATUS_SALON, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_NO_SHOW], self::STATUS_FOLLOWING_UP => [self::STATUS_CONFIRMED, self::STATUS_SALON, self::STATUS_COMPLETED, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_NO_SHOW], self::STATUS_SALON => [self::STATUS_COMPLETED, self::STATUS_FOLLOWING_UP, self::STATUS_CANCELLED_BY_DOCTOR, self::STATUS_CANCELLED_BY_USER, self::STATUS_NO_SHOW], ]; /** * Statuses in which an appointment occupies its (doctor, slot_start) — kept * in lockstep with AppointmentRepository::isSlotTaken (a slot is taken only * by a confirmed booking or a still-live pending one). While occupying, the * row carries a non-null, unique active_slot_key so two live bookings on the * same slot cannot coexist even under a race. Every other status (expired, * completed, no_show, cancelled_*) releases the slot → key NULL. */ private const SLOT_OCCUPYING_STATUSES = [ self::STATUS_PENDING, self::STATUS_CONFIRMED, ]; // Optimistic locking #[ORM\Version] #[ORM\Column(type: 'integer')] private int $version = 1; #[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: Doctor::class)] #[ORM\JoinColumn(name: 'doctor_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')] private Doctor $doctor; #[ORM\ManyToOne(targetEntity: User::class)] #[ORM\JoinColumn(name: 'user_id', referencedColumnName: 'id', nullable: false, onDelete: 'RESTRICT')] private User $user; #[ORM\Column(name: 'slot_start', type: 'integer')] private int $slotStart; #[ORM\Column(name: 'slot_end', type: 'integer')] private int $slotEnd; #[ORM\Column(type: 'string', length: 30)] private string $status = self::STATUS_PENDING; #[ORM\Column(name: 'active_slot_key', type: 'string', length: 64, nullable: true, unique: true)] private ?string $activeSlotKey = null; #[ORM\Column(type: 'string', length: 255, nullable: true)] private ?string $note = null; #[ORM\Column(name: 'expires_at', type: 'integer', nullable: true)] private ?int $expiresAt = null; #[ORM\Column(name: 'patient_name', type: 'string', length: 150, nullable: true)] private ?string $patientName = null; #[ORM\Column(name: 'patient_mobile', type: 'string', length: 20, nullable: true)] private ?string $patientMobile = null; #[ORM\Column(name: 'patient_national_code', type: 'string', length: 20, nullable: true)] private ?string $patientNationalCode = null; #[ORM\Column(name: 'patient_gender', type: 'string', length: 10, nullable: true)] private ?string $patientGender = null; #[ORM\Column(name: 'patient_reason', type: 'text', nullable: true)] private ?string $patientReason = null; #[ORM\Column(name: 'address_id', type: 'integer', nullable: true)] private ?int $addressId = null; #[ORM\Column(name: 'booking_representation_id', type: 'integer', nullable: true)] private ?int $bookingRepresentationId = null; // ── Clinic-workflow fields (Figma نوبت‌ها) ──────────────────────────────── /** بخش — clinic service section this appointment belongs to. */ #[ORM\ManyToOne(targetEntity: \App\ClinicService\Entity\ServiceSection::class)] #[ORM\JoinColumn(name: 'service_section_id', nullable: true, onDelete: 'SET NULL')] private ?\App\ClinicService\Entity\ServiceSection $serviceSection = null; /** سرویس — concrete service item to perform. */ #[ORM\ManyToOne(targetEntity: \App\ClinicService\Entity\ServiceItem::class)] #[ORM\JoinColumn(name: 'service_item_id', nullable: true, onDelete: 'SET NULL')] private ?\App\ClinicService\Entity\ServiceItem $serviceItem = null; /** پرسنل — staff member assigned to the appointment. */ #[ORM\ManyToOne(targetEntity: \App\Staff\Entity\ClinicStaff::class)] #[ORM\JoinColumn(name: 'staff_id', nullable: true, onDelete: 'SET NULL')] private ?\App\Staff\Entity\ClinicStaff $staff = null; /** بیعانه مورد نیاز است. */ #[ORM\Column(name: 'deposit_required', type: 'boolean', options: ['default' => false])] private bool $depositRequired = false; #[ORM\Column(name: 'deposit_amount_rials', type: 'integer', nullable: true)] private ?int $depositAmountRials = null; /** * Reserve-list entry (نوبت رزرو): booked for a day, not a time slot. * slotStart/slotEnd hold that day's midnight so date queries keep working. */ #[ORM\Column(name: 'is_reserve', type: 'boolean', options: ['default' => false])] private bool $isReserve = false; #[ORM\Column(name: 'created_at', type: 'integer')] private int $createdAt; #[ORM\Column(name: 'updated_at', type: 'integer')] private int $updatedAt; public function __construct(Doctor $doctor, User $user, int $slotStart, int $slotEnd) { $this->uuid = Uuid::v4()->toRfc4122(); $this->doctor = $doctor; $this->user = $user; $this->slotStart = $slotStart; $this->slotEnd = $slotEnd; $this->createdAt = time(); $this->updatedAt = time(); $this->refreshActiveSlotKey(); } /** * Recompute the unique active-slot key from the current status. Non-null * while the appointment occupies the slot; null once it is cancelled. */ private function refreshActiveSlotKey(): void { // Reserve-list entries are day-level wishes, not slot bookings — they // never occupy a slot, so several reserves may share the same day. $this->activeSlotKey = !$this->isReserve && in_array($this->status, self::SLOT_OCCUPYING_STATUSES, true) ? sprintf('%d:%d', $this->doctor->getId(), $this->slotStart) : null; } public function getId(): ?int { return $this->id; } public function getUuid(): string { return $this->uuid; } public function getDoctor(): Doctor { return $this->doctor; } public function getUser(): User { return $this->user; } public function getSlotStart(): int { return $this->slotStart; } public function getSlotEnd(): int { return $this->slotEnd; } public function getStatus(): string { return $this->status; } public function getNote(): ?string { return $this->note; } public function getVersion(): int { return $this->version; } public function getExpiresAt(): ?int { return $this->expiresAt; } public function getPatientName(): ?string { return $this->patientName; } public function getPatientMobile(): ?string { return $this->patientMobile; } public function getPatientNationalCode(): ?string { return $this->patientNationalCode; } public function getPatientGender(): ?string { return $this->patientGender; } public function getPatientReason(): ?string { return $this->patientReason; } public function getAddressId(): ?int { return $this->addressId; } public function getBookingRepresentationId(): ?int { return $this->bookingRepresentationId; } public function setNote(?string $v): self { $this->note = $v; return $this; } public function setBookingRepresentationId(?int $v): self { $this->bookingRepresentationId = $v; return $this; } public function setAddressId(?int $v): self { $this->addressId = $v; return $this; } public function setPatientName(?string $v): self { $this->patientName = $v; return $this; } public function setPatientMobile(?string $v): self { $this->patientMobile = $v; return $this; } public function setPatientNationalCode(?string $v): self { $this->patientNationalCode = $v; return $this; } public function setPatientGender(?string $v): self { $this->patientGender = $v; return $this; } public function setPatientReason(?string $v): self { $this->patientReason = $v; return $this; } public function getServiceSection(): ?\App\ClinicService\Entity\ServiceSection { return $this->serviceSection; } public function getServiceItem(): ?\App\ClinicService\Entity\ServiceItem { return $this->serviceItem; } public function getStaff(): ?\App\Staff\Entity\ClinicStaff { return $this->staff; } public function isDepositRequired(): bool { return $this->depositRequired; } public function getDepositAmountRials(): ?int { return $this->depositAmountRials; } public function isReserve(): bool { return $this->isReserve; } public function setServiceSection(?\App\ClinicService\Entity\ServiceSection $v): self { $this->serviceSection = $v; return $this; } public function setServiceItem(?\App\ClinicService\Entity\ServiceItem $v): self { $this->serviceItem = $v; return $this; } public function setStaff(?\App\Staff\Entity\ClinicStaff $v): self { $this->staff = $v; return $this; } public function setDepositRequired(bool $v): self { $this->depositRequired = $v; return $this; } public function setDepositAmountRials(?int $v): self { $this->depositAmountRials = $v; return $this; } /** * Move the appointment to a new slot (جا به جایی نوبت) and/or flip its * reserve flag (انتقال به لیست رزرو و بالعکس). Goes through here — not raw * setters — so active_slot_key stays consistent with the new slot. */ public function rescheduleTo(int $slotStart, int $slotEnd, ?bool $isReserve = null): self { $this->slotStart = $slotStart; $this->slotEnd = $slotEnd; if ($isReserve !== null) { $this->isReserve = $isReserve; } $this->updatedAt = time(); $this->refreshActiveSlotKey(); return $this; } public function markPendingWithTtl(int $ttl): self { $this->expiresAt = time() + $ttl; $this->updatedAt = time(); return $this; } /** آیا پنجرهٔ ۱۵ دقیقه‌ایِ پرداخت گذشته یا زمان اسلات رد شده است؟ */ public function isPaymentWindowExpired(int $now): bool { if ($this->expiresAt !== null && $now > $this->expiresAt) { return true; } return $now >= $this->slotStart; } public function canTransitionTo(string $newStatus): bool { return in_array($newStatus, self::ALLOWED_TRANSITIONS[$this->status] ?? [], true); } public function transitionTo(string $newStatus): self { if (!$this->canTransitionTo($newStatus)) { throw new \LogicException(sprintf( 'Cannot transition appointment from "%s" to "%s"', $this->status, $newStatus )); } $this->status = $newStatus; $this->updatedAt = time(); if ($newStatus !== self::STATUS_PENDING) { $this->expiresAt = null; } $this->refreshActiveSlotKey(); return $this; } public function toArray(): array { $firstAddress = $this->doctor->getAddresses()->first() ?: null; return [ 'uuid' => $this->uuid, 'doctor' => [ 'uuid' => $this->doctor->getUuid(), 'name' => $this->doctor->getName(), 'specialties' => array_map( fn($s) => ['uuid' => $s->getUuid(), 'name' => $s->getName()], $this->doctor->getSpecialties()->toArray() ), ], 'address' => $firstAddress?->toArray(), 'address_id' => $this->addressId, 'user' => [ 'uuid' => $this->user->getUuid(), 'mobile' => $this->user->getMobileNumber(), ], 'slot_start' => $this->slotStart, 'slot_end' => $this->slotEnd, 'status' => $this->status, 'note' => $this->note, 'expires_at' => $this->expiresAt, 'patient_name' => $this->patientName, 'patient_mobile' => $this->patientMobile, 'patient_national_code' => $this->patientNationalCode, 'patient_gender' => $this->patientGender, 'patient_reason' => $this->patientReason, 'service_section' => $this->serviceSection ? ['uuid' => $this->serviceSection->getUuid(), 'name' => $this->serviceSection->getName()] : null, 'service_item' => $this->serviceItem ? ['uuid' => $this->serviceItem->getUuid(), 'name' => $this->serviceItem->getName()] : null, 'staff' => $this->staff ? ['uuid' => $this->staff->getUuid(), 'full_name' => $this->staff->getFullName()] : null, 'deposit_required' => $this->depositRequired, 'deposit_amount_rials' => $this->depositAmountRials, 'is_reserve' => $this->isReserve, 'version' => $this->version, 'created_at' => $this->createdAt, 'updated_at' => $this->updatedAt, ]; } }