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

docs/api/subscription.md

@@ -8,7 +8,9 @@
 
 لیست پنل‌ها با دوره‌های فعال (عمومی — بدون auth).
 
-> پلن `free`: همه امکانات (`patient_records`, `services`, `sms_panel`, `insurance`) فعال‌اند؛ تنها محدودیت آن تعداد منشی (`max_secretaries`) است.
+> پلن `free`: همه امکانات (`patient_records`, `services`, `sms_panel`, `insurance`) فعال‌اند؛ محدودیت‌هایش عددی‌اند — تعداد منشی (`max_secretaries`) و تعداد منبع (`max_resources`).
+
+> `max_resources` سقف منابع محیط است. مقدار `-1` یعنی نامحدود. مقادیر شیپ‌شده: `free` = ۱، `basic` = ۳، `professional` = `-1`. اجرای این سقف در `POST /api/v1/resource` است — [resource.md](resource.md).
 
 **Response 200:**
 ```json
@@ -20,6 +22,7 @@
       "name": "free",
       "level": 0,
       "max_secretaries": 1,
+      "max_resources": 1,
       "features": { "patient_records": true, "services": true, "sms_panel": true, "insurance": true },
       "active": true,
       "periods": []
@@ -29,6 +32,7 @@
       "name": "basic",
       "level": 1,
       "max_secretaries": 3,
+      "max_resources": 3,
       "features": { "patient_records": true, "services": true, "sms_panel": false },
       "active": true,
       "periods": [
@@ -65,7 +69,7 @@
   "data": {
     "subscription": {
       "uuid": "...",
-      "plan": { "name": "basic", "level": 1, "max_secretaries": 3, "features": {...} },
+      "plan": { "name": "basic", "level": 1, "max_secretaries": 3, "max_resources": 3, "features": {...} },
       "period": { "label": "یک ماهه", "duration_months": 1, "price_rials": 290000 },
       "is_trial": false,
       "starts_at": 1718000000,
@@ -74,7 +78,7 @@
       "is_active": true
     },
     "used_trial": false,
-    "effective_plan": { "name": "basic", "level": 1, "max_secretaries": 3, "features": {...} }
+    "effective_plan": { "name": "basic", "level": 1, "max_secretaries": 3, "max_resources": 3, "features": {...} }
   }
 }
 ```
@@ -94,7 +98,7 @@
 {"success":true,"data":{
   "subscription": null,
   "used_trial": false,
-  "effective_plan": { "features": { "patient_records": true, "…": true }, "max_secretaries": 1 }
+  "effective_plan": { "features": { "patient_records": true, "…": true }, "max_secretaries": 1, "max_resources": 1 }
 }}
 ```
 
@@ -180,10 +184,13 @@ callback درگاه پرداخت — پس از پرداخت موفق، `ClinicSu
   "name": "enterprise",
   "level": 3,
   "max_secretaries": 20,
+  "max_resources": -1,
   "features": { "patient_records": true, "services": true, "sms_panel": true }
 }
 ```
 
+`max_resources` اختیاری است و پیش‌فرضش `1` — پلنِ ناشناخته نباید بی‌صدا نامحدود شود. مقدار `-1` یعنی نامحدود. در `PATCH` هم همین فیلد پذیرفته می‌شود.
+
 **خطاها:**
 
 | کد | HTTP | شرح |