fix: store appointment address from schedule and auto-add patient to clinic

Appointments now persist address_id resolved from the weekly-schedule
session (location_id) across all booking paths (online, secretary, admin).
On confirm, the patient is added to the clinic owning that address, or to
the doctor's single clinic as fallback. Weekly-schedule create/update now
requires location_id on every active session. PatientSession exposes
doctor_uuid/doctor_name so clinic records show which doctor each visit is for.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/Appointment/Controller/AppointmentSettingsController.php

@@ -53,6 +53,10 @@ class AppointmentSettingsController extends BaseController
             return $this->error(ErrorCodes::ERR_AUTH_006, 'دسترسی ممنوع', 403);
         }
 
+        if (($err = $this->validateSessionsHaveLocation($data['schedule'] ?? [])) !== null) {
+            return $this->error(ErrorCodes::ERR_VALIDATION_001, $err, 422);
+        }
+
         // Only one schedule per doctor — upsert
         $schedule = $this->scheduleRepo->findByDoctor($doctor);
         if ($schedule !== null) {
@@ -90,6 +94,9 @@ class AppointmentSettingsController extends BaseController
 
         $data = json_decode($request->getContent(), true) ?? [];
         if (isset($data['schedule'])) {
+            if (($err = $this->validateSessionsHaveLocation($data['schedule'])) !== null) {
+                return $this->error(ErrorCodes::ERR_VALIDATION_001, $err, 422);
+            }
             $schedule->setSetting($data['schedule']);
         }
         if (isset($data['meta']) && is_array($data['meta'])) {
@@ -356,4 +363,20 @@ class AppointmentSettingsController extends BaseController
 
         return $this->success(['data' => $result]);
     }
+
+    /**
+     * هر session فعال در برنامه‌ی هفتگی باید آدرس (location_id) داشته باشد.
+     * در صورت نقص، پیام خطا برمی‌گرداند؛ در غیر این صورت null.
+     */
+    private function validateSessionsHaveLocation(array $schedule): ?string
+    {
+        foreach ($schedule as $day) {
+            foreach (($day['sessions'] ?? []) as $session) {
+                if (($session['active'] ?? false) && empty($session['location_id'])) {
+                    return 'برای هر شیفت فعال باید آدرس (مطب/کلینیک) انتخاب شود';
+                }
+            }
+        }
+        return null;
+    }
 }