Update configuration and enhance media processing: add stream token TTL and timeout settings in .env.example, improve error handling in media endpoints, and refactor command handlers for asynchronous operations. Update documentation to reflect current application state and features.

backend/src/TeleWave.Api/Endpoints/ChannelEndpoints.Bumpers.cs

@@ -98,7 +98,7 @@ public static partial class ChannelEndpoints
             cancellationToken
         );
         if (!result.IsSuccess)
-            storage.DeleteAudio(templateId);
+            await storage.DeleteAudioAsync(templateId, cancellationToken);
         return result.ToHttpResult();
     }
 
@@ -214,7 +214,7 @@ public static partial class ChannelEndpoints
     )
     {
         var result = await sender.Send(
-            new RenderBumperPreviewQuery(id, templateId),
+            new RenderBumperPreviewCommand(id, templateId),
             cancellationToken
         );
         return result.IsSuccess ? Results.NoContent() : result.ToHttpResult();

backend/src/TeleWave.Api/Endpoints/MediaEndpoints.cs

@@ -84,7 +84,7 @@ public static class MediaEndpoints
         );
         if (!result.IsSuccess)
         {
-            storage.DeleteUpload(token);
+            await storage.DeleteUploadAsync(token, cancellationToken);
             return result.ToHttpResult();
         }
 

backend/src/TeleWave.Api/Endpoints/StreamingEndpoints.cs

@@ -95,11 +95,18 @@ public static class StreamingEndpoints
         HttpRequest request,
         HttpResponse response,
         StreamTokenService tokens,
+        IIdentityService identity,
         ISender sender,
         CancellationToken cancellationToken
     )
     {
-        if (!tokens.Validate(request.Cookies[StreamCookieName]))
+        // Плейлист hls.js перезагружает регулярно — здесь дёшево (1 запрос на перезагрузку) сверить,
+        // что зритель из токена ещё существует и не заблокирован. Так блокировка отражается почти сразу,
+        // не дожидаясь истечения короткого TTL cookie; сегменты этой проверки не делают (слишком часто).
+        if (tokens.Validate(request.Cookies[StreamCookieName]) is not { } userId)
+            return Results.Unauthorized();
+        var profile = await identity.GetProfileAsync(userId, cancellationToken);
+        if (profile is null || profile.IsBlocked)
             return Results.Unauthorized();
 
         var result = await sender.Send(
@@ -124,7 +131,7 @@ public static class StreamingEndpoints
         MediaPathResolver paths
     )
     {
-        if (!tokens.Validate(request.Cookies[StreamCookieName]))
+        if (tokens.Validate(request.Cookies[StreamCookieName]) is null)
             return Results.Unauthorized();
         if (!SegmentFileName.IsMatch(file))
             return Results.NotFound();

backend/src/TeleWave.Api/Program.cs

@@ -110,8 +110,13 @@ app.UseRateLimiter();
 app.UseAuthentication();
 app.UseAuthorization();
 
-app.MapOpenApi();
-app.MapScalarApiReference();
+// Схему/UI API публикуем не в проде (или явным флагом Api:EnableOpenApi=true) — чтобы в продакшене
+// не раскрывать полную карту эндпоинтов без необходимости.
+if (app.Environment.IsDevelopment() || app.Configuration.GetValue("Api:EnableOpenApi", false))
+{
+    app.MapOpenApi();
+    app.MapScalarApiReference();
+}
 
 app.MapHealthChecks("/health");
 

backend/src/TeleWave.Api/appsettings.Development.json

@@ -5,6 +5,9 @@
       "Microsoft.AspNetCore": "Warning"
     }
   },
