feat(subscription): implement resource quota management based on subscription plans

assets/admin/hooks/useResources.ts

@@ -1,6 +1,7 @@
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { toast } from 'sonner';
 import { api, ApiError, type ApiResponse } from '../lib/api';
+import { useSubscription } from './useSubscription';
 import type {
   ClinicResource, ResourcePool, ResourcePayload, ResourceServiceOffering, ResourceType, Skill,
 } from '../types';
@@ -99,6 +100,36 @@ export function useResources(filters: ResourceFilters = {}) {
   };
 }
 
+/**
+ * سهمیهٔ منابع محیط — سقفش از پلن اشتراک می‌آید و مصرفش از فهرست منابع.
+ *
+ * فهرست عمداً بی‌فیلتر خوانده می‌شود: سهمیه به کل محیط مربوط است و شمردنِ ردیف‌های
+ * فیلترشدهٔ صفحه، با هر فیلتر یک عدد متفاوت می‌داد. کوئری با کلیدِ `[resources, {}]`
+ * همان کوئریِ حالتِ بی‌فیلترِ صفحه است، پس معمولاً رفت‌وبرگشت اضافه‌ای نمی‌سازد.
+ *
+ * تصمیم نهایی با سرور است؛ این فقط دکمه را پیش از رفتن به فرم می‌بندد.
+ */
+export function useResourceQuota() {
+  const { maxResources, planLoaded } = useSubscription();
+
+  const { data } = useQuery({
+    queryKey: [RESOURCES_KEY, {}],
+    queryFn: () => api.get<ApiResponse<ClinicResource[]>>('/api/v1/resources'),
+  });
+
+  const used = data?.data?.length ?? 0;
+  // سقفِ ناشناخته (نقش بی‌اشتراک، یا پاسخِ هنوز نرسیده) گیت نمی‌شود؛ سرور خودش
+  // ۴۲۲ می‌دهد و بستنِ دکمه بر اساس حدس، بدتر از بستنش دیرتر است.
+  const unlimited = !planLoaded || maxResources < 0;
+
+  return {
+    used,
+    limit: maxResources,
+    unlimited,
+    atLimit: !unlimited && used >= maxResources,
+  };
+}
+
 /**
  * سرویس‌هایی که یک منبع ارائه می‌دهد.
  *