Add TV bumpers functionality: introduce configuration options for bumpers in .env.example and appsettings.json, enhance ChannelEndpoints to manage jingles and bumper assets, and update Channel and ScheduleEntry models to support bumper logic. Implement validation for bumper settings and integrate bumper handling in scheduling logic.

backend/src/TeleWave.Domain/Broadcast/Scheduling/SchedulePlannerModels.cs

@@ -21,6 +21,20 @@ public sealed record PlannerOverride(
 
 public sealed record PlannerOverrideShow(Guid ShowId, int Weight);
 
+/// <summary>
+/// Политика ТВ-заставок на переходах. <see cref="Duration"/> должна быть кратна длине сегмента
+/// (генератор выравнивает). Планировщик резервирует под заставку слот этой длины, а конкретный
+/// сгенерированный ассет подставляет уже оркестратор.
+/// </summary>
+public sealed record PlannerBumperConfig(
+    bool Enabled,
+    TimeSpan Duration,
+    bool OnlyBetweenDifferentShows,
+    TimeSpan MinInterval,
+    BumperMode Mode = BumperMode.Dynamic,
+    IReadOnlyList<Guid>? JinglePool = null
+);
+
 /// <summary>Полный вход планировщика для одного прогона по каналу.</summary>
 public sealed record PlannerInput(
     Guid ChannelId,
@@ -32,22 +46,31 @@ public sealed record PlannerInput(
     IReadOnlyDictionary<Guid, TimeSpan> Durations,
     IReadOnlyList<PlannerOverride> Overrides,
     DateTimeOffset StartTime,
-    DateTimeOffset HorizonEnd
+    DateTimeOffset HorizonEnd,
+    PlannerBumperConfig? Bumpers = null,
+    int NextJingleIndex = 0
 );
 
-/// <summary>Одна запланированная запись (ещё не доменная сущность).</summary>
+/// <summary>
+/// Одна запланированная запись (ещё не доменная сущность). Для заставок (<see cref="Kind"/> ==
+/// <see cref="ScheduleEntryKind.Bumper"/>) <see cref="MediaAssetId"/> пуст — его подставит
+/// оркестратор после рендера по паре (<see cref="FromShowId"/> → <see cref="ToShowId"/>).
+/// </summary>
 public sealed record PlannedEntry(
     Guid MediaAssetId,
     ScheduleEntryKind Kind,
     DateTimeOffset StartsAtUtc,
     DateTimeOffset EndsAtUtc,
     Guid? ShowId,
-    int? EpisodeIndex
+    int? EpisodeIndex,
+    Guid? FromShowId = null,
+    Guid? ToShowId = null
 );
 
 /// <summary>Результат прогона: новые записи + обновлённые курсоры (серий по каждому ChannelShow и рекламы).</summary>
 public sealed record PlannerResult(
     IReadOnlyList<PlannedEntry> Entries,
     IReadOnlyDictionary<Guid, int> NextEpisodeIndexByChannelShow,
-    int NextAdIndex
+    int NextAdIndex,
+    int NextJingleIndex
 );