+  "Jwt": {
+    "SigningKey": "telewave-development-only-signing-key-not-for-production-0001"
+  },
   "AdminSeed": {
     "Username": "admin",
     "Password": "Passw0rd!Dev"

backend/src/TeleWave.Application/Broadcast/Bumpers/ClearBumperTemplateAudioCommandHandler.cs

@@ -26,7 +26,8 @@ public sealed class ClearBumperTemplateAudioCommandHandler(
             return Result.Failure(ChannelErrors.BumperTemplateNotFound);
 
         template.ClearAudio();
-        storage.DeleteAudio(command.TemplateId);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        await storage.DeleteAudioAsync(command.TemplateId, cancellationToken);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/RemoveBumperTemplateCommandHandler.cs

@@ -28,7 +28,8 @@ public sealed class RemoveBumperTemplateCommandHandler(
             return Result.Failure(ChannelErrors.CannotRemoveDefaultBumperTemplate);
 
         channel.RemoveBumperTemplate(command.TemplateId);
-        storage.DeleteTemplate(command.TemplateId);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        await storage.DeleteTemplateAsync(command.TemplateId, cancellationToken);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Broadcast/Bumpers/RenderBumperPreviewCommand.cs

@@ -5,6 +5,7 @@ namespace TeleWave.Application.Broadcast.Bumpers;
 
 /// <summary>
 /// Синхронно рендерит примеры всех подблоков блока (с примерными названиями шоу). Каждый подблок —
-/// в свой ассет-превью (id детерминирован по подблоку). БД не меняет — read-side генерация артефактов.
+/// в свой ассет-превью (id детерминирован по подблоку). БД не меняет, но пишет артефакты на диск —
+/// поэтому это команда (действие с побочным эффектом), а не запрос.
 /// </summary>
-public sealed record RenderBumperPreviewQuery(Guid ChannelId, Guid TemplateId) : IQuery<Result>;
+public sealed record RenderBumperPreviewCommand(Guid ChannelId, Guid TemplateId) : ICommand<Result>;

backend/src/TeleWave.Application/Broadcast/Bumpers/RenderBumperPreviewCommandHandler.cs

@@ -8,14 +8,14 @@ using TeleWave.Domain.Broadcast;
 
 namespace TeleWave.Application.Broadcast.Bumpers;
 
-public sealed class RenderBumperPreviewQueryHandler(
+public sealed class RenderBumperPreviewCommandHandler(
     IAppDbContext dbContext,
     IBumperRenderer renderer,
     IBumperTemplateStorage storage,
     IImageStore imageStore,
     IOptions<BumperOptions> bumperOptions,
     IOptions<StreamingOptions> streamingOptions
-) : IQueryHandler<RenderBumperPreviewQuery, Result>
+) : ICommandHandler<RenderBumperPreviewCommand, Result>
 {
     private readonly BumperOptions _bumper = bumperOptions.Value;
     private readonly int _segmentSeconds = Math.Max(1, streamingOptions.Value.SegmentSeconds);
@@ -24,7 +24,7 @@ public sealed class RenderBumperPreviewQueryHandler(
     private const int DefaultBumperDurationSeconds = 8;
 
     public async Task<Result> Handle(
-        RenderBumperPreviewQuery query,
+        RenderBumperPreviewCommand query,
         CancellationToken cancellationToken
     )
     {

backend/src/TeleWave.Application/Broadcast/Scheduling/ScheduleGenerator.cs

@@ -50,6 +50,12 @@ public sealed class ScheduleGenerator(
         if (channel is null || !channel.IsEnabled)
             return -1;
 
+        // Сериализуем генерацию одного канала: фоновый тик и ручная перегенерация не должны читать
+        // одну точку продолжения и оба дописывать хвост (иначе дубли/перекрытия записей). Advisory-lock
+        // держится до коммита/отката транзакции ниже; при сбое рендера заставок весь прогон откатится.
+        await using var transaction = await dbContext.BeginTransactionAsync(cancellationToken);
+        await dbContext.AcquireChannelLockAsync(channelId, cancellationToken);
+
         var horizonEnd = now.AddDays(_options.HorizonDays);
 
         // Чистим прошлое сверх окна ретеншна.
@@ -77,6 +83,7 @@ public sealed class ScheduleGenerator(
         if (startTime >= horizonEnd)
         {
             await dbContext.SaveChangesAsync(cancellationToken);
+            await transaction.CommitAsync(cancellationToken);
             return 0;
         }
 
@@ -130,6 +137,7 @@ public sealed class ScheduleGenerator(
         channel.SetNextBumperIndex(result.NextBumperIndex);
 
         await dbContext.SaveChangesAsync(cancellationToken);
+        await transaction.CommitAsync(cancellationToken);
         return added;
     }
 

backend/src/TeleWave.Application/Common/Interfaces/IAppDbContext.cs

@@ -1,4 +1,5 @@
 using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Storage;
 using TeleWave.Domain.Auth;
 using TeleWave.Domain.Broadcast;
 using TeleWave.Domain.Images;
@@ -21,4 +22,13 @@ public interface IAppDbContext
     DbSet<Image> Images { get; }
 
     Task<int> SaveChangesAsync(CancellationToken cancellationToken);
+
+    /// <summary>Открывает явную транзакцию БД — для команд с несколькими операциями (в т.ч.
+    /// <c>ExecuteDelete</c> в обход change-tracker), которые должны быть атомарны.</summary>
+    Task<IDbContextTransaction> BeginTransactionAsync(CancellationToken cancellationToken);
+
+    /// <summary>Берёт транзакционную advisory-блокировку по каналу (снимается при коммите/откате).
+    /// Сериализует генерацию расписания одного канала между фоновым тиком и ручной перегенерацией.
+    /// Вызывать внутри открытой транзакции.</summary>
+    Task AcquireChannelLockAsync(Guid channelId, CancellationToken cancellationToken);
 }

backend/src/TeleWave.Application/Common/Interfaces/IBumperTemplateStorage.cs

@@ -13,10 +13,10 @@ public interface IBumperTemplateStorage
         CancellationToken cancellationToken
     );
 
-    void DeleteAudio(Guid templateId);
+    Task DeleteAudioAsync(Guid templateId, CancellationToken cancellationToken);
 
     /// <summary>Удалить все файлы блока (при удалении самого блока).</summary>
-    void DeleteTemplate(Guid templateId);
+    Task DeleteTemplateAsync(Guid templateId, CancellationToken cancellationToken);
 
     /// <summary>Абсолютный путь к загруженному звуку или null (нет расширения / файл отсутствует).</summary>
     string? AudioPath(Guid templateId, string? extension);

backend/src/TeleWave.Application/Common/Interfaces/IImageStore.cs

@@ -21,7 +21,7 @@ public interface IImageStore
         CancellationToken cancellationToken
     );
 
-    void Delete(Guid imageId, string extension);
+    Task DeleteAsync(Guid imageId, string extension, CancellationToken cancellationToken);
 
     /// <summary>Абсолютный путь к файлу изображения или null, если файла нет.</summary>
     string? ResolvePath(Guid imageId, string extension);

backend/src/TeleWave.Application/Common/Interfaces/IMediaStorage.cs

@@ -22,7 +22,7 @@ public interface IMediaStorage
     );
 
     /// <summary>Удаляет временный файл загрузки (откат при ошибке до регистрации ассета).</summary>
-    void DeleteUpload(string uploadToken);
+    Task DeleteUploadAsync(string uploadToken, CancellationToken cancellationToken);
 
     /// <summary>
     /// Переносит исходник из источника (<c>uploads/</c> для <see cref="MediaSource.Upload"/> либо
@@ -37,5 +37,5 @@ public interface IMediaStorage
     );
 
     /// <summary>Удаляет все артефакты ассета: исходник в <c>originals/</c> и каталог сегментов <c>assets/{id}/</c>.</summary>
-    void DeleteAssetArtifacts(Guid assetId, string extension);
+    Task DeleteAssetArtifactsAsync(Guid assetId, string extension, CancellationToken cancellationToken);
 }

backend/src/TeleWave.Application/Images/DeleteImage/DeleteImageCommandHandler.cs

@@ -20,8 +20,13 @@ public sealed class DeleteImageCommandHandler(IAppDbContext dbContext, IImageSto
         if (image is null)
             return Result.Failure(ImageErrors.NotFound);
 
-        storage.Delete(image.Id, image.FileExtension);
+        // Сначала коммитим удаление в БД, затем файл (best-effort): orphan-файл безопаснее строки БД,
+        // ссылающейся на уже удалённую картинку.
+        var imageId = image.Id;
+        var extension = image.FileExtension;
         dbContext.Images.Remove(image);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        await storage.DeleteAsync(imageId, extension, cancellationToken);
         return Result.Success();
     }
 }

backend/src/TeleWave.Application/Maintenance/ClearAllMedia/ClearAllMediaCommandHandler.cs

@@ -17,12 +17,20 @@ public sealed class ClearAllMediaCommandHandler(IAppDbContext dbContext, IMediaS
             .MediaAssets.Select(a => new { a.Id, a.OriginalExtension })
             .ToListAsync(cancellationToken);
 
-        foreach (var asset in assets)
-            storage.DeleteAssetArtifacts(asset.Id, asset.OriginalExtension);
-
+        // Оба ExecuteDelete должны быть атомарны; файлы удаляем только после успешного коммита БД
+        // (best-effort) — иначе при падении между ними расписание/ассеты рассинхронизируются с ФС.
+        await using var transaction = await dbContext.BeginTransactionAsync(cancellationToken);
         // Расписание ссылается на удаляемые ассеты — чистим его тоже.
         await dbContext.ScheduleEntries.ExecuteDeleteAsync(cancellationToken);
         var deleted = await dbContext.MediaAssets.ExecuteDeleteAsync(cancellationToken);
+        await transaction.CommitAsync(cancellationToken);
+
+        foreach (var asset in assets)
+            await storage.DeleteAssetArtifactsAsync(
+                asset.Id,
+                asset.OriginalExtension,
+                cancellationToken
+            );
 
         return Result.Success(deleted);
     }

backend/src/TeleWave.Application/Maintenance/DeleteShowMedia/DeleteShowMediaCommandHandler.cs

@@ -28,9 +28,10 @@ public sealed class DeleteShowMediaCommandHandler(IAppDbContext dbContext, IMedi
             .Select(a => new { a.Id, a.OriginalExtension })
             .ToListAsync(cancellationToken);
 
-        foreach (var asset in assets)
-            storage.DeleteAssetArtifacts(asset.Id, asset.OriginalExtension);
-
+        // Все три операции БД (удаление записей расписания, ассетов, отвязка серий) — атомарно в одной
+        // транзакции; файлы удаляем только после успешного коммита (best-effort), чтобы при падении не
+        // остаться с сериями, указывающими на уже удалённые с диска ассеты.
+        await using var transaction = await dbContext.BeginTransactionAsync(cancellationToken);
         await dbContext
             .ScheduleEntries.Where(e => assetIds.Contains(e.MediaAssetId))
             .ExecuteDeleteAsync(cancellationToken);
@@ -38,9 +39,18 @@ public sealed class DeleteShowMediaCommandHandler(IAppDbContext dbContext, IMedi
             .MediaAssets.Where(a => assetIds.Contains(a.Id))
             .ExecuteDeleteAsync(cancellationToken);
 
-        // Серии шоу теперь указывают на удалённые ассеты — убираем их (сохранится через UnitOfWork).
+        // Серии шоу теперь указывают на удалённые ассеты — убираем их.
         foreach (var episode in episodes)
             show.RemoveEpisode(episode.Id);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        await transaction.CommitAsync(cancellationToken);
+
+        foreach (var asset in assets)
+            await storage.DeleteAssetArtifactsAsync(
+                asset.Id,
+                asset.OriginalExtension,
+                cancellationToken
+            );
 
         return Result.Success(assets.Count);
     }

backend/src/TeleWave.Application/Media/Delete/DeleteMediaAssetCommandHandler.cs

@@ -21,8 +21,13 @@ public sealed class DeleteMediaAssetCommandHandler(IAppDbContext dbContext, IMed
             return Result.Failure(MediaErrors.NotFound);
 
         // TODO(этап 2): запретить удаление, пока ассет используется в расписании/пуле канала.
-        storage.DeleteAssetArtifacts(asset.Id, asset.OriginalExtension);
+        // Сначала коммитим удаление в БД, потом чистим файлы (best-effort): orphan-файл на диске
+        // безопаснее, чем строка БД, ссылающаяся на уже удалённые артефакты.
+        var extension = asset.OriginalExtension;
+        var assetId = asset.Id;
         dbContext.MediaAssets.Remove(asset);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        await storage.DeleteAssetArtifactsAsync(assetId, extension, cancellationToken);
 
         return Result.Success();
     }

backend/src/TeleWave.Application/Media/Register/RegisterMediaAssetCommandHandler.cs

@@ -27,15 +27,28 @@ public sealed class RegisterMediaAssetCommandHandler(IAppDbContext dbContext, IM
         var extension = Path.GetExtension(command.OriginalFileName).ToLowerInvariant();
         var asset = MediaAsset.Register(command.OriginalFileName, extension, command.Source);
 
-        await storage.PromoteToOriginalAsync(
-            command.Source,
-            command.SourceToken,
-            asset.Id,
-            extension,
-            cancellationToken
-        );
-
+        // Сначала фиксируем ассет в БД, затем переносим файл в originals/. Если перенос не удался —
+        // откатываем регистрацию, чтобы не оставить orphan (либо есть и строка БД, и файл, либо нет ни
+        // того, ни другого). Обратный порядок оставлял бы перемещённый файл без строки БД при сбое save.
         dbContext.MediaAssets.Add(asset);
+        await dbContext.SaveChangesAsync(cancellationToken);
+        try
+        {
+            await storage.PromoteToOriginalAsync(
+                command.Source,
+                command.SourceToken,
+                asset.Id,
+                extension,
+                cancellationToken
+            );
+        }
+        catch
+        {
+            dbContext.MediaAssets.Remove(asset);
+            await dbContext.SaveChangesAsync(cancellationToken);
+            throw;
+        }
+
         return Result.Success(asset.Id);
     }
 }

backend/src/TeleWave.Application/Streaming/StreamingOptions.cs

@@ -9,4 +9,9 @@ public sealed class StreamingOptions
 
     /// <summary>Сколько сегментов держать в скользящем окне live-плейлиста.</summary>
     public int LiveWindowSegments { get; init; } = 10;
+
+    /// <summary>TTL stream-токена (cookie tw_stream), минуты. Короткий срок ограничивает окно доступа
+    /// после блокировки/логаута; фронт перевыпускает cookie через /watch, пока идёт просмотр. Блокировка
+    /// пользователя при этом отражается почти сразу — при очередной перезагрузке live-плейлиста.</summary>
+    public int StreamTokenMinutes { get; init; } = 30;
 }

