Files
clinicpro/tests/Doctor/DoctorClaimTest.php
T
hamedandClaude Opus 4.8 af125572c9 feat(doctor): complete IRIMC import feature — claim flow, least-privilege importer, unique import key
- Extract import logic from AdminApiController into DoctorImportService
  (thin DoctorImportController keeps the same route/contract)
- Surrogate users get marker role ROLE_UNCLAIMED_DOCTOR (+ backfill command
  app:doctors:backfill-surrogate-role) enabling safe deletion after claim
- DB-level UNIQUE (source, medical_system_code) + concurrent-import retry
- Doctor profile claim flow (climed.md): shahkar + PersonInfo identity checks
  via existing ApiIrService, Persian name normalization (PersianText),
  pessimistic-lock race protection, DoctorClaimRequest audit table
  (national code hashed, mobile masked), doctor_claim rate limiter,
  public claim-info endpoint, welcome SMS
- Admin support tools: manual transfer endpoint + paginated doctor-claims
  audit list + owner_status filter/fields in admin doctors list
- Least privilege: system owner now gets ROLE_IMPORTER (ROLE_ADMIN stripped),
  import endpoint accepts ADMIN|IMPORTER, isStaff includes IMPORTER
- Headless crawler login: X-Service-Token header bypasses captcha only
  (rate limit + password checks intact; empty env = no bypass)
- docs: doctor-claim.md (new), doctor-import.md, admin.md, doctor.md
- tests: DoctorImportTest (6), DoctorClaimTest (11), PersianTextTest (5)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-11 11:39:15 +03:30

220 lines
9.1 KiB
PHP

