feat: implement specialty hierarchy handling in doctor and representation APIs, add backfill command and tests

docs/api/admin.md

@@ -297,7 +297,7 @@ Delete a user.
 | `name` | string | ✅ | نام پزشک |
 | `gender` / `degree` / `medical_system_code` / `info` | string | ❌ | اطلاعات حرفه‌ای |
 | `activity_time` | integer | ❌ | Unix timestamp (ثانیه) تاریخ شروع فعالیت؛ مبنای محاسبهٔ سال تجربه |
-| `specialties` | integer[] | ❌ | آرایهٔ IDهای تخصص |
+| `specialties` | integer[] | ❌ | آرایهٔ IDهای تخصص. هر شناسهٔ فرزند سمت سرور با تمام والدهایش تا ریشهٔ درخت گسترش می‌یابد؛ شناسه‌های ناموجود نادیده گرفته می‌شوند. |
 
 #### Errors
 | Code | HTTP | Description |

docs/api/doctor-import.md

@@ -76,6 +76,10 @@
 
 > `gender`/`degree` باید با ثابت‌های `Doctor::GENDERS` / `Doctor::DEGREES` سازگار باشند.
 > `specialties`/`states`/`cities` اگر داده شوند مجموعهٔ فعلی را **جایگزین** می‌کنند.
+> تخصص‌ها درختی‌اند: هر شناسهٔ فرزند پیش از ذخیره با تمام والدهایش تا ریشه گسترش می‌یابد
+> (ارسال `[3]` «گوارش و کبد» → ذخیرهٔ `[2, 3]` یعنی «داخلی» + «گوارش و کبد»)، پس فرستادن
+> فقط برگ کافی است. شناسه‌های ناموجود نادیده گرفته می‌شوند.
+> برای دادهٔ ایمپورت‌شدهٔ قبل از این تغییر: `php bin/console app:doctors:backfill-specialty-parents`.
 
 ---
 

docs/api/doctor.md

@@ -41,7 +41,7 @@ Create a doctor profile for the authenticated user.
 | `medical_system_code` | string | ❌ | Nظام پزشکی code |
 | `degree` | string | ❌ | Academic degree |
 | `info` | string | ❌ | Bio/description |
-| `specialties` | integer[] | ❌ | Array of specialty IDs |
+| `specialties` | integer[] | ❌ | Array of specialty IDs. تخصص‌ها درختی‌اند: هر شناسهٔ فرزند سمت سرور با تمام والدهایش تا ریشه گسترش می‌یابد، پس پاسخ ممکن است تخصص‌های بیشتری از ورودی داشته باشد (مثلاً ارسال «گوارش و کبد» → ذخیرهٔ «داخلی» + «گوارش و کبد»). شناسه‌های ناموجود نادیده گرفته می‌شوند. |
 | `doctor_services` | integer[] | ❌ | Array of doctor service IDs |
 | `activity_time` | integer | ❌ | Unix timestamp (ثانیه) تاریخ شروع فعالیت؛ مبنای محاسبهٔ `experience` (سال تجربه) در پاسخ |
 

docs/api/representation.md

@@ -388,7 +388,7 @@ Get yearly earnings dashboard for a representation.
 | `name` | string | ✅ |
 | `gender` / `degree` / `medical_system_code` / `info` | string | ❌ |
 | `activity_time` | integer (Unix ts، تاریخ شروع فعالیت) | ❌ |
-| `specialties` | integer[] | ❌ |
+| `specialties` | integer[] | ❌ — هر شناسهٔ فرزند با تمام والدهایش تا ریشهٔ درخت گسترش می‌یابد |
 
 #### Response `201`
 ```json