# Инфинити (Era): журнал звонков и хранение всех записей — контекст и план

> Файл для восстановления контекста в новой сессии. Сначала прочитай его целиком, потом `Телефония.md` (ТЗ).
> Дата ресёрча: 29–30.09.2026. Инстанс: только Казахстан (`APP_INSTANCE=kazakhstan`).
> Подробная версия ресёрча со схемой: Claude Doc https://claude.ai/code/artifact/8b0ab3af-4383-4575-a788-7cea6e01a6c0

## 1. Постановка задачи

1. Сделать в Polaris (KZ) экран по ТЗ `Телефония.md`:
   - поиск и фильтрация истории вызовов из телефонии Инфинити;
   - таблица с итогами;
   - аудиоплеер для прослушивания записей;
   - экспорт в CSV.
2. **Хранить у себя ВСЕ записи звонков, которые есть в Инфинити**, а не только звонки, связанные с Polaris. Таблица `7_callhist` для этого не подходит: там только коммуникации Polaris.
3. Доступ: роли Polaris 1–4 (Технологии, Директор, Координатор, Тимлид).

Инфинити = дайлер **Era-platform** 1.11.0. В коде он называется `Infinity`.

## 2. Где остановились

- Ресёрч завершён, скачивание MP3 по API работает (проверено 30.09.2026).
- План имплементации (раздел 10) одобрен пользователем. **Код ещё не писали.**
- 30.09.2026: Шаг 0 выполнен. **Источник журнала — REST, не SQL** (решение пользователя, см. 4.3 и 4.6).
- 01.10.2026: заказчик ответил — «Сохранить в архиве» и виртуальные звонки не нужны; Абонент А = клиент, Абонент Б = специалист; «Сторона отбоя» = кто положил трубку. Экран приведён к этому (см. раздел 5).

## 3. Доступ к API Era

- Базовый URL: env `INFINITY_BASE_URI` = `https://ddv.era.vivus.kz`. Домен `ddv.era.vivus.kz`.
- Токен: env `INFINITY_TOKEN`, заголовок `Authorization: Bearer <token>`. Это токен **пользователя** `dev4`, а не канала интеграции.
- Роли `dev4`: `callcenter_admin`, `callcenter_operator`, `callcenter_record`, `callcenter_supervisor`, `crud`. Проверка: `GET /rest/v1/user/info`.
- Для скачивания записей нужны: роль **`crud`** у пользователя и **разрешение работы с файлами в токене**. Это ответ саппорта Инфинити. Роли `callrec` из документации в этой инсталляции нет, `callcenter_record` доступа не даёт.
- Прямой доступ к БД Era: подключение `infinity_dialer` (`config/database.php`, env `INFINITY_DIALER_DB_*`, pgsql, БД `era_model_pl2.sms-tel.kz.local`, схема `datamodel`).
  **Это другая инсталляция** (домен `pl2.sms-tel.kz.local`, данные 23.03–02.09.2026, ~2 900 звонков), не `ddv.era.vivus.kz`. Для журнала не используем.
- Локально `INFINITY_BASE_URI`/`INFINITY_TOKEN` заданы в `.env` (добавлены 30.09.2026).

## 4. Ресёрч: как Era хранит записи

- Запись ведётся по правилам записи домена. Она начинается после ответа абонента и длится до конца диалога, на каждый диалог отдельный файл.
- Формат: MP3 стерео, 8 кГц, ~24 кбит/с (≈3 КБ/с, ≈11 МБ на час разговора). Левый канал — инициатор, правый — вызванный.
- Путь файла: MG (`rectemp`) → MIXER (`recpath`) → RECMOVER, который переносит файл в хранилище домена. У нашего домена это S3 `s3yc`.
- Скачать файл можно только после события `callevents.records_moved`.
- Ключ записи (`reclink`, в журнале поле `recordLink`) выглядит так: `sk:s3yc:2026-09-21/10:28/mg11_17310-1789986491027.mp3`. Префикс `sk:` означает S3, `fs:` — файловое хранилище.
- Срок хранения записей в S3 Era неизвестен.

### 4.1. Откуда брать reclink
| Источник | Поле | Статус |
|---|---|---|
| Журнал `callcenter/connections/ArchiveConnections` (REST `GET /rest/v1/model/...` или SQL `datamodel."callcenter/connections/ArchiveConnections$"`) | `recordLink` (в доке названо `reclink`; фильтр по `reclink` падает с `column does not exist`) | Работает |
| Событие `callevents.records_moved` | `areclink` / `breclink`, `acallid` | Не проверяли; в вебхуки Polaris сейчас не подписано |
| `telephony/ArchiveDialogs`, `cdr/COPM3/dialogs` | `reclink` | Нашему токену недоступны |

