feat(смс-клиент): своя база — загрузка Excel, пример файла, оператор через ДаДату, отброшенные не молча

Доработки экрана «Моя база» клиентской СМС-рассылки по просьбе владельца:

- Кривые номера больше не выбрасываются молча: uploadContacts/uploadContactsFile
  возвращают rejected + rejected_samples, экран показывает «Добавлено: N,
  не распознали: M (например: …) — проверьте формат».
- Таблица базы — только «Номер» и «Оператор» (колонку «Имя» убрал).
- Загрузка базы Excel-файлом: сервис ClientSmsPhoneFileReader (phpspreadsheet)
  читает первую колонку, пропускает заголовок, номера-как-числа не уходят в
  научную нотацию; endpoint POST /api/sms/contacts/file; на экране — выбор файла
  и кнопка «Загрузить файл».
- «Скачать пример файла»: ClientSmsBaseExampleWriter + GET /api/sms/contacts/example
  — готовый .xlsx с колонкой «Телефон» и образцами номеров.
- Оператор через ДаДату: EnrichClientSmsContactsOperatorJob обогащает добавленные
  номера (DaDataPhoneClient.provider) в фоне, под tenant-контекстом (RLS), с
  защитой дневного бюджета (DaDataBudgetGuard); сбой ДаДаты не роняет прогон,
  оператор остаётся пустым; уже известного оператора не перезапрашиваем.

Тесты: бэкенд ClientSms 130/130, фронт СМС-спеки 63/63 — зелёные; pint чист;
портал пересобран. Синтетические номера 7999… в тестах.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

app/tests/Unit/ClientSms/BaseExampleWriterTest.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Services\ClientSms\ClientSmsBaseExampleWriter;
+use App\Services\ClientSms\ClientSmsPhoneFileReader;
+use App\Support\PhoneNormalizer;
+
+/**
+ * «Скачать пример файла» — чтобы клиент заполнил свою базу правильно. Пример —
+ * валидный .xlsx с заголовком «Телефон» и парой образцов номеров, который наш же
+ * парсер читает без потерь.
+ */
+it('строит валидный xlsx с примерами номеров', function () {
+    $bytes = (new ClientSmsBaseExampleWriter)->build();
+
+    // .xlsx = ZIP → сигнатура «PK». PDF был бы «%PDF».
+    expect(substr($bytes, 0, 2))->toBe('PK');
+
+    // читаем свой же пример своим парсером: заголовок отсеётся, номера останутся
+    $path = tempnam(sys_get_temp_dir(), 'ex').'.xlsx';
+    file_put_contents($path, $bytes);
+    $rows = (new ClientSmsPhoneFileReader)->read($path);
+    @unlink($path);
+
+    expect($rows)->not->toBeEmpty();
+    // образцы — валидные российские номера
+    foreach ($rows as $r) {
+        expect(PhoneNormalizer::normalize($r))->not->toBeNull();
+    }
+});