Refactor project files for improved readability and structure

- Cleaned up whitespace in Directory.Build.props and Directory.Packages.props for consistency.
- Reformatted project file references in PnvPanel.Api.csproj for better clarity.
- Enhanced code readability in various endpoint files by adjusting line breaks and indentation.
- Standardized method signatures and improved formatting in ResultExtensions and multiple endpoint classes for better maintainability.

backend/src/PnvPanel.Api/Telegram/TelegramNotifier.cs

@@ -8,30 +8,49 @@ using Telegram.Bot.Types.ReplyMarkups;
 
 namespace PnvPanel.Api.Telegram;
 
-internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentityService identityService, IOptions<TelegramOptions> options)
-    : ITelegramNotifier
+internal sealed class TelegramNotifier(
+    ITelegramBotClient botClient,
+    IIdentityService identityService,
+    IOptions<TelegramOptions> options
+) : ITelegramNotifier
 {
     public async Task NotifyAdminsActivationRequestedAsync(
-        Guid requestId, string userName, string? comment, CancellationToken cancellationToken)
+        Guid requestId,
+        string userName,
+        string? comment,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
 
-        var text = $"🆕 Запрос на активацию от <b>{Escape(userName)}</b>"
-            + (string.IsNullOrWhiteSpace(comment) ? string.Empty : $"\nКомментарий: {Escape(comment)}");
+        var text =
+            $"🆕 Запрос на активацию от <b>{Escape(userName)}</b>"
+            + (
+                string.IsNullOrWhiteSpace(comment)
+                    ? string.Empty
+                    : $"\nКомментарий: {Escape(comment)}"
+            );
 
-        var keyboard = new InlineKeyboardMarkup(new[]
-        {
-            InlineKeyboardButton.WithCallbackData("✅ Активировать", $"act:approve:{requestId}"),
-            InlineKeyboardButton.WithCallbackData("❌ Отклонить", $"act:reject:{requestId}"),
-        });
+        var keyboard = new InlineKeyboardMarkup(
+            new[]
+            {
+                InlineKeyboardButton.WithCallbackData("✅ Активировать", $"act:approve:{requestId}"),
+                InlineKeyboardButton.WithCallbackData("❌ Отклонить", $"act:reject:{requestId}"),
+            }
+        );
 
         foreach (var adminId in options.Value.ParseAdminTelegramUserIds())
         {
             try
             {
                 await botClient.SendMessage(
-                    adminId, text, parseMode: ParseMode.Html, replyMarkup: keyboard, cancellationToken: cancellationToken);
+                    adminId,
+                    text,
+                    parseMode: ParseMode.Html,
+                    replyMarkup: keyboard,
+                    cancellationToken: cancellationToken
+                );
             }
             catch
             {
@@ -40,20 +59,28 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         }
     }
 
-    public async Task NotifyAdminsBugReportCreatedAsync(Guid ticketId, string userName, string message, CancellationToken cancellationToken)
+    public async Task NotifyAdminsBugReportCreatedAsync(
+        Guid ticketId,
+        string userName,
+        string message,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
 
         var preview = message.Length > 300 ? message[..300] + "…" : message;
-        var text = $"🐞 Новый тикет (баг/предложение) от <b>{Escape(userName)}</b>\n{Escape(preview)}";
+        var text =
+            $"🐞 Новый тикет (баг/предложение) от <b>{Escape(userName)}</b>\n{Escape(preview)}";
 
         // Только ссылка на сайт — переписка и картинки удобнее там, инлайн-действий для баг-тикетов нет.
         InlineKeyboardMarkup? keyboard = null;
         if (!string.IsNullOrWhiteSpace(options.Value.PublicSiteUrl))
         {
             var url = $"{options.Value.PublicSiteUrl.TrimEnd('/')}/admin/support?ticket={ticketId}";
-            keyboard = new InlineKeyboardMarkup(new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) });
+            keyboard = new InlineKeyboardMarkup(
+                new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) }
+            );
         }
 
         foreach (var adminId in options.Value.ParseAdminTelegramUserIds())
@@ -61,7 +88,12 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
             try
             {
                 await botClient.SendMessage(
-                    adminId, text, parseMode: ParseMode.Html, replyMarkup: keyboard, cancellationToken: cancellationToken);
+                    adminId,
+                    text,
+                    parseMode: ParseMode.Html,
+                    replyMarkup: keyboard,
+                    cancellationToken: cancellationToken
+                );
             }
             catch
             {
@@ -71,25 +103,38 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
     }
 
     public async Task NotifyAdminsRoleRequestCreatedAsync(
-        Guid ticketId, string userName, string roleDescription, string justification, CancellationToken cancellationToken)
+        Guid ticketId,
+        string userName,
+        string roleDescription,
+        string justification,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
 
-        var text = $"🆕 Заявка на роль от <b>{Escape(userName)}</b>\n{Escape(roleDescription)}\nОбоснование: {Escape(justification)}";
+        var text =
+            $"🆕 Заявка на роль от <b>{Escape(userName)}</b>\n{Escape(roleDescription)}\nОбоснование: {Escape(justification)}";
 
