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,82 @@
+using NSubstitute;
+using PnvPanel.Application.Admin.Support;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Application.Support;
+using PnvPanel.Application.Tests.TestSupport;
+using PnvPanel.Domain.Support;
+using Xunit;
+
+namespace PnvPanel.Application.Tests.Admin.Support;
+
+public class ApproveRoleRequestCommandHandlerTests
+{
+    private readonly IRoleService _roleService = Substitute.For<IRoleService>();
+    private readonly IRealtimeNotifier _notifier = Substitute.For<IRealtimeNotifier>();
+    private readonly ITelegramNotifier _telegramNotifier = Substitute.For<ITelegramNotifier>();
+
+    [Fact]
+    public async Task Handle_ForNewRoleRequest_CreatesRoleAssignsAndResolves()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateRoleRequestForNewRole(userId, "premium", 10, 5);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var newRoleId = Guid.NewGuid();
+        _roleService.CreateRoleAsync("premium", 10, 5, Arg.Any<CancellationToken>())
+            .Returns(Result.Success(new RoleDto(newRoleId, "premium", 10, 5, false)));
+        _roleService.ChangeUserRoleAsync(userId, newRoleId, Arg.Any<CancellationToken>()).Returns(Result.Success());
+
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid(), "admin");
+        var handler = new ApproveRoleRequestCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new ApproveRoleRequestCommand(ticket.Id), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal(TicketStatus.Resolved, ticket.Status);
+        await _roleService.Received(1).CreateRoleAsync("premium", 10, 5, Arg.Any<CancellationToken>());
+        await _roleService.Received(1).ChangeUserRoleAsync(userId, newRoleId, Arg.Any<CancellationToken>());
+        await _telegramNotifier.Received(1).NotifyUserAsync(userId, Arg.Any<string>(), Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_ForExistingRoleRequest_SkipsRoleCreation()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var roleId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateRoleRequestForExistingRole(userId, roleId);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        _roleService.ChangeUserRoleAsync(userId, roleId, Arg.Any<CancellationToken>()).Returns(Result.Success());
+
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        var handler = new ApproveRoleRequestCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new ApproveRoleRequestCommand(ticket.Id), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        await _roleService.DidNotReceive().CreateRoleAsync(
+            Arg.Any<string>(), Arg.Any<int>(), Arg.Any<int>(), Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_WhenNotRoleRequestType_ReturnsError()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var ticket = SupportTicket.CreateBugReport(Guid.NewGuid());
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        var handler = new ApproveRoleRequestCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new ApproveRoleRequestCommand(ticket.Id), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.NotRoleRequest, result.Error);
+    }
+}
@@ -0,0 +1,105 @@
+using NSubstitute;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Application.Support;
+using PnvPanel.Application.Support.AddComment;
+using PnvPanel.Application.Tests.TestSupport;
+using PnvPanel.Domain.Support;
+using Xunit;
+
+namespace PnvPanel.Application.Tests.Support;
+
+public class AddTicketCommentCommandHandlerTests
+{
+    private readonly IIdentityService _identityService = Substitute.For<IIdentityService>();
+    private readonly IFileStorage _fileStorage = Substitute.For<IFileStorage>();
+    private readonly IRealtimeNotifier _notifier = Substitute.For<IRealtimeNotifier>();
+
+    private static CurrentUserProfile Profile(Guid userId, string role) =>
+        new(userId, "user", Guid.NewGuid(), role, IsActivated: true, IsBlocked: false, MaxConfigs: 3,
+            MaxIpLimit: RoleQuota.Unlimited, SubscriptionToken: "token");
+
+    [Fact]
+    public async Task Handle_WhenOwnerComments_AddsCommentAndDoesNotNotifySelf()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(userId);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        _identityService.GetProfileAsync(userId, Arg.Any<CancellationToken>()).Returns(Profile(userId, "user"));
+        var currentUser = FakeCurrentUser.Authenticated(userId, "alice");
+
+        var handler = new AddTicketCommentCommandHandler(dbContext, _identityService, _fileStorage, _notifier, currentUser);
+
+        var result = await handler.Handle(new AddTicketCommentCommand(ticket.Id, "апдейт", []), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal("апдейт", result.Value.Body);
+        await _notifier.DidNotReceive().NotifyTicketUpdatedAsync(Arg.Any<Guid>(), Arg.Any<Guid>(), Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_WhenAdminComments_NotifiesOwner()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var ownerId = Guid.NewGuid();
+        var adminId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(ownerId);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        _identityService.GetProfileAsync(adminId, Arg.Any<CancellationToken>()).Returns(Profile(adminId, "admin"));
+        var currentUser = FakeCurrentUser.Authenticated(adminId, "admin");
+
+        var handler = new AddTicketCommentCommandHandler(dbContext, _identityService, _fileStorage, _notifier, currentUser);
+
+        var result = await handler.Handle(new AddTicketCommentCommand(ticket.Id, "ответ админа", []), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        await _notifier.Received(1).NotifyTicketUpdatedAsync(ticket.Id, ownerId, Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_WhenNotOwnerAndNotAdmin_ReturnsNotFound()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var ownerId = Guid.NewGuid();
+        var strangerId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(ownerId);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        _identityService.GetProfileAsync(strangerId, Arg.Any<CancellationToken>()).Returns(Profile(strangerId, "user"));
+        var currentUser = FakeCurrentUser.Authenticated(strangerId);
+
+        var handler = new AddTicketCommentCommandHandler(dbContext, _identityService, _fileStorage, _notifier, currentUser);
+
+        var result = await handler.Handle(new AddTicketCommentCommand(ticket.Id, "текст", []), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.NotFound, result.Error);
+    }
+
+    [Fact]
+    public async Task Handle_WhenTicketClosed_ReturnsTicketClosedError()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(userId);
+        ticket.Close();
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        _identityService.GetProfileAsync(userId, Arg.Any<CancellationToken>()).Returns(Profile(userId, "user"));
+        var currentUser = FakeCurrentUser.Authenticated(userId);
+
+        var handler = new AddTicketCommentCommandHandler(dbContext, _identityService, _fileStorage, _notifier, currentUser);
+
+        var result = await handler.Handle(new AddTicketCommentCommand(ticket.Id, "текст", []), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.TicketClosed, result.Error);
+    }
+}
@@ -0,0 +1,71 @@
+using NSubstitute;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Support;
+using PnvPanel.Application.Support.CreateBugReport;
+using PnvPanel.Application.Tests.TestSupport;
+using PnvPanel.Domain.Support;
+using Xunit;
+
+namespace PnvPanel.Application.Tests.Support;
+
+public class CreateBugReportTicketCommandHandlerTests
+{
+    private readonly IFileStorage _fileStorage = Substitute.For<IFileStorage>();
+    private readonly IRealtimeNotifier _notifier = Substitute.For<IRealtimeNotifier>();
+    private readonly ITelegramNotifier _telegramNotifier = Substitute.For<ITelegramNotifier>();
+
+    [Fact]
+    public async Task Handle_WithValidMessage_CreatesTicketAndComment()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var currentUser = FakeCurrentUser.Authenticated(userId, "alice");
+
+        var handler = new CreateBugReportTicketCommandHandler(dbContext, _fileStorage, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new CreateBugReportTicketCommand("Что-то сломалось", []), CancellationToken.None);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal(TicketType.BugReport, result.Value.Type);
+        Assert.Equal(TicketStatus.Open, result.Value.Status);
+        Assert.Single(result.Value.Comments);
+        Assert.Equal("Что-то сломалось", result.Value.Comments[0].Body);
+        Assert.Single(dbContext.SupportTickets);
+        Assert.Single(dbContext.TicketComments);
+        await _telegramNotifier.Received(1).NotifyAdminsBugReportCreatedAsync(
+            Arg.Any<Guid>(), "alice", "Что-то сломалось", Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_WithTooManyAttachments_ReturnsValidationError()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        var attachments = Enumerable.Range(0, 6)
+            .Select(_ => new TicketAttachmentUpload(new MemoryStream(), "a.png", "image/png", 10))
+            .ToList();
+
+        var handler = new CreateBugReportTicketCommandHandler(dbContext, _fileStorage, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new CreateBugReportTicketCommand("текст", attachments), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.TooManyAttachments, result.Error);
+    }
+
+    [Fact]
+    public async Task Handle_WithUnsupportedAttachmentType_ReturnsValidationError()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        var attachments = new[] { new TicketAttachmentUpload(new MemoryStream(), "a.exe", "application/x-msdownload", 10) };
+
+        var handler = new CreateBugReportTicketCommandHandler(dbContext, _fileStorage, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(new CreateBugReportTicketCommand("текст", attachments), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.UnsupportedAttachmentType, result.Error);
+    }
+}
@@ -0,0 +1,92 @@
+using NSubstitute;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Support;
+using PnvPanel.Application.Support.CreateRoleRequest;
+using PnvPanel.Application.Tests.TestSupport;
+using PnvPanel.Domain.Support;
+using Xunit;
+
+namespace PnvPanel.Application.Tests.Support;
+
+public class CreateRoleRequestTicketCommandHandlerTests
+{
+    private readonly IRoleService _roleService = Substitute.For<IRoleService>();
+    private readonly IRealtimeNotifier _notifier = Substitute.For<IRealtimeNotifier>();
+    private readonly ITelegramNotifier _telegramNotifier = Substitute.For<ITelegramNotifier>();
+
+    [Fact]
+    public async Task Handle_ForExistingRole_CreatesTicket()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var roleId = Guid.NewGuid();
+        var currentUser = FakeCurrentUser.Authenticated(userId, "alice");
+        _roleService.ListRolesAsync(Arg.Any<CancellationToken>())
+            .Returns(new List<RoleDto> { new(roleId, "premium", 5, 2, false) });
+
+        var handler = new CreateRoleRequestTicketCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(
+            new CreateRoleRequestTicketCommand(roleId, null, null, null, "нужно больше конфигов"), CancellationToken.None);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal(roleId, result.Value.RequestedRoleId);
+        Assert.Equal("premium", result.Value.RequestedRoleName);
+        await _telegramNotifier.Received(1).NotifyAdminsRoleRequestCreatedAsync(
+            Arg.Any<Guid>(), "alice", "premium", "нужно больше конфигов", Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task Handle_ForAdminRole_ReturnsForbidden()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var roleId = Guid.NewGuid();
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        _roleService.ListRolesAsync(Arg.Any<CancellationToken>())
+            .Returns(new List<RoleDto> { new(roleId, "admin", -1, -1, true) });
+
+        var handler = new CreateRoleRequestTicketCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(
+            new CreateRoleRequestTicketCommand(roleId, null, null, null, "хочу быть админом"), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.CannotRequestAdminRole, result.Error);
+    }
+
+    [Fact]
+    public async Task Handle_ForNewRole_SetsProposedFields()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid(), "bob");
+
+        var handler = new CreateRoleRequestTicketCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(
+            new CreateRoleRequestTicketCommand(null, "custom", 10, 4, "нужна кастомная роль"), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal("custom", result.Value.ProposedRoleName);
+        Assert.Equal(10, result.Value.ProposedMaxConfigs);
+        Assert.Equal(4, result.Value.ProposedMaxIpLimit);
+    }
+
+    [Fact]
+    public async Task Handle_WhenPendingRoleRequestExists_ReturnsConflict()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        dbContext.SupportTickets.Add(SupportTicket.CreateRoleRequestForNewRole(userId, "x", 1, 1));
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var currentUser = FakeCurrentUser.Authenticated(userId);
+        var handler = new CreateRoleRequestTicketCommandHandler(dbContext, _roleService, _notifier, _telegramNotifier, currentUser);
+
+        var result = await handler.Handle(
+            new CreateRoleRequestTicketCommand(null, "y", 2, 2, "ещё заявка"), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.RoleRequestAlreadyPending, result.Error);
+    }
+}
@@ -0,0 +1,65 @@
+using PnvPanel.Application.Support;
+using PnvPanel.Application.Support.Reopen;
+using PnvPanel.Application.Tests.TestSupport;
+using PnvPanel.Domain.Support;
+using Xunit;
+
+namespace PnvPanel.Application.Tests.Support;
+
+public class ReopenTicketCommandHandlerTests
+{
+    [Fact]
+    public async Task Handle_WhenResolved_SetsOpen()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(userId);
+        ticket.Resolve();
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var currentUser = FakeCurrentUser.Authenticated(userId);
+        var handler = new ReopenTicketCommandHandler(dbContext, currentUser);
+
+        var result = await handler.Handle(new ReopenTicketCommand(ticket.Id), CancellationToken.None);
+
+        Assert.True(result.IsSuccess);
+        Assert.Equal(TicketStatus.Open, ticket.Status);
+    }
+
+    [Fact]
+    public async Task Handle_WhenOpen_ReturnsNotResolved()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var userId = Guid.NewGuid();
+        var ticket = SupportTicket.CreateBugReport(userId);
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var currentUser = FakeCurrentUser.Authenticated(userId);
+        var handler = new ReopenTicketCommandHandler(dbContext, currentUser);
+
+        var result = await handler.Handle(new ReopenTicketCommand(ticket.Id), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.NotResolved, result.Error);
+    }
+
+    [Fact]
+    public async Task Handle_WhenNotOwner_ReturnsNotFound()
+    {
+        using var dbContext = InMemoryDbContextFactory.Create();
+        var ticket = SupportTicket.CreateBugReport(Guid.NewGuid());
+        ticket.Resolve();
+        dbContext.SupportTickets.Add(ticket);
+        await dbContext.SaveChangesAsync(CancellationToken.None);
+
+        var currentUser = FakeCurrentUser.Authenticated(Guid.NewGuid());
+        var handler = new ReopenTicketCommandHandler(dbContext, currentUser);
+
+        var result = await handler.Handle(new ReopenTicketCommand(ticket.Id), CancellationToken.None);
+
+        Assert.False(result.IsSuccess);
+        Assert.Equal(SupportErrors.NotFound, result.Error);
+    }
+}