Implement rate limiting and enhance authentication flow

- Added rate limiting configuration for authentication endpoints, allowing customizable request limits via environment variables.
- Updated authentication flow to utilize HttpRequest for cookie management, ensuring secure handling of refresh tokens.
- Introduced a new endpoint to retrieve user subscription details.
- Enhanced the handling of Telegram bot token validation to prevent errors with empty tokens.
- Updated the application to serialize enums as strings for better documentation and compatibility with TypeScript.
- Improved test coverage for new features and adjustments in command handlers.

backend/src/PnvPanel.Api/Endpoints/AuthEndpoints.cs

@@ -38,13 +38,13 @@ public static class AuthEndpoints
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> Login(LoginCommand command, ISender sender, HttpResponse response, CancellationToken cancellationToken)
+    private static async Task<IResult> Login(LoginCommand command, ISender sender, HttpRequest request, HttpResponse response, CancellationToken cancellationToken)
     {
         var result = await sender.Send(command, cancellationToken);
         if (!result.IsSuccess)
             return result.ToHttpResult();
 
-        SetRefreshCookie(response, result.Value.RefreshToken, result.Value.RefreshTokenExpiresAt);
+        SetRefreshCookie(request, response, result.Value.RefreshToken, result.Value.RefreshTokenExpiresAt);
         return Results.Ok(ToLoginResponse(result.Value));
     }
 
@@ -56,11 +56,11 @@ public static class AuthEndpoints
         var result = await sender.Send(new RefreshCommand(rawToken), cancellationToken);
         if (!result.IsSuccess)
         {
-            response.Cookies.Delete(RefreshCookieName, BuildCookieOptions());
+            response.Cookies.Delete(RefreshCookieName, BuildCookieOptions(request));
             return result.ToHttpResult();
         }
 
-        SetRefreshCookie(response, result.Value.RefreshToken, result.Value.RefreshTokenExpiresAt);
+        SetRefreshCookie(request, response, result.Value.RefreshToken, result.Value.RefreshTokenExpiresAt);
         return Results.Ok(ToLoginResponse(result.Value));
     }
 
@@ -69,7 +69,7 @@ public static class AuthEndpoints
         if (request.Cookies.TryGetValue(RefreshCookieName, out var rawToken) && !string.IsNullOrEmpty(rawToken))
             await sender.Send(new LogoutCommand(rawToken), cancellationToken);
 
-        response.Cookies.Delete(RefreshCookieName, BuildCookieOptions());
+        response.Cookies.Delete(RefreshCookieName, BuildCookieOptions(request));
         return Results.NoContent();
     }
 
@@ -85,10 +85,10 @@ public static class AuthEndpoints
         return result.ToHttpResult();
     }
 
-    private static async Task<IResult> DeleteMe(HttpResponse response, ISender sender, CancellationToken cancellationToken)
+    private static async Task<IResult> DeleteMe(HttpRequest request, HttpResponse response, ISender sender, CancellationToken cancellationToken)
     {
         var result = await sender.Send(new DeleteMyAccountCommand(), cancellationToken);
-        response.Cookies.Delete(RefreshCookieName, BuildCookieOptions());
+        response.Cookies.Delete(RefreshCookieName, BuildCookieOptions(request));
         return result.ToHttpResult();
     }
 
@@ -99,17 +99,19 @@ public static class AuthEndpoints
         user = auth.User,
     };
 
-    private static void SetRefreshCookie(HttpResponse response, string rawToken, DateTimeOffset expiresAt)
+    private static void SetRefreshCookie(HttpRequest request, HttpResponse response, string rawToken, DateTimeOffset expiresAt)
     {
-        var options = BuildCookieOptions();
+        var options = BuildCookieOptions(request);
         options.Expires = expiresAt;
         response.Cookies.Append(RefreshCookieName, rawToken, options);
     }
 
-    private static CookieOptions BuildCookieOptions() => new()
+    // Secure = IsHttps запроса (учитывает ForwardedHeaders за внешним TLS-прокси, см. CLAUDE.md) —
+    // иначе браузер/HttpClient не пришлёт cookie обратно на plain-http (локальный dev, TestServer).
+    private static CookieOptions BuildCookieOptions(HttpRequest request) => new()
     {
         HttpOnly = true,
-        Secure = true,
+        Secure = request.IsHttps,
         SameSite = SameSiteMode.Strict,
         Path = "/api/auth",
     };

