feat(profile): enforce uniqueness of national_code across user profiles and update related error handling

docs/api/patient.md

@@ -86,6 +86,7 @@ Creates a patient record for a user under the current entity. If the record alre
 - اگر `user_uuid` و `mobile` هر دو خالی باشند → خطا.
 - `national_code` فقط وقتی روی کاربر ست می‌شود که کاربر کد ملی نداشته باشد.
 - موبایل تکراری duplicate نمی‌سازد؛ همان کاربر استفاده می‌شود.
+- **یکتایی کد ملی:** اگر `national_code` ارسالی قبلاً به پروفایل کاربر دیگری تعلق داشته باشد → `409` با کد `ERR_PROFILE_001` (`field: national_code`). یک کد ملی = یک بیمار در کل سیستم (هم‌راستا با قید یکتای `profiles.national_code`).
 
 **Response 201:**
 
@@ -109,6 +110,7 @@ Creates a patient record for a user under the current entity. If the record alre
 | Code | HTTP | Description |
 |------|------|-------------|
 | `ERR_VALIDATION_001` | 422 | `user_uuid`/`mobile` خالی، یا موبایل/کد ملی نامعتبر، یا نام برای بیمار جدید خالی |
+| `ERR_PROFILE_001` | 409 | کد ملی قبلاً برای پروفایل کاربر دیگری ثبت شده (`field: national_code`) |
 | `ERR_SUBSCRIPTION_REQUIRED` | 403 | No `patient_records` feature |
 
 ---

docs/api/user-profile.md

@@ -82,6 +82,8 @@ Create a medical profile for the authenticated user.
 | Code | HTTP | Description |
 |------|------|-------------|
 | `ERR_AUTH_001` | 401 | Missing token |
+| `ERR_VALIDATION_001` | 422 | `national_code` نامعتبر (رقم کنترلی/طول غلط) (`field: national_code`) |
+| `ERR_PROFILE_001` | 409 | کد ملی قبلاً برای پروفایل کاربر دیگری ثبت شده (`field: national_code`) |
 | `ERR_CONFLICT_001` | 409 | Profile already exists for this user |
 
 ---
@@ -126,6 +128,8 @@ Update a user profile.
 Same fields as POST — all optional.
 
 > **`national_code` server-side validation:** اگر `national_code` ارسال شود و **غیرخالی** باشد، با الگوریتم رقم کنترلیِ کد ملی ایران اعتبارسنجی می‌شود (ارقام فارسی/عربی به انگلیسی نرمال و به‌صورت لاتین ذخیره می‌شوند). مقدارِ نامعتبر با `422` رد می‌شود. ارسال `null` یا رشته‌ی خالی مجاز است (کد ملی اختیاری) و فیلد را پاک می‌کند.
+>
+> **یکتایی کد ملی:** کد ملی در کل سیستم یکتاست (یک کد ملی = یک بیمار). اگر کد ملی ارسالی قبلاً به پروفایل **کاربر دیگری** تعلق داشته باشد، با `409` و کد `ERR_PROFILE_001` رد می‌شود (`field: national_code`). در سطح دیتابیس هم با `UNIQUE INDEX uniq_profiles_national_code` تضمین شده (مقادیر `NULL` آزادند). همین قید روی مسیر ساخت بیمار توسط منشی (`POST /api/v1/patient`) نیز اعمال می‌شود.
 
 ### Response `200`
 Updated profile object.
@@ -135,6 +139,7 @@ Updated profile object.
 |------|------|-------------|
 | `ERR_AUTH_001` | 401 | Missing token |
 | `ERR_VALIDATION_001` | 422 | `national_code` نامعتبر (رقم کنترلی/طول غلط) (`field: national_code`) |
+| `ERR_PROFILE_001` | 409 | کد ملی قبلاً برای پروفایل کاربر دیگری ثبت شده (`field: national_code`) |
 | `ERR_FORBIDDEN_001` | 403 | Not the profile owner |
 | `ERR_NOT_FOUND_001` | 404 | Profile not found |