Add admin maintenance endpoints and file deletion functionality

- Introduced a new `/api/admin/maintenance` route for administrative maintenance tasks, requiring admin authorization.
- Implemented the `DeleteAsync` method in `IFileStorage` to allow for the deletion of files associated with closed support tickets.
- Updated API documentation to include details about the new maintenance operations and their effects on closed tickets.
- Enhanced frontend routing to include the new maintenance section in the admin panel, improving navigation for administrators.
- Added localization support for maintenance-related actions in both Russian and English.

frontend/src/features/admin/maintenance/api.ts

@@ -0,0 +1,6 @@
+import { apiRequest } from '@/shared/api/client'
+import type { DeleteClosedTicketsResponseDto } from '@/shared/api/types'
+
+export function deleteClosedTickets() {
+  return apiRequest<DeleteClosedTicketsResponseDto>('/admin/maintenance/tickets/closed', { method: 'DELETE' })
+}

frontend/src/routeTree.gen.ts

@@ -24,6 +24,7 @@ import { Route as AdminSupportRouteImport } from './routes/admin/support'
 import { Route as AdminRolesRouteImport } from './routes/admin/roles'
 import { Route as AdminNodesRouteImport } from './routes/admin/nodes'
 import { Route as AdminNewsRouteImport } from './routes/admin/news'
+import { Route as AdminMaintenanceRouteImport } from './routes/admin/maintenance'
 import { Route as AdminConfigsRouteImport } from './routes/admin/configs'
 import { Route as AdminAuditRouteImport } from './routes/admin/audit'
 import { Route as AdminAppsRouteImport } from './routes/admin/apps'
@@ -104,6 +105,11 @@ const AdminNewsRoute = AdminNewsRouteImport.update({
   path: '/news',
   getParentRoute: () => AdminRoute,
 } as any)