### 4.2. Поля ArchiveConnections (сняты с реального ответа)
- **Идентификаторы и время:**
  - `id` (uuid);
  - `nativeID` (`<cid>.<invitets>`);
  - `nativeFirstCallID` (SIP CallId; вероятно, = `acallid` из `POST /rest/v1/uc/calls`, не проверено);
  - `timeStart` (ISO UTC).
- **Длительности (сек):** `duration`, `durationTalk`, `durationWait`, `durationHold`.
- **Направление и статус:**
  - `direction`: in, out, acd, ivr, inner, failure;
  - `nativeDirection`, например `outer -> user`;
  - `lastState`: talk, wait, null;
  - `stopside`: a, b, unknown, null.
- **Запись:** `recorded`, `recordLink`, `recordSize` (байт).
- **Стороны:** `sideA`/`sideB` = `{number, display, domain, kind, login?, user_id?, name?}`. У клиента `kind=outer`, у сотрудника `kind=user` (логин вида `01154`); ещё бывают `acd` и `ivr`.
- **Прочее:** `dialedNumber`, `searchContext`, `seance_link {id, timestamp}`, `acdCall_link`, `asrInfo`, `speechAnalytics`, `service_code`, `domainName`.
- **Результат сеанса:** в `callcenter/seances/ArchiveSeances`, связь по `seance_link.id`. Поле `result`: failed, success, lost, processedInIVR, processedByFirstOperator, processedByOperators.

### 4.3. Синтаксис REST-запросов к модели
- `interval=["from","to"]` — обязательный параметр. **Фильтрует точно по `timeStart`, обе границы включительно** (проверено 30.09: недельные окна 10.08–04.10 в сумме = 830 = `between` по `timeStart`). «Странность» из первого ресёрча — просто 640 из 830 звонков пришлись на 21–27.09.
- Эквивалент фильтром: `["between",["property","timeStart"],["const","2026-09-22T00:00:00Z"],["const","..."]]`.
- `filter` задаётся в польской нотации: `["==",["property","recorded"],true]`, `["and",...]`, `["between",["property","durationTalk"],["const",0],["const",10]]`.
- Прочие параметры: `order=[{"timeStart":"desc"}]`, `limit`, `offset`, `mask`, `countonly=true`, `aggr` + `groupby`.
- **Страница максимум 100 строк** (`limit=300` всё равно даёт 100; без `limit` тоже 100). Пагинация `offset` с `order=[{"timeStart":"asc"},{"id":"asc"}]` без дублей.
- `in` работает только со списком: `["in",["property","id"],["list",["const","<uuid>"],...]]`. `["const",[...]]` и `inlist` падают (error_code 1413).
- Ошибки модели приходят JSON-ом `{"error_code":..., "error_message":...}`.

### 4.4. Скачивание файла (работает)
- `GET /api/admin/v1/callrecords/<rawurlencode(recordLink)>` или `GET /api/admin/v1/callrecords/download?key=<base64(recordLink)>`, с Bearer-токеном.
- Успех: HTTP 200, `Content-Type: application/octet-stream`, `Content-Disposition: attachment; filename*=UTF-8''<имя>.mp3`.
- **Ошибка приходит тоже с HTTP 200**, но в теле JSON: `{"error_code":1401,"error_message":"Access denied by IAM (route).","error_details":{"msg_code":"10019"}}`. Код 10019 значит «нет маршрута по правам». Поэтому успех проверяется по Content-Type, а не по статусу.
- **ЛОВУШКА: по HTTP/2 сервер обрывает ответ примерно на 64 КБ** (SSL unexpected EOF: `Content-Length` 217 944, получено 65 553). По HTTP/1.1 файл приходит целиком. Range игнорируется. Отсюда два обязательных правила:
  - клиент ходит только по HTTP/1.1 (`withOptions(['version' => 1.1])`);
  - размер скачанного файла сверяется с `Content-Length` и `recordSize`.
- Альтернатива `/api/download/v1/<token>/<reclink>` требует токена канала интеграции типа `public`. С нашим токеном отвечает `403 Invalid token`.

