feat: каркас заявки «Изменение условий трудового договора»
Новая кадровая форма (hr-contract-change, только тестировщикам): сотрудник из кадровой базы снимком в текстовых колонках и вид изменения из 10 по ст. 33 ТК РК. Вид хранится MultiChoice-массивом, хотя по ТЗ выбирается один, — чтобы разрешить несколько без миграции. Маршрут — по сотруднику, а без учётной записи — по заявителю. Поля по видам добавляются отдельно. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -51,6 +51,7 @@
|
|||||||
| [`hr-skud-explanation`](../src/webparts/requestPortal/forms/SkudExplanation/README.md) | Объяснительная об отсутствии отметок в СКУД | Отдел кадров | да | нет | да | только «на себя»; дни выбираются кликом в календаре «Мой СКУД» (проходы Hikvision текущего пользователя), сохраняются снимком для согласующего; текст записки собирается автоматически, печать — бланк объяснительной | ⏳ код готов, списки/тип/маршрут не заведены |
|
| [`hr-skud-explanation`](../src/webparts/requestPortal/forms/SkudExplanation/README.md) | Объяснительная об отсутствии отметок в СКУД | Отдел кадров | да | нет | да | только «на себя»; дни выбираются кликом в календаре «Мой СКУД» (проходы Hikvision текущего пользователя), сохраняются снимком для согласующего; текст записки собирается автоматически, печать — бланк объяснительной | ⏳ код готов, списки/тип/маршрут не заведены |
|
||||||
| [`hr-business-trip`](../src/webparts/requestPortal/forms/BusinessTrip/README.md) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; командирующая организация — выбор из организаций сотрудника; маршрут лентой (точки по Казахстану — город из справочника КАТО на русском и казахском + объект из справочника, за рубежом — страна/город/объект вручную; даты не задним числом, поездка ≤ 40 дней; участки с видом транспорта и временем выезда); суточные (≤ 6 МРП КЗ / ≤ 8 за рубежом) и проживание (ночи сами, ≤ 15 000 ₸ за ночь КЗ) — по точкам; комментарий после итога; задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
|
| [`hr-business-trip`](../src/webparts/requestPortal/forms/BusinessTrip/README.md) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; командирующая организация — выбор из организаций сотрудника; маршрут лентой (точки по Казахстану — город из справочника КАТО на русском и казахском + объект из справочника, за рубежом — страна/город/объект вручную; даты не задним числом, поездка ≤ 40 дней; участки с видом транспорта и временем выезда); суточные (≤ 6 МРП КЗ / ≤ 8 за рубежом) и проживание (ночи сами, ≤ 15 000 ₸ за ночь КЗ) — по точкам; комментарий после итога; задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
|
||||||
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
||||||
|
| [`hr-contract-change`](../src/webparts/requestPortal/forms/ContractChange/README.md) | Изменение условий трудового договора | Отдел кадров | да | — | да | сотрудник из `Employee/FullBase` (и без учётки M365), снимок в текстовых колонках; маршрут по сотруднику, без учётки — по заявителю; 10 видов изменения (один, данные под несколько); поля по видам — в работе | ⏳ каркас, списки/тип/маршрут не заведены |
|
||||||
| [`wh-service-request`](../src/webparts/requestPortal/forms/ServiceRequest/README.md) | Заявка на услуги | Склад / Снабжение | да | нет | да | маршрут по проекту (руководитель проекта/ПТО); табличные части «Приложения» и «Смета» (JSON-колонки); сумма по смете считается на лету (qty × цена), итог дублируется числовой колонкой для отчётов | ✅ |
|
| [`wh-service-request`](../src/webparts/requestPortal/forms/ServiceRequest/README.md) | Заявка на услуги | Склад / Снабжение | да | нет | да | маршрут по проекту (руководитель проекта/ПТО); табличные части «Приложения» и «Смета» (JSON-колонки); сумма по смете считается на лету (qty × цена), итог дублируется числовой колонкой для отчётов | ✅ |
|
||||||
|
|
||||||
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
||||||
|
|||||||
@@ -42,6 +42,14 @@ export const REQUEST_TYPES: IRequestType[] = [
|
|||||||
icon: 'people',
|
icon: 'people',
|
||||||
comingSoon: true
|
comingSoon: true
|
||||||
},
|
},
|
||||||
|
// Пока только тестировщикам: каркас без полей по видам; тип и маршрут не заведены в админке approval-route.
|
||||||
|
{
|
||||||
|
id: 'hr-contract-change',
|
||||||
|
categoryId: 'hr',
|
||||||
|
title: 'Изменение условий трудового договора',
|
||||||
|
icon: 'document',
|
||||||
|
comingSoon: true
|
||||||
|
},
|
||||||
|
|
||||||
// Склад / Снабжение — формы открыты для ознакомления, но приём заявок ещё не
|
// Склад / Снабжение — формы открыты для ознакомления, но приём заявок ещё не
|
||||||
// запущен (маршруты/списки не готовы): кнопки сохранения/отправки в самих
|
// запущен (маршруты/списки не готовы): кнопки сохранения/отправки в самих
|
||||||
|
|||||||
@@ -0,0 +1,21 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
// Ссылка «К списку заявок» — как в остальных формах (см. DismissalForm.module.scss).
|
||||||
|
.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,298 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||||
|
import styles from './ContractChangeForm.module.scss';
|
||||||
|
import {
|
||||||
|
Alert,
|
||||||
|
FormCard,
|
||||||
|
InitiatorLine,
|
||||||
|
FormModeProvider,
|
||||||
|
Icon,
|
||||||
|
RequestNumber,
|
||||||
|
SubmitActions,
|
||||||
|
getDraftDeleteHandler,
|
||||||
|
useRequestSubmit
|
||||||
|
} from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
composeRemoveRowRule,
|
||||||
|
ApprovalMatrix,
|
||||||
|
ExecutorsMatrix,
|
||||||
|
ApprovalHistory,
|
||||||
|
StatusBadge,
|
||||||
|
useMatrixEditor,
|
||||||
|
getPlannedMatrix,
|
||||||
|
loadRoutePhase,
|
||||||
|
isOpenedRouteReady,
|
||||||
|
notifyActiveStep,
|
||||||
|
useRequestTypeId,
|
||||||
|
REQUEST_STATUS,
|
||||||
|
isEditableStatus,
|
||||||
|
IApproverToWrite,
|
||||||
|
unassignedStepMessage,
|
||||||
|
resolveWriteListId,
|
||||||
|
executorsToWrite,
|
||||||
|
initialSubmitStatus,
|
||||||
|
useFormExecutors
|
||||||
|
} from '../../shared/approval';
|
||||||
|
import { effectiveUserEmail } from '../../shared/impersonation';
|
||||||
|
import { IRequestFormProps } from '../../models/types';
|
||||||
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import {
|
||||||
|
approvalListTitle,
|
||||||
|
approvalListTitleForListId,
|
||||||
|
dataListTitle,
|
||||||
|
dataListTitleForListId
|
||||||
|
} from '../../shared/listTitles';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField, REQUIRED_FIELDS_MESSAGE, routeEmail } from './model';
|
||||||
|
import { saveContractChangeRequest, contractChangeApprovalService } from './submit';
|
||||||
|
import { loadContractChangeRequest } from './load';
|
||||||
|
import { useSelfEmployee } from './useSelfEmployee';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
const ContractChangeForm: 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();
|
||||||
|
// Стабильная обёртка над колбэком родителя — иначе заявка перезапрашивалась бы
|
||||||
|
// при каждом рендере родителя (см. DismissalForm).
|
||||||
|
const notifyCode = useStableCallback(onCodeLoaded);
|
||||||
|
const { setError: setSubmitError } = submit;
|
||||||
|
|
||||||
|
const readOnly = !isEditableStatus(requestStatus);
|
||||||
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
const applicantEmail = effectiveUserEmail(context);
|
||||||
|
|
||||||
|
const approval = useMemo(() => contractChangeApprovalService(editListId), [editListId]);
|
||||||
|
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||||
|
const requestTypeId = requestTypeIdState.id;
|
||||||
|
|
||||||
|
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!editId) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
loadContractChangeRequest(editId, editListId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (!alive) return;
|
||||||
|
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]);
|
||||||
|
|
||||||
|
// Новая заявка — по умолчанию на себя. Не перетираем, если пользователь успел
|
||||||
|
// выбрать другого, пока шёл поиск своей записи.
|
||||||
|
useSelfEmployee(context, applicantEmail, !editId, (record) =>
|
||||||
|
setData((prev) => (prev.Employee ? prev : { ...prev, Employee: record }))
|
||||||
|
);
|
||||||
|
|
||||||
|
// Маршрут — по сотруднику, а без учётной записи — по заявителю (см. routeEmail).
|
||||||
|
// У заявки на редактировании маршрут читается из уже записанных строк.
|
||||||
|
const routeUserEmail = routeEmail(data.Employee, applicantEmail);
|
||||||
|
const loadMatrix = useCallback(
|
||||||
|
() =>
|
||||||
|
loadRoutePhase(approval, editId, requestStatus, 'Approval', () =>
|
||||||
|
getPlannedMatrix(context, requestTypeId as number, routeUserEmail, approval, 'Approval')
|
||||||
|
),
|
||||||
|
[context, approval, editId, requestStatus, routeUserEmail, requestTypeId]
|
||||||
|
);
|
||||||
|
const matrix = useMatrixEditor(
|
||||||
|
loadMatrix,
|
||||||
|
`${routeUserEmail}-${editId ?? 'new'}`,
|
||||||
|
!readOnly,
|
||||||
|
isOpenedRouteReady(editId, requestStatus, requestTypeId) && (!!editId || (!!routeUserEmail && !!requestTypeId)),
|
||||||
|
(login) => approval.getJobTitle(login)
|
||||||
|
);
|
||||||
|
|
||||||
|
const executors = useFormExecutors({
|
||||||
|
readOnly,
|
||||||
|
context,
|
||||||
|
approval,
|
||||||
|
requestTypeId,
|
||||||
|
userEmail: routeUserEmail,
|
||||||
|
editId,
|
||||||
|
requestStatus
|
||||||
|
});
|
||||||
|
|
||||||
|
const isValid = !!data.Employee && data.ChangeTypes.length > 0;
|
||||||
|
const validate = (): string | undefined => {
|
||||||
|
if (!isValid) return REQUIRED_FIELDS_MESSAGE;
|
||||||
|
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,
|
||||||
|
slaHours: r.slaHours,
|
||||||
|
askOverdueReason: r.askOverdueReason,
|
||||||
|
autoApprove: r.autoApprove
|
||||||
|
}));
|
||||||
|
|
||||||
|
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||||
|
// validate() уже гарантировал requestTypeId, но TS этого через замыкание не видит.
|
||||||
|
const rtId = requestTypeId;
|
||||||
|
if (!rtId) {
|
||||||
|
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||||
|
}
|
||||||
|
// Новая заявка пишется в ТЕКУЩУЮ партицию — спрашиваем её прямо перед записью.
|
||||||
|
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
|
||||||
|
const { id, code } = await saveContractChangeRequest(
|
||||||
|
requestId,
|
||||||
|
rtId,
|
||||||
|
data,
|
||||||
|
toApprovers(matrix.rows),
|
||||||
|
executorsToWrite(executors.rows),
|
||||||
|
status,
|
||||||
|
writeListId
|
||||||
|
);
|
||||||
|
setRequestId(id);
|
||||||
|
setRequestStatus(status);
|
||||||
|
if (code) setRequestCode(code);
|
||||||
|
if (onSaved) onSaved();
|
||||||
|
// Отправка — уведомляем первый активный шаг; списки той партиции, куда записали.
|
||||||
|
if (status === REQUEST_STATUS.onApproval || status === REQUEST_STATUS.execution) {
|
||||||
|
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 unassignedStepMessage(
|
||||||
|
executors.rows,
|
||||||
|
(r) => `Шаг ${r.order} исполнения («${r.position || 'без должности'}») без назначенного человека — обратитесь к администратору маршрута.`
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||||
|
const handleSubmit = (): Promise<void> =>
|
||||||
|
submit.run(
|
||||||
|
'submit',
|
||||||
|
save(
|
||||||
|
executors.rows.length > 0
|
||||||
|
? initialSubmitStatus(matrix.rows.length, executors.rows.length)
|
||||||
|
: REQUEST_STATUS.onApproval
|
||||||
|
),
|
||||||
|
validateSubmit
|
||||||
|
);
|
||||||
|
|
||||||
|
const handleDelete = getDraftDeleteHandler({
|
||||||
|
formKey: FORM_ID,
|
||||||
|
requestId,
|
||||||
|
requestStatus,
|
||||||
|
listId: editListId,
|
||||||
|
code: requestCode,
|
||||||
|
submit,
|
||||||
|
onDeleted: onCancel
|
||||||
|
});
|
||||||
|
|
||||||
|
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 data={data} set={set} context={context} />
|
||||||
|
</FormModeProvider>
|
||||||
|
|
||||||
|
<ApprovalMatrix
|
||||||
|
editor={matrix}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
canRemoveRow={composeRemoveRowRule(applicantEmail)}
|
||||||
|
/>
|
||||||
|
|
||||||
|
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
|
||||||
|
|
||||||
|
{/* Автору на доработке важно видеть, почему вернули, — история и в форме. */}
|
||||||
|
{editId && (
|
||||||
|
<div className="rp-no-print">
|
||||||
|
<ApprovalHistory
|
||||||
|
approval={approval}
|
||||||
|
dataListRef={editListId || dataListTitle(FORM_ID)}
|
||||||
|
requestId={editId}
|
||||||
|
reloadKey={requestStatus}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
|
<SubmitActions
|
||||||
|
onDelete={handleDelete}
|
||||||
|
submit={submit}
|
||||||
|
isValid={isValid}
|
||||||
|
readOnly={readOnly}
|
||||||
|
onCancel={onCancel}
|
||||||
|
onSaveDraft={handleSaveDraft}
|
||||||
|
onSubmit={handleSubmit}
|
||||||
|
submitLabel="Отправить на согласование"
|
||||||
|
/>
|
||||||
|
</FormCard>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default ContractChangeForm;
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
@import '../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
// Заглушка на время загрузки/ошибки — как в остальных просмотрах.
|
||||||
|
.state {
|
||||||
|
padding: $sp-8;
|
||||||
|
color: $gray-500;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
@@ -0,0 +1,163 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||||
|
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import styles from './ContractChangeView.module.scss';
|
||||||
|
import { Alert, FormCard, InitiatorLine, FormModeProvider } from '../../shared/ui';
|
||||||
|
import {
|
||||||
|
ApproverService,
|
||||||
|
DecisionPanel,
|
||||||
|
StatusBadge,
|
||||||
|
ApprovalMatrix,
|
||||||
|
ApprovalHistory,
|
||||||
|
useMatrixEditor,
|
||||||
|
useViewExecutors,
|
||||||
|
ExecutorsMatrix,
|
||||||
|
approvalPhaseRows,
|
||||||
|
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 { loadContractChangeRequest } from './load';
|
||||||
|
import { contractChangeApprovalService } from './submit';
|
||||||
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
import { useStableCallback } from '../../shared/useStableCallback';
|
||||||
|
|
||||||
|
interface IContractChangeViewProps {
|
||||||
|
context: WebPartContext;
|
||||||
|
itemId: number;
|
||||||
|
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||||
|
formKey: string;
|
||||||
|
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||||
|
listId?: string;
|
||||||
|
/** Уведомление о загруженном уникальном коде заявки — см. IApprovalViewProps.onCodeLoaded. */
|
||||||
|
onCodeLoaded?: (code: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
const VIEW_TITLE = 'Изменение условий трудового договора';
|
||||||
|
|
||||||
|
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||||
|
const NOOP_SET: SetField = () => undefined;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Заявка только для просмотра (режим согласующего): та же секция, что в форме
|
||||||
|
* подачи, под <FormModeProvider readOnly>, + маршрут, история и панель решения.
|
||||||
|
* Печати пока нет — бланк кадров ещё не согласован.
|
||||||
|
*/
|
||||||
|
const ContractChangeView: React.FC<IContractChangeViewProps> = ({ context, itemId, formKey, listId, onCodeLoaded }) => {
|
||||||
|
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>('');
|
||||||
|
|
||||||
|
const approval = useMemo(() => contractChangeApprovalService(listId), [listId]);
|
||||||
|
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||||
|
// listId (url) для архивной партиции, Title текущей — см. ApproverService.dataListRef.
|
||||||
|
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||||
|
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||||
|
|
||||||
|
// decisionSeq в reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||||
|
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||||
|
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId).then(approvalPhaseRows), [approval, itemId]);
|
||||||
|
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||||
|
approval.getJobTitle(l)
|
||||||
|
);
|
||||||
|
const executors = useViewExecutors(context, approval, itemId, decisionSeq);
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
let alive = true;
|
||||||
|
setLoading(true);
|
||||||
|
loadContractChangeRequest(itemId, listId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (!alive) return;
|
||||||
|
setData(loaded.data);
|
||||||
|
setStatus(loaded.status);
|
||||||
|
setCode(loaded.code);
|
||||||
|
notifyCode(loaded.code);
|
||||||
|
setError('');
|
||||||
|
setLoading(false);
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
if (!alive) return;
|
||||||
|
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 notify = (): void => {
|
||||||
|
// Тип ещё не резолвился — решение уже применилось, просто некого уведомлять;
|
||||||
|
// не роняем 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);
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleRouteChanged = (): void => {
|
||||||
|
setDecisionSeq((n) => n + 1);
|
||||||
|
notify();
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div>
|
||||||
|
<FormCard
|
||||||
|
title={VIEW_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 data={data} set={NOOP_SET} context={context} />
|
||||||
|
</FormModeProvider>
|
||||||
|
</FormCard>
|
||||||
|
|
||||||
|
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||||
|
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
|
||||||
|
|
||||||
|
{/* История: маршрут пересохраняется патчем (см. writeRoute), прошлые решения — в версиях строк. */}
|
||||||
|
<ApprovalHistory approval={approval} dataListRef={dataListRef} requestId={itemId} reloadKey={decisionSeq} />
|
||||||
|
|
||||||
|
<DecisionPanel
|
||||||
|
service={approverService}
|
||||||
|
requestId={itemId}
|
||||||
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
onDecided={(newStatus) => {
|
||||||
|
setStatus(newStatus);
|
||||||
|
handleRouteChanged();
|
||||||
|
}}
|
||||||
|
onDelegated={handleRouteChanged}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
export default ContractChangeView;
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
# Изменение условий трудового договора (hr-contract-change)
|
||||||
|
|
||||||
|
**Назначение:** заявка на изменение условий трудового договора сотрудника (ст. 33 ТК РК) —
|
||||||
|
повышение оклада, надбавка, перевод, смена режима работы и т. д. (10 видов из ТЗ кадров).
|
||||||
|
**Категория:** Отдел кадров
|
||||||
|
**Списки SP:** «Изменение условий трудового договора 1 — данные» / «… 1 — согласование»
|
||||||
|
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||||
|
`pageUrl` («hr-contract-change») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
||||||
|
RequestTypeId» в `docs/forms.md`). Тип и маршрут в админке approval-route ещё не заведены.
|
||||||
|
|
||||||
|
> **Статус: каркас.** Есть сотрудник и вид изменения; поля под конкретные виды
|
||||||
|
> добавляются по мере разбора ТЗ кадров. Таблица ТЗ (пример, кто инициирует, что
|
||||||
|
> приложить, сроки, маршрут А/Б/В/Г…) — общая, в форму из неё попадает только то,
|
||||||
|
> что явно согласовано. Печатного бланка пока нет.
|
||||||
|
|
||||||
|
## Маршрут
|
||||||
|
- Фазы: согласование (+ исполнение, если его заведут в админке — форма поддерживает).
|
||||||
|
- Маршрут строится по **e-mail сотрудника**, а если его нет (рабочий без учётной
|
||||||
|
записи M365) — по **e-mail заявителя** (`routeEmail` в `model.ts`); на форме под
|
||||||
|
сотрудником тогда пометка об этом.
|
||||||
|
- Матрица редактируема заявителем при новой заявке / черновике / возврате.
|
||||||
|
- От вида изменения маршрут пока не зависит (`fieldValues` не передаются).
|
||||||
|
|
||||||
|
## Особое поведение
|
||||||
|
- **Сотрудник — из `Employee/FullBase`, а не People-picker** (`EmployeeFullBasePicker`,
|
||||||
|
`shared/dictionary`): так находятся и рабочие без учётной записи. Ищется по части
|
||||||
|
Ф.И.О. (от 3 букв), только работающие (`dismissalDate` пустая). Запись = одно место
|
||||||
|
работы: совместитель виден несколькими строками, выбирается нужная компания.
|
||||||
|
- **Хранение сотрудника — снимок в текстовых колонках `Employee*`** (Ф.И.О., ИИН,
|
||||||
|
табельный, e-mail, организация, должность, подразделение, id записи), без колонки
|
||||||
|
People. Справочник со временем меняется, а заявка фиксирует данные на момент подачи.
|
||||||
|
- **По умолчанию — на себя** (`useSelfEmployee`): Ф.И.О. из `Employee/ByEmail` →
|
||||||
|
поиск в `FullBase` → записи с e-mail текущего пользователя. Подставляется, только
|
||||||
|
если такая запись ровно одна — совместителю компанию не выбираем молча.
|
||||||
|
- **Вид изменения** — `ChangeTypes`, MultiChoice в SP, массив в модели. По ТЗ выбор
|
||||||
|
один (`MAX_CHANGE_TYPES`, обычный `Select`); данные уже рассчитаны на несколько,
|
||||||
|
чтобы снять ограничение правкой UI, без миграции. В коде вид — ключ
|
||||||
|
(`ChangeType`), в SP — подпись (`CHANGE_TYPE_LABELS`): подпись = choice колонки,
|
||||||
|
менять только вместе с `provisioning.json`.
|
||||||
|
- **Заголовок элемента** (`Title`): `Изменение условий ТД — {ФИО} — дд.мм.гггг`.
|
||||||
|
|
||||||
|
## Открытые вопросы (проверить на тесте)
|
||||||
|
- Выдаёт ли бэкенд (вебхуки) права на элемент по People-колонке `Employee`? Если да —
|
||||||
|
сотрудник, за которого подали заявку, её не увидит (такой колонки здесь нет).
|
||||||
|
- `Employee/FullBase`: ищет ли `Fio` по подстроке; что фильтрует `Status`.
|
||||||
|
|
||||||
|
## Секции формы
|
||||||
|
RequestSection (сотрудник · вид изменения)
|
||||||
|
|
||||||
|
## Точки входа
|
||||||
|
- rptype: `hr-contract-change`
|
||||||
|
- Режим согласующего (просмотр): есть (`ContractChangeView`), без печати
|
||||||
|
- «Создать на основе»: нет
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
{
|
||||||
|
"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": "AutoApprove", "title": "Автосогласование", "type": "Boolean" },
|
||||||
|
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
import { ISelectOption } from '../../shared/ui';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Виды изменения условий трудового договора (ст. 33 ТК РК) — по ТЗ кадров.
|
||||||
|
*
|
||||||
|
* В коде вид — стабильный ключ (union ниже), в SharePoint — его подпись: колонка
|
||||||
|
* ChangeTypes (MultiChoice) хранит текст, чтобы кадры видели в списке и отчётах
|
||||||
|
* понятные значения. Подпись = choice колонки, поэтому менять её можно только
|
||||||
|
* вместе с choices в provisioning.json (иначе старые заявки перестанут узнаваться).
|
||||||
|
*/
|
||||||
|
export type ChangeType =
|
||||||
|
| 'salary-increase'
|
||||||
|
| 'allowance'
|
||||||
|
| 'position-transfer'
|
||||||
|
| 'department-transfer'
|
||||||
|
| 'workplace-change'
|
||||||
|
| 'contract-extension'
|
||||||
|
| 'schedule-change'
|
||||||
|
| 'function-change'
|
||||||
|
| 'employer-initiative'
|
||||||
|
| 'temporary-transfer';
|
||||||
|
|
||||||
|
/** Порядок — как в ТЗ (в нём же показываются в выпадающем списке). */
|
||||||
|
export const CHANGE_TYPE_LABELS: Record<ChangeType, string> = {
|
||||||
|
'salary-increase': 'Повышение должностного оклада',
|
||||||
|
allowance: 'Установление надбавки / доплаты',
|
||||||
|
'position-transfer': 'Перевод на другую должность (постоянный)',
|
||||||
|
'department-transfer': 'Перевод в другое подразделение',
|
||||||
|
'workplace-change': 'Изменение места работы (другая местность)',
|
||||||
|
'contract-extension': 'Продление срока трудового договора',
|
||||||
|
'schedule-change':
|
||||||
|
'Изменение режима / графика работы по соглашению сторон; неполное рабочее время по просьбе работника',
|
||||||
|
'function-change': 'Изменение трудовой функции (без смены должности)',
|
||||||
|
// Самая длинная подпись (~225 символов) — близко к лимиту choice в SP (255), не удлинять.
|
||||||
|
'employer-initiative':
|
||||||
|
'Изменение условий труда по инициативе работодателя по причинам экономического, технологического характера, ' +
|
||||||
|
'изменений в организации и (или) сокращения объёма работ (снижение оклада, сокращение рабочего времени, изменение графика)',
|
||||||
|
'temporary-transfer': 'Временный перевод при производственной необходимости / простое'
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сколько видов можно выбрать в одной заявке. По ТЗ — один; данные (массив
|
||||||
|
* ChangeTypes + MultiChoice-колонка) уже рассчитаны на несколько, чтобы снять
|
||||||
|
* ограничение правкой UI, а не миграцией.
|
||||||
|
*/
|
||||||
|
export const MAX_CHANGE_TYPES = 1;
|
||||||
|
|
||||||
|
export const CHANGE_TYPE_OPTIONS: ISelectOption[] = (Object.keys(CHANGE_TYPE_LABELS) as ChangeType[]).map(
|
||||||
|
(type) => ({ value: type, label: CHANGE_TYPE_LABELS[type] })
|
||||||
|
);
|
||||||
|
|
||||||
|
/** Подпись из SP → ключ вида. Неизвестная подпись (переименовали choice) — undefined. */
|
||||||
|
export function changeTypeFromLabel(label: string): ChangeType | undefined {
|
||||||
|
const normalized = label.trim();
|
||||||
|
return (Object.keys(CHANGE_TYPE_LABELS) as ChangeType[]).find(
|
||||||
|
(type) => CHANGE_TYPE_LABELS[type] === normalized
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
|
import { IEmployeeFullBaseRecord } from '../../shared/dictionary';
|
||||||
|
import { ChangeType, changeTypeFromLabel } from './changeTypes';
|
||||||
|
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||||
|
|
||||||
|
export interface ILoadedRequest {
|
||||||
|
data: IFormData;
|
||||||
|
status: string;
|
||||||
|
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||||
|
code: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
function text(raw: unknown): string {
|
||||||
|
return typeof raw === 'string' ? raw : '';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Колонки Employee* → запись сотрудника (см. employeeColumns в submit.ts).
|
||||||
|
* Нет ни id, ни Ф.И.О. — сотрудник не был выбран (черновик) → undefined.
|
||||||
|
* Даты приёма/увольнения не хранятся — ''; e-mail пустой — у сотрудника нет учётки.
|
||||||
|
*/
|
||||||
|
function employeeFromItem(item: Record<string, unknown>): IEmployeeFullBaseRecord | undefined {
|
||||||
|
const id = text(item.EmployeeRecordId);
|
||||||
|
const fio = text(item.EmployeeFio);
|
||||||
|
if (!id && !fio) return undefined;
|
||||||
|
return {
|
||||||
|
id,
|
||||||
|
fio,
|
||||||
|
iin: text(item.EmployeeIin),
|
||||||
|
code: text(item.EmployeeCode),
|
||||||
|
company: text(item.EmployeeCompany),
|
||||||
|
position: text(item.EmployeePosition),
|
||||||
|
department: text(item.EmployeeDepartment),
|
||||||
|
admissionDate: '',
|
||||||
|
dismissalDate: '',
|
||||||
|
email: text(item.EmployeeEmail)
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* MultiChoice → ключи видов. Подпись, которой нет в CHANGE_TYPE_LABELS (choice
|
||||||
|
* переименовали в SP, а код — нет), пропускаем с предупреждением в консоли:
|
||||||
|
* форма покажет «вид не выбран», и при отправке валидация попросит выбрать заново.
|
||||||
|
*/
|
||||||
|
function changeTypesFromItem(raw: unknown): ChangeType[] {
|
||||||
|
const labels = Array.isArray(raw) ? raw.filter((v): v is string => typeof v === 'string') : [];
|
||||||
|
const types: ChangeType[] = [];
|
||||||
|
labels.forEach((label) => {
|
||||||
|
const type = changeTypeFromLabel(label);
|
||||||
|
if (type) {
|
||||||
|
types.push(type);
|
||||||
|
} else {
|
||||||
|
console.warn(`[ContractChange] Неизвестный вид изменения «${label}» — нет в CHANGE_TYPE_LABELS`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
return types;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Прочитать заявку по id: модель формы + статус (правка / просмотр).
|
||||||
|
*
|
||||||
|
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
|
||||||
|
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
|
||||||
|
* по url списка.
|
||||||
|
*/
|
||||||
|
export async function loadContractChangeRequest(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',
|
||||||
|
'RequestStatus',
|
||||||
|
'RequestUniqueCode',
|
||||||
|
'EmployeeRecordId',
|
||||||
|
'EmployeeFio',
|
||||||
|
'EmployeeIin',
|
||||||
|
'EmployeeCode',
|
||||||
|
'EmployeeEmail',
|
||||||
|
'EmployeeCompany',
|
||||||
|
'EmployeePosition',
|
||||||
|
'EmployeeDepartment',
|
||||||
|
'ChangeTypes'
|
||||||
|
)()) as Record<string, unknown>;
|
||||||
|
|
||||||
|
const data: IFormData = {
|
||||||
|
...EMPTY_DATA,
|
||||||
|
Employee: employeeFromItem(item),
|
||||||
|
ChangeTypes: changeTypesFromItem(item.ChangeTypes)
|
||||||
|
};
|
||||||
|
|
||||||
|
return {
|
||||||
|
data,
|
||||||
|
status: text(item.RequestStatus),
|
||||||
|
code: text(item.RequestUniqueCode)
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -0,0 +1,67 @@
|
|||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import { RequestTypeId } from '../../models/types';
|
||||||
|
import { IEmployeeFullBaseRecord } from '../../shared/dictionary';
|
||||||
|
import { ChangeType } from './changeTypes';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||||
|
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||||
|
*/
|
||||||
|
export const FORM_ID: RequestTypeId = 'hr-contract-change';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Данные формы «Изменение условий трудового договора» (ст. 33 ТК РК).
|
||||||
|
*
|
||||||
|
* Сотрудник — запись из Employee/FullBase, а не People: заявку подают и за
|
||||||
|
* рабочих без учётной записи M365. В списке SP запись лежит снимком в текстовых
|
||||||
|
* колонках Employee* (разборка/сборка — submit.ts/load.ts); даты приёма и
|
||||||
|
* увольнения не храним — после загрузки они ''.
|
||||||
|
*
|
||||||
|
* Поля под конкретные виды изменения добавляются по мере согласования с кадрами
|
||||||
|
* — каждый вид своим блоком с префиксом имён (см. changeTypes.ts).
|
||||||
|
*/
|
||||||
|
export interface IFormData {
|
||||||
|
/** Сотрудник, чьи условия ТД меняются (одно место работы). undefined — не выбран. */
|
||||||
|
Employee: IEmployeeFullBaseRecord | undefined;
|
||||||
|
/**
|
||||||
|
* Выбранные виды изменения. По ТЗ ровно один (MAX_CHANGE_TYPES), массив —
|
||||||
|
* задел под несколько, см. changeTypes.ts. [] — не выбран.
|
||||||
|
*/
|
||||||
|
ChangeTypes: ChangeType[];
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
|
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||||
|
|
||||||
|
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (запросы к справочникам). */
|
||||||
|
export interface ISectionProps {
|
||||||
|
data: IFormData;
|
||||||
|
set: SetField;
|
||||||
|
context: WebPartContext;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const EMPTY_DATA: IFormData = {
|
||||||
|
Employee: undefined,
|
||||||
|
ChangeTypes: []
|
||||||
|
};
|
||||||
|
|
||||||
|
/** Плейсхолдер для поля выбора сотрудника. */
|
||||||
|
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
||||||
|
/** Плейсхолдер для выбора вида изменения. */
|
||||||
|
export const CHANGE_TYPE_PLACEHOLDER = '— выберите вид изменения —';
|
||||||
|
/**
|
||||||
|
* Пояснение под сотрудником без учётной записи: approval-route резолвит маршрут
|
||||||
|
* по e-mail, а его нет — маршрут строится по заявителю (см. routeEmail в форме).
|
||||||
|
*/
|
||||||
|
export const ROUTE_BY_APPLICANT_NOTE =
|
||||||
|
'У сотрудника нет учётной записи — маршрут согласования построен по заявителю.';
|
||||||
|
export const REQUIRED_FIELDS_MESSAGE = 'Заполните обязательные поля: сотрудник, вид изменения.';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* E-mail, по которому строится маршрут: сотрудника, а если у него нет учётной
|
||||||
|
* записи (рабочие на объектах) — заявителя.
|
||||||
|
*/
|
||||||
|
export function routeEmail(employee: IEmployeeFullBaseRecord | undefined, applicantEmail: string): string {
|
||||||
|
if (!employee) return '';
|
||||||
|
return employee.email || applicantEmail;
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
{
|
||||||
|
"dataListTitle": "Изменение условий трудового договора — данные",
|
||||||
|
"columns": [
|
||||||
|
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||||
|
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||||
|
|
||||||
|
{ "internalName": "EmployeeRecordId", "title": "Сотрудник: id записи кадровой базы", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeFio", "title": "Сотрудник: Ф.И.О.", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeIin", "title": "Сотрудник: ИИН", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeCode", "title": "Сотрудник: табельный номер", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeEmail", "title": "Сотрудник: e-mail", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeCompany", "title": "Сотрудник: организация", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeePosition", "title": "Сотрудник: должность", "type": "Text" },
|
||||||
|
{ "internalName": "EmployeeDepartment", "title": "Сотрудник: подразделение", "type": "Text" },
|
||||||
|
|
||||||
|
{ "internalName": "ChangeTypes", "title": "Вид изменения", "type": "Choice", "allowMultiple": true, "choices": [
|
||||||
|
"Повышение должностного оклада",
|
||||||
|
"Установление надбавки / доплаты",
|
||||||
|
"Перевод на другую должность (постоянный)",
|
||||||
|
"Перевод в другое подразделение",
|
||||||
|
"Изменение места работы (другая местность)",
|
||||||
|
"Продление срока трудового договора",
|
||||||
|
"Изменение режима / графика работы по соглашению сторон; неполное рабочее время по просьбе работника",
|
||||||
|
"Изменение трудовой функции (без смены должности)",
|
||||||
|
"Изменение условий труда по инициативе работодателя по причинам экономического, технологического характера, изменений в организации и (или) сокращения объёма работ (снижение оклада, сокращение рабочего времени, изменение графика)",
|
||||||
|
"Временный перевод при производственной необходимости / простое"
|
||||||
|
] }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
@import '../../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
// Пояснение под полем «Сотрудник» (маршрут по заявителю — см. ROUTE_BY_APPLICANT_NOTE).
|
||||||
|
.note {
|
||||||
|
margin-top: $sp-1;
|
||||||
|
font-size: $fs-label;
|
||||||
|
color: $gray-500;
|
||||||
|
}
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { FormGrid, FormField, Select } from '../../../shared/ui';
|
||||||
|
import { useFormReadOnly } from '@tnsu/ui-kit';
|
||||||
|
import { EmployeeFullBasePicker } from '../../../shared/dictionary';
|
||||||
|
import { ChangeType, CHANGE_TYPE_OPTIONS } from '../changeTypes';
|
||||||
|
import { ISectionProps, EMPLOYEE_PLACEHOLDER, CHANGE_TYPE_PLACEHOLDER, ROUTE_BY_APPLICANT_NOTE } from '../model';
|
||||||
|
import styles from './RequestSection.module.scss';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Общая часть заявки, не зависящая от вида изменения: чьи условия ТД меняются и
|
||||||
|
* что именно. Поля конкретных видов — отдельными секциями (добавляются по ТЗ кадров).
|
||||||
|
*/
|
||||||
|
export const RequestSection: React.FC<ISectionProps> = ({ data, set, context }) => {
|
||||||
|
const readOnly = useFormReadOnly();
|
||||||
|
const hasNoAccount = !!data.Employee && !data.Employee.email;
|
||||||
|
|
||||||
|
// По ТЗ вид один (MAX_CHANGE_TYPES), поэтому обычный Select: значение — первый
|
||||||
|
// элемент массива, выбор заменяет массив целиком. Под несколько видов здесь
|
||||||
|
// встанет MultiChoiceField, модель и SP уже готовы.
|
||||||
|
const selectedType = data.ChangeTypes[0] || '';
|
||||||
|
const handleTypeChange = (value: string): void => {
|
||||||
|
set('ChangeTypes', value ? [value as ChangeType] : []);
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<FormGrid>
|
||||||
|
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||||
|
<EmployeeFullBasePicker
|
||||||
|
context={context}
|
||||||
|
id="Employee"
|
||||||
|
value={data.Employee}
|
||||||
|
onChange={(v) => set('Employee', v)}
|
||||||
|
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
{!readOnly && hasNoAccount && <div className={styles.note}>{ROUTE_BY_APPLICANT_NOTE}</div>}
|
||||||
|
</FormField>
|
||||||
|
<FormField label="Вид изменения" htmlFor="ChangeTypes" required full>
|
||||||
|
<Select
|
||||||
|
id="ChangeTypes"
|
||||||
|
value={selectedType}
|
||||||
|
onChange={handleTypeChange}
|
||||||
|
options={CHANGE_TYPE_OPTIONS}
|
||||||
|
placeholder={CHANGE_TYPE_PLACEHOLDER}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
</FormGrid>
|
||||||
|
);
|
||||||
|
};
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||||
|
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
||||||
|
import { IEmployeeFullBaseRecord } from '../../shared/dictionary';
|
||||||
|
import { CHANGE_TYPE_LABELS } from './changeTypes';
|
||||||
|
import { FORM_ID, IFormData } from './model';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||||
|
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts).
|
||||||
|
*/
|
||||||
|
export function contractChangeApprovalService(listId?: string): ApprovalListService {
|
||||||
|
return approvalServiceFor(FORM_ID, listId);
|
||||||
|
}
|
||||||
|
|
||||||
|
function pad2(n: number): string {
|
||||||
|
return n < 10 ? `0${n}` : `${n}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||||
|
function buildTitle(employeeFio: string): string {
|
||||||
|
const now = new Date();
|
||||||
|
const date = `${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||||
|
return `Изменение условий ТД — ${employeeFio || 'сотрудник не выбран'} — ${date}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Снимок сотрудника → текстовые колонки Employee* (см. provisioning.json).
|
||||||
|
* Не выбран (черновик) — все колонки очищаются null (так SharePoint REST очищает
|
||||||
|
* поле), а не остаются от прошлого выбора.
|
||||||
|
*/
|
||||||
|
function employeeColumns(employee: IEmployeeFullBaseRecord | undefined): Record<string, unknown> {
|
||||||
|
return {
|
||||||
|
EmployeeRecordId: employee?.id || null,
|
||||||
|
EmployeeFio: employee?.fio || null,
|
||||||
|
EmployeeIin: employee?.iin || null,
|
||||||
|
EmployeeCode: employee?.code || null,
|
||||||
|
EmployeeEmail: employee?.email || null,
|
||||||
|
EmployeeCompany: employee?.company || null,
|
||||||
|
EmployeePosition: employee?.position || null,
|
||||||
|
EmployeeDepartment: employee?.department || null
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Поля элемента списка данных из модели формы. */
|
||||||
|
function buildItem(data: IFormData, status: string): Record<string, unknown> {
|
||||||
|
return {
|
||||||
|
Title: buildTitle(data.Employee?.fio || ''),
|
||||||
|
RequestStatus: status,
|
||||||
|
...employeeColumns(data.Employee),
|
||||||
|
// MultiChoice пишется плоским массивом подписей (как «База 1С» в Ticket1C); [] очищает колонку.
|
||||||
|
ChangeTypes: data.ChangeTypes.map((type) => CHANGE_TYPE_LABELS[type])
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export type ISaveResult = ISaveItemResult;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сохранить заявку: содержимое + маршрут согласования.
|
||||||
|
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||||
|
* executors — фаза «Исполнение» маршрута из админки (пусто, если её нет).
|
||||||
|
*
|
||||||
|
* listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadContractChangeRequest); новая
|
||||||
|
* заявка всегда создаётся в текущей партиции.
|
||||||
|
*/
|
||||||
|
export async function saveContractChangeRequest(
|
||||||
|
existingId: number | undefined,
|
||||||
|
requestTypeId: number,
|
||||||
|
data: IFormData,
|
||||||
|
approvers: IApproverToWrite[],
|
||||||
|
executors: IApproverToWrite[],
|
||||||
|
status: string,
|
||||||
|
listId?: string
|
||||||
|
): Promise<ISaveResult> {
|
||||||
|
const item = buildItem(data, status);
|
||||||
|
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
|
||||||
|
await writeRoute(contractChangeApprovalService(listId), result.id, approvers, executors, status);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
import { useEffect } from 'react';
|
||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import {
|
||||||
|
IEmployeeFullBaseRecord,
|
||||||
|
getEmployeeOrganizations,
|
||||||
|
searchActiveEmployees
|
||||||
|
} from '../../shared/dictionary';
|
||||||
|
|
||||||
|
// Совпадений по Ф.И.О. немного (тёзки + совместительства) — запас с лихвой.
|
||||||
|
const MAX_NAMESAKES = 20;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Найти СВОЮ запись в Employee/FullBase. Параметра Email у эндпоинта нет, поэтому
|
||||||
|
* в два шага: Ф.И.О. из Employee/ByEmail → поиск по Ф.И.О. → записи с тем же e-mail.
|
||||||
|
*
|
||||||
|
* Возвращает запись, только если она ОДНА: у совместителя записей несколько, и
|
||||||
|
* молча подставить первую значило бы выбрать компанию за него — пусть выберет сам.
|
||||||
|
*/
|
||||||
|
async function findSelfRecord(context: WebPartContext, email: string): Promise<IEmployeeFullBaseRecord | undefined> {
|
||||||
|
const organizations = await getEmployeeOrganizations(context, email);
|
||||||
|
const fio = organizations[0]?.fio || '';
|
||||||
|
if (!fio) return undefined;
|
||||||
|
|
||||||
|
const namesakes = await searchActiveEmployees(context, fio, MAX_NAMESAKES);
|
||||||
|
const own = namesakes.filter((r) => r.email.toLowerCase() === email.toLowerCase());
|
||||||
|
return own.length === 1 ? own[0] : undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Новая заявка — по умолчанию на себя: подставляет запись текущего пользователя
|
||||||
|
* через onFound. Не нашлась (нет в базе, совместитель, сбой справочника) — поле
|
||||||
|
* просто остаётся пустым, сотрудника выбирают вручную; это не ошибка формы.
|
||||||
|
*/
|
||||||
|
export function useSelfEmployee(
|
||||||
|
context: WebPartContext,
|
||||||
|
email: string,
|
||||||
|
enabled: boolean,
|
||||||
|
onFound: (record: IEmployeeFullBaseRecord) => void
|
||||||
|
): void {
|
||||||
|
useEffect(() => {
|
||||||
|
if (!enabled || !email) return;
|
||||||
|
let alive = true;
|
||||||
|
findSelfRecord(context, email)
|
||||||
|
.then((record) => {
|
||||||
|
if (alive && record) onFound(record);
|
||||||
|
})
|
||||||
|
.catch(() => undefined);
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// onFound намеренно не в зависимостях: подстановка — один раз при открытии новой
|
||||||
|
// заявки, а не на каждый новый экземпляр колбэка у родителя.
|
||||||
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
|
}, [context, email, enabled]);
|
||||||
|
}
|
||||||
@@ -57,6 +57,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
|||||||
),
|
),
|
||||||
'wh-concrete-request': React.lazy(
|
'wh-concrete-request': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'form-concrete-request' */ './ConcreteRequest/ConcreteRequestForm')
|
() => import(/* webpackChunkName: 'form-concrete-request' */ './ConcreteRequest/ConcreteRequestForm')
|
||||||
|
),
|
||||||
|
'hr-contract-change': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'form-contract-change' */ './ContractChange/ContractChangeForm')
|
||||||
)
|
)
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|||||||
@@ -76,6 +76,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
|||||||
),
|
),
|
||||||
'wh-concrete-request': React.lazy(
|
'wh-concrete-request': React.lazy(
|
||||||
() => import(/* webpackChunkName: 'view-concrete-request' */ './ConcreteRequest/ConcreteRequestView')
|
() => import(/* webpackChunkName: 'view-concrete-request' */ './ConcreteRequest/ConcreteRequestView')
|
||||||
|
),
|
||||||
|
'hr-contract-change': React.lazy(
|
||||||
|
() => import(/* webpackChunkName: 'view-contract-change' */ './ContractChange/ContractChangeView')
|
||||||
)
|
)
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|||||||
@@ -34,6 +34,7 @@ const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
|||||||
'hr-unpaid-leave': 'Отпуск без содержания',
|
'hr-unpaid-leave': 'Отпуск без содержания',
|
||||||
'hr-skud-explanation': 'Объяснительная по СКУД',
|
'hr-skud-explanation': 'Объяснительная по СКУД',
|
||||||
'hr-business-trip': 'Заявка на командировку',
|
'hr-business-trip': 'Заявка на командировку',
|
||||||
|
'hr-contract-change': 'Изменение условий трудового договора',
|
||||||
'it-1c-ticket': 'Заявка в отдел 1С',
|
'it-1c-ticket': 'Заявка в отдел 1С',
|
||||||
'it-workplace-setup': 'Организация рабочего места',
|
'it-workplace-setup': 'Организация рабочего места',
|
||||||
'recruiting-hire': 'Прием на работу',
|
'recruiting-hire': 'Прием на работу',
|
||||||
|
|||||||
Reference in New Issue
Block a user