Refactor BumperPlaceholders and BumperFacts for improved logic and readability
ci / build-backend (push) Successful in 2m15s
ci / build-frontend (push) Successful in 1m7s
ci / tests (push) Successful in 2m33s
ci / sonar (push) Successful in 10m26s

Updated the BumperPlaceholders class to streamline token extraction from texts, enhancing performance and clarity. Modified BumperFacts to initialize slot titles with an empty array instead of a dictionary for better consistency. Renamed methods in BumperResolver for clarity, and refactored GridScheduleGenerator to simplify return logic. Additionally, improved the BumperLinesEditor component by implementing a keyed list for better state management and user experience.
This commit is contained in:
Leonid Pershin
2026-07-27 23:04:15 +03:00
parent 3d2ae20368
commit 1afe01aed8
12 changed files with 159 additions and 113 deletions
@@ -95,11 +95,12 @@ public static partial class BumperPlaceholders
/// <summary>Какие плейсхолдеры встречаются в текстах — по ним планировщик решает, что грузить.</summary>
public static IReadOnlySet<string> TokensIn(IEnumerable<string> texts)
{
var used = new HashSet<string>(StringComparer.Ordinal);
foreach (var text in texts.Where(t => !string.IsNullOrWhiteSpace(t)))
foreach (Match match in TokenPattern().Matches(text))
used.Add(match.Groups[1].Value);
return used;
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>
@@ -59,7 +59,7 @@ internal sealed class BumperFacts
var slotTitles = tokens.Contains("slot")
? await LoadSlotTitlesAsync(dbContext, items, cancellationToken)
: new Dictionary<Guid, string>();
: [];
return new BumperFacts(items, channel, shows, slotTitles);
}
@@ -100,7 +100,7 @@ public sealed class BumperResolver(
variant.Id,
linesJson,
posterShowId,
Signature(template, variant.Id, linesJson, posterShowId)
ComputeSignature(template, variant.Id, linesJson, posterShowId)
)
)
);
@@ -210,7 +210,7 @@ public sealed class BumperResolver(
/// и пары шоу в ней нет намеренно: одинаковая заставка на трёх каналах рендерится один раз, а
/// <c>{channel}</c> в тексте разводит их сам собой.
/// </summary>
private static string Signature(
private static string ComputeSignature(
BumperTemplate template,
Guid variantId,
string linesJson,
@@ -447,13 +447,13 @@ public sealed class GridScheduleGenerator(
);
}
return elements.Count == 0
? null
: new PlanningJunction(
id,
elements,
template.MaxTotalSeconds is { } seconds ? TimeSpan.FromSeconds(seconds) : null
);
if (elements.Count == 0)
return null;
var cap = template.MaxTotalSeconds is { } seconds
? TimeSpan.FromSeconds(seconds)
: (TimeSpan?)null;
return new PlanningJunction(id, elements, cap);
}
/// <summary>
@@ -360,9 +360,28 @@ public sealed class GridPlanner(
PlanRun Run
)
{
/// <summary>
/// Длина слота и число единиц в нём. Блок из N единиц занимает ровно столько, сколько эти
/// единицы идут, — округление до пяти минут; хвост короче минимального слота приклеивается
/// к текущему, чтобы в сетке не появлялось огрызков.
/// </summary>
private (int Duration, int Units) Measure(GroupCandidate group, int available)
{
var unit = UnitMinutes(group);
// Полоса, которая меряется временем (марафон, ночь), берёт свой кусок целиком.
if (Band.UnitsPerBlock <= 0 || unit == 0)
return (Fit(Band.BlockMinutes > 0 ? Band.BlockMinutes : available, available), 0);
var duration = Fit(Math.Max(1, Band.UnitsPerBlock) * unit, available);
// Число единиц — по фактической длине слота: полоса задаёт замысел, а сколько влезло,
// решает контент.
return (duration, Math.Max(1, (int)Math.Round(duration / (double)unit)));
}
public PlannedSlot Content(GroupCandidate group, int available)
{
var (duration, units) = Measure(Band, group, available);
var (duration, units) = Measure(group, available);
Run.Reserve(group, units, duration, Target.AiringsPerWeek);
return Build(
@@ -442,29 +461,6 @@ public sealed class GridPlanner(
private static int RepeatMinutes(GridBand band) =>
band.BlockMinutes > 0 ? band.BlockMinutes : 120;
/// <summary>
/// Длина слота и число единиц в нём. Блок из N единиц занимает ровно столько, сколько эти
/// единицы идут, — округление до пяти минут; хвост короче минимального слота приклеивается
/// к текущему, чтобы в сетке не появлялось огрызков.
/// </summary>
private static (int Duration, int Units) Measure(
GridBand band,
GroupCandidate group,
int available
)
{
var unit = UnitMinutes(group);
// Полоса, которая меряется временем (марафон, ночь), берёт свой кусок целиком.
if (band.UnitsPerBlock <= 0 || unit == 0)
return (Fit(band.BlockMinutes > 0 ? band.BlockMinutes : available, available), 0);
var duration = Fit(Math.Max(1, band.UnitsPerBlock) * unit, available);
// Число единиц — по фактической длине слота: полоса задаёт замысел, а сколько влезло,
// решает контент.
return (duration, Math.Max(1, (int)Math.Round(duration / (double)unit)));
}
/// <summary>
/// Длина слота: желаемая, но не больше свободного места. Остаток короче минимального слота
/// приклеивается к текущему — огрызок в сетке читается как ошибка, а не как решение. Остаток
@@ -63,6 +63,18 @@ public sealed record JunctionInsert(
TimeSpan Duration
);
/// <summary>
/// Накопители прогона, нужные раскладке стыка: история врезок (интервалы и ротация единиц),
/// жребий и сама собираемая лента. Принадлежат прогону целиком, а не отдельному стыку, поэтому
/// едут одним параметром — плоским списком сигнатура <see cref="JunctionFiller.Fill"/> перестаёт
/// читаться.
/// </summary>
public sealed record JunctionRun(
JunctionHistory History,
IRandomSource Random,
List<PlannedItem> Items
);
/// <summary>
/// Раскладка врезок стыка: реклама, промо, заставка, заполнитель.
///
@@ -80,15 +92,15 @@ public static class JunctionFiller
DateTimeOffset cursor,
DateTimeOffset limit,
JunctionPlacement placement,
JunctionHistory history,
IRandomSource random,
List<PlannedItem> items,
JunctionRun run,
PlanTrace? trace
)
{
if (junction is null || junction.Elements.Count == 0)
return cursor;
var (history, random, items) = run;
var eligible = junction
.Elements.Where(e => Passes(e, cursor, placement, history, random))
.ToList();
@@ -31,6 +31,11 @@ public static class SchedulePlanner
public List<PlanningWarning> Warnings { get; } = [];
public JunctionHistory Junctions { get; } = new();
private JunctionRun? _junctionRun;
/// <summary>Накопители, которые нужны раскладке стыка: история, жребий и сама лента.</summary>
public JunctionRun JunctionRun => _junctionRun ??= new(Junctions, Random, Items);
/// <summary>Смещение времени канала — врезки со своим окном суток считают его по нему.</summary>
public TimeSpan ChannelOffset { get; } = TimeSpan.FromMinutes(input.UtcOffsetMinutes);
@@ -260,9 +265,7 @@ public static class SchedulePlanner
ElementChanged: run.PreviousShowId != unit.ShowId,
run.ChannelOffset
),
run.Junctions,
run.Random,
run.Items,
run.JunctionRun,
slotTrace
);
@@ -294,9 +297,7 @@ public static class SchedulePlanner
ElementChanged: true,
run.ChannelOffset
),
run.Junctions,
run.Random,
run.Items,
run.JunctionRun,
slotTrace
);
@@ -152,7 +152,7 @@ public sealed class FileSystemStorageInspector(
return new StorageAreaUsage(StorageArea.Other, measurement.Bytes, measurement.Files);
}
private StorageAreaUsage Area(
private static StorageAreaUsage Area(
StorageArea area,
string directory,
CancellationToken cancellationToken
@@ -171,7 +171,7 @@ public class BumperPreviewTests
.Handle(new RenderBumperPreviewCommand(template.Id, null), CancellationToken.None);
Assert.True(result.IsSuccess);
var spec = Specs(renderer).First();
var spec = Specs(renderer)[0];
Assert.Equal("/data/images/bg.png", spec.BackgroundFile);
// Канала нет — образцы заглушечные, но кадр всё равно собирается.
Assert.Equal("Первое шоу", spec.Lines[1].Text);
@@ -201,7 +201,7 @@ public class BumperPreviewTests
.Handle(new RenderBumperPreviewCommand(template.Id, null), CancellationToken.None);
// Жанра у образца нет — строка схлопнулась, а не оставила дыру в кадре.
var spec = Specs(renderer).First();
var spec = Specs(renderer)[0];
Assert.Single(spec.Lines);
}
}