feat: add service-based booking mode to appointment scheduling

- Introduced a new booking mode in WeeklySchedule to support service-based appointments.
- Updated SlotCalculatorService to calculate available start times based on selected service durations and buffer times.
- Enhanced AppointmentController to handle service items during booking, calculating slot_end on the server side.
- Implemented validation to ensure at least one bookable service exists for doctors in service mode.
- Added new API endpoint to retrieve available appointment slots based on selected services.
- Updated MyAppointmentsController to accept service items during appointment creation.
- Modified ServiceItem entity to include a bookable flag, allowing services to be marked for scheduling.
- Created migration to add bookable column to service_items table.
- Added tests for service-based slot calculations and validation logic.

src/ClinicService/Entity/ServiceItem.php

@@ -58,6 +58,10 @@ class ServiceItem
     #[ORM\Column(name: 'duration_minutes', type: 'integer', nullable: true)]
     private ?int $durationMinutes = null;
 
+    /** نمایش این سرویس در نوبت‌دهی (پزشک ممکن است همهٔ سرویس‌ها را ارائه ندهد). */
+    #[ORM\Column(type: 'boolean', options: ['default' => false])]
+    private bool $bookable = false;
+
     #[ORM\Column(name: 'created_at', type: 'integer')]
     private int $createdAt;
 
@@ -85,6 +89,7 @@ class ServiceItem
     public function isInsuranceCovered(): bool  { return $this->insuranceCovered; }
     public function getInsurancePriceRials(): ?int { return $this->insurancePriceRials; }
     public function getDurationMinutes(): ?int { return $this->durationMinutes; }
+    public function isBookable(): bool         { return $this->bookable; }
     public function getCreatedAt(): int        { return $this->createdAt; }
     public function getUpdatedAt(): int        { return $this->updatedAt; }
 
@@ -122,6 +127,7 @@ class ServiceItem
     public function setInsuranceCovered(bool $v): self    { $this->insuranceCovered = $v; $this->updatedAt = time(); return $this; }
     public function setInsurancePriceRials(?int $v): self { $this->insurancePriceRials = $v; $this->updatedAt = time(); return $this; }
     public function setDurationMinutes(?int $v): self { $this->durationMinutes = $v; $this->updatedAt = time(); return $this; }
+    public function setBookable(bool $v): self { $this->bookable = $v; $this->updatedAt = time(); return $this; }
 
     public function toArray(): array
     {
@@ -151,6 +157,7 @@ class ServiceItem
             'insurance_covered'     => $this->insuranceCovered,
             'insurance_price_rials' => $this->insurancePriceRials,
             'duration_minutes'      => $this->durationMinutes,
+            'bookable'              => $this->bookable,
             'created_at'   => $this->createdAt,
             'updated_at'   => $this->updatedAt,
         ];