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.

2026-07-25 00:45:22 +03:00
parent 622bf1e440
commit 0cfc72166a
60 changed files with 5073 additions and 33 deletions
@@ -203,6 +203,200 @@ public class SchedulePlannerTests
        Assert.Equal(b.ShowId, result.Entries[0].ShowId);
    }

+    [Fact]
+    public void Bumpers_InsertedOnTransitionBetweenDifferentShows_BackToBack()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20));
+
+        var input = BaseInput([a, b], durations, Start.AddMinutes(50)) with
+        {
+            Bumpers = new PlannerBumperConfig(true, TimeSpan.FromSeconds(8), OnlyBetweenDifferentShows: true, MinInterval: TimeSpan.Zero),
+        };
+
+        // Чередуем выбор: roll 0 → a, roll 1 → b (веса 1/1, total 2).
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        // Перед первым блоком заставки нет; далее по одной на каждый переход.
+        Assert.Equal(ScheduleEntryKind.Program, result.Entries[0].Kind);
+        var bumpers = result.Entries.Where(e => e.Kind == ScheduleEntryKind.Bumper).ToList();
+        Assert.NotEmpty(bumpers);
+
+        var first = result.Entries[1];
+        Assert.Equal(ScheduleEntryKind.Bumper, first.Kind);
+        Assert.Equal(Guid.Empty, first.MediaAssetId); // ассет подставит оркестратор
+        Assert.Equal(a.ShowId, first.FromShowId);
+        Assert.Equal(b.ShowId, first.ToShowId);
+        Assert.Equal(TimeSpan.FromSeconds(8), first.EndsAtUtc - first.StartsAtUtc);
+        // Встык: программа → заставка → программа.
+        Assert.Equal(result.Entries[0].EndsAtUtc, first.StartsAtUtc);
+        Assert.Equal(first.EndsAtUtc, result.Entries[2].StartsAtUtc);
+    }
+
+    [Fact]
+    public void Bumpers_SkippedForSameShow_WhenOnlyBetweenDifferentShows()
+    {
+        var cs = Guid.NewGuid();
+        Guid[] eps = [Guid.NewGuid(), Guid.NewGuid()];
+
+        var input = BaseInput(
+            [new PlannerShow(cs, Guid.NewGuid(), 1, BlockMode.Count, 1, eps, 0)],
+            Durations((eps[0], 20), (eps[1], 20)),
+            horizonEnd: Start.AddMinutes(50)
+        ) with
+        {
+            Bumpers = new PlannerBumperConfig(true, TimeSpan.FromSeconds(8), OnlyBetweenDifferentShows: true, MinInterval: TimeSpan.Zero),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0));
+
+        Assert.DoesNotContain(result.Entries, e => e.Kind == ScheduleEntryKind.Bumper);
+    }
+
+    [Fact]
+    public void Bumpers_InsertedForSameShow_WhenNotRestrictedToDifferent()
+    {
+        var cs = Guid.NewGuid();
+        Guid[] eps = [Guid.NewGuid(), Guid.NewGuid()];
+
+        var input = BaseInput(
+            [new PlannerShow(cs, Guid.NewGuid(), 1, BlockMode.Count, 1, eps, 0)],
+            Durations((eps[0], 20), (eps[1], 20)),
+            horizonEnd: Start.AddMinutes(50)
+        ) with
+        {
+            Bumpers = new PlannerBumperConfig(true, TimeSpan.FromSeconds(8), OnlyBetweenDifferentShows: false, MinInterval: TimeSpan.Zero),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0));
+
+        Assert.Contains(result.Entries, e => e.Kind == ScheduleEntryKind.Bumper);
+    }
+
+    [Fact]
+    public void Bumpers_MinInterval_SuppressesTooFrequentBumpers()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20));
+
+        // Два перехода в горизонте (~на 20-й и ~40-й минуте), но интервал 30 мин пропускает второй.
+        var input = BaseInput([a, b], durations, Start.AddMinutes(50)) with
+        {
+            Bumpers = new PlannerBumperConfig(
+                true,
+                TimeSpan.FromSeconds(8),
+                OnlyBetweenDifferentShows: true,
+                MinInterval: TimeSpan.FromMinutes(30)
+            ),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        Assert.Equal(1, result.Entries.Count(e => e.Kind == ScheduleEntryKind.Bumper));
+    }
+
+    [Fact]
+    public void Bumpers_StaticMode_UsesJinglesFromPoolInRotation()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        Guid j0 = Guid.NewGuid(),
+            j1 = Guid.NewGuid();
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20), (j0, 1), (j1, 1));
+
+        var input = BaseInput([a, b], durations, Start.AddMinutes(50)) with
+        {
+            Bumpers = new PlannerBumperConfig(
+                true,
+                TimeSpan.FromSeconds(8),
+                OnlyBetweenDifferentShows: true,
+                MinInterval: TimeSpan.Zero,
+                Mode: BumperMode.Static,
+                JinglePool: [j0, j1]
+            ),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        var bumpers = result.Entries.Where(e => e.Kind == ScheduleEntryKind.Bumper).ToList();
+        Assert.Equal(2, bumpers.Count);
+        Assert.Equal([j0, j1], bumpers.Select(e => e.MediaAssetId)); // ротация пула
+        Assert.All(bumpers, e => Assert.Null(e.FromShowId)); // статик — не по паре шоу
+        Assert.Equal(2, result.NextJingleIndex);
+    }
+
+    [Fact]
+    public void Bumpers_StaticMode_EmptyPool_NoBumpers()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20));
+
+        var input = BaseInput([a, b], durations, Start.AddMinutes(50)) with
+        {
+            Bumpers = new PlannerBumperConfig(
+                true,
+                TimeSpan.FromSeconds(8),
+                OnlyBetweenDifferentShows: true,
+                MinInterval: TimeSpan.Zero,
+                Mode: BumperMode.Static,
+                JinglePool: []
+            ),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        Assert.DoesNotContain(result.Entries, e => e.Kind == ScheduleEntryKind.Bumper);
+    }
+
+    [Fact]
+    public void Bumpers_BothMode_AlternatesDynamicAndStatic()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var j0 = Guid.NewGuid();
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20), (j0, 1));
+
+        // Три перехода: динамика, джингл, динамика.
+        var input = BaseInput([a, b], durations, Start.AddMinutes(80)) with
+        {
+            Bumpers = new PlannerBumperConfig(
+                true,
+                TimeSpan.FromSeconds(8),
+                OnlyBetweenDifferentShows: true,
+                MinInterval: TimeSpan.Zero,
+                Mode: BumperMode.Both,
+                JinglePool: [j0]
+            ),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        var bumpers = result.Entries.Where(e => e.Kind == ScheduleEntryKind.Bumper).ToList();
+        Assert.True(bumpers.Count >= 2);
+        Assert.Equal(Guid.Empty, bumpers[0].MediaAssetId); // первый — динамический (плейсхолдер)
+        Assert.Equal(j0, bumpers[1].MediaAssetId); // второй — статичный джингл
+    }
+
+    [Fact]
+    public void Bumpers_Disabled_ProduceNoBumperEntries()
+    {
+        var a = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var b = new PlannerShow(Guid.NewGuid(), Guid.NewGuid(), 1, BlockMode.Count, 1, [Guid.NewGuid()], 0);
+        var durations = Durations((a.EpisodeAssetIds[0], 20), (b.EpisodeAssetIds[0], 20));
+
+        var input = BaseInput([a, b], durations, Start.AddMinutes(50)) with
+        {
+            Bumpers = new PlannerBumperConfig(false, TimeSpan.FromSeconds(8), OnlyBetweenDifferentShows: true, MinInterval: TimeSpan.Zero),
+        };
+
+        var result = SchedulePlanner.Plan(input, new FixedRandom(0, 1));
+
+        Assert.DoesNotContain(result.Entries, e => e.Kind == ScheduleEntryKind.Bumper);
+    }
+
    [Fact]
    public void NoPlayableShows_ReturnsEmpty()
    {