Implement Discontinuity Index for Live Streaming Enhancements

Added a DiscontinuityIndex property to ScheduleEntry and related DTOs to track the cumulative number of discontinuities in live streaming. Updated the LiveWindowCalculator to utilize this index for generating accurate EXT-X-DISCONTINUITY-SEQUENCE values, ensuring compatibility with ffmpeg-based players. Enhanced the WriteEntriesAsync method to calculate and persist the discontinuity index during entry creation. Updated relevant tests and documentation to reflect these changes, improving the reliability of live streaming functionality.

.editorconfig

@@ -0,0 +1,22 @@
+# Базовые правила для редакторов — чтобы IDE не ставила свои отступы и концы строк до того, как
+# файл дойдёт до форматтера. Итоговый стиль всё равно задают csharpier (.config/dotnet-tools.json)
+# и Prettier (frontend/.prettierrc.json); значения здесь совпадают с их настройками намеренно —
+# оба читают .editorconfig, и расхождение развернуло бы форматирование в другую сторону.
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+max_line_length = 100
+
+[*.cs]
+indent_size = 4
+
+[*.md]
+# В markdown два пробела в конце строки — это перенос, обрезать их нельзя.
+trim_trailing_whitespace = false

.env.example

@@ -32,6 +32,9 @@ Storage__LiveWindowSegments=10
 Storage__KeepOriginals=false
 # Порог свободного места, ниже которого загрузка отклоняется (10 ГБ).
 Storage__MinFreeSpaceBytes=10737418240
+# Через сколько часов простоя убирать брошенное в uploads/ (след оборванной заливки или рестарта
+# посреди неё). Идущую загрузку не задевает — отсчёт от времени последней записи. 0 — не убирать.
+# Storage__StaleUploadHours=24
 # TTL stream-токена (cookie tw_stream), минуты. Короткий срок ограничивает окно доступа после
 # блокировки/логаута; фронт перевыпускает cookie, пока идёт просмотр. По умолчанию 30.
 # Storage__StreamTokenMinutes=30
@@ -63,6 +66,9 @@ Media__TranscodeThreads=3
 Media__MaxParallelTranscodes=1
 # Период опроса каталога inbox/ сканером, секунды.
 Media__InboxScanSeconds=15
+# Заводить фильм по файлу из inbox/, когда имя уверенно опознано в источнике метаданных.
+# Неуверенное совпадение остаётся человеку: файл станет ассетом без шоу и попадёт в разбор.
+Media__InboxAutoMovies=true
 # Нормализация громкости при обработке (EBU R128 loudnorm) — все ролики одинаковой громкости.
 Media__NormalizeLoudness=true
 # Целевая громкость, LUFS (−16 типично для стриминга; тише — уменьшить).
@@ -87,8 +93,11 @@ Media__LoudnessTargetLufs=-16
 # Bumpers__TemplateVersion=1
 
 # ── Метаданные шоу/серий (TMDb / OMDb) ─────────────────────────────────────
-# Ключи бесплатные: TMDb — themoviedb.org (Settings → API, v3 key), OMDb — omdbapi.com.
+# Ключи бесплатные: TMDb — themoviedb.org (Settings → API), OMDb — omdbapi.com.
 # Без ключа источник просто не показывается в админке (ручной режим работает всегда).
+# TMDb принимает оба вида учётных данных, различать их не нужно — подставляй что есть:
+#   «API Key (v3 auth)» — 32 hex-символа, уходит параметром api_key;
+#   «API Read Access Token (v4 auth)» — длинный JWT с точками, уходит заголовком Bearer.
 Metadata__Language=ru-RU
 Metadata__Tmdb__ApiKey=
 Metadata__Omdb__ApiKey=

.git-blame-ignore-revs

@@ -0,0 +1,15 @@
+# Коммиты, которые правили только оформление: перевод концов строк в LF и первые прогоны
+# csharpier/Prettier. Без этого списка `git blame` на половине файлов показывал бы их вместо
+# автора реальной правки.
+#
+# Включить локально (в .git/config, а не в репозитории — потому команду надо выполнить у себя):
+#   git config blame.ignoreRevsFile .git-blame-ignore-revs
+#
+# Добавлять сюда только чисто механические коммиты, полным SHA, по одному на строку:
+#   git rev-parse HEAD >> .git-blame-ignore-revs
+
+# Перевод дерева в LF.
+0442056367cb6cd3b38964dacf75f44f123e11ac
+
+# Первый прогон Prettier по фронтенду.
+0606ea3e6ee4a4fd7faf8d1b054a316633442e98

.gitattributes

@@ -0,0 +1,10 @@
+# Концы строк в репозитории — всегда LF. Бэкенд и так лежал в LF, фронтенд — в CRLF; Prettier
+# (endOfLine: lf по умолчанию) выровнял его, и этот файл не даёт разъехаться обратно: без него
+# при core.autocrlf=true у другого разработчика CRLF вернулись бы в коммит.
+* text=auto eol=lf
+
+# Бинарники не трогаем.
+*.png binary
+*.jpg binary
+*.ico binary
+*.woff2 binary

.gitea/workflows/ci.yml

@@ -21,6 +21,14 @@ jobs:
       - name: Restore
         working-directory: backend
         run: dotnet restore TeleWave.slnx
+      # Форматирование проверяем до сборки: падает за секунду и сразу показывает, что чинить.
+      # Версия csharpier прибита в .config/dotnet-tools.json — глобальная копия разработчика на CI
+      # не влияет, иначе её минорка переформатировала бы репозиторий в свой стиль.
+      - name: Format check
+        working-directory: backend
+        run: |
+          dotnet tool restore
+          dotnet csharpier check .
       # Строгая сборка: TreatWarningsAsErrors=true из Directory.Build.props не отключаем.
       - name: Build (Release)
         working-directory: backend
@@ -38,6 +46,9 @@ jobs:
       - name: Install
         working-directory: frontend
         run: pnpm install --frozen-lockfile
+      - name: Format check
+        working-directory: frontend
+        run: pnpm format:check
       - name: Lint
         working-directory: frontend
         run: pnpm lint
@@ -51,8 +62,6 @@ jobs:
   tests:
     runs-on: ubuntu-latest
     needs: [build-backend, build-frontend]
-    permissions:
-      contents: write
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-dotnet@v4
@@ -61,44 +70,16 @@ jobs:
       - name: Restore
         working-directory: backend
         run: dotnet restore TeleWave.slnx
-      - name: Test + coverage
+      # Покрытие здесь не собираем: его считает джоба sonar своим прогоном (в формате opencover),
+      # а бейдж покрытия в README берётся из SonarCloud.
+      - name: Test
         working-directory: backend
         run: >
           dotnet test TeleWave.slnx
           -c Release
           --no-restore
-          --collect:"XPlat Code Coverage"
-          --results-directory ./coverage
           --logger "console;verbosity=normal"
 
-      # Бейдж покрытия обновляем только для main (не для PR/форков): генерируем SVG и
-      # force-пушим в отдельную orphan-ветку badges — README ссылается на её raw-URL.
-      - name: Coverage badge
-        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-        working-directory: backend
-        env:
-          TOKEN: ${{ secrets.COVERAGE_TOKEN || secrets.GITEA_TOKEN }}
-        run: |
-          dotnet tool install --global dotnet-reportgenerator-globaltool
-          export PATH="$PATH:$HOME/.dotnet/tools"
-          reportgenerator \
-            "-reports:coverage/**/coverage.cobertura.xml" \
-            "-targetdir:coverage/badges" \
-            "-reporttypes:Badges" \
-            "-assemblyfilters:+TeleWave.Domain;+TeleWave.Application" \
-            "-classfilters:-System.*"
-          BADGE=coverage/badges/badge_linecoverage.svg
-          test -f "$BADGE" || { echo "badge not generated"; exit 1; }
-          WORK=$(mktemp -d)
-          cp "$BADGE" "$WORK/coverage.svg"
-          cd "$WORK"
-          git init -q -b badges
-          git add coverage.svg
-          git -c user.name=gitea-actions -c user.email=actions@local \
-            commit -q -m "coverage badge [skip ci]"
-          git push -f \
-            "https://gitea-actions:${TOKEN}@gitea.hsrv.site/mrleo1nid/TeleWave.git" badges
-
   # Анализ SonarCloud вместе с покрытием: один прогон собирает решение под сканером, гоняет тесты
   # и отправляет результат. Только push в main — декорация pull request'ов у SonarCloud завязана
   # на GitHub/GitLab, из Gitea она не работает, и анализ PR только засорял бы ветки в проекте.
@@ -145,7 +126,12 @@ jobs:
             /d:sonar.token="$SONAR_TOKEN" \
             /d:sonar.cs.opencover.reportsPaths="**/coverage/**/coverage.opencover.xml" \
             /d:sonar.exclusions="frontend/node_modules/**,frontend/dist/**,frontend/src/routeTree.gen.ts,backend/src/TeleWave.Infrastructure/Migrations/**" \
-            /d:sonar.coverage.exclusions="backend/src/TeleWave.Infrastructure/Migrations/**,frontend/**"
+            /d:sonar.coverage.exclusions="backend/src/TeleWave.Infrastructure/Migrations/**,frontend/**" \
+            /d:sonar.cpd.exclusions="frontend/src/shared/lib/locales/**"
+
+      # Локали исключены из поиска дублей намеренно: ru.ts и en.ts обязаны совпадать ключ в ключ —
+      # это не копипаста, а единственный способ не потерять перевод, и «устранение» такого дубля
+      # означало бы отказ от второго языка.
 
       # Сканер подмешивает в сборку свои анализаторы, а в проекте TreatWarningsAsErrors=true —
       # любое замечание Sonar роняло бы сборку вместо того, чтобы приехать в отчёт. Строгая
@@ -156,15 +142,22 @@ jobs:
 
       # Формат opencover, а не cobertura по умолчанию: C#-анализатор Sonar читает именно его.
       # Интеграционные тесты без Docker пропускаются сами (см. PostgresFixture).
+      #
+      # Проекты гоняются по одному, а не одним прогоном по решению: при общем прогоне сборщик
+      # покрытия теряет попадания — отчёт приезжает без модуля TeleWave.Application, и в Sonar
+      # покрытые тестами файлы выглядят нулевыми. Отчёты складываются в один каталог, сканер
+      # подбирает их маской.
       - name: Test + coverage
         if: env.SONAR_TOKEN != ''
-        run: >
+        run: |
-          dotnet test backend/TeleWave.slnx
+          for project in Domain Application Integration; do
-          -c Release
+            dotnet test "backend/tests/TeleWave.$project.Tests" \
-          --no-build
+              -c Release \
-          --collect:"XPlat Code Coverage;Format=opencover"
+              --no-build \
-          --results-directory backend/coverage
+              --collect:"XPlat Code Coverage;Format=opencover" \
+              --results-directory backend/coverage \
               --logger "console;verbosity=normal"
+          done
 
       - name: End analysis
         if: env.SONAR_TOKEN != ''

.gitignore

@@ -84,3 +84,8 @@ dist-ssr/
 # Отчёты покрытия (артефакт dotnet test / CI)
 coverage/
 TestResults/
