diff --git a/docs/forms.md b/docs/forms.md index 486fd2e..51094be 100644 --- a/docs/forms.md +++ b/docs/forms.md @@ -51,6 +51,7 @@ | [`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-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 × цена), итог дублируется числовой колонкой для отчётов | ✅ | Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения; diff --git a/src/webparts/requestPortal/data/requests.ts b/src/webparts/requestPortal/data/requests.ts index f444c8d..ae3917d 100644 --- a/src/webparts/requestPortal/data/requests.ts +++ b/src/webparts/requestPortal/data/requests.ts @@ -42,6 +42,14 @@ export const REQUEST_TYPES: IRequestType[] = [ icon: 'people', comingSoon: true }, + // Пока только тестировщикам: каркас без полей по видам; тип и маршрут не заведены в админке approval-route. + { + id: 'hr-contract-change', + categoryId: 'hr', + title: 'Изменение условий трудового договора', + icon: 'document', + comingSoon: true + }, // Склад / Снабжение — формы открыты для ознакомления, но приём заявок ещё не // запущен (маршруты/списки не готовы): кнопки сохранения/отправки в самих diff --git a/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.module.scss b/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.module.scss new file mode 100644 index 0000000..4aa03d4 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.module.scss @@ -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; + } +} diff --git a/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.tsx b/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.tsx new file mode 100644 index 0000000..10e5097 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/ContractChangeForm.tsx @@ -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 = ({ + requestType, + context, + onCancel, + onSaved, + editId, + editListId, + onCodeLoaded +}) => { + const [data, setData] = useState(EMPTY_DATA); + const [requestId, setRequestId] = useState(editId); + const [requestStatus, setRequestStatus] = useState(undefined); + const [requestCode, setRequestCode] = useState(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) => async (): Promise => { + // 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 => submit.run('draft', save(REQUEST_STATUS.draft), validate); + const handleSubmit = (): Promise => + 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 ( +
+ + + + } + headerRight={ + requestId || requestStatus ? ( + <> + {requestStatus && } + {requestCode && } + + ) : undefined + } + > + {submit.savedKind && !submit.error && ( + + {submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'} + + )} + {submit.error && {submit.error}} + + + + + + approval.searchUsers(q)} + canRemoveRow={composeRemoveRowRule(applicantEmail)} + /> + + approval.searchUsers(q)} /> + + {/* Автору на доработке важно видеть, почему вернули, — история и в форме. */} + {editId && ( +
+ +
+ )} + + + +
+ ); +}; + +export default ContractChangeForm; diff --git a/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.module.scss b/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.module.scss new file mode 100644 index 0000000..69b5abf --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.module.scss @@ -0,0 +1,9 @@ +@import '../../../../styles/design-tokens'; + +// Заглушка на время загрузки/ошибки — как в остальных просмотрах. +.state { + padding: $sp-8; + color: $gray-500; + font-size: $fs-sm; + text-align: center; +} diff --git a/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.tsx b/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.tsx new file mode 100644 index 0000000..8c52a03 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/ContractChangeView.tsx @@ -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; + +/** + * Заявка только для просмотра (режим согласующего): та же секция, что в форме + * подачи, под , + маршрут, история и панель решения. + * Печати пока нет — бланк кадров ещё не согласован. + */ +const ContractChangeView: React.FC = ({ context, itemId, formKey, listId, onCodeLoaded }) => { + const notifyCode = useStableCallback(onCodeLoaded); + const [data, setData] = useState(EMPTY_DATA); + const [status, setStatus] = useState(''); + const [code, setCode] = useState(''); + const [loading, setLoading] = useState(true); + const [error, setError] = useState(''); + + 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(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
Загрузка заявки…
; + } + if (error) { + return ( +
+ {error} +
+ ); + } + + 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 ( +
+ + } + headerRight={status ? : undefined} + > + + + + + + approval.searchUsers(q)} /> + approval.searchUsers(q)} /> + + {/* История: маршрут пересохраняется патчем (см. writeRoute), прошлые решения — в версиях строк. */} + + + approval.searchUsers(q)} + onDecided={(newStatus) => { + setStatus(newStatus); + handleRouteChanged(); + }} + onDelegated={handleRouteChanged} + /> +
+ ); +}; + +export default ContractChangeView; diff --git a/src/webparts/requestPortal/forms/ContractChange/README.md b/src/webparts/requestPortal/forms/ContractChange/README.md new file mode 100644 index 0000000..ab64438 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/README.md @@ -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`), без печати +- «Создать на основе»: нет diff --git a/src/webparts/requestPortal/forms/ContractChange/approval/provisioning.json b/src/webparts/requestPortal/forms/ContractChange/approval/provisioning.json new file mode 100644 index 0000000..a63b7c5 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/approval/provisioning.json @@ -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" } + ] +} diff --git a/src/webparts/requestPortal/forms/ContractChange/changeTypes.ts b/src/webparts/requestPortal/forms/ContractChange/changeTypes.ts new file mode 100644 index 0000000..b241ba8 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/changeTypes.ts @@ -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 = { + '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 + ); +} diff --git a/src/webparts/requestPortal/forms/ContractChange/load.ts b/src/webparts/requestPortal/forms/ContractChange/load.ts new file mode 100644 index 0000000..7ab17b1 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/load.ts @@ -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): 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 { + 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; + + const data: IFormData = { + ...EMPTY_DATA, + Employee: employeeFromItem(item), + ChangeTypes: changeTypesFromItem(item.ChangeTypes) + }; + + return { + data, + status: text(item.RequestStatus), + code: text(item.RequestUniqueCode) + }; +} diff --git a/src/webparts/requestPortal/forms/ContractChange/model.ts b/src/webparts/requestPortal/forms/ContractChange/model.ts new file mode 100644 index 0000000..236a238 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/model.ts @@ -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 = (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; +} diff --git a/src/webparts/requestPortal/forms/ContractChange/provisioning.json b/src/webparts/requestPortal/forms/ContractChange/provisioning.json new file mode 100644 index 0000000..b01dd15 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/provisioning.json @@ -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": [ + "Повышение должностного оклада", + "Установление надбавки / доплаты", + "Перевод на другую должность (постоянный)", + "Перевод в другое подразделение", + "Изменение места работы (другая местность)", + "Продление срока трудового договора", + "Изменение режима / графика работы по соглашению сторон; неполное рабочее время по просьбе работника", + "Изменение трудовой функции (без смены должности)", + "Изменение условий труда по инициативе работодателя по причинам экономического, технологического характера, изменений в организации и (или) сокращения объёма работ (снижение оклада, сокращение рабочего времени, изменение графика)", + "Временный перевод при производственной необходимости / простое" + ] } + ] +} diff --git a/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.module.scss b/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.module.scss new file mode 100644 index 0000000..a7bd5d0 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.module.scss @@ -0,0 +1,8 @@ +@import '../../../../../styles/design-tokens'; + +// Пояснение под полем «Сотрудник» (маршрут по заявителю — см. ROUTE_BY_APPLICANT_NOTE). +.note { + margin-top: $sp-1; + font-size: $fs-label; + color: $gray-500; +} diff --git a/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.tsx b/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.tsx new file mode 100644 index 0000000..d4489d1 --- /dev/null +++ b/src/webparts/requestPortal/forms/ContractChange/sections/RequestSection.tsx @@ -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 = ({ 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 ( + + + set('Employee', v)} + placeholder={EMPLOYEE_PLACEHOLDER} + /> + {!readOnly && hasNoAccount &&
{ROUTE_BY_APPLICANT_NOTE}
} + + +