feat: update user roles and passwords in QA driver, enhance documentation with error codes, and improve trial activation error handling

2026-07-19 15:19:03 +03:30
parent 3e841b5e57
commit 7761c37a3e
10 changed files with 326 additions and 109 deletions
@@ -80,6 +80,11 @@

 همه‌ی سرویس‌های owner در همه‌ی بخش‌ها (برای انتخاب/جستجوی سراسری در فرم ثبت/ویرایش مراجعه). پاسخ مثل لیست هر بخش (آرایه‌ی `ServiceItem::toArray`)، مرتب بر نام.

+**Errors:**
+| Code | HTTP | توضیح |
+|------|------|-------|
+| ERR_FORBIDDEN_001 | 403 | کاربر نه پروفایل پزشک دارد نه کلینیک، پس محیط کاری قابل‌تعیین نیست (ادمین، منشی، نماینده، کاربر عادی) |
+
 ## GET /api/v1/service-items/{sectionUuid}

 لیست سرویس‌های یک بخش.
@@ -95,8 +95,9 @@
 | Code | HTTP | توضیح |
 |------|------|-------|
 | ERR_TRIAL_ALREADY_USED | 422 | قبلاً از تریال استفاده شده |
-| ERR_TRIAL_DISABLED | 422 | تریال غیرفعال است (SiteConfig: trial_enabled=0) |
+| ERR_TRIAL_DISABLED | 422 | تریال غیرفعال است — یا `SiteConfig: trial_enabled=0`، یا پلن `basic` هیچ دورهٔ تریالِ `active` ندارد |
 | ERR_FORBIDDEN_001 | 403 | پروفایل doctor/clinic یافت نشد |
+| ERR_NOT_FOUND_001 | 500 | پلن `basic` وجود ندارد یا غیرفعال است (نصب ناقص) |

 ---