Update directory structure of local image storage

docs/pages/configuration/index.md

@@ -38,14 +38,11 @@ In der Weboberfläche können Bilddateien hochgeladen werden. Diese werden mit e
 | `Turnierplan__ImageQuality` | Die Qualitätseinstellung für Bild-Uploads. Ein Wert von `100` entspricht einer verlustfreien Komprimierung.           | `80`                      |
 | `ImageStorage__StoragePath` | Das Verzeichnis innerhalb vom Container, hochgeladene Bilder gespeichert werden.                                      | `/var/turnierplan/images` |
 
-Alternativ können externe Services zum Speichern der Bilder konfiguriert werden. Dies hat den Vorteil, dass das Bereitstellen von Bilddateien keine CPU- und Netzwerkresourcen vom turnierplan.NET-Server beansprucht. Aktuell werden die folgenden externen Services unterstützt:
+Alternativ können externe Services zum Speichern der Bilder konfiguriert werden. Dies hat den Vorteil, dass das Bereitstellen von Bilddateien keine CPU- und Netzwerkressourcen vom turnierplan.NET-Server beansprucht. Aktuell werden die folgenden externen Services unterstützt:
 
 - **AWS S3** (oder kompatibler Dienst)
 - **Azure Blob Storage**
 
-!!! warning
-    Die nachfolgend vorgestellten Alternativen verwenden nicht zwangsläufig eine identische Verzeichnisstruktur zur Organisation der Dateien. Dadurch wird eine nachträgliche Umstellung ggf. erschwert!
-
 ### AWS S3
 
 Um Bilder in einem AWS S3 oder S3-kompatiblen Bucket zu speichern, müssen die folgenden Umgebungsvariablen gesetzt werden:

src/Turnierplan.App/Helpers/DatabaseImageProvider.cs

@@ -0,0 +1,13 @@
+using Turnierplan.Core.Image;
+using Turnierplan.Dal.Repositories;
+using Turnierplan.ImageStorage;
+
+namespace Turnierplan.App.Helpers;
+
+internal sealed class DatabaseImageProvider(IImageRepository imageRepository) : IImageProvider
+{
+    public async Task<IReadOnlyCollection<Image>> GetImagesAsync()
+    {
+        return (await imageRepository.GetAllImagesAsync()).AsReadOnly();
+    }
+}

src/Turnierplan.App/Program.cs

@@ -37,7 +37,7 @@
 builder.Services.AddTurnierplanMonitoring(builder.Configuration);
 builder.Services.AddTurnierplanDataAccessLayer(builder.Configuration);
 builder.Services.AddTurnierplanDocumentRendering<ApplicationUrlProvider>();
-builder.Services.AddTurnierplanImageStorage(builder.Configuration.GetSection("ImageStorage"));
+builder.Services.AddTurnierplanImageStorage<DatabaseImageProvider>(builder.Configuration.GetSection("ImageStorage"));
 builder.Services.AddTurnierplanLocalization();
 builder.Services.AddTurnierplanSecurity(builder.Configuration.GetSection("Identity"));
 
@@ -116,4 +116,7 @@
 // Migrate database and create admin user if DB is empty
 await app.InitializeDatabaseAsync();
 
+// Run image storage migrations if required by the configured image storage
+await app.MigrateImageStorageAsync();
+
 await app.RunAsync();

src/Turnierplan.Dal/Repositories/ImageRepository.cs

@@ -6,6 +6,8 @@ namespace Turnierplan.Dal.Repositories;
 
 public interface IImageRepository : IRepositoryWithPublicId<Image, long>
 {
+    Task<List<Image>> GetAllImagesAsync();
+
     Task<int> CountNumberOfReferencingTournamentsAsync(long imageId);
 }
 
@@ -22,6 +24,11 @@ internal sealed class ImageRepository(TurnierplanContext context) : RepositoryBa
             .FirstOrDefaultAsync();
     }
 
