Add Telegram bot integration and enhance user management features

- Introduced Telegram.Bot package for bot functionality.
- Updated user management to include Telegram linking and blocking features.
- Enhanced activation request handling with notifications via Telegram.
- Added new database entities for Telegram link tokens and login requests.
- Implemented traffic synchronization for client stats in the XuiPanelGateway.
- Updated application structure to support new test projects and improved dependency injection for Telegram services.

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

@@ -2,9 +2,11 @@ using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using PnvPanel.Domain.Activation;
 using PnvPanel.Domain.Apps;
+using PnvPanel.Domain.Audit;
 using PnvPanel.Domain.Configs;
 using PnvPanel.Domain.Inbounds;
 using PnvPanel.Domain.Nodes;
+using PnvPanel.Domain.Telegram;
 
 namespace PnvPanel.Application.Common.Interfaces;
 
@@ -12,12 +14,20 @@ public interface IAppDbContext
 {
     DbSet<ActivationRequest> ActivationRequests { get; }
 
+    DbSet<AuditLog> AuditLogs { get; }
+
+    DbSet<TelegramLinkToken> TelegramLinkTokens { get; }
+
+    DbSet<TelegramLoginRequest> TelegramLoginRequests { get; }
+
     DbSet<Node> Nodes { get; }
 
     DbSet<Inbound> Inbounds { get; }
 
     DbSet<VpnConfig> VpnConfigs { get; }
 
+    DbSet<TrafficSample> TrafficSamples { get; }
+
     DbSet<ClientApp> ClientApps { get; }
 
     /// <summary>Нужен для advisory-lock при проверке квоты конфигов (см. CreateVpnConfigCommandHandler).</summary>

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

@@ -6,3 +6,13 @@ public interface ICurrentUser
     string? UserName { get; }
     bool IsAuthenticated { get; }
 }
+
+/// <summary>
+/// Только для фоновых/не-HTTP контекстов (Telegram-бот): задаёт "текущего" пользователя в рамках
+/// одного DI-scope, чтобы переиспользовать те же команды/запросы, что и веб (которые читают
+/// ICurrentUser). Реализуется тем же классом, что и ICurrentUser — см. CurrentUser (Infrastructure).
+/// </summary>
+public interface ICurrentUserSetter
+{
+    void SetUser(Guid userId, string userName);
+}

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

@@ -4,7 +4,13 @@ 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, int MaxConfigs);
+public sealed record CurrentUserProfile(Guid Id, string UserName, Guid RoleId, string Role, bool IsActivated, bool IsBlocked, int MaxConfigs);
+
+public sealed record UserSummaryDto(Guid Id, string UserName, string Role, bool IsActivated, bool IsBlocked, DateTimeOffset? ActivatedAt);
+
+public sealed record UserStatsDto(int Total, int Activated);
+
+public sealed record TelegramLinkInfo(bool IsLinked, long? TelegramUserId, string? Username);
 
 public interface IIdentityService
 {
@@ -30,4 +36,24 @@ public interface IIdentityService
 
     /// <summary>Для агрегированной подписки /sub/{userToken} (все активные конфиги пользователя).</summary>
     Task<Guid?> FindUserIdBySubscriptionTokenAsync(string token, CancellationToken cancellationToken);
+
+    /// <summary>Блокировка: вход запрещён (см. ValidateCredentialsAsync). Конфиги гасит вызывающая сторона.</summary>
+    Task<Result> BlockUserAsync(Guid userId, CancellationToken cancellationToken);
+
+    Task<Result> UnblockUserAsync(Guid userId, CancellationToken cancellationToken);
+
+    /// <summary>Сброс пароля админом — для пользователей без привязанного Telegram (M7).</summary>
+    Task<Result> ResetPasswordAsync(Guid userId, string newPassword, CancellationToken cancellationToken);
+
+    Task<PagedList<UserSummaryDto>> ListUsersAsync(int page, int pageSize, string? search, CancellationToken cancellationToken);
+
+    Task<UserStatsDto> GetUserStatsAsync(CancellationToken cancellationToken);
+
+    Task<Result> LinkTelegramAsync(Guid userId, long telegramUserId, string? telegramUsername, CancellationToken cancellationToken);
+
+    Task<Result> UnlinkTelegramAsync(Guid userId, CancellationToken cancellationToken);
+
+    Task<Guid?> FindUserIdByTelegramUserIdAsync(long telegramUserId, CancellationToken cancellationToken);
+
+    Task<TelegramLinkInfo> GetTelegramLinkInfoAsync(Guid userId, CancellationToken cancellationToken);
 }

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