### 4.5. Данные на 30.09.2026 (REST, перепроверено)
- Журнал: 830 звонков, `timeStart` от 2026-08-14T07:34:18Z до 2026-09-30T06:23:04Z. `ArchiveSeances`: 220.
- `direction`: failure 501, out 173, inner 70, acd 34, in 39, ivr 13.
- Записи есть у 55 звонков: 34 in, 21 out. Исходящие тоже пишутся.
- `stopside`: null 501, a 179, b 146, unknown 4. `lastState`: null 501, talk 165, wait 164.
- Сеанс есть не у всех соединений (у `failure` его нет). `seance_link = {id, timestamp(ms int)}`; `timeStart` сеанса отличается от соединения не более чем на ~32 с в выборке.
- В SQL-инсталляции встречались ещё `direction=outer`, `result=processedByExternalAgent`, префикс записи `fs:rp:` — маппинг должен принимать неизвестные значения как есть.

### 4.6. Поля ArchiveConnections через REST
`acdCall_link, asrInfo, callContext, callInfo, dialedNumber, direction, display, domainName, duration, durationHold, durationTalk, durationWait, ext, id, lastState, nativeDirection, nativeEvents, nativeFirstCallID, nativeID, recordLink, recordSize, recorded, rtpStat, seance_link, searchContext, service_code, sideA, sideB, speechAnalytics, stopside, timeStart`.
`sideA`/`sideB`: у `user` ключи `display, domain, kind, login, name, number, user_id` (иногда без `user_id`); у `outer` — `display, domain, kind, number` (иногда `name`); у `failure` только `display, number` без `kind`.

## 5. Сопоставление ТЗ и API

| Требование ТЗ | Источник в Era | Решение |
|---|---|---|
| Период до секунды, длительность с/по | `timeStart`, `duration` | ОК, фильтр в своей БД |
| Итого / Ожидание / Разговор | `duration` / `durationWait` / `durationTalk` | «Ожидание» = `durationWait`; `durationHold` храним, не выводим |
| Направление ↓/↑ | `direction`, 6 значений | Иконки для in/out, для остальных текстовая метка |
| Сторона отбоя | `stopside` | Отдельная графа: «Клиент» / «Специалист», для IVR/очереди — «Сторона А/Б» по колонке на экране |
| Абонент А/Б: номер и оператор | `sideA`/`sideB` | **А = клиент, Б = вторая сторона** (на показе и в CSV; в БД стороны как в Era). Клиент = сторона `kind=outer`; у `failure` (kind пустой) — сторона с номером ≥ 10 цифр. Нет клиента (inner) — порядок Era. `InfinityCall::clientSide()/displaySide()` |
| Фильтр «Абонент» | номера обеих сторон, подстрока | 11 цифр с `7`/`8` в начале ищутся по последним 10 (у `failure` номер без кода страны) |
| Модалка «Операторы» (логин, фамилия, имя, отчество, внутр. номер, подразделение) | пользователи Polaris | ФИО одной строкой (`nombre`), поиск по подстроке; подразделение = дом (`idcasa`) |
| «Оператор» (текстовое поле) | стороны с `kind=user` или без kind (`failure`) | Поиск по логину, имени или номеру |
| «Результат» | `ArchiveSeances.result` | Статус Era как есть |
| «Отображать виртуальные» | — | **Не делаем** |
| «Сохранить в архиве» | — | **Не делаем** (ответ заказчика 01.10.2026) |
| Быстрые периоды, Применить/Отменить/Обновить, CSV, итоговая строка | своя БД | ОК |
| Плеер (play/pause/stop, перемотка, таймлайн, громкость, зациклить, автопереход, скачать) | наш файл | Нативный `<audio>` и Alpine |
| «Автоуровень» | — | Web Audio `DynamicsCompressorNode` |
| Аудитория «ОКК» против ролей 1–4 | ОКК = `Role::ROLE_QUALITY` (5) | **Жёстко роли 1–4** |

## 6. Принятые решения (пользователь)
- В таблице все звонки журнала; плеер активен только у звонков с записью.
- «Результат» — статус Era как есть. «Виртуальные» и «Архив» не делаем.
- Операторы берутся из пользователей Polaris с `dialer_extension_id`.
- Доступ жёстко для ролей 1–4 (`usuarios.idperfil`). Пункт меню выдаётся через permission ролям [1,2,3,4].
- MP3 хранятся на `filesDisk()` бессрочно.
- ~~Журнал читаем SQL через `infinity_dialer`~~ → **журнал и файлы читаем через REST** (30.09.2026, SQL — другая инсталляция).

## 7. Что уже есть в коде (не писать заново)
- **Конфиг** `config/integrations.php`, ключ `infinity`:
  - `base_uri`, `token`, `mode`, `webhook_url`, `webhook_expires`;
  - `webhook_events` = `['callevents.route_fin','callevents.dlg_stop']`.