backend/src/PnvPanel.Api/Endpoints/ConfigEndpoints.cs

@@ -4,6 +4,7 @@ using PnvPanel.Application.Configs.Create;
 using PnvPanel.Application.Configs.Edit;
 using PnvPanel.Application.Configs.GetConfigLink;
 using PnvPanel.Application.Configs.GetMyConfigs;
+using PnvPanel.Application.Configs.GetMySubscription;
 using PnvPanel.Application.Configs.ListAvailableInbounds;
 using PnvPanel.Application.Configs.Revoke;
 using PnvPanel.Application.Configs.Rotate;
@@ -23,6 +24,7 @@ public static class ConfigEndpoints
         group.MapPost("/configs/{id:guid}/rotate", RotateConfig);
         group.MapDelete("/configs/{id:guid}", RevokeConfig);
         group.MapGet("/configs/{id:guid}/link", GetConfigLink);
+        group.MapGet("/subscription", GetMySubscription);
 
         return app;
     }
@@ -74,6 +76,16 @@ public static class ConfigEndpoints
         var subscriptionUrl = $"{request.Scheme}://{request.Host}/sub/{result.Value.SubscriptionToken}";
         return Results.Ok(new { connectionString = result.Value.ConnectionString, subscriptionUrl });
     }
+
+    private static async Task<IResult> GetMySubscription(HttpRequest request, ISender sender, CancellationToken cancellationToken)
+    {
+        var result = await sender.Send(new GetMySubscriptionQuery(), cancellationToken);
+        if (!result.IsSuccess)
+            return result.ToHttpResult();
+
+        var subscriptionUrl = $"{request.Scheme}://{request.Host}/sub/{result.Value.SubscriptionToken}";
+        return Results.Ok(new { subscriptionUrl });
+    }
 }
 
 public sealed record CreateConfigBody(Guid InboundId, string? Label, int? DeviceLimit);

backend/src/PnvPanel.Api/Program.cs

@@ -1,3 +1,4 @@
+using System.Text.Json.Serialization;
 using Microsoft.AspNetCore.HttpOverrides;
 using Microsoft.AspNetCore.RateLimiting;
 using Microsoft.Extensions.Options;
@@ -40,11 +41,17 @@ builder.Services.AddSignalR();
 builder.Services.AddSingleton<IRealtimeNotifier, SignalRRealtimeNotifier>();
 
 // Telegram-бот: presentation-адаптер, хостится в процессе Api (long polling). Клиент регистрируем
-// всегда (даже с пустым токеном) — TelegramBotHostedService сам решает не стартовать без токена.
+// всегда (даже с пустым токеном) — TelegramBotHostedService сам решает не стартовать без токена,
+// а TelegramNotifier — не слать сообщения. TelegramBotClient(...) при этом валидирует формат токена
+// и падает на пустой строке, поэтому при пустом BotToken подставляем синтаксически валидную заглушку —
+// реальный HTTP-вызов через неё никогда не происходит (все вызывающие места сами проверяют BotToken).
 builder.Services.AddSingleton<ITelegramBotClient>(sp =>
 {
     var options = sp.GetRequiredService<IOptions<TelegramOptions>>();
-    return new TelegramBotClient(options.Value.BotToken ?? string.Empty);
+    var token = options.Value.BotToken;
+    return new TelegramBotClient(string.IsNullOrWhiteSpace(token)
+        ? "0:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
+        : token);
 });
 // Scoped — зависит от IIdentityService (scoped), не Singleton.
 builder.Services.AddScoped<ITelegramNotifier, TelegramNotifier>();
@@ -55,13 +62,20 @@ builder.Services.AddRateLimiter(options =>
 {
     options.AddFixedWindowLimiter(RateLimiting.AuthPolicy, limiterOptions =>
     {
-        limiterOptions.PermitLimit = 20;
+        // Настраиваемо через конфиг, чтобы интеграционные тесты (общий TestServer/host на весь
+        // collection, все запросы — от одного "клиента") могли поднять лимит и не ловить 429.
+        limiterOptions.PermitLimit = builder.Configuration.GetValue("RateLimiting:AuthPermitLimit", 20);
         limiterOptions.Window = TimeSpan.FromMinutes(1);
         limiterOptions.QueueLimit = 0;
     });
     options.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
 });
 
