Enhance documentation with new features: added dark/light/system theme support, instructions page, and application catalog. Updated API and domain model for app management and automatic migrations on startup. Improved frontend structure with new routes and features for user instructions and app management.

backend/src/PnvPanel.Application/Apps/ClientAppDto.cs

@@ -0,0 +1,9 @@
+using PnvPanel.Domain.Apps;
+
+namespace PnvPanel.Application.Apps;
+
+public sealed record ClientAppDto(Guid Id, string Name, string DownloadUrl, string? Description, string? IconUrl)
+{
+    public static ClientAppDto FromDomain(ClientApp app) =>
+        new(app.Id, app.Name, app.DownloadUrl.ToString(), app.Description, app.IconUrl);
+}

backend/src/PnvPanel.Application/Apps/ListAppsQuery.cs

@@ -0,0 +1,7 @@
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Apps;
+
+namespace PnvPanel.Application.Apps;
+
+public sealed record ListAppsQuery : IQuery<Result<IReadOnlyDictionary<OsPlatform, IReadOnlyList<ClientAppDto>>>>;

backend/src/PnvPanel.Application/Apps/ListAppsQueryHandler.cs

@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Apps;
+
+namespace PnvPanel.Application.Apps;
+
+public sealed class ListAppsQueryHandler(IAppDbContext dbContext)
+    : IQueryHandler<ListAppsQuery, Result<IReadOnlyDictionary<OsPlatform, IReadOnlyList<ClientAppDto>>>>
+{
+    public async Task<Result<IReadOnlyDictionary<OsPlatform, IReadOnlyList<ClientAppDto>>>> Handle(
+        ListAppsQuery query, CancellationToken cancellationToken)
+    {
+        var apps = await dbContext.ClientApps.AsNoTracking()
+            .Where(a => a.IsEnabled)
+            .OrderBy(a => a.SortOrder)
+            .ToListAsync(cancellationToken);
+
+        var grouped = apps
+            .GroupBy(a => a.OperatingSystem)
+            .ToDictionary(
+                g => g.Key,
+                g => (IReadOnlyList<ClientAppDto>)g.Select(ClientAppDto.FromDomain).ToList());
+
+        return Result.Success<IReadOnlyDictionary<OsPlatform, IReadOnlyList<ClientAppDto>>>(grouped);
+    }
+}