- **`app/Integrations/Infinity/Services/InfinityCallService.php`:**
  - образец HTTP-вызова: `Http::withToken(config('integrations.infinity.token'))->acceptJson()->asJson()->timeout(70)->post(...)->throw()`;
  - `acallid` не хранится отдельно, только внутри `infinity_call_logs.response`.
- **`app/Services/Communication/Migration/InfinityCommunicationMigrator.php`:**
  - уже читает `datamodel."callcenter/connections/ArchiveConnections$"` JOIN `ArchiveSeances$` по `(c."seance_link"->>'id')::uuid = s.id` через `DB::connection('infinity_dialer')`;
  - даты подставляет интерполяцией: так не делать, использовать bindings.
- **Вебхуки:**
  - `routes/webhooks.php`, контроллер `InfinityCallbackController` → `InfinityWebhookEventJob` (очередь `webhooks_queue`);
  - обработчики `route_fin` и `dlg_stop` — пустые заглушки; `records_moved` не подписан.
- **Ручной звонок:** `acallid` уходит в `7_callhist.idllamada` (`app/Models/Collection/Communication/CallHistory.php`).
- **Роли и доступ:**
  - `app/Models/User/Role.php`: 1 TECHNOLOGY, 2 DIRECTOR, 3 COORDINATOR, 4 TEAMLEADER, 5 QUALITY, 6 USER, 8 API;
  - `User` = таблица `usuarios` на подключении `users`; поля `usuario`, `nombre`, `dialer_extension_id`, `idcasa`, `idperfil`;
  - `User::checkAccess()` / `can()` проверяют slug через роли, кэш `user_roles_{id}` на сутки.
- **Меню:**
  - таблица `admin_menu` (подключение `collection`), фильтр в `app/Livewire/Navigation/SideMenu.php`, кэш `admin_menu_user_{id}_structure`;
  - образец миграции: `database/migrations/2026_08_12_120000_add_promises_to_menu.php` (`nextId`, `nextMenuOrder`, роли [1,2,3,4]);
  - сброс кэша: `2026_08_24_120000_grant_promises_permission_to_agent_roles.php::forgetAffectedUsersCache()`.
- **Образец экрана:**
  - `app/Livewire/Promise/IndexComponent.php`: `#[Url]` фильтры, `WithPagination`, `getTotals`, `exportCsv()`;
  - `app/Services/Promise/PromiseCsvExporter.php`: `streamDownload`, разделитель `;`, BOM;
  - `app/Repositories/Collection/ReadPromiseRepository.php`;
  - вьюхи `resources/views/livewire/promise/...`, контроллер `app/Admin/Controllers/Promise/PromiseController.php`, обёртка `components.layouts.app`.
- **Фронтенд:**
  - flatpickr грузится глобально, но везде без времени (`enableTime` и `enableSeconds` нигде не используются);
  - готовой модалки выбора пользователей нет; образец Alpine-модалки: `resources/views/livewire/infinity/infinity-webhook-subscriptions-component.blade.php`;
  - аудиоплеера нет;
  - ассеты закоммичены в `public/js` и `public/css`, Vite не используется.
- **Файлы:** `filesDisk()` / `fileUrl()` в `app/Helpers/Autoload/functions.php`. `MediaDownloadController` отдаёт только локальный диск `media`.
- **Расписание:**
  - `app/Console/Kernel.php`, `LEAD_TIME[INSTANCE_KAZAKHSTAN]`;
  - трекинг запусков через `ScheduledCommandRun::TRACKED_COMMANDS`;
  - образец watermark с перекрытием: `app/Services/Actualization/ActualizationRunner.php`.
- **Тесты:**
  - `tests/Feature/Integrations/Infinity/InfinityCallServiceTest.php` (`Http::fake`, `DatabaseTransactions`, `$connectionsToTransact=['collection']`);
  - `tests/Feature/Livewire/Promise/IndexComponentTest.php` (мок репозитория, `actingAs` ROLE_TECHNOLOGY, `config()->set('polaris.instance', INSTANCE_KAZAKHSTAN)`);
  - изолированной тестовой БД нет, тесты идут на реальные подключения в транзакциях.

## 8. Риски и замечания вне скоупа
- В `config/integrations.php` в значении по умолчанию для `INFINITY_TOKEN` захардкожен токен. Стоит убрать.
- Пункт меню «Infinity webhooks», вероятно, удалён миграцией `2026_07_21_120000_recreate_admin_menu_and_permissions.php`.
- Вебхук `/webhooks/infinity` принимает запросы без проверки подлинности.
- Записи содержат ПДн: не скачивать их вручную без разрешения и сразу удалять временные файлы.