backend/src/TeleWave.Domain/Library/Show.cs

@@ -69,9 +69,16 @@ public class Show
     private static string? Normalize(string? value) =>
         string.IsNullOrWhiteSpace(value) ? null : value.Trim();
 
-    /// <summary>Добавляет серию в конец. Для <see cref="ShowKind.Single"/> допустима ровно одна серия.</summary>
+    /// <summary>Добавляет серию в конец. Для <see cref="ShowKind.Single"/> допустима ровно одна серия
+    /// (инвариант защищён самим агрегатом; вызывающий обычно проверяет <see cref="CanAddEpisode"/> заранее
+    /// и возвращает управляемую ошибку — исключение здесь лишь страховка от обхода).</summary>
     public ShowEpisode AddEpisode(Guid mediaAssetId)
     {
+        if (!CanAddEpisode)
+            throw new InvalidOperationException(
+                "Полнометражка (ShowKind.Single) может содержать только одну серию."
+            );
+
         var nextPosition = _episodes.Count == 0 ? 0 : _episodes.Max(e => e.Position) + 1;
         var episode = ShowEpisode.Create(Id, mediaAssetId, nextPosition);
         _episodes.Add(episode);

backend/src/TeleWave.Infrastructure/Media/BumperTemplateStorage.cs

@@ -17,15 +17,23 @@ public sealed class BumperTemplateStorage(MediaPathResolver paths) : IBumperTemp
         CancellationToken cancellationToken
     ) => SaveAsync(templateId, Audio, extension, content, cancellationToken);
 
