feat: add staff role functionality with dashboard access and service management

- Implemented SidebarStaff component tests to ensure staff users see only their dashboard and services.
- Created StaffMyServicesPage to display assigned services for staff users.
- Added migration to link clinic staff rows to user accounts for ROLE_STAFF access.
- Defined StaffPermissions class for static permissions related to staff role.
- Introduced StaffRouteGuardSubscriber to restrict API access for staff users.
- Developed StaffAccountService for managing staff user accounts and linking them to clinic staff.
- Added comprehensive tests for StaffAccountService to validate user creation, mobile number handling, and account attachment.
- Implemented tests for staff dashboard access to ensure proper permissions and access control.
- Created tests for staff login context to verify correct environment visibility based on user roles.

src/Staff/Entity/ClinicStaff.php

@@ -2,6 +2,7 @@
 
 namespace App\Staff\Entity;
 
+use App\Auth\Entity\User;
 use App\Staff\Repository\ClinicStaffRepository;
 use Doctrine\ORM\Mapping as ORM;
 use Symfony\Component\Uid\Uuid;
@@ -9,6 +10,7 @@ use Symfony\Component\Uid\Uuid;
 #[ORM\Entity(repositoryClass: ClinicStaffRepository::class)]
 #[ORM\Table(name: 'clinic_staff')]
 #[ORM\Index(columns: ['entity_type', 'entity_id', 'active'], name: 'idx_staff_entity_active')]
+#[ORM\Index(columns: ['user_id', 'active'], name: 'idx_staff_user_active')]
 class ClinicStaff
 {
     #[ORM\Id]
@@ -43,6 +45,15 @@ class ClinicStaff
     #[ORM\Column(type: 'boolean')]
     private bool $active = true;
 
+    /**
+     * حساب کاربری پرسنل برای ورود به پنل. nullable است چون پرسنل می‌تواند صرفاً یک
+     * رکورد اطلاعاتی باشد؛ قطع دسترسی هم با null کردن همین ستون انجام می‌شود تا
+     * ارجاعات سرویس/نوبت به این ردیف دست‌نخورده بماند.
+     */
+    #[ORM\ManyToOne(targetEntity: User::class)]
+    #[ORM\JoinColumn(name: 'user_id', nullable: true, onDelete: 'SET NULL')]
+    private ?User $user = null;
+
     #[ORM\Column(name: 'created_at', type: 'integer')]
     private int $createdAt;
 
@@ -69,6 +80,8 @@ class ClinicStaff
     public function getAddress(): ?string  { return $this->address; }
     public function getNationalCode(): ?string { return $this->nationalCode; }
     public function isActive(): bool       { return $this->active; }
+    public function getUser(): ?User       { return $this->user; }
+    public function hasAccount(): bool     { return $this->user !== null; }
     public function getCreatedAt(): int    { return $this->createdAt; }
     public function getUpdatedAt(): int    { return $this->updatedAt; }
 
@@ -78,6 +91,7 @@ class ClinicStaff
     public function setAddress(?string $address): self     { $this->address = $address; $this->updatedAt = time(); return $this; }
     public function setNationalCode(?string $code): self   { $this->nationalCode = $code; $this->updatedAt = time(); return $this; }
     public function setActive(bool $active): self          { $this->active = $active; $this->updatedAt = time(); return $this; }
+    public function setUser(?User $user): self             { $this->user = $user; $this->updatedAt = time(); return $this; }
 
     public function toggleActive(): self
     {
@@ -98,6 +112,8 @@ class ClinicStaff
             'address'       => $this->address,
             'national_code' => $this->nationalCode,
             'active'        => $this->active,
+            'has_account'   => $this->user !== null,
+            'user_uuid'     => $this->user?->getUuid(),
             'created_at'    => $this->createdAt,
             'updated_at'    => $this->updatedAt,
         ];