## 9. Документация Era (всё под https://vendor.era-platform.ru/docs/era/latest/)
- Оглавление: `index.html`. Пути относительно `/docs/era/latest/`; `/docs/` в середине даёт 404.
- Запись звонков: `articles/recording.html`.
- Скачивание: `api/api/admin/callrecords.html`; по токену канала: `api/api/token/download.html`; WebSocket: `api/websocket/token/callrecord.html`.
- UC calls (`TRANSCRIBE`, `SETUP_RECORD`, источники reclink): `api/rest/v1/uc/calls.html`.
- Модель данных: `api/rest/v1/model/index.html`, `api/rest/v1/model/overview/index.html` (filter, order, aggr), `api/rest/v1/model/endpoints/index.html`.
- События: `events/event_classes/callevents/records_moved.html`, `call_rec_links.html`, `rec_info.html`.
- Правила записи и хранилища: `api/rest/v1/uc/recordrules.html`, `entities/uc/recordrule.html`, `api/rest/v1/domain/storages.html`, `api/rest/v1/domain/storagerules.html`.
- Роли: `configuration/roles/recmover.html`, `configuration/roles/callstore.html`.
- Продуктового слоя callcenter (`ArchiveConnections`, `ccsevents.*`) в этой документации нет. Поля сняты с живого ответа.

## 10. План имплементации

### Шаг 0. Схема источника (только чтение)
- [x] Поля и поведение REST проверены (4.3, 4.5, 4.6).

### Шаг 1. Таблица `infinity_calls` (подключение `collection`) — ГОТОВО 30.09.2026
- Миграция `database/migrations/2026_09_30_191918_create_infinity_calls_table.php` (локально применена только она через `--path`; 5 чужих миграций от 17–18.09 в локальной БД остаются Pending).
- `time_start` — `timestamp` в `app.timezone` (Asia/Almaty) с точностью до секунды; при синхронизации UTC `timeStart` из Era конвертировать. Добавлена колонка `seance_id`. Индекс `(recorded, record_path)` для очереди скачивания.
- Модель `app/Models/Collection/InfinityCall.php`: константы `DIRECTION_*`, `SIDE_KIND_*`, `MAX_RECORD_ATTEMPTS=5`, связь `polarisUser()`, `hasStoredRecord()`, scope `pendingRecordDownload()`.
- Фабрика `database/factories/Collection/InfinityCallFactory.php` (состояния `recorded()`, `withStoredRecord()`), тест `tests/Feature/Integrations/Infinity/InfinityCallModelTest.php`.
- Файлы, созданные `artisan make:*` в контейнере, принадлежат root — после генерации делать `docker exec -i polaris-service-new chown -R 1000:1000 <path>`.
- [x] Миграция через `php artisan make:migration`.
- [ ] Колонки:
  - `era_id` (uuid, unique), `native_id`, `native_first_call_id` (index);
  - `time_start` (index), `duration`, `duration_talk`, `duration_wait`, `duration_hold`;
  - `direction` (index), `native_direction`, `last_state`, `stop_side`, `seance_result` (index);
  - `side_a_number/kind/login/name` и то же для `side_b_*`;
  - `external_number` (index), `operator_login`, `operator_extension` (index), `polaris_user_id` (nullable);
  - `recorded`, `record_link`, `record_size`, `record_path`, `record_downloaded_at`, `record_attempts`, `record_error`;
  - timestamps.
- [x] Модель `app/Models/Collection/InfinityCall.php`: `$connection='collection'`, `protected $casts`.

