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.

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

@@ -7,6 +7,7 @@ using PnvPanel.Domain.Configs;
 using PnvPanel.Domain.Inbounds;
 using PnvPanel.Domain.News;
 using PnvPanel.Domain.Nodes;
+using PnvPanel.Domain.Support;
 using PnvPanel.Domain.Telegram;
 
 namespace PnvPanel.Application.Common.Interfaces;
@@ -33,6 +34,12 @@ public interface IAppDbContext
 
     DbSet<NewsPost> NewsPosts { get; }
 
+    DbSet<SupportTicket> SupportTickets { get; }
+
+    DbSet<TicketComment> TicketComments { get; }
+
+    DbSet<TicketAttachment> TicketAttachments { get; }
+
     /// <summary>Нужен для advisory-lock при проверке квоты конфигов (см. CreateVpnConfigCommandHandler).</summary>
     DatabaseFacade Database { get; }
 

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

@@ -0,0 +1,15 @@
+namespace PnvPanel.Application.Common.Interfaces;
+
+/// <summary>
+/// Хранилище бинарных вложений (скриншоты к тикетам поддержки) — физический диск в контейнере
+/// (см. DiskFileStorage), volume в docker-compose. Реализация сама генерирует непрозрачное имя файла
+/// на диске (не доверяет пользовательскому имени) и возвращает его — это же имя передаётся обратно
+/// в OpenReadAsync, вызывающая сторона его не парсит и не строит из него пути.
+/// </summary>
+public interface IFileStorage
+{
+    Task<string> SaveAsync(Stream content, CancellationToken cancellationToken);
+
+    /// <summary>Null, если файла с таким именем нет на диске (например, удалён вручную).</summary>
+    Task<Stream?> OpenReadAsync(string storedFileName, CancellationToken cancellationToken);
+}

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

@@ -1,5 +1,6 @@
 using PnvPanel.Domain.Configs;
 using PnvPanel.Domain.Nodes;
+using PnvPanel.Domain.Support;
 
 namespace PnvPanel.Application.Common.Interfaces;
 
@@ -24,4 +25,9 @@ public interface IRealtimeNotifier
 
     /// <summary>Единственное широковещательное событие (всем подключенным клиентам), а не по группе.</summary>
     Task NotifyNewsPublishedAsync(Guid postId, string title, DateTimeOffset createdAt, CancellationToken cancellationToken);
+
+    Task NotifyTicketCreatedAsync(Guid ticketId, Guid userId, string userName, TicketType type, CancellationToken cancellationToken);
+
+    /// <summary>Новый комментарий или смена статуса — пушится автору тикета (не всем участникам треда).</summary>
+    Task NotifyTicketUpdatedAsync(Guid ticketId, Guid userId, CancellationToken cancellationToken);
 }

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

@@ -12,4 +12,12 @@ public interface ITelegramNotifier
 
     /// <summary>Личное сообщение пользователю, если у него привязан Telegram (иначе no-op).</summary>
     Task NotifyUserAsync(Guid userId, string message, CancellationToken cancellationToken);
+
+    /// <summary>Баг-репорт/предложение — только кнопка-ссылка на сайт (переписка и картинки — там),
+    /// без инлайн-действий.</summary>
+    Task NotifyAdminsBugReportCreatedAsync(Guid ticketId, string userName, string message, CancellationToken cancellationToken);
+
+    /// <summary>Заявка на роль — инлайн-кнопки «Одобрить/Отклонить», решается полностью в Telegram.</summary>
+    Task NotifyAdminsRoleRequestCreatedAsync(
+        Guid ticketId, string userName, string roleDescription, string justification, CancellationToken cancellationToken);
 }