feat: implement server-side validation for mobile numbers and national codes across multiple endpoints

docs/api/admin.md

@@ -284,6 +284,47 @@ Delete a user.
 
 > **نماینده (ROLE_REPRESENTATION):** افزودن پزشک و کلینیک برای نماینده از طریق endpointهای جدا انجام می‌شود — `POST /api/v1/representation/doctor` و `POST /api/v1/representation/clinic` (به `docs/api/representation.md` مراجعه کنید). در نسخه‌ی نماینده، `representation_id` پزشک خودکار روی نماینده‌ی کاربر جاری ست می‌شود. endpointهای `/api/v1/admin/*` همچنان فقط `ROLE_ADMIN` هستند.
 
+### POST `/api/v1/admin/doctors`
+
+ساخت پزشک جدید (در صورت نبودِ کاربر با این موبایل، یک User هم ساخته می‌شود).
+
+**Permission:** `ROLE_ADMIN`
+
+#### Request Body (`application/json`)
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `mobile` | string | ✅ | موبایل ورود؛ باید فرمت معتبر موبایل ایران داشته باشد (`^09\d{9}$`) — ارقام فارسی/عربی به انگلیسی نرمال می‌شوند |
+| `name` | string | ✅ | نام پزشک |
+
+#### Errors
+| Code | HTTP | Description |
+|------|------|-------------|
+| `VALIDATION` | 422 | `mobile` یا `name` خالی |
+| `VALIDATION` | 422 | `mobile` فرمت معتبر موبایل ایران ندارد (`field: mobile`) |
+
+---
+
+### POST `/api/v1/admin/clinic`
+
+ساخت کلینیک جدید (در صورت نبودِ کاربرِ صاحب با این موبایل، یک User هم ساخته می‌شود).
+
+**Permission:** `ROLE_ADMIN`
+
+#### Request Body (`application/json`)
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `owner_mobile` | string | ✅ | موبایل صاحب کلینیک؛ باید فرمت معتبر موبایل ایران داشته باشد (`^09\d{9}$`) |
+| `name` | string | ✅ | نام کلینیک |
+
+#### Errors
+| Code | HTTP | Description |
+|------|------|-------------|
+| `VALIDATION` | 422 | `owner_mobile` خالی |
+| `VALIDATION` | 422 | `owner_mobile` فرمت معتبر موبایل ایران ندارد (`field: owner_mobile`) |
+| `VALIDATION` | 422 | `name` کلینیک خالی |
+
+---
+
 ### GET `/api/v1/admin/doctors`
 
 List all doctors with pagination.

docs/api/representation.md

@@ -59,7 +59,8 @@ Create a new representation.
 | `ERR_AUTH_001` | 401 | Missing token |
 | `ERR_AUTH_006` | 403 | Not admin |
 | `ERR_CONFLICT_001` | 409 | Mobile number already in use |
-| `ERR_VALIDATION_001` | 422 | Invalid input |
+| `ERR_VALIDATION_001` | 422 | `mobile_number` فرمت معتبر موبایل ایران (`^09\d{9}$`) ندارد (`field: mobile_number`) |
+| `ERR_VALIDATION_002` | 422 | `mobile_number` یا `full_name` خالی |
 
 ---
 
@@ -288,6 +289,7 @@ Get yearly earnings dashboard for a representation.
 | Code | HTTP | Description |
 |------|------|-------------|
 | `ERR_VALIDATION_002` | 422 | موبایل یا نام خالی |
+| `ERR_VALIDATION_001` | 422 | `mobile` فرمت معتبر موبایل ایران ندارد (`field: mobile`) |
 | `ERR_CONFLICT_001` | 409 | این کاربر قبلاً پزشک است |
 
 ---
@@ -314,6 +316,7 @@ Get yearly earnings dashboard for a representation.
 | Code | HTTP | Description |
 |------|------|-------------|
 | `ERR_VALIDATION_002` | 422 | موبایل یا نام خالی |
+| `ERR_VALIDATION_001` | 422 | `owner_mobile` فرمت معتبر موبایل ایران ندارد (`field: owner_mobile`) |
 
 ---
 

docs/api/user-profile.md

@@ -125,6 +125,8 @@ Update a user profile.
 ### Request Body
 Same fields as POST — all optional.
 
+> **`national_code` server-side validation:** اگر `national_code` ارسال شود و **غیرخالی** باشد، با الگوریتم رقم کنترلیِ کد ملی ایران اعتبارسنجی می‌شود (ارقام فارسی/عربی به انگلیسی نرمال و به‌صورت لاتین ذخیره می‌شوند). مقدارِ نامعتبر با `422` رد می‌شود. ارسال `null` یا رشته‌ی خالی مجاز است (کد ملی اختیاری) و فیلد را پاک می‌کند.
+
 ### Response `200`
 Updated profile object.
 
@@ -132,6 +134,7 @@ Updated profile object.
 | Code | HTTP | Description |
 |------|------|-------------|
 | `ERR_AUTH_001` | 401 | Missing token |
+| `ERR_VALIDATION_001` | 422 | `national_code` نامعتبر (رقم کنترلی/طول غلط) (`field: national_code`) |
 | `ERR_FORBIDDEN_001` | 403 | Not the profile owner |
 | `ERR_NOT_FOUND_001` | 404 | Profile not found |