feat(subscription): return plan features for users without subscription permission

2026-08-04 12:54:12 +03:30
parent 85a27812c7
commit 4653cd0e4a
3 changed files with 68 additions and 9 deletions
@@ -81,6 +81,29 @@

 اگر اشتراک فعالی نداشت `subscription` برابر `null` است، اما `effective_plan` همیشه مقدار دارد: پلن اشتراک فعال، یا در نبود اشتراک، **پلن پیش‌فرض `free`**. فرانت‌اند برای تعیین دسترسی به امکانات (`hasFeature`) باید از `effective_plan` استفاده کند (نه `subscription`) تا کاربرانِ بدون اشتراک هم امکانات پلن free را داشته باشند. `subscription`/`hasPlan` صرفاً برای نمایش وضعیت اشتراک پولی است.

+### پاسخ کاهش‌یافته برای کاربرِ بدون مجوزِ `subscription.view` (2026-08)
+
+پیش از این، منشیِ بدون این مجوز `403` می‌گرفت. نتیجه‌اش یک **قفلِ دروغین در پنل** بود:
+سایدبار هر آیتم feature-دار (پروندهٔ بیماران، بیمه) را با `hasFeature()` گیت می‌کند و
+بدون این پاسخ، `features` خالی می‌ماند و آیتم قفل و به صفحهٔ اشتراک هدایت می‌شد — حتی
+وقتی خودِ API آن قابلیت را به همان منشی می‌داد.
+
+حالا پاسخ `200` است ولی فقط توانمندی‌های پلن را دارد:
+
+```json
+{"success":true,"data":{
+  "subscription": null,
+  "used_trial": false,
+  "effective_plan": { "features": { "patient_records": true, "…": true }, "max_secretaries": 1 }
+}}
+```
+
+- `subscription`، `used_trial` و فیلدهای هویتی/سطحِ پلن (`name`, `level`, `uuid`, `active`,
+  `periods`) در این حالت **نمی‌آیند**.
+- افشای تازه‌ای نیست: `GET /subscription/plans` عمومی است و همین `features` را (به‌همراه
+  قیمت‌ها) برای همهٔ پلن‌ها می‌دهد.
+- سایر نقش‌ها و منشیِ دارای `subscription.view` همان پاسخ کامل بالا را می‌گیرند.
+
 ---

 ## POST /api/v1/subscription/trial