### Шаг 2. Синхронизация журнала — ГОТОВО 30.09.2026
- Реальный прогон 30.09.2026 (с разрешения): `infinity:sync-calls --from="2026-08-01 00:00:00"` в локальную БД → 830 звонков, 55 с записью (8 547 336 байт по `recordSize`), направления/stopside совпадают с Era (4.5); повторный запуск по умолчанию (окно −2 ч) дублей не дал. `polaris_user_id` локально 0 — в локальной `usuarios` операторов KZ с такими `dialer_extension_id` нет.
- `app/Integrations/Infinity/Services/InfinityCallJournalSource.php`: `connectionPages(from,to)` (генератор страниц по 100, стоп на короткой/пустой странице, защита от игнорирования offset), `seanceResults(ids,from,to)` (пачки по 50 id, окно назад на 24 ч). Ошибки: `App\Integrations\Infinity\Exceptions\InfinityApiException`.
- `app/Services/Telephony/Infinity/InfinityCallSynchronizer.php` → `InfinityCallSyncResult(calls, recorded)`. Upsert по `era_id` постранично; не трогает `record_path/record_downloaded_at/record_attempts/record_error`. `recorded=true` только при непустом `recordLink`. `polaris_user_id` — по `usuarios.dialer_extension_id` = `number` стороны `user` (в Era у операторов `number == login`, напр. `01135`).
- Команда `infinity:sync-calls {--from=} {--to=}` (`app/Console/Commands/Cron/Infinity/SyncInfinityCallsCommand.php`): только KZ; окно по умолчанию `max(time_start) - 2ч .. now`, пустая таблица → последние 24 ч.
- Kernel KZ `everyFiveMinutes`, `ScheduledCommandRun::TRACKED_COMMANDS`, переводы `monitoring.scheduler.commands.infinity:sync-calls` в 6 локалях.
- Тесты: `InfinityCallJournalSourceTest`, `InfinityCallSynchronizerTest`, `SyncInfinityCallsCommandTest`, `KernelScheduleTest`, `ScheduledTaskMonitorTest` — зелёные.
- Не связанные с задачей падения (были до изменений, проверено stash): 13 тестов `tests/Feature/Monitoring/*` (ожидают русскую локаль, получают en) и `InfinityCallServiceTest::test_posts_expected_payload...` (Ok vs Timeout).
- Постановка задач на скачивание MP3 — в шаге 3.
- [ ] `app/Integrations/Infinity/Services/InfinityCallJournalSource.php` (REST):
  - `GET /rest/v1/model/callcenter/connections/ArchiveConnections`, `interval=[from,to]`, `order` timeStart+id asc, страницы по 100 через `offset`;
  - для каждой страницы результаты сеансов одним запросом `ArchiveSeances` c `["in",["property","id"],["list",...]]`, `mask=id,result`, тот же `interval` расширенный на запас;
  - HTTP/1.1, Bearer, проверка JSON-ошибки (`error_code`).
- [ ] `app/Services/Telephony/Infinity/InfinityCallSynchronizer.php`:
  - маппинг: оператор = сторона `kind=user`, внешний номер = сторона `kind=outer`;
  - `upsert` по `era_id`;
  - `polaris_user_id` по `usuarios.dialer_extension_id`.
- [ ] Команда `infinity:sync-calls {--from=} {--to=}` (`app/Console/Commands/Cron/Infinity/SyncInfinityCallsCommand.php`):
  - guard `isKazakhstan()`;
  - окно по умолчанию: `max(time_start)` минус 2 часа до now;
  - бэкфилл: `--from=2026-08-01`.
- [ ] `Kernel::LEAD_TIME[INSTANCE_KAZAKHSTAN]` → `everyFiveMinutes`; добавить в `ScheduledCommandRun::TRACKED_COMMANDS`.

### Шаг 3. Копирование MP3 — ГОТОВО 30.09.2026
- Реальное скачивание 30.09.2026 (с разрешения): 55/55 записей за ~35 с, 0 ошибок; размеры = `recordSize` (8 547 336 байт), у всех заголовок MP3; длительность по размеру (3 КБ/с) = `duration_talk` ±3 с. Файлы в `storage/app/infinity-records` (не публичный). Повторный запуск — 0 в очереди. Несуществующий `recordLink` → Era отвечает `[1506] Failed get data size` (ловится как `InfinityApiException`).
- Каталоги создаются с `directory_visibility=public` (0755): иначе Flysystem делает 0700, и если cron/воркер пишет от root, PHP-FPM (`www-data`) не прочитает файлы.
- **Отступление от решения «MP3 на `filesDisk()`»:** локально `filesDisk()` = `public` (`storage/app/public`, отдаётся по `/storage/...` без авторизации) — для ПДн нельзя. Добавлен `config('integrations.infinity.records_disk')` (env `INFINITY_RECORDS_DISK`): `s3`, если `FILESYSTEM_DISK=s3`, иначе приватный `local`.
- `app/Integrations/Infinity/Services/InfinityCallRecordService.php::download(recordLink, localPath): int` — `GET /api/admin/v1/callrecords/<rawurlencode>`, HTTP/1.1 + `stream`, JSON → `InfinityApiException`, тип не octet-stream/audio → ошибка, размер ≠ `Content-Length` → ошибка.
- `app/Jobs/Infinity/DownloadInfinityCallRecordJob.php`: очередь `default`, `ShouldBeUnique` по id звонка (`uniqueFor` 1 ч), `tries=1` — повтор делает синхронизация (каждые 5 мин, пока `record_attempts < 5`). Путь `infinity-records/Y/m/d/<era_id>.mp3` (дата звонка по Алматы). Сверка с `record_size`; временный файл удаляется всегда.
- `InfinityCallSynchronizer::queuePendingRecordDownloads()` вызывается в конце `sync()` по всей таблице; `InfinityCallSyncResult::$queuedDownloads`, вывод в команде.
- Тесты: `InfinityCallRecordServiceTest`, `DownloadInfinityCallRecordJobTest`, дополнен `InfinityCallSynchronizerTest` (`Queue::fake()` обязателен: локально `QUEUE_CONNECTION=sync`, а в БД реальные звонки с записями).
- Ограничение: после 5 неудач (≈25 мин недоступности Era) запись больше не ставится — сбросить `record_attempts` вручную. Конфиг воркеров в репо нет — проверить, что на KZ слушается очередь `default`.
- [ ] `app/Integrations/Infinity/Services/InfinityCallRecordService.php`:
  - `withToken`, **`withOptions(['version' => 1.1])`**, `timeout(120)`, `sink()`;
  - ошибка, если пришёл JSON или размер ≠ `Content-Length`.