+    public Task<List<Image>> GetAllImagesAsync()
+    {
+        return DbSet.ToListAsync();
+    }
+
     public async Task<int> CountNumberOfReferencingTournamentsAsync(long imageId)
     {
         var count = await _context.Tournaments

src/Turnierplan.ImageStorage.Test.Migration/Turnierplan.ImageStorage.Test.Migration.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <Import Project="../version.xml" />
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <Import Project="../Turnierplan.Test.Common.props" />
+
+  <ItemGroup>
+    <ProjectReference Include="..\Turnierplan.ImageStorage\Turnierplan.ImageStorage.csproj" />
+  </ItemGroup>
+</Project>

src/Turnierplan.ImageStorage/AssemblyInfo.cs

@@ -0,0 +1,3 @@
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("Turnierplan.ImageStorage.Test.Migration")]

src/Turnierplan.ImageStorage/Extensions/ServiceCollectionExtensions.cs

@@ -8,7 +8,8 @@ namespace Turnierplan.ImageStorage.Extensions;
 
 public static class ServiceCollectionExtensions
 {
-    public static void AddTurnierplanImageStorage(this IServiceCollection services, IConfigurationSection configuration)
+    public static void AddTurnierplanImageStorage<T>(this IServiceCollection services, IConfigurationSection configuration)
+        where T : IImageProvider
     {
         var type = configuration.GetValue<string>("Type");
 
@@ -29,5 +30,7 @@ public static void AddTurnierplanImageStorage(this IServiceCollection services,
             default:
                 throw new InvalidOperationException($"Invalid image storage type specified: '{type}'");
         }
+
+        services.AddTransient<ImageStorageMigrator>(sp => new ImageStorageMigrator(sp.GetRequiredService<IImageStorage>(), ActivatorUtilities.CreateInstance<T>(sp)));
     }
 }

src/Turnierplan.ImageStorage/Extensions/WebApplicationExtensions.cs

@@ -0,0 +1,28 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Turnierplan.ImageStorage.Extensions;
+
+public static class WebApplicationExtensions
+{
+    public static void MapImageStorageEndpoint(this WebApplication application)
+    {
+        var imageStorage = application.Services.GetRequiredService<IImageStorage>();
+
+        if (imageStorage is not IHostedImageStorage localImageStorage)
+        {
+            return;
+        }
+
+        localImageStorage.MapEndpoint(application);
+    }
+
+    public static async Task MigrateImageStorageAsync(this WebApplication application)
+    {
+        await using var scope = application.Services.CreateAsyncScope();
+
+        var migrator = scope.ServiceProvider.GetRequiredService<ImageStorageMigrator>();
+
+        await migrator.MigrateAsync(application.Lifetime.ApplicationStopping);
+    }
+}

src/Turnierplan.ImageStorage/IHostedImageStorage.cs

@@ -0,0 +1,8 @@
+using Microsoft.AspNetCore.Builder;
+
+namespace Turnierplan.ImageStorage;
+
+internal interface IHostedImageStorage
+{
+    void MapEndpoint(IApplicationBuilder applicationBuilder);
+}

src/Turnierplan.ImageStorage/IImageProvider.cs

@@ -0,0 +1,8 @@
+using Turnierplan.Core.Image;
+
+namespace Turnierplan.ImageStorage;
+
+public interface IImageProvider
+{
+    Task<IReadOnlyCollection<Image>> GetImagesAsync();
+}

src/Turnierplan.ImageStorage/IMigratableImageStorage.cs

@@ -0,0 +1,6 @@
+namespace Turnierplan.ImageStorage;
+
+internal interface IMigratableImageStorage
+{
+    Task MigrateAsync(IImageProvider imageProvider, CancellationToken cancellationToken);
+}

src/Turnierplan.ImageStorage/ImageStorageMigrator.cs

@@ -0,0 +1,14 @@
+namespace Turnierplan.ImageStorage;
+
+internal sealed class ImageStorageMigrator(IImageStorage imageStorage, IImageProvider imageProvider)
+{
+    public async Task MigrateAsync(CancellationToken cancellationToken = default)
+    {
+        if (imageStorage is not IMigratableImageStorage migratableImageStorage)
+        {
+            return;
+        }
+
+        await migratableImageStorage.MigrateAsync(imageProvider, cancellationToken);
+    }
+}