feat(resource): every resource is supervised by a doctor

Supervision now lives on the resource itself instead of being asked for again at
booking time, so one relation answers it everywhere.

The column is deliberately separate from the existing doctor_id bridge. That
bridge means "this resource IS this doctor" and isPerson() uses it to pin
capacity at 1; a supervised three-seat device must not become a person resource.
The FK is SET NULL rather than CASCADE because deleting a doctor should not take
the clinic's laser with it.

Required on create and non-clearable on update, enforced in the API where it can
give a Persian message. Ownership is checked through Clinic::hasDoctor so a
secretary cannot put their device under a doctor of another clinic; that returns
404, not 403, keeping foreign data invisible.

The 13 existing resources are backfilled deterministically: a practice resource
gets its own doctor, a clinic resource gets that clinic's first doctor. Both are
editable from the resource form.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
2026-08-03 12:15:42 +03:30
co-authored by Claude Opus 5
parent b03ae95bf8
commit ab4974d174
10 changed files with 318 additions and 10 deletions
+32 -3
View File
@@ -61,6 +61,34 @@ abstract class ResourceTestCase extends ApiTestCase
return [$user, $doctor, $address];
}
/**
* پزشکِ ناظرِ محیطِ همین آدرس — از وقتی ناظر روی منبع الزامی شد، هر ساختِ منبع
* یکی لازم دارد. برای کلینیک یک پزشک عضو ساخته می‌شود و برای مطب، خودِ پزشک.
*/
protected function supervisorFor(DoctorAddress $address): Doctor
{
if ($address->tenantEntityType() === 'doctor') {
return $this->em->getRepository(Doctor::class)->find($address->tenantEntityId());
}
$clinic = $this->em->getRepository(Clinic::class)->find($address->tenantEntityId());
foreach ($clinic->getDoctors() as $existing) {
return $existing;
}
$user = $this->createUser(['ROLE_USER', 'ROLE_DOCTOR']);
$doctor = new Doctor($user, 'پزشک ناظر');
$doctor->setMobileNumber($user->getMobileNumber());
$this->em->persist($doctor);
$this->em->flush();
$clinic->getDoctors()->add($doctor);
$this->em->flush();
return $doctor;
}
protected function resourceType(DoctorAddress $address, string $code = 'device', string $name = 'دستگاه'): ResourceType
{
$type = new ResourceType($address->tenantEntityType(), $address->tenantEntityId(), $code, $name);
@@ -83,9 +111,10 @@ abstract class ResourceTestCase extends ApiTestCase
protected function createResource(User $user, DoctorAddress $address, ResourceType $type, array $body = []): array
{
return $this->authJson('POST', '/api/v1/resource', $user, $body + [
'address_uuid' => $address->getUuid(),
'type_uuid' => $type->getUuid(),
'name' => 'لیزر آلکساندرایت ۱',
'address_uuid' => $address->getUuid(),
'type_uuid' => $type->getUuid(),
'name' => 'لیزر آلکساندرایت ۱',
'supervisor_doctor_uuid' => $this->supervisorFor($address)->getUuid(),
]);
}