+
+# ---> TeleWave
+# Отладочные дампы каналов: архивы кладёт сюда бэкенд (секция Debug:ExportDirectory).
+debug-exports/*
+!debug-exports/.gitkeep

CLAUDE.md

@@ -4,157 +4,125 @@
 
 ## Что это
 
-**TeleWave** — сервис онлайн-каналов: пользователи смотрят сетку каналов, видео отдаётся из
+**TeleWave** — сервис онлайн-каналов: зритель смотрит сетку каналов, видео отдаётся из хранилища
-хранилища на сервере. Админ управляет каналами и пользователями.
+на сервере. Админ ведёт библиотеку, каналы и эфир.
 
-> Текущее состояние — **рабочий вертикальный срез**: вход/регистрация, роли, пользователи, админка;
+Работает: аутентификация, роли, пользователи; библиотека шоу/серий, коллекции, жанры, метаданные
-> библиотека шоу/серий, загрузка и обработка медиа (ffmpeg → HLS-сегменты), реестр изображений,
+(TMDb/OMDb), обработка медиа (ffmpeg → HLS), изображения; группы, шаблон сетки, стыки и заставки,
-> метаданные (TMDb/OMDb), каталог каналов, планировщик эфира (реклама, ТВ-заставки-переходы,
+автосборка по профилям, обмен конфигурацией файлом и запросом к ИИ; генерация ленты, live-раздача,
-> weekly-override'ы) и live-раздача HLS с публичным просмотром сетки. Telegram-бот сознательно
+публичный просмотр, статистика хранилища. Telegram-бот расписания (подписки на оповещения по каналам, прокси, опрос или вебхук). Конвенции — зеркало
-> не делаем. Дальнейшие крупные направления (напр. многоэкземплярное развёртывание, новые доменные
+[`PnvPanel`](../PnvPanel) (тот же автор).
-> фичи) — по сверке с пользователем.
 
-Архитектура и код-конвенции — прямое зеркало [`D:\Github\PnvPanel`](../PnvPanel) (тот же автор,
+**Спеки в `docs/` — источник правды по домену**, читай до правок в подсистеме:
-тот же стек), но домен урезан под текущий объём фичи.
+[`tv-scheduler-architecture.md`](docs/tv-scheduler-architecture.md) (группы, сетка, слоты, стыки,
+заставки, планировщик, автосборка, обмен конфигурацией — главный документ),
+[`media-storage-and-streaming.md`](docs/media-storage-and-streaming.md) и
+[`server-storage-setup.md`](docs/server-storage-setup.md) (медиа и хранилище).
 
 ## Стек
 
-- **Backend**: C# / .NET 10, ASP.NET Core Web API (Minimal API), Clean Architecture, CQRS через
+- **Backend**: C# / .NET 10, ASP.NET Core Minimal API, Clean Architecture, CQRS через
-  [`LiteCqrs.Net`](https://github.com/mrleo1nid/LiteCqrs.Net) (NuGet-пакет, лёгкая
+  [`LiteCqrs.Net`](https://github.com/mrleo1nid/LiteCqrs.Net) (лёгкая альтернатива MediatR с явным
-  CQRS-библиотека, альтернатива MediatR с явным разделением Command/Query — см. её README).
+  разделением Command/Query — см. README). EF Core 10 + Npgsql, Identity + JWT, FluentValidation,
-  EF Core 10 + Npgsql, ASP.NET Core Identity + JWT (access + refresh), FluentValidation, Serilog.
+  Serilog, маппинг DTO вручную, OpenAPI + Scalar UI, тесты на xUnit + NSubstitute.
-  Маппинг DTO вручную. OpenAPI — нативный `Microsoft.AspNetCore.OpenApi` + Scalar UI.
+- **Frontend**: React 19 + Vite + TS, TanStack Query/Router (файловые роуты, `routeTree.gen.ts`
-- **Frontend**: React 19 + Vite + TS, TanStack Query/Router, shadcn-стиль поверх Radix + Tailwind
+  генерируется сборкой), shadcn поверх Radix + Tailwind v4, Zustand (только auth+тема),
-  v4, Zustand (только auth+тема), react-hook-form + zod. pnpm, oxlint.
+  react-hook-form + zod, i18n (ru/en), pnpm + oxlint + prettier.
-- **Инфра**: единый Docker-образ (API + статика SPA); PostgreSQL — **внешний сервер**, не в
-  compose (в отличие от PnvPanel).
 
 ## Архитектура — жёсткие правила
 
-Слои и направление зависимостей: **Api → Infrastructure → Application → Domain** (внутрь).
+Зависимости строго внутрь: **Api → Infrastructure → Application → Domain**.
 
-- **Domain** — без внешних зависимостей. Сейчас единственная сущность — `Auth/RefreshToken`
+- **Domain** — без внешних зависимостей: `Auth`, `Library` (шоу, серии, коллекции, жанры), `Media`,
-  (rich model: приватные сеттеры, фабричный `Issue(...)`, поведенческий `Revoke(...)`).
+  `Images`, `Programming` (группы, сетка, слоты, стыки + **чистый планировщик** `Planning`),
-- **Application** — CQRS-хендлеры, DTO, валидаторы, **порты** (интерфейсы:
+  `Broadcast` (каналы, заставки, лента, live), `Settings`. Модель rich: приватные сеттеры,
-  `IAppDbContext`, `ICurrentUser`, `IIdentityService`, `IJwtTokenService`, `IRefreshTokenService`,
+  фабрики `Create`, поведенческие методы.
-  `IRoleService`). Зависит только от Domain — никаких `Npgsql`/`AspNetCore.Identity`, только их
+- **Application** — CQRS-хендлеры, DTO, валидаторы и **порты** (`Common/Interfaces/I*.cs`:
-  абстракции.
+  `IAppDbContext`, `ICurrentUser`, `IMediaProcessor`, `IMediaStorage`, `IBumperRenderer`,
+  `IMetadataProvider`, `IImageStore`, `IStorageInspector`, …). Зависит только от Domain: никаких
+  `Npgsql`/`AspNetCore.Identity`, лишь их абстракции.
 - **Infrastructure** — реализации портов: EF Core (`AppDbContext : IdentityDbContext<AppUser,
-  AppRole, Guid>`), `IdentityService`/`RoleService`/`JwtTokenService`/`RefreshTokenService`,
+  AppRole, Guid>`, конфигурации в `Persistence/Configurations`), ffmpeg, хранилище, метаданные,
-  идемпотентный `DbInitializer` (сидинг ролей + админа).
+  идемпотентный `DbInitializer` (роли + админ из env `AdminSeed__*`).
-- **Api** — Minimal API эндпоинты (`Endpoints/*Endpoints.cs`), middleware, DI composition root
+- **Api** — Minimal API (`Endpoints/*Endpoints.cs`), middleware, DI composition root (`Program.cs`).
-  (`Program.cs`).
 
 Обязательно:
 - Команды меняют состояние в транзакции (`UnitOfWorkBehavior`); запросы только читают. Диспетчер —
-  из `LiteCqrs.Net` (`ISender`/`ICommandHandler`/`IQueryHandler`), регистрация через
+  `ISender`/`ICommandHandler`/`IQueryHandler`, регистрация в `Application/DependencyInjection.cs`.
-  `AddLiteCqrs(...)` в `TeleWave.Application/DependencyInjection.cs`.
+- Управляемые ошибки — через `Result<T>` (`Common/Models/Result.cs`), не исключениями. Валидация —
-- Управляемые ошибки — через `Result<T>` (`Common/Models/Result.cs`), не исключениями.
+  FluentValidation через `ValidationBehavior`; хендлер не перепроверяет формат ввода.
-- Валидация — FluentValidation через `ValidationBehavior`; хендлер не перепроверяет формат ввода.
+- Всё I/O асинхронно, `CancellationToken` пробрасывается до EF/HTTP; никаких `.Result`/`.Wait()`.
-- Всё I/O асинхронно, `CancellationToken` пробрасывается до EF/HTTP. Никаких `.Result`/`.Wait()`.
+  Nullable включён, `TreatWarningsAsErrors=true` — предупреждения анализаторов не игнорировать.
-- Nullable reference types включены; `Directory.Build.props` включает
+- Планировщик (`Domain/Programming/Planning`) — **чистая функция**: вход `PlanningInput`, никаких
-  `TreatWarningsAsErrors=true` — предупреждения анализаторов не игнорировать.
+  запросов и часов внутри. Данные под него собирает `Application/Programming/Planning`.
 
-## Домен: роли, пользователи, аутентификация
+## Инварианты, которые легко нарушить
 
-Полноценной доменной модели (каналы/видео) пока нет — см. заметку в начале файла. Текущие
+- **Роли** динамические, у пользователя ровно одна; системные `admin`/`user` (`IsSystem=true`) не
-инварианты:
+  переименовать и не удалить, последнего админа не разжаловать, себя не заблокировать и не удалить.
-
+- **Регистрация открытая** (создаётся `user`, токены сразу); понадобится модерация — заводи отдельный
-- **Роли** (`AppRole : IdentityRole<Guid>`, `Infrastructure/Identity/`) — динамические,
+  флаг, не переиспользуй `IsBlocked`. Вход по `UserName`, email и SMTP не используются; JWT access +
-  без квот (в отличие от PnvPanel: тут нет `MaxIpLimit`/`BillingEnabled` — при появлении
+  refresh в httpOnly `tw_refresh_token` с обнаружением повторного использования отозванного.
-  доменных фич квоты/лимиты добавляются на `AppRole`/`AppUser` по мере необходимости, не заранее).
+- **Правка сетки эфир не двигает**: команда поднимает ревизию шаблона, ленту пересобирает применение.
-  У пользователя ровно одна роль. Системные роли `admin`/`user` (`IsSystem=true`) нельзя
+- **Вещательные сутки** начинаются с `Channel.DayStartTime` (06:00), сетка задаётся во времени
-  переименовать/удалить — проверяется в `RoleService`. Смену роли (`ChangeUserRoleCommand`)
+  канала (`UtcOffsetMinutes`), в базе всё в UTC.
-  запрещено делать так, чтобы не осталось ни одного `admin` (`RoleErrors.CannotRemoveLastAdmin`).
-- **Регистрация** — открытая, без гейта активации (в отличие от PnvPanel): `RegisterCommandHandler`
-  создаёт пользователя с ролью `user` и сразу выдаёт токены (auto-login). Если в будущем
-  понадобится модерация новых пользователей — добавлять отдельным полем/флагом по аналогии с
-  `IsActivated` в PnvPanel, не переиспользовать `IsBlocked`.
-- **Блокировка** (`AppUser.IsBlocked`) — админ блокирует/разблокирует пользователя; вход
-  запрещён (`LoginCommandHandler`/`RefreshCommandHandler` проверяют флаг). Админ не может
-  заблокировать/удалить самого себя (`UserErrors.CannotBlockSelf`/`CannotDeleteSelf`).
-- **Вход по `UserName`** (email не используется, SMTP не нужен). JWT — access (короткий TTL) +
-  refresh (httpOnly cookie `tw_refresh_token`, `SameSite=Strict`, ротация с обнаружением повторного
-  использования отозванного токена — см. `RefreshTokenService.RotateAsync`).
-- **Сидинг**: идемпотентный `DbInitializer` создаёт системные роли + админа из env
-  (`AdminSeed__Username`/`Password`) при старте. Источник примера env — `.env.example`.
 
 ## Единый контейнер
 
-- Один образ: Api раздаёт REST (`/api`) и статику SPA из `wwwroot` (fallback на `index.html`).
+- Один образ: Api раздаёт REST (`/api`) и статику SPA из `wwwroot` (fallback на `index.html`), один
-  Один origin, база API — относительный `/api`.
+  origin, база API — относительный `/api`. Multi-stage Dockerfile: node → dotnet sdk → aspnet.
-- Multi-stage Dockerfile: node (фронт) → dotnet sdk (publish + копирование в `wwwroot`) → aspnet
+  Отдельный nginx для статики не вводить — ломает требование единого контейнера.
-  runtime. Контейнер работает под непривилегированным пользователем образа (`USER $APP_UID`,
+- Работает под непривилегированным `USER $APP_UID` (uid/gid 1654) **статически**, без
-  uid/gid 1654) — но **статически**, без gosu/entrypoint-скриптов и подгонки uid на старте: права
+  gosu/entrypoint: права на bind-mount выставляет оператор (`docs/server-storage-setup.md` § 5).
-  на bind-mount хранилища выставляет оператор на хосте (см. `docs/server-storage-setup.md` § 5).
+  Data Protection не заводим — шифруемых секретов на диске нет. **TLS внешний**: `app` отдаёт HTTP
-  Data Protection key-ring не заводим — секретов на диске пока нет (JWT-ключ — обычная конфигурация,
+  и доверяет `X-Forwarded-*`.
-  не шифруемый секрет at-rest); появятся зашифрованные данные (например API-ключи внешних
+- docker-compose: только `app`. PostgreSQL внешний (`ConnectionStrings__Default` из `.env`), база
-  сервисов) — добавлять Data Protection по образцу PnvPanel.
+  и пользователь создаются заранее вручную; миграции применяются на старте (`ApplyMigrationsAsync`),
-- docker-compose: только `app` — PostgreSQL живёт вне compose (внешний сервер/хост, адрес и
+  прав `CREATEDB` не нужно.
-  креды — в `ConnectionStrings__Default` из `.env`; база и пользователь на нём создаются
-  заранее вручную, приложение их не сидит). Миграции применяются авто на старте
-  (`ApplyMigrationsAsync` в `Program.cs`) — прав `CREATEDB` не требуется, только DDL/DML в
-  уже существующей базе.
-- Не вводи отдельный nginx-контейнер для статики — ломает требование единого контейнера.
-- **TLS — внешний**; `app` отдаёт HTTP + доверяет `X-Forwarded-*` (`ForwardedHeaders`).
 
 ## Соглашения по коду
 
-- `<Verb><Noun>Command`/`<Get|List><Noun>Query` + `Handler`/`Validator` (валидатор — где есть что
+- `<Verb><Noun>Command`/`<Get|List><Noun>Query` + `Handler`/`Validator` (где есть что проверить),
-  проверить). Папки — по фичам (`Auth/Login/`, `Admin/Roles/CreateRole/`, ...).
+  папки по фичам (`Auth/Login/`, `Programming/Templates/Generate/`, …). Один публичный тип на файл =
-- DTO — суффикс `Dto`; тела запросов Api-эндпоинтов, не совпадающие с командой 1:1, — `Body`
+  имя файла, кроме `Body` — тела Api-эндпоинтов, не совпадающие с командой 1:1 (`sealed record`
-  (`sealed record` внизу файла эндпоинта).
+  внизу файла эндпоинта). DTO — суффикс `Dto`.
-- Один публичный тип на файл = имя файла (кроме `Body` в файле эндпоинтов).
+- Ошибки — каталоги `XErrors` (`Error.Validation/NotFound/Conflict/…`), наружу единым
-- Ошибки — статические каталоги `XErrors` (`AuthErrors`, `RoleErrors`, `UserErrors`) с
+  `application/problem+json` (`Api/Common/ResultExtensions.cs`). Секреты не логировать.
-  `Error.Validation/NotFound/Conflict/Unauthorized/Forbidden(...)`.
+- **Изображения — только через реестр `Image`** (`Domain/Images`, галерея `features/admin/images`):
-- Секреты не логировать; логи — Serilog.
+  картинка хранится как `ImageId` и выбирается контролом `ImageGallery`/`GalleryBrowser`, своих
-- Ошибки API — единый `application/problem+json` (см. `Api/Common/ResultExtensions.cs`).
+  файловых полей не заводить. Файлы — `images/{id}{ext}`, отдаются по `/api/images/{id}`.
-- **Изображения — через общий реестр `Image`** (домен `Domain/Images`, галерея `features/admin/images`).
+- Фронт: фича = папка в `src/features/admin/<фича>`; тексты только через i18n, ключи в `ru.ts` и `en.ts`.
-  Любой новый функционал, где загружается или выбирается картинка, должен использовать контрол
+- Комментарии объясняют **почему**, а не что; по-русски, как в существующем коде.
-  `ImageGallery`/`GalleryBrowser` (пикер по категориям `ImageCategory`) и хранить ссылку на `ImageId`,
-  а не заводить своё файловое поле. Автоматически полученные картинки (например постер из метадаты)
-  тоже регистрируются как `Image`. Файлы лежат под `images/{id}{ext}`, отдаются по `/api/images/{id}`.
 
 ## Команды
 
 Backend (из `backend/`):
 ```bash
 dotnet build
-# Форматирование — csharpier, версия закреплена в .config/dotnet-tools.json (один раз: dotnet tool restore).
+dotnet csharpier format .   # только через dotnet (версия из .config/); в CI — csharpier check
-# Глобально установленный csharpier может быть другой версии — вызывать только через dotnet:
+dotnet test tests/TeleWave.Domain.Tests        # по одному проекту: MSBuild не берёт несколько
-dotnet csharpier format .
-dotnet csharpier check .
-# Юнит-тесты (по одному проекту за вызов — MSBuild не принимает несколько):
-dotnet test tests/TeleWave.Domain.Tests
 dotnet test tests/TeleWave.Application.Tests
-# Интеграционные тесты (Testcontainers-Postgres) — нужен запущенный Docker; без него пропускаются:
+dotnet test tests/TeleWave.Integration.Tests   # Testcontainers; без Docker пропускаются
-dotnet test tests/TeleWave.Integration.Tests
 dotnet run --project src/TeleWave.Api
 dotnet ef migrations add <Name> --project src/TeleWave.Infrastructure --startup-project src/TeleWave.Api
-dotnet ef database update --project src/TeleWave.Infrastructure --startup-project src/TeleWave.Api
 ```
 
 Frontend (из `frontend/`):
 ```bash
-pnpm install
+pnpm install && pnpm dev
-pnpm dev
+pnpm lint && pnpm typecheck && pnpm build
-pnpm build
+pnpm format && pnpm format:check   # CI падает на неотформатированном — прогоняй после правок
-pnpm lint && pnpm typecheck
 ```
 
-Инфраструктура:
+Инфраструктура: `docker compose up -d --build` (только api; postgres внешний). Окружение — Windows,
-```bash
+оболочка **PowerShell**; для POSIX-скриптов есть Bash-инструмент.
-docker compose up -d --build   # только api; postgres — внешний, см. ConnectionStrings__Default
-```
-
-> Окружение: Windows, основная оболочка — **PowerShell**. Для POSIX-скриптов есть Bash-инструмент.
 
 ## Рабочие принципы
 
-- Базовый вертикальный срез (каналы, планировщик, раздача HLS, обработка медиа) уже реализован —
+- Базовый срез реализован — правь по месту. Новые крупные направления с непринятыми решениями
-  правь его по месту. Но новые крупные направления с непринятыми архитектурными решениями (напр.
+  (многоэкземплярность, транскод-профили, подсистемы) — после сверки; неоднозначность — вопрос.
-  многоэкземплярное развёртывание, транскод-профили, новые доменные подсистемы) начинай только после
+- Меняешь поведение подсистемы — обнови её спеку в `docs/` тем же заходом.
-  сверки с пользователем. При неоднозначности — вопрос пользователю, не предположение.
+- Соблюдай границы слоёв — главный инвариант проекта.
-- Соблюдай границы слоёв — главный инвариант проекта, как и в PnvPanel.
+- Правь файлы через Edit/Write: пользователь видит дифф, а harness не даст перезаписать файл вслепую.
-- Не коммить и не пуши без явной просьбы.
+  Скриптом на python — только при крайней необходимости (массовая механическая замена), и сказать явно.
-- Отвечай пользователю на русском.
+- Не коммить и не пуши без явной просьбы; отвечай пользователю на русском.

Dockerfile

@@ -4,7 +4,9 @@
 FROM node:22-alpine AS frontend
 WORKDIR /app/frontend
 RUN corepack enable
-COPY frontend/package.json frontend/pnpm-lock.yaml ./
+# pnpm-workspace.yaml здесь не про воркспейсы: в pnpm 11 там живут overrides, и без него
+# --frozen-lockfile падает на несовпадении конфигурации с локом.
+COPY frontend/package.json frontend/pnpm-lock.yaml frontend/pnpm-workspace.yaml ./
 # --ignore-scripts: ни один пакет фронта не требует postinstall, поэтому lifecycle-скрипты зависимостей
 # в сборке не выполняются — компрометация любого пакета в дереве не даёт исполнения кода на этапе install.
 RUN corepack prepare pnpm@11.9.0 --activate && pnpm install --frozen-lockfile --ignore-scripts

README.md

@@ -1,8 +1,12 @@
 # TeleWave
 
 [![ci](https://gitea.hsrv.site/mrleo1nid/TeleWave/actions/workflows/ci.yml/badge.svg)](https://gitea.hsrv.site/mrleo1nid/TeleWave/actions?workflow=ci.yml)
-[![coverage](https://gitea.hsrv.site/mrleo1nid/TeleWave/raw/branch/badges/coverage.svg)](https://gitea.hsrv.site/mrleo1nid/TeleWave/actions?workflow=ci.yml)
+[![quality gate](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=alert_status&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
-[![quality gate](https://sonarcloud.io/api/project_badges/quality_gate?project=mrleo1nid_telewave&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=coverage&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
+[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=bugs&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
+[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=code_smells&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
+[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=security_rating&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
+[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=mrleo1nid_telewave&metric=sqale_rating&token=fa38966b51f0043827fa89a5e42a0afe20180758)](https://sonarcloud.io/summary/new_code?id=mrleo1nid_telewave)
 
 **TeleWave** — сервис онлайн-каналов: пользователи смотрят сетку каналов, видео отдаётся из
 хранилища на сервере, админ управляет каналами и пользователями.

backend/src/TeleWave.Api/Endpoints/BumperEndpoints.cs

@@ -1,35 +1,88 @@
 using System.Text;
 using LiteCqrs;
 using TeleWave.Api.Common;
-using TeleWave.Application.Broadcast;
 using TeleWave.Application.Broadcast.Bumpers;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Domain.Broadcast;
+using TeleWave.Infrastructure.Identity;
 using TeleWave.Infrastructure.Media;
 
 namespace TeleWave.Api.Endpoints;
 
-/// <summary>Эндпоинты ТВ-заставок канала: блоки (стиль/аудио/фон), подблоки и рендер превью.</summary>
+/// <summary>
-public static partial class ChannelEndpoints
+/// Блоки ТВ-заставок: оформление, звук, подблоки с текстом и рендер превью. Блоки общие для всех
+/// каналов, поэтому и раздел свой, не канальный — канал только ссылается на них врезками стыков.
+/// </summary>
+public static class BumperEndpoints
 {
-    private static async Task<IResult> AddBumperTemplate(
+    public static IEndpointRouteBuilder MapBumperEndpoints(this IEndpointRouteBuilder app)
-        Guid id,
+    {
-        AddBumperTemplateBody body,
+        var admin = app.MapGroup("/api/admin/bumpers")
+            .WithTags("Admin.Bumpers")
+            .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin));
+
+        admin.MapGet("", List).Produces<IReadOnlyList<BumperTemplateDto>>();
+        admin.MapPost("", Create).Produces<CreatedIdResponse>(StatusCodes.Status201Created);
+        admin.MapPut("/{templateId:guid}", Update).Produces(StatusCodes.Status204NoContent);
+        admin.MapDelete("/{templateId:guid}", Delete).Produces(StatusCodes.Status204NoContent);
+
+        admin
+            .MapPut("/{templateId:guid}/audio", UploadAudio)
+            .Produces(StatusCodes.Status204NoContent);
+        admin
+            .MapDelete("/{templateId:guid}/audio", ClearAudio)
+            .Produces(StatusCodes.Status204NoContent);
+        admin
+            .MapPut("/{templateId:guid}/background", SetBackground)
+            .Produces(StatusCodes.Status204NoContent);
+        admin
+            .MapDelete("/{templateId:guid}/background", ClearBackground)
+            .Produces(StatusCodes.Status204NoContent);
+
+        admin
+            .MapPost("/{templateId:guid}/variants", AddVariant)
+            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
+        admin
+            .MapPut("/{templateId:guid}/variants/{variantId:guid}", UpdateVariant)
+            .Produces(StatusCodes.Status204NoContent);
+        admin
+            .MapDelete("/{templateId:guid}/variants/{variantId:guid}", RemoveVariant)
+            .Produces(StatusCodes.Status204NoContent);
+
+        admin
+            .MapPost("/{templateId:guid}/preview", RenderPreview)
+            .Produces(StatusCodes.Status204NoContent);
+        admin.MapGet("/{templateId:guid}/preview/{variantId:guid}/index.m3u8", PreviewPlaylist);
+        admin.MapGet("/{templateId:guid}/preview/{variantId:guid}/{file}", PreviewSegment);
+
+        return app;
+    }
+
+    private static async Task<IResult> List(ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new ListBumperTemplatesQuery(), cancellationToken);
+        return Results.Ok(result);
+    }
+
+    private static async Task<IResult> Create(
+        BumperNameBody body,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new AddBumperTemplateCommand(id, body.Name),
+            new CreateBumperTemplateCommand(body.Name),
             cancellationToken
         );
         return result.IsSuccess
-            ? Results.Created($"/api/admin/channels/{id}", new CreatedIdResponse(result.Value))
+            ? Results.Created(
+                $"/api/admin/bumpers/{result.Value}",
+                new CreatedIdResponse(result.Value)
+            )
             : result.ToHttpResult();
     }
 
-    private static async Task<IResult> UpdateBumperTemplate(
+    private static async Task<IResult> Update(
-        Guid id,
         Guid templateId,
         UpdateBumperTemplateBody body,
         ISender sender,
@@ -38,35 +91,37 @@ public static partial class ChannelEndpoints
     {
         var result = await sender.Send(
             new UpdateBumperTemplateCommand(
-                id,
                 templateId,
+                new BumperStyle(
                     body.Name,
+                    body.Font,
                     body.BackgroundColor,
                     body.BackgroundColor2,
                     body.AccentColor,
                     body.TextColor
+                )
             ),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> RemoveBumperTemplate(
+    private static async Task<IResult> Delete(
-        Guid id,
         Guid templateId,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new RemoveBumperTemplateCommand(id, templateId),
+            new DeleteBumperTemplateCommand(templateId),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> UploadTemplateAudio(
+    private static async Task<IResult> UploadAudio(
-        [AsParameters] BumperAudioUpload upload,
+        Guid templateId,
+        string fileName,
         HttpRequest request,
         IBumperTemplateStorage storage,
         IAudioProbe probe,
@@ -74,124 +129,101 @@ public static partial class ChannelEndpoints
         CancellationToken cancellationToken
     )
     {
-        if (
+        if (ResolveExtension(fileName, request) is not { } ext)
-            ResolveBumperExtension(upload.FileName, request, BumperFiles.AudioExtensions)
+            return BumperErrors.InvalidFile.ToProblem();
-            is not { } ext
-        )
-            return ChannelErrors.InvalidBumperFile.ToProblem();
 
-        await storage.SaveAudioAsync(upload.TemplateId, ext, request.Body, cancellationToken);
+        await storage.SaveAudioAsync(templateId, ext, request.Body, cancellationToken);
 
         // Длина заставки идёт по длине звука — замеряем ffprobe (при неудаче 0 → дефолтная длина).
-        var path = storage.AudioPath(upload.TemplateId, ext);
+        var path = storage.AudioPath(templateId, ext);
         var duration = path is null
             ? null
             : await probe.TryGetDurationAsync(path, cancellationToken);
 
         var result = await sender.Send(
-            new SetBumperTemplateAudioCommand(
+            new SetBumperTemplateAudioCommand(templateId, ext, duration?.TotalSeconds ?? 0),
-                upload.Id,
-                upload.TemplateId,
-                ext,
-                duration?.TotalSeconds ?? 0
-            ),
             cancellationToken
         );
         if (!result.IsSuccess)
-            await storage.DeleteAudioAsync(upload.TemplateId, cancellationToken);
+            await storage.DeleteAudioAsync(templateId, cancellationToken);
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> ClearTemplateAudio(
+    private static async Task<IResult> ClearAudio(
-        Guid id,
         Guid templateId,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new ClearBumperTemplateAudioCommand(id, templateId),
+            new ClearBumperTemplateAudioCommand(templateId),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> SetTemplateBackground(
+    private static async Task<IResult> SetBackground(
-        Guid id,
         Guid templateId,
-        SetBumperTemplateBackgroundBody body,
+        SetBumperBackgroundBody body,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new SetBumperTemplateBackgroundCommand(id, templateId, body.ImageId),
+            new SetBumperTemplateBackgroundCommand(templateId, body.ImageId),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> ClearTemplateBackground(
+    private static async Task<IResult> ClearBackground(
-        Guid id,
         Guid templateId,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new ClearBumperTemplateBackgroundCommand(id, templateId),
+            new ClearBumperTemplateBackgroundCommand(templateId),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> AddBumperVariant(
+    private static async Task<IResult> AddVariant(
-        Guid id,
         Guid templateId,
-        AddBumperVariantBody body,
+        BumperNameBody body,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new AddBumperTextVariantCommand(id, templateId, body.Name),
+            new AddBumperVariantCommand(templateId, body.Name),
             cancellationToken
         );
         return result.IsSuccess
-            ? Results.Created($"/api/admin/channels/{id}", new CreatedIdResponse(result.Value))
+            ? Results.Created(
+                $"/api/admin/bumpers/{templateId}",
+                new CreatedIdResponse(result.Value)
+            )
             : result.ToHttpResult();
     }
 
-    private static async Task<IResult> UpdateBumperVariant(
+    private static async Task<IResult> UpdateVariant(
-        Guid id,
         Guid templateId,
         Guid variantId,
-        UpdateBumperVariantBody body,
+        BumperVariantInput input,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new UpdateBumperTextVariantCommand(
+            new UpdateBumperVariantCommand(templateId, variantId, input),
-                id,
-                templateId,
-                variantId,
-                body.Name,
-                body.Kind,
-                body.NowLabel,
-                body.NextLabel,
-                body.Line1,
-                body.Line2,
-                body.Trigger,
-                body.Weight
-            ),
             cancellationToken
         );
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> RemoveBumperVariant(
+    private static async Task<IResult> RemoveVariant(
-        Guid id,
         Guid templateId,
         Guid variantId,
         ISender sender,
@@ -199,7 +231,7 @@ public static partial class ChannelEndpoints
     )
     {
         var result = await sender.Send(
-            new RemoveBumperTextVariantCommand(id, templateId, variantId),
+            new RemoveBumperVariantCommand(templateId, variantId),
             cancellationToken
         );
         return result.ToHttpResult();
@@ -207,33 +239,27 @@ public static partial class ChannelEndpoints
 
     /// <summary>Синхронно рендерит пример заставки блока (несколько секунд ffmpeg).</summary>
     private static async Task<IResult> RenderPreview(
-        Guid id,
         Guid templateId,
+        Guid? channelId,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new RenderBumperPreviewCommand(id, templateId),
+            new RenderBumperPreviewCommand(templateId, channelId),
             cancellationToken
         );
         return result.IsSuccess ? Results.NoContent() : result.ToHttpResult();
     }
 
     /// <summary>Плейлист превью подблока: переписываем ffmpeg-index.m3u8, направляя сегменты на admin-роут.</summary>
-    private static IResult PreviewPlaylist(
+    private static IResult PreviewPlaylist(Guid templateId, Guid variantId, MediaPathResolver paths)
-        Guid id,
-        Guid templateId,
-        Guid variantId,
-        MediaPathResolver paths
-    )
     {
         var previewId = BumperPreview.AssetId(variantId);
         if (SegmentFiles.TryResolveExisting(paths, previewId, "index.m3u8") is not { } indexPath)
             return Results.NotFound();
 
-        var baseUrl =
+        var baseUrl = $"/api/admin/bumpers/{templateId}/preview/{variantId}/";
-            $"/api/admin/channels/{id}/bumper/templates/{templateId}/preview/{variantId}/";
         var sb = new StringBuilder();
         foreach (var line in File.ReadLines(indexPath))
         {
@@ -249,9 +275,8 @@ public static partial class ChannelEndpoints
     }
 
     /// <summary>
-    /// Сегмент превью. Канал и блок в маршруте есть, но хендлеру не нужны: каталог превью
+    /// Сегмент превью. Блок в маршруте есть, но хендлеру не нужен: каталог превью адресуется
-    /// адресуется подблоком (см. BumperPreview.AssetId), поэтому в сигнатуре их нет — незаявленные
+    /// подблоком (см. <see cref="BumperPreview.AssetId"/>) — незаявленные параметры не связываются.
-    /// параметры маршрута просто не связываются.
     /// </summary>
     private static IResult PreviewSegment(Guid variantId, string file, MediaPathResolver paths)
     {
@@ -267,50 +292,27 @@ public static partial class ChannelEndpoints
 
     /// <summary>Проверяет расширение файла (по allowlist) и размер (Content-Length). Возвращает
     /// нормализованное расширение (с точкой, нижний регистр) или null при отказе.</summary>
-    private static string? ResolveBumperExtension(
+    private static string? ResolveExtension(string fileName, HttpRequest request)
-        string fileName,
-        HttpRequest request,
-        IReadOnlySet<string> allowedExtensions
-    )
     {
         if (request.ContentLength is > BumperFiles.MaxBytes or 0 or null)
             return null;
         var ext = Path.GetExtension(fileName).ToLowerInvariant();
-        return allowedExtensions.Contains(ext) ? ext : null;
+        return BumperFiles.AudioExtensions.Contains(ext) ? ext : null;
     }
 }
 
-public sealed record AddBumperTemplateBody(string Name);
+public sealed record BumperNameBody(string Name);
 
 public sealed record UpdateBumperTemplateBody(
     string Name,
+    BumperFont Font,
     string BackgroundColor,
     string BackgroundColor2,
     string AccentColor,
     string TextColor
 );
 
-public sealed record SetBumperTemplateBackgroundBody(Guid ImageId);
+public sealed record SetBumperBackgroundBody(Guid ImageId);
-
-public sealed record AddBumperVariantBody(string Name);
-
-public sealed record UpdateBumperVariantBody(
-    string Name,
-    BumperTextKind Kind,
-    string NowLabel,
-    string NextLabel,
-    string Line1,
-    string Line2,
-    BumperTrigger Trigger,
-    int Weight
-);
-
-/// <summary>
-/// Адрес загружаемого звука: канал и блок из маршрута плюс имя исходного файла из query (по нему
-/// проверяется расширение). Свёрнуто в один параметр — кроме него хендлеру нужны ещё запрос, два
-/// сервиса, диспетчер и токен отмены, и плоским списком сигнатура перестаёт читаться.
-/// </summary>
-public sealed record BumperAudioUpload(Guid Id, Guid TemplateId, string FileName);
 
 /// <summary>Ограничения на загружаемый звук блока заставки (фон-картинка — через общий реестр).</summary>
 internal static class BumperFiles

backend/src/TeleWave.Api/Endpoints/ChannelEndpoints.cs

@@ -8,6 +8,7 @@ using TeleWave.Application.Broadcast.ListChannels;
 using TeleWave.Application.Broadcast.UpdateChannelSettings;
 using TeleWave.Application.Broadcast.UpdateChannelTime;
 using TeleWave.Application.Broadcast.UpdateViewerSettings;
+using TeleWave.Application.Programming.Planning.DebugExport;
 using TeleWave.Application.Programming.Planning.Trace;
 using TeleWave.Domain.Broadcast;
 using TeleWave.Infrastructure.Identity;
@@ -15,11 +16,11 @@ using TeleWave.Infrastructure.Identity;
 namespace TeleWave.Api.Endpoints;
 
 /// <summary>
-/// Админ-эндпоинты канала: создание, список, настройки, время и чтение расписания. Заставки —
+/// Админ-эндпоинты канала: создание, список, настройки, время и чтение расписания. Заставки
-/// в <c>ChannelEndpoints.Bumpers.cs</c>. Что и когда идёт в эфире, задаёт шаблон сетки
+/// и стыки общие для всех каналов и живут своими разделами (<c>BumperEndpoints</c>,
-/// (<c>TemplateEndpoints</c>).
+/// <c>JunctionEndpoints</c>); что и когда идёт в эфире, задаёт шаблон сетки (<c>TemplateEndpoints</c>).
 /// </summary>
-public static partial class ChannelEndpoints
+public static class ChannelEndpoints
 {
     public static IEndpointRouteBuilder MapChannelEndpoints(this IEndpointRouteBuilder app)
     {
@@ -35,62 +36,6 @@ public static partial class ChannelEndpoints
             .Produces(StatusCodes.Status204NoContent);
         admin.MapPut("/{id:guid}/time", UpdateTime).Produces(StatusCodes.Status204NoContent);
 
-        admin
-            .MapPost("/{id:guid}/bumper/templates", AddBumperTemplate)
-            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
-        admin
-            .MapPut("/{id:guid}/bumper/templates/{templateId:guid}", UpdateBumperTemplate)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapDelete("/{id:guid}/bumper/templates/{templateId:guid}", RemoveBumperTemplate)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapPut("/{id:guid}/bumper/templates/{templateId:guid}/audio", UploadTemplateAudio)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapDelete("/{id:guid}/bumper/templates/{templateId:guid}/audio", ClearTemplateAudio)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapPut(
-                "/{id:guid}/bumper/templates/{templateId:guid}/background",
-                SetTemplateBackground
-            )
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapDelete(
-                "/{id:guid}/bumper/templates/{templateId:guid}/background",
-                ClearTemplateBackground
-            )
-            .Produces(StatusCodes.Status204NoContent);
-
-        admin
-            .MapPost("/{id:guid}/bumper/templates/{templateId:guid}/preview", RenderPreview)
-            .Produces(StatusCodes.Status204NoContent);
-        admin.MapGet(
-            "/{id:guid}/bumper/templates/{templateId:guid}/preview/{variantId:guid}/index.m3u8",
-            PreviewPlaylist
-        );
-        admin.MapGet(
-            "/{id:guid}/bumper/templates/{templateId:guid}/preview/{variantId:guid}/{file}",
-            PreviewSegment
-        );
-
-        admin
-            .MapPost("/{id:guid}/bumper/templates/{templateId:guid}/variants", AddBumperVariant)
-            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
-        admin
-            .MapPut(
-                "/{id:guid}/bumper/templates/{templateId:guid}/variants/{variantId:guid}",
-                UpdateBumperVariant
-            )
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapDelete(
-                "/{id:guid}/bumper/templates/{templateId:guid}/variants/{variantId:guid}",
-                RemoveBumperVariant
-            )
-            .Produces(StatusCodes.Status204NoContent);
-
         admin
             .MapGet("/{id:guid}/schedule", GetSchedule)
             .Produces<IReadOnlyList<ScheduleEntryDto>>();
@@ -101,9 +46,29 @@ public static partial class ChannelEndpoints
         // «Почему это здесь»: цепочка происхождения записи, записанная в момент генерации.
         admin.MapGet("/entries/{entryId:guid}/trace", GetEntryTrace).Produces<EntryTraceDto>();
 
+        // Отладочный дамп: вход планировщика и результат одним архивом.
+        admin.MapPost("/{id:guid}/debug-export", ExportDebug).Produces(StatusCodes.Status200OK);
+
         return app;
     }
 
+    /// <summary>
+    /// Отдаёт архив со снимком канала. POST, а не GET: команда оставляет копию дампа на сервере,
+    /// и кэшировать такой ответ никому не следует.
+    /// </summary>
+    private static async Task<IResult> ExportDebug(
+        Guid id,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new ExportChannelDebugCommand(id), cancellationToken);
+        if (!result.IsSuccess)
+            return result.ToHttpResult();
+
+        return Results.File(result.Value.Content, "application/zip", result.Value.FileName);
+    }
+
     private static async Task<IResult> UpdateViewerSettings(
         Guid id,
         UpdateViewerSettingsBody body,
@@ -195,9 +160,8 @@ public static partial class ChannelEndpoints
                 id,
                 body.Name,
                 body.IsEnabled,
-                body.BumpersEnabled,
+                body.FillerAssetId,
-                body.Bumper,
+                body.IconImageId
-                body.FillerAssetId
             ),
             cancellationToken
         );
@@ -232,9 +196,8 @@ public sealed record UpdateChannelTimeBody(
 public sealed record UpdateChannelSettingsBody(
     string Name,
     bool IsEnabled,
-    bool BumpersEnabled,
+    Guid? FillerAssetId,
-    BumperSettingsInput Bumper,
+    Guid? IconImageId
-    Guid? FillerAssetId
 );
 
 /// <summary>Оверлеи и аналоговый фильтр — как канал выглядит у зрителя (см. 6.8).</summary>

backend/src/TeleWave.Api/Endpoints/CollectionEndpoints.cs

@@ -2,13 +2,16 @@ using LiteCqrs;
 using TeleWave.Api.Common;
 using TeleWave.Application.Library.Collections;
 using TeleWave.Application.Library.Collections.AddCollectionShow;
+using TeleWave.Application.Library.Collections.AddShowsToCollection;
 using TeleWave.Application.Library.Collections.CreateCollection;
 using TeleWave.Application.Library.Collections.DeleteCollection;
+using TeleWave.Application.Library.Collections.FillCollectionPosters;
 using TeleWave.Application.Library.Collections.GetCollection;
 using TeleWave.Application.Library.Collections.ListCollections;
 using TeleWave.Application.Library.Collections.RemoveCollectionShow;
 using TeleWave.Application.Library.Collections.ReorderCollection;
 using TeleWave.Application.Library.Collections.SetCollectionPoster;
+using TeleWave.Application.Library.Collections.Suggest;
 using TeleWave.Application.Library.Collections.UpdateCollection;
 using TeleWave.Infrastructure.Identity;
 
@@ -36,9 +39,89 @@ public static class CollectionEndpoints
         admin.MapPut("/{id:guid}/order", Reorder).Produces(StatusCodes.Status204NoContent);
         admin.MapPut("/{id:guid}/poster-image", SetPoster).Produces(StatusCodes.Status204NoContent);
 
+        // Сборка франшиз: массовое добавление отмеченных шоу и предложения по библиотеке.
+        admin.MapPost("/bulk/shows", AddShows).Produces<AddShowsToCollectionResultDto>();
+        // Постеры по частям: без списка — всем коллекциям, у которых постера ещё нет.
+        admin.MapPost("/bulk/posters", FillPosters).Produces<int>();
+        admin
+            .MapGet("/suggestions", Suggestions)
+            .Produces<IReadOnlyList<CollectionSuggestionDto>>();
+        admin
+            .MapPost("/suggestions", CreateFromSuggestion)
+            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
+        // Дополнение уже собранной франшизы: коллекция определяется тем же ключом предложения.
+        admin.MapPost("/suggestions/add", AddFromSuggestion).Produces<int>();
+
         return app;
     }
 
+    private static async Task<IResult> FillPosters(
+        FillCollectionPostersBody? body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new FillCollectionPostersCommand(body?.CollectionIds),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> AddShows(
+        AddShowsToCollectionBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new AddShowsToCollectionCommand(
+                body.ShowIds,
+                body.CollectionId,
+                body.NewCollectionName
+            ),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> Suggestions(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new SuggestCollectionsQuery(), cancellationToken);
+        return Results.Ok(result);
+    }
+
+    private static async Task<IResult> CreateFromSuggestion(
+        CreateCollectionFromSuggestionBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new CreateCollectionFromSuggestionCommand(body.Key),
+            cancellationToken
+        );
+        return result.IsSuccess
+            ? Results.Created(
+                $"/api/admin/collections/{result.Value}",
+                new CreatedIdResponse(result.Value)
+            )
+            : result.ToHttpResult();
+    }
+
+    private static async Task<IResult> AddFromSuggestion(
+        CreateCollectionFromSuggestionBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new AddSuggestedShowsCommand(body.Key), cancellationToken);
+        return result.ToHttpResult();
+    }
+
     private static async Task<IResult> ListCollections(
         ISender sender,
         CancellationToken cancellationToken
@@ -161,3 +244,14 @@ public sealed record CollectionShowBody(Guid ShowId);
 public sealed record ReorderCollectionBody(IReadOnlyList<Guid> ShowIdsInOrder);
 
 public sealed record CollectionPosterBody(Guid? ImageId);
+
+/// <summary>Куда складывать: существующая коллекция либо новая по имени.</summary>
+public sealed record AddShowsToCollectionBody(
+    IReadOnlyList<Guid> ShowIds,
+    Guid? CollectionId = null,
+    string? NewCollectionName = null
+);
+
+public sealed record CreateCollectionFromSuggestionBody(string Key);
+
+public sealed record FillCollectionPostersBody(IReadOnlyList<Guid>? CollectionIds);

backend/src/TeleWave.Api/Endpoints/DiagnosticsEndpoints.cs

@@ -0,0 +1,162 @@
+using System.Reflection;
+using System.Runtime.InteropServices;
+using LiteCqrs;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.Options;
+using TeleWave.Application.Diagnostics;
+using TeleWave.Infrastructure.Identity;
+
+namespace TeleWave.Api.Endpoints;
+
+/// <summary>
+/// Админская диагностика. Главное здесь — картина прокси-форвардинга: заголовки, которым доверяет
+/// приложение, и итоговая схема/хост, из которых строятся абсолютные ссылки (M3U/EPG). Именно тут
+/// видно, почему ссылки уходят по http вместо https: X-Forwarded-Proto пришёл, но сосед не доверен.
+/// Плюс живое состояние инфраструктуры (БД, том хранилища, ffmpeg) — через системный запрос.
+/// </summary>
+public static class DiagnosticsEndpoints
+{
+    public static IEndpointRouteBuilder MapDiagnosticsEndpoints(this IEndpointRouteBuilder app)
+    {
+        app.MapGet("/api/admin/diagnostics", Get)
+            .WithTags("Admin.Diagnostics")
+            .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin))
+            .Produces<DiagnosticsResponse>();
+
+        return app;
+    }
+
+    private static async Task<IResult> Get(
+        HttpContext http,
+        IOptions<ForwardedHeadersOptions> forwardedOptions,
+        IHostEnvironment env,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var system = await sender.Send(new GetSystemDiagnosticsQuery(), cancellationToken);
+        var host = BuildHost(env);
+        var forwarding = BuildForwarding(http, forwardedOptions.Value);
+
+        return Results.Ok(new DiagnosticsResponse(host, forwarding, system));
+    }
+
+    private static HostDiagnosticsDto BuildHost(IHostEnvironment env)
+    {
+        var assembly = Assembly.GetEntryAssembly();
+        var version =
+            assembly
+                ?.GetCustomAttribute<AssemblyInformationalVersionAttribute>()
+                ?.InformationalVersion
+            ?? assembly?.GetName().Version?.ToString();
+
+        return new HostDiagnosticsDto(
+            version,
+            env.EnvironmentName,
+            RuntimeInformation.FrameworkDescription,
+            RuntimeInformation.OSDescription,
+            DateTimeOffset.UtcNow
+        );
+    }
+
+    private static ForwardingDiagnosticsDto BuildForwarding(
+        HttpContext http,
+        ForwardedHeadersOptions options
+    )
+    {
+        var request = http.Request;
+        var scheme = request.Scheme;
+        var host = request.Host.Value ?? string.Empty;
+        var isHttps = string.Equals(scheme, "https", StringComparison.OrdinalIgnoreCase);
+        var remoteIp = http.Connection.RemoteIpAddress?.ToString();
+
+        var forwardedProto = Header(request, "X-Forwarded-Proto");
+        // X-Original-* заголовки ставит сам ForwardedHeaders-middleware, когда доверяет соседу и
+        // применяет форвардинг — по их наличию отличаем «применено» от «отброшено как недоверенное».
+        var originalProto = Header(request, "X-Original-Proto");
+        var originalRemoteIp = Header(request, "X-Original-For");
+        var applied = originalProto is not null || originalRemoteIp is not null;
+
+        // Что прокси реально прислал (до возможного применения), и вывод с готовой подсказкой.
+        var sentProto = originalProto ?? forwardedProto;
+        string verdict;
+        string? suggestedTrustedIp = null;
+        if (isHttps)
+            verdict = "ok";
+        else if (string.Equals(sentProto, "https", StringComparison.OrdinalIgnoreCase))
+        {
+            // Заголовок пришёл, но схема осталась http → непосредственный сосед не в доверенных.
+            verdict = "proxyNotTrusted";
+            suggestedTrustedIp = remoteIp;
+        }
+        else
+            verdict = "protoHeaderMissing";
+
+        return new ForwardingDiagnosticsDto(
+            scheme,
+            host,
+            $"{scheme}://{host}",
+            isHttps,
+            remoteIp,
+            forwardedProto,
+            Header(request, "X-Forwarded-For"),
+            Header(request, "X-Forwarded-Host"),
+            Header(request, "X-Real-IP"),
+            originalProto,
+            originalRemoteIp,
+            applied,
+            options.ForwardLimit,
+            options.ForwardedHeaders.ToString(),
+            [.. options.KnownProxies.Select(ip => ip.ToString())],
+            [.. options.KnownIPNetworks.Select(net => net.ToString())],
+            verdict,
+            suggestedTrustedIp
+        );
+    }
+
+    private static string? Header(HttpRequest request, string name) =>
+        request.Headers.TryGetValue(name, out var value) && !string.IsNullOrEmpty(value)
+            ? value.ToString()
+            : null;
+}
+
+/// <summary>Ответ диагностики: процесс/рантайм, картина форвардинга и живое состояние инфраструктуры.</summary>
+public sealed record DiagnosticsResponse(
+    HostDiagnosticsDto Host,
+    ForwardingDiagnosticsDto Forwarding,
+    SystemDiagnosticsDto System
+);
+
+public sealed record HostDiagnosticsDto(
+    string? AppVersion,
+    string Environment,
+    string Framework,
+    string Os,
+    DateTimeOffset ServerTimeUtc
+);
+
+/// <summary>
+/// Картина X-Forwarded-*. <c>Verdict</c>: <c>ok</c> — схема https; <c>proxyNotTrusted</c> — прокси
+/// прислал https, но <c>Applied=false</c>, и <c>SuggestedTrustedIp</c> нужно внести в KnownProxies;
+/// <c>protoHeaderMissing</c> — прокси вообще не шлёт X-Forwarded-Proto.
+/// </summary>
+public sealed record ForwardingDiagnosticsDto(
+    string Scheme,
+    string Host,
+    string Origin,
+    bool IsHttps,
+    string? RemoteIp,
+    string? XForwardedProto,
+    string? XForwardedFor,
+    string? XForwardedHost,
+    string? XRealIp,
+    string? OriginalProto,
+    string? OriginalRemoteIp,
+    bool Applied,
+    int? ForwardLimit,
+    string ForwardedHeaders,
+    IReadOnlyList<string> KnownProxies,
+    IReadOnlyList<string> KnownNetworks,
+    string Verdict,
+    string? SuggestedTrustedIp
+);

backend/src/TeleWave.Api/Endpoints/GroupEndpoints.cs

@@ -4,13 +4,16 @@ using TeleWave.Application.Programming.Groups;
 using TeleWave.Application.Programming.Groups.AddGroupElements;
 using TeleWave.Application.Programming.Groups.CreateGroup;
 using TeleWave.Application.Programming.Groups.DeleteGroup;
+using TeleWave.Application.Programming.Groups.ExcludeGroupElement;
 using TeleWave.Application.Programming.Groups.FindGroupCandidates;
 using TeleWave.Application.Programming.Groups.GetGroup;
 using TeleWave.Application.Programming.Groups.ListGroups;
 using TeleWave.Application.Programming.Groups.RemoveGroupItem;
 using TeleWave.Application.Programming.Groups.ReorderGroup;
 using TeleWave.Application.Programming.Groups.SetGroupItemWeight;
+using TeleWave.Application.Programming.Groups.Suggest;
 using TeleWave.Application.Programming.Groups.UpdateGroup;
+using TeleWave.Domain.Programming;
 using TeleWave.Infrastructure.Identity;
 
 namespace TeleWave.Api.Endpoints;
@@ -34,6 +37,12 @@ public static class GroupEndpoints
             .MapPost("/{id:guid}/candidates", FindCandidates)
             .Produces<IReadOnlyList<GroupCandidateDto>>();
 
+        // Предложения: что имеет смысл завести группой при нынешней библиотеке.
+        admin.MapGet("/suggestions", Suggestions).Produces<IReadOnlyList<GroupSuggestionDto>>();
+        admin
+            .MapPost("/suggestions", CreateFromSuggestion)
+            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
+
         admin.MapPost("/{id:guid}/items", AddElements).Produces<AddedCountResponse>();
         admin
             .MapDelete("/{id:guid}/items/{itemId:guid}", RemoveItem)
@@ -43,6 +52,9 @@ public static class GroupEndpoints
             .Produces(StatusCodes.Status204NoContent);
         admin.MapPut("/{id:guid}/order", Reorder).Produces(StatusCodes.Status204NoContent);
 
+        // Поправки к вычисленному составу динамической группы.
+        admin.MapPost("/{id:guid}/exclusions", Exclude).Produces(StatusCodes.Status204NoContent);
+
         return app;
     }
 
@@ -80,6 +92,33 @@ public static class GroupEndpoints
             : result.ToHttpResult();
     }
 
+    private static async Task<IResult> Suggestions(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new SuggestGroupsQuery(), cancellationToken);
+        return Results.Ok(result);
+    }
+
+    private static async Task<IResult> CreateFromSuggestion(
+        CreateGroupFromSuggestionBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new CreateGroupFromSuggestionCommand(body.Key),
+            cancellationToken
+        );
+        return result.IsSuccess
+            ? Results.Created(
+                $"/api/admin/groups/{result.Value}",
+                new CreatedIdResponse(result.Value)
+            )
+            : result.ToHttpResult();
+    }
+
     private static async Task<IResult> UpdateGroup(
         Guid id,
         UpdateGroupBody body,
@@ -88,7 +127,7 @@ public static class GroupEndpoints
     )
     {
         var result = await sender.Send(
-            new UpdateGroupCommand(id, body.Name, body.Description, body.Filter),
+            new UpdateGroupCommand(id, body.Name, body.Description, body.Filter, body.Mode),
             cancellationToken
         );
         return result.ToHttpResult();
@@ -160,6 +199,20 @@ public static class GroupEndpoints
         return result.ToHttpResult();
     }
 
+    private static async Task<IResult> Exclude(
+        Guid id,
+        ExcludeElementBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new ExcludeGroupElementCommand(id, body.ElementKind, body.ElementId, body.Excluded),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
     private static async Task<IResult> Reorder(
         Guid id,
         ReorderGroupBody body,
@@ -175,10 +228,24 @@ public static class GroupEndpoints
     }
 }
 
-public sealed record UpdateGroupBody(string Name, string? Description, GroupFilter? Filter);
+public sealed record UpdateGroupBody(
+    string Name,
+    string? Description,
+    GroupFilter? Filter,
+    GroupMode? Mode = null
+);
+
+/// <summary>Исключить элемент из динамической группы либо вернуть его правилу.</summary>
+public sealed record ExcludeElementBody(
+    GroupElementKind ElementKind,
+    Guid ElementId,
+    bool Excluded
+);
 
 public sealed record FindCandidatesBody(GroupFilter? Filter);
 
+public sealed record CreateGroupFromSuggestionBody(string Key);
+
 public sealed record AddGroupElementsBody(IReadOnlyList<GroupElementRef> Elements);
 
 public sealed record GroupItemWeightBody(int Weight);

backend/src/TeleWave.Api/Endpoints/IptvEndpoints.cs

@@ -0,0 +1,241 @@
+using System.Globalization;
+using System.Text;
+using System.Xml;
+using LiteCqrs;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Streaming.GetIptvGuide;
+using TeleWave.Infrastructure.Streaming;
+
+namespace TeleWave.Api.Endpoints;
+
+/// <summary>
+/// Выгрузка для внешних IPTV-плееров: M3U со списком каналов и XMLTV с программой передач.
+///
+/// Плеер не умеет ни Bearer, ни httpOnly-cookie — он умеет только открыть URL. Поэтому пропуск
+/// зашит в сами ссылки файла долгим stream-токеном: **файл и есть доступ к эфиру**, и делиться им
+/// нельзя. Срок — <c>Storage:IptvTokenDays</c>; блокировка зрителя обрывает доступ на ближайшей
+/// перезагрузке плейлиста канала, а смена <c>Jwt:SigningKey</c> обнуляет все выданные разом.
+/// </summary>
+public static class IptvEndpoints
+{
+    /// <summary>Сколько суток программы класть в XMLTV: горизонт ленты и так неделя.</summary>
+    private static readonly TimeSpan GuideWindow = TimeSpan.FromDays(7);
+
+    /// <summary>Заглушка иконки канала, когда своя не задана: фавикон сайта из wwwroot.</summary>
+    private const string FaviconPath = "/favicon.svg";
+
+    public static IEndpointRouteBuilder MapIptvEndpoints(this IEndpointRouteBuilder app)
+    {
+        var iptv = app.MapGroup("/api/iptv").WithTags("IPTV");
+
+        // Файл забирает браузер под обычной авторизацией — токен внутрь кладёт уже сервер.
+        iptv.MapGet("/playlist.m3u", Playlist).RequireAuthorization();
+        // XMLTV тянет сам плеер, у него из пропусков только токен из ссылки.
+        iptv.MapGet("/epg.xml", Guide);
+
+        return app;
+    }
+
+    private static async Task<IResult> Playlist(
+        ICurrentUser currentUser,
+        StreamTokenService tokens,
+        HttpRequest request,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        if (currentUser.UserId is not { } userId)
+            return Results.Unauthorized();
+
+        // Окно нулевое: плейлисту нужен только список каналов, программу плеер возьмёт из XMLTV.
+        var now = DateTimeOffset.UtcNow;
+        var channels = await sender.Send(new GetIptvGuideQuery(now, now), cancellationToken);
+
+        var (token, _) = tokens.IssueForIptv(userId);
+        var origin = Origin(request);
+        var body = RenderPlaylist(channels, origin, token);
+
+        return Results.File(
+            Encoding.UTF8.GetBytes(body),
+            "audio/x-mpegurl",
+            fileDownloadName: "telewave.m3u"
+        );
+    }
+
+    private static async Task<IResult> Guide(
+        HttpRequest request,
+        StreamTokenService tokens,
+        IIdentityService identity,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        if (tokens.Validate(request.Query["token"]) is not { } userId)
+            return Results.Unauthorized();
+        // Та же сверка, что и у плейлиста канала: заблокированный зритель не должен продолжать
+        // тянуть гид по выданному раньше файлу.
+        var profile = await identity.GetProfileAsync(userId, cancellationToken);
+        if (profile is null || profile.IsBlocked)
+            return Results.Unauthorized();
+
+        var now = DateTimeOffset.UtcNow;
+        var channels = await sender.Send(
+            new GetIptvGuideQuery(now, now.Add(GuideWindow)),
+            cancellationToken
+        );
+
+        return Results.File(
+            RenderGuide(channels, Origin(request)),
+            "application/xml; charset=utf-8",
+            fileDownloadName: "telewave-epg.xml"
+        );
+    }
+
+    /// <summary>
+    /// Абсолютный адрес сервиса. Плееру нужны именно абсолютные ссылки — относительные ему не от
+    /// чего считать. Схема и хост берутся из запроса: TLS внешний, и их подставляет
+    /// <c>ForwardedHeaders</c>.
+    /// </summary>
+    private static string Origin(HttpRequest request) => $"{request.Scheme}://{request.Host}";
+
+    private static string RenderPlaylist(
+        IReadOnlyList<IptvChannelDto> channels,
+        string origin,
+        string token
+    )
+    {
+        var sb = new StringBuilder();
+        sb.Append(
+            CultureInfo.InvariantCulture,
+            $"#EXTM3U x-tvg-url=\"{origin}/api/iptv/epg.xml?token={token}\"\n"
+        );
+
+        foreach (var channel in channels)
+        {
+            // tvg-logo ставим всегда: своя иконка либо фавикон-заглушка — иначе в плеере пустой квадрат.
+            var logo = $" tvg-logo=\"{ChannelIcon(origin, channel.IconImageId)}\"";
+            var number = channel.Number is { } value
+                ? $" tvg-chno=\"{value.ToString(CultureInfo.InvariantCulture)}\""
+                : string.Empty;
+            var name = Attribute(channel.Name);
+
+            sb.Append(
+                CultureInfo.InvariantCulture,
+                $"#EXTINF:-1 tvg-id=\"{Attribute(channel.Slug)}\" tvg-name=\"{name}\"{number}{logo} group-title=\"TeleWave\",{name}\n"
+            );
+            sb.Append(
+                CultureInfo.InvariantCulture,
+                $"{origin}/api/channels/{channel.Slug}/live.m3u8?token={token}\n"
+            );
+        }
+
+        return sb.ToString();
+    }
+
+    /// <summary>
+    /// Значение атрибута M3U. Экранирования в формате нет вовсе, поэтому кавычки и переводы строк
+    /// не заменяются, а вырезаются: иначе название канала рвало бы строку файла.
+    /// </summary>
+    private static string Attribute(string value) =>
+        value.Replace("\"", string.Empty).ReplaceLineEndings(" ").Trim();
+
+    private static byte[] RenderGuide(IReadOnlyList<IptvChannelDto> channels, string origin)
+    {
+        using var output = new MemoryStream();
+        // Пишем сразу в поток в UTF-8, а не в StringBuilder: XmlWriter поверх строки объявил бы
+        // encoding="utf-16" (строки .NET — UTF-16), тогда как байты мы всё равно отдаём в UTF-8.
+        // Часть плееров (Go encoding/xml) отвергает такое расхождение декларации и реальных байт.
+        // BOM не пишем: XMLTV его не ждёт, и он мешает строгим парсерам.
+        // Через XmlWriter, а не склейкой строк: в названия и описания приходит текст из библиотеки,
+        // и экранировать его руками — верный способ однажды отдать битый XML.
+        using (
+            var writer = XmlWriter.Create(
+                output,
+                new XmlWriterSettings
+                {
+                    Indent = true,
+                    Encoding = new UTF8Encoding(encoderShouldEmitUTF8Identifier: false),
+                }
+            )
+        )
+        {
+            writer.WriteStartDocument();
+            writer.WriteStartElement("tv");
+            writer.WriteAttributeString("generator-info-name", "TeleWave");
+
+            // Сначала все каналы, потом все передачи: XMLTV требует именно такого порядка секций.
+            foreach (var channel in channels)
+                WriteChannel(writer, channel, origin);
+
+            foreach (var channel in channels)
+            {
+                foreach (var programme in channel.Programmes)
+                    WriteProgramme(writer, channel.Slug, programme, origin);
+            }
+
+            writer.WriteEndElement();
+            writer.WriteEndDocument();
+        }
+
+        return output.ToArray();
+    }
+
+    private static void WriteChannel(XmlWriter writer, IptvChannelDto channel, string origin)
+    {
+        writer.WriteStartElement("channel");
+        writer.WriteAttributeString("id", channel.Slug);
+        writer.WriteElementString("display-name", channel.Name);
+        // Номер вторым display-name: так плееры с нумерацией подхватывают его без своих настроек.
+        if (channel.Number is { } number)
+            writer.WriteElementString(
+                "display-name",
+                number.ToString(CultureInfo.InvariantCulture)
+            );
+        // Иконку канала пишем всегда: своя либо фавикон-заглушка (в отличие от иконок передач ниже).
+        writer.WriteStartElement("icon");
+        writer.WriteAttributeString("src", ChannelIcon(origin, channel.IconImageId));
+        writer.WriteEndElement();
+        writer.WriteEndElement();
+    }
+
+    private static void WriteProgramme(
+        XmlWriter writer,
+        string slug,
+        IptvProgrammeDto programme,
+        string origin
+    )
+    {
+        writer.WriteStartElement("programme");
+        writer.WriteAttributeString("start", XmltvTime(programme.StartsAtUtc));
+        writer.WriteAttributeString("stop", XmltvTime(programme.EndsAtUtc));
+        writer.WriteAttributeString("channel", slug);
+
+        writer.WriteElementString("title", programme.Title);
+        if (!string.IsNullOrWhiteSpace(programme.SubTitle))
+            writer.WriteElementString("sub-title", programme.SubTitle);
+        if (!string.IsNullOrWhiteSpace(programme.Description))
+            writer.WriteElementString("desc", programme.Description);
+        WriteIcon(writer, programme.ImageId, origin);
+
+        writer.WriteEndElement();
+    }
+
+    private static void WriteIcon(XmlWriter writer, Guid? imageId, string origin)
+    {
+        if (imageId is not { } id)
+            return;
+
+        writer.WriteStartElement("icon");
+        writer.WriteAttributeString("src", $"{origin}/api/images/{id}");
+        writer.WriteEndElement();
+    }
+
+    /// <summary>URL иконки канала: своя из реестра либо фавикон-заглушка сайта (абсолютный адрес).</summary>
+    private static string ChannelIcon(string origin, Guid? iconImageId) =>
+        iconImageId is { } id ? $"{origin}/api/images/{id}" : $"{origin}{FaviconPath}";
+
+    /// <summary>Время XMLTV: <c>YYYYMMDDHHMMSS +0000</c>. Отдаём в UTC — плеер сдвинет сам.</summary>
+    private static string XmltvTime(DateTimeOffset moment) =>
+        moment.ToUniversalTime().ToString("yyyyMMddHHmmss", CultureInfo.InvariantCulture)
+        + " +0000";
+}

backend/src/TeleWave.Api/Endpoints/JunctionEndpoints.cs

@@ -7,67 +7,50 @@ using TeleWave.Infrastructure.Identity;
 namespace TeleWave.Api.Endpoints;
 
 /// <summary>
-/// Шаблоны стыков канала: что играет между программами. Как и правка сетки, эфира не двигают —
+/// Шаблоны стыков: что играет между программами. Стыки общие для всех каналов, канал только
-/// помечают шаблон канала изменённым, а хвост пересобирается применением.
+/// ссылается на них слотами. Как и правка сетки, эфира не двигают — помечают шаблоны каналов,
+/// которые их используют, изменёнными, а хвост пересобирается применением.
 /// </summary>
 public static class JunctionEndpoints
 {
     public static IEndpointRouteBuilder MapJunctionEndpoints(this IEndpointRouteBuilder app)
     {
-        var admin = app.MapGroup("/api/admin")
+        var admin = app.MapGroup("/api/admin/junctions")
             .WithTags("Admin.Junctions")
             .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin));
 
-        admin
+        admin.MapGet("", List).Produces<IReadOnlyList<JunctionTemplateDto>>();
-            .MapGet("/channels/{channelId:guid}/junctions", List)
+        admin.MapPost("", Create).Produces<CreatedIdResponse>(StatusCodes.Status201Created);
-            .Produces<IReadOnlyList<JunctionTemplateDto>>();
+        admin.MapPut("/{junctionId:guid}", Update).Produces(StatusCodes.Status204NoContent);
-        admin
+        admin.MapDelete("/{junctionId:guid}", Delete).Produces(StatusCodes.Status204NoContent);
-            .MapPost("/channels/{channelId:guid}/junctions", Create)
-            .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
-        admin
-            .MapPut("/junctions/{junctionId:guid}", Rename)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapDelete("/junctions/{junctionId:guid}", Delete)
-            .Produces(StatusCodes.Status204NoContent);
 
         admin
-            .MapPost("/junctions/{junctionId:guid}/elements", AddElement)
+            .MapPost("/{junctionId:guid}/elements", AddElement)
             .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
         admin
-            .MapPut("/junctions/{junctionId:guid}/elements/{elementId:guid}", UpdateElement)
+            .MapPut("/{junctionId:guid}/elements/{elementId:guid}", UpdateElement)
             .Produces(StatusCodes.Status204NoContent);
         admin
-            .MapDelete("/junctions/{junctionId:guid}/elements/{elementId:guid}", RemoveElement)
+            .MapDelete("/{junctionId:guid}/elements/{elementId:guid}", RemoveElement)
-            .Produces(StatusCodes.Status204NoContent);
-        admin
-            .MapPut("/junctions/{junctionId:guid}/order", Reorder)
             .Produces(StatusCodes.Status204NoContent);
+        admin.MapPut("/{junctionId:guid}/order", Reorder).Produces(StatusCodes.Status204NoContent);
 
         return app;
     }
 
-    private static async Task<IResult> List(
+    private static async Task<IResult> List(ISender sender, CancellationToken cancellationToken)
-        Guid channelId,
-        ISender sender,
-        CancellationToken cancellationToken
-    )
     {
-        var result = await sender.Send(new ListJunctionsQuery(channelId), cancellationToken);
+        var result = await sender.Send(new ListJunctionsQuery(), cancellationToken);
         return Results.Ok(result);
     }
 
     private static async Task<IResult> Create(
-        Guid channelId,
         JunctionNameBody body,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
-        var result = await sender.Send(
+        var result = await sender.Send(new CreateJunctionCommand(body.Name), cancellationToken);
-            new CreateJunctionCommand(channelId, body.Name),
-            cancellationToken
-        );
         return result.IsSuccess
             ? Results.Created(
                 $"/api/admin/junctions/{result.Value}",
@@ -76,15 +59,15 @@ public static class JunctionEndpoints
             : result.ToHttpResult();
     }
 
-    private static async Task<IResult> Rename(
+    private static async Task<IResult> Update(
         Guid junctionId,
-        JunctionNameBody body,
+        UpdateJunctionBody body,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
         var result = await sender.Send(
-            new RenameJunctionCommand(junctionId, body.Name),
+            new UpdateJunctionCommand(junctionId, body.Name, body.MaxTotalSeconds),
             cancellationToken
         );
         return result.ToHttpResult();
@@ -156,7 +139,7 @@ public static class JunctionEndpoints
     )
     {
         var result = await sender.Send(
-            new ReorderJunctionCommand(junctionId, body.ElementIdsInOrder),
+            new ReorderJunctionCommand(junctionId, body.Order),
             cancellationToken
         );
         return result.ToHttpResult();
@@ -165,6 +148,9 @@ public static class JunctionEndpoints
 
 public sealed record JunctionNameBody(string Name);
 
+public sealed record UpdateJunctionBody(string Name, int? MaxTotalSeconds);
+
 public sealed record JunctionElementKindBody(JunctionElementKind Kind);
 
-public sealed record ReorderJunctionBody(IReadOnlyList<Guid> ElementIdsInOrder);
+/// <summary>Порядок врезок вместе с их развилками — перетаскивание меняет и то, и другое разом.</summary>
+public sealed record ReorderJunctionBody(IReadOnlyList<JunctionElementOrder> Order);

backend/src/TeleWave.Api/Endpoints/MediaEndpoints.cs

@@ -8,7 +8,9 @@ using TeleWave.Application.Media;
 using TeleWave.Application.Media.Delete;
 using TeleWave.Application.Media.ListMedia;
 using TeleWave.Application.Media.ManualInbox;
+using TeleWave.Application.Media.MovieImport;
 using TeleWave.Application.Media.Register;
+using TeleWave.Application.Media.Retry;
 using TeleWave.Application.Media.Stats;
 using TeleWave.Domain.Media;
 using TeleWave.Infrastructure.Identity;
@@ -29,10 +31,20 @@ public static class MediaEndpoints
         admin.MapGet("/stats", Stats).Produces<MediaStatsDto>();
         admin.MapDelete("/{id:guid}", Delete).Produces(StatusCodes.Status204NoContent);
 
+        // Перезапуск упавшей обработки: файл на месте, повторить нарезку — обычное дело.
+        admin.MapPost("/{id:guid}/retry", Retry).Produces<RetryMediaResultDto>();
+        admin.MapPost("/retry-failed", RetryFailed).Produces<RetryMediaResultDto>();
+
         // Ручной inbox: сканером не разбирается — файлы выбирает админ и сразу указывает шоу.
         admin.MapGet("/manual", ListManual).Produces<ManualInboxListDto>();
         admin.MapPost("/manual/import", ImportManual).Produces<ImportManualInboxResultDto>();
 
+        // Разбор фильмов: имена приходят с клиента (каталог manual/ либо выбранные в браузере
+        // файлы), сервер разбирает их и ищет в источнике. Импорт заводит шоу на файл.
+        admin.MapPost("/movies/match", MatchMovies).Produces<IReadOnlyList<MovieMatchDto>>();
+        admin.MapPost("/movies/match-one", MatchMovie).Produces<MovieMatchDto>();
+        admin.MapPost("/movies/import", ImportMovies).Produces<ImportMoviesResultDto>();
+
         // Просмотр обработанного ассета в админке (ролики, проверка серии). Публичная раздача идёт
         // по stream-куке, здесь роут под JWT — плейлист и сегменты грузит hls.js с Bearer.
         admin.MapGet("/{id:guid}/preview/index.m3u8", PreviewPlaylist);
@@ -41,6 +53,25 @@ public static class MediaEndpoints
         return app;
     }
 
+    private static async Task<IResult> Retry(
+        Guid id,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new RetryMediaCommand(id), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> RetryFailed(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new RetryMediaCommand(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
     /// <summary>
     /// Потоковая загрузка: тело запроса — сырые байты файла, имя передаётся в query «fileName».
     /// Файл стримится на диск без буферизации в память, затем регистрируется и уходит в обработку.
@@ -88,13 +119,27 @@ public static class MediaEndpoints
         var extension = Path.GetExtension(fileName);
         var token = await storage.SaveUploadAsync(request.Body, extension, cancellationToken);
 
-        var result = await sender.Send(
+        // Файл уже на диске в uploads/, но в БД его ещё нет и ссылок на токен нигде не остаётся:
+        // любой исход, кроме успешной регистрации, обязан за собой убрать. Удаляем и при исключении
+        // (оборванный запрос, сбой БД) — иначе гигабайты остаются в uploads/ до уборщика.
+        // Токен отмены для уборки не пробрасываем: при обрыве запроса он уже сработал.
+        Result<Guid> result;
+        try
+        {
+            result = await sender.Send(
                 new RegisterMediaAssetCommand(token, MediaSource.Upload, fileName),
                 cancellationToken
             );
+        }
+        catch
+        {
+            await storage.DeleteUploadAsync(token, CancellationToken.None);
+            throw;
+        }
+
         if (!result.IsSuccess)
         {
-            await storage.DeleteUploadAsync(token, cancellationToken);
+            await storage.DeleteUploadAsync(token, CancellationToken.None);
             return result.ToHttpResult();
         }
 
@@ -150,6 +195,45 @@ public static class MediaEndpoints
         return Results.Ok(result);
     }
 
+    private static async Task<IResult> MatchMovies(
+        MatchMoviesBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new MatchMoviesQuery(body.Names, body.Provider),
+            cancellationToken
+        );
+        return Results.Ok(result);
+    }
+
+    private static async Task<IResult> MatchMovie(
+        MatchMovieBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new MatchMovieQuery(body.Name, body.Title, body.Year, body.Provider),
+            cancellationToken
+        );
+        return Results.Ok(result);
+    }
+
+    private static async Task<IResult> ImportMovies(
+        ImportMoviesBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new ImportMoviesCommand(body.Items, body.Provider),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
     private static async Task<IResult> ImportManual(
         ImportManualInboxBody body,
         ISender sender,
@@ -214,3 +298,9 @@ public sealed record ListMediaFilter(
 public sealed record UploadMediaResponse(Guid Id);
 
 public sealed record ImportManualInboxBody(IReadOnlyList<ManualImportItem> Items, Guid ShowId);
+
+public sealed record MatchMoviesBody(IReadOnlyList<string> Names, string Provider);
+
+public sealed record MatchMovieBody(string Name, string Title, int? Year, string Provider);
+
+public sealed record ImportMoviesBody(IReadOnlyList<MovieImportItem> Items, string Provider);

backend/src/TeleWave.Api/Endpoints/MetadataEndpoints.cs

@@ -4,6 +4,7 @@ using TeleWave.Application.Metadata;
 using TeleWave.Application.Metadata.ApplyShowMetadata;
 using TeleWave.Application.Metadata.ClearShowMetadata;
 using TeleWave.Application.Metadata.FindMissingEpisodes;
+using TeleWave.Application.Metadata.FindMissingSeasons;
 using TeleWave.Application.Metadata.GetProviders;
 using TeleWave.Application.Metadata.RefreshEpisodes;
 using TeleWave.Application.Metadata.SearchShows;
@@ -34,6 +35,9 @@ public static class MetadataEndpoints
         admin
             .MapGet("/shows/{showId:guid}/missing-episodes", FindMissing)
             .Produces<MissingEpisodesReport>();
+        admin
+            .MapGet("/shows/{showId:guid}/missing-seasons", FindMissingSeasons)
+            .Produces<MissingSeasonsReport>();
 
         // Постеры шоу и кадры серий теперь в общем реестре и отдаются по /api/images/{id}.
         return app;
@@ -137,6 +141,16 @@ public static class MetadataEndpoints
         var result = await sender.Send(new FindMissingEpisodesQuery(showId), cancellationToken);
         return result.ToHttpResult();
     }
+
+    private static async Task<IResult> FindMissingSeasons(
+        Guid showId,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new FindMissingSeasonsQuery(showId), cancellationToken);
+        return result.ToHttpResult();
+    }
 }
 
 public sealed record ApplyMetadataBody(string Provider, string ExternalId);

backend/src/TeleWave.Api/Endpoints/ShowEndpoints.cs

@@ -2,15 +2,18 @@ using LiteCqrs;
 using TeleWave.Api.Common;
 using TeleWave.Application.Library;
 using TeleWave.Application.Library.AddEpisode;
+using TeleWave.Application.Library.BulkTagShows;
 using TeleWave.Application.Library.CreateShow;
 using TeleWave.Application.Library.DeleteShow;
 using TeleWave.Application.Library.GetShow;
+using TeleWave.Application.Library.GetShowUsage;
 using TeleWave.Application.Library.ListShows;
 using TeleWave.Application.Library.RemoveEpisode;
 using TeleWave.Application.Library.RenameShow;
 using TeleWave.Application.Library.SetShowAudience;
 using TeleWave.Application.Library.SetShowGenres;
 using TeleWave.Application.Library.SetShowOriginalName;
+using TeleWave.Application.Metadata.EnrichShows;
 using TeleWave.Domain.Library;
 using TeleWave.Infrastructure.Identity;
 
@@ -33,7 +36,12 @@ public static class ShowEndpoints
             .Produces(StatusCodes.Status204NoContent);
         admin.MapPut("/{id:guid}/audience", SetAudience).Produces(StatusCodes.Status204NoContent);
         admin.MapPut("/{id:guid}/genres", SetGenres).Produces(StatusCodes.Status204NoContent);
+        admin.MapGet("/{id:guid}/usage", GetUsage).Produces<ShowUsageDto>();
         admin.MapDelete("/{id:guid}", DeleteShow).Produces(StatusCodes.Status204NoContent);
+
+        // Массовые операции над отмеченными шоу: разметка руками и обогащение из источника.
+        admin.MapPost("/bulk/tag", BulkTag).Produces<BulkTaggedResponse>();
+        admin.MapPost("/bulk/enrich", BulkEnrich).Produces<EnrichShowsResultDto>();
         admin
             .MapPost("/{id:guid}/episodes", AddEpisode)
             .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
@@ -136,13 +144,20 @@ public static class ShowEndpoints
         return result.ToHttpResult();
     }
 
+    /// <param name="withMedia">Снести заодно файлы шоу — иначе они останутся осиротевшими.</param>
+    /// <param name="withSchedule">Вырезать шоу из будущего эфира вместо отказа.</param>
     private static async Task<IResult> DeleteShow(
         Guid id,
         ISender sender,
-        CancellationToken cancellationToken
+        CancellationToken cancellationToken,
+        bool withMedia = false,
+        bool withSchedule = false
     )
     {
-        var result = await sender.Send(new DeleteShowCommand(id), cancellationToken);
+        var result = await sender.Send(
+            new DeleteShowCommand(id, withMedia, withSchedule),
+            cancellationToken
+        );
         return result.ToHttpResult();
     }
 
@@ -172,10 +187,68 @@ public static class ShowEndpoints
         var result = await sender.Send(new RemoveEpisodeCommand(id, episodeId), cancellationToken);
         return result.ToHttpResult();
     }
+
+    private static async Task<IResult> GetUsage(
+        Guid id,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new GetShowUsageQuery(id), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> BulkTag(
+        BulkTagShowsBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new BulkTagShowsCommand(
+                body.ShowIds,
+                body.GenreIds,
+                body.ReplaceGenres,
+                body.Audience,
+                body.SetAudience
+            ),
+            cancellationToken
+        );
+        return result.IsSuccess
+            ? Results.Ok(new BulkTaggedResponse(result.Value))
+            : result.ToHttpResult();
+    }
+
+    private static async Task<IResult> BulkEnrich(
+        BulkEnrichBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new EnrichShowsMetadataCommand(body.ShowIds, body.Provider),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
 }
 
 public sealed record AddEpisodeBody(Guid MediaAssetId);
 
+/// <summary>Массовая разметка: жанры и рейтинг применяются независимо друг от друга.</summary>
+public sealed record BulkTagShowsBody(
+    IReadOnlyList<Guid> ShowIds,
+    IReadOnlyList<Guid>? GenreIds = null,
+    bool ReplaceGenres = false,
+    ShowAudience? Audience = null,
+    bool SetAudience = false
+);
+
+public sealed record BulkEnrichBody(IReadOnlyList<Guid> ShowIds, string Provider);
+
+/// <summary>Скольких шоу коснулась массовая правка.</summary>
+public sealed record BulkTaggedResponse(int Updated);
+
 public sealed record RenameShowBody(string Name);
 
 public sealed record SetShowOriginalNameBody(string? OriginalName);

backend/src/TeleWave.Api/Endpoints/StorageEndpoints.cs

@@ -0,0 +1,33 @@
+using LiteCqrs;
+using TeleWave.Application.Storage;
+using TeleWave.Infrastructure.Identity;
+
+namespace TeleWave.Api.Endpoints;
+
+/// <summary>Чем занят диск: объём по областям хранилища и заполненность тома.</summary>
+public static class StorageEndpoints
+{
+    public static IEndpointRouteBuilder MapStorageEndpoints(this IEndpointRouteBuilder app)
+    {
+        app.MapGet("/api/admin/storage", Stats)
+            .WithTags("Admin.Storage")
+            .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin))
+            .Produces<StorageStatsDto>();
+
+        return app;
+    }
+
+    /// <param name="refresh">Пересчитать, не дожидаясь истечения кэша: обход дерева долгий.</param>
+    private static async Task<IResult> Stats(
+        bool? refresh,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new GetStorageStatsQuery(refresh ?? false),
+            cancellationToken
+        );
+        return Results.Ok(result);
+    }
+}

backend/src/TeleWave.Api/Endpoints/StreamingEndpoints.cs

@@ -117,7 +117,9 @@ public static class StreamingEndpoints
         // Плейлист hls.js перезагружает регулярно — здесь дёшево (1 запрос на перезагрузку) сверить,
         // что зритель из токена ещё существует и не заблокирован. Так блокировка отражается почти сразу,
         // не дожидаясь истечения короткого TTL cookie; сегменты этой проверки не делают (слишком часто).
-        if (tokens.Validate(request.Cookies[StreamCookieName]) is not { } userId)
+        // Для IPTV это единственная точка, где блокировка вообще может сработать: у внешнего плеера
+        // пропуск долгий и перевыпуску не подлежит.
+        if (Viewer(request, tokens) is not { } userId)
             return Results.Unauthorized();
         var profile = await identity.GetProfileAsync(userId, cancellationToken);
         if (profile is null || profile.IsBlocked)
@@ -132,8 +134,15 @@ public static class StreamingEndpoints
         if (result.Value.Segments.Count == 0)
             return Results.StatusCode(StatusCodes.Status503ServiceUnavailable);
 
+        // Токен из ссылки тянется дальше в адреса сегментов: плеер разрешает их относительно
+        // плейлиста и query при этом теряет, а cookie у него нет — без этого сегменты дадут 401.
+        var token = request.Query["token"].ToString();
+        var suffix = string.IsNullOrEmpty(token)
+            ? string.Empty
+            : $"?token={Uri.EscapeDataString(token)}";
+
         response.Headers.CacheControl = "no-cache";
-        return Results.Text(Render(result.Value), "application/vnd.apple.mpegurl");
+        return Results.Text(Render(result.Value, suffix), "application/vnd.apple.mpegurl");
     }
 
     private static IResult Segment(
@@ -145,7 +154,7 @@ public static class StreamingEndpoints
         MediaPathResolver paths
     )
     {
-        if (tokens.Validate(request.Cookies[StreamCookieName]) is null)
+        if (Viewer(request, tokens) is null)
             return Results.Unauthorized();
         if (!SegmentFiles.IsSegmentName(file))
             return Results.NotFound();
@@ -157,7 +166,15 @@ public static class StreamingEndpoints
         return Results.File(path, "video/mp2t", enableRangeProcessing: true);
     }
 
-    private static string Render(LivePlaylistDto playlist)
+    /// <summary>
+    /// Кто смотрит: cookie — для браузера, токен в ссылке — для внешнего IPTV-плеера, который
+    /// cookie не носит. Токен один и тот же по формату, различается только сроком выдачи.
+    /// </summary>
+    private static Guid? Viewer(HttpRequest request, StreamTokenService tokens) =>
+        tokens.Validate(request.Cookies[StreamCookieName])
+        ?? tokens.Validate(request.Query["token"]);
+
+    private static string Render(LivePlaylistDto playlist, string segmentSuffix)
     {
         var extinf = playlist.TargetDuration.ToString("F6", CultureInfo.InvariantCulture);
         var sb = new StringBuilder();
@@ -171,6 +188,12 @@ public static class StreamingEndpoints
             CultureInfo.InvariantCulture,
             $"#EXT-X-MEDIA-SEQUENCE:{playlist.MediaSequence}\n"
         );
+        // Без DISCONTINUITY-SEQUENCE ffmpeg-плееры (Jellyfin) теряют счёт склеек, когда тег
+        // EXT-X-DISCONTINUITY уезжает за верхний край окна, и встают на стыке серий.
+        sb.Append(
+            CultureInfo.InvariantCulture,
+            $"#EXT-X-DISCONTINUITY-SEQUENCE:{playlist.DiscontinuitySequence}\n"
+        );
 
         foreach (var segment in playlist.Segments)
         {
@@ -179,7 +202,7 @@ public static class StreamingEndpoints
             sb.Append(CultureInfo.InvariantCulture, $"#EXTINF:{extinf},\n");
             sb.Append(
                 CultureInfo.InvariantCulture,
-                $"/api/stream/{segment.AssetId:N}/seg{segment.LocalIndex:D5}.ts\n"
+                $"/api/stream/{segment.AssetId:N}/seg{segment.LocalIndex:D5}.ts{segmentSuffix}\n"
             );
         }
 

backend/src/TeleWave.Api/Endpoints/TelegramEndpoints.cs

@@ -0,0 +1,175 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Api.Common;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Notifications;
+using TeleWave.Application.Notifications.Link;
+using TeleWave.Application.Notifications.Settings;
+using TeleWave.Application.Notifications.Subscribers;
+using TeleWave.Domain.Notifications;
+using TeleWave.Infrastructure.Identity;
+
+namespace TeleWave.Api.Endpoints;
+
+/// <summary>
+/// Бот расписания: настройка в админке, привязка чата зрителем и приём обновлений вебхуком.
+/// </summary>
+public static class TelegramEndpoints
+{
+    /// <summary>Заголовок, которым Telegram подтверждает, что вызов вебхука — его.</summary>
+    private const string SecretHeader = "X-Telegram-Bot-Api-Secret-Token";
+
+    public static IEndpointRouteBuilder MapTelegramEndpoints(this IEndpointRouteBuilder app)
+    {
+        var admin = app.MapGroup("/api/admin/telegram")
+            .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin));
+
+        admin.MapGet("/settings", GetSettings).Produces<TelegramSettingsDto>();
+        admin.MapPut("/settings", UpdateSettings).Produces<TelegramSettingsDto>();
+        admin
+            .MapGet("/subscribers", ListSubscribers)
+            .Produces<IReadOnlyList<TelegramSubscriberDto>>();
+
+        // Настроен ли бот — публично: по этому флагу зрительская страница решает, показывать ли
+        // кнопку. Ничего, кроме флага и имени бота, здесь не отдаётся.
+        app.MapGet("/api/telegram/status", Status).AllowAnonymous().Produces<TelegramStatusDto>();
+
+        // Ссылка на чат — зрителю, а не админу: код привязывает его собственную учётку.
+        app.MapPost("/api/telegram/link", IssueLink)
+            .RequireAuthorization()
+            .Produces<TelegramLinkDto>();
+
+        // Вебхук открыт наружу по построению: его вызывает Telegram, а не наш фронт. Пускаем
+        // только по секрету из настроек — адрес рано или поздно окажется в чужих логах.
+        app.MapPost("/api/telegram/webhook", Webhook).AllowAnonymous();
+
+        return app;
+    }
+
+    private static async Task<IResult> Status(
+        IAppDbContext dbContext,
+        CancellationToken cancellationToken
+    )
+    {
+        var settings = await dbContext
+            .TelegramSettings.AsNoTracking()
+            .FirstOrDefaultAsync(cancellationToken);
+
+        var link = settings is null ? null : TelegramSettingsService.BotLink(settings);
+        return Results.Ok(new TelegramStatusDto(link is not null, settings?.BotUsername));
+    }
+
+    private static async Task<IResult> GetSettings(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new GetTelegramSettingsQuery(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> UpdateSettings(
+        TelegramSettingsBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new UpdateTelegramSettingsCommand(
+                body.IsEnabled,
+                body.Transport,
+                body.BotToken,
+                body.WebhookUrl,
+                body.ProxyKind,
+                body.ProxyHost,
+                body.ProxyPort,
+                body.ProxyUsername,
+                body.ProxyPassword
+            ),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> ListSubscribers(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new ListTelegramSubscribersQuery(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> IssueLink(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new IssueTelegramLinkCommand(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    /// <summary>
+    /// Приём обновления от Telegram. Разбираем тем же сервисом, что и опрос: транспорт разный,
+    /// разговор один.
+    ///
+    /// Отвечаем 200 всегда, когда секрет сошёлся: на ошибку Telegram повторяет доставку, и одно
+    /// кривое обновление зациклило бы вебхук.
+    /// </summary>
+    private static async Task<IResult> Webhook(
+        HttpRequest request,
+        IAppDbContext dbContext,
+        TelegramBotService bot,
+        ITelegramApi api,
+        ILoggerFactory loggers,
+        CancellationToken cancellationToken
+    )
+    {
+        var settings = await dbContext.TelegramSettings.FirstOrDefaultAsync(cancellationToken);
+        if (
+            settings is null
+            || !settings.IsOperational
+            || settings.Transport != TelegramTransport.Webhook
+        )
+            return Results.NotFound();
+
+        var secret = request.Headers[SecretHeader].ToString();
+        if (string.IsNullOrWhiteSpace(settings.WebhookSecret) || secret != settings.WebhookSecret)
+            return Results.Unauthorized();
+
+        var update = await api.ReadUpdateAsync(request.Body, cancellationToken);
+        if (update is null)
+            return Results.Ok();
+
+        var logger = loggers.CreateLogger("Telegram.Webhook");
+        try
+        {
+            await bot.HandleAsync(settings, update, DateTimeOffset.UtcNow, cancellationToken);
+            settings.MarkContact(DateTimeOffset.UtcNow);
+            settings.AdvanceUpdateId(update.UpdateId);
+            await dbContext.SaveChangesAsync(cancellationToken);
+        }
+        catch (Exception exception) when (exception is not OperationCanceledException)
+        {
+            logger.LogError(exception, "Не разобрано обновление {UpdateId}", update.UpdateId);
+        }
+
+        return Results.Ok();
+    }
+}
+
+/// <summary>Что зрительской части нужно знать о боте: настроен ли и как он называется.</summary>
+public sealed record TelegramStatusDto(bool IsConfigured, string? BotUsername);
+
+/// <summary>Тело правки настроек: секреты необязательны — пусто значит «не менять».</summary>
+public sealed record TelegramSettingsBody(
+    bool IsEnabled,
+    TelegramTransport Transport,
+    string? BotToken,
+    string? WebhookUrl,
+    TelegramProxyKind ProxyKind,
+    string? ProxyHost,
+    int? ProxyPort,
+    string? ProxyUsername,
+    string? ProxyPassword
+);

backend/src/TeleWave.Api/Endpoints/TemplateEndpoints.cs

@@ -8,8 +8,12 @@ using TeleWave.Application.Programming.Templates.CopyTemplate;
 using TeleWave.Application.Programming.Templates.CreateSlot;
 using TeleWave.Application.Programming.Templates.CreateTemplate;
 using TeleWave.Application.Programming.Templates.DeleteSlot;
+using TeleWave.Application.Programming.Templates.Generate;
 using TeleWave.Application.Programming.Templates.GetTemplate;
 using TeleWave.Application.Programming.Templates.Layers;
+using TeleWave.Application.Programming.Templates.Reset;
+using TeleWave.Application.Programming.Templates.Restore;
+using TeleWave.Application.Programming.Templates.Transfer;
 using TeleWave.Application.Programming.Templates.UpdateSlot;
 using TeleWave.Application.Programming.Templates.Validate;
 using TeleWave.Infrastructure.Identity;
@@ -43,6 +47,14 @@ public static class TemplateEndpoints
         admin
             .MapPost("/channels/{channelId:guid}/template/apply", ApplyTemplate)
             .Produces<ApplyResultDto>();
+        // Откат правок к состоянию, по которому идёт эфир. Ленту не трогает — она и так по нему.
+        admin
+            .MapPost("/channels/{channelId:guid}/template/restore", RestoreTemplate)
+            .Produces<RestoreTemplateResultDto>();
+        // Сброс сетки вместе с собранным по ней будущим эфиром. Прошлое и идущая запись остаются.
+        admin
+            .MapPost("/channels/{channelId:guid}/template/reset", ResetTemplate)
+            .Produces<ResetTemplateResultDto>();
         // Предпросмотр — тот же генератор, но без записи и без продвижения курсоров.
         admin
             .MapGet("/channels/{channelId:guid}/template/preview", PreviewTemplate)
@@ -62,6 +74,30 @@ public static class TemplateEndpoints
             )
             .Produces<CopyTemplateResultDto>();
 
+        // Автосборка сетки: каталог профилей, план по выбранному и его создание. План считается
+        // одним и тем же кодом, поэтому предпросмотр показывает ровно то, что создаст кнопка.
+        admin
+            .MapGet("/grid-profiles", ListGridProfiles)
+            .Produces<IReadOnlyList<GridProfileDto>>();
+        admin
+            .MapGet("/channels/{channelId:guid}/template/grid-plan", PreviewGrid)
+            .Produces<GridPlanDto>();
+        admin
+            .MapPost("/channels/{channelId:guid}/template/generate", GenerateGrid)
+            .Produces<GenerateGridResultDto>();
+
+        // Обмен конфигурацией: выгрузка файлом, загрузка чужого файла и сборка запроса к ИИ.
+        // Запрос никуда не отправляется — админ копирует его в свою модель и приносит ответ назад.
+        admin
+            .MapGet("/channels/{channelId:guid}/template/export", ExportGrid)
+            .Produces<GridConfig>();
+        admin
+            .MapPost("/channels/{channelId:guid}/template/import", ImportGrid)
+            .Produces<GridImportResultDto>();
+        admin
+            .MapPost("/channels/{channelId:guid}/template/ai-prompt", BuildPrompt)
+            .Produces<GridPromptDto>();
+
         admin
             .MapPost("/templates/{templateId:guid}/layers", CreateLayer)
             .Produces<CreatedIdResponse>(StatusCodes.Status201Created);
@@ -124,6 +160,26 @@ public static class TemplateEndpoints
         return result.ToHttpResult();
     }
 
+    private static async Task<IResult> RestoreTemplate(
+        Guid channelId,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new RestoreTemplateCommand(channelId), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> ResetTemplate(
+        Guid channelId,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new ResetTemplateCommand(channelId), cancellationToken);
+        return result.ToHttpResult();
+    }
+
     private static async Task<IResult> PreviewTemplate(
         Guid channelId,
         ISender sender,
@@ -158,6 +214,82 @@ public static class TemplateEndpoints
         return result.ToHttpResult();
     }
 
+    private static async Task<IResult> ListGridProfiles(
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new ListGridProfilesQuery(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> PreviewGrid(
+        Guid channelId,
+        GridProfileKind profile,
+        GridGenerationMode mode,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new PreviewGeneratedGridQuery(channelId, profile, mode),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> GenerateGrid(
+        Guid channelId,
+        GenerateGridBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new GenerateGridCommand(channelId, body.Profile, body.Mode),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> ExportGrid(
+        Guid channelId,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(new ExportGridQuery(channelId), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> ImportGrid(
+        Guid channelId,
+        ImportGridBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new ImportGridCommand(channelId, body.Config, body.Replace),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> BuildPrompt(
+        Guid channelId,
+        GridPromptBody body,
+        ISender sender,
+        CancellationToken cancellationToken
+    )
+    {
+        var result = await sender.Send(
+            new BuildGridPromptQuery(channelId, body.References ?? [], body.Notes),
+            cancellationToken
+        );
+        return result.ToHttpResult();
+    }
+
     private static async Task<IResult> CopyTemplate(
         Guid channelId,
         Guid targetChannelId,
@@ -286,6 +418,12 @@ public sealed record UpdateTemplateBody(
     PlanningRules? Rules
 );
 
+public sealed record GenerateGridBody(GridProfileKind Profile, GridGenerationMode Mode);
+
+public sealed record ImportGridBody(GridConfig Config, bool Replace);
+
+public sealed record GridPromptBody(IReadOnlyList<string>? References, string? Notes);
+
 public sealed record CreateLayerBody(string Name, int Priority);
 
 public sealed record UpdateLayerBody(

backend/src/TeleWave.Api/Program.cs

@@ -38,26 +38,35 @@ builder.Services.Configure<ForwardedHeadersOptions>(options =>
 {
     options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
 
-    foreach (
+    foreach (var proxy in ReadList(builder.Configuration, "ForwardedHeaders:KnownProxies"))
-        var proxy in builder
-            .Configuration.GetSection("ForwardedHeaders:KnownProxies")
-            .Get<string[]>()
-            ?? []
-    )
         options.KnownProxies.Add(IPAddress.Parse(proxy));
 
-    foreach (
+    foreach (var network in ReadList(builder.Configuration, "ForwardedHeaders:KnownNetworks"))
-        var network in builder
-            .Configuration.GetSection("ForwardedHeaders:KnownNetworks")
-            .Get<string[]>()
-            ?? []
-    )
     {
         var parts = network.Split('/');
         options.KnownIPNetworks.Add(
             new System.Net.IPNetwork(IPAddress.Parse(parts[0]), int.Parse(parts[1]))
         );
     }
+
+    // Список доверенных прокси/сетей приходит из .env одной строкой (env-переменная по одному ключу
+    // в string[] не биндится) — принимаем и запятые, и массив appsettings/индексы __0. Иначе
+    // задокументированная в .env.example запись через запятую молча игнорировалась бы, оставляя
+    // доверие только loopback и обрывая подхват X-Forwarded-Proto.
+    static string[] ReadList(IConfiguration config, string key)
+    {
+        var array = config.GetSection(key).Get<string[]>();
+        if (array is { Length: > 0 })
+            return array;
+
+        var scalar = config[key];
+        return string.IsNullOrWhiteSpace(scalar)
+            ? []
+            : scalar.Split(
+                ',',
+                StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries
+            );
+    }
 });
 
 builder.Services.AddHttpContextAccessor();
@@ -130,13 +139,18 @@ app.MapInterstitialEndpoints();
 app.MapCollectionEndpoints();
 app.MapGroupEndpoints();
 app.MapTemplateEndpoints();
+app.MapBumperEndpoints();
 app.MapJunctionEndpoints();
 app.MapChannelEndpoints();
+app.MapTelegramEndpoints();
 app.MapStreamingEndpoints();
+app.MapIptvEndpoints();
 app.MapMaintenanceEndpoints();
+app.MapStorageEndpoints();
 app.MapSettingsEndpoints();
 app.MapMetadataEndpoints();
 app.MapImageEndpoints();
+app.MapDiagnosticsEndpoints();
 
 // Раздача статики SPA из wwwroot + fallback на index.html для клиентских маршрутов.
 app.UseDefaultFiles();

backend/src/TeleWave.Api/appsettings.Development.json

@@ -20,5 +20,10 @@
   },
   "Storage": {
     "RootPath": ".dev-media"
+  },
+  // Отладочные дампы каналов ложатся в папку репозитория: разбирать «почему сетка построилась
+  // так» приходится рядом с кодом. Путь относительный — от рабочего каталога Api (backend/src/TeleWave.Api).
+  "Debug": {
+    "ExportDirectory": "../../../debug-exports"
   }
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/AddBumperTemplateCommand.cs

@@ -1,7 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Добавить новый блок заставки на канал (звук/фон загружаются отдельно).</summary>
-public sealed record AddBumperTemplateCommand(Guid ChannelId, string Name) : ICommand<Result<Guid>>;

backend/src/TeleWave.Application/Broadcast/Bumpers/AddBumperTemplateCommandHandler.cs

@@ -1,28 +0,0 @@
-using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
-using TeleWave.Application.Common.Interfaces;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class AddBumperTemplateCommandHandler(IAppDbContext dbContext)
-    : ICommandHandler<AddBumperTemplateCommand, Result<Guid>>
-{
-    public async Task<Result<Guid>> Handle(
-        AddBumperTemplateCommand command,
-        CancellationToken cancellationToken
-    )
-    {
-        var channel = await dbContext
-            .Channels.Include(c => c.BumperTemplates)
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure<Guid>(ChannelErrors.NotFound);
-
-        var name = string.IsNullOrWhiteSpace(command.Name)
-            ? $"Заставка {channel.BumperTemplates.Count + 1}"
-            : command.Name.Trim();
-        var template = channel.AddBumperTemplate(name);
-        return Result.Success(template.Id);
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/AddBumperTextVariantCommand.cs

@@ -1,8 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Добавить подблок (текст-вариант) в блок заставки.</summary>
-public sealed record AddBumperTextVariantCommand(Guid ChannelId, Guid TemplateId, string Name)
-    : ICommand<Result<Guid>>;

backend/src/TeleWave.Application/Broadcast/Bumpers/AddBumperTextVariantCommandHandler.cs

@@ -1,34 +0,0 @@
-using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
-using TeleWave.Application.Common.Interfaces;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class AddBumperTextVariantCommandHandler(IAppDbContext dbContext)
-    : ICommandHandler<AddBumperTextVariantCommand, Result<Guid>>
-{
-    public async Task<Result<Guid>> Handle(
-        AddBumperTextVariantCommand command,
-        CancellationToken cancellationToken
-    )
-    {
-        var channel = await dbContext
-            .Channels.Include(c => c.BumperTemplates)
-                .ThenInclude(t => t.Variants)
-            .AsSplitQuery()
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure<Guid>(ChannelErrors.NotFound);
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
-        if (template is null)
-            return Result.Failure<Guid>(ChannelErrors.BumperTemplateNotFound);
-
-        var name = string.IsNullOrWhiteSpace(command.Name)
-            ? $"Текст {template.Variants.Count + 1}"
-            : command.Name.Trim();
-        var variant = template.AddVariant(name);
-        return Result.Success(variant.Id);
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/AddBumperVariantCommandHandler.cs

@@ -0,0 +1,27 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class AddBumperVariantCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<AddBumperVariantCommand, Result<Guid>>
+{
+    public async Task<Result<Guid>> Handle(
+        AddBumperVariantCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var template = await BumperTemplateLoader.LoadAsync(
+            dbContext,
+            command.TemplateId,
+            cancellationToken
+        );
+        if (template is null)
+            return Result.Failure<Guid>(BumperErrors.TemplateNotFound);
+
+        var variant = template.AddVariant(command.Name);
+        variant.SetLines(BumperTemplateLoader.DefaultLines());
+        return Result.Success(variant.Id);
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperCommands.cs

@@ -0,0 +1,104 @@
+using FluentValidation;
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed record ListBumperTemplatesQuery : IQuery<IReadOnlyList<BumperTemplateDto>>;
+
+public sealed record CreateBumperTemplateCommand(string Name) : ICommand<Result<Guid>>;
+
+/// <summary>Оформление блока: имя, шрифт и палитра. Меняет ревизию — заставки пересобираются.</summary>
+public sealed record UpdateBumperTemplateCommand(Guid TemplateId, BumperStyle Style)
+    : ICommand<Result>;
+
+public sealed record DeleteBumperTemplateCommand(Guid TemplateId) : ICommand<Result>;
+
+public sealed record SetBumperTemplateAudioCommand(
+    Guid TemplateId,
+    string Extension,
+    double DurationSeconds
+) : ICommand<Result>;
+
+public sealed record ClearBumperTemplateAudioCommand(Guid TemplateId) : ICommand<Result>;
+
+public sealed record SetBumperTemplateBackgroundCommand(Guid TemplateId, Guid ImageId)
+    : ICommand<Result>;
+
+public sealed record ClearBumperTemplateBackgroundCommand(Guid TemplateId) : ICommand<Result>;
+
+public sealed record AddBumperVariantCommand(Guid TemplateId, string Name) : ICommand<Result<Guid>>;
+
+/// <summary>Полное содержимое подблока — строки редактор всегда присылает списком целиком.</summary>
+public sealed record BumperVariantInput(
+    string Name,
+    BumperTrigger Trigger,
+    BumperBackground Background,
+    int Weight,
+    IReadOnlyList<BumperLineDto> Lines,
+    /// <summary>Ролик-подложка для фона <see cref="BumperBackground.Clip"/>.</summary>
+    Guid? BackgroundClipShowId = null
+);
+
+public sealed record UpdateBumperVariantCommand(
+    Guid TemplateId,
+    Guid VariantId,
+    BumperVariantInput Input
+) : ICommand<Result>;
+
+public sealed record RemoveBumperVariantCommand(Guid TemplateId, Guid VariantId) : ICommand<Result>;
+
+/// <summary>
+/// Рендер примера заставки. Канал нужен только для образцов подстановки: блок общий, но посмотреть
+/// его надо глазами конкретного канала — иначе <c>{channel}</c> не на что заменить.
+/// </summary>
+public sealed record RenderBumperPreviewCommand(Guid TemplateId, Guid? ChannelId)
+    : ICommand<Result>;
+
+public sealed class CreateBumperTemplateCommandValidator
+    : AbstractValidator<CreateBumperTemplateCommand>
+{
+    public CreateBumperTemplateCommandValidator() =>
+        RuleFor(x => x.Name).NotEmpty().MaximumLength(64);
+}
+
+public sealed class UpdateBumperTemplateCommandValidator
+    : AbstractValidator<UpdateBumperTemplateCommand>
+{
+    public UpdateBumperTemplateCommandValidator()
+    {
+        RuleFor(x => x.Style.Name).NotEmpty().MaximumLength(64);
+        RuleFor(x => x.Style.BackgroundColor).NotEmpty().MaximumLength(32);
+        RuleFor(x => x.Style.BackgroundColor2).NotEmpty().MaximumLength(32);
+        RuleFor(x => x.Style.AccentColor).NotEmpty().MaximumLength(32);
+        RuleFor(x => x.Style.TextColor).NotEmpty().MaximumLength(32);
+    }
+}
+
+public sealed class AddBumperVariantCommandValidator : AbstractValidator<AddBumperVariantCommand>
+{
+    public AddBumperVariantCommandValidator() => RuleFor(x => x.Name).NotEmpty().MaximumLength(64);
+}
+
+public sealed class UpdateBumperVariantCommandValidator
+    : AbstractValidator<UpdateBumperVariantCommand>
+{
+    /// <summary>Больше шести строк в кадр не помещается ни при каком размере шрифта.</summary>
+    private const int MaxLines = 6;
+
+    public UpdateBumperVariantCommandValidator()
+    {
+        RuleFor(x => x.Input.Name).NotEmpty().MaximumLength(64);
+        RuleFor(x => x.Input.Weight).InclusiveBetween(0, 1000);
+        RuleFor(x => x.Input.Lines).NotNull().Must(l => l.Count <= MaxLines);
+        RuleForEach(x => x.Input.Lines)
+            .ChildRules(line => line.RuleFor(l => l.Text).NotEmpty().MaximumLength(120));
+
+        // Фон из ролика без самого ролика — это не «пока не выбрал», а заставка, которая молча
+        // отрендерится градиентом. Пусть выбор будет обязательным сразу.
+        RuleFor(x => x.Input.BackgroundClipShowId)
+            .NotNull()
+            .When(x => x.Input.Background == BumperBackground.Clip);
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperDtos.cs

@@ -0,0 +1,36 @@
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>Строка заставки: роль, цвет из палитры блока и текст с плейсхолдерами.</summary>
+public sealed record BumperLineDto(BumperLineStyle Style, BumperLineColor Color, string Text);
+
+/// <summary>Подблок (текст-вариант): свои строки, фон и правило показа поверх оформления блока.</summary>
+public sealed record BumperTextVariantDto(
+    Guid Id,
+    int Position,
+    string Name,
+    BumperTrigger Trigger,
+    BumperBackground Background,
+    int Weight,
+    IReadOnlyList<BumperLineDto> Lines,
+    /// <summary>Ролик-подложка для фона <see cref="BumperBackground.Clip"/>.</summary>
+    Guid? BackgroundClipShowId
+);
+
+/// <summary>Блок заставки: оформление + звук + подблоки. <see cref="AudioDurationSeconds"/> — длина звука (сек).</summary>
+public sealed record BumperTemplateDto(
+    Guid Id,
+    string Name,
+    BumperFont Font,
+    string BackgroundColor,
+    string BackgroundColor2,
+    string AccentColor,
+    string TextColor,
+    Guid? BackgroundImageId,
+    bool HasAudio,
+    double? AudioDurationSeconds,
+    /// <summary>Во скольких врезках стыков используется блок — блоки общие, и это надо видеть до правки.</summary>
+    int UsageCount,
+    IReadOnlyList<BumperTextVariantDto> Variants
+);

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperErrors.cs

@@ -0,0 +1,48 @@
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>Ошибки блоков заставок. Блоки общие для всех каналов, поэтому и каталог свой, не канальный.</summary>
+public static class BumperErrors
+{
+    public static readonly Error TemplateNotFound = Error.NotFound(
+        "Bumpers.TemplateNotFound",
+        "Блок заставки не найден."
+    );
+
+    public static readonly Error VariantNotFound = Error.NotFound(
+        "Bumpers.VariantNotFound",
+        "Подблок заставки не найден."
+    );
+
+    public static readonly Error CannotRemoveLastVariant = Error.Validation(
+        "Bumpers.CannotRemoveLastVariant",
+        "Нельзя удалить последний подблок — нужен хотя бы один."
+    );
+
+    /// <summary>Блок общий: держат его врезки конкретных стыков, их и перечисляем.</summary>
+    public static Error TemplateInUse(string where) =>
+        Error.Conflict(
+            "Bumpers.TemplateInUse",
+            where.Length > 0
+                ? $"Блок заставки используется во врезках стыков ({where}) — уберите его оттуда."
+                : "Блок заставки используется во врезках стыков."
+        );
+
+    public static readonly Error VariantInUse = Error.Conflict(
+        "Bumpers.VariantInUse",
+        "Подблок заставки выбран во врезке стыка."
+    );
+
+    public static readonly Error InvalidFile = Error.Validation(
+        "Bumpers.InvalidFile",
+        "Недопустимый файл заставки (формат или размер)."
+    );
+
+    /// <summary>Неизвестный плейсхолдер — ошибка ввода: в эфире его бы уже никто не заметил.</summary>
+    public static Error UnknownPlaceholders(IEnumerable<string> tokens) =>
+        Error.Validation(
+            "Bumpers.UnknownPlaceholders",
+            $"Неизвестные плейсхолдеры: {string.Join(", ", tokens.Select(t => $"{{{t}}}"))}."
+        );
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperMapper.cs

@@ -0,0 +1,37 @@
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>Ручной маппинг блока заставки в DTO — одна точка на список и на карточку.</summary>
+public static class BumperMapper
+{
+    public static BumperTemplateDto ToDto(BumperTemplate template, int usageCount) =>
+        new(
+            template.Id,
+            template.Name,
+            template.Font,
+            template.BackgroundColor,
+            template.BackgroundColor2,
+            template.AccentColor,
+            template.TextColor,
+            template.BackgroundImageId,
+            template.AudioExtension is not null,
+            template.AudioDurationSeconds,
+            usageCount,
+            template
+                .Variants.OrderBy(v => v.Position)
+                .Select(v => new BumperTextVariantDto(
+                    v.Id,
+                    v.Position,
+                    v.Name,
+                    v.Trigger,
+                    v.Background,
+                    v.Weight,
+                    v.Lines.OrderBy(l => l.Position)
+                        .Select(l => new BumperLineDto(l.Style, l.Color, l.Text))
+                        .ToList(),
+                    v.BackgroundClipShowId
+                ))
+                .ToList()
+        );
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperPlaceholders.cs

@@ -0,0 +1,201 @@
+using System.Globalization;
+using System.Text;
+using System.Text.RegularExpressions;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>
+/// Чем подставляются плейсхолдеры одной заставки. Собирает контекст планировщик — только он знает
+/// и пару соседей, и точное время показа; редактор подставляет те же поля образцами.
+/// </summary>
+public sealed record BumperContext(
+    string ChannelName,
+    int? ChannelNumber,
+    /// <summary>Момент показа заставки во времени канала.</summary>
+    DateTimeOffset LocalMoment,
+    string? NowTitle = null,
+    string? NextTitle = null,
+    string? NowEpisode = null,
+    string? NextEpisode = null,
+    int? NextYear = null,
+    string? NextGenre = null,
+    /// <summary>Во сколько начнётся следующая программа (время канала).</summary>
+    TimeOnly? NextTime = null,
+    string? SlotTitle = null,
+    /// <summary>Что и когда идёт вечером этих вещательных суток — для анонсов.</summary>
+    BumperAnnouncement? Tonight = null,
+    BumperAnnouncement? Tomorrow = null
+);
+
+/// <summary>Анонсируемая программа: что и во сколько. Null — анонсировать нечего, строка схлопнется.</summary>
+public sealed record BumperAnnouncement(string Title, TimeOnly Time);
+
+/// <summary>
+/// Плейсхолдеры текста заставки: «ДАЛЕЕ В {next.time}» → «ДАЛЕЕ В 21:30».
+///
+/// Список закрытый и проверяется при сохранении: незнакомый плейсхолдер — ошибка ввода, а не
+/// сюрприз в эфире, где его уже не увидит никто, кроме зрителя.
+/// </summary>
+public static partial class BumperPlaceholders
+{
+    /// <summary>Все допустимые имена. Описания и образцы живут в локалях редактора, не здесь.</summary>
+    public static readonly IReadOnlySet<string> Tokens = new HashSet<string>(StringComparer.Ordinal)
+    {
+        "channel",
+        "channel.number",
+        "now.title",
+        "next.title",
+        "now.episode",
+        "next.episode",
+        "next.year",
+        "next.genre",
+        "next.time",
+        "tonight.title",
+        "tonight.time",
+        "tomorrow.title",
+        "tomorrow.time",
+        "time",
+        "date",
+        "weekday",
+        "slot",
+    };
+
+    /// <summary>
+    /// Плейсхолдеры, привязанные к моменту показа. Каждое их значение уникально, поэтому кэш
+    /// отрендеренных заставок с ними перестаёт работать — редактор обязан об этом предупредить.
+    /// </summary>
+    public static readonly IReadOnlySet<string> VolatileTokens = new HashSet<string>(
+        StringComparer.Ordinal
+    )
+    {
+        "time",
+        "date",
+        "weekday",
+    };
+
+    // Русская культура фиксирована: заставка рендерится один раз в видео, локали зрителя у неё нет.
+    private static readonly CultureInfo Culture = CultureInfo.GetCultureInfo("ru-RU");
+
+    /// <summary>Время в кадре — только часы и минуты: секунды в заставке не читаются.</summary>
+    private const string TimeFormat = "HH:mm";
+
+    [GeneratedRegex(@"\{([a-zA-Z][a-zA-Z.]*)\}", RegexOptions.CultureInvariant)]
+    private static partial Regex TokenPattern();
+
+    [GeneratedRegex(@"[ \t]{2,}", RegexOptions.CultureInvariant)]
+    private static partial Regex ExtraSpaces();
+
+    /// <summary>Разделители, которые остаются висеть, когда подставлять оказалось нечего.</summary>
+    private static readonly char[] DanglingSeparators = ['—', '–', '-', ':', '·', ',', ';', '/'];
+
+    /// <summary>
+    /// Подставляет значения. Неизвестное значение даёт пустую строку, а осиротевшие разделители
+    /// по краям убираются: «СЕЙЧАС — {now.title}» без текущей программы должно стать «СЕЙЧАС»,
+    /// а не «СЕЙЧАС —».
+    ///
+    /// Строка, в которой не подставился ни один плейсхолдер, исчезает целиком: она и писалась ради
+    /// данных, а «ДАЛЕЕ В» без времени — это не подпись, а мусор в кадре. Строки без плейсхолдеров
+    /// это не касается: они и есть постоянный текст.
+    /// </summary>
+    public static string Resolve(string text, BumperContext context)
+    {
+        if (string.IsNullOrWhiteSpace(text))
+            return string.Empty;
+
+        var tokens = TokenPattern().Matches(text);
+        if (tokens.Count == 0)
+            return Clean(text);
+
+        // Собираем строку сами, а не через Replace с лямбдой: подстановку надо не только сделать,
+        // но и сосчитать, а счётчик в замыкании читается хуже и не виден анализаторам.
+        var builder = new StringBuilder();
+        var cursor = 0;
+        var filled = 0;
+
+        foreach (Match token in tokens)
+        {
+            builder.Append(text, cursor, token.Index - cursor);
+            cursor = token.Index + token.Length;
+
+            var value = Value(token.Groups[1].Value, context);
+            if (string.IsNullOrWhiteSpace(value))
+                continue;
+
+            builder.Append(value);
+            filled++;
+        }
+
+        if (filled == 0)
+            return string.Empty;
+
+        builder.Append(text, cursor, text.Length - cursor);
+        return Clean(builder.ToString());
+    }
+
+    /// <summary>Схлопывает лишние пробелы и снимает осиротевшие разделители по краям.</summary>
+    private static string Clean(string text) =>
+        ExtraSpaces().Replace(text, " ").Trim().Trim(DanglingSeparators).Trim();
+
+    /// <summary>Какие плейсхолдеры встречаются в текстах — по ним планировщик решает, что грузить.</summary>
+    public static IReadOnlySet<string> TokensIn(IEnumerable<string> texts)
+    {
+        var matches = texts
+            .Where(t => !string.IsNullOrWhiteSpace(t))
+            .SelectMany(text => TokenPattern().Matches(text))
+            .Select(match => match.Groups[1].Value);
+
+        return new HashSet<string>(matches, StringComparer.Ordinal);
+    }
+
+    /// <summary>Плейсхолдеры текста, которых нет в списке допустимых.</summary>
+    public static IReadOnlyList<string> UnknownTokens(string? text)
+    {
+        if (string.IsNullOrWhiteSpace(text))
+            return [];
+
+        return TokenPattern()
+            .Matches(text)
+            .Select(m => m.Groups[1].Value)
+            .Where(token => !Tokens.Contains(token))
+            .Distinct(StringComparer.Ordinal)
+            .ToList();
+    }
+
+    /// <summary>Есть ли в тексте плейсхолдер, привязанный к моменту показа (ломает кэш рендера).</summary>
+    public static bool IsVolatile(string? text) =>
+        !string.IsNullOrWhiteSpace(text)
+        && TokenPattern().Matches(text).Any(m => VolatileTokens.Contains(m.Groups[1].Value));
+
+    private static string? Value(string token, BumperContext context) =>
+        token switch
+        {
+            "channel" => context.ChannelName,
+            "channel.number" => context.ChannelNumber?.ToString(Culture),
+            "now.title" => context.NowTitle,
+            "next.title" => context.NextTitle,
+            "now.episode" => context.NowEpisode,
+            "next.episode" => context.NextEpisode,
+            "next.year" => context.NextYear?.ToString(Culture),
+            "next.genre" => context.NextGenre,
+            "next.time" => context.NextTime?.ToString(TimeFormat, Culture),
+            "tonight.title" => context.Tonight?.Title,
+            "tonight.time" => context.Tonight?.Time.ToString(TimeFormat, Culture),
+            "tomorrow.title" => context.Tomorrow?.Title,
+            "tomorrow.time" => context.Tomorrow?.Time.ToString(TimeFormat, Culture),
+            "time" => TimeOnly
+                .FromDateTime(context.LocalMoment.DateTime)
+                .ToString(TimeFormat, Culture),
+            "date" => context.LocalMoment.ToString("d MMMM", Culture),
+            "weekday" => context.LocalMoment.ToString("dddd", Culture),
+            "slot" => context.SlotTitle,
+            _ => null,
+        };
+
+    /// <summary>Подпись серии в эфирном виде: «с5э12», либо просто номер, если сезон не распознан.</summary>
+    public static string? Episode(int? season, int? episode)
+    {
+        if (season is { } s and > 0 && episode is { } e and > 0)
+            return string.Create(Culture, $"с{s}э{e}");
+        return episode is { } only and > 0 ? string.Create(Culture, $"э{only}") : null;
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperRenderedText.cs

@@ -0,0 +1,37 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using TeleWave.Application.Common.Interfaces;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>
+/// Сериализация готовых строк заставки в кэш-запись. Хранить подставленный текст обязательно:
+/// время показа и пара соседей из ссылок задним числом не восстанавливаются, а ffmpeg запускается
+/// фоновым сервисом уже после того, как лента записана.
+/// </summary>
+public static class BumperRenderedText
+{
+    private static readonly JsonSerializerOptions Options = new()
+    {
+        PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+        Converters = { new JsonStringEnumConverter() },
+    };
+
+    public static string ToJson(IReadOnlyList<BumperRenderLine> lines) =>
+        JsonSerializer.Serialize(lines, Options);
+
+    public static IReadOnlyList<BumperRenderLine> FromJson(string? json)
+    {
+        if (string.IsNullOrWhiteSpace(json))
+            return [];
+
+        try
+        {
+            return JsonSerializer.Deserialize<List<BumperRenderLine>>(json, Options) ?? [];
+        }
+        catch (JsonException)
+        {
+            return [];
+        }
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperSpecFactory.cs

@@ -4,22 +4,18 @@ using TeleWave.Domain.Broadcast;
 namespace TeleWave.Application.Broadcast.Bumpers;
 
 /// <summary>
-/// Чистая сборка <see cref="BumperRenderSpec"/> из уже разрешённых входов (пути к постеру/фону/звуку,
+/// Чистая сборка <see cref="BumperRenderSpec"/> из уже разрешённых входов (готовые строки, пути к
-/// названия шоу). Общая точка для фонового рендерера заставок расписания и превью в админке.
+/// постеру/фону/звуку). Общая точка для фонового рендерера заставок расписания и превью в админке.
 /// </summary>
 public static class BumperSpecFactory
 {
     public static BumperRenderSpec Build(
         BumperOptions bumper,
-        BumperFont font,
         BumperTemplate template,
-        BumperTextVariant variant,
         int alignedDurationSeconds,
         BumperSpecInputs inputs
-    )
+    ) =>
-    {
+        new(
-        var free = variant.Kind == BumperTextKind.Free;
-        return new BumperRenderSpec(
             alignedDurationSeconds,
             bumper.Width,
             bumper.Height,
@@ -27,17 +23,14 @@ public static class BumperSpecFactory
             template.BackgroundColor2,
             template.AccentColor,
             template.TextColor,
-            font == BumperFont.Serif ? bumper.FontFileSerif : bumper.FontFileSans,
+            template.Font == BumperFont.Serif ? bumper.FontFileSerif : bumper.FontFileSans,
-            free ? "" : variant.NowLabel,
+            inputs.Lines,
-            free ? "" : inputs.FromName,
-            free ? "" : variant.NextLabel,
-            free ? "" : inputs.ToName,
             inputs.BackgroundAbsolutePath,
             inputs.AudioPath,
             inputs.PosterAbsolutePath,
-            free,
+            inputs.ClipAbsolutePath,
-            variant.Line1,
+            // Джингл назначен — он и звучит, подрезанный под ролик; не назначен — играет
-            variant.Line2
+            // оригинальная дорожка ролика.
+            UseClipAudio: inputs.ClipAbsolutePath is not null && inputs.AudioPath is null
         );
 }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperSpecInputs.cs

@@ -1,15 +1,18 @@
+using TeleWave.Application.Common.Interfaces;
+
 namespace TeleWave.Application.Broadcast.Bumpers;
 
 /// <summary>
-/// Уже разрешённые входы рендера заставки: названия шоу «из/в» и пути к файлам. Разрешает их
+/// Уже разрешённые входы рендера заставки: готовые строки (плейсхолдеры подставлены) и пути к
-/// вызывающий (генератор эфира — по реальной паре соседей, превью — по образцам канала), а
+/// файлам. Разрешает их вызывающий — генератор эфира по реальной паре соседей, редактор по
-/// <see cref="BumperSpecFactory"/> только раскладывает их по спецификации.
+/// образцам, — а <see cref="BumperSpecFactory"/> только раскладывает их по спецификации.
 /// </summary>
 public sealed record BumperSpecInputs(
-    string FromName,
+    IReadOnlyList<BumperRenderLine> Lines,
-    string ToName,
     string? AudioPath = null,
-    /// <summary>Постер «следующего» шоу как фон; в превью не подставляется — шоу ещё неизвестно.</summary>
+    /// <summary>Постер шоу как фон; подставляется, только если подблок его запросил.</summary>
     string? PosterAbsolutePath = null,
-    string? BackgroundAbsolutePath = null
+    string? BackgroundAbsolutePath = null,
+    /// <summary>Плейлист ролика-подложки, если текст пишется поверх готового видео.</summary>
+    string? ClipAbsolutePath = null
 );

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperSpecLoader.cs

@@ -4,19 +4,20 @@ using TeleWave.Application.Broadcast.Scheduling;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Streaming;
 using TeleWave.Domain.Broadcast;
+using TeleWave.Domain.Media;
 
 namespace TeleWave.Application.Broadcast.Bumpers;
 
 /// <summary>
-/// Восстанавливает <see cref="BumperRenderSpec"/> по кэш-строке заставки: планировщик сохранил только
+/// Восстанавливает <see cref="BumperRenderSpec"/> по кэш-строке заставки: планировщик сохранил
-/// ссылки (канал/блок/подблок/пара шоу), а рендеру нужны названия шоу и абсолютные пути к звуку,
+/// готовые строки и ссылку на блок, а рендеру нужны ещё абсолютные пути к звуку, постеру и фону.
-/// постеру и фону. Вынесено из фонового рендерера: чтение и сборка — работа слоя приложения,
+/// Вынесено из фонового рендерера: чтение и сборка — работа слоя приложения, воркер лишь крутит ffmpeg.
-/// воркер лишь крутит ffmpeg.
 /// </summary>
 public sealed class BumperSpecLoader(
     IAppDbContext dbContext,
     IBumperTemplateStorage bumperStorage,
     IImageStore imageStore,
+    IMediaStorage mediaStorage,
     IOptions<BumperOptions> bumperOptions,
     IOptions<StreamingOptions> streamingOptions
 )
@@ -38,50 +39,63 @@ public sealed class BumperSpecLoader(
         if (cache is null)
             return null;
 
-        var channel = await dbContext
+        var template = await dbContext
-            .Channels.AsNoTracking()
+            .BumperTemplates.AsNoTracking()
-            .Include(c => c.BumperTemplates)
+            .FirstOrDefaultAsync(t => t.Id == cache.TemplateId, cancellationToken);
-                .ThenInclude(t => t.Variants)
+        if (template is null)
-            .AsSplitQuery()
-            .FirstOrDefaultAsync(c => c.Id == cache.ChannelId, cancellationToken);
-        var template = channel?.BumperTemplates.FirstOrDefault(t => t.Id == cache.TemplateId);
-        var variant = template?.Variants.FirstOrDefault(v => v.Id == cache.VariantId);
-        if (channel is null || template is null || variant is null)
             return null;
 
-        var names = await dbContext
+        var posterPath = cache.PosterShowId is { } showId
-            .Shows.AsNoTracking()
+            ? await ResolveShowPosterAsync(showId, cancellationToken)
-            .Where(s => s.Id == cache.FromShowId || s.Id == cache.ToShowId)
+            : null;
-            .Select(s => new { s.Id, s.Name })
-            .ToDictionaryAsync(s => s.Id, s => s.Name, cancellationToken);
-
-        // Постер шоу-получателя как фон — только для «Сейчас/Далее».
-        string? posterPath = null;
-        if (variant.Kind == BumperTextKind.NowNext)
-            posterPath = await ResolveShowPosterAsync(cache.ToShowId, cancellationToken);
-
         var bgPath = await ResolveImagePathAsync(template.BackgroundImageId, cancellationToken);
+        var (clipPath, clipSeconds) = await ResolveClipAsync(
+            cache.BackgroundAssetId,
+            cancellationToken
+        );
+
+        // Длину задаёт ролик, если он есть: подрезать чужую заставку под джингл значило бы обрывать
+        // её на полуслове. Выравнивание по сегменту остаётся — лента этого требует от любой записи.
         var aligned = BumperDuration.Aligned(
-            BumperDuration.TemplateSeconds(template),
+            clipSeconds ?? BumperDuration.TemplateSeconds(template),
             _segmentSeconds
         );
 
         return BumperSpecFactory.Build(
             _bumper,
-            channel.BumperFont,
             template,
-            variant,
             aligned,
             new BumperSpecInputs(
-                names.GetValueOrDefault(cache.FromShowId, "…"),
+                BumperRenderedText.FromJson(cache.RenderedLinesJson),
-                names.GetValueOrDefault(cache.ToShowId, "…"),
                 bumperStorage.AudioPath(template.Id, template.AudioExtension),
                 posterPath,
-                bgPath
+                bgPath,
+                clipPath
             )
         );
     }
 
+    /// <summary>Плейлист ролика-подложки и его длительность; null — ролика уже нет или он не готов.</summary>
+    private async Task<(string? Path, int? Seconds)> ResolveClipAsync(
+        Guid? assetId,
+        CancellationToken cancellationToken
+    )
+    {
+        if (assetId is not { } id)
+            return (null, null);
+
+        var duration = await dbContext
+            .MediaAssets.AsNoTracking()
+            .Where(a => a.Id == id && a.Status == MediaAssetStatus.Ready)
+            .Select(a => a.Duration)
+            .FirstOrDefaultAsync(cancellationToken);
+        if (duration is not { } value || value <= TimeSpan.Zero)
+            return (null, null);
+
+        var path = mediaStorage.ResolvePlaylistPath(id);
+        return path is null ? (null, null) : (path, (int)Math.Ceiling(value.TotalSeconds));
+    }
+
     private async Task<string?> ResolveShowPosterAsync(
         Guid showId,
         CancellationToken cancellationToken

backend/src/TeleWave.Application/Broadcast/Bumpers/BumperTemplateLoader.cs

@@ -0,0 +1,27 @@
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+/// <summary>Общее для команд блока заставки: загрузка вместе с подблоками и строками.</summary>
+internal static class BumperTemplateLoader
+{
+    public static Task<BumperTemplate?> LoadAsync(
+        IAppDbContext dbContext,
+        Guid templateId,
+        CancellationToken cancellationToken
+    ) =>
+        dbContext
+            .BumperTemplates.Include(t => t.Variants)
+            .FirstOrDefaultAsync(t => t.Id == templateId, cancellationToken);
+
+    /// <summary>Строки подблока «Сейчас / Далее» — с них начинается новый блок.</summary>
+    public static IReadOnlyList<BumperLine> DefaultLines() =>
+        [
+            BumperLine.Create(0, BumperLineStyle.Label, BumperLineColor.Accent, "СЕЙЧАС"),
+            BumperLine.Create(1, BumperLineStyle.Title, BumperLineColor.Text, "{now.title}"),
+            BumperLine.Create(2, BumperLineStyle.Label, BumperLineColor.Accent, "ДАЛЕЕ"),
+            BumperLine.Create(3, BumperLineStyle.Title, BumperLineColor.Text, "{next.title}"),
+        ];
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/ClearBumperTemplateAudioCommand.cs

@@ -1,8 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Удалить загруженный звук блока (вернуться к синтезированному джинглу).</summary>
-public sealed record ClearBumperTemplateAudioCommand(Guid ChannelId, Guid TemplateId)
-    : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/ClearBumperTemplateAudioCommandHandler.cs

@@ -1,5 +1,4 @@
 using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 
@@ -15,19 +14,16 @@ public sealed class ClearBumperTemplateAudioCommandHandler(
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await BumperTemplateLoader.LoadAsync(
-            .Channels.Include(c => c.BumperTemplates)
+            dbContext,
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
+            command.TemplateId,
-        if (channel is null)
+            cancellationToken
-            return Result.Failure(ChannelErrors.NotFound);
+        );
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
         if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
+            return Result.Failure(BumperErrors.TemplateNotFound);
 
         template.ClearAudio();
-        await dbContext.SaveChangesAsync(cancellationToken);
+        await storage.DeleteAudioAsync(template.Id, cancellationToken);
-        await storage.DeleteAudioAsync(command.TemplateId, cancellationToken);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/ClearBumperTemplateBackgroundCommand.cs

@@ -1,8 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Удалить загруженную фон-картинку блока (вернуться к градиенту/постеру).</summary>
-public sealed record ClearBumperTemplateBackgroundCommand(Guid ChannelId, Guid TemplateId)
-    : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/ClearBumperTemplateBackgroundCommandHandler.cs

@@ -1,5 +1,4 @@
 using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 
@@ -13,17 +12,14 @@ public sealed class ClearBumperTemplateBackgroundCommandHandler(IAppDbContext db
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await BumperTemplateLoader.LoadAsync(
-            .Channels.Include(c => c.BumperTemplates)
+            dbContext,
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
+            command.TemplateId,
-        if (channel is null)
+            cancellationToken
-            return Result.Failure(ChannelErrors.NotFound);
+        );
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
         if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
+            return Result.Failure(BumperErrors.TemplateNotFound);
 
-        // Отвязываем фон; сама картинка остаётся в галерее.
         template.ClearBackgroundImage();
         return Result.Success();
     }

backend/src/TeleWave.Application/Broadcast/Bumpers/CreateBumperTemplateCommandHandler.cs

@@ -0,0 +1,24 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class CreateBumperTemplateCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<CreateBumperTemplateCommand, Result<Guid>>
+{
+    private const string DefaultVariantName = "Текст 1";
+
+    public Task<Result<Guid>> Handle(
+        CreateBumperTemplateCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var template = BumperTemplate.Create(command.Name, DefaultVariantName);
+        // Пустой блок в редакторе выглядит поломанным — новый начинается с «Сейчас / Далее».
+        template.Variants[0].SetLines(BumperTemplateLoader.DefaultLines());
+        dbContext.BumperTemplates.Add(template);
+        return Task.FromResult(Result.Success(template.Id));
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/DeleteBumperTemplateCommandHandler.cs

@@ -0,0 +1,53 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class DeleteBumperTemplateCommandHandler(
+    IAppDbContext dbContext,
+    IBumperTemplateStorage storage
+) : ICommandHandler<DeleteBumperTemplateCommand, Result>
+{
+    public async Task<Result> Handle(
+        DeleteBumperTemplateCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var template = await BumperTemplateLoader.LoadAsync(
+            dbContext,
+            command.TemplateId,
+            cancellationToken
+        );
+        if (template is null)
+            return Result.Failure(BumperErrors.TemplateNotFound);
+
+        // Блок общий: удалив используемый, мы бы молча выключили заставки в чужих каналах.
+        var used = await dbContext.JunctionElements.AnyAsync(
+            e => e.BumperTemplateId == template.Id,
+            cancellationToken
+        );
+        if (used)
+        {
+            // Имя стыка — по связи врезки с ним; факт использования проверен отдельно и раньше.
+            var junctions = await (
+                from element in dbContext.JunctionElements
+                join junction in dbContext.JunctionTemplates
+                    on element.JunctionTemplateId equals junction.Id
+                where element.BumperTemplateId == template.Id
+                select junction.Name
+            )
+                .Distinct()
+                .ToListAsync(cancellationToken);
+
+            return Result.Failure(
+                BumperErrors.TemplateInUse(UsageText.Part("стыки", junctions) ?? string.Empty)
+            );
+        }
+
+        dbContext.BumperTemplates.Remove(template);
+        await storage.DeleteAudioAsync(template.Id, cancellationToken);
+        return Result.Success();
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/ListBumperTemplatesQueryHandler.cs

@@ -0,0 +1,32 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Domain.Programming;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class ListBumperTemplatesQueryHandler(IAppDbContext dbContext)
+    : IQueryHandler<ListBumperTemplatesQuery, IReadOnlyList<BumperTemplateDto>>
+{
+    public async Task<IReadOnlyList<BumperTemplateDto>> Handle(
+        ListBumperTemplatesQuery query,
+        CancellationToken cancellationToken
+    )
+    {
+        var templates = await dbContext
+            .BumperTemplates.AsNoTracking()
+            .Include(t => t.Variants)
+            .OrderBy(t => t.Name)
+            .ToListAsync(cancellationToken);
+
+        // Блоки общие, поэтому «сколько врезок на меня ссылается» — не справка, а условие правки.
+        var usage = await dbContext
+            .JunctionElements.AsNoTracking()
+            .Where(e => e.Kind == JunctionElementKind.Bumper && e.BumperTemplateId != null)
+            .GroupBy(e => e.BumperTemplateId!.Value)
+            .Select(g => new { TemplateId = g.Key, Count = g.Count() })
+            .ToDictionaryAsync(x => x.TemplateId, x => x.Count, cancellationToken);
+
+        return templates.Select(t => BumperMapper.ToDto(t, usage.GetValueOrDefault(t.Id))).ToList();
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperTemplateCommand.cs

@@ -1,8 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Удалить блок заставки (кроме дефолтного) и его файлы.</summary>
-public sealed record RemoveBumperTemplateCommand(Guid ChannelId, Guid TemplateId)
-    : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperTemplateCommandHandler.cs

@@ -1,35 +0,0 @@
-using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
-using TeleWave.Application.Common.Interfaces;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class RemoveBumperTemplateCommandHandler(
-    IAppDbContext dbContext,
-    IBumperTemplateStorage storage
-) : ICommandHandler<RemoveBumperTemplateCommand, Result>
-{
-    public async Task<Result> Handle(
-        RemoveBumperTemplateCommand command,
-        CancellationToken cancellationToken
-    )
-    {
-        var channel = await dbContext
-            .Channels.Include(c => c.BumperTemplates)
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure(ChannelErrors.NotFound);
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
-        if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
-        if (template.IsDefault)
-            return Result.Failure(ChannelErrors.CannotRemoveDefaultBumperTemplate);
-
-        channel.RemoveBumperTemplate(command.TemplateId);
-        await dbContext.SaveChangesAsync(cancellationToken);
-        await storage.DeleteTemplateAsync(command.TemplateId, cancellationToken);
-        return Result.Success();
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperTextVariantCommand.cs

@@ -1,8 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Удалить подблок (кроме последнего) из блока заставки.</summary>
-public sealed record RemoveBumperTextVariantCommand(Guid ChannelId, Guid TemplateId, Guid VariantId)
-    : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperTextVariantCommandHandler.cs

@@ -1,34 +0,0 @@
-using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
-using TeleWave.Application.Common.Interfaces;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class RemoveBumperTextVariantCommandHandler(IAppDbContext dbContext)
-    : ICommandHandler<RemoveBumperTextVariantCommand, Result>
-{
-    public async Task<Result> Handle(
-        RemoveBumperTextVariantCommand command,
-        CancellationToken cancellationToken
-    )
-    {
-        var channel = await dbContext
-            .Channels.Include(c => c.BumperTemplates)
-                .ThenInclude(t => t.Variants)
-            .AsSplitQuery()
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure(ChannelErrors.NotFound);
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
-        if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
-        if (template.FindVariant(command.VariantId) is null)
-            return Result.Failure(ChannelErrors.BumperTextVariantNotFound);
-
-        return template.RemoveVariant(command.VariantId)
-            ? Result.Success()
-            : Result.Failure(ChannelErrors.CannotRemoveLastBumperTextVariant);
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperVariantCommandHandler.cs

@@ -0,0 +1,39 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class RemoveBumperVariantCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<RemoveBumperVariantCommand, Result>
+{
+    public async Task<Result> Handle(
+        RemoveBumperVariantCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var template = await BumperTemplateLoader.LoadAsync(
+            dbContext,
+            command.TemplateId,
+            cancellationToken
+        );
+        if (template is null)
+            return Result.Failure(BumperErrors.TemplateNotFound);
+
+        if (template.FindVariant(command.VariantId) is null)
+            return Result.Failure(BumperErrors.VariantNotFound);
+
+        // Врезка могла выбрать этот подблок жёстко — тогда удаление оставило бы её без текста.
+        var used = await dbContext.JunctionElements.AnyAsync(
+            e => e.BumperVariantId == command.VariantId,
+            cancellationToken
+        );
+        if (used)
+            return Result.Failure(BumperErrors.VariantInUse);
+
+        return template.RemoveVariant(command.VariantId)
+            ? Result.Success()
+            : Result.Failure(BumperErrors.CannotRemoveLastVariant);
+    }
+}

backend/src/TeleWave.Application/Broadcast/Bumpers/RenderBumperPreviewCommand.cs

@@ -1,11 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>
-/// Синхронно рендерит примеры всех подблоков блока (с примерными названиями шоу). Каждый подблок —
-/// в свой ассет-превью (id детерминирован по подблоку). БД не меняет, но пишет артефакты на диск —
-/// поэтому это команда (действие с побочным эффектом), а не запрос.
-/// </summary>
-public sealed record RenderBumperPreviewCommand(Guid ChannelId, Guid TemplateId) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/RenderBumperPreviewCommandHandler.cs

@@ -1,19 +1,27 @@
 using LiteCqrs;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Options;
+using TeleWave.Application.Broadcast.Scheduling;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 using TeleWave.Application.Streaming;
 using TeleWave.Domain.Broadcast;
+using TeleWave.Domain.Media;
 using TeleWave.Domain.Programming;
 
 namespace TeleWave.Application.Broadcast.Bumpers;
 
+/// <summary>
+/// Рендерит пример каждого подблока. Блок общий, поэтому образцы подстановки берутся глазами
+/// выбранного канала: без него <c>{channel}</c> не на что заменить, а названия шоу были бы
+/// случайными из библиотеки.
+/// </summary>
 public sealed class RenderBumperPreviewCommandHandler(
     IAppDbContext dbContext,
     IBumperRenderer renderer,
     IBumperTemplateStorage storage,
     IImageStore imageStore,
+    IMediaStorage mediaStorage,
     IOptions<BumperOptions> bumperOptions,
     IOptions<StreamingOptions> streamingOptions
 ) : ICommandHandler<RenderBumperPreviewCommand, Result>
@@ -21,56 +29,68 @@ public sealed class RenderBumperPreviewCommandHandler(
     private readonly BumperOptions _bumper = bumperOptions.Value;
     private readonly int _segmentSeconds = Math.Max(1, streamingOptions.Value.SegmentSeconds);
 
-    /// <summary>Длительность заставки без загруженного звука (сек) — как в генераторе.</summary>
-    private const int DefaultBumperDurationSeconds = 8;
-
     public async Task<Result> Handle(
-        RenderBumperPreviewCommand query,
+        RenderBumperPreviewCommand command,
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await dbContext
-            .Channels.AsNoTracking()
+            .BumperTemplates.AsNoTracking()
-            .Include(c => c.BumperTemplates)
+            .Include(t => t.Variants)
-                .ThenInclude(t => t.Variants)
+            .FirstOrDefaultAsync(t => t.Id == command.TemplateId, cancellationToken);
-            .AsSplitQuery()
-            .FirstOrDefaultAsync(c => c.Id == query.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure(ChannelErrors.NotFound);
-
-        var template = channel.BumperTemplates.FirstOrDefault(t => t.Id == query.TemplateId);
         if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
+            return Result.Failure(BumperErrors.TemplateNotFound);
 
-        var (fromName, toName) = await SampleNamesAsync(channel, cancellationToken);
+        var channel = command.ChannelId is { } channelId
-        var backgroundPath = await ResolveBackgroundPathAsync(template, cancellationToken);
+            ? await dbContext
-        var seconds = template.AudioDurationSeconds is { } d and > 0
+                .Channels.AsNoTracking()
-            ? d
+                .FirstOrDefaultAsync(c => c.Id == channelId, cancellationToken)
-            : DefaultBumperDurationSeconds;
+            : null;
-        var aligned = (int)(
+
-            Math.Ceiling(Math.Max(_segmentSeconds, seconds) / _segmentSeconds) * _segmentSeconds
+        var samples = await SampleShowsAsync(channel, cancellationToken);
+        var context = BuildContext(channel, samples);
+        var backgroundPath = await ResolveImagePathAsync(
+            template.BackgroundImageId,
+            cancellationToken
+        );
+        var posterPath = await ResolveImagePathAsync(samples.NextPosterId, cancellationToken);
+        var aligned = BumperDuration.Aligned(
+            BumperDuration.TemplateSeconds(template),
+            _segmentSeconds
         );
         var audioPath = storage.AudioPath(template.Id, template.AudioExtension);
 
-        // Постер зависит от конкретного «следующего» шоу — в превью его не подставляем.
+        var clips = await ResolveClipsAsync(template, cancellationToken);
-        var inputs = new BumperSpecInputs(
-            fromName,
-            toName,
-            audioPath,
-            PosterAbsolutePath: null,
-            backgroundPath
-        );
 
-        // Рендерим каждый подблок в свой ассет-превью (id по подблоку).
         foreach (var variant in template.Variants.OrderBy(v => v.Position))
         {
+            var lines = variant
+                .Lines.OrderBy(l => l.Position)
+                .Select(l => new BumperRenderLine(
+                    l.Style,
+                    l.Color,
+                    BumperPlaceholders.Resolve(l.Text, context)
+                ))
+                .Where(l => !string.IsNullOrWhiteSpace(l.Text))
+                .ToList();
+
+            // У ролика своя длина — в превью она тоже должна быть настоящей, иначе админ увидит
+            // не ту заставку, которая пойдёт в эфир.
+            var clip = variant.BackgroundClipShowId is { } clipShowId
+                ? clips.GetValueOrDefault(clipShowId)
+                : null;
+
             var spec = BumperSpecFactory.Build(
                 _bumper,
-                channel.BumperFont,
                 template,
-                variant,
+                clip is null ? aligned : BumperDuration.Aligned(clip.Seconds, _segmentSeconds),
-                aligned,
+                new BumperSpecInputs(
-                inputs
+                    lines,
+                    audioPath,
+                    variant.Background == BumperBackground.Template ? null : posterPath,
+                    backgroundPath,
+                    clip?.Path
+                )
             );
             await renderer.RenderAsync(BumperPreview.AssetId(variant.Id), spec, cancellationToken);
         }
@@ -78,49 +98,155 @@ public sealed class RenderBumperPreviewCommandHandler(
         return Result.Success();
     }
 
-    /// <summary>Путь к фон-картинке блока в общем реестре или null, если она не привязана.</summary>
+    /// <summary>Ролик-подложка: плейлист и длительность.</summary>
-    private async Task<string?> ResolveBackgroundPathAsync(
+    private sealed record ClipSource(string Path, int Seconds);
+
+    /// <summary>Ролики-подложки подблоков блока, по шоу. Неготовые молча выпадают — превью не эфир.</summary>
+    private async Task<Dictionary<Guid, ClipSource>> ResolveClipsAsync(
         BumperTemplate template,
         CancellationToken cancellationToken
     )
     {
-        if (template.BackgroundImageId is not { } imageId)
+        var showIds = template
-            return null;
+            .Variants.Where(v => v.Background == BumperBackground.Clip)
+            .Select(v => v.BackgroundClipShowId)
+            .Where(id => id is not null)
+            .Select(id => id!.Value)
+            .Distinct()
+            .ToList();
+        if (showIds.Count == 0)
+            return [];
 
-        var extension = await dbContext
+        var episodes = await dbContext
-            .Images.AsNoTracking()
+            .Shows.AsNoTracking()
-            .Where(i => i.Id == imageId)
+            .SelectMany(s => s.Episodes)
-            .Select(i => i.FileExtension)
+            .Where(e => showIds.Contains(e.ShowId))
-            .FirstOrDefaultAsync(cancellationToken);
+            .OrderBy(e => e.Position)
+            .Select(e => new { e.ShowId, e.MediaAssetId })
+            .ToListAsync(cancellationToken);
 
-        return extension is null ? null : imageStore.ResolvePath(imageId, extension);
+        var assetIds = episodes.Select(e => e.MediaAssetId).ToList();
+        var ready = await dbContext
+            .MediaAssets.AsNoTracking()
+            .Where(a =>
+                assetIds.Contains(a.Id) && a.Status == MediaAssetStatus.Ready && a.Duration != null
+            )
+            .Select(a => new { a.Id, a.Duration })
+            .ToDictionaryAsync(a => a.Id, a => a.Duration!.Value, cancellationToken);
+
+        var result = new Dictionary<Guid, ClipSource>();
+        foreach (var episode in episodes)
+        {
+            if (result.ContainsKey(episode.ShowId))
+                continue;
+            if (!ready.TryGetValue(episode.MediaAssetId, out var duration))
+                continue;
+            if (mediaStorage.ResolvePlaylistPath(episode.MediaAssetId) is not { } path)
+                continue;
+
+            result[episode.ShowId] = new ClipSource(path, (int)Math.Ceiling(duration.TotalSeconds));
+        }
+
+        return result;
+    }
+
+    private static BumperContext BuildContext(Channel? channel, SampleShows samples)
+    {
+        var offset = TimeSpan.FromMinutes(
+            channel?.UtcOffsetMinutes ?? Channel.DefaultUtcOffsetMinutes
+        );
+        var moment = DateTimeOffset.UtcNow.ToOffset(offset);
+
+        return new BumperContext(
+            channel?.Name ?? "Канал",
+            channel?.Number,
+            moment,
+            samples.NowTitle,
+            samples.NextTitle,
+            "с1э5",
+            "с2э3",
+            samples.NextYear,
+            samples.NextGenre,
+            TimeOnly.FromDateTime(moment.AddMinutes(30).DateTime),
+            samples.SlotTitle,
+            // Анонсы в превью показываются образцом: настоящий вечер известен только ленте.
+            new BumperAnnouncement(samples.NextTitle, new TimeOnly(20, 0)),
+            new BumperAnnouncement(samples.NowTitle, new TimeOnly(20, 0))
+        );
     }
 
     /// <summary>
-    /// Примерные названия «из/в» для превью. Берём шоу из групп, на которые ссылаются слоты канала:
+    /// Пара шоу для образца. Берём те, что реально ходят в этом канале (через группы его слотов), —
-    /// так превью показывает реальные названия этого канала, а не случайные из библиотеки.
+    /// иначе предпросмотр показывает библиотеку, а не канал.
     /// </summary>
-    private async Task<(string From, string To)> SampleNamesAsync(
+    private async Task<SampleShows> SampleShowsAsync(
-        Channel channel,
+        Channel? channel,
         CancellationToken cancellationToken
     )
     {
-        var names = await (
+        var query = dbContext.Shows.AsNoTracking().AsQueryable();
-            from slot in dbContext.Slots.AsNoTracking()
+        if (channel?.TemplateId is { } templateId)
+            query =
+                from show in query
+                join item in dbContext.GroupItems.AsNoTracking() on show.Id equals item.ElementId
+                join slot in dbContext.Slots.AsNoTracking() on item.GroupId equals slot.GroupId
                 join layer in dbContext.GridLayers.AsNoTracking() on slot.LayerId equals layer.Id
-            join item in dbContext.GroupItems.AsNoTracking() on slot.GroupId equals item.GroupId
+                where layer.TemplateId == templateId && item.ElementKind == GroupElementKind.Show
-            join show in dbContext.Shows.AsNoTracking() on item.ElementId equals show.Id
+                select show;
-            where
+
-                layer.TemplateId == channel.TemplateId && item.ElementKind == GroupElementKind.Show
+        var shows = await query
-            select show.Name
+            .Select(s => new
-        )
+            {
+                s.Name,
+                s.Year,
+                s.PosterImageId,
+            })
             .Distinct()
             .Take(2)
             .ToListAsync(cancellationToken);
 
-        return (
+        var slotTitle = channel?.TemplateId is { } id
-            names.ElementAtOrDefault(0) ?? "Первое шоу",
+            ? await (
-            names.ElementAtOrDefault(1) ?? "Второе шоу"
+                from slot in dbContext.Slots.AsNoTracking()
+                join layer in dbContext.GridLayers.AsNoTracking() on slot.LayerId equals layer.Id
+                where layer.TemplateId == id
+                select slot.Title
+            ).FirstOrDefaultAsync(cancellationToken)
+            : null;
+
+        var next = shows.ElementAtOrDefault(1) ?? shows.ElementAtOrDefault(0);
+        return new SampleShows(
+            shows.ElementAtOrDefault(0)?.Name ?? "Первое шоу",
+            next?.Name ?? "Второе шоу",
+            next?.Year,
+            null,
+            next?.PosterImageId,
+            slotTitle ?? "Вечернее кино"
         );
     }
+
+    private async Task<string?> ResolveImagePathAsync(
+        Guid? imageId,
+        CancellationToken cancellationToken
+    )
+    {
+        if (imageId is not { } id)
+            return null;
+
+        var extension = await dbContext
+            .Images.AsNoTracking()
+            .Where(i => i.Id == id)
+            .Select(i => i.FileExtension)
+            .FirstOrDefaultAsync(cancellationToken);
+        return extension is null ? null : imageStore.ResolvePath(id, extension);
+    }
+
+    private sealed record SampleShows(
+        string NowTitle,
+        string NextTitle,
+        int? NextYear,
+        string? NextGenre,
+        Guid? NextPosterId,
+        string SlotTitle
+    );
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/SetBumperTemplateAudioCommand.cs

@@ -1,12 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Отметить загруженный звук блока: расширение (с точкой) и длину в секундах (замер ffprobe).</summary>
-public sealed record SetBumperTemplateAudioCommand(
-    Guid ChannelId,
-    Guid TemplateId,
-    string Extension,
-    double DurationSeconds
-) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/SetBumperTemplateAudioCommandHandler.cs

@@ -1,5 +1,4 @@
 using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 
@@ -13,15 +12,13 @@ public sealed class SetBumperTemplateAudioCommandHandler(IAppDbContext dbContext
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await BumperTemplateLoader.LoadAsync(
-            .Channels.Include(c => c.BumperTemplates)
+            dbContext,
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
+            command.TemplateId,
-        if (channel is null)
+            cancellationToken
-            return Result.Failure(ChannelErrors.NotFound);
+        );
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
         if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
+            return Result.Failure(BumperErrors.TemplateNotFound);
 
         template.SetAudio(command.Extension, command.DurationSeconds);
         return Result.Success();

backend/src/TeleWave.Application/Broadcast/Bumpers/SetBumperTemplateBackgroundCommand.cs

@@ -1,11 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Привязать фон-картинку блока по ссылке на изображение из реестра (галерея).</summary>
-public sealed record SetBumperTemplateBackgroundCommand(
-    Guid ChannelId,
-    Guid TemplateId,
-    Guid ImageId
-) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/SetBumperTemplateBackgroundCommandHandler.cs

@@ -2,6 +2,7 @@ using LiteCqrs;
 using Microsoft.EntityFrameworkCore;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
+using TeleWave.Application.Images;
 
 namespace TeleWave.Application.Broadcast.Bumpers;
 
@@ -13,15 +14,16 @@ public sealed class SetBumperTemplateBackgroundCommandHandler(IAppDbContext dbCo
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await BumperTemplateLoader.LoadAsync(
-            .Channels.Include(c => c.BumperTemplates)
+            dbContext,
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
+            command.TemplateId,
-        if (channel is null)
+            cancellationToken
-            return Result.Failure(ChannelErrors.NotFound);
+        );
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
         if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
+            return Result.Failure(BumperErrors.TemplateNotFound);
+
+        if (!await dbContext.Images.AnyAsync(i => i.Id == command.ImageId, cancellationToken))
+            return Result.Failure(ImageErrors.NotFound);
 
         template.SetBackgroundImage(command.ImageId);
         return Result.Success();

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTemplateCommand.cs

@@ -1,15 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Обновить оформление блока заставки: имя и цвета (в нотации ffmpeg).</summary>
-public sealed record UpdateBumperTemplateCommand(
-    Guid ChannelId,
-    Guid TemplateId,
-    string Name,
-    string BackgroundColor,
-    string BackgroundColor2,
-    string AccentColor,
-    string TextColor
-) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTemplateCommandHandler.cs

@@ -1,5 +1,4 @@
 using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 
@@ -13,23 +12,15 @@ public sealed class UpdateBumperTemplateCommandHandler(IAppDbContext dbContext)
         CancellationToken cancellationToken
     )
     {
-        var channel = await dbContext
+        var template = await BumperTemplateLoader.LoadAsync(
-            .Channels.Include(c => c.BumperTemplates)
+            dbContext,
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
+            command.TemplateId,
-        if (channel is null)
+            cancellationToken
-            return Result.Failure(ChannelErrors.NotFound);
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
-        if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
-
-        template.UpdateStyle(
-            command.Name.Trim(),
-            command.BackgroundColor,
-            command.BackgroundColor2,
-            command.AccentColor,
-            command.TextColor
         );
+        if (template is null)
+            return Result.Failure(BumperErrors.TemplateNotFound);
+
+        template.UpdateStyle(command.Style);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTemplateCommandValidator.cs

@@ -1,31 +0,0 @@
-using System.Text.RegularExpressions;
-using FluentValidation;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed partial class UpdateBumperTemplateCommandValidator
-    : AbstractValidator<UpdateBumperTemplateCommand>
-{
-    public UpdateBumperTemplateCommandValidator()
-    {
-        RuleFor(x => x.Name).NotEmpty().MaximumLength(64);
-
-        // Цвета уходят в строку ffmpeg-фильтра без экранирования — допускаем только безопасный формат
-        // (0xRRGGBB[AA], #RRGGBB[AA] или имя цвета), чтобы исключить инъекцию синтаксиса фильтра.
-        RuleFor(x => x.BackgroundColor).Must(BeSafeColor).WithMessage(ColorMessage);
-        RuleFor(x => x.BackgroundColor2).Must(BeSafeColor).WithMessage(ColorMessage);
-        RuleFor(x => x.AccentColor).Must(BeSafeColor).WithMessage(ColorMessage);
-        RuleFor(x => x.TextColor).Must(BeSafeColor).WithMessage(ColorMessage);
-    }
-
-    private const string ColorMessage =
-        "Цвет должен быть в формате 0xRRGGBB, #RRGGBB или именем (например white).";
-
-    private static bool BeSafeColor(string? value) =>
-        !string.IsNullOrWhiteSpace(value) && ColorRegex().IsMatch(value);
-
-    [GeneratedRegex(
-        @"^((0x|#)?[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?|[A-Za-z]{2,20}(@[0-9]?\.?[0-9]+)?)$"
-    )]
-    private static partial Regex ColorRegex();
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTextVariantCommand.cs

@@ -1,20 +0,0 @@
-using LiteCqrs;
-using TeleWave.Application.Common.Models;
-using TeleWave.Domain.Broadcast;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-/// <summary>Обновить подблок: имя, режим текста, текст, правило показа и вес.</summary>
-public sealed record UpdateBumperTextVariantCommand(
-    Guid ChannelId,
-    Guid TemplateId,
-    Guid VariantId,
-    string Name,
-    BumperTextKind Kind,
-    string NowLabel,
-    string NextLabel,
-    string Line1,
-    string Line2,
-    BumperTrigger Trigger,
-    int Weight
-) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTextVariantCommandHandler.cs

@@ -1,47 +0,0 @@
-using LiteCqrs;
-using Microsoft.EntityFrameworkCore;
-using TeleWave.Application.Common.Interfaces;
-using TeleWave.Application.Common.Models;
-using TeleWave.Domain.Broadcast;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class UpdateBumperTextVariantCommandHandler(IAppDbContext dbContext)
-    : ICommandHandler<UpdateBumperTextVariantCommand, Result>
-{
-    public async Task<Result> Handle(
-        UpdateBumperTextVariantCommand command,
-        CancellationToken cancellationToken
-    )
-    {
-        var channel = await dbContext
-            .Channels.Include(c => c.BumperTemplates)
-                .ThenInclude(t => t.Variants)
-            .AsSplitQuery()
-            .FirstOrDefaultAsync(c => c.Id == command.ChannelId, cancellationToken);
-        if (channel is null)
-            return Result.Failure(ChannelErrors.NotFound);
-
-        var template = channel.FindBumperTemplate(command.TemplateId);
-        if (template is null)
-            return Result.Failure(ChannelErrors.BumperTemplateNotFound);
-
-        var variant = template.FindVariant(command.VariantId);
-        if (variant is null)
-            return Result.Failure(ChannelErrors.BumperTextVariantNotFound);
-
-        variant.Update(
-            command.Name.Trim(),
-            new BumperTextContent(
-                command.Kind,
-                command.NowLabel,
-                command.NextLabel,
-                command.Line1,
-                command.Line2
-            ),
-            command.Trigger,
-            command.Weight
-        );
-        return Result.Success();
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperTextVariantCommandValidator.cs

@@ -1,17 +0,0 @@
-using FluentValidation;
-
-namespace TeleWave.Application.Broadcast.Bumpers;
-
-public sealed class UpdateBumperTextVariantCommandValidator
-    : AbstractValidator<UpdateBumperTextVariantCommand>
-{
-    public UpdateBumperTextVariantCommandValidator()
-    {
-        RuleFor(x => x.Name).NotEmpty().MaximumLength(64);
-        RuleFor(x => x.NowLabel).MaximumLength(64);
-        RuleFor(x => x.NextLabel).MaximumLength(64);
-        RuleFor(x => x.Line1).MaximumLength(120);
-        RuleFor(x => x.Line2).MaximumLength(120);
-        RuleFor(x => x.Weight).InclusiveBetween(0, 1000);
-    }
-}

backend/src/TeleWave.Application/Broadcast/Bumpers/UpdateBumperVariantCommandHandler.cs

@@ -0,0 +1,52 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+using TeleWave.Domain.Broadcast;
+
+namespace TeleWave.Application.Broadcast.Bumpers;
+
+public sealed class UpdateBumperVariantCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<UpdateBumperVariantCommand, Result>
+{
+    public async Task<Result> Handle(
+        UpdateBumperVariantCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var template = await BumperTemplateLoader.LoadAsync(
+            dbContext,
+            command.TemplateId,
+            cancellationToken
+        );
+        if (template is null)
+            return Result.Failure(BumperErrors.TemplateNotFound);
+
+        var variant = template.FindVariant(command.VariantId);
+        if (variant is null)
+            return Result.Failure(BumperErrors.VariantNotFound);
+
+        // Незнакомый плейсхолдер ловим здесь: в эфире он превратился бы в пустоту, и заметить это
+        // было бы уже некому.
+        var unknown = command
+            .Input.Lines.SelectMany(l => BumperPlaceholders.UnknownTokens(l.Text))
+            .Distinct(StringComparer.Ordinal)
+            .ToList();
+        if (unknown.Count > 0)
+            return Result.Failure(BumperErrors.UnknownPlaceholders(unknown));
+
+        variant.Update(
+            command.Input.Name,
+            command.Input.Trigger,
+            command.Input.Background,
+            command.Input.Weight,
+            command.Input.BackgroundClipShowId
+        );
+        variant.SetLines(
+            command.Input.Lines.Select(
+                (line, index) => BumperLine.Create(index, line.Style, line.Color, line.Text)
+            )
+        );
+
+        return Result.Success();
+    }
+}

backend/src/TeleWave.Application/Broadcast/ChannelDtos.cs

@@ -4,39 +4,6 @@ namespace TeleWave.Application.Broadcast;
 
 public sealed record ChannelSummaryDto(Guid Id, string Name, string Slug, bool IsEnabled);
 
-/// <summary>Общие для канала настройки ТВ-заставок (стиль/звук/текст — на блоках/подблоках).</summary>
-public sealed record BumperSettingsDto(BumperFont Font, BumperSelection Selection);
-
-/// <summary>Подблок (текст-вариант): свой текст + правило показа + вес поверх стиля/звука блока.</summary>
-public sealed record BumperTextVariantDto(
-    Guid Id,
-    int Position,
-    string Name,
-    BumperTextKind Kind,
-    string NowLabel,
-    string NextLabel,
-    string Line1,
-    string Line2,
-    BumperTrigger Trigger,
-    int Weight
-);
-
-/// <summary>Блок заставки: своё оформление + звук + подблоки. <see cref="AudioDurationSeconds"/> — длина звука (сек).</summary>
-public sealed record BumperTemplateDto(
-    Guid Id,
-    int Position,
-    bool IsDefault,
-    string Name,
-    string BackgroundColor,
-    string BackgroundColor2,
-    string AccentColor,
-    string TextColor,
-    Guid? BackgroundImageId,
-    bool HasAudio,
-    double? AudioDurationSeconds,
-    IReadOnlyList<BumperTextVariantDto> Variants
-);
-
 public sealed record ChannelDto(
     Guid Id,
     string Name,
@@ -46,10 +13,9 @@ public sealed record ChannelDto(
     int UtcOffsetMinutes,
     TimeOnly DayStartTime,
     Guid? TemplateId,
-    bool BumpersEnabled,
-    BumperSettingsDto Bumper,
-    IReadOnlyList<BumperTemplateDto> BumperTemplates,
     Guid? FillerAssetId,
+    /// <summary>Иконка канала для внешних IPTV-плееров (M3U/XMLTV); null — отдаётся заглушка.</summary>
+    Guid? IconImageId,
     /// <summary>Оверлеи и фильтр зрительской части — всё опционально (см. 6.8).</summary>
     ViewerSettingsDto Viewer
 );

backend/src/TeleWave.Application/Broadcast/GetChannel/GetChannelQueryHandler.cs

@@ -17,44 +17,10 @@ public sealed class GetChannelQueryHandler(IAppDbContext dbContext)
         // (GetChannelTemplateQuery) — здесь только собственные свойства канала.
         var channel = await dbContext
             .Channels.AsNoTracking()
-            .Include(c => c.BumperTemplates)
-                .ThenInclude(t => t.Variants)
-            .AsSplitQuery()
             .FirstOrDefaultAsync(c => c.Id == query.Id, cancellationToken);
         if (channel is null)
             return Result.Failure<ChannelDto>(ChannelErrors.NotFound);
 
-        var bumperTemplates = channel
-            .BumperTemplates.OrderBy(t => t.Position)
-            .Select(t => new BumperTemplateDto(
-                t.Id,
-                t.Position,
-                t.IsDefault,
-                t.Name,
-                t.BackgroundColor,
-                t.BackgroundColor2,
-                t.AccentColor,
-                t.TextColor,
-                t.BackgroundImageId,
-                t.AudioExtension is not null,
-                t.AudioDurationSeconds,
-                t.Variants.OrderBy(v => v.Position)
-                    .Select(v => new BumperTextVariantDto(
-                        v.Id,
-                        v.Position,
-                        v.Name,
-                        v.Kind,
-                        v.NowLabel,
-                        v.NextLabel,
-                        v.Line1,
-                        v.Line2,
-                        v.Trigger,
-                        v.Weight
-                    ))
-                    .ToList()
-            ))
-            .ToList();
-
         return Result.Success(
             new ChannelDto(
                 channel.Id,
@@ -65,10 +31,8 @@ public sealed class GetChannelQueryHandler(IAppDbContext dbContext)
                 channel.UtcOffsetMinutes,
                 channel.DayStartTime,
                 channel.TemplateId,
-                channel.BumpersEnabled,
-                new BumperSettingsDto(channel.BumperFont, channel.BumperSelection),
-                bumperTemplates,
                 channel.FillerAssetId,
+                channel.IconImageId,
                 new ViewerSettingsDto(
                     channel.LogoImageId,
                     channel.LogoCorner,

backend/src/TeleWave.Application/Broadcast/GetSchedule/GetChannelScheduleQueryHandler.cs

@@ -1,5 +1,6 @@
 using LiteCqrs;
 using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Broadcast.Bumpers;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Application.Common.Models;
 using TeleWave.Application.Library;
@@ -43,22 +44,31 @@ public sealed class GetChannelScheduleQueryHandler(IAppDbContext dbContext)
             .Select(s => new { s.Id, s.Name })
             .ToDictionaryAsync(s => s.Id, s => s.Name, cancellationToken);
 
-        // Подблоки заставок в окне — чтобы показать в расписании, какая именно заставка и с каким текстом.
+        // Заставки в окне: берём их из кэша по ассету — там лежит ровно тот текст, который играл,
-        var variantIds = entries
+        // с уже подставленными плейсхолдерами. Собирать его заново из подблока значило бы гадать.
-            .Where(e =>
+        var bumperAssetIds = entries
-                e.Kind == Domain.Broadcast.ScheduleEntryKind.Bumper && e.BumperVariantId != null
+            .Where(e => e.Kind == Domain.Broadcast.ScheduleEntryKind.Bumper)
-            )
+            .Select(e => e.MediaAssetId)
-            .Select(e => e.BumperVariantId!.Value)
             .Distinct()
             .ToList();
-        var variants =
+        var bumpers =
-            variantIds.Count == 0
+            bumperAssetIds.Count == 0
                 ? []
-                : await dbContext
+                : await (
-                    .BumperTextVariants.AsNoTracking()
+                    from cache in dbContext.BumperAssets.AsNoTracking()
-                    .Where(v => variantIds.Contains(v.Id))
+                    join variant in dbContext.BumperTextVariants.AsNoTracking()
-                    .ToListAsync(cancellationToken);
+                        on cache.VariantId equals variant.Id
-        var variantsById = variants.ToDictionary(v => v.Id);
+                    where bumperAssetIds.Contains(cache.MediaAssetId)
+                    select new
+                    {
+                        cache.MediaAssetId,
+                        variant.Name,
+                        cache.RenderedLinesJson,
+                    }
+                ).ToListAsync(cancellationToken);
+        var bumpersByAsset = bumpers
+            .GroupBy(b => b.MediaAssetId)
+            .ToDictionary(g => g.Key, g => g.First());
 
         // Имена ассетов программ — чтобы показать реальную метку S16E03 в расписании админки.
         var assetIds = entries
@@ -72,23 +82,45 @@ public sealed class GetChannelScheduleQueryHandler(IAppDbContext dbContext)
             .Select(a => new { a.Id, a.OriginalFileName })
             .ToDictionaryAsync(a => a.Id, a => a.OriginalFileName, cancellationToken);
 
-        // «Из какого шоу» для заставки берём из ближайшей предыдущей программы в упорядоченном окне.
+        // Франшизы записей: у фильма серия всегда одна, и «Серия 1» в расписании — пустая метка.
-        Guid? prevProgramShowId = null;
+        // Осмысленно другое — какой частью коллекции он шёл.
+        var collectionIds = entries
+            .Where(e => e.CollectionId != null)
+            .Select(e => e.CollectionId!.Value)
+            .Distinct()
+            .ToList();
+        var collectionParts =
+            collectionIds.Count == 0
+                ? []
+                : await (
+                    from item in dbContext.CollectionItems.AsNoTracking()
+                    join collection in dbContext.Collections.AsNoTracking()
+                        on item.CollectionId equals collection.Id
+                    where collectionIds.Contains(item.CollectionId)
+                    select new CollectionPart(
+                        item.CollectionId,
+                        item.ShowId,
+                        item.Position,
+                        collection.Name
+                    )
+                ).ToListAsync(cancellationToken);
+        var partsByCollection = collectionParts
+            .GroupBy(p => p.CollectionId)
+            .ToDictionary(g => g.Key, g => g.OrderBy(p => p.Position).ToList());
+
         var dtos = new List<ScheduleEntryDto>(entries.Count);
         foreach (var e in entries)
         {
             string? bumperName = null;
             string? bumperText = null;
-            if (
+            if (bumpersByAsset.TryGetValue(e.MediaAssetId, out var bumper))
-                e.Kind == Domain.Broadcast.ScheduleEntryKind.Bumper
-                && e.BumperVariantId is { } vid
-                && variantsById.TryGetValue(vid, out var variant)
-            )
             {
-                bumperName = variant.Name;
+                bumperName = bumper.Name;
-                bumperText = BumperText(variant, prevProgramShowId, e.ShowId, showNames);
+                bumperText = BumperText(bumper.RenderedLinesJson);
             }
 
+            var franchise = FranchisePart(partsByCollection, e.CollectionId, e.ShowId);
+
             dtos.Add(
                 new ScheduleEntryDto(
                     e.Id,
@@ -103,37 +135,54 @@ public sealed class GetChannelScheduleQueryHandler(IAppDbContext dbContext)
                         ? EpisodeName.ParseLabel(name)
                         : null,
                     bumperName,
-                    bumperText
+                    bumperText,
+                    franchise?.Part,
+                    franchise?.Total,
+                    franchise?.Name
                 )
             );
-
-            if (e.Kind == Domain.Broadcast.ScheduleEntryKind.Program)
-                prevProgramShowId = e.ShowId;
         }
 
         return Result.Success<IReadOnlyList<ScheduleEntryDto>>(dtos);
     }
 
+    /// <summary>Место записи во франшизе: «часть N из M» и её название.</summary>
+    private sealed record FranchisePosition(int Part, int Total, string Name);
+
     /// <summary>
-    /// Текст заставки для метки в расписании: для «Сейчас/Далее» — подписи + названия шоу (из→в),
+    /// Какой частью коллекции шла запись. Номер ищется по позиции шоу в текущем составе, а не по
-    /// для свободного текста — заданные строки. Возвращает null, если показывать нечего.
+    /// индексу записи: франшизу могли переупорядочить, и «часть 2» обязана означать вторую сейчас.
     /// </summary>
-    private static string? BumperText(
+    private static FranchisePosition? FranchisePart(
-        Domain.Broadcast.BumperTextVariant variant,
+        IReadOnlyDictionary<Guid, List<CollectionPart>> partsByCollection,
-        Guid? fromShowId,
+        Guid? collectionId,
-        Guid? toShowId,
+        Guid? showId
-        IReadOnlyDictionary<Guid, string> showNames
     )
     {
-        if (variant.Kind == Domain.Broadcast.BumperTextKind.Free)
+        if (
-        {
+            collectionId is not { } id
-            var parts = new[] { variant.Line1, variant.Line2 }
+            || showId is not { } show
-                .Where(s => !string.IsNullOrWhiteSpace(s))
+            || !partsByCollection.TryGetValue(id, out var ordered)
-                .ToArray();
+        )
-            return parts.Length == 0 ? null : string.Join(" · ", parts);
+            return null;
+
+        var at = ordered.FindIndex(p => p.ShowId == show);
+        return at < 0 ? null : new FranchisePosition(at + 1, ordered.Count, ordered[0].Name);
     }
 
-        string Name(Guid? id) => id is { } g ? showNames.GetValueOrDefault(g, "…") : "…";
+    /// <summary>Позиция шоу в коллекции вместе с её названием — то, чем считается номер части.</summary>
-        return $"{variant.NowLabel} {Name(fromShowId)} · {variant.NextLabel} {Name(toShowId)}";
+    private sealed record CollectionPart(Guid CollectionId, Guid ShowId, int Position, string Name);
+
+    /// <summary>Строки сыгравшей заставки одной меткой для расписания; null — показывать нечего.</summary>
+    private static string? BumperText(string? renderedLinesJson)
+    {
+        var text = string.Join(
+            " · ",
+            BumperRenderedText
+                .FromJson(renderedLinesJson)
+                .Select(l => l.Text)
+                .Where(t => !string.IsNullOrWhiteSpace(t))
+        );
+        return text.Length == 0 ? null : text;
     }
 }

backend/src/TeleWave.Application/Broadcast/ScheduleEntryDto.cs

@@ -14,5 +14,12 @@ public sealed record ScheduleEntryDto(
     string? SeasonEpisode,
     // Для заставок (Kind == Bumper): имя подблока и его текст — для метки в админ-расписании.
     string? BumperName = null,
-    string? BumperText = null
+    string? BumperText = null,
+    /// <summary>
+    /// Какой частью франшизы шла запись и сколько их всего. У фильма серия всегда одна, и «Серия 1»
+    /// в расписании ничего не значит; «часть 3 из 3» — значит.
+    /// </summary>
+    int? CollectionPart = null,
+    int? CollectionParts = null,
+    string? CollectionName = null
 );

backend/src/TeleWave.Application/Broadcast/UpdateChannelSettings/UpdateChannelSettingsCommand.cs

@@ -1,6 +1,5 @@
 using LiteCqrs;
 using TeleWave.Application.Common.Models;
-using TeleWave.Domain.Broadcast;
 
 namespace TeleWave.Application.Broadcast.UpdateChannelSettings;
 
@@ -8,11 +7,6 @@ public sealed record UpdateChannelSettingsCommand(
     Guid ChannelId,
     string Name,
     bool IsEnabled,
-    bool BumpersEnabled,
+    Guid? FillerAssetId,
-    BumperSettingsInput Bumper,
+    Guid? IconImageId
-    Guid? FillerAssetId
 ) : ICommand<Result>;
-
-/// <summary>Общие настройки ТВ-заставок канала (см. <c>Channel.UpdateBumperSettings</c>). Условия
-/// показа сюда не входят — они задаются на элементе стыка.</summary>
-public sealed record BumperSettingsInput(BumperFont Font, BumperSelection Selection);

backend/src/TeleWave.Application/Broadcast/UpdateChannelSettings/UpdateChannelSettingsCommandHandler.cs

@@ -33,10 +33,9 @@ public sealed class UpdateChannelSettingsCommandHandler(IAppDbContext dbContext)
         channel.UpdateSettings(
             command.Name,
             command.IsEnabled,
-            command.BumpersEnabled,
+            command.FillerAssetId,
-            command.FillerAssetId
+            command.IconImageId
         );
-        channel.UpdateBumperSettings(command.Bumper.Font, command.Bumper.Selection);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Common/DebugExportOptions.cs

@@ -0,0 +1,20 @@
+namespace TeleWave.Application.Common;
+
+/// <summary>Настройки отладочного дампа. Секция «Debug».</summary>
+public sealed class DebugExportOptions
+{
+    public const string SectionName = "Debug";
+
+    /// <summary>
+    /// Куда класть копии архивов. Пусто — не класть никуда, отдавать только в браузер: на сервере
+    /// дампы на диске не нужны, а в разработке путь указывает на папку рядом с репозиторием.
+    /// Относительный путь считается от рабочего каталога приложения.
+    /// </summary>
+    public string? ExportDirectory { get; init; }
+
+    /// <summary>
+    /// Сколько последних архивов держать в каталоге. Дамп канала — это мегабайты, а собирают их
+    /// пачками, отлаживая одну и ту же сетку; без потолка папка растёт молча.
+    /// </summary>
+    public int KeepLast { get; init; } = 20;
+}

backend/src/TeleWave.Application/Common/Interfaces/IAppDbContext.cs

@@ -5,6 +5,7 @@ using TeleWave.Domain.Broadcast;
 using TeleWave.Domain.Images;
 using TeleWave.Domain.Library;
 using TeleWave.Domain.Media;
+using TeleWave.Domain.Notifications;
 using TeleWave.Domain.Programming;
 using TeleWave.Domain.Settings;
 
@@ -30,7 +31,12 @@ public interface IAppDbContext
     DbSet<JunctionElement> JunctionElements { get; }
     DbSet<Channel> Channels { get; }
     DbSet<ScheduleEntry> ScheduleEntries { get; }
+    DbSet<BumperTemplate> BumperTemplates { get; }
     DbSet<BumperTextVariant> BumperTextVariants { get; }
+    DbSet<TelegramSettings> TelegramSettings { get; }
+    DbSet<TelegramSubscriber> TelegramSubscribers { get; }
+    DbSet<TelegramSubscription> TelegramSubscriptions { get; }
+    DbSet<TelegramLinkCode> TelegramLinkCodes { get; }
     DbSet<BumperAsset> BumperAssets { get; }
     DbSet<AppSetting> AppSettings { get; }
     DbSet<Image> Images { get; }

backend/src/TeleWave.Application/Common/Interfaces/IBumperRenderer.cs

@@ -1,7 +1,13 @@
+using TeleWave.Domain.Broadcast;
+
 namespace TeleWave.Application.Common.Interfaces;
 
+/// <summary>Готовая строка заставки: роль, цвет из палитры блока и уже подставленный текст.</summary>
+public sealed record BumperRenderLine(BumperLineStyle Style, BumperLineColor Color, string Text);
+
 /// <summary>
-/// Полная спецификация одной заставки для рендера: оформление канала + подписи + названия шоу.
+/// Полная спецификация одной заставки для рендера: оформление блока + готовые строки. Плейсхолдеры
+/// в <see cref="Lines"/> уже подставлены — рендер работает с текстом, а не с шаблоном.
 /// <see cref="DurationSeconds"/> уже выровнена на длину сегмента (готовит оркестратор), а
 /// <see cref="FontFile"/> — абсолютный путь к TTF внутри контейнера.
 /// </summary>
@@ -14,18 +20,21 @@ public sealed record BumperRenderSpec(
     string AccentColor,
     string TextColor,
     string FontFile,
-    string NowLabel,
+    IReadOnlyList<BumperRenderLine> Lines,
-    string NowTitle,
-    string NextLabel,
-    string NextTitle,
     string? BackgroundFile = null,
     string? MusicFile = null,
-    /// <summary>Постер шоу как фон (используется, если нет загруженного фона канала; затемняется).</summary>
+    /// <summary>Постер шоу как фон (используется, если подблок его запросил; затемняется).</summary>
     string? PosterFile = null,
-    /// <summary>Режим свободного текста: вместо «Сейчас/Далее» рисуются <see cref="FreeLine1"/>/<see cref="FreeLine2"/>.</summary>
+    /// <summary>
-    bool FreeText = false,
+    /// Готовый ролик как подложка: плейлист ассета из библиотеки. Побеждает остальные источники —
-    string FreeLine1 = "",
+    /// это самый явный выбор из всех, его не подставляют молча.
-    string FreeLine2 = ""
+    /// </summary>
+    string? ClipFile = null,
+    /// <summary>
+    /// Брать звук из самого ролика. Ставится, когда у блока нет джингла: подкладывать под чужую
+    /// заставку синтезированный писк хуже, чем оставить её собственную дорожку.
+    /// </summary>
+    bool UseClipAudio = false
 );
 
 /// <summary>Итог рендера заставки — та же форма метаданных, что у обычного ассета после нарезки.</summary>
@@ -39,9 +48,9 @@ public sealed record BumperRenderResult(
 );
 
 /// <summary>
-/// Порт рендера ТВ-заставок. Реализация синтезирует короткий клип (анимированный фон + текст
+/// Порт рендера ТВ-заставок. Реализация синтезирует короткий клип (анимированный фон + строки текста
-/// «Сейчас/Далее» + джингл) по <see cref="BumperRenderSpec"/> и режет его на HLS-сегменты в
+/// + джингл) по <see cref="BumperRenderSpec"/> и режет его на HLS-сегменты в assets/{assetId} — так
-/// assets/{assetId} — так же, как обычный ассет, чтобы раздача эфира не отличала заставку от программы.
+/// же, как обычный ассет, чтобы раздача эфира не отличала заставку от программы.
 /// </summary>
 public interface IBumperRenderer
 {

backend/src/TeleWave.Application/Common/Interfaces/IDebugExportStore.cs

@@ -0,0 +1,19 @@
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>
+/// Куда ложится копия отладочного дампа на сервере. Сам архив всегда уезжает в браузер — это порт
+/// для второй копии, которая остаётся рядом с репозиторием: разбирать «почему сетка построилась
+/// вот так» приходится вместе с кодом, и перекладывать архивы руками из загрузок каждый раз —
+/// лишний шаг.
+///
+/// Каталог задаётся настройкой и по умолчанию пуст: на сервере писать дампы на диск незачем,
+/// это инструмент разработки.
+/// </summary>
+public interface IDebugExportStore
+{
+    /// <summary>
+    /// Сохраняет архив. Возвращает путь, куда он лёг, либо null — сохранение выключено настройкой.
+    /// Ошибка записи наружу не идёт: дамп уже собран, и терять его из-за недоступной папки нельзя.
+    /// </summary>
+    Task<string?> SaveAsync(string fileName, byte[] content, CancellationToken cancellationToken);
+}

backend/src/TeleWave.Application/Common/Interfaces/IDiagnosticsProbe.cs

@@ -0,0 +1,26 @@
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>
+/// Живые проверки инфраструктуры для админской диагностики: свободное место на томе хранилища и
+/// доступность внешних инструментов (ffmpeg/ffprobe). Отдельный порт — чтобы Application не ходил
+/// в файловую систему и процессы напрямую: это забота Infrastructure.
+/// </summary>
+public interface IDiagnosticsProbe
+{
+    Task<StorageProbe> ProbeStorageAsync(CancellationToken cancellationToken);
+    Task<ToolProbe> ProbeFfmpegAsync(CancellationToken cancellationToken);
+    Task<ToolProbe> ProbeFfprobeAsync(CancellationToken cancellationToken);
+}
+
+/// <summary>Состояние тома хранилища. Нули в размерах — ФС не отдала метрику (экзотический маунт).</summary>
+public sealed record StorageProbe(
+    string RootPath,
+    bool Exists,
+    bool Writable,
+    long TotalBytes,
+    long FreeBytes,
+    long MinFreeBytes
+);
+
+/// <summary>Доступность внешнего инструмента и его версия (первая строка вывода <c>-version</c>).</summary>
+public sealed record ToolProbe(bool Available, string? Version);

backend/src/TeleWave.Application/Common/Interfaces/IMediaProcessingLimits.cs

@@ -0,0 +1,14 @@
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>
+/// Пропускная способность обработчика медиа. Нужна, чтобы по очереди и среднему времени посчитать,
+/// когда она разгребётся: при двух параллельных транскодах ждать вдвое меньше, чем при одном.
+///
+/// Порт, а не чтение настроек напрямую: настройки ffmpeg живут в Infrastructure, и прикладной слой
+/// про их устройство знать не должен.
+/// </summary>
+public interface IMediaProcessingLimits
+{
+    /// <summary>Сколько файлов обрабатывается одновременно.</summary>
+    int MaxParallelTranscodes { get; }
+}

backend/src/TeleWave.Application/Common/Interfaces/IMediaStorage.cs

@@ -11,6 +11,12 @@ public interface IMediaStorage
     /// <summary>Свободное место на томе хранилища, байт.</summary>
     long GetAvailableFreeSpaceBytes();
 
+    /// <summary>
+    /// Абсолютный путь к HLS-плейлисту готового ассета (<c>assets/{id}/index.m3u8</c>) — им ffmpeg
+    /// читает уже нарезанное медиа как обычный вход. Null, если каталога ассета нет на диске.
+    /// </summary>
+    string? ResolvePlaylistPath(Guid assetId);
+
     /// <summary>
     /// Стримит загружаемый контент во временный файл в <c>uploads/</c> без буферизации в память.
     /// Возвращает непрозрачный токен (имя временного файла) для последующего <see cref="PromoteToOriginalAsync"/>.
@@ -35,9 +41,10 @@ public interface IMediaStorage
     IReadOnlyList<ManualInboxFile> ListManualInbox(int max);
 
     /// <summary>
-    /// Убирает то, что осталось в <c>manual/</c> рядом с забранным файлом: спутники с тем же именем
+    /// Убирает то, что осталось в <c>manual/</c> от забранного файла: спутники с тем же именем
-    /// и другим расширением (субтитры, nfo, обложка) и опустевший каталог. Другие видеофайлы
+    /// и другим расширением (субтитры, nfo, обложка), файлы того же эпизода в соседних подпапках
-    /// не трогает — рядом может лежать следующая серия.
+    /// (<c>subs_ru</c>, <c>Subtitles</c>) и опустевшие каталоги вверх до корня <c>manual/</c>.
+    /// Другие видеофайлы не трогает — рядом может лежать следующая серия или иная версия.
     /// </summary>
     Task CleanupManualLeftoversAsync(string relativePath, CancellationToken cancellationToken);
 

backend/src/TeleWave.Application/Common/Interfaces/IMetadataProvider.cs

@@ -48,6 +48,15 @@ public interface IMetadataProvider
         int season,
         CancellationToken cancellationToken
     );
+
+    /// <summary>
+    /// Номера сезонов сериала по данным источника (пусто — источник не отдал данные). Спецвыпуски
+    /// (нулевой сезон) не отдаются: в библиотеку они не грузятся и считались бы вечно отсутствующими.
+    /// </summary>
+    Task<IReadOnlyList<int>> GetSeasonNumbersAsync(
+        string externalId,
+        CancellationToken cancellationToken
+    );
 }
 
 /// <summary>Резолвит провайдер по ключу и перечисляет реально настроенные (с API-ключом) источники.</summary>

backend/src/TeleWave.Application/Common/Interfaces/IStorageInspector.cs

@@ -0,0 +1,72 @@
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>
+/// Части хранилища, которые считаются отдельно. Это не «папки», а ответ на вопрос «чем занят диск»:
+/// сегменты программ и сегменты заставок лежат в одном каталоге, но растут по разным причинам,
+/// и администратору важно видеть их порознь.
+/// </summary>
+public enum StorageArea
+{
+    /// <summary>HLS-сегменты программ — обычно это почти весь объём.</summary>
+    Assets = 0,
+
+    /// <summary>HLS-сегменты отрендеренных заставок.</summary>
+    BumperAssets = 1,
+
+    /// <summary>Исходники, оставленные после нарезки (<c>Storage:KeepOriginals</c>).</summary>
+    Originals = 2,
+
+    /// <summary>Автоматический inbox — то, что ещё не разобрано сканером.</summary>
+    Inbox = 3,
+
+    /// <summary>Ручной inbox — то, что админ забирает в шоу сам.</summary>
+    ManualInbox = 4,
+
+    /// <summary>Перевалочный каталог заливок: всё, что здесь залежалось, — след оборванной загрузки.</summary>
+    Uploads = 5,
+
+    /// <summary>Звук и фоны блоков заставок (сырые файлы, не нарезка).</summary>
+    BumperSources = 6,
+
+    /// <summary>Общий реестр изображений: постеры, кадры, логотипы.</summary>
+    Images = 7,
+
+    /// <summary>Всё прочее под корнем хранилища — обычно ноль, а если нет, то это и надо увидеть.</summary>
+    Other = 8,
+}
+
+/// <param name="Bytes">Объём области, байт.</param>
+/// <param name="Files">Число файлов — по нему видно, что «пусто» и «много мелочи» это разные беды.</param>
+public sealed record StorageAreaUsage(StorageArea Area, long Bytes, int Files);
+
+/// <param name="RootPath">Корень хранилища — на сервере их может быть несколько, и надо видеть, о каком речь.</param>
+/// <param name="VolumeTotalBytes">Размер тома целиком; 0 — файловая система не отдала метрику.</param>
+/// <param name="VolumeFreeBytes">Свободно на томе. Свободное место делится со всем, что есть на диске.</param>
+/// <param name="MinFreeSpaceBytes">Порог, ниже которого загрузка отклоняется; едет вместе с цифрами тома, чтобы их было с чем сравнить.</param>
+/// <param name="ComputedAt">Когда посчитано: обход дерева кэшируется, и возраст цифры надо показывать.</param>
+public sealed record StorageUsage(
+    string RootPath,
+    long VolumeTotalBytes,
+    long VolumeFreeBytes,
+    long StorageBytes,
+    int StorageFiles,
+    long MinFreeSpaceBytes,
+    IReadOnlyList<StorageAreaUsage> Areas,
+    DateTimeOffset ComputedAt
+);
+
+/// <summary>
+/// Порт подсчёта занятого места. Размеров в БД нет и не будет: правда о диске лежит на диске,
+/// а любое дублирование в таблицах разошлось бы с ней при первой же ручной правке файлов.
+///
+/// Обход дерева стоит дорого (сегментов — сотни тысяч), поэтому результат кэшируется реализацией,
+/// а <paramref name="refresh"/> — это явная кнопка «пересчитать» в админке.
+/// </summary>
+public interface IStorageInspector
+{
+    Task<StorageUsage> InspectAsync(
+        IReadOnlySet<Guid> generatedAssetIds,
+        bool refresh,
+        CancellationToken cancellationToken
+    );
+}

backend/src/TeleWave.Application/Common/Interfaces/ITelegramApi.cs

@@ -0,0 +1,90 @@
+using TeleWave.Domain.Notifications;
+
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>Кнопка инлайн-клавиатуры: подпись и что вернётся в callback.</summary>
+public sealed record TelegramButton(string Text, string CallbackData);
+
+/// <summary>Обновление от Telegram — только то, что нам нужно от его модели.</summary>
+public sealed record TelegramUpdate(
+    long UpdateId,
+    long? ChatId,
+    string? Text,
+    string? From,
+    /// <summary>Идентификатор нажатия: на него надо ответить, иначе кнопка «крутится» у зрителя.</summary>
+    string? CallbackId,
+    string? CallbackData,
+    long? CallbackMessageId
+);
+
+/// <summary>Кто мы для Telegram — ответ getMe, по нему проверяется токен.</summary>
+public sealed record TelegramBotInfo(long Id, string Username);
+
+/// <summary>
+/// Порт к Bot API. Держим ровно те вызовы, что нужны боту расписания: узнать себя, получить
+/// обновления, ответить сообщением с кнопками и переключить вебхук.
+///
+/// Настройки (токен, прокси) реализация читает сама на каждый вызов: админ меняет их в рантайме,
+/// и держать клиента, собранного на старте, значило бы требовать перезапуск контейнера.
+/// </summary>
+public interface ITelegramApi
+{
+    Task<TelegramBotInfo?> GetMeAsync(
+        TelegramSettings settings,
+        CancellationToken cancellationToken
+    );
+
+    Task<IReadOnlyList<TelegramUpdate>> GetUpdatesAsync(
+        TelegramSettings settings,
+        long offset,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>Отправляет сообщение и возвращает его идентификатор — по нему потом правят и удаляют.</summary>
+    Task<long?> SendMessageAsync(
+        TelegramSettings settings,
+        long chatId,
+        string text,
+        IReadOnlyList<IReadOnlyList<TelegramButton>>? keyboard,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>Переписывает уже отправленное сообщение — так меню подписок обновляется на месте.</summary>
+    Task EditMessageAsync(
+        TelegramSettings settings,
+        long chatId,
+        long messageId,
+        string text,
+        IReadOnlyList<IReadOnlyList<TelegramButton>>? keyboard,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>
+    /// Снимает своё сообщение. В личном чате бот вправе удалять только собственные — команды
+    /// зрителя остаются, и это не в нашей власти.
+    /// </summary>
+    Task DeleteMessageAsync(
+        TelegramSettings settings,
+        long chatId,
+        long messageId,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>Гасит «часики» на нажатой кнопке; текст — всплывающая подсказка.</summary>
+    Task AnswerCallbackAsync(
+        TelegramSettings settings,
+        string callbackId,
+        string? text,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>
+    /// Разбирает тело вебхука в то же обновление, что приходит опросом: разговор с ботом один,
+    /// и знать про две модели ему незачем. null — тело не разобралось.
+    /// </summary>
+    Task<TelegramUpdate?> ReadUpdateAsync(Stream body, CancellationToken cancellationToken);
+
+    Task SetWebhookAsync(TelegramSettings settings, CancellationToken cancellationToken);
+
+    Task DeleteWebhookAsync(TelegramSettings settings, CancellationToken cancellationToken);
+}

backend/src/TeleWave.Application/Common/Models/UsageText.cs

@@ -0,0 +1,28 @@
+namespace TeleWave.Application.Common.Models;
+
+/// <summary>
+/// Склейка ответа на вопрос «где это используется» для текста ошибки. Отказ вида «объект занят»
+/// без адреса заставляет обходить все экраны подряд, а перечисление держателей превращает ошибку
+/// в инструкцию: видно, что именно отвязать.
+/// </summary>
+public static class UsageText
+{
+    /// <summary>Сколько имён показываем: длинный список в тосте всё равно не читается.</summary>
+    private const int MaxNames = 5;
+
+    /// <summary>Раздел перечисления: «слоты каналов: Первый, Второй». Пустой список — пропускается.</summary>
+    public static string? Part(string what, IReadOnlyCollection<string> names)
+    {
+        if (names.Count == 0)
+            return null;
+
+        var shown = string.Join(", ", names.Take(MaxNames));
+        return names.Count > MaxNames
+            ? $"{what}: {shown} и ещё {names.Count - MaxNames}"
+            : $"{what}: {shown}";
+    }
+
+    /// <summary>Собирает разделы в одну строку; пустые отбрасываются.</summary>
+    public static string Join(params string?[] parts) =>
+        string.Join("; ", parts.Where(p => !string.IsNullOrWhiteSpace(p)));
+}

backend/src/TeleWave.Application/DependencyInjection.cs

@@ -5,10 +5,21 @@ using LiteCqrs.DependencyInjection;
 using Microsoft.Extensions.DependencyInjection;
 using TeleWave.Application.Broadcast.Bumpers;
 using TeleWave.Application.Common.Behaviors;
+using TeleWave.Application.Library.Collections;
+using TeleWave.Application.Library.Collections.Suggest;
 using TeleWave.Application.Library.Genres;
+using TeleWave.Application.Media;
+using TeleWave.Application.Media.ManualInbox;
+using TeleWave.Application.Media.MovieImport;
+using TeleWave.Application.Metadata;
+using TeleWave.Application.Notifications;
+using TeleWave.Application.Notifications.Settings;
 using TeleWave.Application.Programming.Groups;
+using TeleWave.Application.Programming.Groups.Suggest;
 using TeleWave.Application.Programming.Planning;
+using TeleWave.Application.Programming.Planning.DebugExport;
 using TeleWave.Application.Programming.Templates;
+using TeleWave.Application.Programming.Templates.Generate;
 
 namespace TeleWave.Application;
 
@@ -35,14 +46,31 @@ public static class DependencyInjection
         // здесь, а не в Infrastructure: тот слой не должен знать внутреннего устройства Application.
         services.AddScoped<BumperSpecLoader>();
         services.AddScoped<GenreMatcher>();
+        services.AddScoped<ShowMetadataApplier>();
+        services.AddScoped<MovieMatcher>();
+        services.AddScoped<ManualInboxTaker>();
+        services.AddScoped<ShowMediaEraser>();
+        services.AddScoped<CollectionSuggestionBuilder>();
+        services.AddScoped<CollectionPosterPicker>();
         services.AddScoped<GroupElementResolver>();
+        services.AddScoped<GroupFilterMatcher>();
+        services.AddScoped<DynamicGroupResolver>();
         services.AddScoped<GroupStatsService>();
+        services.AddScoped<GroupSuggestionBuilder>();
         services.AddScoped<GroupMembershipCleaner>();
+        services.AddScoped<InterstitialGroups>();
         services.AddScoped<SlotWriter>();
+        services.AddScoped<GroupCatalog>();
+        services.AddScoped<GridPlanner>();
         services.AddScoped<GroupExpander>();
         services.AddScoped<BumperResolver>();
         services.AddScoped<PostCheckRunner>();
         services.AddScoped<GridScheduleGenerator>();
+        services.AddScoped<ChannelDebugCollector>();
+        services.AddScoped<LibraryDebugCollector>();
+        services.AddScoped<TelegramSettingsService>();
+        services.AddScoped<TelegramBotService>();
+        services.AddScoped<TelegramNotifier>();
 
         return services;
     }

backend/src/TeleWave.Application/Diagnostics/GetSystemDiagnosticsQuery.cs

@@ -0,0 +1,29 @@
+using LiteCqrs;
+
+namespace TeleWave.Application.Diagnostics;
+
+/// <summary>Живое состояние инфраструктуры для админской панели диагностики: БД, хранилище, ffmpeg.</summary>
+public sealed record GetSystemDiagnosticsQuery : IQuery<SystemDiagnosticsDto>;
+
+public sealed record SystemDiagnosticsDto(
+    DatabaseDiagnosticsDto Database,
+    StorageDiagnosticsDto Storage,
+    ToolDiagnosticsDto Ffmpeg,
+    ToolDiagnosticsDto Ffprobe
+);
+
+/// <summary>Доступность БД и время лёгкого запроса; при ошибке — её текст без latency.</summary>
+public sealed record DatabaseDiagnosticsDto(bool Reachable, long? LatencyMs, string? Error);
+
+/// <summary><c>LowSpace</c> — свободного меньше порога <c>MinFreeBytes</c> (место известно и оно мало).</summary>
+public sealed record StorageDiagnosticsDto(
+    string RootPath,
+    bool Exists,
+    bool Writable,
+    long TotalBytes,
+    long FreeBytes,
+    long MinFreeBytes,
+    bool LowSpace
+);
+
+public sealed record ToolDiagnosticsDto(bool Available, string? Version);

backend/src/TeleWave.Application/Diagnostics/GetSystemDiagnosticsQueryHandler.cs

@@ -0,0 +1,64 @@
+using System.Data.Common;
+using System.Diagnostics;
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+
+namespace TeleWave.Application.Diagnostics;
+
+public sealed class GetSystemDiagnosticsQueryHandler(
+    IAppDbContext dbContext,
+    IDiagnosticsProbe probe
+) : IQueryHandler<GetSystemDiagnosticsQuery, SystemDiagnosticsDto>
+{
+    public async Task<SystemDiagnosticsDto> Handle(
+        GetSystemDiagnosticsQuery query,
+        CancellationToken cancellationToken
+    )
+    {
+        var database = await CheckDatabaseAsync(cancellationToken);
+        var storageProbe = await probe.ProbeStorageAsync(cancellationToken);
+        var ffmpeg = await probe.ProbeFfmpegAsync(cancellationToken);
+        var ffprobe = await probe.ProbeFfprobeAsync(cancellationToken);
+
+        var storage = new StorageDiagnosticsDto(
+            storageProbe.RootPath,
+            storageProbe.Exists,
+            storageProbe.Writable,
+            storageProbe.TotalBytes,
+            storageProbe.FreeBytes,
+            storageProbe.MinFreeBytes,
+            LowSpace: storageProbe.FreeBytes > 0
+                && storageProbe.FreeBytes < storageProbe.MinFreeBytes
+        );
+
+        return new SystemDiagnosticsDto(
+            database,
+            storage,
+            new ToolDiagnosticsDto(ffmpeg.Available, ffmpeg.Version),
+            new ToolDiagnosticsDto(ffprobe.Available, ffprobe.Version)
+        );
+    }
+
+    /// <summary>
+    /// Лёгкая живая проверка БД: тривиальный запрос под секундомер. Не полагаемся на стартовый
+    /// health-check — админ хочет видеть состояние прямо сейчас. Ловим <see cref="DbException"/>
+    /// (база провайдера Npgsql-исключений) — так Application не тянет ссылку на Npgsql.
+    /// </summary>
+    private async Task<DatabaseDiagnosticsDto> CheckDatabaseAsync(
+        CancellationToken cancellationToken
+    )
+    {
+        var stopwatch = Stopwatch.StartNew();
+        try
+        {
+            await dbContext.AppSettings.AnyAsync(cancellationToken);
+            stopwatch.Stop();
+            return new DatabaseDiagnosticsDto(true, stopwatch.ElapsedMilliseconds, null);
+        }
+        catch (DbException ex)
+        {
+            return new DatabaseDiagnosticsDto(false, null, ex.Message);
+        }
+    }
+}

backend/src/TeleWave.Application/Library/BulkTagShows/BulkTagShowsCommand.cs

@@ -0,0 +1,28 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+using TeleWave.Domain.Library;
+
+namespace TeleWave.Application.Library.BulkTagShows;
+
+/// <summary>
+/// Проставляет жанры и/или возрастной рейтинг сразу нескольким шоу. Оба поля необязательны и
+/// применяются независимо: обычно правят что-то одно, а связывать их в одну форму значило бы
+/// заставлять переставлять второе «как было».
+/// </summary>
+/// <param name="GenreIds">
+/// Что делать с жанрами: null — не трогать. Иначе <paramref name="ReplaceGenres"/> решает, заменить
+/// набор целиком или дописать к имеющимся.
+/// </param>
+/// <param name="ReplaceGenres">
+/// true — заменить набор жанров переданным; false — дописать. Дописывание нужно чаще: у шоу уже
+/// есть жанры из метаданных, и разметка «это ещё и детское» не должна их стирать.
+/// </param>
+/// <param name="Audience">Рейтинг: null со <paramref name="SetAudience"/> = true снимает проставленный.</param>
+/// <param name="SetAudience">Трогать ли рейтинг вообще.</param>
+public sealed record BulkTagShowsCommand(
+    IReadOnlyList<Guid> ShowIds,
+    IReadOnlyList<Guid>? GenreIds = null,
+    bool ReplaceGenres = false,
+    ShowAudience? Audience = null,
+    bool SetAudience = false
+) : ICommand<Result<int>>;

backend/src/TeleWave.Application/Library/BulkTagShows/BulkTagShowsCommandHandler.cs

@@ -0,0 +1,66 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+using TeleWave.Application.Library.Genres;
+
+namespace TeleWave.Application.Library.BulkTagShows;
+
+public sealed class BulkTagShowsCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<BulkTagShowsCommand, Result<int>>
+{
+    public async Task<Result<int>> Handle(
+        BulkTagShowsCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var showIds = command.ShowIds.Distinct().ToList();
+        if (showIds.Count == 0)
+            return Result.Success(0);
+
+        var genreIds = command.GenreIds?.Distinct().ToList();
+        if (genreIds is { Count: > 0 })
+        {
+            // Ссылка на несуществующий жанр упала бы нарушением внешнего ключа — проверяем заранее.
+            var known = await dbContext
+                .Genres.Where(g => genreIds.Contains(g.Id))
+                .CountAsync(cancellationToken);
+            if (known != genreIds.Count)
+                return Result.Failure<int>(GenreErrors.NotFound);
+        }
+
+        var shows = await dbContext
+            .Shows.Include(s => s.Genres)
+            .Where(s => showIds.Contains(s.Id))
+            .ToListAsync(cancellationToken);
+
+        // Пропавшее шоу не роняет всю операцию: список выбирали галочками, и пока его собирали,
+        // что-то могли удалить. Возвращаем, скольких реально коснулись.
+        foreach (var show in shows)
+        {
+            if (genreIds is not null)
+                ApplyGenres(show, genreIds, command.ReplaceGenres);
+
+            if (command.SetAudience)
+                show.SetAudience(command.Audience);
+        }
+
+        return Result.Success(shows.Count);
+    }
+
+    /// <summary>
+    /// Основным остаётся прежний основной жанр — массовая разметка не должна незаметно менять то,
+    /// что показано в списке шоу. Если его не было (жанров не было вовсе), основным станет первый
+    /// из добавленных, как и при обычной правке.
+    /// </summary>
+    private static void ApplyGenres(
+        Domain.Library.Show show,
+        IReadOnlyList<Guid> genreIds,
+        bool replace
+    )
+    {
+        var primary = show.PrimaryGenreId;
+        var ids = replace ? genreIds : show.Genres.Select(g => g.GenreId).Union(genreIds).ToList();
+        show.SetGenres(ids, ids.Contains(primary ?? Guid.Empty) ? primary : null);
+    }
+}

backend/src/TeleWave.Application/Library/BulkTagShows/BulkTagShowsCommandValidator.cs

@@ -0,0 +1,15 @@
+using FluentValidation;
+
+namespace TeleWave.Application.Library.BulkTagShows;
+
+public sealed class BulkTagShowsCommandValidator : AbstractValidator<BulkTagShowsCommand>
+{
+    public BulkTagShowsCommandValidator()
+    {
+        RuleFor(x => x.ShowIds).NotEmpty();
+        // Команда, которая ничего не меняет, — почти наверняка недосмотр вызывающей стороны.
+        RuleFor(x => x)
+            .Must(x => x.GenreIds is not null || x.SetAudience)
+            .WithMessage("Нечего применять: не заданы ни жанры, ни рейтинг.");
+    }
+}

backend/src/TeleWave.Application/Library/Collections/AddShowsToCollection/AddShowsToCollectionCommand.cs

@@ -0,0 +1,22 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.AddShowsToCollection;
+
+/// <summary>
+/// Отправляет несколько шоу во франшизу разом. Коллекция либо уже есть
+/// (<paramref name="CollectionId"/>), либо заводится по имени
+/// (<paramref name="NewCollectionName"/>) — иначе на сборку франшизы уходило бы два экрана.
+///
+/// Порядок добавления — по году выпуска: сиквелы почти всегда идут так, а исключения правятся
+/// перетаскиванием в карточке коллекции.
+/// </summary>
+public sealed record AddShowsToCollectionCommand(
+    IReadOnlyList<Guid> ShowIds,
+    Guid? CollectionId = null,
+    string? NewCollectionName = null
+) : ICommand<Result<AddShowsToCollectionResultDto>>;
+
+/// <param name="CollectionId">Куда в итоге сложили — новая коллекция или переданная.</param>
+/// <param name="Added">Сколько шоу реально добавлено (уже входящие пропускаются).</param>
+public sealed record AddShowsToCollectionResultDto(Guid CollectionId, string Name, int Added);

backend/src/TeleWave.Application/Library/Collections/AddShowsToCollection/AddShowsToCollectionCommandHandler.cs

@@ -0,0 +1,62 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+using TeleWave.Domain.Library;
+
+namespace TeleWave.Application.Library.Collections.AddShowsToCollection;
+
+public sealed class AddShowsToCollectionCommandHandler(IAppDbContext dbContext)
+    : ICommandHandler<AddShowsToCollectionCommand, Result<AddShowsToCollectionResultDto>>
+{
+    public async Task<Result<AddShowsToCollectionResultDto>> Handle(
+        AddShowsToCollectionCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var showIds = command.ShowIds.Distinct().ToList();
+        var shows = await dbContext
+            .Shows.AsNoTracking()
+            .Where(s => showIds.Contains(s.Id))
+            .Select(s => new
+            {
+                s.Id,
+                s.Name,
+                s.Year,
+            })
+            .ToListAsync(cancellationToken);
+        if (shows.Count == 0)
+            return Result.Failure<AddShowsToCollectionResultDto>(ShowErrors.NotFound);
+
+        var collection = await ResolveCollectionAsync(command, cancellationToken);
+        if (collection is null)
+            return Result.Failure<AddShowsToCollectionResultDto>(CollectionErrors.NotFound);
+
+        // Год — главный порядок франшизы; без года часть уходит в конец, там её и переставят руками.
+        var ordered = shows
+            .OrderBy(s => s.Year is null)
+            .ThenBy(s => s.Year)
+            .ThenBy(s => s.Name, StringComparer.CurrentCultureIgnoreCase);
+
+        var added = ordered.Count(show => collection.AddShow(show.Id) is not null);
+
+        return Result.Success(
+            new AddShowsToCollectionResultDto(collection.Id, collection.Name, added)
+        );
+    }
+
+    private async Task<Collection?> ResolveCollectionAsync(
+        AddShowsToCollectionCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        if (command.CollectionId is { } id)
+            return await dbContext
+                .Collections.Include(c => c.Items)
+                .FirstOrDefaultAsync(c => c.Id == id, cancellationToken);
+
+        var created = Collection.Create(command.NewCollectionName!);
+        dbContext.Collections.Add(created);
+        return created;
+    }
+}

backend/src/TeleWave.Application/Library/Collections/AddShowsToCollection/AddShowsToCollectionCommandValidator.cs

@@ -0,0 +1,19 @@
+using FluentValidation;
+
+namespace TeleWave.Application.Library.Collections.AddShowsToCollection;
+
+public sealed class AddShowsToCollectionCommandValidator
+    : AbstractValidator<AddShowsToCollectionCommand>
+{
+    public AddShowsToCollectionCommandValidator()
+    {
+        RuleFor(x => x.ShowIds).NotEmpty();
+        // Либо кладём в существующую, либо заводим новую — «ни то ни другое» указывает на ошибку UI.
+        RuleFor(x => x)
+            .Must(x =>
+                x.CollectionId is not null || !string.IsNullOrWhiteSpace(x.NewCollectionName)
+            )
+            .WithMessage("Не указано, в какую коллекцию складывать.");
+        RuleFor(x => x.NewCollectionName).MaximumLength(256);
+    }
+}

backend/src/TeleWave.Application/Library/Collections/CollectionErrors.cs

@@ -18,4 +18,14 @@ public static class CollectionErrors
         "Collections.ShowNotInCollection",
         "Шоу не входит в коллекцию."
     );
+
+    public static readonly Error SuggestionNotFound = Error.NotFound(
+        "Collections.SuggestionNotFound",
+        "Предложение устарело — библиотека изменилась. Обновите список предложений."
+    );
+
+    public static readonly Error SuggestionAlreadyCreated = Error.Conflict(
+        "Collections.SuggestionAlreadyCreated",
+        "Коллекция с таким названием уже есть."
+    );
 }

backend/src/TeleWave.Application/Library/Collections/CollectionPosterPicker.cs

@@ -0,0 +1,72 @@
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Domain.Library;
+
+namespace TeleWave.Application.Library.Collections;
+
+/// <summary>
+/// Подбирает коллекции постер по её частям: берётся первая часть с постером — обычно это первый
+/// фильм цикла, и он же узнаётся с обложки. Отдельный тип, потому что подбор нужен и при создании
+/// коллекции, и по кнопке для уже заведённых.
+///
+/// Своего изображения коллекция не заводит: постер — это тот же <see cref="Image"/> из реестра,
+/// на который ссылается шоу. Копировать файл ради второй ссылки незачем.
+/// </summary>
+public sealed class CollectionPosterPicker(IAppDbContext dbContext)
+{
+    /// <summary>
+    /// Проставляет постер коллекциям, у которых его нет. Уже выбранный не трогаем: его мог
+    /// поставить человек, и перебивать такой выбор автоматикой нельзя. Возвращает, скольким
+    /// коллекциям постер нашёлся.
+    /// </summary>
+    public async Task<int> FillAsync(
+        IReadOnlyList<Collection> collections,
+        CancellationToken cancellationToken
+    )
+    {
+        var pending = collections.Where(c => c.PosterImageId is null).ToList();
+        if (pending.Count == 0)
+            return 0;
+
+        var posters = await PostersAsync(pending, cancellationToken);
+        var filled = 0;
+
+        foreach (var collection in pending)
+        {
+            if (Pick(collection, posters) is not { } imageId)
+                continue;
+
+            collection.SetPosterImage(imageId);
+            filled++;
+        }
+
+        return filled;
+    }
+
+    /// <summary>Постер первой по порядку части, у которой он есть.</summary>
+    private static Guid? Pick(Collection collection, IReadOnlyDictionary<Guid, Guid> posters) =>
+        collection
+            .Items.OrderBy(i => i.Position)
+            .Select(i => posters.TryGetValue(i.ShowId, out var image) ? image : (Guid?)null)
+            .FirstOrDefault(image => image is not null);
+
+    /// <summary>Постеры шоу, входящих в эти коллекции, одним запросом на всю пачку.</summary>
+    private async Task<Dictionary<Guid, Guid>> PostersAsync(
+        IReadOnlyList<Collection> collections,
+        CancellationToken cancellationToken
+    )
+    {
+        var showIds = collections
+            .SelectMany(c => c.Items.Select(i => i.ShowId))
+            .Distinct()
+            .ToList();
+
+        var shows = await dbContext
+            .Shows.AsNoTracking()
+            .Where(s => showIds.Contains(s.Id) && s.PosterImageId != null)
+            .Select(s => new { s.Id, PosterImageId = s.PosterImageId!.Value })
+            .ToListAsync(cancellationToken);
+
+        return shows.ToDictionary(s => s.Id, s => s.PosterImageId);
+    }
+}

backend/src/TeleWave.Application/Library/Collections/FillCollectionPosters/FillCollectionPostersCommand.cs

@@ -0,0 +1,11 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.FillCollectionPosters;
+
+/// <summary>
+/// Проставляет постеры коллекциям по их частям. Пустой список — всем коллекциям без постера:
+/// после массового импорта фильмов их сразу десятки, и обходить каждую руками бессмысленно.
+/// </summary>
+public sealed record FillCollectionPostersCommand(IReadOnlyList<Guid>? CollectionIds = null)
+    : ICommand<Result<int>>;

backend/src/TeleWave.Application/Library/Collections/FillCollectionPosters/FillCollectionPostersCommandHandler.cs

@@ -0,0 +1,28 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.FillCollectionPosters;
+
+public sealed class FillCollectionPostersCommandHandler(
+    IAppDbContext dbContext,
+    CollectionPosterPicker picker
+) : ICommandHandler<FillCollectionPostersCommand, Result<int>>
+{
+    public async Task<Result<int>> Handle(
+        FillCollectionPostersCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var query = dbContext.Collections.Include(c => c.Items).AsQueryable();
+
+        if (command.CollectionIds is { Count: > 0 } ids)
+            query = query.Where(c => ids.Contains(c.Id));
+
+        var collections = await query.ToListAsync(cancellationToken);
+        var filled = await picker.FillAsync(collections, cancellationToken);
+
+        return Result.Success(filled);
+    }
+}

backend/src/TeleWave.Application/Library/Collections/Suggest/AddSuggestedShowsCommand.cs

@@ -0,0 +1,10 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.Suggest;
+
+/// <summary>
+/// Дополняет уже собранную франшизу по предложению: состав сервер пересобирает по ключу, а не берёт
+/// с клиента. Между показом и нажатием библиотека могла измениться — добавиться должно актуальное.
+/// </summary>
+public sealed record AddSuggestedShowsCommand(string Key) : ICommand<Result<int>>;

backend/src/TeleWave.Application/Library/Collections/Suggest/AddSuggestedShowsCommandHandler.cs

@@ -0,0 +1,43 @@
+using LiteCqrs;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.Suggest;
+
+public sealed class AddSuggestedShowsCommandHandler(
+    IAppDbContext dbContext,
+    CollectionSuggestionBuilder builder,
+    CollectionPosterPicker posters
+) : ICommandHandler<AddSuggestedShowsCommand, Result<int>>
+{
+    public async Task<Result<int>> Handle(
+        AddSuggestedShowsCommand command,
+        CancellationToken cancellationToken
+    )
+    {
+        var suggestions = await builder.BuildAsync(cancellationToken);
+        var suggestion = suggestions.FirstOrDefault(s => s.Key == command.Key);
+
+        // Ключ создания сюда приходить не должен: у такого предложения нет коллекции, которую
+        // дополнять. Для админа это одно и то же — список предложений устарел.
+        if (suggestion?.CollectionId is not { } collectionId)
+            return Result.Failure<int>(CollectionErrors.SuggestionNotFound);
+
+        var collection = await dbContext
+            .Collections.Include(c => c.Items)
+            .FirstOrDefaultAsync(c => c.Id == collectionId, cancellationToken);
+        if (collection is null)
+            return Result.Failure<int>(CollectionErrors.NotFound);
+
+        // Части предложения уже упорядочены по году, а AddShow ставит в конец: франшиза пополняется
+        // в хронологии, и переставлять руками обычно не приходится.
+        var added = suggestion.Parts.Count(part => collection.AddShow(part.ShowId) is not null);
+
+        // Коллекция без постера могла остаться такой именно потому, что первой части не хватало.
+        // Уже выбранный постер подборщик не трогает — проверять это здесь незачем.
+        await posters.FillAsync([collection], cancellationToken);
+
+        return Result.Success(added);
+    }
+}

backend/src/TeleWave.Application/Library/Collections/Suggest/CollectionSuggestionBuilder.cs

@@ -0,0 +1,353 @@
+using System.Text.RegularExpressions;
+using Microsoft.EntityFrameworkCore;
+using TeleWave.Application.Common.Interfaces;
+using TeleWave.Domain.Library;
+
+namespace TeleWave.Application.Library.Collections.Suggest;
+
+/// <summary>
+/// Предложение франшизы: имя и части в предлагаемом порядке. <paramref name="CollectionId"/>
+/// задан — франшиза уже собрана, и предлагается дополнить её найденными частями, а не заводить
+/// вторую такую же.
+/// </summary>
+public sealed record CollectionSuggestion(
+    string Key,
+    CollectionSuggestionSource Source,
+    string Name,
+    IReadOnlyList<CollectionSuggestionPartDto> Parts,
+    Guid? CollectionId = null
+);
+
+/// <summary>
+/// Ищет, что стоит собрать в коллекцию, среди полнометражек, ещё не входящих ни в одну.
+///
+/// Два источника, и они не равны по надёжности. Франшиза из метаданных — это факт: TMDb сам считает
+/// эти фильмы одним целым. Догадка по названиям — эвристика для библиотеки без метаданных, и она
+/// намеренно осторожна: совпадать должно осмысленное начало названия, а не первое слово, иначе
+/// «Человек-паук» и «Человек дождя» уедут в одну франшизу.
+///
+/// Предложений тоже два вида: собрать новую франшизу и **дополнить уже собранную**. Второй важнее,
+/// чем кажется: библиотека пополняется по одному фильму, и четвёртая часть, приехавшая после сборки
+/// коллекции, сама по себе франшизы не образует — раньше она просто не показывалась нигде.
+///
+/// Решение всё равно за человеком: предложение показывает состав целиком, а применяется кнопкой.
+/// Сериалы сюда не попадают — у них своя форма продолжения, сезоны.
+/// </summary>
+public sealed class CollectionSuggestionBuilder(IAppDbContext dbContext)
+{
+    /// <summary>Меньше двух частей — не франшиза.</summary>
+    private const int MinParts = 2;
+
+    /// <summary>
+    /// Со скольких общих слов начало названия само по себе считается признаком франшизы:
+    /// «Harry Potter and the …» случайным совпадением не бывает, а «Человек …» — бывает.
+    /// </summary>
+    private const int StrongCommonWords = 3;
+
+    /// <summary>
+    /// Чем продолжение отличается от однофамильца: номер («Рокки 2», «Рокки III»), слово «часть»
+    /// либо подзаголовок через двоеточие или тире («Матрица: Перезагрузка»). У «Человек дождя»
+    /// и «Человек-слон» хвосты — обычные слова, и в одну франшизу они не попадут.
+    /// </summary>
+    private static readonly Regex SequelTail = new(
+        @"^(?:\d{1,2}\b|[IVXivx]{1,4}\b|part\b|часть\b|[:–—-]\s*\S)",
+        RegexOptions.IgnoreCase | RegexOptions.CultureInvariant,
+        TimeSpan.FromSeconds(1)
+    );
+
+    public async Task<IReadOnlyList<CollectionSuggestion>> BuildAsync(
+        CancellationToken cancellationToken
+    )
+    {
+        var members = await dbContext
+            .CollectionItems.AsNoTracking()
+            .Select(i => new MemberRow(i.CollectionId, i.ShowId))
+            .ToListAsync(cancellationToken);
+
+        var allMovies = await dbContext
+            .Shows.AsNoTracking()
+            .Where(s => s.Kind == ShowKind.Single)
+            .Select(s => new MovieRow(
+                s.Id,
+                s.Name,
+                s.OriginalName,
+                s.Year,
+                s.FranchiseExternalId,
+                s.FranchiseName
+            ))
+            .ToListAsync(cancellationToken);
+
+        var inCollections = members.Select(m => m.ShowId).ToHashSet();
+        var movies = allMovies.Where(m => !inCollections.Contains(m.Id)).ToList();
+        if (movies.Count == 0)
+            return [];
+
+        var suggestions = new List<CollectionSuggestion>();
+        var taken = new HashSet<Guid>();
+
+        // Дополнение существующих идёт первым: если франшиза уже собрана, вторую такую же заводить
+        // нельзя (имя занято), и предложить админу «создать» вместо «добавить» значило бы завести
+        // его в конфликт.
+        var additions = await ToExistingAsync(movies, members, allMovies, cancellationToken);
+        foreach (var addition in additions)
+        {
+            suggestions.Add(addition);
+            foreach (var part in addition.Parts)
+                taken.Add(part.ShowId);
+        }
+
+        var free = movies.Where(m => !taken.Contains(m.Id)).ToList();
+
+        foreach (var franchise in ByMetadata(free))
+        {
+            suggestions.Add(franchise);
+            foreach (var part in franchise.Parts)
+                taken.Add(part.ShowId);
+        }
+
+        // По названиям добираем только то, что не разобрала метадата: иначе одни и те же фильмы
+        // попали бы в два предложения сразу и админ выбирал бы между ними вслепую.
+        suggestions.AddRange(ByName(free.Where(m => !taken.Contains(m.Id)).ToList()));
+
+        return
+        [
+            .. suggestions
+                // Дополнения выше новых франшиз: это точечное действие на один-два фильма, и оно
+                // не должно теряться под списком крупных предложений.
+                .OrderByDescending(s => s.CollectionId is not null)
+                .ThenBy(s => s.Source)
+                .ThenByDescending(s => s.Parts.Count)
+                .ThenBy(s => s.Name, StringComparer.CurrentCultureIgnoreCase),
+        ];
+    }
+
+    /// <summary>
+    /// Чего не хватает уже собранным франшизам. Фильм признаётся частью коллекции по тем же двум
+    /// признакам, что и при сборке новой: франшиза из метаданных совпала с франшизой любого её
+    /// участника либо название подошло по правилам догадки.
+    ///
+    /// Метадата проверяется по всем коллекциям раньше догадки: точное совпадение не должно
+    /// проигрывать похожему названию из соседней франшизы.
+    /// </summary>
+    private async Task<IReadOnlyList<CollectionSuggestion>> ToExistingAsync(
+        List<MovieRow> orphans,
+        List<MemberRow> members,
+        List<MovieRow> allMovies,
+        CancellationToken cancellationToken
+    )
+    {
+        var collections = await dbContext
+            .Collections.AsNoTracking()
+            .Select(c => new { c.Id, c.Name })
+            .ToListAsync(cancellationToken);
+        if (collections.Count == 0)
+            return [];
+
+        var byId = allMovies.ToDictionary(m => m.Id);
+        var membersByCollection = members
+            .GroupBy(m => m.CollectionId)
+            .ToDictionary(
+                g => g.Key,
+                // Сериал в коллекции — не ориентир для франшизы полнометражек: в справочнике
+                // фильмов его просто нет, поэтому он и отсеивается по словарю.
+                g => g.Where(m => byId.ContainsKey(m.ShowId)).Select(m => byId[m.ShowId]).ToList()
+            );
+
+        var hits = new Dictionary<Guid, List<MovieRow>>();
+
+        foreach (var orphan in orphans)
+        {
+            var target = collections.FirstOrDefault(c =>
+                Members(membersByCollection, c.Id).Any(m => SameMetadataFranchise(orphan, m))
+            );
+            var byMetadata = target is not null;
+
+            target ??= collections.FirstOrDefault(c =>
+                Members(membersByCollection, c.Id)
+                    .Any(m => SameFranchise(Words(Title(orphan)), Words(Title(m))))
+            );
+            if (target is null)
+                continue;
+
+            if (!hits.TryGetValue(target.Id, out var found))
+                hits[target.Id] = found = [];
+            found.Add(orphan with { MatchedByMetadata = byMetadata });
+        }
+
+        return
+        [
+            .. hits.Select(pair => new CollectionSuggestion(
+                $"existing:{pair.Key:N}",
+                // Источник — по самому слабому попаданию: одна догадка в наборе означает, что
+                // весь набор надо проверить глазами.
+                pair.Value.All(m => m.MatchedByMetadata)
+                    ? CollectionSuggestionSource.Metadata
+                    : CollectionSuggestionSource.NameGuess,
+                collections.First(c => c.Id == pair.Key).Name,
+                Parts(pair.Value),
+                pair.Key
+            )),
+        ];
+    }
+
+    private static List<MovieRow> Members(
+        Dictionary<Guid, List<MovieRow>> membersByCollection,
+        Guid collectionId
+    ) => membersByCollection.TryGetValue(collectionId, out var list) ? list : [];
+
+    /// <summary>Обе части знают свою франшизу из метаданных, и это одна и та же франшиза.</summary>
+    private static bool SameMetadataFranchise(MovieRow first, MovieRow second) =>
+        first.FranchiseExternalId is not null
+        && first.FranchiseExternalId == second.FranchiseExternalId;
+
+    private static IEnumerable<CollectionSuggestion> ByMetadata(List<MovieRow> movies)
+    {
+        var groups = movies
+            .Where(m => m.FranchiseExternalId is not null && m.FranchiseName is not null)
+            .GroupBy(m => m.FranchiseExternalId!)
+            .Where(g => g.Count() >= MinParts);
+
+        foreach (var group in groups)
+            yield return new CollectionSuggestion(
+                $"franchise:{group.Key}",
+                CollectionSuggestionSource.Metadata,
+                group.First().FranchiseName!,
+                Parts(group)
+            );
+    }
+
+    /// <summary>
+    /// Догадка по названиям для библиотеки без метаданных. Сравниваются целые слова, а не символы:
+    /// посимвольное совпадение слишком легко ловит однофамильцев («Человек дождя» и «Человек-слон»).
+    /// Пара считается франшизой, если общее начало длинное либо хвосты обеих частей выглядят
+    /// продолжением. Имя предложения — общее начало, очищенное от хвостовых предлогов и знаков.
+    /// </summary>
+    private static IEnumerable<CollectionSuggestion> ByName(List<MovieRow> movies)
+    {
+        var used = new HashSet<Guid>();
+
+        // От длинных названий к коротким: так более специфичная франшиза собирается первой.
+        foreach (var movie in movies.OrderByDescending(m => Title(m).Length))
+        {
+            if (used.Contains(movie.Id))
+                continue;
+
+            var words = Words(Title(movie));
+            var family = movies
+                .Where(other =>
+                    other.Id != movie.Id
+                    && !used.Contains(other.Id)
+                    && SameFranchise(words, Words(Title(other)))
+                )
+                .ToList();
+            if (family.Count == 0)
+                continue;
+
+            var common = family.Aggregate(
+                words,
+                (acc, other) => acc[..CommonWordCount(acc, Words(Title(other)))]
+            );
+            var name = Clean(string.Join(' ', common));
+            if (name.Length < 3)
+                continue;
+
+            family.Add(movie);
+            foreach (var part in family)
+                used.Add(part.Id);
+
+            yield return new CollectionSuggestion(
+                $"name:{name.ToLowerInvariant()}",
+                CollectionSuggestionSource.NameGuess,
+                name,
+                Parts(family)
+            );
+        }
+    }
+
+    /// <summary>Части идут по году: у франшизы это и есть порядок просмотра.</summary>
+    private static IReadOnlyList<CollectionSuggestionPartDto> Parts(IEnumerable<MovieRow> movies) =>
+        [
+            .. movies
+                .OrderBy(m => m.Year is null)
+                .ThenBy(m => m.Year)
+                .ThenBy(m => m.Name, StringComparer.CurrentCultureIgnoreCase)
+                .Select(m => new CollectionSuggestionPartDto(m.Id, m.Name, m.Year)),
+        ];
+
+    /// <summary>Сравниваем по оригинальному названию, если оно есть: у релизов оно стабильнее.</summary>
+    private static string Title(MovieRow movie) =>
+        string.IsNullOrWhiteSpace(movie.OriginalName) ? movie.Name : movie.OriginalName;
+
+    private static bool SameFranchise(string[] first, string[] second)
+    {
+        var common = CommonWordCount(first, second);
+        if (common == 0)
+            return false;
+        if (common >= StrongCommonWords)
+            return true;
+        return IsSequelTail(first, common) && IsSequelTail(second, common);
+    }
+
+    /// <summary>Хвост после общего начала: пусто — это первая часть, иначе должен выглядеть продолжением.</summary>
+    private static bool IsSequelTail(string[] words, int common)
+    {
+        var tail = string.Join(' ', words.Skip(common)).Trim();
+        return tail.Length == 0 || SequelTail.IsMatch(tail);
+    }
+
+    private static int CommonWordCount(string[] first, string[] second)
+    {
+        var count = 0;
+        while (
+            count < first.Length
+            && count < second.Length
+            && string.Equals(first[count], second[count], StringComparison.CurrentCultureIgnoreCase)
+        )
+            count++;
+        return count;
+    }
+
+    private static string[] Words(string title) =>
+        title.Split(' ', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+
+    /// <summary>
+    /// Общее начало обрывается на союзе или знаке: «Harry Potter and the» — это ещё не имя франшизы.
+    /// Чистим, пока есть что убирать: за один проход «and the» не снять.
+    /// </summary>
+    private static string Clean(string prefix)
+    {
+        var trimmed = prefix.Trim();
+        bool changed;
+        do
+        {
+            changed = false;
+            trimmed = trimmed.TrimEnd(':', '-', '–', '—', '.', ',', ' ');
+            foreach (var tail in (string[])[" и", " and", " the", " part", " часть"])
+            {
+                if (!trimmed.EndsWith(tail, StringComparison.CurrentCultureIgnoreCase))
+                    continue;
+                trimmed = trimmed[..^tail.Length];
+                changed = true;
+            }
+        } while (changed);
+
+        return trimmed.Trim();
+    }
+
+    /// <param name="MatchedByMetadata">
+    /// Как фильм попал в дополнение существующей коллекции: по франшизе из метаданных или догадкой
+    /// по названию. Живёт здесь, а не отдельным списком, чтобы признак не разъезжался с самим
+    /// фильмом при группировке.
+    /// </param>
+    private sealed record MovieRow(
+        Guid Id,
+        string Name,
+        string? OriginalName,
+        int? Year,
+        string? FranchiseExternalId,
+        string? FranchiseName,
+        bool MatchedByMetadata = false
+    );
+
+    private sealed record MemberRow(Guid CollectionId, Guid ShowId);
+}

backend/src/TeleWave.Application/Library/Collections/Suggest/CollectionSuggestionSource.cs

@@ -0,0 +1,11 @@
+namespace TeleWave.Application.Library.Collections.Suggest;
+
+/// <summary>Насколько предложению можно верить — по этому UI подписывает происхождение.</summary>
+public enum CollectionSuggestionSource
+{
+    /// <summary>Франшиза пришла из метаданных (TMDb знает её как единое целое).</summary>
+    Metadata = 0,
+
+    /// <summary>Догадка по названиям: общее начало и нумерация. Требует проверки глазами.</summary>
+    NameGuess = 1,
+}

backend/src/TeleWave.Application/Library/Collections/Suggest/CreateCollectionFromSuggestionCommand.cs

@@ -0,0 +1,11 @@
+using LiteCqrs;
+using TeleWave.Application.Common.Models;
+
+namespace TeleWave.Application.Library.Collections.Suggest;
+
+/// <summary>
+/// Создаёт коллекцию по предложению: имя и состав сервер пересобирает по ключу, а не берёт
+/// с клиента. Между показом и нажатием библиотека могла измениться — во франшизу должно попасть
+/// актуальное.
+/// </summary>
+public sealed record CreateCollectionFromSuggestionCommand(string Key) : ICommand<Result<Guid>>;