- [ ] Job `app/Jobs/Infinity/DownloadInfinityCallRecordJob.php`:
  - `ShouldQueue`, `JobsQueueEnum::DEFAULT`, `tries`/`backoff`;
  - кладёт файл на `filesDisk()` по пути `infinity-records/Y/m/d/<basename>`;
  - сверяет с `record_size`;
  - при ошибке пишет `record_error` и увеличивает `record_attempts`.
- [ ] Синхронизация ставит задачи для `recorded && record_path is null && record_attempts < 5`.

### Шаг 4. Доступ и меню — ГОТОВО 30.09.2026 (миграция локально НЕ применена — применить в шаге 5 вместе с маршрутом)
- `User::canViewInfinityCalls()`: только KZ; администратор или `idperfil` 1–4. Экран проверяет именно это, а не permission (permission лишь показывает пункт меню).
- `PERMISSION_INFINITY_CALLS = 'infinity-calls-view'` в `app/Helpers/Autoload/constants.php`.
- Миграция `database/migrations/2026_09_30_200706_add_infinity_calls_to_menu.php`: только KZ, идемпотентна; пункт `menu.infinity_calls` в группе «Телефония» (ищется по `title='menu.telephony'`, локально id 15; нет группы → верх раздела 7), uri `config('app.url').'/admin/infinity/calls'`; permission ролям 1–4; сброс кэша по `admin_role_users`; `down()` удаляет созданное.
- У ролей 1–4 уже есть `telefonía` (проверено в локальной БД) — группа видна.
- Lang `menu.infinity_calls` только ru/en/es: в ar/hi/zh-CN нет и остальных пунктов телефонии (fallback en).
- Тесты: `tests/Unit/Models/User/UserInfinityCallsAccessTest.php`, `tests/Feature/Admin/AddInfinityCallsMenuMigrationTest.php`.
- [ ] `User::canViewInfinityCalls()`: администратор или `idperfil` в 1..4, плюс `isKazakhstan()`.
- [ ] Константа `PERMISSION_INFINITY_CALLS = 'infinity-calls-view'`.
- [ ] Миграция меню и permission для ролей [1,2,3,4], только KZ, по образцу promises; сброс кэша.
- [ ] Lang-ключи в `resources/lang/{ru,en,es}/menu.php`.

