Co-authored-by: gorbenko.pavel <gorbenko.pavel@tansu.kz> Reviewed-on: http://git.tnsu.kz/timur.gorodetskiy/request-portal/pulls/13
This commit was merged in pull request #13.
This commit is contained in:
@@ -42,6 +42,7 @@
|
||||
| --- | --- | --- | :---: | :---: | :---: | --- | :---: |
|
||||
| [`recruiting-selection`](../src/webparts/requestPortal/forms/RecruitingSelection/README.md) | Заявка на подбор | Рекрутинг | нет | нет | нет | много полей (~42), поля-люди (в т.ч. мульти) | ✅ |
|
||||
| [`recruiting-hire`](../src/webparts/requestPortal/forms/RecruitingHire/README.md) | Заявка на прием | Рекрутинг | да | да | да | маска телефона, деньги, условное «взамен кого», источник для орг. места | ✅ |
|
||||
| [`recruiting-referral`](../src/webparts/requestPortal/forms/Referral/README.md) | Реферальная рекомендация | Рекрутинг | да | да | да | кандидат — внешний (текстовые поля, не People); маршрут по рекомендателю; исполнитель переназначает на реального; условное уточнение «откуда знаете» | ✅ |
|
||||
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
|
||||
| [`it-1c-ticket`](../src/webparts/requestPortal/forms/Ticket1C/README.md) | Заявка в отдел 1С | IT | да | нет | да | контакты предзаполняются из Graph (/me); вместо фазы исполнения — карточка в Microsoft Planner (согласовано/сразу без согласования — рабочий бакет, отклонено — отдельный бакет) | ✅ |
|
||||
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker); условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД), сумма обучения | ✅ |
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
<#
|
||||
<#
|
||||
.SYNOPSIS
|
||||
Идемпотентно создаёт списки данных форм портала заявок в SharePoint Online
|
||||
по манифестам provisioning.json (единый источник правды по колонкам).
|
||||
|
||||
@@ -8,6 +8,7 @@ export const REQUEST_TYPES: IRequestType[] = [
|
||||
// Отдел рекрутинга
|
||||
{ id: 'recruiting-selection', categoryId: 'recruiting', title: 'Заявка на подбор', icon: 'search' },
|
||||
{ id: 'recruiting-hire', categoryId: 'recruiting', title: 'Заявка на прием', icon: 'people' },
|
||||
{ id: 'recruiting-referral', categoryId: 'recruiting', title: 'Реферальная рекомендация', icon: 'send' },
|
||||
|
||||
// IT
|
||||
{ id: 'it-workplace-setup', categoryId: 'it', title: 'Заявка на организацию рабочего места', icon: 'monitor' },
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
# Реферальная рекомендация (recruiting-referral)
|
||||
|
||||
**Назначение:** сотрудник рекомендует внешнего кандидата на открытую вакансию
|
||||
(реферальная программа).
|
||||
**Категория:** Отдел рекрутинга
|
||||
**Списки SP:** «Реферальная рекомендация — данные» / «Реферальная рекомендация — согласование»
|
||||
**RequestTypeId (внешний API маршрутов):** _плейсхолдер_ — получит числовой id при
|
||||
заведении типа в админке approval-route (форма резолвит его в рантайме по pageUrl,
|
||||
хардкодить не нужно — см. `docs/forms.md`).
|
||||
|
||||
## Маршрут
|
||||
- Тип заявки в approval-route API (`/api/request-types`): `pageUrl` «recruiting-referral».
|
||||
- Фазы: согласование + исполнение. Исполнитель в маршруте — фиксированная
|
||||
роль (не выбирается заявителем), которая назначает **реального** исполнителя
|
||||
через переназначение (флаг `AllowReassignToOtherApprovers` на шаге в
|
||||
админке approval-route) — см. обсуждение в истории репо. Обе фазы
|
||||
подгружаются отдельными запросами `getPlannedMatrix(..., 'Approval' | 'Execution')`
|
||||
и рендерятся как два отдельных блока `<ApprovalMatrix>` (как в RecruitingHire).
|
||||
- **Матрица согласования редактируема заявителем** при новой заявке / черновике
|
||||
/ возврате: `useMatrixEditor(editable = !readOnly)`. **Матрица исполнения —
|
||||
только чтение** (фиксируется маршрутом, не заявителем).
|
||||
|
||||
## Особое поведение
|
||||
- **Кандидат — не сотрудник компании.** Его Ф.И.О., телефон, email и город —
|
||||
обычные текстовые поля, а НЕ People-picker: в каталоге тенанта его ещё нет.
|
||||
People-поле здесь только одно — `Referrer` (рекомендатель).
|
||||
- **Маршрут резолвится по рекомендателю** (`getPlannedMatrix(..., data.Referrer, ...)`),
|
||||
reloadKey матрицы включает `data.Referrer`. Рекомендацию согласуют по линии
|
||||
рекомендателя — кандидата в тенанте нет, резолвить условия по нему нечем.
|
||||
- **Автоподстановка при создании:** рекомендатель = текущий пользователь, его
|
||||
должность и подразделение — из профиля SharePoint (`SPS-JobTitle`/`SPS-Department`
|
||||
через `approval.getProfileFields`), дата подачи = сегодня. При выборе другого
|
||||
рекомендателя должность и подразделение подтягиваются заново — оба поля
|
||||
остаются **редактируемыми** (фолбэк, если профиль не синхронизирован или
|
||||
подразделение указано не так, как нужно для этой рекомендации).
|
||||
«Подразделение / Объект» вакансии (`VacancyDepartment`) — отдельное поле,
|
||||
свободный текст: это подразделение, КУДА рекомендуют, а не рекомендателя.
|
||||
- **Условное поле:** «Откуда знаете» = «Другое» → появляется обязательное
|
||||
уточнение `AcquaintanceSourceOther`. При смене варианта уточнение очищается,
|
||||
и в список пишется `null` (см. `buildItem` в `submit.ts`).
|
||||
- **Маски:** `PhoneInput` на `ReferrerPhone` и `CandidatePhone`.
|
||||
- **Заголовок элемента** (`Title`): `Реферальная рекомендация — {ФИО кандидата} — {вакансия} — дд.мм.гггг`.
|
||||
|
||||
## Секции формы
|
||||
ReferrerSection (дата подачи · рекомендатель · должность · подразделение · телефон)
|
||||
· CandidateSection (Ф.И.О. · телефон · email · город)
|
||||
· VacancySection (название вакансии · подразделение)
|
||||
· CandidateInfoSection (текущая работа · должность · стаж · как давно знаете · откуда знаете [+ уточнение])
|
||||
· AssessmentSection (сильные стороны · о чём стоит знать · вахта · ожидания по ЗП)
|
||||
|
||||
## Точки входа
|
||||
- rptype: `recruiting-referral`
|
||||
- Режим согласующего (просмотр): есть (`ReferralView`)
|
||||
- «Создать на основе»: нет
|
||||
@@ -0,0 +1,20 @@
|
||||
@import '../../../../styles/design-tokens';
|
||||
|
||||
.back {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: $sp-2;
|
||||
margin-bottom: $sp-4;
|
||||
padding: 0;
|
||||
border: 0;
|
||||
background: transparent;
|
||||
color: $navy-700;
|
||||
font-family: $font-sans;
|
||||
font-size: $fs-sm;
|
||||
cursor: pointer;
|
||||
transition: color .18s;
|
||||
|
||||
&:hover {
|
||||
color: $gold-600;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,395 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||
import styles from './ReferralForm.module.scss';
|
||||
import {
|
||||
Alert,
|
||||
FormCard,
|
||||
InitiatorLine,
|
||||
FormModeProvider,
|
||||
Icon,
|
||||
RequestNumber,
|
||||
SubmitActions,
|
||||
useRequestSubmit
|
||||
} from '../../shared/ui';
|
||||
import {
|
||||
ApprovalMatrix,
|
||||
StatusBadge,
|
||||
useMatrixEditor,
|
||||
getPlannedMatrix,
|
||||
notifyActiveStep,
|
||||
useRequestTypeId,
|
||||
REQUEST_STATUS,
|
||||
isEditableStatus,
|
||||
IApproverToWrite,
|
||||
unassignedStepMessage,
|
||||
resolveWriteListId,
|
||||
APPROVAL_PHASE,
|
||||
initialSubmitStatus
|
||||
} from '../../shared/approval';
|
||||
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, OTHER_VALUE, todayIso } from './model';
|
||||
import { saveReferralRequest, referralApprovalService } from './submit';
|
||||
import { loadReferralRequest } from './load';
|
||||
import { ReferrerSection } from './sections/ReferrerSection';
|
||||
import { CandidateSection } from './sections/CandidateSection';
|
||||
import { VacancySection } from './sections/VacancySection';
|
||||
import { CandidateInfoSection } from './sections/CandidateInfoSection';
|
||||
import { AssessmentSection } from './sections/AssessmentSection';
|
||||
|
||||
const ReferralForm: React.FC<IRequestFormProps> = ({
|
||||
requestType,
|
||||
context,
|
||||
onCancel,
|
||||
onSaved,
|
||||
editId,
|
||||
editListId
|
||||
}) => {
|
||||
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();
|
||||
|
||||
const readOnly = !isEditableStatus(requestStatus);
|
||||
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||
|
||||
// editListId уже проверен в EditFeature — если бы партиции не нашлось в реестре,
|
||||
// форма сюда вообще не смонтировалась бы, поэтому referralApprovalService можно
|
||||
// звать не опасаясь исключения.
|
||||
const approval = useMemo(() => referralApprovalService(editListId), [editListId]);
|
||||
// pageUrl формы (requestType.id совпадает с ним по конвенции портала, см.
|
||||
// data/requests.ts) → числовой RequestTypeId, нужный approval-route API.
|
||||
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||
const requestTypeId = requestTypeIdState.id;
|
||||
|
||||
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
|
||||
useEffect(() => {
|
||||
if (!editId) {
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
loadReferralRequest(editId, editListId)
|
||||
.then((loaded) => {
|
||||
if (alive) {
|
||||
setData(loaded.data);
|
||||
setRequestStatus(loaded.status);
|
||||
setRequestCode(loaded.code || undefined);
|
||||
}
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) {
|
||||
submit.setError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId, editListId]);
|
||||
|
||||
// Новая заявка: рекомендатель — сам подающий (подставляем его, должность и
|
||||
// подразделение из профиля SharePoint — SPS-JobTitle/SPS-Department, как в
|
||||
// «Обходном листе»), дата подачи — сегодня.
|
||||
useEffect(() => {
|
||||
if (editId) {
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
const user = context.pageContext.user;
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Referrer: prev.Referrer || user.email,
|
||||
SubmitDate: prev.SubmitDate || todayIso()
|
||||
}));
|
||||
approval
|
||||
.getProfileFields(user.loginName)
|
||||
.then((profile) => {
|
||||
if (alive) {
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
ReferrerPosition: prev.ReferrerPosition || profile.jobTitle,
|
||||
ReferrerDepartment: prev.ReferrerDepartment || profile.department
|
||||
}));
|
||||
}
|
||||
})
|
||||
.catch(() => undefined);
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId]);
|
||||
|
||||
// Выбор другого рекомендателя подтягивает его должность и подразделение из
|
||||
// профиля — оба поля остаются редактируемыми (фолбэк, если профиль не
|
||||
// синхронизирован), поэтому не затираем то, что уже введено, пустым значением.
|
||||
const handleReferrerChange = (login: string): void => {
|
||||
setData((prev) => ({ ...prev, Referrer: login }));
|
||||
if (!login) {
|
||||
return;
|
||||
}
|
||||
approval
|
||||
.getProfileFields(login)
|
||||
.then((profile) =>
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
ReferrerPosition: profile.jobTitle || prev.ReferrerPosition,
|
||||
ReferrerDepartment: profile.department || prev.ReferrerDepartment
|
||||
}))
|
||||
)
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
// Планируемый маршрут резолвится по e-mail РЕКОМЕНДАТЕЛЯ (кандидата в тенанте
|
||||
// ещё нет, да и согласуют рекомендацию по линии рекомендателя). У заявки на
|
||||
// редактировании маршрут читается из уже записанных строк, чтобы не затереть
|
||||
// правки инициатора.
|
||||
const loadMatrix = useCallback(
|
||||
() =>
|
||||
editId
|
||||
? approval
|
||||
.getMatrixForRequest(editId)
|
||||
.then((rows) => rows.filter((r) => r.phase !== APPROVAL_PHASE.execution))
|
||||
: getPlannedMatrix(context, requestTypeId as number, data.Referrer, approval, 'Approval'),
|
||||
[context, approval, editId, data.Referrer, requestTypeId]
|
||||
);
|
||||
const matrix = useMatrixEditor(
|
||||
loadMatrix,
|
||||
`${data.Referrer}-${editId ?? 'new'}`,
|
||||
!readOnly,
|
||||
!!editId || (!!data.Referrer && !!requestTypeId),
|
||||
(login) => approval.getJobTitle(login)
|
||||
);
|
||||
|
||||
// Фаза исполнения: реальный исполнитель, назначаемый по маршруту (не
|
||||
// редактируется заявителем — только чтение, как в RecruitingHire/Clearance).
|
||||
// Именно этот шаг сейчас «пропадал» на форме: без явного запроса фазы
|
||||
// 'Execution' getPlannedMatrix её просто не резолвит.
|
||||
const loadExecutors = useCallback(
|
||||
() =>
|
||||
editId
|
||||
? approval
|
||||
.getMatrixForRequest(editId)
|
||||
.then((rows) => rows.filter((r) => r.phase === APPROVAL_PHASE.execution))
|
||||
: getPlannedMatrix(context, requestTypeId as number, data.Referrer, approval, 'Execution'),
|
||||
[context, approval, editId, data.Referrer, requestTypeId]
|
||||
);
|
||||
const executors = useMatrixEditor(
|
||||
loadExecutors,
|
||||
`${data.Referrer}-${editId ?? 'new'}`,
|
||||
false,
|
||||
!!editId || (!!data.Referrer && !!requestTypeId),
|
||||
(login) => approval.getJobTitle(login)
|
||||
);
|
||||
|
||||
// «Другое» в «откуда знаете» без уточнения — незаполненное поле по сути.
|
||||
const sourceValid = !!(
|
||||
data.AcquaintanceSource &&
|
||||
(data.AcquaintanceSource !== OTHER_VALUE || data.AcquaintanceSourceOther.trim())
|
||||
);
|
||||
const isValid = !!(
|
||||
data.SubmitDate &&
|
||||
data.Referrer &&
|
||||
data.ReferrerPosition.trim() &&
|
||||
data.ReferrerPhone.trim() &&
|
||||
data.CandidateName.trim() &&
|
||||
data.CandidatePhone.trim() &&
|
||||
data.VacancyTitle.trim() &&
|
||||
sourceValid &&
|
||||
data.Strengths.trim()
|
||||
);
|
||||
const validate = (): string | undefined => {
|
||||
if (
|
||||
!data.SubmitDate ||
|
||||
!data.Referrer ||
|
||||
!data.ReferrerPosition.trim() ||
|
||||
!data.ReferrerPhone.trim() ||
|
||||
!data.CandidateName.trim() ||
|
||||
!data.CandidatePhone.trim() ||
|
||||
!data.VacancyTitle.trim() ||
|
||||
!data.AcquaintanceSource ||
|
||||
!data.Strengths.trim()
|
||||
) {
|
||||
return 'Заполните обязательные поля: дата подачи, рекомендатель, его должность и телефон, Ф.И.О. и телефон кандидата, название вакансии, откуда знаете кандидата, сильные стороны.';
|
||||
}
|
||||
if (!sourceValid) {
|
||||
return 'Уточните, откуда вы знаете кандидата — выбран вариант «Другое».';
|
||||
}
|
||||
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||
if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
|
||||
return undefined;
|
||||
};
|
||||
|
||||
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
|
||||
rows.map((r) => ({
|
||||
email: r.email,
|
||||
position: r.position,
|
||||
allowReassign: r.allowReassign,
|
||||
order: r.order,
|
||||
// Транзитом из маршрута в строку списка: наследование бэкенд применил
|
||||
// при resolve, форма только переносит значения (см. IMatrixRow.slaHours).
|
||||
slaHours: r.slaHours,
|
||||
askOverdueReason: r.askOverdueReason
|
||||
}));
|
||||
|
||||
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||
// validate()/validateSubmit() уже гарантировали requestTypeId к моменту вызова
|
||||
// (см. useRequestSubmit.run — валидирует ДО save), но TS этого через границу
|
||||
// замыкания не видит — локальный const и явная проверка снимают обе проблемы.
|
||||
const rtId = requestTypeId;
|
||||
if (!rtId) {
|
||||
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||
}
|
||||
// Новая заявка пишется в ТЕКУЩУЮ партицию — запрашиваем её у approval-route
|
||||
// API непосредственно перед записью (не кеш из onInit): именно этот вызов
|
||||
// проверяет порог элементов и запускает архивацию следующей партиции.
|
||||
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
|
||||
const { id, code } = await saveReferralRequest(
|
||||
requestId,
|
||||
rtId,
|
||||
data,
|
||||
toApprovers(matrix.rows),
|
||||
toApprovers(executors.rows),
|
||||
status,
|
||||
writeListId
|
||||
);
|
||||
setRequestId(id);
|
||||
setRequestStatus(status);
|
||||
if (code) {
|
||||
setRequestCode(code);
|
||||
}
|
||||
if (onSaved) {
|
||||
onSaved();
|
||||
}
|
||||
// Отправка (на согласование ИЛИ, если согласующих нет, сразу на исполнение) —
|
||||
// уведомляем первый активный шаг (поток оповещения). Имена списков — той же
|
||||
// партиции, куда фактически записана заявка (writeListId), не текущей:
|
||||
// поток ищет строку маршрута именно в НЕЙ.
|
||||
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;
|
||||
const unassignedExecutorError = unassignedStepMessage(
|
||||
executors.rows,
|
||||
(r) => `Шаг ${r.order} исполнения («${r.position || 'без должности'}») без назначенного человека — обратитесь к администратору маршрута.`
|
||||
);
|
||||
if (unassignedExecutorError) return unassignedExecutorError;
|
||||
return undefined;
|
||||
};
|
||||
|
||||
// Маршрута может не быть вообще (нет согласующих — только исполнитель, как у
|
||||
// рефералки): initialSubmitStatus сразу пишет «Выполнение», минуя «На
|
||||
// согласовании», которого в таком маршруте попросту не бывает.
|
||||
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||
const handleSubmit = (): Promise<void> =>
|
||||
submit.run(
|
||||
'submit',
|
||||
save(initialSubmitStatus(matrix.rows.length, executors.rows.length)),
|
||||
validateSubmit
|
||||
);
|
||||
|
||||
// Согласующих в маршруте нет вообще (подтверждено — матрица загружена без
|
||||
// ошибки и пуста), а не просто «ещё загружается»: до этого момента считаем,
|
||||
// что фаза согласования есть — исторический дефолт, без мигания подписи.
|
||||
const noApprovalPhase = !matrix.loading && !matrix.error && matrix.rows.length === 0;
|
||||
|
||||
const sectionProps = { data, set, context, onReferrerChange: handleReferrerChange };
|
||||
|
||||
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'
|
||||
? 'Черновик сохранён.'
|
||||
: noApprovalPhase
|
||||
? 'Заявка отправлена на исполнение.'
|
||||
: 'Заявка отправлена на согласование.'}
|
||||
</Alert>
|
||||
)}
|
||||
{submit.error && <Alert variant="err">{submit.error}</Alert>}
|
||||
|
||||
<FormModeProvider readOnly={readOnly}>
|
||||
<ReferrerSection {...sectionProps} />
|
||||
<CandidateSection {...sectionProps} />
|
||||
<VacancySection {...sectionProps} />
|
||||
<CandidateInfoSection {...sectionProps} />
|
||||
<AssessmentSection {...sectionProps} />
|
||||
</FormModeProvider>
|
||||
|
||||
{/* Блок остаётся видимым и пустым (не скрываем по noApprovalPhase) —
|
||||
маршрут без согласующих не значит, что их нельзя добавить: матрица
|
||||
редактируема, заявитель вправе вписать согласующего сам. */}
|
||||
<ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
|
||||
|
||||
{!executors.loading && executors.rows.length > 0 && (
|
||||
<ApprovalMatrix
|
||||
editor={executors}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
title={noApprovalPhase ? 'Исполнение' : 'Исполнение (после согласования)'}
|
||||
roleLabel="Исполнитель"
|
||||
emptyText="Исполнители не заданы по маршруту."
|
||||
/>
|
||||
)}
|
||||
|
||||
<SubmitActions
|
||||
submit={submit}
|
||||
isValid={isValid}
|
||||
readOnly={readOnly}
|
||||
onCancel={onCancel}
|
||||
onSaveDraft={handleSaveDraft}
|
||||
onSubmit={handleSubmit}
|
||||
submitLabel={noApprovalPhase ? 'Отправить на исполнение' : 'Отправить на согласование'}
|
||||
/>
|
||||
</FormCard>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default ReferralForm;
|
||||
@@ -0,0 +1,14 @@
|
||||
@import '../../../../styles/design-tokens';
|
||||
|
||||
.state {
|
||||
padding: $sp-8;
|
||||
color: $gray-500;
|
||||
font-size: $fs-sm;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.toolbar {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
margin-bottom: $sp-4;
|
||||
}
|
||||
@@ -0,0 +1,199 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import styles from './ReferralView.module.scss';
|
||||
import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintButton } from '../../shared/ui';
|
||||
import {
|
||||
ApproverService,
|
||||
DecisionPanel,
|
||||
StatusBadge,
|
||||
ApprovalMatrix,
|
||||
useMatrixEditor,
|
||||
notifyActiveStep,
|
||||
useRequestTypeId,
|
||||
APPROVAL_PHASE
|
||||
} 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 { loadReferralRequest } from './load';
|
||||
import { referralApprovalService } from './submit';
|
||||
import { ReferrerSection } from './sections/ReferrerSection';
|
||||
import { CandidateSection } from './sections/CandidateSection';
|
||||
import { VacancySection } from './sections/VacancySection';
|
||||
import { CandidateInfoSection } from './sections/CandidateInfoSection';
|
||||
import { AssessmentSection } from './sections/AssessmentSection';
|
||||
|
||||
interface IReferralViewProps {
|
||||
context: WebPartContext;
|
||||
itemId: number;
|
||||
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||
formKey: string;
|
||||
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||
listId?: string;
|
||||
}
|
||||
|
||||
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||
const NOOP_SET: SetField = () => undefined;
|
||||
|
||||
// Реферальная рекомендация только для просмотра (режим согласующего). Переиспользует
|
||||
// те же секции, что и форма подачи; редактирование выключено через
|
||||
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||
const ReferralView: React.FC<IReferralViewProps> = ({ context, itemId, formKey, listId }) => {
|
||||
const [data, setData] = useState<IFormData>(EMPTY_DATA);
|
||||
const [status, setStatus] = useState<string>('');
|
||||
const [code, setCode] = useState<string>('');
|
||||
const [loading, setLoading] = useState<boolean>(true);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
|
||||
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||
// referralApprovalService можно звать не опасаясь исключения.
|
||||
const approval = useMemo(() => referralApprovalService(listId), [listId]);
|
||||
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||
// Ref списка данных для ApproverService.updateRequestStatus: listId (url) для
|
||||
// архивной партиции, Title текущей — иначе (см. ApproverService.dataListRef).
|
||||
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||
|
||||
// Матрица маршрута из фактических строк заявки (read-only), разбитая по
|
||||
// фазам — иначе шаг исполнения (реальный исполнитель, назначаемый по
|
||||
// маршруту) смешивался бы с согласующими в одной таблице. decisionSeq в
|
||||
// reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||
const loadApprovers = useCallback(
|
||||
() =>
|
||||
approval
|
||||
.getMatrixForRequest(itemId)
|
||||
.then((rows) => rows.filter((r) => r.phase !== APPROVAL_PHASE.execution)),
|
||||
[approval, itemId]
|
||||
);
|
||||
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||
approval.getJobTitle(l)
|
||||
);
|
||||
const loadExecutors = useCallback(
|
||||
() =>
|
||||
approval
|
||||
.getMatrixForRequest(itemId)
|
||||
.then((rows) => rows.filter((r) => r.phase === APPROVAL_PHASE.execution)),
|
||||
[approval, itemId]
|
||||
);
|
||||
const executors = useMatrixEditor(loadExecutors, `e-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||
approval.getJobTitle(l)
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
let alive = true;
|
||||
setLoading(true);
|
||||
loadReferralRequest(itemId, listId)
|
||||
.then((loaded) => {
|
||||
if (alive) {
|
||||
setData(loaded.data);
|
||||
setStatus(loaded.status);
|
||||
setCode(loaded.code);
|
||||
setError(null);
|
||||
setLoading(false);
|
||||
}
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) {
|
||||
setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
|
||||
setLoading(false);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [itemId, listId]);
|
||||
|
||||
if (loading) {
|
||||
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||
}
|
||||
if (error) {
|
||||
return (
|
||||
<div className={styles.state}>
|
||||
<Alert variant="err">{error}</Alert>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const sectionProps = { data, set: NOOP_SET, context };
|
||||
|
||||
const notify = (): void => {
|
||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
|
||||
// весь UI ради необязательного оповещения.
|
||||
if (!requestTypeId) return;
|
||||
notifyActiveStep(context, approval, itemId, {
|
||||
requestTypeId,
|
||||
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
|
||||
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
|
||||
}).catch(() => undefined);
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
<div className={`${styles.toolbar} rp-no-print`}>
|
||||
<PrintButton />
|
||||
</div>
|
||||
|
||||
<div className="rp-print-root">
|
||||
<FormCard
|
||||
title="Реферальная рекомендация"
|
||||
subtitle={`№${code || itemId}`}
|
||||
belowSubtitle={
|
||||
<InitiatorLine
|
||||
listTitle={listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID)}
|
||||
itemId={itemId}
|
||||
/>
|
||||
}
|
||||
headerRight={status ? <StatusBadge status={status} /> : undefined}
|
||||
>
|
||||
<FormModeProvider readOnly>
|
||||
<ReferrerSection {...sectionProps} />
|
||||
<CandidateSection {...sectionProps} />
|
||||
<VacancySection {...sectionProps} />
|
||||
<CandidateInfoSection {...sectionProps} />
|
||||
<AssessmentSection {...sectionProps} />
|
||||
</FormModeProvider>
|
||||
</FormCard>
|
||||
|
||||
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||
|
||||
{!executors.loading && executors.rows.length > 0 && (
|
||||
<ApprovalMatrix
|
||||
editor={executors}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
title="Исполнение"
|
||||
roleLabel="Исполнитель"
|
||||
emptyText="Исполнители не назначены."
|
||||
/>
|
||||
)}
|
||||
</div>
|
||||
|
||||
{/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый). */}
|
||||
<div className="rp-no-print">
|
||||
<DecisionPanel
|
||||
service={approverService}
|
||||
requestId={itemId}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
onDecided={(newStatus) => {
|
||||
setStatus(newStatus);
|
||||
setDecisionSeq((n) => n + 1);
|
||||
notify();
|
||||
}}
|
||||
onDelegated={() => {
|
||||
setDecisionSeq((n) => n + 1);
|
||||
notify();
|
||||
}}
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default ReferralView;
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"dataListTitle": "Реферальная рекомендация — согласование",
|
||||
"columns": [
|
||||
{ "internalName": "TansuSiteApprover", "title": "Согласующий", "type": "User", "userSelectionMode": "PeopleOnly" },
|
||||
{ "internalName": "ApprovalStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "Ждёт очереди", "На согласовании", "На исполнении", "Согласовано", "Выполнено", "Отклонено", "Возвращена на доработку"] },
|
||||
{ "internalName": "Ticket", "title": "Заявка", "type": "Lookup", "lookupList": "Реферальная рекомендация — данные", "lookupShowField": "Title" },
|
||||
{ "internalName": "Date", "title": "Дата", "type": "DateTime" },
|
||||
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||
{ "internalName": "StepOrder", "title": "Порядок", "type": "Number" },
|
||||
{ "internalName": "AllowReassignToOtherApprovers", "title": "Можно перепоручать", "type": "Boolean" },
|
||||
{ "internalName": "Phase", "title": "Фаза", "type": "Choice", "choices": ["Согласование", "Исполнение"] },
|
||||
{ "internalName": "SLAhours", "title": "SLA, часов", "type": "Number" },
|
||||
{ "internalName": "AskOverdueReason", "title": "Опрос причины просрочки", "type": "Boolean" },
|
||||
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,89 @@
|
||||
import { getSP } from '../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
/** Ф.И.О. рекомендателя из поля Referrer (для заголовка режима чтения). */
|
||||
referrerName: string;
|
||||
status: string;
|
||||
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||
code: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Прочитать реферальную рекомендацию по id: модель формы + статус (правка / просмотр).
|
||||
*
|
||||
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
|
||||
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
|
||||
* по url списка, а не по имени: так не нужно резолвить, как называется архивный
|
||||
* список, и запрос не зависит от реестра партиций.
|
||||
*/
|
||||
export async function loadReferralRequest(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',
|
||||
'SubmitDate',
|
||||
'ReferrerPosition',
|
||||
'ReferrerDepartment',
|
||||
'ReferrerPhone',
|
||||
'CandidateName',
|
||||
'CandidatePhone',
|
||||
'CandidateEmail',
|
||||
'CandidateCity',
|
||||
'VacancyTitle',
|
||||
'VacancyDepartment',
|
||||
'CurrentEmployer',
|
||||
'CurrentPosition',
|
||||
'ExperienceYears',
|
||||
'AcquaintanceDuration',
|
||||
'AcquaintanceSource',
|
||||
'AcquaintanceSourceOther',
|
||||
'Strengths',
|
||||
'ConcernsNotes',
|
||||
'ReadyForShiftWork',
|
||||
'SalaryExpectations',
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
'Referrer/Title',
|
||||
'Referrer/EMail'
|
||||
)
|
||||
.expand('Referrer')()) as Record<string, unknown>;
|
||||
|
||||
const referrer = item.Referrer as { Title?: string; EMail?: string } | undefined;
|
||||
const submitDate = (item.SubmitDate as string) || '';
|
||||
|
||||
const data: IFormData = {
|
||||
...EMPTY_DATA,
|
||||
SubmitDate: submitDate.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||
Referrer: referrer?.EMail || '',
|
||||
ReferrerPosition: (item.ReferrerPosition as string) || '',
|
||||
ReferrerDepartment: (item.ReferrerDepartment as string) || '',
|
||||
ReferrerPhone: (item.ReferrerPhone as string) || '',
|
||||
CandidateName: (item.CandidateName as string) || '',
|
||||
CandidatePhone: (item.CandidatePhone as string) || '',
|
||||
CandidateEmail: (item.CandidateEmail as string) || '',
|
||||
CandidateCity: (item.CandidateCity as string) || '',
|
||||
VacancyTitle: (item.VacancyTitle as string) || '',
|
||||
VacancyDepartment: (item.VacancyDepartment as string) || '',
|
||||
CurrentEmployer: (item.CurrentEmployer as string) || '',
|
||||
CurrentPosition: (item.CurrentPosition as string) || '',
|
||||
ExperienceYears: (item.ExperienceYears as string) || '',
|
||||
AcquaintanceDuration: (item.AcquaintanceDuration as string) || '',
|
||||
AcquaintanceSource: (item.AcquaintanceSource as string) || '',
|
||||
AcquaintanceSourceOther: (item.AcquaintanceSourceOther as string) || '',
|
||||
Strengths: (item.Strengths as string) || '',
|
||||
ConcernsNotes: (item.ConcernsNotes as string) || '',
|
||||
ReadyForShiftWork: (item.ReadyForShiftWork as string) || '',
|
||||
SalaryExpectations: (item.SalaryExpectations as string) || ''
|
||||
};
|
||||
|
||||
return {
|
||||
data,
|
||||
referrerName: referrer?.Title || '',
|
||||
status: (item.RequestStatus as string) || '',
|
||||
code: (item.RequestUniqueCode as string) || ''
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { RequestTypeId } from '../../models/types';
|
||||
import { ISelectOption } from '../../shared/ui';
|
||||
|
||||
/**
|
||||
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||
*/
|
||||
export const FORM_ID: RequestTypeId = 'recruiting-referral';
|
||||
|
||||
/** Вариант «Другое» у Choice-полей: включает парное поле-уточнение. */
|
||||
export const OTHER_VALUE = 'Другое';
|
||||
|
||||
/** Откуда рекомендатель знает кандидата. */
|
||||
export const ACQUAINTANCE_SOURCE_OPTIONS: ISelectOption[] = [
|
||||
{ value: 'Работали вместе', label: 'Работали вместе' },
|
||||
{ value: 'Друзья', label: 'Друзья' },
|
||||
{ value: 'Родственники', label: 'Родственники' },
|
||||
{ value: OTHER_VALUE, label: OTHER_VALUE }
|
||||
];
|
||||
|
||||
/** Готовность кандидата к вахтовому графику. */
|
||||
export const SHIFT_WORK_OPTIONS: ISelectOption[] = [
|
||||
{ value: 'Да', label: 'Да' },
|
||||
{ value: 'Нет', label: 'Нет' },
|
||||
{ value: 'Не применимо', label: 'Не применимо' }
|
||||
];
|
||||
|
||||
/**
|
||||
* Данные формы «Реферальная рекомендация». Ключи = internalName колонок списка
|
||||
* данных (см. provisioning.json), кроме Referrer — он хранит e-mail (то, что
|
||||
* отдаёт PeopleField), а в список пишется как ReferrerId.
|
||||
*
|
||||
* Кандидат — НЕ сотрудник компании, поэтому его ФИО/телефон/почта — обычный
|
||||
* текст, а не People-поля: в каталоге тенанта его ещё нет.
|
||||
*/
|
||||
export interface IFormData {
|
||||
/** ISO YYYY-MM-DD (input type=date). По умолчанию — сегодня. */
|
||||
SubmitDate: string;
|
||||
/** E-mail рекомендателя (People). Пусто = не выбран. */
|
||||
Referrer: string;
|
||||
ReferrerPosition: string;
|
||||
ReferrerDepartment: string;
|
||||
ReferrerPhone: string;
|
||||
|
||||
CandidateName: string;
|
||||
CandidatePhone: string;
|
||||
CandidateEmail: string;
|
||||
CandidateCity: string;
|
||||
|
||||
VacancyTitle: string;
|
||||
VacancyDepartment: string;
|
||||
|
||||
CurrentEmployer: string;
|
||||
CurrentPosition: string;
|
||||
ExperienceYears: string;
|
||||
AcquaintanceDuration: string;
|
||||
/** Один из ACQUAINTANCE_SOURCE_OPTIONS; OTHER_VALUE открывает …Other. */
|
||||
AcquaintanceSource: string;
|
||||
AcquaintanceSourceOther: string;
|
||||
|
||||
Strengths: string;
|
||||
ConcernsNotes: string;
|
||||
/** Один из SHIFT_WORK_OPTIONS. */
|
||||
ReadyForShiftWork: string;
|
||||
SalaryExpectations: string;
|
||||
}
|
||||
|
||||
/** Обновление одного поля формы с сохранением типа значения. */
|
||||
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||
|
||||
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker). */
|
||||
export interface ISectionProps {
|
||||
data: IFormData;
|
||||
set: SetField;
|
||||
context: WebPartContext;
|
||||
/**
|
||||
* Выбор рекомендателя подтягивает его должность — поэтому у поля отдельный
|
||||
* обработчик. Если не передан (режим чтения) — правка через set.
|
||||
*/
|
||||
onReferrerChange?: (login: string) => void;
|
||||
}
|
||||
|
||||
export const EMPTY_DATA: IFormData = {
|
||||
SubmitDate: '',
|
||||
Referrer: '',
|
||||
ReferrerPosition: '',
|
||||
ReferrerDepartment: '',
|
||||
ReferrerPhone: '',
|
||||
CandidateName: '',
|
||||
CandidatePhone: '',
|
||||
CandidateEmail: '',
|
||||
CandidateCity: '',
|
||||
VacancyTitle: '',
|
||||
VacancyDepartment: '',
|
||||
CurrentEmployer: '',
|
||||
CurrentPosition: '',
|
||||
ExperienceYears: '',
|
||||
AcquaintanceDuration: '',
|
||||
AcquaintanceSource: '',
|
||||
AcquaintanceSourceOther: '',
|
||||
Strengths: '',
|
||||
ConcernsNotes: '',
|
||||
ReadyForShiftWork: '',
|
||||
SalaryExpectations: ''
|
||||
};
|
||||
|
||||
/** Плейсхолдер для поля выбора рекомендателя. */
|
||||
export const REFERRER_PLACEHOLDER = 'Начните вводить Ф.И.О. рекомендателя…';
|
||||
|
||||
/** Сегодняшняя дата как YYYY-MM-DD — значение по умолчанию для «Дата подачи». */
|
||||
export function todayIso(): string {
|
||||
const now = new Date();
|
||||
const m = now.getMonth() + 1;
|
||||
const d = now.getDate();
|
||||
return `${now.getFullYear()}-${m < 10 ? '0' : ''}${m}-${d < 10 ? '0' : ''}${d}`;
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
{
|
||||
"dataListTitle": "Реферальная рекомендация — данные",
|
||||
"columns": [
|
||||
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||
|
||||
{ "internalName": "SubmitDate", "title": "Дата подачи", "type": "DateTime", "dateOnly": true },
|
||||
{ "internalName": "Referrer", "title": "Рекомендатель", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
||||
{ "internalName": "ReferrerPosition", "title": "Должность рекомендателя", "type": "Text" },
|
||||
{ "internalName": "ReferrerDepartment", "title": "Подразделение / Объект рекомендателя", "type": "Text" },
|
||||
{ "internalName": "ReferrerPhone", "title": "Контактный телефон рекомендателя", "type": "Text" },
|
||||
|
||||
{ "internalName": "CandidateName", "title": "ФИО кандидата", "type": "Text", "required": true },
|
||||
{ "internalName": "CandidatePhone", "title": "Контактный телефон кандидата", "type": "Text" },
|
||||
{ "internalName": "CandidateEmail", "title": "Email кандидата", "type": "Text" },
|
||||
{ "internalName": "CandidateCity", "title": "Город проживания кандидата", "type": "Text" },
|
||||
|
||||
{ "internalName": "VacancyTitle", "title": "Название вакансии", "type": "Text", "required": true },
|
||||
{ "internalName": "VacancyDepartment", "title": "Подразделение / Объект вакансии", "type": "Text" },
|
||||
|
||||
{ "internalName": "CurrentEmployer", "title": "Текущее место работы кандидата", "type": "Text" },
|
||||
{ "internalName": "CurrentPosition", "title": "Текущая должность кандидата", "type": "Text" },
|
||||
{ "internalName": "ExperienceYears", "title": "Общий стаж по специальности", "type": "Text" },
|
||||
{ "internalName": "AcquaintanceDuration", "title": "Как давно знаете кандидата", "type": "Text" },
|
||||
{ "internalName": "AcquaintanceSource", "title": "Откуда знаете кандидата", "type": "Choice", "choices": ["Работали вместе", "Друзья", "Родственники", "Другое"] },
|
||||
{ "internalName": "AcquaintanceSourceOther", "title": "Откуда знаете кандидата (другое)", "type": "Text" },
|
||||
|
||||
{ "internalName": "Strengths", "title": "Почему рекомендуете кандидата (сильные стороны)", "type": "Note" },
|
||||
{ "internalName": "ConcernsNotes", "title": "Моменты, о которых стоит знать", "type": "Note" },
|
||||
{ "internalName": "ReadyForShiftWork", "title": "Готовность к вахтовому графику", "type": "Choice", "choices": ["Да", "Нет", "Не применимо"] },
|
||||
{ "internalName": "SalaryExpectations", "title": "Ожидания по заработной плате", "type": "Text" }
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,31 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, TextArea, Select } from '../../../shared/ui';
|
||||
import { ISectionProps, SHIFT_WORK_OPTIONS } from '../model';
|
||||
|
||||
/** Секция 5: субъективная оценка рекомендателя — сильные стороны, риски, условия. */
|
||||
export const AssessmentSection: React.FC<ISectionProps> = ({ data, set }) => (
|
||||
<CollapseSection title="Оценка рекомендателя" icon="clipboard">
|
||||
<FormField label="Почему рекомендуете этого кандидата (сильные стороны)" htmlFor="Strengths" required full>
|
||||
<TextArea id="Strengths" value={data.Strengths} onChange={(v) => set('Strengths', v)} rows={4} />
|
||||
</FormField>
|
||||
<FormField label="Есть ли моменты, о которых стоит знать" htmlFor="ConcernsNotes" full>
|
||||
<TextArea id="ConcernsNotes" value={data.ConcernsNotes} onChange={(v) => set('ConcernsNotes', v)} rows={3} />
|
||||
</FormField>
|
||||
<FormField label="Готов ли кандидат к вахтовому графику" htmlFor="ReadyForShiftWork">
|
||||
<Select
|
||||
id="ReadyForShiftWork"
|
||||
value={data.ReadyForShiftWork}
|
||||
onChange={(v) => set('ReadyForShiftWork', v)}
|
||||
options={SHIFT_WORK_OPTIONS}
|
||||
placeholder="— выберите —"
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Ожидания по заработной плате (если известно)" htmlFor="SalaryExpectations">
|
||||
<TextInput
|
||||
id="SalaryExpectations"
|
||||
value={data.SalaryExpectations}
|
||||
onChange={(v) => set('SalaryExpectations', v)}
|
||||
/>
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,50 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, Select } from '../../../shared/ui';
|
||||
import { ISectionProps, ACQUAINTANCE_SOURCE_OPTIONS, OTHER_VALUE } from '../model';
|
||||
|
||||
/** Секция 4: что рекомендатель знает о кандидате — работа, стаж, знакомство. */
|
||||
export const CandidateInfoSection: React.FC<ISectionProps> = ({ data, set }) => (
|
||||
<CollapseSection title="Информация о кандидате" icon="document">
|
||||
<FormField label="Текущее место работы" htmlFor="CurrentEmployer">
|
||||
<TextInput id="CurrentEmployer" value={data.CurrentEmployer} onChange={(v) => set('CurrentEmployer', v)} />
|
||||
</FormField>
|
||||
<FormField label="Текущая должность" htmlFor="CurrentPosition">
|
||||
<TextInput id="CurrentPosition" value={data.CurrentPosition} onChange={(v) => set('CurrentPosition', v)} />
|
||||
</FormField>
|
||||
<FormField label="Общий стаж по специальности" htmlFor="ExperienceYears">
|
||||
<TextInput
|
||||
id="ExperienceYears"
|
||||
value={data.ExperienceYears}
|
||||
onChange={(v) => set('ExperienceYears', v)}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Как давно знаете кандидата" htmlFor="AcquaintanceDuration">
|
||||
<TextInput
|
||||
id="AcquaintanceDuration"
|
||||
value={data.AcquaintanceDuration}
|
||||
onChange={(v) => set('AcquaintanceDuration', v)}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Откуда знаете" htmlFor="AcquaintanceSource" required>
|
||||
<Select
|
||||
id="AcquaintanceSource"
|
||||
value={data.AcquaintanceSource}
|
||||
onChange={(v) => {
|
||||
set('AcquaintanceSource', v);
|
||||
if (v !== OTHER_VALUE) set('AcquaintanceSourceOther', '');
|
||||
}}
|
||||
options={ACQUAINTANCE_SOURCE_OPTIONS}
|
||||
placeholder="— выберите —"
|
||||
/>
|
||||
</FormField>
|
||||
{data.AcquaintanceSource === OTHER_VALUE && (
|
||||
<FormField label="Откуда знаете (уточните)" htmlFor="AcquaintanceSourceOther" required>
|
||||
<TextInput
|
||||
id="AcquaintanceSourceOther"
|
||||
value={data.AcquaintanceSourceOther}
|
||||
onChange={(v) => set('AcquaintanceSourceOther', v)}
|
||||
/>
|
||||
</FormField>
|
||||
)}
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,24 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, PhoneInput } from '../../../shared/ui';
|
||||
import { ISectionProps } from '../model';
|
||||
|
||||
/**
|
||||
* Секция 2: данные кандидата. Кандидат — не сотрудник компании, поэтому поля
|
||||
* обычные текстовые, а не People (в каталоге тенанта его ещё нет).
|
||||
*/
|
||||
export const CandidateSection: React.FC<ISectionProps> = ({ data, set }) => (
|
||||
<CollapseSection title="Данные кандидата" icon="people">
|
||||
<FormField label="Ф.И.О. кандидата" htmlFor="CandidateName" required full>
|
||||
<TextInput id="CandidateName" value={data.CandidateName} onChange={(v) => set('CandidateName', v)} />
|
||||
</FormField>
|
||||
<FormField label="Контактный телефон" htmlFor="CandidatePhone" required>
|
||||
<PhoneInput id="CandidatePhone" value={data.CandidatePhone} onChange={(v) => set('CandidatePhone', v)} />
|
||||
</FormField>
|
||||
<FormField label="Email" htmlFor="CandidateEmail">
|
||||
<TextInput id="CandidateEmail" value={data.CandidateEmail} onChange={(v) => set('CandidateEmail', v)} />
|
||||
</FormField>
|
||||
<FormField label="Город проживания" htmlFor="CandidateCity">
|
||||
<TextInput id="CandidateCity" value={data.CandidateCity} onChange={(v) => set('CandidateCity', v)} />
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,38 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, PhoneInput, PeopleField } from '../../../shared/ui';
|
||||
import { ISectionProps, REFERRER_PLACEHOLDER } from '../model';
|
||||
|
||||
/** Секция 1: кто рекомендует — дата подачи, сам рекомендатель и его контакты. */
|
||||
export const ReferrerSection: React.FC<ISectionProps> = ({ data, set, context, onReferrerChange }) => (
|
||||
<CollapseSection title="Рекомендатель" icon="people">
|
||||
<FormField label="Дата подачи" htmlFor="SubmitDate" required>
|
||||
<TextInput id="SubmitDate" type="date" value={data.SubmitDate} onChange={(v) => set('SubmitDate', v)} />
|
||||
</FormField>
|
||||
<FormField label="Ф.И.О. рекомендателя" htmlFor="Referrer" required full>
|
||||
<PeopleField
|
||||
context={context}
|
||||
value={data.Referrer}
|
||||
onChange={onReferrerChange ?? ((v) => set('Referrer', v))}
|
||||
placeholder={REFERRER_PLACEHOLDER}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Должность рекомендателя" htmlFor="ReferrerPosition" required>
|
||||
<TextInput
|
||||
id="ReferrerPosition"
|
||||
value={data.ReferrerPosition}
|
||||
onChange={(v) => set('ReferrerPosition', v)}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Подразделение / Объект" htmlFor="ReferrerDepartment">
|
||||
<TextInput
|
||||
id="ReferrerDepartment"
|
||||
value={data.ReferrerDepartment}
|
||||
onChange={(v) => set('ReferrerDepartment', v)}
|
||||
placeholder="Подставится автоматически по выбранному сотруднику"
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Контактный телефон" htmlFor="ReferrerPhone" required>
|
||||
<PhoneInput id="ReferrerPhone" value={data.ReferrerPhone} onChange={(v) => set('ReferrerPhone', v)} />
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,19 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput } from '../../../shared/ui';
|
||||
import { ISectionProps } from '../model';
|
||||
|
||||
/** Секция 3: на какую вакансию рекомендуют. */
|
||||
export const VacancySection: React.FC<ISectionProps> = ({ data, set }) => (
|
||||
<CollapseSection title="На какую вакансию рекомендуете" icon="search">
|
||||
<FormField label="Название вакансии" htmlFor="VacancyTitle" required full>
|
||||
<TextInput id="VacancyTitle" value={data.VacancyTitle} onChange={(v) => set('VacancyTitle', v)} />
|
||||
</FormField>
|
||||
<FormField label="Подразделение / Объект" htmlFor="VacancyDepartment" full>
|
||||
<TextInput
|
||||
id="VacancyDepartment"
|
||||
value={data.VacancyDepartment}
|
||||
onChange={(v) => set('VacancyDepartment', v)}
|
||||
/>
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,88 @@
|
||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
||||
import { ensureEmployee } from '../../shared/employee';
|
||||
import { FORM_ID, IFormData, OTHER_VALUE } from './model';
|
||||
|
||||
/**
|
||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
|
||||
* именем формы для читаемости вызывающего кода.
|
||||
*/
|
||||
export function referralApprovalService(listId?: string): ApprovalListService {
|
||||
return approvalServiceFor(FORM_ID, listId);
|
||||
}
|
||||
|
||||
function pad2(n: number): string {
|
||||
return n < 10 ? `0${n}` : `${n}`;
|
||||
}
|
||||
|
||||
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||
function buildTitle(candidateName: string, vacancyTitle: string): string {
|
||||
const now = new Date();
|
||||
const date = `${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||
return `Реферальная рекомендация — ${candidateName} — ${vacancyTitle} — ${date}`;
|
||||
}
|
||||
|
||||
/** Поля элемента списка данных из модели формы (+ Referrer по Id). */
|
||||
function buildItem(data: IFormData, status: string, referrerId: number): Record<string, unknown> {
|
||||
return {
|
||||
Title: buildTitle(data.CandidateName, data.VacancyTitle),
|
||||
RequestStatus: status,
|
||||
SubmitDate: data.SubmitDate || null,
|
||||
ReferrerId: referrerId,
|
||||
ReferrerPosition: data.ReferrerPosition || null,
|
||||
ReferrerDepartment: data.ReferrerDepartment || null,
|
||||
ReferrerPhone: data.ReferrerPhone || null,
|
||||
CandidateName: data.CandidateName || null,
|
||||
CandidatePhone: data.CandidatePhone || null,
|
||||
CandidateEmail: data.CandidateEmail || null,
|
||||
CandidateCity: data.CandidateCity || null,
|
||||
VacancyTitle: data.VacancyTitle || null,
|
||||
VacancyDepartment: data.VacancyDepartment || null,
|
||||
CurrentEmployer: data.CurrentEmployer || null,
|
||||
CurrentPosition: data.CurrentPosition || null,
|
||||
ExperienceYears: data.ExperienceYears || null,
|
||||
AcquaintanceDuration: data.AcquaintanceDuration || null,
|
||||
AcquaintanceSource: data.AcquaintanceSource || null,
|
||||
// Уточнение имеет смысл только при «Другое» — иначе не тащим в список остаток
|
||||
// от ранее выбранного варианта (UI его прячет, но значение могло остаться).
|
||||
AcquaintanceSourceOther:
|
||||
data.AcquaintanceSource === OTHER_VALUE ? data.AcquaintanceSourceOther || null : null,
|
||||
Strengths: data.Strengths || null,
|
||||
ConcernsNotes: data.ConcernsNotes || null,
|
||||
ReadyForShiftWork: data.ReadyForShiftWork || null,
|
||||
SalaryExpectations: data.SalaryExpectations || null
|
||||
};
|
||||
}
|
||||
|
||||
export type ISaveResult = ISaveItemResult;
|
||||
|
||||
/**
|
||||
* Сохранить реферальную рекомендацию: содержимое + маршрут согласования.
|
||||
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||
* После согласования — фаза исполнения: реальный исполнитель, назначаемый по
|
||||
* маршруту (не заявителем). executors может быть пустым — тогда после
|
||||
* согласования заявка сразу станет «Согласовано» (как у форм без исполнения).
|
||||
* Возвращает Id заявки (+ код при создании).
|
||||
*
|
||||
* listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadReferralRequest). Имеет смысл
|
||||
* только вместе с existingId: новая заявка всегда создаётся в ТЕКУЩЕЙ партиции —
|
||||
* писать новые заявки в архив незачем и нельзя (approval-route переключает
|
||||
* текущую партицию сам, по своему порогу элементов).
|
||||
*/
|
||||
export async function saveReferralRequest(
|
||||
existingId: number | undefined,
|
||||
requestTypeId: number,
|
||||
data: IFormData,
|
||||
approvers: IApproverToWrite[],
|
||||
executors: IApproverToWrite[],
|
||||
status: string,
|
||||
listId?: string
|
||||
): Promise<ISaveResult> {
|
||||
const referrer = await ensureEmployee(data.Referrer);
|
||||
const item = buildItem(data, status, referrer.Id);
|
||||
|
||||
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
|
||||
await writeRoute(referralApprovalService(listId), result.id, approvers, executors, status);
|
||||
return result;
|
||||
}
|
||||
@@ -19,6 +19,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
||||
() =>
|
||||
import(/* webpackChunkName: 'form-recruiting-hire' */ './RecruitingHire/RecruitingHireForm')
|
||||
),
|
||||
'recruiting-referral': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-referral' */ './Referral/ReferralForm')
|
||||
),
|
||||
'it-workplace-setup': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-workplace-setup' */ './WorkplaceSetup/WorkplaceSetupForm')
|
||||
),
|
||||
|
||||
@@ -32,6 +32,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
||||
'recruiting-hire': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-recruiting-hire' */ './RecruitingHire/RecruitingHireView')
|
||||
),
|
||||
'recruiting-referral': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-referral' */ './Referral/ReferralView')
|
||||
),
|
||||
'it-workplace-setup': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-workplace-setup' */ './WorkplaceSetup/WorkplaceSetupView')
|
||||
),
|
||||
|
||||
@@ -3,7 +3,7 @@ import { resolveRoute } from './approvalRoute.service';
|
||||
import { ApprovalListService, IApproverToWrite } from './approvalList.service';
|
||||
import { IMatrixRow } from './models/IMatrixRow';
|
||||
import { ApprovalStatus, IResolveFieldValue } from './models/IApprovalRouteApi';
|
||||
import { APPROVAL_PHASE, REQUEST_STATUS } from './models/statuses';
|
||||
import { APPROVAL_PHASE, REQUEST_STATUS, isSubmittedStatus } from './models/statuses';
|
||||
|
||||
// Планируемый маршрут для НОВОЙ заявки: resolve по email инициатора → строки матрицы.
|
||||
// status выбирает фазу: 'Approval' (согласующие, по умолчанию) или 'Execution'
|
||||
@@ -82,7 +82,11 @@ export async function writeRoute(
|
||||
// При ОТПРАВКЕ все шаги пишем «Ждёт очереди», затем активируем первый —
|
||||
// так активен ровно текущий шаг, остальные ждут. В черновике — статус заявки
|
||||
// (Черновик), без активации.
|
||||
const submitted = status === REQUEST_STATUS.onApproval;
|
||||
//
|
||||
// Именно предикат, а не `status === onApproval`: отправка маршрута без
|
||||
// согласующих даёт «Выполнение» (см. initialSubmitStatus), и при строгом
|
||||
// сравнении такая заявка не активировала ни одного шага исполнения.
|
||||
const submitted = isSubmittedStatus(status);
|
||||
const rowStatus = submitted ? REQUEST_STATUS.queued : status;
|
||||
|
||||
// Смещение фазы исполнения — по МАКСИМАЛЬНОМУ номеру шага согласующих, а не по
|
||||
|
||||
@@ -7,6 +7,8 @@ export {
|
||||
APPROVAL_PHASE_CHOICES,
|
||||
EDITABLE_STATUSES,
|
||||
isEditableStatus,
|
||||
initialSubmitStatus,
|
||||
isSubmittedStatus,
|
||||
} from './models/statuses';
|
||||
export type { ISiteUser } from './models/ISiteUser';
|
||||
export type { IMatrixRow } from './models/IMatrixRow';
|
||||
|
||||
@@ -5,7 +5,9 @@ import {
|
||||
EDITABLE_STATUSES,
|
||||
REQUEST_STATUS,
|
||||
REQUEST_STATUS_CHOICES,
|
||||
initialSubmitStatus,
|
||||
isEditableStatus,
|
||||
isSubmittedStatus,
|
||||
} from './statuses';
|
||||
|
||||
describe('isEditableStatus', () => {
|
||||
@@ -32,6 +34,43 @@ describe('isEditableStatus', () => {
|
||||
});
|
||||
});
|
||||
|
||||
describe('initialSubmitStatus', () => {
|
||||
it('есть согласующие — заявка идёт на согласование', () => {
|
||||
expect(initialSubmitStatus(2, 0)).toBe(REQUEST_STATUS.onApproval);
|
||||
expect(initialSubmitStatus(2, 3)).toBe(REQUEST_STATUS.onApproval);
|
||||
});
|
||||
|
||||
it('согласующих нет, но есть исполнители — сразу в исполнение', () => {
|
||||
expect(initialSubmitStatus(0, 1)).toBe(REQUEST_STATUS.execution);
|
||||
});
|
||||
|
||||
it('маршрута нет вовсе — заявка сразу согласована', () => {
|
||||
expect(initialSubmitStatus(0, 0)).toBe(REQUEST_STATUS.approved);
|
||||
});
|
||||
});
|
||||
|
||||
// writeRoute по этому предикату решает, писать строки как «Ждёт очереди» и
|
||||
// активировать первую, или оставить как есть (черновик). Каждый статус, который
|
||||
// возвращает initialSubmitStatus, ОБЯЗАН считаться отправкой: иначе строки
|
||||
// маршрута получают недопустимый статус, а активации не происходит вовсе —
|
||||
// именно так заявка без согласующих перестала попадать в очередь исполнения.
|
||||
describe('isSubmittedStatus', () => {
|
||||
it('любой результат initialSubmitStatus считается отправкой', () => {
|
||||
[initialSubmitStatus(1, 0), initialSubmitStatus(0, 1), initialSubmitStatus(0, 0)].forEach((s) =>
|
||||
expect(isSubmittedStatus(s)).toBe(true)
|
||||
);
|
||||
});
|
||||
|
||||
it('черновик отправкой не считается', () => {
|
||||
expect(isSubmittedStatus(REQUEST_STATUS.draft)).toBe(false);
|
||||
});
|
||||
|
||||
it('возврат и отклонение отправкой не считаются (маршрут не переактивируется)', () => {
|
||||
expect(isSubmittedStatus(REQUEST_STATUS.returned)).toBe(false);
|
||||
expect(isSubmittedStatus(REQUEST_STATUS.rejected)).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// Наборы Choice-значений держатся в синхроне с provisioning.json списков —
|
||||
// расхождение ломает запись (SharePoint отвергает значение вне Choice).
|
||||
describe('наборы Choice-значений', () => {
|
||||
|
||||
@@ -43,6 +43,45 @@ export function isEditableStatus(status: string | undefined): boolean {
|
||||
return !status || EDITABLE_STATUSES.indexOf(status) !== -1;
|
||||
}
|
||||
|
||||
/**
|
||||
* Статус ЗАЯВКИ в момент ОТПРАВКИ — до записи строк маршрута (см. writeRoute),
|
||||
* когда реальных строк ещё нет и решать по ним, как computeRequestStatus в
|
||||
* approverDecision.service.ts, нельзя. Формы раньше писали «На согласовании»
|
||||
* безусловно; это неверно для маршрута без согласующих (только исполнение,
|
||||
* см. форму «Реферальная рекомендация») — там заявка должна сразу войти в
|
||||
* фазу исполнения, минуя несуществующую фазу согласования.
|
||||
*
|
||||
* Порядок фаз — тот же, что у computeRequestStatus (согласование → исполнение
|
||||
* → закрыта), только по КОЛИЧЕСТВУ шагов, а не по фактическим статусам строк
|
||||
* (при отправке все строки ещё «Ждёт очереди»/не существуют).
|
||||
*/
|
||||
export function initialSubmitStatus(approversCount: number, executorsCount: number): string {
|
||||
if (approversCount > 0) return REQUEST_STATUS.onApproval;
|
||||
if (executorsCount > 0) return REQUEST_STATUS.execution;
|
||||
return REQUEST_STATUS.approved;
|
||||
}
|
||||
|
||||
/**
|
||||
* Статус заявки означает «отправлена» (в отличие от черновика)?
|
||||
*
|
||||
* Нужен writeRoute: он по этому признаку решает, писать строки маршрута как
|
||||
* «Ждёт очереди» + активировать первую, или сохранить их «как есть» (черновик).
|
||||
* Раньше там стояло строгое `status === onApproval` — единственный статус,
|
||||
* которым формы отправляли заявку. С появлением initialSubmitStatus отправка
|
||||
* может дать «Выполнение» (маршрут без согласующих), и строгое сравнение молча
|
||||
* ломалось: строки получали ApprovalStatus «Выполнение» (недопустимое значение
|
||||
* для строки, см. APPROVAL_ROW_STATUS_CHOICES), а activateNextQueued не
|
||||
* вызывался — ни одна строка не становилась «На исполнении», и заявка не
|
||||
* попадала в очередь исполнителя.
|
||||
*/
|
||||
export function isSubmittedStatus(status: string): boolean {
|
||||
return (
|
||||
status === REQUEST_STATUS.onApproval ||
|
||||
status === REQUEST_STATUS.execution ||
|
||||
status === REQUEST_STATUS.approved
|
||||
);
|
||||
}
|
||||
|
||||
// Наборов значений ДВА, и они не совпадают — это разные сущности:
|
||||
//
|
||||
// 1) статус ЗАЯВКИ — колонка RequestStatus в списке «… — данные». Пишется
|
||||
|
||||
@@ -42,6 +42,11 @@ export const ApprovalMatrix: React.FC<IApprovalMatrixProps> = ({
|
||||
}) => {
|
||||
const { rows, loading, error, editable, blocks } = editor;
|
||||
|
||||
// Подпись «доп. согласующий»/«доп. исполнитель» — из roleLabel, а не
|
||||
// хардкод: иначе блок «Исполнение» (roleLabel="Исполнитель") показывал бы
|
||||
// добавленному через переназначение исполнителю подпись «Доп. согласующий».
|
||||
const addedByLabel = `Доп. ${roleLabel.charAt(0).toLowerCase()}${roleLabel.slice(1)}, добавил:`;
|
||||
|
||||
// Ключи строк и анимация их перестановки. Ключи обязаны быть устойчивыми
|
||||
// (не индекс) — иначе React переписывает строки на месте, и «переезжать»
|
||||
// при перестановке шага будет нечему (см. matrixRowKeys / useFlipRows).
|
||||
@@ -155,13 +160,13 @@ export const ApprovalMatrix: React.FC<IApprovalMatrixProps> = ({
|
||||
{!r.who && r.warning && (
|
||||
<span className={styles.warningInline}>{r.warning}</span>
|
||||
)}
|
||||
{/* Доп. согласующий, добавленный другим согласующим (с правом
|
||||
переназначения) — помечаем, кто его добавил. Пусто у обычных
|
||||
строк маршрута. Как и комментарий — inline под именем, чтобы
|
||||
не ломать rowSpan колонки «Шаг» у параллельных шагов. */}
|
||||
{/* Доп. участник шага, добавленный переназначением — помечаем,
|
||||
кто его добавил. Пусто у обычных строк маршрута. Как и
|
||||
комментарий — inline под именем, чтобы не ломать rowSpan
|
||||
колонки «Шаг» у параллельных шагов. */}
|
||||
{r.addedBy && (
|
||||
<span className={styles.addedByInline}>
|
||||
<span className={styles.addedByLabel}>Доп. согласующий, добавил:</span>{' '}
|
||||
<span className={styles.addedByLabel}>{addedByLabel}</span>{' '}
|
||||
{r.addedBy}
|
||||
</span>
|
||||
)}
|
||||
|
||||
@@ -142,12 +142,18 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
|
||||
}
|
||||
|
||||
if (delegated > 0) {
|
||||
// Склоняем по фазе шага: у исполнения нет «согласующих» — тот, кого
|
||||
// добавили, реально выполняет заявку, а не рассматривает её.
|
||||
const who = isExecution ? 'Исполнитель' : 'Согласующий';
|
||||
const whoMany = isExecution ? 'Исполнителей' : 'Согласующих';
|
||||
const verb = isExecution ? 'выполнит' : 'рассмотрит';
|
||||
const verbMany = isExecution ? 'выполнят' : 'рассмотрят';
|
||||
return (
|
||||
<div className={styles.panel}>
|
||||
<Alert variant="ok">
|
||||
{delegated === 1
|
||||
? 'Согласующий добавлен перед вами — он рассмотрит заявку раньше вас. Ваш шаг остаётся в маршруте.'
|
||||
: `Согласующих добавлено: ${delegated}. Они рассмотрят заявку раньше вас, в порядке добавления. ` +
|
||||
? `${who} добавлен перед вами — он ${verb} заявку раньше вас. Ваш шаг остаётся в маршруте.`
|
||||
: `${whoMany} добавлено: ${delegated}. Они ${verbMany} заявку раньше вас, в порядке добавления. ` +
|
||||
'Ваш шаг остаётся в маршруте.'}
|
||||
</Alert>
|
||||
</div>
|
||||
@@ -234,9 +240,11 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
|
||||
<div className={styles.panel}>
|
||||
<div className={styles.title}>{isExecution ? 'Исполнение' : 'Ваше решение'}</div>
|
||||
<Alert variant="warn">
|
||||
Заявку сейчас рассматривает сотрудник, которого вы добавили перед собой. Ваш шаг никуда
|
||||
не делся — он вернётся к вам, когда очередь дойдёт. Если добавленный сотрудник
|
||||
недоступен, можно добавить ещё.
|
||||
{isExecution
|
||||
? 'Заявку сейчас выполняет сотрудник, которого вы добавили перед собой.'
|
||||
: 'Заявку сейчас рассматривает сотрудник, которого вы добавили перед собой.'}{' '}
|
||||
Ваш шаг никуда не делся — он вернётся к вам, когда очередь дойдёт. Если добавленный
|
||||
сотрудник недоступен, можно добавить ещё.
|
||||
</Alert>
|
||||
{error && <Alert variant="err">{error}</Alert>}
|
||||
{delegateBlock}
|
||||
|
||||
@@ -32,6 +32,7 @@ const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
||||
'it-1c-ticket': 'Заявка в отдел 1С',
|
||||
'it-workplace-setup': 'Организация рабочего места',
|
||||
'recruiting-hire': 'Прием на работу',
|
||||
'recruiting-referral': 'Реферальная рекомендация',
|
||||
'recruiting-selection': 'Заявка на подбор',
|
||||
'wh-tmc-transfer': 'СЗ на перемещение ТМЦ'
|
||||
};
|
||||
|
||||
Reference in New Issue
Block a user