-    public void DeleteAudio(Guid templateId) => DeleteKind(templateId, Audio);
-
-    public void DeleteTemplate(Guid templateId)
+    public Task DeleteAudioAsync(Guid templateId, CancellationToken cancellationToken)
     {
-        var dir = paths.BumperTemplateDir(templateId);
-        if (Directory.Exists(dir))
-            Directory.Delete(dir, recursive: true);
+        DeleteKind(templateId, Audio);
+        return Task.CompletedTask;
     }
 
+    public Task DeleteTemplateAsync(Guid templateId, CancellationToken cancellationToken) =>
+        Task.Run(
+            () =>
+            {
+                var dir = paths.BumperTemplateDir(templateId);
+                if (Directory.Exists(dir))
+                    Directory.Delete(dir, recursive: true);
+            },
+            cancellationToken
+        );
+
     public string? AudioPath(Guid templateId, string? extension) =>
         ResolvePath(templateId, Audio, extension);
 

backend/src/TeleWave.Infrastructure/Media/FfmpegBumperRenderer.cs

@@ -82,6 +82,7 @@ public sealed class FfmpegBumperRenderer(
                 _media.FfmpegPath,
                 args,
                 lowPriority: true,
+                TimeSpan.FromSeconds(_media.TranscodeTimeoutSeconds),
                 cancellationToken
             );
             if (result.ExitCode != 0)