### Шаг 5. Экран — ГОТОВО 30.09.2026
- Маршруты `admin.infinity.calls.index` (`/admin/infinity/calls`) и `admin.infinity.calls.record` (`/{call}/record`, `?download=1`). Контроллер `app/Admin/Controllers/Infinity/InfinityCallController.php`: доступ по `canViewInfinityCalls()`; локальный диск → `response()->file()` (Range/206 для перемотки), S3 → редирект на `temporaryUrl` 10 мин. Middleware `admin.user.rights` в проекте отключён (`return $next` первой строкой) — доступ держат только контроллер и компонент.
- `app/Livewire/Infinity/CallRecords/IndexComponent.php` (проверка доступа в `boot()` — на каждый запрос), view `resources/views/livewire/infinity/call-records/index.blade.php` + `include/index/{filter,operators,table,totals,player,player-script}`.
- `app/Repositories/Collection/ReadInfinityCallRepository.php` (`collection_replica`), `app/Enums/Infinity/InfinityCallColumn.php` (таблица + CSV), `app/Services/Telephony/Infinity/InfinityCallCsvExporter.php`, DTO в `app/Services/Telephony/Infinity/DTO/`.
- Lang `views.infinity.calls.*` (ru/en/es). Миграция меню применена локально (пункт id 57).
- Тесты: `InfinityCallColumnTest`, `ReadInfinityCallRepositoryTest` (фикстуры через `collection_replica`, день 2030-01-15), `Livewire/Infinity/CallRecords/IndexComponentTest`, `Admin/InfinityCallControllerTest`.
- Проверено в браузере (Chrome, пользователь залогинился сам): меню, 830 звонков за 01.08–30.09, фильтры (success+01149 = 2, «Вчера» = 3 — совпадает с БД), flatpickr с секундами синхронизируется с быстрыми периодами, модалка операторов, подсветка строки, автопереход, громкость/зациклить, граф автоуровня, 206 от записи, MP3 декодируется (42,9 с = «Разговор 00:43»). Реальное звучание в автоматизированной вкладке не проверить: вкладка скрыта (`visibilityState=hidden`), Chrome не грузит медиа — нужна ручная проверка.
- [ ] Маршруты в `app/Admin/routes.php`, группа `infinity`:
  - `calls.index`;
  - `calls.record/{call}`: стрим MP3 через `Storage::disk(filesDisk())->response()` с проверкой доступа, режим скачивания.
- [ ] Контроллер `app/Admin/Controllers/Infinity/InfinityCallController.php` (обёртка `components.layouts.app`).
- [ ] Репозиторий `app/Repositories/Collection/ReadInfinityCallRepository.php`: `paginateFiltered`, `getTotals`, `cursorFiltered`, DTO фильтра.
- [ ] Livewire `app/Livewire/Infinity/CallRecords/IndexComponent.php`:
  - фильтры `#[Url]`: `dateFrom`/`dateTo` (flatpickr с `enableTime`, `enableSeconds`, `time_24hr`), `durationFrom`/`durationTo`, `operatorIds[]`, `operatorText`, `phone`, `result`;
  - быстрые периоды «Сегодня», «Вчера», «Неделя», «Месяц»;
  - Применить / Отменить / Обновить;
  - пагинация, итоги (count, суммы duration, wait, talk);
  - `exportCsv()`;
  - проверка доступа в каждом действии.
- [ ] Модалка операторов (Alpine): поиск пользователей с `dialer_extension_id` по `usuario`, `nombre` (ILIKE), номеру, дому.
- [ ] Таблица: дата, время, длительности, направление (иконка или метка), сторона отбоя, абоненты А/Б; строки без записи неактивны.
- [ ] Плеер (нижняя закреплённая панель):
  - play, pause, stop, в начало/назад, таймлайн `mm:ss / mm:ss`, громкость;
  - зациклить, автопереход к следующей строке с записью;
  - автоуровень (`DynamicsCompressorNode`), скачать.

### Шаг 6. Тесты (PHPUnit, `php artisan make:test`)
- [ ] `InfinityCallRecordServiceTest`, `Http::fake`: успех (audio), JSON-ошибка с кодом 200, несовпадение размера, Bearer.
- [ ] `InfinityCallSynchronizerTest`: мок источника, маппинг сторон, upsert без дублей, появление `recordLink` при повторе, `Queue::fake`.
- [ ] `DownloadInfinityCallRecordJobTest`, `Storage::fake`: путь, поля, ошибки.
- [ ] `IndexComponentTest`: фильтры, итоги, CSV, 403 для ролей 5 и 6, недоступность вне KZ.
- [ ] Тест маршрута записи: 403 без роли, стрим с ролью.
- [ ] Тест миграции меню по образцу `tests/Feature/Admin/EnsurePromisesAccessMigrationTest.php`.

### Шаг 7. Проверка
- [ ] `docker exec -i polaris-service-new php artisan test --compact --filter=InfinityCall` и тесты экрана.
- [ ] `docker exec -i polaris-service-new vendor/bin/pint --dirty`.
- [ ] Ручной прогон `infinity:sync-calls --from=2026-09-20` **только с разрешения пользователя** (реальные записи с ПДн). Сверить: число звонков и записей с агрегатами Era, размер MP3 = `recordSize`.
- [ ] Экран под ролью 1–4 и под ролью 5: меню, фильтры, итоги, CSV, воспроизведение, автопереход.