+// Энумы сериализуются строками ("Vless", "Active", ...), не числами — самодокументируемый JSON,
+// корректные строковые литералы при генерации TS-типов из OpenAPI-схемы (см. docs/frontend.md).
+builder.Services.ConfigureHttpJsonOptions(options =>
+    options.SerializerOptions.Converters.Add(new JsonStringEnumConverter()));
+
 builder.Services.AddProblemDetails();
 builder.Services.AddOpenApi();
 builder.Services.AddHealthChecks()

backend/src/PnvPanel.Application/Admin/Activation/ApproveActivationCommandHandler.cs

@@ -5,6 +5,7 @@ using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
 using PnvPanel.Domain.Activation;
+using PnvPanel.Domain.Audit;
 
 namespace PnvPanel.Application.Admin.Activation;
 
@@ -33,6 +34,9 @@ public sealed class ApproveActivationCommandHandler(
         if (!activateResult.IsSuccess)
             return activateResult;
 
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            adminId, "ActivationApproved", "User", request.UserId.ToString(), metadata: null, AuditSource.Web));
+
         await notifier.NotifyUserActivatedAsync(request.UserId, cancellationToken);
         await telegramNotifier.NotifyUserAsync(request.UserId, "✅ Ваш аккаунт активирован администратором.", cancellationToken);
         return Result.Success();

backend/src/PnvPanel.Application/Admin/Activation/RejectActivationCommandHandler.cs

@@ -5,6 +5,7 @@ using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
 using PnvPanel.Domain.Activation;
+using PnvPanel.Domain.Audit;
 
 namespace PnvPanel.Application.Admin.Activation;
 
@@ -26,6 +27,10 @@ public sealed class RejectActivationCommandHandler(IAppDbContext dbContext, ICur
             return Result.Failure(ActivationErrors.AlreadyDecided);
 
         request.Reject(adminId, command.Reason);
+
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            adminId, "ActivationRejected", "User", request.UserId.ToString(), metadata: null, AuditSource.Web));
+
         return Result.Success();
     }
 }

backend/src/PnvPanel.Application/Admin/Inbounds/PublishInboundCommandHandler.cs

@@ -2,10 +2,11 @@ using Microsoft.EntityFrameworkCore;
 using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
 
 namespace PnvPanel.Application.Admin.Inbounds;
 
-public sealed class PublishInboundCommandHandler(IAppDbContext dbContext)
+public sealed class PublishInboundCommandHandler(IAppDbContext dbContext, ICurrentUser currentUser)
     : ICommandHandler<PublishInboundCommand, Result<InboundDto>>
 {
     public async Task<Result<InboundDto>> Handle(PublishInboundCommand command, CancellationToken cancellationToken)
@@ -19,6 +20,10 @@ public sealed class PublishInboundCommandHandler(IAppDbContext dbContext)
         else
             inbound.Unpublish();
 
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            currentUser.UserId, command.IsPublished ? "InboundPublished" : "InboundUnpublished",
+            "Inbound", inbound.Id.ToString(), metadata: null, AuditSource.Web));
+
         return Result.Success(InboundDto.FromDomain(inbound));
     }
 }

backend/src/PnvPanel.Application/Admin/Nodes/DeleteNodeCommandHandler.cs

@@ -2,10 +2,11 @@ using Microsoft.EntityFrameworkCore;
 using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
 
 namespace PnvPanel.Application.Admin.Nodes;
 
-public sealed class DeleteNodeCommandHandler(IAppDbContext dbContext, IXuiPanelGateway gateway)
+public sealed class DeleteNodeCommandHandler(IAppDbContext dbContext, IXuiPanelGateway gateway, ICurrentUser currentUser)
     : ICommandHandler<DeleteNodeCommand, Result>
 {
     public async Task<Result> Handle(DeleteNodeCommand command, CancellationToken cancellationToken)
@@ -19,6 +20,9 @@ public sealed class DeleteNodeCommandHandler(IAppDbContext dbContext, IXuiPanelG
         dbContext.Nodes.Remove(node);
         gateway.InvalidateClient(node.Id);
 
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            currentUser.UserId, "NodeDeleted", "Node", node.Id.ToString(), metadata: null, AuditSource.Web));
+
         return Result.Success();
     }
 }