+const AdminMaintenanceRoute = AdminMaintenanceRouteImport.update({
+  id: '/maintenance',
+  path: '/maintenance',
+  getParentRoute: () => AdminRoute,
+} as any)
 const AdminConfigsRoute = AdminConfigsRouteImport.update({
   id: '/configs',
   path: '/configs',
@@ -139,6 +145,7 @@ export interface FileRoutesByFullPath {
   '/admin/apps': typeof AdminAppsRoute
   '/admin/audit': typeof AdminAuditRoute
   '/admin/configs': typeof AdminConfigsRoute
+  '/admin/maintenance': typeof AdminMaintenanceRoute
   '/admin/news': typeof AdminNewsRoute
   '/admin/nodes': typeof AdminNodesRoute
   '/admin/roles': typeof AdminRolesRoute
@@ -159,6 +166,7 @@ export interface FileRoutesByTo {
   '/admin/apps': typeof AdminAppsRoute
   '/admin/audit': typeof AdminAuditRoute
   '/admin/configs': typeof AdminConfigsRoute
+  '/admin/maintenance': typeof AdminMaintenanceRoute
   '/admin/news': typeof AdminNewsRoute
   '/admin/nodes': typeof AdminNodesRoute
   '/admin/roles': typeof AdminRolesRoute
@@ -181,6 +189,7 @@ export interface FileRoutesById {
   '/admin/apps': typeof AdminAppsRoute
   '/admin/audit': typeof AdminAuditRoute
   '/admin/configs': typeof AdminConfigsRoute
+  '/admin/maintenance': typeof AdminMaintenanceRoute
   '/admin/news': typeof AdminNewsRoute
   '/admin/nodes': typeof AdminNodesRoute
   '/admin/roles': typeof AdminRolesRoute
@@ -204,6 +213,7 @@ export interface FileRouteTypes {
     | '/admin/apps'
     | '/admin/audit'
     | '/admin/configs'
+    | '/admin/maintenance'
     | '/admin/news'
     | '/admin/nodes'
     | '/admin/roles'
@@ -224,6 +234,7 @@ export interface FileRouteTypes {
     | '/admin/apps'
     | '/admin/audit'
     | '/admin/configs'
+    | '/admin/maintenance'
     | '/admin/news'
     | '/admin/nodes'
     | '/admin/roles'
@@ -245,6 +256,7 @@ export interface FileRouteTypes {
     | '/admin/apps'
     | '/admin/audit'
     | '/admin/configs'
+    | '/admin/maintenance'
     | '/admin/news'
     | '/admin/nodes'
     | '/admin/roles'
@@ -372,6 +384,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof AdminNewsRouteImport
       parentRoute: typeof AdminRoute
     }
+    '/admin/maintenance': {
+      id: '/admin/maintenance'
+      path: '/maintenance'
+      fullPath: '/admin/maintenance'
+      preLoaderRoute: typeof AdminMaintenanceRouteImport
+      parentRoute: typeof AdminRoute
+    }
     '/admin/configs': {
       id: '/admin/configs'
       path: '/configs'
@@ -408,6 +427,7 @@ interface AdminRouteChildren {
   AdminAppsRoute: typeof AdminAppsRoute
   AdminAuditRoute: typeof AdminAuditRoute
   AdminConfigsRoute: typeof AdminConfigsRoute
+  AdminMaintenanceRoute: typeof AdminMaintenanceRoute
   AdminNewsRoute: typeof AdminNewsRoute
   AdminNodesRoute: typeof AdminNodesRoute
   AdminRolesRoute: typeof AdminRolesRoute
@@ -421,6 +441,7 @@ const AdminRouteChildren: AdminRouteChildren = {
   AdminAppsRoute: AdminAppsRoute,
   AdminAuditRoute: AdminAuditRoute,
   AdminConfigsRoute: AdminConfigsRoute,
+  AdminMaintenanceRoute: AdminMaintenanceRoute,
   AdminNewsRoute: AdminNewsRoute,
   AdminNodesRoute: AdminNodesRoute,
   AdminRolesRoute: AdminRolesRoute,

frontend/src/routes/admin.tsx

@@ -16,6 +16,7 @@ const TABS = [
   { to: '/admin/news', key: 'news' },
   { to: '/admin/support', key: 'support' },
   { to: '/admin/audit', key: 'audit' },
+  { to: '/admin/maintenance', key: 'maintenance' },
 ] as const
 
 function AdminLayout() {

frontend/src/routes/admin/maintenance.tsx

@@ -0,0 +1,47 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import { useTranslation } from 'react-i18next'
+import { toast } from '@/shared/ui/toast-store'
+import { Button } from '@/shared/ui/button'
+import { Card, CardContent, CardHeader, CardTitle } from '@/shared/ui/card'
+import { deleteClosedTickets } from '@/features/admin/maintenance/api'
+
+export const Route = createFileRoute('/admin/maintenance')({ component: AdminMaintenancePage })
+
+function AdminMaintenancePage() {
+  const { t } = useTranslation()
+  const queryClient = useQueryClient()
+
+  const deleteClosedTicketsMutation = useMutation({
+    mutationFn: deleteClosedTickets,
+    onSuccess: async (data) => {
+      toast.success(t('admin.maintenance.closedTickets.deleted', { count: data.deletedCount }))
+      await queryClient.invalidateQueries({ queryKey: ['admin-tickets'] })
+    },
+    onError: () => toast.error(t('auth.genericError')),
+  })
+
+  return (
+    <div className="flex flex-col gap-4">
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base">{t('admin.maintenance.closedTickets.title')}</CardTitle>
+        </CardHeader>
+        <CardContent className="flex flex-col gap-3">
+          <p className="text-sm text-muted-foreground">{t('admin.maintenance.closedTickets.description')}</p>
+          <div>
+            <Button
+              variant="outline"
+              disabled={deleteClosedTicketsMutation.isPending}
+              onClick={() => {
+                if (confirm(t('admin.maintenance.closedTickets.confirm'))) deleteClosedTicketsMutation.mutate()
+              }}
+            >
+              {t('admin.maintenance.closedTickets.action')}
+            </Button>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

frontend/src/shared/api/types.ts

@@ -270,6 +270,10 @@ export type TicketSummaryDto = {
   messagePreview: string | null
 }
 
+export type DeleteClosedTicketsResponseDto = {
+  deletedCount: number
+}
+
 export type TicketDetailDto = {
   id: string
   userId: string

frontend/src/shared/lib/i18n.ts

@@ -196,8 +196,9 @@ const resources = {
           nodes: 'Ноды',
           apps: 'Приложения',
           news: 'Новости',
-          support: 'Поддержка',
+          support: 'Тикеты',
           audit: 'Аудит',
+          maintenance: 'Обслуживание',
         },
         users: {
           searchPlaceholder: 'Поиск по имени пользователя',
@@ -345,6 +346,15 @@ const resources = {
           source: 'Источник',
           empty: 'Журнал аудита пуст.',
         },
+        maintenance: {
+          closedTickets: {
+            title: 'Закрытые обращения',
+            description: 'Удалить все закрытые обращения вместе с перепиской и вложениями (файлами). Действие необратимо.',
+            action: 'Удалить закрытые обращения',
+            confirm: 'Удалить все закрытые обращения и файлы в них? Действие необратимо.',
+            deleted: 'Удалено обращений: {{count}}.',
+          },
+        },
         stats: {
           totalUsers: 'Всего пользователей',
           activatedUsers: 'Активировано',
@@ -552,8 +562,9 @@ const resources = {
           nodes: 'Nodes',
           apps: 'Apps',
           news: 'News',
-          support: 'Support',
+          support: 'Tickets',
           audit: 'Audit',
+          maintenance: 'Maintenance',
         },
         users: {
           searchPlaceholder: 'Search by username',
@@ -701,6 +712,15 @@ const resources = {
           source: 'Source',
           empty: 'The audit log is empty.',
         },
+        maintenance: {
+          closedTickets: {
+            title: 'Closed tickets',
+            description: 'Delete all closed tickets along with their comments and attachments (files). This cannot be undone.',
+            action: 'Delete closed tickets',
+            confirm: 'Delete all closed tickets and their files? This cannot be undone.',
+            deleted: 'Deleted tickets: {{count}}.',
+          },
+        },
         stats: {
           totalUsers: 'Total users',
           activatedUsers: 'Activated',