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.Api/Endpoints/RoleEndpoints.cs

@@ -0,0 +1,59 @@
+using PnvPanel.Api.Common;
+using PnvPanel.Application.Admin.Roles;
+using PnvPanel.Application.Admin.Users;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Infrastructure.Identity;
+
+namespace PnvPanel.Api.Endpoints;
+
+public static class RoleEndpoints
+{
+    public static IEndpointRouteBuilder MapRoleEndpoints(this IEndpointRouteBuilder app)
+    {
+        var admin = app.MapGroup("/api/admin")
+            .WithTags("Admin.Roles")
+            .RequireAuthorization(policy => policy.RequireRole(RoleNames.Admin));
+
+        admin.MapGet("/roles", ListRoles);
+        admin.MapPost("/roles", CreateRole);
+        admin.MapPut("/roles/{id:guid}", UpdateRole);
+        admin.MapDelete("/roles/{id:guid}", DeleteRole);
+        admin.MapPatch("/users/{id:guid}/role", ChangeUserRole);
+
+        return app;
+    }
+
+    private static async Task<IResult> ListRoles(ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new ListRolesQuery(), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> CreateRole(CreateRoleCommand command, ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(command, cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> UpdateRole(Guid id, UpdateRoleBody body, ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new UpdateRoleCommand(id, body.MaxConfigs), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> DeleteRole(Guid id, ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new DeleteRoleCommand(id), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> ChangeUserRole(Guid id, ChangeUserRoleBody body, ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new ChangeUserRoleCommand(id, body.RoleId), cancellationToken);
+        return result.ToHttpResult();
+    }
+}
+
+public sealed record UpdateRoleBody(int MaxConfigs);
+
+public sealed record ChangeUserRoleBody(Guid RoleId);