backend/src/TeleWave.Infrastructure/Media/FfmpegMediaProcessor.cs

@@ -49,6 +49,7 @@ public sealed class FfmpegMediaProcessor(
             _media.FfmpegPath,
             args,
             lowPriority: true,
+            TimeSpan.FromSeconds(_media.TranscodeTimeoutSeconds),
             cancellationToken
         );
         if (result.ExitCode != 0)
@@ -169,6 +170,7 @@ public sealed class FfmpegMediaProcessor(
             _media.FfprobePath,
             ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", path],
             lowPriority: false,
+            TimeSpan.FromSeconds(_media.ProbeTimeoutSeconds),
             cancellationToken
         );
         if (result.ExitCode != 0)

backend/src/TeleWave.Infrastructure/Media/FfprobeAudioProbe.cs

@@ -27,6 +27,7 @@ public sealed class FfprobeAudioProbe(IOptions<MediaOptions> mediaOptions) : IAu
                 _media.FfprobePath,
                 ["-v", "quiet", "-print_format", "json", "-show_format", absolutePath],
                 lowPriority: false,
+                TimeSpan.FromSeconds(_media.ProbeTimeoutSeconds),
                 cancellationToken
             );
             if (result.ExitCode != 0)

backend/src/TeleWave.Infrastructure/Media/FileSystemMediaStorage.cs

