Implement support ticket system with role request and bug report functionalities

- Introduced a new support ticket system allowing users to submit bug reports and role requests. - Implemented endpoints for creating, updating, and managing support tickets, including file attachments. - Enhanced Telegram bot integration to handle role requests directly within the bot, enabling admins to approve or reject requests without accessing the website. - Updated database schema to include support ticket entities and their relationships. - Improved API documentation to reflect new support ticket endpoints and their usage. - Added necessary localization for support ticket features in both Russian and English.
2026-07-14 06:49:05 +03:00
parent 14b64a3140
commit b5630b2685
98 changed files with 4463 additions and 6 deletions
@@ -0,0 +1,73 @@
+using Microsoft.EntityFrameworkCore;
+using PnvPanel.Application.Auth;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Support;
+
+namespace PnvPanel.Application.Support.CreateRoleRequest;
+
+public sealed class CreateRoleRequestTicketCommandHandler(
+    IAppDbContext dbContext, IRoleService roleService, IRealtimeNotifier notifier,
+    ITelegramNotifier telegramNotifier, ICurrentUser currentUser)
+    : ICommandHandler<CreateRoleRequestTicketCommand, Result<TicketDetailDto>>
+{
+    // Совпадает со значением Infrastructure.Identity.RoleNames.Admin — Application не может ссылаться
+    // на Infrastructure (направление зависимостей), поэтому системное имя роли продублировано здесь.
+    private const string AdminRoleName = "admin";
+
+    public async Task<Result<TicketDetailDto>> Handle(CreateRoleRequestTicketCommand command, CancellationToken cancellationToken)
+    {
+        if (currentUser.UserId is not { } userId)
+            return Result.Failure<TicketDetailDto>(AuthErrors.Unauthorized);
+
+        var hasPending = await dbContext.SupportTickets.AnyAsync(
+            t => t.UserId == userId && t.Type == TicketType.RoleRequest && t.Status == TicketStatus.Open,
+            cancellationToken);
+        if (hasPending)
+            return Result.Failure<TicketDetailDto>(SupportErrors.RoleRequestAlreadyPending);
+
+        SupportTicket ticket;
+        string? requestedRoleName = null;
+
+        if (command.ExistingRoleId is { } roleId)
+        {
+            var roles = await roleService.ListRolesAsync(cancellationToken);
+            var role = roles.FirstOrDefault(r => r.Id == roleId);
+            if (role is null)
+                return Result.Failure<TicketDetailDto>(SupportErrors.RoleNotFound);
+
+            if (role.Name.Equals(AdminRoleName, StringComparison.OrdinalIgnoreCase))
+                return Result.Failure<TicketDetailDto>(SupportErrors.CannotRequestAdminRole);
+
+            ticket = SupportTicket.CreateRoleRequestForExistingRole(userId, roleId);
+            requestedRoleName = role.Name;
+        }
+        else
+        {
+            ticket = SupportTicket.CreateRoleRequestForNewRole(
+                userId, command.NewRoleName!, command.NewRoleMaxConfigs!.Value, command.NewRoleMaxIpLimit!.Value);
+        }
+
+        dbContext.SupportTickets.Add(ticket);
+
+        var comment = TicketComment.Create(ticket.Id, userId, command.Justification);
+        dbContext.TicketComments.Add(comment);
+
+        var userName = currentUser.UserName ?? userId.ToString();
+        var roleDescription = requestedRoleName
+            ?? $"новая роль «{command.NewRoleName}» (конфигов: {command.NewRoleMaxConfigs}, IP: {command.NewRoleMaxIpLimit})";
+
+        await notifier.NotifyTicketCreatedAsync(ticket.Id, userId, userName, ticket.Type, cancellationToken);
+        await telegramNotifier.NotifyAdminsRoleRequestCreatedAsync(ticket.Id, userName, roleDescription, command.Justification, cancellationToken);
+
+        var commentDto = new TicketCommentDto(comment.Id, userId, userName, comment.Body, comment.CreatedAt, []);
+
+        var dto = new TicketDetailDto(
+            ticket.Id, ticket.UserId, userName, ticket.Type, ticket.Status,
+            ticket.RequestedRoleId, requestedRoleName, ticket.ProposedRoleName, ticket.ProposedMaxConfigs,
+            ticket.ProposedMaxIpLimit, ticket.CreatedAt, [commentDto]);
+
+        return Result.Success(dto);
+    }
+}