feat: add optional inventory package association to service items and implement audit logging

- Added `inventory_package_uuid` and `inventory_package_title` fields to the `ServiceItem` interface.
- Updated API documentation to reflect new fields in service item responses.
- Implemented methods in `ClinicServiceController` to handle inventory package associations.
- Created `ServiceItemAuditLog` entity and repository for tracking changes to service items.
- Added functionality to log changes to service items, including inventory package associations.
- Implemented tests for attaching/detaching inventory packages and auditing changes.
- Created database migrations for new fields and audit log table.

src/ClinicService/Entity/ServiceItem.php

@@ -62,6 +62,14 @@ class ServiceItem
     #[ORM\Column(type: 'boolean', options: ['default' => false])]
     private bool $bookable = false;
 
+    /**
+     * پکیج کالای مصرفی این خدمت ({@see \App\Inventory\Entity\InventoryPackage}).
+     * ارجاع خام int بدون FK — همان الگوی Tariff و TenantServiceCoverage — تا دامنهٔ
+     * ClinicService به Inventory وابسته نشود.
+     */
+    #[ORM\Column(name: 'inventory_package_id', type: 'integer', nullable: true)]
+    private ?int $inventoryPackageId = null;
+
     #[ORM\Column(name: 'created_at', type: 'integer')]
     private int $createdAt;
 
@@ -90,6 +98,7 @@ class ServiceItem
     public function getInsurancePriceRials(): ?int { return $this->insurancePriceRials; }
     public function getDurationMinutes(): ?int { return $this->durationMinutes; }
     public function isBookable(): bool         { return $this->bookable; }
+    public function getInventoryPackageId(): ?int { return $this->inventoryPackageId; }
     public function getCreatedAt(): int        { return $this->createdAt; }
     public function getUpdatedAt(): int        { return $this->updatedAt; }
 
@@ -128,6 +137,7 @@ class ServiceItem
     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 setInventoryPackageId(?int $v): self { $this->inventoryPackageId = $v; $this->updatedAt = time(); return $this; }
 
     public function toArray(): array
     {
@@ -159,6 +169,7 @@ class ServiceItem
             'insurance_price_rials' => $this->insurancePriceRials,
             'duration_minutes'      => $this->durationMinutes,
             'bookable'              => $this->bookable,
+            'inventory_package_id'  => $this->inventoryPackageId,
             'created_at'   => $this->createdAt,
             'updated_at'   => $this->updatedAt,
         ];