@@ -43,11 +43,12 @@ public sealed class FileSystemMediaStorage(MediaPathResolver paths) : IMediaStor
         return token;
     }
 
-    public void DeleteUpload(string uploadToken)
+    public Task DeleteUploadAsync(string uploadToken, CancellationToken cancellationToken)
     {
         var path = paths.UploadPath(uploadToken);
         if (File.Exists(path))
             File.Delete(path);
+        return Task.CompletedTask;
     }
 
     public Task PromoteToOriginalAsync(
@@ -72,14 +73,24 @@ public sealed class FileSystemMediaStorage(MediaPathResolver paths) : IMediaStor
         return Task.CompletedTask;
     }
 
-    public void DeleteAssetArtifacts(Guid assetId, string extension)
-    {
-        var original = paths.OriginalPath(assetId, extension);
-        if (File.Exists(original))
-            File.Delete(original);
+    public Task DeleteAssetArtifactsAsync(
+        Guid assetId,
+        string extension,
+        CancellationToken cancellationToken
+    ) =>
+        // Каталог сегментов удаляется рекурсивно (может быть много .ts) — офлоадим с вызывающего потока
+        // (запрос/фоновый сервис), чтобы не блокировать его на время файлового I/O.
+        Task.Run(
+            () =>
+            {
+                var original = paths.OriginalPath(assetId, extension);
+                if (File.Exists(original))
+                    File.Delete(original);
 
-        var assetDir = paths.AssetDir(assetId);
-        if (Directory.Exists(assetDir))
-            Directory.Delete(assetDir, recursive: true);
-    }
+                var assetDir = paths.AssetDir(assetId);
+                if (Directory.Exists(assetDir))
+                    Directory.Delete(assetDir, recursive: true);
+            },
+            cancellationToken
+        );
 }