backend/src/PnvPanel.Application/Admin/Nodes/RegisterNodeCommandHandler.cs

@@ -1,11 +1,13 @@
 using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
 using PnvPanel.Domain.Nodes;
 
 namespace PnvPanel.Application.Admin.Nodes;
 
-public sealed class RegisterNodeCommandHandler(IAppDbContext dbContext, IXuiPanelGateway gateway, ISecretProtector secretProtector)
+public sealed class RegisterNodeCommandHandler(
+    IAppDbContext dbContext, IXuiPanelGateway gateway, ISecretProtector secretProtector, ICurrentUser currentUser)
     : ICommandHandler<RegisterNodeCommand, Result<NodeDto>>
 {
     public Task<Result<NodeDto>> Handle(RegisterNodeCommand command, CancellationToken cancellationToken)
@@ -21,6 +23,8 @@ public sealed class RegisterNodeCommandHandler(IAppDbContext dbContext, IXuiPane
         var node = Node.Register(command.Name, baseAddress, credentials, command.Location);
 
         dbContext.Nodes.Add(node);
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            currentUser.UserId, "NodeRegistered", "Node", node.Id.ToString(), metadata: null, AuditSource.Web));
 
         return Task.FromResult(Result.Success(NodeDto.FromDomain(node)));
     }

backend/src/PnvPanel.Application/Admin/Nodes/UpdateNodeCommandHandler.cs

@@ -2,11 +2,13 @@ using Microsoft.EntityFrameworkCore;
 using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
 using PnvPanel.Domain.Nodes;
 
 namespace PnvPanel.Application.Admin.Nodes;
 
-public sealed class UpdateNodeCommandHandler(IAppDbContext dbContext, IXuiPanelGateway gateway, ISecretProtector secretProtector)
+public sealed class UpdateNodeCommandHandler(
+    IAppDbContext dbContext, IXuiPanelGateway gateway, ISecretProtector secretProtector, ICurrentUser currentUser)
     : ICommandHandler<UpdateNodeCommand, Result<NodeDto>>
 {
     public async Task<Result<NodeDto>> Handle(UpdateNodeCommand command, CancellationToken cancellationToken)
@@ -28,6 +30,9 @@ public sealed class UpdateNodeCommandHandler(IAppDbContext dbContext, IXuiPanelG
             gateway.InvalidateClient(node.Id);
         }
 
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            currentUser.UserId, "NodeUpdated", "Node", node.Id.ToString(), metadata: null, AuditSource.Web));
+
         return Result.Success(NodeDto.FromDomain(node));
     }
 }

backend/src/PnvPanel.Application/Admin/Users/ChangeUserRoleCommandHandler.cs

@@ -1,11 +1,23 @@
 using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Application.Common.Messaging;
 using PnvPanel.Application.Common.Models;
+using PnvPanel.Domain.Audit;
 
 namespace PnvPanel.Application.Admin.Users;
 
-public sealed class ChangeUserRoleCommandHandler(IRoleService roleService) : ICommandHandler<ChangeUserRoleCommand, Result>
+public sealed class ChangeUserRoleCommandHandler(IRoleService roleService, IAppDbContext dbContext, ICurrentUser currentUser)
+    : ICommandHandler<ChangeUserRoleCommand, Result>
 {
-    public Task<Result> Handle(ChangeUserRoleCommand command, CancellationToken cancellationToken)
-        => roleService.ChangeUserRoleAsync(command.UserId, command.RoleId, cancellationToken);
+    public async Task<Result> Handle(ChangeUserRoleCommand command, CancellationToken cancellationToken)
+    {
+        var result = await roleService.ChangeUserRoleAsync(command.UserId, command.RoleId, cancellationToken);
+        if (!result.IsSuccess)
+            return result;
+
+        dbContext.AuditLogs.Add(AuditLog.Create(
+            currentUser.UserId, "UserRoleChanged", "User", command.UserId.ToString(),
+            metadata: $"{{\"roleId\":\"{command.RoleId}\"}}", AuditSource.Web));
+
+        return result;
+    }
 }

backend/src/PnvPanel.Application/Common/Interfaces/IIdentityService.cs

@@ -4,7 +4,8 @@ namespace PnvPanel.Application.Common.Interfaces;
 
 public sealed record AuthenticatedUser(Guid Id, string UserName, string Role);
 
