feat: добавил формы Заявка на перемещение сотрудника и Заявка на бетон
Tests / frontend-test (push) Successful in 1m22s
Tests / frontend-test (push) Successful in 1m22s
This commit is contained in:
Тимур Городецкий
@@ -19,11 +19,12 @@ export const REQUEST_TYPES: IRequestType[] = [
|
|||||||
{ id: 'hr-unpaid-leave', categoryId: 'hr', title: 'Заявка на отпуск без содержания', icon: 'document' },
|
{ id: 'hr-unpaid-leave', categoryId: 'hr', title: 'Заявка на отпуск без содержания', icon: 'document' },
|
||||||
{ id: 'hr-dismissal', categoryId: 'hr', title: 'Заявление на увольнение', icon: 'document' },
|
{ id: 'hr-dismissal', categoryId: 'hr', title: 'Заявление на увольнение', icon: 'document' },
|
||||||
{ id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
|
{ id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
|
||||||
{ id: 'hr-transfer', categoryId: 'hr', title: 'Заявка на перемещение сотрудников', icon: 'people' },
|
{ id: 'hr-transfer', categoryId: 'hr', title: 'Заявка на перемещение сотрудника', icon: 'people' },
|
||||||
|
|
||||||
// Склад / Снабжение
|
// Склад / Снабжение
|
||||||
{ id: 'wh-tmc-transfer', categoryId: 'warehouse', title: 'СЗ на перемещение ТМЦ', icon: 'send' },
|
{ id: 'wh-tmc-transfer', categoryId: 'warehouse', title: 'СЗ на перемещение ТМЦ', icon: 'send' },
|
||||||
{ id: 'wh-service-request', categoryId: 'warehouse', title: 'Заявка на услуги', icon: 'document' }
|
{ id: 'wh-service-request', categoryId: 'warehouse', title: 'Заявка на услуги', icon: 'document' },
|
||||||
|
{ id: 'wh-concrete-request', categoryId: 'warehouse', title: 'Заявка на бетон', icon: 'vehicle' }
|
||||||
];
|
];
|
||||||
|
|
||||||
/** Заявки, относящиеся к указанной категории. */
|
/** Заявки, относящиеся к указанной категории. */
|
||||||
|
|||||||
@@ -0,0 +1,20 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.back {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: $sp-2;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
padding: 0;
|
||||||
|
border: 0;
|
||||||
|
background: transparent;
|
||||||
|
color: $navy-700;
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: color .18s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
color: $gold-600;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,331 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||||
|
import styles from './ConcreteRequestForm.module.scss';
|
||||||
|
import {
|
||||||
|
Alert,
|
||||||
|
FormCard,
|
||||||
|
InitiatorLine,
|
||||||
|
FormModeProvider,
|
||||||
|
Icon,
|
||||||
|
RequestNumber,
|
||||||
|
SubmitActions,
|
||||||
|
useRequestSubmit
|
||||||
|
} from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApprovalMatrix,
|
||||||
|
StatusBadge,
|
||||||
|
useMatrixEditor,
|
||||||
|
getPlannedMatrix,
|
||||||
|
resolveWriteListId,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId,
|
||||||
|
REQUEST_STATUS,
|
||||||
|
isEditableStatus,
|
||||||
|
IApproverToWrite,
|
||||||
|
unassignedStepMessage
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { IRequestFormProps } from '../../models/types';
|
||||||
|
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
|
||||||
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import {
|
||||||
|
approvalListTitle,
|
||||||
|
approvalListTitleForListId,
|
||||||
|
dataListTitle,
|
||||||
|
dataListTitleForListId
|
||||||
|
} from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { saveConcreteRequest, concreteRequestApprovalService } from './submit';
|
||||||
|
import { loadConcreteRequest } from './load';
|
||||||
|
import { HeaderSection } from './sections/HeaderSection';
|
||||||
|
import { ItemsSection } from './sections/ItemsSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
const ConcreteRequestForm: React.FC<IRequestFormProps> = ({
|
||||||
|
requestType,
|
||||||
|
context,
|
||||||
|
onCancel,
|
||||||
|
onSaved,
|
||||||
|
editId,
|
||||||
|
editListId,
|
||||||
|
onCodeLoaded
|
||||||
|
}) => {
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [requestId, setRequestId] = useState<number | undefined>(editId);
|
||||||
|
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
|
||||||
|
const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
|
||||||
|
const submit = useRequestSubmit();
|
||||||
|
// onCodeLoaded — колбэк родителя (RequestPortal → EditFeature): его ссылка
|
||||||
|
// может меняться на каждом рендере, поэтому в зависимости эффектов идёт
|
||||||
|
// стабильная обёртка, а не сам проп — иначе заявка перезапрашивалась бы при
|
||||||
|
// каждом рендере родителя.
|
||||||
|
const notifyCode = useStableCallback(onCodeLoaded);
|
||||||
|
// submit целиком в зависимости класть нельзя (пересоздаётся при каждой смене
|
||||||
|
// saving/error), а setError стабилен — его и берём.
|
||||||
|
const { setError: setSubmitError } = submit;
|
||||||
|
|
||||||
|
const readOnly = !isEditableStatus(requestStatus);
|
||||||
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
|
||||||
|
// editListId уже проверен в EditFeature (см. её комментарий) — если бы партиции
|
||||||
|
// не нашлось в реестре, форма сюда вообще не смонтировалась бы, поэтому здесь
|
||||||
|
// concreteRequestApprovalService можно звать не опасаясь исключения.
|
||||||
|
const approval = useMemo(() => concreteRequestApprovalService(editListId), [editListId]);
|
||||||
|
// pageUrl формы (requestType.id совпадает с ним по конвенции портала, см.
|
||||||
|
// data/requests.ts) → числовой RequestTypeId, нужный approval-route API.
|
||||||
|
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||||
|
const requestTypeId = requestTypeIdState.id;
|
||||||
|
|
||||||
|
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
loadConcreteRequest(editId, editListId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setRequestStatus(loaded.status);
|
||||||
|
setRequestCode(loaded.code || undefined);
|
||||||
|
if (loaded.code) notifyCode(loaded.code);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
setSubmitError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [editId, editListId, notifyCode, setSubmitError]);
|
||||||
|
|
||||||
|
// Новая заявка — по умолчанию «Составил» это текущий пользователь: подставляем
|
||||||
|
// его, его ФИО и организации (Employee/ByEmail — сотрудник может состоять
|
||||||
|
// сразу в нескольких организациях, ФИО берём из ПЕРВОЙ записи).
|
||||||
|
useEffect(() => {
|
||||||
|
if (editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
const user = context.pageContext.user;
|
||||||
|
setData((prev) => ({ ...prev, SiteChiefEmail: prev.SiteChiefEmail || user.email }));
|
||||||
|
getEmployeeOrganizations(context, user.email)
|
||||||
|
.then((records) => {
|
||||||
|
if (!alive) return;
|
||||||
|
setData((prev) => ({
|
||||||
|
...prev,
|
||||||
|
SiteChiefName: prev.SiteChiefName || records[0]?.fio || user.displayName || '',
|
||||||
|
Organization: formatEmployeeOrganizations(records)
|
||||||
|
}));
|
||||||
|
})
|
||||||
|
.catch(() => undefined);
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// context — единственный экземпляр WebPartContext на всё время жизни
|
||||||
|
// веб-части, так что перезапуска эффекта эта зависимость не добавляет.
|
||||||
|
}, [editId, context]);
|
||||||
|
|
||||||
|
// Выбор другого начальника участка подтягивает его ФИО и организации.
|
||||||
|
const handleSiteChiefChange = (login: string): void => {
|
||||||
|
setData((prev) => ({ ...prev, SiteChiefEmail: login }));
|
||||||
|
if (!login) {
|
||||||
|
setData((prev) => ({ ...prev, SiteChiefName: '', Organization: '' }));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
getEmployeeOrganizations(context, login)
|
||||||
|
.then((records) =>
|
||||||
|
setData((prev) => ({
|
||||||
|
...prev,
|
||||||
|
SiteChiefName: records[0]?.fio || prev.SiteChiefName,
|
||||||
|
Organization: formatEmployeeOrganizations(records)
|
||||||
|
}))
|
||||||
|
)
|
||||||
|
.catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
// Выбор мастера участка подтягивает только его ФИО (для печати) — на маршрут не влияет.
|
||||||
|
const handleForemanChange = (login: string): void => {
|
||||||
|
setData((prev) => ({ ...prev, ForemanEmail: login }));
|
||||||
|
if (!login) {
|
||||||
|
setData((prev) => ({ ...prev, ForemanName: '' }));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
getEmployeeOrganizations(context, login)
|
||||||
|
.then((records) => setData((prev) => ({ ...prev, ForemanName: records[0]?.fio || prev.ForemanName })))
|
||||||
|
.catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
// Маршрут согласования зависит от начальника участка И проекта (в админке
|
||||||
|
// approval-route для этого типа заявки настроено условие ByProject) —
|
||||||
|
// planned resolve без ProjectId 404-ит, поэтому матрица не готова, пока
|
||||||
|
// проект не выбран (см. matrixReady). У заявки на редактировании маршрут
|
||||||
|
// читается из уже записанных строк, поэтому проект там уже не нужен.
|
||||||
|
const projectId = data.ProjectId || null;
|
||||||
|
const matrixReady = !!editId || (!!data.SiteChiefEmail && !!projectId && !!requestTypeId);
|
||||||
|
const loadMatrix = useCallback(
|
||||||
|
() =>
|
||||||
|
editId
|
||||||
|
? approval.getMatrixForRequest(editId)
|
||||||
|
: getPlannedMatrix(context, requestTypeId as number, data.SiteChiefEmail, approval, 'Approval', null, undefined, projectId),
|
||||||
|
[context, approval, editId, data.SiteChiefEmail, requestTypeId, projectId]
|
||||||
|
);
|
||||||
|
const matrix = useMatrixEditor(
|
||||||
|
loadMatrix,
|
||||||
|
`${data.SiteChiefEmail}-${editId ?? 'new'}-${projectId}`,
|
||||||
|
!readOnly,
|
||||||
|
matrixReady,
|
||||||
|
(login) => approval.getJobTitle(login)
|
||||||
|
);
|
||||||
|
|
||||||
|
const hasItems = data.Items.some((i) => i.mixClass.trim().length > 0 && i.volume.trim().length > 0);
|
||||||
|
const isValid = !!(data.RequestDate && data.SiteChiefEmail && data.Project.trim() && hasItems);
|
||||||
|
const validate = (): string | undefined => {
|
||||||
|
if (!isValid) {
|
||||||
|
return 'Заполните обязательные поля: дата поставки, начальник участка, проект и хотя бы одну позицию (класс смеси + количество).';
|
||||||
|
}
|
||||||
|
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||||
|
if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
|
||||||
|
rows.map((r) => ({
|
||||||
|
email: r.email,
|
||||||
|
position: r.position,
|
||||||
|
allowReassign: r.allowReassign,
|
||||||
|
order: r.order,
|
||||||
|
// Транзитом из маршрута в строку списка: наследование бэкенд применил
|
||||||
|
// при resolve, форма только переносит значения (см. IMatrixRow.slaHours).
|
||||||
|
slaHours: r.slaHours,
|
||||||
|
askOverdueReason: r.askOverdueReason
|
||||||
|
}));
|
||||||
|
|
||||||
|
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||||
|
// validate()/validateSubmit() уже гарантировали requestTypeId к моменту вызова
|
||||||
|
// (см. useRequestSubmit.run — валидирует ДО save), но TS этого через границу
|
||||||
|
// замыкания не видит — локальный const и явная проверка снимают обе проблемы.
|
||||||
|
const rtId = requestTypeId;
|
||||||
|
if (!rtId) {
|
||||||
|
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||||
|
}
|
||||||
|
// requestId уже задан → редактируем существующую заявку, пишем в ту же
|
||||||
|
// партицию (editListId); иначе резолвится ТЕКУЩАЯ (см. resolveWriteListId —
|
||||||
|
// именно этот запрос проверяет порог элементов и запускает архивацию).
|
||||||
|
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
|
||||||
|
const { id, code } = await saveConcreteRequest(
|
||||||
|
requestId,
|
||||||
|
rtId,
|
||||||
|
data,
|
||||||
|
toApprovers(matrix.rows),
|
||||||
|
status,
|
||||||
|
writeListId
|
||||||
|
);
|
||||||
|
setRequestId(id);
|
||||||
|
setRequestStatus(status);
|
||||||
|
if (code) {
|
||||||
|
setRequestCode(code);
|
||||||
|
}
|
||||||
|
if (onSaved) {
|
||||||
|
onSaved();
|
||||||
|
}
|
||||||
|
// Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
|
||||||
|
// Имена списков — той же партиции, куда фактически записана заявка (writeListId),
|
||||||
|
// не текущей: поток ищет строку маршрута именно в НЕЙ.
|
||||||
|
if (status === REQUEST_STATUS.onApproval) {
|
||||||
|
await notifyActiveStep(context, approval, id, {
|
||||||
|
requestTypeId: rtId,
|
||||||
|
dataListName: writeListId ? dataListTitleForListId(FORM_ID, writeListId) : dataListTitle(FORM_ID),
|
||||||
|
approvalListName: writeListId ? approvalListTitleForListId(FORM_ID, writeListId) : approvalListTitle(FORM_ID)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// На отправку (в отличие от черновика) маршрут должен быть полностью
|
||||||
|
// укомплектован — иначе шаг без назначенного человека молча пропадёт при записи.
|
||||||
|
const validateSubmit = (): string | undefined => {
|
||||||
|
const formError = validate();
|
||||||
|
if (formError) return formError;
|
||||||
|
if (matrix.error) {
|
||||||
|
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
|
||||||
|
}
|
||||||
|
const unassignedError = unassignedStepMessage(
|
||||||
|
matrix.rows,
|
||||||
|
(r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
|
||||||
|
);
|
||||||
|
if (unassignedError) return unassignedError;
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||||
|
const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||||
|
|
||||||
|
const sectionProps = {
|
||||||
|
data,
|
||||||
|
set,
|
||||||
|
context,
|
||||||
|
onSiteChiefChange: handleSiteChiefChange,
|
||||||
|
onForemanChange: handleForemanChange
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<button type="button" className={styles.back} onClick={onCancel}>
|
||||||
|
<Icon name="arrow-left" size="sm" />
|
||||||
|
<span>К списку заявок</span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
<FormCard
|
||||||
|
title={requestType.title}
|
||||||
|
subtitle="Категория: Склад / Снабжение"
|
||||||
|
belowSubtitle={
|
||||||
|
<InitiatorLine
|
||||||
|
listTitle={editListId ? dataListTitleForListId(FORM_ID, editListId) : dataListTitle(FORM_ID)}
|
||||||
|
itemId={requestId}
|
||||||
|
fallback={{ name: data.SiteChiefName, email: data.SiteChiefEmail }}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
headerRight={
|
||||||
|
requestId || requestStatus ? (
|
||||||
|
<>
|
||||||
|
{requestStatus && <StatusBadge status={requestStatus} />}
|
||||||
|
{requestCode && <RequestNumber code={requestCode} />}
|
||||||
|
</>
|
||||||
|
) : undefined
|
||||||
|
}
|
||||||
|
>
|
||||||
|
{submit.savedKind && !submit.error && (
|
||||||
|
<Alert variant="ok">
|
||||||
|
{submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
|
||||||
|
</Alert>
|
||||||
|
)}
|
||||||
|
{submit.error && <Alert variant="err">{submit.error}</Alert>}
|
||||||
|
|
||||||
|
<FormModeProvider readOnly={readOnly}>
|
||||||
|
<HeaderSection {...sectionProps} />
|
||||||
|
<ItemsSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
|
||||||
|
<ApprovalMatrix
|
||||||
|
editor={matrix}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
waiting={!matrixReady}
|
||||||
|
waitingText="Укажите начальника участка и проект, чтобы построить маршрут согласования."
|
||||||
|
/>
|
||||||
|
|
||||||
|
<SubmitActions
|
||||||
|
submit={submit}
|
||||||
|
isValid={isValid}
|
||||||
|
readOnly={readOnly}
|
||||||
|
onCancel={onCancel}
|
||||||
|
onSaveDraft={handleSaveDraft}
|
||||||
|
onSubmit={handleSubmit}
|
||||||
|
submitLabel="Отправить на согласование"
|
||||||
|
/>
|
||||||
|
</FormCard>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default ConcreteRequestForm;
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.state {
|
||||||
|
padding: $sp-8;
|
||||||
|
color: $gray-500;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toolbar {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: flex-end;
|
||||||
|
gap: $sp-3;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
}
|
||||||
@@ -0,0 +1,178 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||||
|
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import styles from './ConcreteRequestView.module.scss';
|
||||||
|
import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintSplitButton, OrgLetterhead } from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApproverService,
|
||||||
|
DecisionPanel,
|
||||||
|
StatusBadge,
|
||||||
|
ApprovalMatrix,
|
||||||
|
useMatrixEditor,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import {
|
||||||
|
approvalListTitle,
|
||||||
|
approvalListTitleForListId,
|
||||||
|
dataListTitle,
|
||||||
|
dataListTitleForListId
|
||||||
|
} from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { loadConcreteRequest } from './load';
|
||||||
|
import { concreteRequestApprovalService } from './submit';
|
||||||
|
import { HeaderSection } from './sections/HeaderSection';
|
||||||
|
import { ItemsSection } from './sections/ItemsSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
interface IConcreteRequestViewProps {
|
||||||
|
context: WebPartContext;
|
||||||
|
itemId: number;
|
||||||
|
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||||
|
formKey: string;
|
||||||
|
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||||
|
listId?: string;
|
||||||
|
/** Уведомление о загруженном уникальном коде заявки — см. IApprovalViewProps.onCodeLoaded. */
|
||||||
|
onCodeLoaded?: (code: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||||
|
const NOOP_SET: SetField = () => undefined;
|
||||||
|
|
||||||
|
// Заявка на бетон только для просмотра (режим согласующего). Переиспользует ту
|
||||||
|
// же секцию, что и форма подачи; редактирование выключено через
|
||||||
|
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||||
|
const ConcreteRequestView: React.FC<IConcreteRequestViewProps> = ({ context, itemId, formKey, listId, onCodeLoaded }) => {
|
||||||
|
// onCodeLoaded — колбэк родителя (RequestPortal → ApproveFeature): его ссылка
|
||||||
|
// может меняться на каждом рендере, поэтому в зависимости эффекта загрузки
|
||||||
|
// идёт стабильная обёртка, а не сам проп — иначе заявка перезапрашивалась бы
|
||||||
|
// при каждом рендере родителя.
|
||||||
|
const notifyCode = useStableCallback(onCodeLoaded);
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [status, setStatus] = useState<string>('');
|
||||||
|
const [code, setCode] = useState<string>('');
|
||||||
|
const [loading, setLoading] = useState<boolean>(true);
|
||||||
|
const [error, setError] = useState<string | null>(null);
|
||||||
|
// Какая из организаций начальника участка (см. OrganizationField) идёт в печать —
|
||||||
|
// выбор в тулбаре через PrintSplitButton, по умолчанию первая.
|
||||||
|
const [printOrgIndex, setPrintOrgIndex] = useState<number>(0);
|
||||||
|
|
||||||
|
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||||
|
// concreteRequestApprovalService можно звать не опасаясь исключения.
|
||||||
|
const approval = useMemo(() => concreteRequestApprovalService(listId), [listId]);
|
||||||
|
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||||
|
// Ref списка данных для ApproverService.updateRequestStatus: listId (url) для
|
||||||
|
// архивной партиции, Title текущей — иначе (см. ApproverService.dataListRef).
|
||||||
|
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||||
|
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||||
|
|
||||||
|
// Матрица маршрута из фактических строк заявки (read-only). decisionSeq в
|
||||||
|
// reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||||
|
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||||
|
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId), [approval, itemId]);
|
||||||
|
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||||
|
approval.getJobTitle(l)
|
||||||
|
);
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
let alive = true;
|
||||||
|
setLoading(true);
|
||||||
|
loadConcreteRequest(itemId, listId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setStatus(loaded.status);
|
||||||
|
setCode(loaded.code);
|
||||||
|
notifyCode(loaded.code);
|
||||||
|
setError(null);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [itemId, listId, notifyCode]);
|
||||||
|
|
||||||
|
if (loading) {
|
||||||
|
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||||
|
}
|
||||||
|
if (error) {
|
||||||
|
return (
|
||||||
|
<div className={styles.state}>
|
||||||
|
<Alert variant="err">{error}</Alert>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const sectionProps = { data, set: NOOP_SET, context, printOrgIndex };
|
||||||
|
|
||||||
|
const notify = (): void => {
|
||||||
|
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||||
|
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
|
||||||
|
// весь UI ради необязательного оповещения.
|
||||||
|
if (!requestTypeId) return;
|
||||||
|
notifyActiveStep(context, approval, itemId, {
|
||||||
|
requestTypeId,
|
||||||
|
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
|
||||||
|
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
|
||||||
|
}).catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<div className={`${styles.toolbar} rp-no-print`}>
|
||||||
|
<PrintSplitButton value={data.Organization} selectedIndex={printOrgIndex} onChange={setPrintOrgIndex} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="rp-print-root">
|
||||||
|
<OrgLetterhead value={data.Organization} selectedIndex={printOrgIndex} />
|
||||||
|
<FormCard
|
||||||
|
title="Заявка на бетон"
|
||||||
|
subtitle={`№${code || itemId}`}
|
||||||
|
belowSubtitle={
|
||||||
|
<InitiatorLine
|
||||||
|
listTitle={listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID)}
|
||||||
|
itemId={itemId}
|
||||||
|
fallback={{ name: data.SiteChiefName, email: data.SiteChiefEmail }}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
headerRight={status ? <StatusBadge status={status} /> : undefined}
|
||||||
|
>
|
||||||
|
<FormModeProvider readOnly>
|
||||||
|
<HeaderSection {...sectionProps} />
|
||||||
|
<ItemsSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
</FormCard>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый). */}
|
||||||
|
<div className="rp-no-print">
|
||||||
|
<DecisionPanel
|
||||||
|
service={approverService}
|
||||||
|
requestId={itemId}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
onDecided={(newStatus) => {
|
||||||
|
setStatus(newStatus);
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
onDelegated={() => {
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default ConcreteRequestView;
|
||||||
@@ -0,0 +1,63 @@
|
|||||||
|
# Заявка на бетон (wh-concrete-request)
|
||||||
|
|
||||||
|
**Назначение:** заявка участка строительства на поставку бетонной смеси.
|
||||||
|
Бумажный первоисточник — «Заявка на поставку бетонной смеси» (таблица позиций +
|
||||||
|
подписи начальника и мастера участка).
|
||||||
|
**Категория:** Склад / Снабжение
|
||||||
|
**Списки SP:** «Заявка на бетон — данные» / «Заявка на бетон — согласование»
|
||||||
|
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||||
|
`pageUrl` («wh-concrete-request») через `useRequestTypeId` (см. «Формы больше не
|
||||||
|
хардкодят RequestTypeId» в `docs/forms.md`). Тип и маршрут нужно завести в
|
||||||
|
админке approval-route — на момент написания роль согласующего ещё не определена
|
||||||
|
заказчиком (один шаг, но кто именно — уточняется).
|
||||||
|
|
||||||
|
## Маршрут
|
||||||
|
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||||
|
получает статус «Согласовано» (как «Заявка на отпуск»).
|
||||||
|
- **Матрица редактируема заявителем** при новой заявке / черновике / возврате:
|
||||||
|
`useMatrixEditor(editable = !readOnly)`.
|
||||||
|
- Маршрут резолвится по e-mail **начальника участка** (`SiteChiefEmail` — «Составил»
|
||||||
|
на бумаге), не мастера участка, **и по проекту** (`ProjectId`) — в админке
|
||||||
|
approval-route для этого типа заявки настроено условие `ByProject`, поэтому
|
||||||
|
`getPlannedMatrix(...)` вызывается с `projectId` седьмым аргументом (тот же
|
||||||
|
приём, что у «СЗ на перемещение ТМЦ» с `SourceProjectId`). Пока проект не
|
||||||
|
выбран, planned-resolve вернул бы 404 — матрица не грузится (`matrixReady`),
|
||||||
|
вместо неё показывается заглушка (`ApprovalMatrix waiting`).
|
||||||
|
|
||||||
|
## Особое поведение
|
||||||
|
- **Два подписанта с одной стороны, без «Согласовано» от другого лица на бумаге:**
|
||||||
|
«Начальник участка» (`SiteChiefEmail`/`SiteChiefName`, People-picker, по умолчанию
|
||||||
|
текущий пользователь, резолвит маршрут) и «Мастер участка»
|
||||||
|
(`ForemanEmail`/`ForemanName`, People-picker) — чисто информационное поле для
|
||||||
|
печати, на маршрут не влияет.
|
||||||
|
- **Email/ФИО хранятся как обычный текст** (не колонки типа User) — тот же приём,
|
||||||
|
что у «СЗ на перемещение ТМЦ» (`RequesterEmail`/`AuthorName`): участники не
|
||||||
|
обязаны быть штатными сотрудниками с полной карточкой в SharePoint.
|
||||||
|
- **Автоподстановка организации** (`Organization`, read-only, `OrganizationField`) —
|
||||||
|
из `Employee/ByEmail` при выборе начальника участка, сотрудник может состоять
|
||||||
|
сразу в нескольких организациях (печать — как у «Заявки на отпуск»,
|
||||||
|
`PrintSplitButton`/`OrgLetterhead`).
|
||||||
|
- **Проект** (`Project`/`ProjectId`, `ProjectPicker`, обязателен) — ОДИН на всю
|
||||||
|
заявку, выбирается в шапке (`HeaderSection`), а не на каждую позицию: раньше
|
||||||
|
был в табличной части, но перенесён в шапку, потому что от него зависит
|
||||||
|
маршрут согласования (см. «Маршрут» выше) — дублировать его по позициям
|
||||||
|
незачем, все позиции заявки относятся к одному проекту.
|
||||||
|
- **Табличная часть** (`ItemsEditor`, сериализуется в `ItemsJson`) — карточка на
|
||||||
|
каждую поставку: класс/марка смеси и характеристика (`mixClass`), количество
|
||||||
|
в м³ (`volume`), подвижность (`workability`, фиксированный набор П1–П5), время
|
||||||
|
(`time`, свободный текст) и примечание (`note`). Проекта в позиции больше нет
|
||||||
|
(см. выше). Не переиспользует общий `shared/ui/ItemsTable` (тот заточен под
|
||||||
|
номенклатуру ТМЦ — наименование/инв. номер/ед.изм/кол-во) — набор колонок
|
||||||
|
здесь другой, поэтому у формы свой редактор. Карточки (`FormGrid`/`FormField`),
|
||||||
|
а не строки плоской таблицы — адаптивнее на мобильных, чем строка с
|
||||||
|
горизонтальным скроллом.
|
||||||
|
- **Заголовок элемента** (`Title`): `Заявка на бетон — {ФИО начальника участка} — дд.мм.гггг`.
|
||||||
|
|
||||||
|
## Секции формы
|
||||||
|
HeaderSection (дата поставки · начальник участка · организация (read-only) ·
|
||||||
|
проект · мастер участка) + ItemsEditor (табличная часть поставок)
|
||||||
|
|
||||||
|
## Точки входа
|
||||||
|
- rptype: `wh-concrete-request`
|
||||||
|
- Режим согласующего (просмотр): есть (`ConcreteRequestView`)
|
||||||
|
- «Создать на основе»: нет
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Заявка на бетон — согласование",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "TansuSiteApprover", "title": "Согласующий", "type": "User", "userSelectionMode": "PeopleOnly" },
|
||||||
|
{ "internalName": "ApprovalStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "Ждёт очереди", "На согласовании", "На исполнении", "Согласовано", "Выполнено", "Отклонено", "Возвращена на доработку"] },
|
||||||
|
{ "internalName": "Ticket", "title": "Заявка", "type": "Lookup", "lookupList": "Заявка на бетон — данные", "lookupShowField": "Title" },
|
||||||
|
{ "internalName": "Date", "title": "Дата", "type": "DateTime" },
|
||||||
|
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||||
|
{ "internalName": "StepOrder", "title": "Порядок", "type": "Number" },
|
||||||
|
{ "internalName": "AllowReassignToOtherApprovers", "title": "Можно перепоручать", "type": "Boolean" },
|
||||||
|
{ "internalName": "Phase", "title": "Фаза", "type": "Choice", "choices": ["Согласование", "Исполнение"] },
|
||||||
|
{ "internalName": "SLAhours", "title": "SLA, часов", "type": "Number" },
|
||||||
|
{ "internalName": "AskOverdueReason", "title": "Опрос причины просрочки", "type": "Boolean" },
|
||||||
|
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, IConcreteItem, EMPTY_DATA } from './model';
|
||||||
|
|
||||||
|
export interface ILoadedRequest {
|
||||||
|
data: IFormData;
|
||||||
|
/** Ф.И.О. начальника участка (для заголовка режима чтения / InitiatorLine fallback). */
|
||||||
|
employeeName: string;
|
||||||
|
status: string;
|
||||||
|
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||||
|
code: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Разобрать ItemsJson. Невалидный/пустой JSON → []. */
|
||||||
|
function parseItems(raw: unknown): IConcreteItem[] {
|
||||||
|
if (typeof raw !== 'string' || raw.trim() === '') return [];
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(raw);
|
||||||
|
return Array.isArray(parsed) ? (parsed as IConcreteItem[]) : [];
|
||||||
|
} catch {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Прочитать заявку на бетон по id: модель формы + статус (правка / просмотр).
|
||||||
|
*
|
||||||
|
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
|
||||||
|
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
|
||||||
|
* по url списка, а не по имени: так не нужно резолвить, как называется архивный
|
||||||
|
* список, и запрос не зависит от реестра партиций.
|
||||||
|
*/
|
||||||
|
export async function loadConcreteRequest(itemId: number, listId?: string): Promise<ILoadedRequest> {
|
||||||
|
const list = listId ? getSP().web.getList(listId) : getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
|
||||||
|
const item = (await list
|
||||||
|
.items.getById(itemId)
|
||||||
|
.select(
|
||||||
|
'Id',
|
||||||
|
'RequestDate',
|
||||||
|
'SiteChiefEmail',
|
||||||
|
'SiteChiefName',
|
||||||
|
'ForemanEmail',
|
||||||
|
'ForemanName',
|
||||||
|
'Organization',
|
||||||
|
'Project',
|
||||||
|
'ProjectId',
|
||||||
|
'ItemsJson',
|
||||||
|
'RequestStatus',
|
||||||
|
'RequestUniqueCode'
|
||||||
|
)()) as Record<string, unknown>;
|
||||||
|
|
||||||
|
const requestDate = (item.RequestDate as string) || '';
|
||||||
|
|
||||||
|
const data: IFormData = {
|
||||||
|
...EMPTY_DATA,
|
||||||
|
RequestDate: requestDate.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||||
|
SiteChiefEmail: (item.SiteChiefEmail as string) || '',
|
||||||
|
SiteChiefName: (item.SiteChiefName as string) || '',
|
||||||
|
ForemanEmail: (item.ForemanEmail as string) || '',
|
||||||
|
ForemanName: (item.ForemanName as string) || '',
|
||||||
|
Organization: (item.Organization as string) || '',
|
||||||
|
Project: (item.Project as string) || '',
|
||||||
|
ProjectId: (item.ProjectId as string) || '',
|
||||||
|
Items: parseItems(item.ItemsJson)
|
||||||
|
};
|
||||||
|
|
||||||
|
return {
|
||||||
|
data,
|
||||||
|
employeeName: data.SiteChiefName,
|
||||||
|
status: (item.RequestStatus as string) || '',
|
||||||
|
code: (item.RequestUniqueCode as string) || ''
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -0,0 +1,126 @@
|
|||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import { ISelectOption } from '../../shared/ui';
|
||||||
|
import { RequestTypeId } from '../../models/types';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||||
|
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||||
|
*/
|
||||||
|
export const FORM_ID: RequestTypeId = 'wh-concrete-request';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Строка табличной части — одна поставка бетонной смеси (бумажный бланк
|
||||||
|
* «Заявка на поставку бетонной смеси»). Все поля — строки: значения приходят
|
||||||
|
* из текстовых полей ввода, количество арифметически не считаем.
|
||||||
|
*
|
||||||
|
* Объект/проект здесь НЕ хранится — он один на всю заявку (см. IFormData.Project),
|
||||||
|
* а не на позицию: перенесён в шапку, потому что от него теперь зависит маршрут
|
||||||
|
* согласования (ByProject, см. IFormData).
|
||||||
|
*/
|
||||||
|
export interface IConcreteItem {
|
||||||
|
/** Класс/марка смеси и краткая характеристика (напр. «C20/25 F75 W6»). */
|
||||||
|
mixClass: string;
|
||||||
|
/** Количество, м³. */
|
||||||
|
volume: string;
|
||||||
|
/** Подвижность смеси — см. WORKABILITY_OPTIONS. */
|
||||||
|
workability: string;
|
||||||
|
/** Время поставки (свободный текст, напр. «13:00» — своего типа времени в TextInput нет). */
|
||||||
|
time: string;
|
||||||
|
/** Примечание. */
|
||||||
|
note: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const EMPTY_CONCRETE_ITEM: IConcreteItem = {
|
||||||
|
mixClass: '',
|
||||||
|
volume: '',
|
||||||
|
workability: '',
|
||||||
|
time: '',
|
||||||
|
note: ''
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Подвижность бетонной смеси (ГОСТ 7473) — фиксированный набор, чтобы не плодить опечатки. */
|
||||||
|
export const WORKABILITY_OPTIONS: ISelectOption[] = [
|
||||||
|
{ value: 'П1', label: 'П1' },
|
||||||
|
{ value: 'П2', label: 'П2' },
|
||||||
|
{ value: 'П3', label: 'П3' },
|
||||||
|
{ value: 'П4', label: 'П4' },
|
||||||
|
{ value: 'П5', label: 'П5' }
|
||||||
|
];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Данные формы «Заявка на бетон» по бумажному шаблону («Заявка на поставку
|
||||||
|
* бетонной смеси» с участка строительства). Ключи шапки = internalName колонок
|
||||||
|
* SP-списка. Табличная часть (Items) в SP не разворачивается в колонки, а
|
||||||
|
* сериализуется в JSON-колонку ItemsJson (см. submit.ts / load.ts) — тот же
|
||||||
|
* приём, что и у «СЗ на перемещение ТМЦ».
|
||||||
|
*
|
||||||
|
* На бумаге два подписанта с одной стороны (заявителя), без отдельного
|
||||||
|
* «Согласовано» от другого лица: «Составил — Начальник участка» и «Мастер
|
||||||
|
* участка». Маршрут резолвится по e-mail НАЧАЛЬНИКА УЧАСТКА (SiteChiefEmail) —
|
||||||
|
* он же автор заявки; мастер участка — второй подписант, на маршрут не влияет.
|
||||||
|
*
|
||||||
|
* Проект (`Project`/`ProjectId`) — ОДИН на всю заявку (не на позицию, см.
|
||||||
|
* IConcreteItem): в админке approval-route для этого типа заявки настроено
|
||||||
|
* условие по проекту (ByProject), поэтому ProjectId передаётся в
|
||||||
|
* getPlannedMatrix как обязательный параметр — без него маршрут не резолвится
|
||||||
|
* (см. ConcreteRequestForm.tsx).
|
||||||
|
*/
|
||||||
|
export interface IFormData {
|
||||||
|
/** Дата поставки (ISO YYYY-MM-DD). */
|
||||||
|
RequestDate: string;
|
||||||
|
/**
|
||||||
|
* «Составил: Начальник участка» — email заявителя (People). По нему
|
||||||
|
* резолвится маршрут согласования, поэтому заявку можно подать и за
|
||||||
|
* другого — выбор подтягивает организацию (см. Organization).
|
||||||
|
*/
|
||||||
|
SiteChiefEmail: string;
|
||||||
|
/** Ф.И.О. начальника участка — для печати, подтягивается из Employee/ByEmail. */
|
||||||
|
SiteChiefName: string;
|
||||||
|
/** «Мастер участка» — email второго подписанта (People). На маршрут не влияет. */
|
||||||
|
ForemanEmail: string;
|
||||||
|
/** Ф.И.О. мастера участка — для печати. */
|
||||||
|
ForemanName: string;
|
||||||
|
/**
|
||||||
|
* Организации начальника участка (`\n`-joined «Компания — должность» на
|
||||||
|
* строку) — подтягивается автоматически из Employee/ByEmail, read-only
|
||||||
|
* (см. shared/ui/OrganizationField).
|
||||||
|
*/
|
||||||
|
Organization: string;
|
||||||
|
/** Проект (справочник /Project, см. shared/dictionary/ProjectPicker) — влияет на маршрут согласования. */
|
||||||
|
Project: string;
|
||||||
|
/** oid проекта из справочника; '' — введён вручную без выбора. */
|
||||||
|
ProjectId: string;
|
||||||
|
/** Табличная часть — позиции поставки (сериализуется в ItemsJson). */
|
||||||
|
Items: IConcreteItem[];
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
|
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||||
|
|
||||||
|
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker, project picker). */
|
||||||
|
export interface ISectionProps {
|
||||||
|
data: IFormData;
|
||||||
|
set: SetField;
|
||||||
|
context: WebPartContext;
|
||||||
|
/** Индекс организации для печати (см. shared/ui/PrintSplitButton и OrganizationField.printIndex). */
|
||||||
|
printOrgIndex?: number;
|
||||||
|
/** Выбор начальника участка подтягивает его ФИО и организации. Не передан (просмотр) — правка через set. */
|
||||||
|
onSiteChiefChange?: (login: string) => void;
|
||||||
|
/** Выбор мастера участка подтягивает его ФИО. Не передан (просмотр) — правка через set. */
|
||||||
|
onForemanChange?: (login: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const SITE_CHIEF_PLACEHOLDER = 'Начните вводить Ф.И.О. начальника участка…';
|
||||||
|
export const FOREMAN_PLACEHOLDER = 'Начните вводить Ф.И.О. мастера участка…';
|
||||||
|
|
||||||
|
export const EMPTY_DATA: IFormData = {
|
||||||
|
RequestDate: '',
|
||||||
|
SiteChiefEmail: '',
|
||||||
|
SiteChiefName: '',
|
||||||
|
ForemanEmail: '',
|
||||||
|
ForemanName: '',
|
||||||
|
Organization: '',
|
||||||
|
Project: '',
|
||||||
|
ProjectId: '',
|
||||||
|
Items: []
|
||||||
|
};
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Заявка на бетон — данные",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||||
|
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||||
|
|
||||||
|
{ "internalName": "RequestDate", "title": "Дата поставки", "type": "DateTime", "dateOnly": true },
|
||||||
|
{ "internalName": "SiteChiefEmail", "title": "Начальник участка (email)", "type": "Text", "required": true },
|
||||||
|
{ "internalName": "SiteChiefName", "title": "Начальник участка (Ф.И.О.)", "type": "Text" },
|
||||||
|
{ "internalName": "ForemanEmail", "title": "Мастер участка (email)", "type": "Text" },
|
||||||
|
{ "internalName": "ForemanName", "title": "Мастер участка (Ф.И.О.)", "type": "Text" },
|
||||||
|
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||||
|
{ "internalName": "Project", "title": "Проект", "type": "Text", "required": true },
|
||||||
|
{ "internalName": "ProjectId", "title": "Id проекта (справочник)", "type": "Text" },
|
||||||
|
|
||||||
|
{ "internalName": "ItemsJson", "title": "Позиции поставки (JSON)", "type": "Note" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { FormGrid, FormField, TextInput, PeopleField, OrganizationField } from '../../../shared/ui';
|
||||||
|
import { ProjectPicker } from '../../../shared/dictionary';
|
||||||
|
import { ISectionProps, SITE_CHIEF_PLACEHOLDER, FOREMAN_PLACEHOLDER } from '../model';
|
||||||
|
|
||||||
|
/** Шапка заявки на бетон: дата поставки, начальник участка (составил), мастер участка. */
|
||||||
|
export const HeaderSection: React.FC<ISectionProps> = ({
|
||||||
|
data,
|
||||||
|
set,
|
||||||
|
context,
|
||||||
|
printOrgIndex,
|
||||||
|
onSiteChiefChange,
|
||||||
|
onForemanChange
|
||||||
|
}) => (
|
||||||
|
<FormGrid>
|
||||||
|
<FormField label="Дата поставки" htmlFor="RequestDate" required>
|
||||||
|
<TextInput id="RequestDate" type="date" value={data.RequestDate} onChange={(v) => set('RequestDate', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Начальник участка (составил)" htmlFor="SiteChiefEmail" required full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.SiteChiefEmail}
|
||||||
|
onChange={onSiteChiefChange ?? ((v) => set('SiteChiefEmail', v))}
|
||||||
|
placeholder={SITE_CHIEF_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<OrganizationField value={data.Organization} printIndex={printOrgIndex} />
|
||||||
|
<FormField label="Проект" htmlFor="Project" required>
|
||||||
|
<ProjectPicker
|
||||||
|
id="Project"
|
||||||
|
context={context}
|
||||||
|
value={data.Project}
|
||||||
|
onChange={(name, id) => {
|
||||||
|
set('Project', name);
|
||||||
|
set('ProjectId', id);
|
||||||
|
}}
|
||||||
|
placeholder="Начните вводить название или код проекта…"
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Мастер участка" htmlFor="ForemanEmail" full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.ForemanEmail}
|
||||||
|
onChange={onForemanChange ?? ((v) => set('ForemanEmail', v))}
|
||||||
|
placeholder={FOREMAN_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
</FormGrid>
|
||||||
|
);
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
@import '../../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
// Секция занимает обе колонки FormGrid родителя (CollapseSection).
|
||||||
|
.full {
|
||||||
|
grid-column: 1 / -1;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: $sp-4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card {
|
||||||
|
border: 1px solid $gray-200;
|
||||||
|
border-radius: $r-md;
|
||||||
|
background: $gray-50;
|
||||||
|
padding: $sp-4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.cardHead {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
gap: $sp-3;
|
||||||
|
margin-bottom: $sp-3;
|
||||||
|
}
|
||||||
|
|
||||||
|
.cardIndex {
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
font-weight: 600;
|
||||||
|
color: $gray-700;
|
||||||
|
}
|
||||||
|
|
||||||
|
.remove {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
flex-shrink: 0;
|
||||||
|
padding: 6px;
|
||||||
|
border: 0;
|
||||||
|
border-radius: $r-sm;
|
||||||
|
background: transparent;
|
||||||
|
color: $gray-500;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: .18s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
background: $red-50;
|
||||||
|
color: $red-500;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.empty {
|
||||||
|
padding: $sp-3 0;
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
color: $gray-500;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
@@ -0,0 +1,85 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import styles from './ItemsEditor.module.scss';
|
||||||
|
import { Button, Icon, TextInput, Select, FormGrid, FormField, useFormReadOnly } from '../../../shared/ui';
|
||||||
|
import { EMPTY_CONCRETE_ITEM, IConcreteItem, WORKABILITY_OPTIONS } from '../model';
|
||||||
|
|
||||||
|
export interface IItemsEditorProps {
|
||||||
|
value: IConcreteItem[];
|
||||||
|
onChange: (rows: IConcreteItem[]) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Табличная часть заявки на бетон: класс смеси, объём, подвижность, время и
|
||||||
|
* примечание — карточка на каждую поставку. Проект/объект сюда не входит: он
|
||||||
|
* один на всю заявку и выбирается в шапке (см. HeaderSection, IFormData.Project) —
|
||||||
|
* от него зависит маршрут согласования, поэтому поле не дублируется по позициям.
|
||||||
|
*
|
||||||
|
* НЕ плоская таблица-простыня (как shared/ui/ItemsTable): карточки с обычным
|
||||||
|
* FormGrid адаптивнее узкой строки с горизонтальным скроллом на мобильных.
|
||||||
|
*/
|
||||||
|
export const ItemsEditor: React.FC<IItemsEditorProps> = ({ value, onChange }) => {
|
||||||
|
const readOnly = useFormReadOnly();
|
||||||
|
|
||||||
|
const setRow = (index: number, patch: Partial<IConcreteItem>): void => {
|
||||||
|
onChange(value.map((row, i) => (i === index ? { ...row, ...patch } : row)));
|
||||||
|
};
|
||||||
|
|
||||||
|
const addRow = (): void => onChange([...value, { ...EMPTY_CONCRETE_ITEM }]);
|
||||||
|
const removeRow = (index: number): void => onChange(value.filter((_, i) => i !== index));
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className={styles.full}>
|
||||||
|
{value.length === 0 ? (
|
||||||
|
<div className={styles.empty}>{readOnly ? 'Позиции не добавлены' : 'Нет позиций. Добавьте строку.'}</div>
|
||||||
|
) : (
|
||||||
|
value.map((row, i) => (
|
||||||
|
<div className={styles.card} key={i}>
|
||||||
|
<div className={styles.cardHead}>
|
||||||
|
<span className={styles.cardIndex}>Позиция {i + 1}</span>
|
||||||
|
{!readOnly && (
|
||||||
|
<button type="button" className={styles.remove} title="Удалить позицию" onClick={() => removeRow(i)}>
|
||||||
|
<Icon name="trash" size="sm" />
|
||||||
|
</button>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
<FormGrid>
|
||||||
|
<FormField label="Класс смеси и хар-ка" htmlFor={`mixClass-${i}`} required full>
|
||||||
|
<TextInput
|
||||||
|
id={`mixClass-${i}`}
|
||||||
|
value={row.mixClass}
|
||||||
|
onChange={(v) => setRow(i, { mixClass: v })}
|
||||||
|
placeholder="C20/25 F75 W6"
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Количество, м³" htmlFor={`volume-${i}`} required>
|
||||||
|
<TextInput id={`volume-${i}`} value={row.volume} onChange={(v) => setRow(i, { volume: v })} placeholder="0" />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Подвижность" htmlFor={`workability-${i}`}>
|
||||||
|
<Select
|
||||||
|
id={`workability-${i}`}
|
||||||
|
value={row.workability}
|
||||||
|
onChange={(v) => setRow(i, { workability: v })}
|
||||||
|
options={WORKABILITY_OPTIONS}
|
||||||
|
placeholder="—"
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Время" htmlFor={`time-${i}`}>
|
||||||
|
<TextInput id={`time-${i}`} value={row.time} onChange={(v) => setRow(i, { time: v })} placeholder="13:00" />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Примечание" htmlFor={`note-${i}`} full>
|
||||||
|
<TextInput id={`note-${i}`} value={row.note} onChange={(v) => setRow(i, { note: v })} placeholder="Примечание" />
|
||||||
|
</FormField>
|
||||||
|
</FormGrid>
|
||||||
|
</div>
|
||||||
|
))
|
||||||
|
)}
|
||||||
|
|
||||||
|
{!readOnly && (
|
||||||
|
<Button variant="secondary" size="sm" onClick={addRow}>
|
||||||
|
<Icon name="plus" size="sm" />
|
||||||
|
Добавить позицию
|
||||||
|
</Button>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { CollapseSection } from '../../../shared/ui';
|
||||||
|
import { ItemsEditor } from './ItemsEditor';
|
||||||
|
import { ISectionProps } from '../model';
|
||||||
|
|
||||||
|
/** Табличная часть заявки на бетон: класс смеси, объём, подвижность, время, примечание. */
|
||||||
|
export const ItemsSection: React.FC<ISectionProps> = ({ data, set }) => (
|
||||||
|
<CollapseSection title="Позиции поставки" icon="clipboard">
|
||||||
|
<ItemsEditor value={data.Items} onChange={(rows) => set('Items', rows)} />
|
||||||
|
</CollapseSection>
|
||||||
|
);
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||||
|
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
||||||
|
import { IConcreteItem, FORM_ID, IFormData } from './model';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||||
|
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
|
||||||
|
* именем формы для читаемости вызывающего кода.
|
||||||
|
*/
|
||||||
|
export function concreteRequestApprovalService(listId?: string): ApprovalListService {
|
||||||
|
return approvalServiceFor(FORM_ID, listId);
|
||||||
|
}
|
||||||
|
|
||||||
|
function pad2(n: number): string {
|
||||||
|
return n < 10 ? `0${n}` : `${n}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||||
|
function buildTitle(siteChiefName: string): string {
|
||||||
|
const now = new Date();
|
||||||
|
return `Заявка на бетон — ${siteChiefName || 'без Ф.И.О.'} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Поля элемента списка данных из модели формы. Items не разворачивается в
|
||||||
|
* колонки — сериализуется в Note-колонку ItemsJson (тот же приём, что и у
|
||||||
|
* «СЗ на перемещение ТМЦ»).
|
||||||
|
*/
|
||||||
|
function buildItem(data: IFormData, status: string): Record<string, unknown> {
|
||||||
|
const item: Record<string, unknown> = { Title: buildTitle(data.SiteChiefName), RequestStatus: status };
|
||||||
|
|
||||||
|
(Object.keys(data) as (keyof IFormData)[]).forEach((key) => {
|
||||||
|
if (key === 'Items') {
|
||||||
|
const items = data.Items as IConcreteItem[];
|
||||||
|
item.ItemsJson = items.length > 0 ? JSON.stringify(items) : null;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const value = data[key];
|
||||||
|
item[key] = value === '' ? null : value;
|
||||||
|
});
|
||||||
|
|
||||||
|
return item;
|
||||||
|
}
|
||||||
|
|
||||||
|
export type ISaveResult = ISaveItemResult;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сохранить заявку на бетон: содержимое + маршрут согласования.
|
||||||
|
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||||
|
* Фазы исполнения нет — writeRoute вызывается с пустым списком исполнителей.
|
||||||
|
* Возвращает Id заявки (+ код при создании).
|
||||||
|
*
|
||||||
|
* listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadConcreteRequest). Имеет смысл
|
||||||
|
* только вместе с existingId: новая заявка всегда создаётся в ТЕКУЩЕЙ
|
||||||
|
* партиции — approval-route переключает её сам, по своему порогу элементов.
|
||||||
|
*/
|
||||||
|
export async function saveConcreteRequest(
|
||||||
|
existingId: number | undefined,
|
||||||
|
requestTypeId: number,
|
||||||
|
data: IFormData,
|
||||||
|
approvers: IApproverToWrite[],
|
||||||
|
status: string,
|
||||||
|
listId?: string
|
||||||
|
): Promise<ISaveResult> {
|
||||||
|
const item = buildItem(data, status);
|
||||||
|
|
||||||
|
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
|
||||||
|
await writeRoute(concreteRequestApprovalService(listId), result.id, approvers, [], status);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.back {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: $sp-2;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
padding: 0;
|
||||||
|
border: 0;
|
||||||
|
background: transparent;
|
||||||
|
color: $navy-700;
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: color .18s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
color: $gold-600;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,307 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||||
|
import styles from './EmployeeTransferForm.module.scss';
|
||||||
|
import {
|
||||||
|
Alert,
|
||||||
|
FormCard,
|
||||||
|
InitiatorLine,
|
||||||
|
FormModeProvider,
|
||||||
|
Icon,
|
||||||
|
RequestNumber,
|
||||||
|
SubmitActions,
|
||||||
|
useRequestSubmit
|
||||||
|
} from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApprovalMatrix,
|
||||||
|
StatusBadge,
|
||||||
|
useMatrixEditor,
|
||||||
|
getPlannedMatrix,
|
||||||
|
resolveWriteListId,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId,
|
||||||
|
REQUEST_STATUS,
|
||||||
|
isEditableStatus,
|
||||||
|
IApproverToWrite,
|
||||||
|
unassignedStepMessage
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { IRequestFormProps } from '../../models/types';
|
||||||
|
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
|
||||||
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import {
|
||||||
|
approvalListTitle,
|
||||||
|
approvalListTitleForListId,
|
||||||
|
dataListTitle,
|
||||||
|
dataListTitleForListId
|
||||||
|
} from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { saveEmployeeTransferRequest, employeeTransferApprovalService } from './submit';
|
||||||
|
import { loadEmployeeTransferRequest } from './load';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
const EmployeeTransferForm: React.FC<IRequestFormProps> = ({
|
||||||
|
requestType,
|
||||||
|
context,
|
||||||
|
onCancel,
|
||||||
|
onSaved,
|
||||||
|
editId,
|
||||||
|
editListId,
|
||||||
|
onCodeLoaded
|
||||||
|
}) => {
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [requestId, setRequestId] = useState<number | undefined>(editId);
|
||||||
|
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
|
||||||
|
const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
|
||||||
|
const submit = useRequestSubmit();
|
||||||
|
// onCodeLoaded — колбэк родителя (RequestPortal → EditFeature): его ссылка
|
||||||
|
// может меняться на каждом рендере, поэтому в зависимости эффектов идёт
|
||||||
|
// стабильная обёртка, а не сам проп — иначе заявка перезапрашивалась бы при
|
||||||
|
// каждом рендере родителя.
|
||||||
|
const notifyCode = useStableCallback(onCodeLoaded);
|
||||||
|
// submit целиком в зависимости класть нельзя (пересоздаётся при каждой смене
|
||||||
|
// saving/error), а setError стабилен — его и берём.
|
||||||
|
const { setError: setSubmitError } = submit;
|
||||||
|
|
||||||
|
const readOnly = !isEditableStatus(requestStatus);
|
||||||
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
|
||||||
|
// editListId уже проверен в EditFeature (см. её комментарий) — если бы партиции
|
||||||
|
// не нашлось в реестре, форма сюда вообще не смонтировалась бы, поэтому здесь
|
||||||
|
// employeeTransferApprovalService можно звать не опасаясь исключения.
|
||||||
|
const approval = useMemo(() => employeeTransferApprovalService(editListId), [editListId]);
|
||||||
|
// pageUrl формы (requestType.id совпадает с ним по конвенции портала, см.
|
||||||
|
// data/requests.ts) → числовой RequestTypeId, нужный approval-route API.
|
||||||
|
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||||
|
const requestTypeId = requestTypeIdState.id;
|
||||||
|
|
||||||
|
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
loadEmployeeTransferRequest(editId, editListId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setRequestStatus(loaded.status);
|
||||||
|
setRequestCode(loaded.code || undefined);
|
||||||
|
if (loaded.code) notifyCode(loaded.code);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
setSubmitError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [editId, editListId, notifyCode, setSubmitError]);
|
||||||
|
|
||||||
|
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя,
|
||||||
|
// его текущую должность и организации (Employee/ByEmail — см. shared/dictionary/
|
||||||
|
// employeeOrganizations.service.ts; сотрудник может состоять сразу в
|
||||||
|
// нескольких организациях, должность берём из ПЕРВОЙ записи).
|
||||||
|
useEffect(() => {
|
||||||
|
if (editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
const user = context.pageContext.user;
|
||||||
|
setData((prev) => ({ ...prev, Employee: prev.Employee || user.email }));
|
||||||
|
getEmployeeOrganizations(context, user.email)
|
||||||
|
.then((records) => {
|
||||||
|
if (!alive) return;
|
||||||
|
setData((prev) => ({
|
||||||
|
...prev,
|
||||||
|
Position: prev.Position || records[0]?.position || prev.Position,
|
||||||
|
Organization: formatEmployeeOrganizations(records)
|
||||||
|
}));
|
||||||
|
})
|
||||||
|
.catch(() => undefined);
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// context — единственный экземпляр WebPartContext на всё время жизни
|
||||||
|
// веб-части, так что перезапуска эффекта эта зависимость не добавляет.
|
||||||
|
}, [editId, context]);
|
||||||
|
|
||||||
|
// Выбор другого сотрудника подтягивает его текущую должность и организации.
|
||||||
|
const handleEmployeeChange = (login: string): void => {
|
||||||
|
setData((prev) => ({ ...prev, Employee: login }));
|
||||||
|
if (!login) {
|
||||||
|
setData((prev) => ({ ...prev, Organization: '' }));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
getEmployeeOrganizations(context, login)
|
||||||
|
.then((records) =>
|
||||||
|
setData((prev) => ({
|
||||||
|
...prev,
|
||||||
|
Position: records[0]?.position || prev.Position,
|
||||||
|
Organization: formatEmployeeOrganizations(records)
|
||||||
|
}))
|
||||||
|
)
|
||||||
|
.catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
// Планируемый маршрут резолвится по e-mail ВЫБРАННОГО сотрудника (не текущего
|
||||||
|
// пользователя) — так работает подача за другого. У заявки на редактировании
|
||||||
|
// маршрут читается из уже записанных строк, чтобы не затереть правки инициатора.
|
||||||
|
const loadMatrix = useCallback(
|
||||||
|
() =>
|
||||||
|
editId
|
||||||
|
? approval.getMatrixForRequest(editId)
|
||||||
|
: getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval'),
|
||||||
|
[context, approval, editId, data.Employee, requestTypeId]
|
||||||
|
);
|
||||||
|
const matrix = useMatrixEditor(
|
||||||
|
loadMatrix,
|
||||||
|
`${data.Employee}-${editId ?? 'new'}`,
|
||||||
|
!readOnly,
|
||||||
|
!!editId || (!!data.Employee && !!requestTypeId),
|
||||||
|
(login) => approval.getJobTitle(login)
|
||||||
|
);
|
||||||
|
|
||||||
|
const isValid = !!(
|
||||||
|
data.Employee &&
|
||||||
|
data.Position.trim() &&
|
||||||
|
data.TransferDate &&
|
||||||
|
data.NewPosition.trim() &&
|
||||||
|
data.NewDepartment.trim()
|
||||||
|
);
|
||||||
|
const validate = (): string | undefined => {
|
||||||
|
if (!isValid) {
|
||||||
|
return 'Заполните обязательные поля: сотрудник, текущая должность, дата перевода, новая должность, новое подразделение.';
|
||||||
|
}
|
||||||
|
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||||
|
if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
|
||||||
|
rows.map((r) => ({
|
||||||
|
email: r.email,
|
||||||
|
position: r.position,
|
||||||
|
allowReassign: r.allowReassign,
|
||||||
|
order: r.order,
|
||||||
|
// Транзитом из маршрута в строку списка: наследование бэкенд применил
|
||||||
|
// при resolve, форма только переносит значения (см. IMatrixRow.slaHours).
|
||||||
|
slaHours: r.slaHours,
|
||||||
|
askOverdueReason: r.askOverdueReason
|
||||||
|
}));
|
||||||
|
|
||||||
|
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||||
|
// validate()/validateSubmit() уже гарантировали requestTypeId к моменту вызова
|
||||||
|
// (см. useRequestSubmit.run — валидирует ДО save), но TS этого через границу
|
||||||
|
// замыкания не видит — локальный const и явная проверка снимают обе проблемы.
|
||||||
|
const rtId = requestTypeId;
|
||||||
|
if (!rtId) {
|
||||||
|
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||||
|
}
|
||||||
|
// requestId уже задан → редактируем существующую заявку, пишем в ту же
|
||||||
|
// партицию (editListId); иначе резолвится ТЕКУЩАЯ (см. resolveWriteListId —
|
||||||
|
// именно этот запрос проверяет порог элементов и запускает архивацию).
|
||||||
|
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
|
||||||
|
const { id, code } = await saveEmployeeTransferRequest(
|
||||||
|
requestId,
|
||||||
|
rtId,
|
||||||
|
data,
|
||||||
|
toApprovers(matrix.rows),
|
||||||
|
status,
|
||||||
|
writeListId
|
||||||
|
);
|
||||||
|
setRequestId(id);
|
||||||
|
setRequestStatus(status);
|
||||||
|
if (code) {
|
||||||
|
setRequestCode(code);
|
||||||
|
}
|
||||||
|
if (onSaved) {
|
||||||
|
onSaved();
|
||||||
|
}
|
||||||
|
// Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
|
||||||
|
// Имена списков — той же партиции, куда фактически записана заявка (writeListId),
|
||||||
|
// не текущей: поток ищет строку маршрута именно в НЕЙ.
|
||||||
|
if (status === REQUEST_STATUS.onApproval) {
|
||||||
|
await notifyActiveStep(context, approval, id, {
|
||||||
|
requestTypeId: rtId,
|
||||||
|
dataListName: writeListId ? dataListTitleForListId(FORM_ID, writeListId) : dataListTitle(FORM_ID),
|
||||||
|
approvalListName: writeListId ? approvalListTitleForListId(FORM_ID, writeListId) : approvalListTitle(FORM_ID)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// На отправку (в отличие от черновика) маршрут должен быть полностью
|
||||||
|
// укомплектован — иначе шаг без назначенного человека молча пропадёт при записи.
|
||||||
|
const validateSubmit = (): string | undefined => {
|
||||||
|
const formError = validate();
|
||||||
|
if (formError) return formError;
|
||||||
|
if (matrix.error) {
|
||||||
|
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
|
||||||
|
}
|
||||||
|
const unassignedError = unassignedStepMessage(
|
||||||
|
matrix.rows,
|
||||||
|
(r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
|
||||||
|
);
|
||||||
|
if (unassignedError) return unassignedError;
|
||||||
|
return undefined;
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||||
|
const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||||
|
|
||||||
|
const sectionProps = { data, set, context, onEmployeeChange: handleEmployeeChange };
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<button type="button" className={styles.back} onClick={onCancel}>
|
||||||
|
<Icon name="arrow-left" size="sm" />
|
||||||
|
<span>К списку заявок</span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
<FormCard
|
||||||
|
title={requestType.title}
|
||||||
|
subtitle="Категория: Отдел кадров"
|
||||||
|
belowSubtitle={
|
||||||
|
<InitiatorLine
|
||||||
|
listTitle={editListId ? dataListTitleForListId(FORM_ID, editListId) : dataListTitle(FORM_ID)}
|
||||||
|
itemId={requestId}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
headerRight={
|
||||||
|
requestId || requestStatus ? (
|
||||||
|
<>
|
||||||
|
{requestStatus && <StatusBadge status={requestStatus} />}
|
||||||
|
{requestCode && <RequestNumber code={requestCode} />}
|
||||||
|
</>
|
||||||
|
) : undefined
|
||||||
|
}
|
||||||
|
>
|
||||||
|
{submit.savedKind && !submit.error && (
|
||||||
|
<Alert variant="ok">
|
||||||
|
{submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
|
||||||
|
</Alert>
|
||||||
|
)}
|
||||||
|
{submit.error && <Alert variant="err">{submit.error}</Alert>}
|
||||||
|
|
||||||
|
<FormModeProvider readOnly={readOnly}>
|
||||||
|
<RequestSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
|
||||||
|
|
||||||
|
<SubmitActions
|
||||||
|
submit={submit}
|
||||||
|
isValid={isValid}
|
||||||
|
readOnly={readOnly}
|
||||||
|
onCancel={onCancel}
|
||||||
|
onSaveDraft={handleSaveDraft}
|
||||||
|
onSubmit={handleSubmit}
|
||||||
|
submitLabel="Отправить на согласование"
|
||||||
|
/>
|
||||||
|
</FormCard>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default EmployeeTransferForm;
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.state {
|
||||||
|
padding: $sp-8;
|
||||||
|
color: $gray-500;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.toolbar {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: flex-end;
|
||||||
|
gap: $sp-3;
|
||||||
|
margin-bottom: $sp-4;
|
||||||
|
}
|
||||||
@@ -0,0 +1,175 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||||
|
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import styles from './EmployeeTransferView.module.scss';
|
||||||
|
import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintSplitButton, OrgLetterhead } from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApproverService,
|
||||||
|
DecisionPanel,
|
||||||
|
StatusBadge,
|
||||||
|
ApprovalMatrix,
|
||||||
|
useMatrixEditor,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import {
|
||||||
|
approvalListTitle,
|
||||||
|
approvalListTitleForListId,
|
||||||
|
dataListTitle,
|
||||||
|
dataListTitleForListId
|
||||||
|
} from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
|
import { loadEmployeeTransferRequest } from './load';
|
||||||
|
import { employeeTransferApprovalService } from './submit';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
interface IEmployeeTransferViewProps {
|
||||||
|
context: WebPartContext;
|
||||||
|
itemId: number;
|
||||||
|
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||||
|
formKey: string;
|
||||||
|
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||||
|
listId?: string;
|
||||||
|
/** Уведомление о загруженном уникальном коде заявки — см. IApprovalViewProps.onCodeLoaded. */
|
||||||
|
onCodeLoaded?: (code: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||||
|
const NOOP_SET: SetField = () => undefined;
|
||||||
|
|
||||||
|
// Заявка на перемещение только для просмотра (режим согласующего). Переиспользует
|
||||||
|
// ту же секцию, что и форма подачи; редактирование выключено через
|
||||||
|
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||||
|
const EmployeeTransferView: React.FC<IEmployeeTransferViewProps> = ({ context, itemId, formKey, listId, onCodeLoaded }) => {
|
||||||
|
// onCodeLoaded — колбэк родителя (RequestPortal → ApproveFeature): его ссылка
|
||||||
|
// может меняться на каждом рендере, поэтому в зависимости эффекта загрузки
|
||||||
|
// идёт стабильная обёртка, а не сам проп — иначе заявка перезапрашивалась бы
|
||||||
|
// при каждом рендере родителя.
|
||||||
|
const notifyCode = useStableCallback(onCodeLoaded);
|
||||||
|
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||||
|
const [status, setStatus] = useState<string>('');
|
||||||
|
const [code, setCode] = useState<string>('');
|
||||||
|
const [loading, setLoading] = useState<boolean>(true);
|
||||||
|
const [error, setError] = useState<string | null>(null);
|
||||||
|
// Какая из организаций сотрудника (см. OrganizationField) идёт в печать —
|
||||||
|
// выбор в тулбаре через PrintSplitButton, по умолчанию первая.
|
||||||
|
const [printOrgIndex, setPrintOrgIndex] = useState<number>(0);
|
||||||
|
|
||||||
|
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||||
|
// employeeTransferApprovalService можно звать не опасаясь исключения.
|
||||||
|
const approval = useMemo(() => employeeTransferApprovalService(listId), [listId]);
|
||||||
|
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||||
|
// Ref списка данных для ApproverService.updateRequestStatus: listId (url) для
|
||||||
|
// архивной партиции, Title текущей — иначе (см. ApproverService.dataListRef).
|
||||||
|
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||||
|
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||||
|
|
||||||
|
// Матрица маршрута из фактических строк заявки (read-only). decisionSeq в
|
||||||
|
// reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||||
|
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||||
|
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId), [approval, itemId]);
|
||||||
|
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||||
|
approval.getJobTitle(l)
|
||||||
|
);
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
let alive = true;
|
||||||
|
setLoading(true);
|
||||||
|
loadEmployeeTransferRequest(itemId, listId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) {
|
||||||
|
setData(loaded.data);
|
||||||
|
setStatus(loaded.status);
|
||||||
|
setCode(loaded.code);
|
||||||
|
notifyCode(loaded.code);
|
||||||
|
setError(null);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (alive) {
|
||||||
|
setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
|
||||||
|
setLoading(false);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [itemId, listId, notifyCode]);
|
||||||
|
|
||||||
|
if (loading) {
|
||||||
|
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||||
|
}
|
||||||
|
if (error) {
|
||||||
|
return (
|
||||||
|
<div className={styles.state}>
|
||||||
|
<Alert variant="err">{error}</Alert>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const sectionProps = { data, set: NOOP_SET, context, printOrgIndex };
|
||||||
|
|
||||||
|
const notify = (): void => {
|
||||||
|
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||||
|
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
|
||||||
|
// весь UI ради необязательного оповещения.
|
||||||
|
if (!requestTypeId) return;
|
||||||
|
notifyActiveStep(context, approval, itemId, {
|
||||||
|
requestTypeId,
|
||||||
|
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
|
||||||
|
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
|
||||||
|
}).catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<div className={`${styles.toolbar} rp-no-print`}>
|
||||||
|
<PrintSplitButton value={data.Organization} selectedIndex={printOrgIndex} onChange={setPrintOrgIndex} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="rp-print-root">
|
||||||
|
<OrgLetterhead value={data.Organization} selectedIndex={printOrgIndex} />
|
||||||
|
<FormCard
|
||||||
|
title="Заявка на перемещение сотрудника"
|
||||||
|
subtitle={`№${code || itemId}`}
|
||||||
|
belowSubtitle={
|
||||||
|
<InitiatorLine
|
||||||
|
listTitle={listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID)}
|
||||||
|
itemId={itemId}
|
||||||
|
/>
|
||||||
|
}
|
||||||
|
headerRight={status ? <StatusBadge status={status} /> : undefined}
|
||||||
|
>
|
||||||
|
<FormModeProvider readOnly>
|
||||||
|
<RequestSection {...sectionProps} />
|
||||||
|
</FormModeProvider>
|
||||||
|
</FormCard>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый). */}
|
||||||
|
<div className="rp-no-print">
|
||||||
|
<DecisionPanel
|
||||||
|
service={approverService}
|
||||||
|
requestId={itemId}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
onDecided={(newStatus) => {
|
||||||
|
setStatus(newStatus);
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
onDelegated={() => {
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default EmployeeTransferView;
|
||||||
@@ -0,0 +1,50 @@
|
|||||||
|
# Заявка на перемещение сотрудника (hr-transfer)
|
||||||
|
|
||||||
|
**Назначение:** заявление сотрудника директору ТОО с просьбой перевести его на
|
||||||
|
другую должность и/или в другое подразделение. Бумажный первоисточник — типовой
|
||||||
|
бланк «Заявление» (перевод) с согласованием начальника подразделения.
|
||||||
|
**Категория:** Отдел кадров
|
||||||
|
**Списки SP:** «Заявка на перемещение сотрудника — данные» / «Заявка на перемещение сотрудника — согласование»
|
||||||
|
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||||
|
`pageUrl` («hr-transfer») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
||||||
|
RequestTypeId» в `docs/forms.md`). Тип и маршрут нужно завести в админке approval-route.
|
||||||
|
|
||||||
|
## Маршрут
|
||||||
|
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||||
|
получает статус «Согласовано» (как «Заявка на отпуск» / «Отпуск без содержания»).
|
||||||
|
- **Матрица редактируема заявителем** при новой заявке / черновике / возврате:
|
||||||
|
`useMatrixEditor(editable = !readOnly)`.
|
||||||
|
- Запланированный шаблон маршрута (approval-route, заводится в админке): шаг 1 —
|
||||||
|
`HeadType.Chief` (непосредственный руководитель сотрудника), шаг 2 —
|
||||||
|
`HeadType.CompanyDirectors` (директор компании сотрудника, как в «Заявлении на
|
||||||
|
увольнение») — по бумажному шаблону заявление адресовано директору ТОО, а
|
||||||
|
согласовывает его начальник подразделения.
|
||||||
|
|
||||||
|
## Особое поведение
|
||||||
|
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
||||||
|
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного**
|
||||||
|
сотрудника, reloadKey матрицы включает `data.Employee`.
|
||||||
|
- **Автоподстановка при выборе сотрудника:** текущая должность (`Position`,
|
||||||
|
редактируема — справочник не всегда точен) и организации (`Organization`,
|
||||||
|
read-only, `OrganizationField`) — из `Employee/ByEmail` (`shared/dictionary`),
|
||||||
|
тот же приём, что у «Заявки на отпуск».
|
||||||
|
- **Новая должность** (`NewPosition`) — свободный текст.
|
||||||
|
- **Новое подразделение** (`NewDepartment`/`NewDepartmentId`) — справочник
|
||||||
|
`Dictionary/Departments` (`shared/dictionary/DepartmentPicker`), не влияет на
|
||||||
|
маршрут (справочное поле, как «Подразделение» в «Заявке на отпуск»).
|
||||||
|
- **Дата перевода** (`TransferDate`) — обязательна, ограничений по сроку
|
||||||
|
уведомления (в отличие от отпуска/увольнения) шаблон не задаёт.
|
||||||
|
- **Комментарий** (`Comment`) — необязательный свободный текст.
|
||||||
|
- **Заголовок элемента** (`Title`): `Перемещение — {ФИО} — дд.мм.гггг`.
|
||||||
|
- **Печать** (`PrintSplitButton`/`OrgLetterhead`) — как у «Заявки на отпуск»:
|
||||||
|
сотрудник может состоять сразу в нескольких организациях, печатается бланк с
|
||||||
|
шапкой выбранной компании.
|
||||||
|
|
||||||
|
## Секции формы
|
||||||
|
RequestSection (сотрудник · текущая должность · организация (read-only) · дата
|
||||||
|
перевода · новая должность · новое подразделение · комментарий)
|
||||||
|
|
||||||
|
## Точки входа
|
||||||
|
- rptype: `hr-transfer`
|
||||||
|
- Режим согласующего (просмотр): есть (`EmployeeTransferView`)
|
||||||
|
- «Создать на основе»: нет
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Заявка на перемещение сотрудника — согласование",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "TansuSiteApprover", "title": "Согласующий", "type": "User", "userSelectionMode": "PeopleOnly" },
|
||||||
|
{ "internalName": "ApprovalStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "Ждёт очереди", "На согласовании", "На исполнении", "Согласовано", "Выполнено", "Отклонено", "Возвращена на доработку"] },
|
||||||
|
{ "internalName": "Ticket", "title": "Заявка", "type": "Lookup", "lookupList": "Заявка на перемещение сотрудника — данные", "lookupShowField": "Title" },
|
||||||
|
{ "internalName": "Date", "title": "Дата", "type": "DateTime" },
|
||||||
|
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||||
|
{ "internalName": "StepOrder", "title": "Порядок", "type": "Number" },
|
||||||
|
{ "internalName": "AllowReassignToOtherApprovers", "title": "Можно перепоручать", "type": "Boolean" },
|
||||||
|
{ "internalName": "Phase", "title": "Фаза", "type": "Choice", "choices": ["Согласование", "Исполнение"] },
|
||||||
|
{ "internalName": "SLAhours", "title": "SLA, часов", "type": "Number" },
|
||||||
|
{ "internalName": "AskOverdueReason", "title": "Опрос причины просрочки", "type": "Boolean" },
|
||||||
|
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,63 @@
|
|||||||
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||||
|
|
||||||
|
export interface ILoadedRequest {
|
||||||
|
data: IFormData;
|
||||||
|
/** Ф.И.О. сотрудника из поля Employee (для заголовка режима чтения). */
|
||||||
|
employeeName: string;
|
||||||
|
status: string;
|
||||||
|
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||||
|
code: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Прочитать заявку на перемещение по id: модель формы + статус (правка / просмотр).
|
||||||
|
*
|
||||||
|
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
|
||||||
|
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
|
||||||
|
* по url списка, а не по имени: так не нужно резолвить, как называется архивный
|
||||||
|
* список, и запрос не зависит от реестра партиций.
|
||||||
|
*/
|
||||||
|
export async function loadEmployeeTransferRequest(itemId: number, listId?: string): Promise<ILoadedRequest> {
|
||||||
|
const list = listId ? getSP().web.getList(listId) : getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
|
||||||
|
const item = (await list
|
||||||
|
.items.getById(itemId)
|
||||||
|
.select(
|
||||||
|
'Id',
|
||||||
|
'Position',
|
||||||
|
'Organization',
|
||||||
|
'TransferDate',
|
||||||
|
'NewPosition',
|
||||||
|
'NewDepartment',
|
||||||
|
'NewDepartmentId',
|
||||||
|
'Comment',
|
||||||
|
'RequestStatus',
|
||||||
|
'RequestUniqueCode',
|
||||||
|
'Employee/Title',
|
||||||
|
'Employee/EMail'
|
||||||
|
)
|
||||||
|
.expand('Employee')()) as Record<string, unknown>;
|
||||||
|
|
||||||
|
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
|
||||||
|
const transferDate = (item.TransferDate as string) || '';
|
||||||
|
|
||||||
|
const data: IFormData = {
|
||||||
|
...EMPTY_DATA,
|
||||||
|
Employee: employee?.EMail || '',
|
||||||
|
Position: (item.Position as string) || '',
|
||||||
|
Organization: (item.Organization as string) || '',
|
||||||
|
TransferDate: transferDate.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||||
|
NewPosition: (item.NewPosition as string) || '',
|
||||||
|
NewDepartment: (item.NewDepartment as string) || '',
|
||||||
|
NewDepartmentId: (item.NewDepartmentId as string) || '',
|
||||||
|
Comment: (item.Comment as string) || ''
|
||||||
|
};
|
||||||
|
|
||||||
|
return {
|
||||||
|
data,
|
||||||
|
employeeName: employee?.Title || '',
|
||||||
|
status: (item.RequestStatus as string) || '',
|
||||||
|
code: (item.RequestUniqueCode as string) || ''
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import { RequestTypeId } from '../../models/types';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||||
|
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||||
|
*/
|
||||||
|
export const FORM_ID: RequestTypeId = 'hr-transfer';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Данные формы «Заявка на перемещение сотрудника» по бумажному шаблону (заявление
|
||||||
|
* директору ТОО с просьбой перевести на другую должность/в другое подразделение).
|
||||||
|
* Ключи по возможности = internalName колонок списка данных (см. shared/listTitles.ts).
|
||||||
|
* Employee хранит e-mail сотрудника (то, что отдаёт PeopleField); по нему резолвится
|
||||||
|
* маршрут согласования, поэтому заявку можно подать и за другого сотрудника.
|
||||||
|
*/
|
||||||
|
export interface IFormData {
|
||||||
|
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
||||||
|
Employee: string;
|
||||||
|
/** Текущая должность — подтягивается автоматически из Employee/ByEmail, но редактируема (справочник не всегда точен). */
|
||||||
|
Position: string;
|
||||||
|
/**
|
||||||
|
* Организации сотрудника (`\n`-joined «Компания — должность» на строку) —
|
||||||
|
* подтягивается автоматически из Employee/ByEmail (см.
|
||||||
|
* shared/dictionary/employeeOrganizations.service.ts) при выборе Employee,
|
||||||
|
* read-only (см. shared/ui/OrganizationField). Сотрудник может состоять
|
||||||
|
* сразу в нескольких организациях — тогда строк несколько.
|
||||||
|
*/
|
||||||
|
Organization: string;
|
||||||
|
/** Дата, с которой сотрудник переводится на новую должность. ISO YYYY-MM-DD (input type=date). */
|
||||||
|
TransferDate: string;
|
||||||
|
/** Новая должность, на которую переводится сотрудник. */
|
||||||
|
NewPosition: string;
|
||||||
|
/** Новое подразделение (справочник Dictionary/Departments, см. shared/dictionary/DepartmentPicker). */
|
||||||
|
NewDepartment: string;
|
||||||
|
/** Id нового подразделения из справочника; '' — если введено вручную без выбора из списка. */
|
||||||
|
NewDepartmentId: string;
|
||||||
|
/** Необязательный комментарий заявителя. */
|
||||||
|
Comment: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
|
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||||
|
|
||||||
|
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker). */
|
||||||
|
export interface ISectionProps {
|
||||||
|
data: IFormData;
|
||||||
|
set: SetField;
|
||||||
|
context: WebPartContext;
|
||||||
|
/**
|
||||||
|
* Выбор сотрудника подтягивает его текущую должность и организации — поэтому
|
||||||
|
* у поля «Сотрудник» отдельный обработчик. Если не передан (режим чтения) —
|
||||||
|
* правка через set.
|
||||||
|
*/
|
||||||
|
onEmployeeChange?: (login: string) => void;
|
||||||
|
/** Индекс организации для печати (см. shared/ui/PrintSplitButton и OrganizationField.printIndex). */
|
||||||
|
printOrgIndex?: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const EMPTY_DATA: IFormData = {
|
||||||
|
Employee: '',
|
||||||
|
Position: '',
|
||||||
|
Organization: '',
|
||||||
|
TransferDate: '',
|
||||||
|
NewPosition: '',
|
||||||
|
NewDepartment: '',
|
||||||
|
NewDepartmentId: '',
|
||||||
|
Comment: ''
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Плейсхолдер для поля выбора сотрудника. */
|
||||||
|
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Заявка на перемещение сотрудника — данные",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||||
|
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||||
|
|
||||||
|
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
||||||
|
{ "internalName": "Position", "title": "Текущая должность", "type": "Text" },
|
||||||
|
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||||
|
{ "internalName": "TransferDate", "title": "Дата перевода", "type": "DateTime", "dateOnly": true },
|
||||||
|
{ "internalName": "NewPosition", "title": "Новая должность", "type": "Text" },
|
||||||
|
{ "internalName": "NewDepartment", "title": "Новое подразделение", "type": "Text" },
|
||||||
|
{ "internalName": "NewDepartmentId", "title": "Id нового подразделения (справочник)", "type": "Text" },
|
||||||
|
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { FormGrid, FormField, TextInput, TextArea, PeopleField, OrganizationField } from '../../../shared/ui';
|
||||||
|
import { DepartmentPicker } from '../../../shared/dictionary';
|
||||||
|
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
||||||
|
|
||||||
|
/** Единственная секция формы «Заявка на перемещение сотрудника»: кто и куда переводится. */
|
||||||
|
export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, onEmployeeChange, printOrgIndex }) => (
|
||||||
|
<FormGrid>
|
||||||
|
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.Employee}
|
||||||
|
onChange={onEmployeeChange ?? ((v) => set('Employee', v))}
|
||||||
|
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Текущая должность" htmlFor="Position" required>
|
||||||
|
<TextInput id="Position" value={data.Position} onChange={(v) => set('Position', v)} />
|
||||||
|
</FormField>
|
||||||
|
<OrganizationField value={data.Organization} printIndex={printOrgIndex} />
|
||||||
|
<FormField label="Дата перевода" htmlFor="TransferDate" required>
|
||||||
|
<TextInput id="TransferDate" type="date" value={data.TransferDate} onChange={(v) => set('TransferDate', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Новая должность" htmlFor="NewPosition" required>
|
||||||
|
<TextInput id="NewPosition" value={data.NewPosition} onChange={(v) => set('NewPosition', v)} />
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Новое подразделение" htmlFor="NewDepartment" required>
|
||||||
|
<DepartmentPicker
|
||||||
|
id="NewDepartment"
|
||||||
|
context={context}
|
||||||
|
value={data.NewDepartment}
|
||||||
|
onChange={(name, id) => {
|
||||||
|
set('NewDepartment', name);
|
||||||
|
set('NewDepartmentId', id);
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Комментарий" htmlFor="Comment" full>
|
||||||
|
<TextArea id="Comment" value={data.Comment} onChange={(v) => set('Comment', v)} />
|
||||||
|
</FormField>
|
||||||
|
</FormGrid>
|
||||||
|
);
|
||||||
@@ -0,0 +1,67 @@
|
|||||||
|
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||||
|
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
||||||
|
import { ensureEmployee } from '../../shared/employee';
|
||||||
|
import { FORM_ID, IFormData } from './model';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||||
|
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
|
||||||
|
* именем формы для читаемости вызывающего кода.
|
||||||
|
*/
|
||||||
|
export function employeeTransferApprovalService(listId?: string): ApprovalListService {
|
||||||
|
return approvalServiceFor(FORM_ID, listId);
|
||||||
|
}
|
||||||
|
|
||||||
|
function pad2(n: number): string {
|
||||||
|
return n < 10 ? `0${n}` : `${n}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||||
|
function buildTitle(employeeName: string): string {
|
||||||
|
const now = new Date();
|
||||||
|
return `Перемещение — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Поля элемента списка данных из модели формы (+ Employee по Id). */
|
||||||
|
function buildItem(data: IFormData, status: string, employeeId: number, employeeName: string): Record<string, unknown> {
|
||||||
|
return {
|
||||||
|
Title: buildTitle(employeeName),
|
||||||
|
RequestStatus: status,
|
||||||
|
EmployeeId: employeeId,
|
||||||
|
Position: data.Position || null,
|
||||||
|
Organization: data.Organization || null,
|
||||||
|
TransferDate: data.TransferDate || null,
|
||||||
|
NewPosition: data.NewPosition || null,
|
||||||
|
NewDepartment: data.NewDepartment || null,
|
||||||
|
NewDepartmentId: data.NewDepartmentId || null,
|
||||||
|
Comment: data.Comment || null
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export type ISaveResult = ISaveItemResult;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сохранить заявку на перемещение: содержимое + маршрут согласования.
|
||||||
|
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||||
|
* Фазы исполнения нет — writeRoute вызывается с пустым списком исполнителей.
|
||||||
|
* Возвращает Id заявки (+ код при создании).
|
||||||
|
*
|
||||||
|
* listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadEmployeeTransferRequest). Имеет
|
||||||
|
* смысл только вместе с existingId: новая заявка всегда создаётся в ТЕКУЩЕЙ
|
||||||
|
* партиции — approval-route переключает её сам, по своему порогу элементов.
|
||||||
|
*/
|
||||||
|
export async function saveEmployeeTransferRequest(
|
||||||
|
existingId: number | undefined,
|
||||||
|
requestTypeId: number,
|
||||||
|
data: IFormData,
|
||||||
|
approvers: IApproverToWrite[],
|
||||||
|
status: string,
|
||||||
|
listId?: string
|
||||||
|
): Promise<ISaveResult> {
|
||||||
|
const employee = await ensureEmployee(data.Employee);
|
||||||
|
const item = buildItem(data, status, employee.Id, employee.Title || data.Employee);
|
||||||
|
|
||||||
|
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
|
||||||
|
await writeRoute(employeeTransferApprovalService(listId), result.id, approvers, [], status);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
@@ -43,6 +43,7 @@ export const ApplicationSection: React.FC<ISectionProps> = ({ data, set, context
|
|||||||
type="date"
|
type="date"
|
||||||
value={data.ClosingDeadline}
|
value={data.ClosingDeadline}
|
||||||
onChange={(v) => set('ClosingDeadline', v)}
|
onChange={(v) => set('ClosingDeadline', v)}
|
||||||
|
min={data.SubmitDate || undefined}
|
||||||
/>
|
/>
|
||||||
</FormField>
|
</FormField>
|
||||||
<FormField label="1.5 Причина открытия вакансии" htmlFor="VacancyOpenReason">
|
<FormField label="1.5 Причина открытия вакансии" htmlFor="VacancyOpenReason">
|
||||||
|
|||||||
@@ -45,6 +45,12 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
|||||||
),
|
),
|
||||||
'hr-dismissal': React.lazy(
|
'hr-dismissal': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'form-dismissal' */ './Dismissal/DismissalForm')
|
() => import(/* webpackChunkName: 'form-dismissal' */ './Dismissal/DismissalForm')
|
||||||
|
),
|
||||||
|
'hr-transfer': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'form-employee-transfer' */ './EmployeeTransfer/EmployeeTransferForm')
|
||||||
|
),
|
||||||
|
'wh-concrete-request': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'form-concrete-request' */ './ConcreteRequest/ConcreteRequestForm')
|
||||||
)
|
)
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|||||||
@@ -64,6 +64,12 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
|||||||
),
|
),
|
||||||
'hr-dismissal': React.lazy(
|
'hr-dismissal': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'view-dismissal' */ './Dismissal/DismissalView')
|
() => import(/* webpackChunkName: 'view-dismissal' */ './Dismissal/DismissalView')
|
||||||
|
),
|
||||||
|
'hr-transfer': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'view-employee-transfer' */ './EmployeeTransfer/EmployeeTransferView')
|
||||||
|
),
|
||||||
|
'wh-concrete-request': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'view-concrete-request' */ './ConcreteRequest/ConcreteRequestView')
|
||||||
)
|
)
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|||||||
@@ -27,7 +27,9 @@ import {
|
|||||||
/** База имени по типу заявки. Ключи — те же, что в реестре форм (forms/registry.ts). */
|
/** База имени по типу заявки. Ключи — те же, что в реестре форм (forms/registry.ts). */
|
||||||
const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
||||||
'clearance-form': 'Обходной лист',
|
'clearance-form': 'Обходной лист',
|
||||||
|
'wh-concrete-request': 'Заявка на бетон',
|
||||||
'hr-dismissal': 'Заявление на увольнение',
|
'hr-dismissal': 'Заявление на увольнение',
|
||||||
|
'hr-transfer': 'Заявка на перемещение сотрудника',
|
||||||
'hr-vacation': 'Заявка на отпуск',
|
'hr-vacation': 'Заявка на отпуск',
|
||||||
'hr-unpaid-leave': 'Отпуск без содержания',
|
'hr-unpaid-leave': 'Отпуск без содержания',
|
||||||
'it-1c-ticket': 'Заявка в отдел 1С',
|
'it-1c-ticket': 'Заявка в отдел 1С',
|
||||||
|
|||||||
Reference in New Issue
Block a user