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.Api/Program.cs

@@ -1,13 +1,19 @@
 using Microsoft.AspNetCore.HttpOverrides;
 using Microsoft.AspNetCore.RateLimiting;
+using Microsoft.Extensions.Options;
 using PnvPanel.Api.Common;
 using PnvPanel.Api.Endpoints;
+using PnvPanel.Api.Hubs;
+using PnvPanel.Api.Telegram;
 using PnvPanel.Application;
+using PnvPanel.Application.Common.Interfaces;
 using PnvPanel.Infrastructure;
 using PnvPanel.Infrastructure.Identity;
 using PnvPanel.Infrastructure.Persistence;
+using PnvPanel.Infrastructure.Telegram;
 using Scalar.AspNetCore;
 using Serilog;
+using Telegram.Bot;
 
 var builder = WebApplication.CreateBuilder(args);
 
@@ -29,6 +35,22 @@ builder.Services.AddHttpContextAccessor();
 builder.Services.AddApplication();
 builder.Services.AddInfrastructure(builder.Configuration);
 
+builder.Services.AddSignalR();
+// В Api, не в Infrastructure — реализации нужен IHubContext<PanelHub>, а Hub определён здесь же.
+builder.Services.AddSingleton<IRealtimeNotifier, SignalRRealtimeNotifier>();
+
+// Telegram-бот: presentation-адаптер, хостится в процессе Api (long polling). Клиент регистрируем
+// всегда (даже с пустым токеном) — TelegramBotHostedService сам решает не стартовать без токена.
+builder.Services.AddSingleton<ITelegramBotClient>(sp =>
+{
+    var options = sp.GetRequiredService<IOptions<TelegramOptions>>();
+    return new TelegramBotClient(options.Value.BotToken ?? string.Empty);
+});
+// Scoped — зависит от IIdentityService (scoped), не Singleton.
+builder.Services.AddScoped<ITelegramNotifier, TelegramNotifier>();
+builder.Services.AddSingleton<PnvBotUpdateHandler>();
+builder.Services.AddHostedService<TelegramBotHostedService>();
+
 builder.Services.AddRateLimiter(options =>
 {
     options.AddFixedWindowLimiter(RateLimiting.AuthPolicy, limiterOptions =>
@@ -74,6 +96,12 @@ app.MapInboundEndpoints();
 app.MapConfigEndpoints();
 app.MapSubscriptionEndpoints();
 app.MapAppEndpoints();
+app.MapAdminUserEndpoints();
+app.MapAdminStatsEndpoints();
+app.MapAdminAppEndpoints();
+app.MapTelegramEndpoints();
+
+app.MapHub<PanelHub>("/hubs/panel");
 
 // Раздача статики SPA из wwwroot + fallback на index.html для клиентских маршрутов.
 app.UseDefaultFiles();
@@ -81,3 +109,6 @@ app.UseStaticFiles();
 app.MapFallbackToFile("index.html");
 
 app.Run();
+
+/// <summary>Делает неявный класс Program доступным для WebApplicationFactory&lt;Program&gt; в интеграционных тестах.</summary>
+public partial class Program;