@@ -0,0 +1,24 @@
+using PnvPanel.Domain.Configs;
+using PnvPanel.Domain.Nodes;
+
+namespace PnvPanel.Application.Common.Interfaces;
+
+/// <summary>
+/// Пуш событий через SignalR. Реализация (SignalRRealtimeNotifier) живёт в Api (не в Infrastructure) —
+/// ей нужен IHubContext&lt;PanelHub&gt;, а Hub, будучи транспортным механизмом, определён в Api;
+/// Infrastructure не может ссылаться на Api (обратное направление зависимостей).
+/// </summary>
+public interface IRealtimeNotifier
+{
+    Task NotifyConfigTrafficUpdatedAsync(
+        Guid userId, Guid configId, long usedUpBytes, long usedDownBytes, CancellationToken cancellationToken);
+
+    Task NotifyConfigStatusChangedAsync(Guid userId, Guid configId, ConfigStatus status, CancellationToken cancellationToken);
+
+    Task NotifyNodeStatusChangedAsync(Guid nodeId, NodeStatus status, DateTimeOffset? lastSyncAt, CancellationToken cancellationToken);
+
+    Task NotifyActivationRequestedAsync(
+        Guid requestId, Guid userId, string userName, string? comment, DateTimeOffset createdAt, CancellationToken cancellationToken);
+
+    Task NotifyUserActivatedAsync(Guid userId, CancellationToken cancellationToken);
+}

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

@@ -0,0 +1,15 @@
+namespace PnvPanel.Application.Common.Interfaces;
+
+/// <summary>
+/// Проактивные DM-уведомления через бота. Реализация — в Api (нужен ITelegramBotClient,
+/// который там же и регистрируется), аналогично IRealtimeNotifier/PanelHub. Если BotToken не
+/// задан — реализация тихо не отправляет ничего (бот работает без Telegram).
+/// </summary>
+public interface ITelegramNotifier
+{
+    Task NotifyAdminsActivationRequestedAsync(
+        Guid requestId, string userName, string? comment, CancellationToken cancellationToken);
+
+    /// <summary>Личное сообщение пользователю, если у него привязан Telegram (иначе no-op).</summary>
+    Task NotifyUserAsync(Guid userId, string message, CancellationToken cancellationToken);
+}

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

@@ -8,6 +8,8 @@ public sealed record RemoteInboundInfo(string RemoteInboundId, VpnProtocol Proto
 
 public sealed record NodeProbeResult(bool IsReachable, string? ErrorMessage);
 
+public sealed record ClientTrafficInfo(long UpBytes, long DownBytes);
+
 /// <summary>
 /// Оркестрация панелей 3x-ui через ThreeXui.Net. Один BaseAddress в библиотеке, но нод много —
 /// реализация держит клиента per-node (кэш по NodeId), см. XuiPanelGateway.
@@ -38,4 +40,11 @@ public interface IXuiPanelGateway
     Task<Result<string>> BuildConnectionStringAsync(
         Node node, Inbound inbound, string clientExternalId, string clientName, string publicHost,
         CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Трафик по клиентам инбаунда, ключ — ClientEmail. ThreeXui.Net не даёт типизированного метода
+    /// для этого — извлекается из сырого clientStats[] в RawInboundJson (стандартное поле 3x-ui API).
+    /// </summary>
+    Task<Result<IReadOnlyDictionary<string, ClientTrafficInfo>>> GetClientTrafficAsync(
+        Node node, string inboundRemoteId, CancellationToken cancellationToken);
 }