-public sealed record CurrentUserProfile(Guid Id, string UserName, Guid RoleId, string Role, bool IsActivated, bool IsBlocked, int MaxConfigs);
+public sealed record CurrentUserProfile(
+    Guid Id, string UserName, Guid RoleId, string Role, bool IsActivated, bool IsBlocked, int MaxConfigs, string SubscriptionToken);
 
 public sealed record UserSummaryDto(Guid Id, string UserName, string Role, bool IsActivated, bool IsBlocked, DateTimeOffset? ActivatedAt);
 

backend/src/PnvPanel.Application/Configs/GetMySubscription/GetMySubscriptionQuery.cs

@@ -0,0 +1,9 @@
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Configs.GetMySubscription;
+
+public sealed record GetMySubscriptionQuery : IQuery<Result<MySubscriptionDto>>;
+
+/// <summary>SubscriptionToken — Api-слой строит из него абсолютный URL (знает scheme/host запроса), см. GetConfigLinkQuery.</summary>
+public sealed record MySubscriptionDto(string SubscriptionToken);

backend/src/PnvPanel.Application/Configs/GetMySubscription/GetMySubscriptionQueryHandler.cs

@@ -0,0 +1,22 @@
+using PnvPanel.Application.Auth;
+using PnvPanel.Application.Common.Interfaces;
+using PnvPanel.Application.Common.Messaging;
+using PnvPanel.Application.Common.Models;
+
+namespace PnvPanel.Application.Configs.GetMySubscription;
+
+public sealed class GetMySubscriptionQueryHandler(IIdentityService identityService, ICurrentUser currentUser)
+    : IQueryHandler<GetMySubscriptionQuery, Result<MySubscriptionDto>>
+{
+    public async Task<Result<MySubscriptionDto>> Handle(GetMySubscriptionQuery query, CancellationToken cancellationToken)
+    {
+        if (currentUser.UserId is not { } userId)
+            return Result.Failure<MySubscriptionDto>(AuthErrors.Unauthorized);
+
+        var profile = await identityService.GetProfileAsync(userId, cancellationToken);
+        if (profile is null)
+            return Result.Failure<MySubscriptionDto>(AuthErrors.Unauthorized);
+
+        return Result.Success(new MySubscriptionDto(profile.SubscriptionToken));
+    }
+}

backend/src/PnvPanel.Infrastructure/DependencyInjection.cs

@@ -26,10 +26,12 @@ public static class DependencyInjection
 {
     public static IServiceCollection AddInfrastructure(this IServiceCollection services, IConfiguration configuration)
     {
-        var connectionString = configuration["ConnectionStrings:Default"]
-            ?? throw new InvalidOperationException("Строка подключения 'ConnectionStrings:Default' не сконфигурирована.");
-
-        services.AddDbContext<AppDbContext>(options => options.UseNpgsql(connectionString));
+        // Строка подключения читается лениво внутри лямбды (а не в локальную переменную сразу), иначе
+        // в тестах WebApplicationFactory.ConfigureAppConfiguration (Testcontainers-порт) не успевает
+        // примениться до регистрации DbContext — окажется закэширован дефолт из appsettings.json.
+        services.AddDbContext<AppDbContext>(options => options.UseNpgsql(
+            configuration["ConnectionStrings:Default"]
+                ?? throw new InvalidOperationException("Строка подключения 'ConnectionStrings:Default' не сконфигурирована.")));
         services.AddScoped<IAppDbContext>(sp => sp.GetRequiredService<AppDbContext>());
 
         services

backend/src/PnvPanel.Infrastructure/Identity/IdentityService.cs

@@ -59,7 +59,8 @@ internal sealed class IdentityService(UserManager<AppUser> userManager, SignInMa
             return null;
 
         var role = await GetPrimaryRoleAsync(user);
-        return new CurrentUserProfile(user.Id, user.UserName!, role.Id, role.Name!, user.IsActivated, user.IsBlocked, role.MaxConfigs);
+        return new CurrentUserProfile(
+            user.Id, user.UserName!, role.Id, role.Name!, user.IsActivated, user.IsBlocked, role.MaxConfigs, user.SubscriptionToken);
     }
 
     public async Task<Result> ChangePasswordAsync(Guid userId, string currentPassword, string newPassword, CancellationToken cancellationToken)