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/Admin/Roles/CreateRoleCommand.cs

@@ -0,0 +1,7 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed record CreateRoleCommand(string Name, int MaxConfigs) : ICommand<Result<RoleDto>>;

backend/src/PnvPanel.Application/Admin/Roles/CreateRoleCommandHandler.cs

@@ -0,0 +1,11 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class CreateRoleCommandHandler(IRoleService roleService) : ICommandHandler<CreateRoleCommand, Result<RoleDto>>
+{
+    public Task<Result<RoleDto>> Handle(CreateRoleCommand command, CancellationToken cancellationToken)
+        => roleService.CreateRoleAsync(command.Name, command.MaxConfigs, cancellationToken);
+}

backend/src/PnvPanel.Application/Admin/Roles/CreateRoleCommandValidator.cs

@@ -0,0 +1,16 @@
+using FluentValidation;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class CreateRoleCommandValidator : AbstractValidator<CreateRoleCommand>
+{
+    public CreateRoleCommandValidator()
+    {
+        RuleFor(x => x.Name)
+            .NotEmpty()
+            .Length(2, 32)
+            .Matches("^[a-zA-Z0-9_-]+$");
+
+        RuleFor(x => x.MaxConfigs).GreaterThanOrEqualTo(-1);
+    }
+}

backend/src/PnvPanel.Application/Admin/Roles/DeleteRoleCommand.cs

@@ -0,0 +1,6 @@
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed record DeleteRoleCommand(Guid RoleId) : ICommand<Result>;

backend/src/PnvPanel.Application/Admin/Roles/DeleteRoleCommandHandler.cs

@@ -0,0 +1,11 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class DeleteRoleCommandHandler(IRoleService roleService) : ICommandHandler<DeleteRoleCommand, Result>
+{
+    public Task<Result> Handle(DeleteRoleCommand command, CancellationToken cancellationToken)
+        => roleService.DeleteRoleAsync(command.RoleId, cancellationToken);
+}

backend/src/PnvPanel.Application/Admin/Roles/ListRolesQuery.cs

@@ -0,0 +1,7 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed record ListRolesQuery : IQuery<Result<IReadOnlyList<RoleDto>>>;

backend/src/PnvPanel.Application/Admin/Roles/ListRolesQueryHandler.cs

@@ -0,0 +1,12 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class ListRolesQueryHandler(IRoleService roleService)
+    : IQueryHandler<ListRolesQuery, Result<IReadOnlyList<RoleDto>>>
+{
+    public async Task<Result<IReadOnlyList<RoleDto>>> Handle(ListRolesQuery query, CancellationToken cancellationToken)
+        => Result.Success(await roleService.ListRolesAsync(cancellationToken));
+}

backend/src/PnvPanel.Application/Admin/Roles/RoleErrors.cs

@@ -0,0 +1,11 @@
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public static class RoleErrors
+{
+    public static readonly Error NotFound = Error.NotFound("Roles.NotFound", "Роль не найдена.");
+    public static readonly Error DuplicateName = Error.Conflict("Roles.DuplicateName", "Роль с таким именем уже существует.");
+    public static readonly Error CannotModifySystemRole = Error.Forbidden("Roles.CannotModifySystemRole", "Системную роль нельзя удалить.");
+    public static readonly Error RoleInUse = Error.Conflict("Roles.RoleInUse", "Роль назначена пользователям — сначала переназначьте их.");
+}

backend/src/PnvPanel.Application/Admin/Roles/UpdateRoleCommand.cs

@@ -0,0 +1,7 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed record UpdateRoleCommand(Guid RoleId, int MaxConfigs) : ICommand<Result<RoleDto>>;

backend/src/PnvPanel.Application/Admin/Roles/UpdateRoleCommandHandler.cs

@@ -0,0 +1,11 @@
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class UpdateRoleCommandHandler(IRoleService roleService) : ICommandHandler<UpdateRoleCommand, Result<RoleDto>>
+{
+    public Task<Result<RoleDto>> Handle(UpdateRoleCommand command, CancellationToken cancellationToken)
+        => roleService.UpdateRoleAsync(command.RoleId, command.MaxConfigs, cancellationToken);
+}

backend/src/PnvPanel.Application/Admin/Roles/UpdateRoleCommandValidator.cs

@@ -0,0 +1,11 @@
+using FluentValidation;
+
+namespace PnvPanel.Application.Admin.Roles;
+
+public sealed class UpdateRoleCommandValidator : AbstractValidator<UpdateRoleCommand>
+{
+    public UpdateRoleCommandValidator()
+    {
+        RuleFor(x => x.MaxConfigs).GreaterThanOrEqualTo(-1);
+    }
+}