backend/src/TeleWave.Infrastructure/Media/ImageStore.cs

@@ -30,11 +30,12 @@ public sealed class ImageStore(MediaPathResolver paths) : IImageStore
         await File.WriteAllBytesAsync(path, content, cancellationToken);
     }
 
-    public void Delete(Guid imageId, string extension)
+    public Task DeleteAsync(Guid imageId, string extension, CancellationToken cancellationToken)
     {
         var path = paths.ImagePath(imageId, Normalize(extension));
         if (File.Exists(path))
             File.Delete(path);
+        return Task.CompletedTask;
     }
 
     public string? ResolvePath(Guid imageId, string extension)

backend/src/TeleWave.Infrastructure/Media/MediaOptions.cs

@@ -28,4 +28,12 @@ public sealed class MediaOptions
 
     /// <summary>Целевая интегральная громкость, LUFS (−16 — типично для стриминга; тише — уменьшить).</summary>
     public int LoudnessTargetLufs { get; init; } = -16;
+
+    /// <summary>Таймаут одного вызова ffprobe, секунды (0 — без таймаута). Пробирование метаданных —
+    /// быстрая операция; страхует от подвисшего ffprobe на битом/сетевом источнике.</summary>
+    public int ProbeTimeoutSeconds { get; init; } = 120;
+
+    /// <summary>Таймаут одного вызова ffmpeg (транскод/рендер заставки), секунды (0 — без таймаута).
+    /// Не даёт зависшему процессу вечно держать слот параллелизма. Поднять для очень длинных файлов.</summary>
+    public int TranscodeTimeoutSeconds { get; init; } = 1800;
 }

backend/src/TeleWave.Infrastructure/Media/ProcessRunner.cs

@@ -13,6 +13,7 @@ internal static class ProcessRunner
         string fileName,
         IEnumerable<string> arguments,
         bool lowPriority,
+        TimeSpan timeout,
         CancellationToken cancellationToken
     )
     {
@@ -58,13 +59,30 @@ internal static class ProcessRunner
             }
         }
 
+        // Таймаут (если задан) — отдельный источник отмены, слитый с внешним: зависший ffmpeg/ffprobe
+        // (битый источник, -stream_loop и т.п.) не должен держать слот параллелизма/тик планировщика вечно.
+        using var timeoutCts =
+            timeout > TimeSpan.Zero ? new CancellationTokenSource(timeout) : null;
+        using var linked =
+            timeoutCts is null
+                ? null
+                : CancellationTokenSource.CreateLinkedTokenSource(
+                    cancellationToken,
+                    timeoutCts.Token
+                );
+        var waitToken = linked?.Token ?? cancellationToken;
+
         try
         {
-            await process.WaitForExitAsync(cancellationToken);
+            await process.WaitForExitAsync(waitToken);
         }
         catch (OperationCanceledException)
         {
             TryKill(process);
+            if (timeoutCts is { IsCancellationRequested: true } && !cancellationToken.IsCancellationRequested)
+                throw new TimeoutException(
+                    $"Процесс {fileName} превысил таймаут {timeout.TotalSeconds:0}с и был прерван."
+                );
             throw;
         }
 

backend/src/TeleWave.Infrastructure/Persistence/AppDbContext.cs

@@ -1,6 +1,7 @@
 using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage;
 using TeleWave.Application.Common.Interfaces;
 using TeleWave.Domain.Auth;
 using TeleWave.Domain.Broadcast;
@@ -30,6 +31,21 @@ public class AppDbContext(DbContextOptions<AppDbContext> options)
     public DbSet<AppSetting> AppSettings => Set<AppSetting>();
     public DbSet<Image> Images => Set<Image>();
 
+    public Task<IDbContextTransaction> BeginTransactionAsync(CancellationToken cancellationToken) =>
+        Database.BeginTransactionAsync(cancellationToken);
+
+    public Task AcquireChannelLockAsync(Guid channelId, CancellationToken cancellationToken)
+    {
+        // pg_advisory_xact_lock(bigint) освобождается автоматически при завершении транзакции.
+        // Ключ — стабильный int64 из GUID канала; коллизии между каналами лишь сериализуют их генерацию,
+        // корректности не нарушают.
+        var key = BitConverter.ToInt64(channelId.ToByteArray());
+        return Database.ExecuteSqlAsync(
+            $"SELECT pg_advisory_xact_lock({key})",
+            cancellationToken
+        );
+    }
+
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
         base.OnModelCreating(modelBuilder);

