# دسترسی پزشک به آدرس‌های کلینیک‌های عضو + اجباری کردن فیلدهای آدرس

## زمینه

وقتی یک پزشک عضو یک کلینیک می‌شود، آدرس‌های آن کلینیک باید در پروفایل پزشک (بخش «آدرس‌های مطب») نمایش داده شود. این آدرس‌ها با `type: 'clinic'` در entity `DoctorAddress` ذخیره می‌شوند و `clinic_id` دارند، اما در پاسخ API فعلی `clinic_name` برگردانده نمی‌شود در حالی که frontend آن را از `a.clinic_name` می‌خواند.

همچنین پزشک باید بتواند آدرس‌های کلینیک‌هایی که عضو آن‌هاست را ببیند — در حال حاضر `GET /api/v1/clinic-pro/doctor-addresses/{doctorId}` فقط آدرس‌های مستقیم Doctor entity را برمی‌گرداند و آدرس‌های کلینیک‌های وابسته را شامل نمی‌شود.

علاوه بر این، در `AddressModal` (افزودن آدرس جدید در پروفایل پزشک)، فیلدهای `telephone`، `address`، `province_id` و `city_id` اختیاری هستند و باید اجباری شوند.

## مشکل / هدف

سه هدف مجزا:

**۱.** آدرس‌های کلینیک‌های عضو پزشک باید در لیست آدرس‌های پزشک نمایش داده شوند
**۲.** `DoctorAddress::toArray()` باید `clinic_name` را نیز برگرداند تا frontend بتواند آن را نشان دهد
**۳.** در `AddressModal`، فیلدهای تلفن، آدرس کامل، شهر و استان باید اجباری (required) باشند

## فایل‌های مرتبط

| فایل | نقش |
|------|-----|
| `src/Doctor/Entity/DoctorAddress.php` | entity آدرس — متد `toArray()` باید `clinic_name` اضافه کند |
| `src/Doctor/Controller/DoctorController.php` | `listAddresses()` — خط 671 — باید آدرس‌های کلینیک‌ها را هم شامل شود |
| `src/Clinic/Repository/ClinicRepository.php` | دارای `findByDoctor(Doctor $doctor): array` |
| `src/Clinic/Controller/ClinicController.php` | `listAddresses()` — خط 544 — PUBLIC، آدرس‌های کلینیک را برمی‌گرداند |
| `assets/admin/pages/DoctorDetailPage.tsx` | `addrSchema` در خط 772 — `AddressModal` — فرم افزودن آدرس |
| `docs/api/doctor.md` | مستندات endpoint پزشک |

## وضعیت فعلی

### Backend — DoctorAddress::toArray() (فایل: `src/Doctor/Entity/DoctorAddress.php`, خط 112)

```php
public function toArray(): array
{
    return [
        'id'         => (string) $this->id,
        'uuid'       => $this->uuid,
        'type'       => $this->type,
        'clinic_id'  => $this->clinicId,   // ← فقط ID، بدون نام
        'name'       => $this->name,
        // ...
    ];
}
```

### Backend — listAddresses در DoctorController (خط 671)

```php
#[Route('/api/v1/clinic-pro/doctor-addresses/{doctorId}', methods: ['GET'])]
public function listAddresses(int $doctorId): JsonResponse
{
    $doctor = $this->doctorRepo->find($doctorId);
    // ...
    $addresses = array_map(fn(DoctorAddress $a) => $a->toArray(), $doctor->getAddresses()->toArray());
    // ← فقط آدرس‌های مستقیم Doctor entity — آدرس‌های کلینیک‌های عضو شامل نمی‌شود
    return $this->success(['data' => $addresses]);
}
```

### Frontend — addrSchema در DoctorDetailPage.tsx (خط 772)

```tsx
const addrSchema = z.object({
  name:        z.string().optional(),
  address:     z.string().optional(),       // ← باید required باشد
  telephone:   z.string().max(20).optional(), // ← باید required باشد
  province_id: z.number().nullable().optional(), // ← باید required باشد
  city_id:     z.number().nullable().optional(), // ← باید required باشد
  latitude:    z.string().optional(),
  longitude:   z.string().optional(),
});
```

### Frontend — SessionEditor (خط 1082-1085)

```tsx
...addresses.filter(a => a.type === 'clinic').map(a => ({
  label: `🏨 ${a.clinic_name ? `${a.clinic_name}${a.name ? ` — ${a.name}` : ''}` : (a.name ?? a.address ?? `کلینیک ${a.id}`)}`,
}))
// ← a.clinic_name را استفاده می‌کند اما toArray() این فیلد را برنمی‌گرداند
```

## وضعیت ClinicRepository

```php
// src/Clinic/Repository/ClinicRepository.php — خط 25
public function findByDoctor(Doctor $doctor): array
{
    return $this->createQueryBuilder('c')
        ->innerJoin('c.doctors', 'd')
        ->where('d.id = :doctorId')
        ->setParameter('doctorId', $doctor->getId())
        ->getQuery()
        ->getResult();
}
```

متد `findByDoctor()` وجود دارد — از آن استفاده کن.

## وظایف

### ۱. Backend — اضافه کردن `clinic_name` به `DoctorAddress::toArray()`

در `src/Doctor/Entity/DoctorAddress.php`، `DoctorAddress` entity دارای فیلد `clinicId` (integer) است اما ارتباط مستقیم به entity `Clinic` ندارد. بنابراین `clinic_name` باید از طریق injection خارجی به toArray اضافه شود.