<?php
namespace App\Tests\Doctor;
use App\Auth\Entity\User;
use App\Doctor\Entity\Doctor;
use App\Doctor\Entity\DoctorClaimRequest;
use App\Shared\Service\ApiIrService;
use App\Tests\ApiTestCase;
/**
* جریان تصاحب پروفایل پزشک ایمپورت‌شده. ApiIrService همیشه mock می‌شود —
* تست‌ها هرگز به سرویس واقعی api.ir درخواست نمی‌زنند.
*/
class DoctorClaimTest extends ApiTestCase
{
protected function setUp(): void
{
parent::setUp();
$this->client->disableReboot();
}
private function mockApiIr(bool $shahkar = true, ?array $person = ['firstName' => 'تست', 'lastName' => 'ایمپورت', 'alive' => true]): void
{
$mock = $this->createMock(ApiIrService::class);
$mock->method('isConfigured')->willReturn(true);
$mock->method('shahkarMatch')->willReturn($shahkar);
$mock->method('personInfo')->willReturn($person);
static::getContainer()->set(ApiIrService::class, $mock);
}
private function importUnclaimedDoctor(): string
{
$admin = $this->createUser(['ROLE_USER', 'ROLE_ADMIN']);
$code = 'C' . random_int(100_000, 999_999) . random_int(100, 999);
$data = $this->authJson('POST', '/api/v1/admin/doctors/import', $admin, [
'name' => 'دکتر تست ایمپورت',
'medical_system_code' => $code,
]);
return $data['data']['uuid'];
}
private function claimBody(): array
{
// db_test هرگز reset نمی‌شود و users.national_code یکتاست → کد ملی هر تست تصادفی
return [
'national_code' => '00' . str_pad((string) random_int(0, 99_999_999), 8, '0', STR_PAD_LEFT),
'birth_date' => '1371/1/1',
'first_name' => 'تست',
'last_name' => 'ایمپورت',
];
}
public function testSuccessfulClaimTransfersOwnershipAndDeletesSurrogate(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr();
$doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $uuid]);
$surrogateId = $doctor->getUser()->getId();
$claimer = $this->createUser(['ROLE_USER']);
$res = $this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, $this->claimBody());
$this->assertSame(200, $this->responseCode());
$this->assertSame('claimed', $res['data']['status']);
$this->em->clear();
$doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $uuid]);
$this->assertSame('claimed', $doctor->getOwnerStatus());
$this->assertSame($claimer->getId(), $doctor->getUser()->getId());
$this->assertNull($doctor->getManagedBy());
$claimer = $this->em->getRepository(User::class)->find($claimer->getId());
$this->assertTrue($claimer->hasRole('ROLE_DOCTOR'));
$this->assertTrue($claimer->isNationalCodeVerified());
$this->assertNull($this->em->getRepository(User::class)->find($surrogateId), 'surrogate must be deleted');
$claim = $this->em->getRepository(DoctorClaimRequest::class)->findOneBy(['doctor' => $doctor]);
$this->assertSame(DoctorClaimRequest::STATUS_COMPLETED, $claim->getStatus());
}
public function testNameMismatchRevertsToUnclaimed(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr(person: ['firstName' => 'کس', 'lastName' => 'دیگری', 'alive' => true]);
$claimer = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, $this->claimBody());
$this->assertSame(422, $this->responseCode());
$this->em->clear();
$doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $uuid]);
$this->assertSame('unclaimed', $doctor->getOwnerStatus(), 'must be free for the real doctor to retry');
$this->assertStringStartsWith('imp_', $doctor->getUser()->getMobileNumber(), 'surrogate must survive');
$claim = $this->em->getRepository(DoctorClaimRequest::class)->findOneBy(['doctor' => $doctor]);
$this->assertSame(DoctorClaimRequest::STATUS_FAILED, $claim->getStatus());
$this->assertNotNull($claim->getFailureReason());
}
public function testDeceasedPersonIsRejected(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr(person: ['firstName' => 'تست', 'lastName' => 'ایمپورت', 'alive' => false]);
$claimer = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, $this->claimBody());
$this->assertSame(422, $this->responseCode());
}
public function testShahkarMismatchIsRejected(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr(shahkar: false);
$claimer = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, $this->claimBody());
$this->assertSame(422, $this->responseCode());
}
public function testAlreadyClaimedIsConflict(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr();
$first = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $first, $this->claimBody());
$this->assertSame(200, $this->responseCode());
$second = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $second, $this->claimBody());
$this->assertSame(409, $this->responseCode());
}
public function testUserWhoAlreadyOwnsADoctorCannotClaim(): void
{
$uuidA = $this->importUnclaimedDoctor();
$uuidB = $this->importUnclaimedDoctor();
$this->mockApiIr();
$claimer = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuidA}/claim", $claimer, $this->claimBody());
$this->assertSame(200, $this->responseCode());
$this->authJson('POST', "/api/v1/doctor/{$uuidB}/claim", $claimer, $this->claimBody());
$this->assertSame(409, $this->responseCode());
$this->em->clear();
$doctorB = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $uuidB]);
$this->assertSame('unclaimed', $doctorB->getOwnerStatus());
}
public function testValidationErrors(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->mockApiIr();
$claimer = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, ['national_code' => '123', 'birth_date' => '1371/1/1', 'first_name' => 'الف', 'last_name' => 'ب']);
$this->assertSame(422, $this->responseCode());
$this->authJson('POST', "/api/v1/doctor/{$uuid}/claim", $claimer, ['national_code' => '0010007700', 'birth_date' => 'invalid', 'first_name' => 'الف', 'last_name' => 'ب']);
$this->assertSame(422, $this->responseCode());
}
public function testClaimInfoIsPublic(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->client->request('GET', "/api/v1/doctor/{$uuid}/claim-info");
$this->assertSame(200, $this->responseCode());
$data = json_decode($this->client->getResponse()->getContent(), true);
$this->assertTrue($data['data']['claimable']);
$this->assertSame('unclaimed', $data['data']['owner_status']);
}
public function testAdminTransferHappyPath(): void
{
$uuid = $this->importUnclaimedDoctor();
$admin = $this->createUser(['ROLE_USER', 'ROLE_ADMIN']);
$mobile = '09' . str_pad((string) random_int(0, 999_999_999), 9, '0', STR_PAD_LEFT);
$res = $this->authJson('POST', "/api/v1/admin/doctors/{$uuid}/transfer", $admin, ['mobile' => $mobile]);
$this->assertSame(200, $this->responseCode());
$this->assertSame('claimed', $res['data']['owner_status']);
$this->em->clear();
$doctor = $this->em->getRepository(Doctor::class)->findOneBy(['uuid' => $uuid]);
$this->assertSame('claimed', $doctor->getOwnerStatus());
$this->assertSame($mobile, $doctor->getUser()->getMobileNumber());
$this->assertTrue($doctor->getUser()->hasRole('ROLE_DOCTOR'));
// transfer دوباره → 409
$this->authJson('POST', "/api/v1/admin/doctors/{$uuid}/transfer", $admin, ['mobile' => $mobile]);
$this->assertSame(409, $this->responseCode());
}
public function testAdminTransferRequiresAdmin(): void
{
$uuid = $this->importUnclaimedDoctor();
$user = $this->createUser(['ROLE_USER']);
$this->authJson('POST', "/api/v1/admin/doctors/{$uuid}/transfer", $user, ['mobile' => '09121234567']);
$this->assertSame(403, $this->responseCode());
}
public function testClaimRequiresAuthentication(): void
{
$uuid = $this->importUnclaimedDoctor();
$this->client->request('POST', "/api/v1/doctor/{$uuid}/claim", server: ['CONTENT_TYPE' => 'application/json'], content: json_encode($this->claimBody()));
$this->assertSame(401, $this->responseCode());
}
}