Add reset template functionality to channel management
ci / build-backend (push) Successful in 1m35s
ci / build-frontend (push) Successful in 53s
ci / tests (push) Successful in 1m36s
ci / sonar (push) Successful in 4m21s

Implemented a new endpoint for resetting the channel template, which clears the grid and removes future scheduled entries while preserving past and current recordings. Updated the frontend to include a reset button in the channel management interface, along with corresponding localization strings in English and Russian. Enhanced integration tests to verify the reset functionality, ensuring that the expected number of slots, layers, and entries are accurately reported after the reset operation.
This commit is contained in:
Leonid Pershin
2026-07-28 14:19:35 +03:00
parent 3908b6e722
commit 6c85db2d60
10 changed files with 268 additions and 1 deletions
@@ -11,6 +11,7 @@ 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;
@@ -50,6 +51,10 @@ public static class TemplateEndpoints
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)
@@ -165,6 +170,16 @@ public static class TemplateEndpoints
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,
@@ -0,0 +1,17 @@
using LiteCqrs;
using TeleWave.Application.Common.Models;
namespace TeleWave.Application.Programming.Templates.Reset;
/// <summary>
/// Полный сброс сетки канала и собранного по ней эфира: слоты и слои снимаются, будущий хвост
/// ленты удаляется. Настройки шаблона (аварийная группа, стык по умолчанию, правила) остаются —
/// они переживают перекройку сетки, и терять их вместе со слотами админ не просит.
/// </summary>
public sealed record ResetTemplateCommand(Guid ChannelId)
: ICommand<Result<ResetTemplateResultDto>>;
/// <param name="Slots">Сколько слотов снято.</param>
/// <param name="Layers">Сколько слоёв удалено — фоновый в счёт не идёт, он остаётся всегда.</param>
/// <param name="Entries">Сколько будущих записей эфира удалено.</param>
public sealed record ResetTemplateResultDto(int Slots, int Layers, int Entries);
@@ -0,0 +1,74 @@
using LiteCqrs;
using Microsoft.EntityFrameworkCore;
using TeleWave.Application.Broadcast;
using TeleWave.Application.Common.Interfaces;
using TeleWave.Application.Common.Models;
namespace TeleWave.Application.Programming.Templates.Reset;
/// <summary>
/// Сброс сетки и собранного по ней эфира — «начать канал заново», не пересоздавая его.
///
/// Прошлое и идущая сейчас запись не трогаются: инвариант общий с генератором — у зрителя нельзя
/// вырезать программу из-под носа, а история показов нужна остыванию и потолку повторов.
/// Курсоры слотов уходят каскадом вместе со слотами, поэтому сериалы после сброса начинаются
/// с начала — это и просят словом «полностью».
///
/// Снимок последнего применения остаётся: он единственная точка отката, и после сброса «Откатить»
/// вернёт сетку. Ленту это не вернёт — её пересоберёт применение.
/// </summary>
public sealed class ResetTemplateCommandHandler(IAppDbContext dbContext)
: ICommandHandler<ResetTemplateCommand, Result<ResetTemplateResultDto>>
{
public async Task<Result<ResetTemplateResultDto>> Handle(
ResetTemplateCommand command,
CancellationToken cancellationToken
)
{
var template = await dbContext
.ScheduleTemplates.Include(t => t.Layers)
.ThenInclude(l => l.Slots)
.AsSplitQuery()
.FirstOrDefaultAsync(t => t.ChannelId == command.ChannelId, cancellationToken);
if (template is null)
return Result.Failure<ResetTemplateResultDto>(ChannelErrors.TemplateNotFound);
var now = DateTimeOffset.UtcNow;
// Удаление ленты идёт мимо change-tracker (ExecuteDelete), снятие слотов — через него:
// связывает их в одну операцию только явная транзакция. Лок канала — тот же, что берёт
// генератор: фоновый тик не должен дописывать хвост в момент сброса.
await using var transaction = await dbContext.BeginTransactionAsync(cancellationToken);
await dbContext.AcquireChannelLockAsync(command.ChannelId, cancellationToken);
var entries = await dbContext
.ScheduleEntries.Where(e => e.ChannelId == command.ChannelId && e.StartsAtUtc >= now)
.ExecuteDeleteAsync(cancellationToken);
var slots = 0;
var layers = 0;
foreach (var layer in template.Layers.ToList())
{
slots += layer.Slots.Count;
// Нефоновый слой уходит целиком — слоты за ним каскадом. Фоновый удалить нельзя,
// поэтому его чистим послотно.
if (template.RemoveLayer(layer.Id))
{
layers++;
continue;
}
foreach (var slot in layer.Slots.ToList())
layer.RemoveSlot(slot.Id);
}
template.MarkChanged();
await dbContext.SaveChangesAsync(cancellationToken);
await transaction.CommitAsync(cancellationToken);
return Result.Success(new ResetTemplateResultDto(slots, layers, entries));
}
}
@@ -3,6 +3,7 @@ using TeleWave.Application.Programming.Groups;
using TeleWave.Application.Programming.Templates;
using TeleWave.Application.Programming.Templates.CopyTemplate;
using TeleWave.Application.Programming.Templates.CreateTemplate;
using TeleWave.Application.Programming.Templates.Reset;
using TeleWave.Application.Programming.Templates.Validate;
using TeleWave.Domain.Broadcast;
using TeleWave.Domain.Programming;
@@ -136,6 +137,84 @@ public sealed class TemplateOperationsIntegrationTests(PostgresFixture fixture)
Assert.Single(verify.GridLayers.Where(l => l.TemplateId == template.Id && l.IsBackground));
}
/// <summary>
/// Сброс: сетка снимается целиком, будущий эфир уходит, прошлое и идущая запись остаются.
/// Проверяется на настоящей БД — команда держит транзакцию с advisory-локом канала и сносит
/// ленту через ExecuteDelete, а этого InMemory не умеет.
/// </summary>
[SkippableFact]
public async Task Reset_ClearsGridAndFutureTape_KeepingPastAndCurrentEntry()
{
Skip.IfNot(fixture.Available, "Docker недоступен");
await using var seedDb = fixture.CreateContext();
var (channelId, _, _) = await SeedPairAsync(seedDb);
var now = DateTimeOffset.UtcNow;
var slotId = seedDb
.ScheduleTemplates.Include(t => t.Layers)
.ThenInclude(l => l.Slots)
.Single(t => t.ChannelId == channelId)
.Layers.SelectMany(l => l.Slots)
.Single()
.Id;
// Курсор слота: он обязан уйти вместе со слотом, иначе сериал продолжится с той же серии.
var state = SlotState.Create(slotId);
state.MoveTo(GroupElementKind.Show, Guid.NewGuid(), 3);
seedDb.SlotStates.Add(state);
Entry(seedDb, channelId, now.AddHours(-2), now.AddHours(-1));
Entry(seedDb, channelId, now.AddMinutes(-10), now.AddMinutes(20));
Entry(seedDb, channelId, now.AddHours(1), now.AddHours(2));
await seedDb.SaveChangesAsync();
await using var db = fixture.CreateContext();
var result = await new ResetTemplateCommandHandler(db).Handle(
new ResetTemplateCommand(channelId),
default
);
Assert.True(result.IsSuccess);
Assert.Equal(1, result.Value.Slots);
Assert.Equal(1, result.Value.Layers);
Assert.Equal(1, result.Value.Entries);
await using var verify = fixture.CreateContext();
var template = verify
.ScheduleTemplates.Include(t => t.Layers)
.ThenInclude(l => l.Slots)
.Single(t => t.ChannelId == channelId);
// Фоновый слой остаётся всегда — удалить его нельзя, и без него сетку нечем закрывать.
var layer = Assert.Single(template.Layers);
Assert.True(layer.IsBackground);
Assert.Empty(layer.Slots);
Assert.True(template.HasPendingChanges);
Assert.False(verify.SlotStates.Any(s => s.SlotId == slotId));
var entries = verify.ScheduleEntries.Where(e => e.ChannelId == channelId).ToList();
Assert.Equal(2, entries.Count);
Assert.All(entries, e => Assert.True(e.StartsAtUtc < now));
}
private static void Entry(
AppDbContext db,
Guid channelId,
DateTimeOffset from,
DateTimeOffset to
) =>
db.ScheduleEntries.Add(
ScheduleEntry.FromSlot(
channelId,
Guid.NewGuid(),
ScheduleEntryKind.Program,
from,
to,
new ScheduleEntryOrigin(null, null, null, null, null)
)
);
/// <summary>Два канала: у источника слой со слотом, группой и стыком; у приёмника — пустая сетка.</summary>
private static async Task<(Guid Source, Guid Target, Guid GroupId)> SeedPairAsync(
AppDbContext db