Add broadcast scheduling features: implement Show and Channel entities, enhance AppDbContext and DependencyInjection for broadcasting, and update API routing. Include migration for new database schema and update documentation for broadcast-related functionalities.

2026-07-24 08:57:08 +03:00
parent e15ecbdb29
commit 4fa9dae37f
86 changed files with 4094 additions and 15 deletions
@@ -0,0 +1,53 @@
+namespace TeleWave.Domain.Broadcast.Scheduling;
+
+/// <summary>Шоу канала, подготовленное для планировщика: только готовые серии, с курсором.</summary>
+public sealed record PlannerShow(
+    Guid ChannelShowId,
+    Guid ShowId,
+    int Weight,
+    BlockMode BlockMode,
+    int BlockValue,
+    IReadOnlyList<Guid> EpisodeAssetIds,
+    int NextEpisodeIndex
+);
+
+/// <summary>Override в терминах планировщика: окно + режим + шоу с весами.</summary>
+public sealed record PlannerOverride(
+    DateTimeOffset StartsAtUtc,
+    DateTimeOffset EndsAtUtc,
+    OverrideMode Mode,
+    IReadOnlyList<PlannerOverrideShow> Shows
+);
+
+public sealed record PlannerOverrideShow(Guid ShowId, int Weight);
+
+/// <summary>Полный вход планировщика для одного прогона по каналу.</summary>
+public sealed record PlannerInput(
+    Guid ChannelId,
+    AdInsertion AdInsertion,
+    int AdsPerBreak,
+    int NextAdIndex,
+    IReadOnlyList<PlannerShow> Shows,
+    IReadOnlyList<Guid> AdPool,
+    IReadOnlyDictionary<Guid, TimeSpan> Durations,
+    IReadOnlyList<PlannerOverride> Overrides,
+    DateTimeOffset StartTime,
+    DateTimeOffset HorizonEnd
+);
+
+/// <summary>Одна запланированная запись (ещё не доменная сущность).</summary>
+public sealed record PlannedEntry(
+    Guid MediaAssetId,
+    ScheduleEntryKind Kind,
+    DateTimeOffset StartsAtUtc,
+    DateTimeOffset EndsAtUtc,
+    Guid? ShowId,
+    int? EpisodeIndex
+);
+
+/// <summary>Результат прогона: новые записи + обновлённые курсоры (серий по каждому ChannelShow и рекламы).</summary>
+public sealed record PlannerResult(
+    IReadOnlyList<PlannedEntry> Entries,
+    IReadOnlyDictionary<Guid, int> NextEpisodeIndexByChannelShow,
+    int NextAdIndex
+);