fix(tenant): check the environment wherever a uuid comes from the request

Phase 7 was scoped to guard aggregate children, which the Doctrine filter cannot
reach. Measuring first — as the plan required — moved the target: all 22 children
and their 20 repositories were already sound. Every list query anchors on its
root, and ServiceItemRepository even joins service_sections and filters on the
pair by hand. A repository-level guard would have found nothing.

The real exposure was one layer up. Where a uuid arrives from a request body or
query string, the entity it names is loaded by uuid alone, and the filter is no
help: aggregate children have no tenant column, and a panel user who never chose
an environment is not filtered at all. Three leaks, each proven by removing the
fix and watching the new tests go red:

- GET /api/v1/appointment-service-slots accepted service_item_uuids from any
  environment. Existence, bookable state and duration leaked through the error
  messages and the returned slots. The booking path in the same controller had
  guarded this since it was written; the slot path never did.
- POST /api/v1/my/appointment attached service_section_uuid, service_item_uuid,
  staff_uuid and the service list without any check, and persisted them onto the
  appointment. A write, not just a read.
- PatientService did the same in all three of its loops — pricing, session
  create, session update — so another environment's service price entered the
  invoice and its SessionService row was stored, staff included.

TenantOwnershipChecker is the single place that answers "does this belong to the
current environment?". It reads getEntityType()/getEntityId(), so ServiceItem now
delegates that pair to its section: an aggregate child exposing the tenant it
inherits. An entity that exposes no pair throws rather than returning false —
silence here builds an always-closed guard, which is its own bug.

TenantLookupInventoryTest keeps a per-file count of these lookups. It earned its
place immediately: the first run found more sites than the manual grep had, and
reviewing them turned up the third PatientService loop. StaffController looked
unguarded until read properly — ownsStaff sits two lines below the null check.

One assertion was wrong before it was right: the create-path test read
`$session['services'] ?? []`, which passes vacuously. It now counts the stored
rows through the repository, and fails without the fix.

Tests: 879 passing. PHPStan unchanged at its 17 pre-existing errors.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

src/Shared/Tenant/TenantOwnershipChecker.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Shared\Tenant;
+
+use App\Shared\Context\EntityContext;
+
+/**
+ * «آیا این موجودیت مالِ همین محیط است؟»
+ *
+ * برای جاهایی لازم است که یک uuid از خودِ درخواست می‌آید و موجودیت متناظرش را
+ * TenantFilter پوشش نمی‌دهد — یا چون فرزند aggregate است (ServiceItem) یا چون
+ * کاربر هنوز محیطی انتخاب نکرده و فیلتر خاموش است.
+ *
+ * موجودیت باید جفت محیطش را با getEntityType()/getEntityId() بدهد. فرزندان
+ * aggregate می‌توانند این دو را به ریشه delegate کنند، همان‌طور که ServiceItem
+ * به ServiceSection می‌دهد.
+ */
+final class TenantOwnershipChecker
+{
+    /** null یعنی موجودیتی پیدا نشد — همان‌قدر «مالِ این محیط نیست» که یک موجودیت بیگانه. */
+    public function belongsTo(EntityContext $context, ?object $entity): bool
+    {
+        if (!$context->isResolved()) {
+            return false;
+        }
+
+        [$type, $id] = $context->toEntityPair();
+
+        return $this->belongsToPair($type, $id, $entity);
+    }
+
+    /**
+     * برای فراخوانی‌هایی که جفت را از قبل به‌صورت اسکالر دارند و موجودیت محیط را در
+     * دست ندارند. ساختن EntityContext از اسکالر عمداً ممکن نیست: چنین contextی
+     * isClinic() درست می‌دهد ولی ->clinic تهی دارد و مصرف‌کننده را بی‌صدا می‌شکند.
+     */
+    public function belongsToPair(string $entityType, int $entityId, ?object $entity): bool
+    {
+        if ($entity === null) {
+            return false;
+        }
+
+        if (!method_exists($entity, 'getEntityType') || !method_exists($entity, 'getEntityId')) {
+            throw new \InvalidArgumentException(sprintf(
+                '%s does not expose a tenant pair; add getEntityType()/getEntityId() or delegate them to its aggregate root.',
+                $entity::class,
+            ));
+        }
+
+        return $entity->getEntityType() === $entityType && $entity->getEntityId() === $entityId;
+    }
+
+    /**
+     * یک بیگانه در فهرست، کل فهرست را رد می‌کند.
+     *
+     * @param iterable<object|null> $entities
+     */
+    public function allBelongTo(EntityContext $context, iterable $entities): bool
+    {
+        foreach ($entities as $entity) {
+            if (!$this->belongsTo($context, $entity)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+}