**روش پیشنهادی:** متد `toArray()` را با پارامتر اختیاری گسترش بده:

```php
public function toArray(?string $clinicName = null): array
{
    return [
        'id'          => (string) $this->id,
        'uuid'        => $this->uuid,
        'type'        => $this->type,
        'clinic_id'   => $this->clinicId,
        'clinic_name' => $clinicName,  // ← جدید
        'name'        => $this->name,
        // ... بقیه فیلدها بدون تغییر
    ];
}
```

### ۲. Backend — آدرس‌های کلینیک‌های عضو را در `listAddresses` شامل کن

در `src/Doctor/Controller/DoctorController.php`، متد `listAddresses` (خط 671):

1. `ClinicRepository` را به constructor اضافه کن (اگر از قبل وجود ندارد، بررسی کن)
2. آدرس‌های کلینیک‌های عضو پزشک را دریافت کن
3. آن‌ها را به لیست آدرس‌های پزشک اضافه کن

```php
public function listAddresses(int $doctorId): JsonResponse
{
    $doctor = $this->doctorRepo->find($doctorId);
    if ($doctor === null) {
        return $this->error(ErrorCodes::ERR_VALIDATION_002, 'دکتر یافت نشد', 404);
    }

    // آدرس‌های شخصی پزشک
    $personalAddresses = array_map(
        fn(DoctorAddress $a) => $a->toArray(),
        $doctor->getAddresses()->toArray()
    );

    // آدرس‌های کلینیک‌هایی که پزشک عضو آن‌هاست
    $clinicAddresses = [];
    $clinics = $this->clinicRepo->findByDoctor($doctor);
    foreach ($clinics as $clinic) {
        $clinicAddrs = $this->addressRepo->findBy(['clinicId' => $clinic->getId()]);
        foreach ($clinicAddrs as $addr) {
            $clinicAddresses[] = $addr->toArray($clinic->getName());
        }
    }

    return $this->success(['data' => array_merge($personalAddresses, $clinicAddresses)]);
}
```

**نکته:** `$this->addressRepo` باید از نوع `DoctorAddressRepository` باشد (همان که در ClinicController استفاده می‌شود). بررسی کن که DoctorController این repo را دارد یا نه — اگر ندارد به constructor اضافه کن.

**نکته:** `$this->clinicRepo` از نوع `ClinicRepository` — بررسی کن DoctorController این dependency را دارد.

### ۳. Frontend — اجباری کردن فیلدها در `addrSchema`

در `assets/admin/pages/DoctorDetailPage.tsx`، خط 772، schema را به این شکل تغییر بده:

```tsx
const addrSchema = z.object({
  name:        z.string().optional(),
  address:     z.string().min(1, 'آدرس کامل اجباری است'),
  telephone:   z.string().min(1, 'تلفن اجباری است').max(20),
  province_id: z.number({ required_error: 'استان اجباری است' }),
  city_id:     z.number({ required_error: 'شهر اجباری است' }),
  latitude:    z.string().optional(),
  longitude:   z.string().optional(),
});
```

همچنین لیبل فیلدهای اجباری در form باید علامت ستاره (`*`) داشته باشند — فیلدهای `address`، `telephone`، `استان`، `شهر`.

در JSX، لیبل‌های مربوطه را به این شکل تغییر بده:
```tsx
// مثال:
<label>تلفن <span className="text-red-500">*</span></label>
<label>آدرس کامل <span className="text-red-500">*</span></label>
<label>استان <span className="text-red-500">*</span></label>
<label>شهر <span className="text-red-500">*</span></label>
```

و اضافه کردن نمایش خطا در زیر فیلدها با `formState: { errors }` از `useForm`:
```tsx
const { register, handleSubmit, watch, setValue, reset, formState: { errors } } = useForm<AddrForm>({
  resolver: zodResolver(addrSchema),
});
// ...
{errors.telephone && <p className="text-xs text-red-500 mt-1">{errors.telephone.message}</p>}
{errors.address && <p className="text-xs text-red-500 mt-1">{errors.address.message}</p>}
```

برای `province_id` و `city_id` که از `SearchableSelect` استفاده می‌کنند، error در زیر select نمایش بده.

## نکات مهم

- **Migration لازم نیست** — هیچ schema تغییر نمی‌کند، فقط response format و validation
- **`DoctorAddress::toArray(?string $clinicName = null)`** — پارامتر optional است، همه فراخوانی‌های فعلی بدون تغییر کار می‌کنند
- **DoctorController constructor** — بررسی کن آیا `ClinicRepository` و `DoctorAddressRepository` از قبل inject شده‌اند
- **ClinicController** دارای `$this->addressRepo` از نوع `DoctorAddressRepository` — در DoctorController باید نام variable یکسان باشد (بررسی کن)
- **frontend** در خط 1084: `a.clinic_name` — بعد از اضافه شدن این فیلد به response، این بخش کار می‌کند
- `GET /api/v1/clinic-pro/doctor-addresses/{doctorId}` PUBLIC است — نیازی به auth guard جدید نیست
- بعد از تغییر controller: `ddev exec php bin/console cache:clear`
- بعد از تغییر frontend: `ddev exec yarn dev` و TypeScript check
- مستندات: `docs/api/doctor.md` را با تغییرات endpoint `listAddresses` به‌روزرسانی کن (اضافه شدن clinic addresses به response)