Files
tnsu-approval-route/frontend/src/webparts/approvalAdmin/services/api.ts
T
gorbenko.pavel 1bf8d4ca11
Tests / frontend-test (push) Successful in 45s
Tests / backend-test (push) Successful in 1m43s
Feature/request manage server load (#22)
Co-authored-by: gorbenko.pavel <gorbenko.pavel@tansu.kz>
Reviewed-on: http://git.tnsu.kz/gorbenko.pavel/tnsu-approval-route/pulls/22
2026-09-25 06:30:59 +00:00

159 lines
7.8 KiB
TypeScript

import { IHttpClient } from './httpClient';
import {
CreateRequestTypeInput,
CreateTemplateRouteInput,
CreateTemplateRouteStepInput,
ManagedApprovalRow,
ManagedApprovalRowApi,
ManagedRequestMatrix,
ManagedRequestMatrixApi,
ManagedRequestPage,
PatchRequestTypeInput,
PatchTemplateRouteInput,
PatchTemplateRouteStepInput,
RequestListPartition,
RequestType,
RequestTypeListSeries,
ResolveTemplateRouteQuery,
ResolveTemplateRouteResult,
TemplateRoute,
TemplateRouteStep,
UpdateRequestTypeInput,
UpdateTemplateRouteInput,
UpdateTemplateRouteStepInput,
UserApprovalRow,
UserApprovalRowApi
} from '../models';
import { formatDateIso } from '../utils/date';
// Api-формы (dateIso, без отформатированного date) → формы, которыми пользуются
// экраны (ManageRequestsScreen/ManageByUserScreen) — см. requestManage.ts/
// ManagedApprovalRowApi. Единственная разница — производное поле date.
function toApprovalRow(r: ManagedApprovalRowApi): ManagedApprovalRow {
return { ...r, date: formatDateIso(r.dateIso) };
}
function toMatrix(m: ManagedRequestMatrixApi): ManagedRequestMatrix {
return { ...m, rows: m.rows.map(toApprovalRow) };
}
function toUserApprovalRow(r: UserApprovalRowApi): UserApprovalRow {
return { ...r, date: formatDateIso(r.dateIso) };
}
// Тонкий 1:1 фасад над контроллерами бэкенда:
// backend/Tnsu.ApprovalRoute.Api/Controllers/{RequestTypes,TemplateRoutes,TemplateRouteSteps}Controller.cs
export class ApprovalRouteApi {
constructor(private readonly http: IHttpClient) {}
public readonly requestTypes = {
list: (): Promise<RequestType[]> =>
this.http.get<RequestType[]>('/api/request-types'),
get: (id: number): Promise<RequestType> =>
this.http.get<RequestType>(`/api/request-types/${id}`),
create: (body: CreateRequestTypeInput): Promise<RequestType> =>
this.http.post<RequestType>('/api/request-types', body),
update: (id: number, body: UpdateRequestTypeInput): Promise<RequestType> =>
this.http.put<RequestType>(`/api/request-types/${id}`, body),
patch: (id: number, body: PatchRequestTypeInput): Promise<RequestType> =>
this.http.patch<RequestType>(`/api/request-types/${id}`, body),
remove: (id: number): Promise<void> =>
this.http.delete(`/api/request-types/${id}`),
// Серии партиций СРАЗУ по всем типам заявок (см.
// ListPartitionService.ListAllAsync) — для дашборда (счётчик партиций) и
// портала, которому нужен весь список адресов разом, а не по одному запросу
// на тип.
listsAll: (): Promise<RequestTypeListSeries[]> =>
this.http.get<RequestTypeListSeries[]>('/api/request-types/lists'),
// Вся серия партиций ОДНОГО типа заявки (архив + текущая) — нужна экрану
// редактирования заявок: заявка может лежать в любой из них, не только в
// текущей (см. requestManageService.ts).
lists: (requestTypeId: number): Promise<RequestListPartition[]> =>
this.http.get<RequestListPartition[]>(`/api/request-types/${requestTypeId}/lists`)
};
public readonly templateRoutes = {
list: (requestTypeId?: number): Promise<TemplateRoute[]> =>
this.http.get<TemplateRoute[]>('/api/template-routes', { requestTypeId }),
get: (id: number): Promise<TemplateRoute> =>
this.http.get<TemplateRoute>(`/api/template-routes/${id}`),
create: (body: CreateTemplateRouteInput): Promise<TemplateRoute> =>
this.http.post<TemplateRoute>('/api/template-routes', body),
update: (id: number, body: UpdateTemplateRouteInput): Promise<TemplateRoute> =>
this.http.put<TemplateRoute>(`/api/template-routes/${id}`, body),
patch: (id: number, body: PatchTemplateRouteInput): Promise<TemplateRoute> =>
this.http.patch<TemplateRoute>(`/api/template-routes/${id}`, body),
remove: (id: number): Promise<void> =>
this.http.delete(`/api/template-routes/${id}`),
// POST, а не GET: запрос несёт список условий (fieldValues) переменной длины —
// не ложится на плоскую query-строку (см. IHttpClient.QueryParams).
resolve: (query: ResolveTemplateRouteQuery): Promise<ResolveTemplateRouteResult> =>
this.http.post<ResolveTemplateRouteResult>('/api/template-routes/resolve', query)
};
public readonly templateRouteSteps = {
list: (routeId: number): Promise<TemplateRouteStep[]> =>
this.http.get<TemplateRouteStep[]>(`/api/template-routes/${routeId}/steps`),
get: (routeId: number, id: number): Promise<TemplateRouteStep> =>
this.http.get<TemplateRouteStep>(`/api/template-routes/${routeId}/steps/${id}`),
create: (routeId: number, body: CreateTemplateRouteStepInput): Promise<TemplateRouteStep> =>
this.http.post<TemplateRouteStep>(`/api/template-routes/${routeId}/steps`, body),
update: (routeId: number, id: number, body: UpdateTemplateRouteStepInput): Promise<TemplateRouteStep> =>
this.http.put<TemplateRouteStep>(`/api/template-routes/${routeId}/steps/${id}`, body),
patch: (routeId: number, id: number, body: PatchTemplateRouteStepInput): Promise<TemplateRouteStep> =>
this.http.patch<TemplateRouteStep>(`/api/template-routes/${routeId}/steps/${id}`, body),
remove: (routeId: number, id: number): Promise<void> =>
this.http.delete(`/api/template-routes/${routeId}/steps/${id}`),
// Сквозной поиск ПО ВСЕМ маршрутам разом (не вложен под конкретный routeId) —
// для экрана «Заявки по согласующему» (ManageByUserScreen): шаги, где
// исполнитель задан этим конкретным email, а не должностью/ролью.
listByExecutorEmail: (executorEmail: string): Promise<TemplateRouteStep[]> =>
this.http.get<TemplateRouteStep[]>('/api/template-route-steps', { executorEmail })
};
// Чтение заявок и маршрутов согласования от имени ПРИЛОЖЕНИЯ (см.
// backend/Tnsu.ApprovalRoute.Application/RequestManage/RequestManageService.cs) —
// в отличие от остальных групп выше, это НЕ CRUD над сущностями самого API:
// данные по-прежнему живут в списках SharePoint, которыми управляет
// request-portal (см. requestManageService.ts), только читаются они теперь
// не PnP-клиентом текущего пользователя, а этим бэкендом, поэтому видимость
// заявок не зависит от прав администратора на списки SharePoint.
public readonly requestManage = {
search: (requestTypeId: number, query: string, page: number, pageSize = 20): Promise<ManagedRequestPage> =>
this.http.get<ManagedRequestPage>('/api/request-manage/search', { requestTypeId, query, page, pageSize }),
matrix: (requestTypeId: number, listId: string, requestId: number): Promise<ManagedRequestMatrix> =>
this.http
.get<ManagedRequestMatrixApi>('/api/request-manage/matrix', { requestTypeId, listId, requestId })
.then(toMatrix),
byApprover: (approverEmail: string, activeStatuses: string[]): Promise<UserApprovalRow[]> =>
this.http
.get<UserApprovalRowApi[]>('/api/request-manage/by-approver', {
approverEmail,
statuses: activeStatuses.join(',')
})
.then(rows => rows.map(toUserApprovalRow))
};
}