feat: hồ sơ khách (ngày sinh, tỉnh/phường theo mã), gộp menu + nút tắt, thông báo theo uuid

- PUT v1/client/update: gender theo enum ClientGender (0 Nam/1 Nữ), thêm
  birthday (cột mới), province_code/ward_code validate theo bảng provinces/wards
  (phường phải thuộc tỉnh). Migration nạp dữ liệu hành chính 2025 từ
  province_ward_import.sql (chỉ bảng trống), API GET v1/provinces[/{code}/wards].
- CustomerObserver/OrderObserver log giá trị cũ bằng getRawOriginal: getOriginal
  trả enum object, nối chuỗi gây 500 khi khách đổi giới tính.
- ClientResource: các cờ trả boolean, CCCD chỉ trả cccd_updated (không lộ ảnh/số).
- GET v1/setting/menu trả cả items + quick_links, bỏ v1/setting/quick-links.
- Thông báo admin/khách tra theo uuid thay vì id tự tăng.
- Chặn gửi template marketing cho khách đã tắt nhận email marketing.
- Xoá ProvinceWardSeeder và Customer::$updatable không dùng.

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

app/Http/Controllers/Api/Admin/MailCampaign/MailCampaignController.php

@@ -169,14 +169,19 @@ final class MailCampaignController extends Controller
 
         $campaign = $this->draftCampaign($data);
 
+        $marketingOnly = $campaign->isMarketing();
         $recipients = $data['recipient_type'] === 'all'
-            ? $this->allCustomerRecipients()
-            : $this->selectedRecipients($data['uuids'] ?? [], $data['emails'] ?? []);
+            ? $this->allCustomerRecipients($marketingOnly)
+            : $this->selectedRecipients($data['uuids'] ?? [], $data['emails'] ?? [], $marketingOnly);
+        $optedOut = $recipients['opted_out'];
+        $recipients = $recipients['recipients'];
 
         if ($recipients === []) {
             return response()->json([
                 'error' => true,
-                'message' => 'Không có người nhận hợp lệ để gửi.',
+                'message' => $optedOut > 0
+                    ? "Không có người nhận hợp lệ: {$optedOut} khách hàng đã tắt nhận email marketing."
+                    : 'Không có người nhận hợp lệ để gửi.',
             ], 422);
         }
 
@@ -200,7 +205,8 @@ final class MailCampaignController extends Controller
 
         return response()->json([
             'error'   => false,
-            'message' => "Đã đưa {$campaign->total_recipients} email vào hàng đợi gửi.",
+            'message' => "Đã đưa {$campaign->total_recipients} email vào hàng đợi gửi."
+                . ($optedOut > 0 ? " Bỏ qua {$optedOut} khách hàng đã tắt nhận email marketing." : ''),
             'data'    => $this->mapCampaign($campaign),
         ]);
     }
@@ -258,42 +264,62 @@ final class MailCampaignController extends Controller
     }
 
     /**
-     * @return array<string, int>
+     * @return array{recipients: array<string, int>, opted_out: int}
      */
-    private function allCustomerRecipients(): array
+    private function allCustomerRecipients(bool $marketingOnly): array
     {
-        return Customer::query()
+        $customers = Customer::query()
             ->whereNotNull('email')
             ->where('email', '!=', '')
-            ->pluck('id', 'email')
-            ->all();
+            ->get(['id', 'email', 'email_marketing']);
+
+        [$accepted, $optedOut] = $customers->partition(
+            fn (Customer $customer) => !$marketingOnly || $customer->acceptsMarketingEmail()
+        );
+
+        return [
+            'recipients' => $accepted->pluck('id', 'email')->all(),
+            'opted_out'  => $optedOut->count(),
+        ];
     }
 
     /**
      * @param array<int, string> $uuids
      * @param array<int, string> $emails
-     * @return array<string, int|null>
+     * @return array{recipients: array<string, int|null>, opted_out: int}
      */
-    private function selectedRecipients(array $uuids, array $emails): array
+    private function selectedRecipients(array $uuids, array $emails, bool $marketingOnly): array
     {
         $emails = array_values(array_unique(array_map(fn ($email) => mb_strtolower(trim($email)), $emails)));
 
         $customers = Customer::query()
             ->where(fn ($q) => $q->whereIn('uuid', $uuids)->orWhereIn('email', $emails))
             ->whereNotNull('email')
-            ->get(['id', 'email', 'uuid']);
+            ->get(['id', 'email', 'uuid', 'email_marketing']);
 
         $recipients = [];
+        $optedOutEmails = [];
         foreach ($customers as $customer) {
-            if (in_array($customer->uuid, $uuids, true) || in_array(mb_strtolower($customer->email), $emails, true)) {
-                $recipients[mb_strtolower($customer->email)] = $customer->id;
+            $email = mb_strtolower($customer->email);
+            if (!in_array($customer->uuid, $uuids, true) && !in_array($email, $emails, true)) {
+                continue;
             }
+            if ($marketingOnly && !$customer->acceptsMarketingEmail()) {
+                $optedOutEmails[$email] = true;
+                continue;
+            }
+            $recipients[$email] = $customer->id;
         }
         foreach ($emails as $email) {
-            $recipients[$email] ??= null;
+            if (!isset($optedOutEmails[$email])) {
+                $recipients[$email] ??= null;
+            }
         }
 
-        return array_filter($recipients, fn ($id, $email) => filter_var($email, FILTER_VALIDATE_EMAIL), ARRAY_FILTER_USE_BOTH);
+        return [
+            'recipients' => array_filter($recipients, fn ($id, $email) => filter_var($email, FILTER_VALIDATE_EMAIL), ARRAY_FILTER_USE_BOTH),
+            'opted_out'  => count($optedOutEmails),
+        ];
     }
 
     private function mapCampaign(MailCampaign $campaign): array