fix(doctor): strip «دکتر» prefix on IRIMC import + name-fix & purge commands

Root cause of "دکتر دکتر …" (and ellipsis-truncated "…نی") in admin: IRIMC
names already contain the «دکتر» title, while the panel renders «دکتر {name}».
Convention is to store the bare name.

- DoctorImportService: normalize name via PersianText::stripDoctorTitle
  (also fixes ي/ی, ك/ک, half-space)
- PersianText::stripDoctorTitle now strips consecutive «دکتر دکتر …» prefixes
- app:doctors:fix-irimc-names: one-off backfill for existing source='irimc'
  rows (dry-run supported) — fixed 340 rows
- app:doctors:purge: FK-safe full wipe of doctors + all dependent tables +
  orphan surrogate users, for a clean test DB (dry-run default, --force to
  apply, prod-guarded)
- tests: PersianTextTest cases for the title stripping; DoctorImportTest
  asserts stored name has no «دکتر» prefix
- docs/api/doctor-import.md: name convention + the two new commands

Verified: import "دکتر صفورا حجازی نیا" → stored "صفورا حجازی نیا" → panel
shows single «دکتر صفورا حجازی نیا».

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
2026-07-11 14:07:18 +03:30
co-authored by Claude Opus 4.8
parent 0b49b03a1e
commit 51432c7bb9
21 changed files with 2460 additions and 1333 deletions
+5 -2
View File
@@ -15,7 +15,7 @@ class DoctorImportTest extends ApiTestCase
private function importPayload(string $code): array
{
return [
'name' => 'دکتر تست ایمپورت',
'name' => 'دکتر صفورا حجازی نیا',
'medical_system_code' => $code,
'source_ref' => 'https://membersearch.irimc.org/member/profile?id=test',
'gender' => 'man',
@@ -46,6 +46,8 @@ class DoctorImportTest extends ApiTestCase
$this->assertSame('unclaimed', $doctor->getOwnerStatus());
$this->assertSame('irimc', $doctor->getSource());
$this->assertFalse($doctor->isActiveDoctorAppointment());
// نام بدون پیشوند «دکتر» ذخیره می‌شود (UI خودش «دکتر» را جلو می‌گذارد)
$this->assertSame('صفورا حجازی نیا', $doctor->getName());
$surrogate = $doctor->getUser();
$this->assertStringStartsWith('imp_', $surrogate->getMobileNumber());
@@ -74,7 +76,8 @@ class DoctorImportTest extends ApiTestCase
$this->em->clear();
$doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $first['data']['uuid']]);
$this->assertSame('دکتر تست ویرایش‌شده', $doctor->getName());
// نیم‌فاصله در normalize به فاصله تبدیل می‌شود
$this->assertSame('تست ویرایش شده', $doctor->getName());
}
public function testClaimedDoctorIsNeverOverwritten(): void