Implement extension request and gift functionalities in billing system

- Added new endpoints for creating and managing extension requests, allowing users to request billing period extensions. - Implemented admin approval processes for extension requests via Telegram, including inline buttons for approval and rejection. - Introduced a gifting feature for admins to grant additional billing days directly to users without a request. - Updated the support ticket model to accommodate extension requests and their associated properties. - Enhanced the Telegram notifier to inform admins of new extension requests and notify users of approval or rejection. - Updated frontend components to support the new extension request and gifting functionalities, including user interfaces for managing these features. - Revised API documentation to reflect the new endpoints and their usage in the billing context.
2026-07-19 05:30:11 +03:00
parent e088e302e9
commit 24cee9bb78
46 changed files with 2541 additions and 78 deletions
@@ -0,0 +1,76 @@
+using Microsoft.Extensions.Logging;
+using PnvPanel.Application.Admin.Users;
+using PnvPanel.Application.Auth;
+using PnvPanel.Application.Billing;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
+
+namespace PnvPanel.Application.Admin.Billing;
+
+public sealed class GrantBillingGiftCommandHandler(
+    IAppDbContext dbContext,
+    IIdentityService identityService,
+    IXuiPanelGateway gateway,
+    IRealtimeNotifier notifier,
+    ITelegramNotifier telegramNotifier,
+    ICurrentUser currentUser,
+    ILogger<GrantBillingGiftCommandHandler> logger
+) : ICommandHandler<GrantBillingGiftCommand, Result>
+{
+    public async Task<Result> Handle(GrantBillingGiftCommand command, CancellationToken cancellationToken)
+    {
+        if (currentUser.UserId is not { } adminId)
+            return Result.Failure(AuthErrors.Unauthorized);
+
+        var profile = await identityService.GetProfileAsync(command.UserId, cancellationToken);
+        if (profile is null)
+            return Result.Failure(UserErrors.NotFound);
+
+        if (!profile.BillingEnabled)
+            return Result.Failure(BillingErrors.NotEnabled);
+
+        var now = DateTimeOffset.UtcNow;
+        var baseline = profile.BillingPaidUntil is { } paidUntil && paidUntil > now ? paidUntil : now;
+        var newPaidUntil = baseline.AddDays(command.Days);
+
+        var extendResult = await identityService.ExtendBillingPaidUntilAsync(
+            command.UserId,
+            newPaidUntil,
+            cancellationToken
+        );
+        if (!extendResult.IsSuccess)
+            return extendResult;
+
+        await BillingConfigResumer.ResumeConfigsAsync(
+            dbContext,
+            gateway,
+            notifier,
+            logger,
+            command.UserId,
+            newPaidUntil,
+            cancellationToken
+        );
+
+        dbContext.AuditLogs.Add(
+            AuditLog.Create(
+                adminId,
+                "BillingGiftGranted",
+                "User",
+                command.UserId.ToString(),
+                metadata: $"{{\"days\":{command.Days}}}",
+                AuditSource.Web
+            )
+        );
+
+        await telegramNotifier.NotifyUserAsync(
+            command.UserId,
+            $"🎁 Вам подарено {command.Days} дн. подписки! Доступ продлён до {newPaidUntil:dd.MM.yyyy}.",
+            "/billing",
+            cancellationToken
+        );
+
+        return Result.Success();
+    }
+}