Add admin maintenance endpoints and file deletion functionality
CI / Backend (build + test) (push) Successful in 1m21s
CI / Frontend (lint + typecheck + build) (push) Successful in 37s

- 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.
This commit is contained in:
Leonid Pershin
2026-07-14 12:04:10 +03:00
parent 9a6540a266
commit 8dfeb05912
15 changed files with 329 additions and 3 deletions
@@ -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' })
}
+21
View File
@@ -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,
+1
View File
@@ -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() {
+47
View File
@@ -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>
)
}
+4
View File
@@ -270,6 +270,10 @@ export type TicketSummaryDto = {
messagePreview: string | null
}
export type DeleteClosedTicketsResponseDto = {
deletedCount: number
}
export type TicketDetailDto = {
id: string
userId: string
+22 -2
View File
@@ -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',