backend/src/TeleWave.Infrastructure/Streaming/StreamTokenService.cs

@@ -1,6 +1,7 @@
 using System.Security.Cryptography;
 using System.Text;
 using Microsoft.Extensions.Options;
+using TeleWave.Application.Streaming;
 using TeleWave.Infrastructure.Identity;
 
 namespace TeleWave.Infrastructure.Streaming;
@@ -8,29 +9,37 @@ namespace TeleWave.Infrastructure.Streaming;
 /// <summary>
 /// Короткоживущий подписанный токен для cookie <c>tw_stream</c>: выдаётся авторизованному зрителю,
 /// проверяется на запросах плейлиста и сегментов (работает и с нативным HLS, где заголовок не
-/// поставить). Подпись — HMAC-SHA256 на том же ключе, что и JWT.
+/// поставить). Подпись — HMAC-SHA256 на том же ключе, что и JWT. TTL короткий (см.
+/// <see cref="StreamingOptions.StreamTokenMinutes"/>), а <see cref="Validate"/> возвращает id зрителя —
+/// эндпоинт плейлиста дополнительно сверяет, что пользователь не заблокирован.
 /// </summary>
-public sealed class StreamTokenService(IOptions<JwtOptions> jwtOptions)
+public sealed class StreamTokenService(
+    IOptions<JwtOptions> jwtOptions,
+    IOptions<StreamingOptions> streamingOptions
+)
 {
-    private static readonly TimeSpan Ttl = TimeSpan.FromHours(6);
+    private readonly TimeSpan _ttl = TimeSpan.FromMinutes(
+        Math.Max(1, streamingOptions.Value.StreamTokenMinutes)
+    );
     private readonly byte[] _key = Encoding.UTF8.GetBytes(jwtOptions.Value.SigningKey);
 
     public (string Token, DateTimeOffset ExpiresAt) Issue(Guid userId)
     {
-        var expiresAt = DateTimeOffset.UtcNow.Add(Ttl);
+        var expiresAt = DateTimeOffset.UtcNow.Add(_ttl);
         var payload = $"{userId:N}.{expiresAt.ToUnixTimeSeconds()}";
         var token = $"{Base64Url(Encoding.UTF8.GetBytes(payload))}.{Base64Url(Sign(payload))}";
         return (token, expiresAt);
     }
 
-    public bool Validate(string? token)
+    /// <summary>Проверяет подпись и срок; при успехе возвращает id зрителя из токена, иначе null.</summary>
+    public Guid? Validate(string? token)
     {
         if (string.IsNullOrEmpty(token))
-            return false;
+            return null;
 
         var parts = token.Split('.');
         if (parts.Length != 2)
-            return false;
+            return null;
 
         byte[] payloadBytes;
         byte[] signature;
@@ -41,19 +50,22 @@ public sealed class StreamTokenService(IOptions<JwtOptions> jwtOptions)
         }
         catch (FormatException)
         {
-            return false;
+            return null;
         }
 
         var payload = Encoding.UTF8.GetString(payloadBytes);
         var expected = Sign(payload);
         if (!CryptographicOperations.FixedTimeEquals(signature, expected))
-            return false;
+            return null;
 
         var dot = payload.LastIndexOf('.');
         if (dot < 0 || !long.TryParse(payload.AsSpan(dot + 1), out var expiresUnix))
-            return false;
+            return null;
 
-        return DateTimeOffset.FromUnixTimeSeconds(expiresUnix) > DateTimeOffset.UtcNow;
+        if (DateTimeOffset.FromUnixTimeSeconds(expiresUnix) <= DateTimeOffset.UtcNow)
+            return null;
+
+        return Guid.TryParseExact(payload[..dot], "N", out var userId) ? userId : null;
     }
 
     private byte[] Sign(string payload) =>