-        var keyboard = new InlineKeyboardMarkup(new[]
-        {
-            InlineKeyboardButton.WithCallbackData("✅ Одобрить", $"rrq:approve:{ticketId}"),
-            InlineKeyboardButton.WithCallbackData("❌ Отклонить", $"rrq:reject:{ticketId}"),
-        });
+        var keyboard = new InlineKeyboardMarkup(
+            new[]
+            {
+                InlineKeyboardButton.WithCallbackData("✅ Одобрить", $"rrq:approve:{ticketId}"),
+                InlineKeyboardButton.WithCallbackData("❌ Отклонить", $"rrq:reject:{ticketId}"),
+            }
+        );
 
         foreach (var adminId in options.Value.ParseAdminTelegramUserIds())
         {
             try
             {
                 await botClient.SendMessage(
-                    adminId, text, parseMode: ParseMode.Html, replyMarkup: keyboard, cancellationToken: cancellationToken);
+                    adminId,
+                    text,
+                    parseMode: ParseMode.Html,
+                    replyMarkup: keyboard,
+                    cancellationToken: cancellationToken
+                );
             }
             catch
             {
@@ -98,7 +143,12 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         }
     }
 
-    public async Task NotifyAdminsTicketReopenedAsync(Guid ticketId, string userName, TicketType type, CancellationToken cancellationToken)
+    public async Task NotifyAdminsTicketReopenedAsync(
+        Guid ticketId,
+        string userName,
+        TicketType type,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
@@ -110,7 +160,9 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         if (!string.IsNullOrWhiteSpace(options.Value.PublicSiteUrl))
         {
             var url = $"{options.Value.PublicSiteUrl.TrimEnd('/')}/admin/support?ticket={ticketId}";
-            keyboard = new InlineKeyboardMarkup(new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) });
+            keyboard = new InlineKeyboardMarkup(
+                new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) }
+            );
         }
 
         foreach (var adminId in options.Value.ParseAdminTelegramUserIds())
@@ -118,7 +170,12 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
             try
             {
                 await botClient.SendMessage(
-                    adminId, text, parseMode: ParseMode.Html, replyMarkup: keyboard, cancellationToken: cancellationToken);
+                    adminId,
+                    text,
+                    parseMode: ParseMode.Html,
+                    replyMarkup: keyboard,
+                    cancellationToken: cancellationToken
+                );
             }
             catch
             {
@@ -127,7 +184,10 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         }
     }
 
-    public async Task NotifyUsersNewsPublishedAsync(string title, CancellationToken cancellationToken)
+    public async Task NotifyUsersNewsPublishedAsync(
+        string title,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
@@ -138,16 +198,25 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         if (!string.IsNullOrWhiteSpace(options.Value.PublicSiteUrl))
         {
             var url = $"{options.Value.PublicSiteUrl.TrimEnd('/')}/news";
-            keyboard = new InlineKeyboardMarkup(new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) });
+            keyboard = new InlineKeyboardMarkup(
+                new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", url) }
+            );
         }
 
-        var telegramUserIds = await identityService.GetActivatedLinkedTelegramUserIdsAsync(cancellationToken);
+        var telegramUserIds = await identityService.GetActivatedLinkedTelegramUserIdsAsync(
+            cancellationToken
+        );
         foreach (var telegramUserId in telegramUserIds)
         {
             try
             {
                 await botClient.SendMessage(
-                    telegramUserId, text, parseMode: ParseMode.Html, replyMarkup: keyboard, cancellationToken: cancellationToken);
+                    telegramUserId,
+                    text,
+                    parseMode: ParseMode.Html,
+                    replyMarkup: keyboard,
+                    cancellationToken: cancellationToken
+                );
             }
             catch
             {
@@ -156,7 +225,11 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         }
     }
 
-    public async Task NotifyUserAsync(Guid userId, string message, CancellationToken cancellationToken)
+    public async Task NotifyUserAsync(
+        Guid userId,
+        string message,
+        CancellationToken cancellationToken
+    )
     {
         if (string.IsNullOrWhiteSpace(options.Value.BotToken))
             return;
@@ -167,11 +240,24 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
 
         InlineKeyboardMarkup? keyboard = null;
         if (!string.IsNullOrWhiteSpace(options.Value.PublicSiteUrl))
-            keyboard = new InlineKeyboardMarkup(new[] { InlineKeyboardButton.WithUrl("🌐 Открыть на сайте", options.Value.PublicSiteUrl) });
+            keyboard = new InlineKeyboardMarkup(
+                new[]
+                {
+                    InlineKeyboardButton.WithUrl(
+                        "🌐 Открыть на сайте",
+                        options.Value.PublicSiteUrl
+                    ),
+                }
+            );
 
         try
         {
-            await botClient.SendMessage(telegramUserId, message, replyMarkup: keyboard, cancellationToken: cancellationToken);
+            await botClient.SendMessage(
+                telegramUserId,
+                message,
+                replyMarkup: keyboard,
+                cancellationToken: cancellationToken
+            );
         }
         catch
         {
@@ -179,5 +265,6 @@ internal sealed class TelegramNotifier(ITelegramBotClient botClient, IIdentitySe
         }
     }
 
-    private static string Escape(string text) => text.Replace("&", "&amp;").Replace("<", "&lt;").Replace(">", "&gt;");
+    private static string Escape(string text) =>
+        text.Replace("&", "&amp;").Replace("<", "&lt;").Replace(">", "&gt;");
 }