Add metadata management for shows: implement metadata retrieval, application, and updates in the API and UI. Enhance Show and ShowDto models to include metadata fields, and update the database schema accordingly. Introduce new endpoints for metadata operations and integrate metadata display in the ShowDetail component.

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

@@ -0,0 +1,28 @@
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>
+/// Локальное хранилище картинок метаданных (постеры/кадры) под metadata/ в корне хранилища. Скачивает
+/// изображения к себе, чтобы не зависеть от внешнего CDN на этапе показа.
+/// </summary>
+public interface IMetadataImageStore
+{
+    /// <summary>Скачивает постер по URL и сохраняет для шоу. Возвращает относительный путь или null при ошибке.</summary>
+    Task<string?> DownloadShowPosterAsync(
+        Guid showId,
+        string url,
+        CancellationToken cancellationToken
+    );
+
+    /// <summary>Сохраняет загруженный вручную постер шоу. Возвращает относительный путь.</summary>
+    Task<string> SaveShowPosterAsync(
+        Guid showId,
+        string extension,
+        Stream content,
+        CancellationToken cancellationToken
+    );
+
+    void DeleteShowImages(Guid showId);
+
+    /// <summary>Абсолютный путь к файлу по относительному (с защитой от traversal) или null, если вне корня.</summary>
+    string? ResolveAbsolutePath(string relativePath);
+}

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

@@ -0,0 +1,33 @@
+using TeleWave.Application.Metadata;
+
+namespace TeleWave.Application.Common.Interfaces;
+
+/// <summary>Источник метаданных о шоу/сериях (TMDb, OMDb). Реализация ходит во внешний API.</summary>
+public interface IMetadataProvider
+{
+    /// <summary>Ключ источника: «tmdb», «omdb».</summary>
+    string Key { get; }
+
+    Task<IReadOnlyList<MetadataCandidate>> SearchShowsAsync(
+        string query,
+        CancellationToken cancellationToken
+    );
+
+    Task<ShowMetadata?> GetShowAsync(string externalId, CancellationToken cancellationToken);
+
+    Task<EpisodeMetadata?> GetEpisodeAsync(
+        string externalId,
+        int season,
+        int episode,
+        CancellationToken cancellationToken
+    );
+}
+
+/// <summary>Резолвит провайдер по ключу и перечисляет реально настроенные (с API-ключом) источники.</summary>
+public interface IMetadataProviderResolver
+{
+    IMetadataProvider? Resolve(string key);
+
+    /// <summary>Ключи источников, у которых задан API-ключ (доступны в UI).</summary>
+    IReadOnlyList<string> AvailableKeys { get; }
+}