Тимур Городецкий
@@ -20,12 +20,14 @@ import {
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField, WRITE_OFF_CATEGORIES } from './model';
|
||||
import { loadClearanceRequest } from './load';
|
||||
import {
|
||||
clearanceApprovalService,
|
||||
updateApproverFields,
|
||||
IApproverEditableFields
|
||||
updateWriteOffFields,
|
||||
IApproverEditableFields,
|
||||
IWriteOffFields
|
||||
} from './submit';
|
||||
import { canEditHrRecordsFields, canEditParkingField } from './approverRights';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
@@ -52,10 +54,18 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [hrRecordsEditable, setHrRecordsEditable] = useState<boolean>(false);
|
||||
const [parkingEditable, setParkingEditable] = useState<boolean>(false);
|
||||
// Суммы к списанию, в отличие от отметок выше, не привязаны к должности — их
|
||||
// может заполнить ЛЮБОЙ активный согласующий (см. эффект прав ниже).
|
||||
const [canEditWriteOffs, setCanEditWriteOffs] = useState<boolean>(false);
|
||||
// Категории, УЖЕ заблокированные (сумма непустая) НА МОМЕНТ ЗАГРУЗКИ — не
|
||||
// реактивно от текущего data, иначе поле блокировалось бы прямо во время
|
||||
// ввода (набрал сумму → data стал непустым → поле сразу стало бы readOnly).
|
||||
const [lockedWriteOffs, setLockedWriteOffs] = useState<Set<string>>(new Set());
|
||||
const [saveState, setSaveState] = useState<SaveState>('idle');
|
||||
// Какая из организаций сотрудника (см. OrganizationField) идёт в печать —
|
||||
// выбор в тулбаре через PrintOrgSelect, по умолчанию первая.
|
||||
const [printOrgIndex, setPrintOrgIndex] = useState<number>(0);
|
||||
const [saveErrorMessage, setSaveErrorMessage] = useState<string>('');
|
||||
|
||||
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||
|
||||
@@ -105,6 +115,9 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
setCode(loaded.code);
|
||||
setError(null);
|
||||
setLoading(false);
|
||||
setLockedWriteOffs(
|
||||
new Set(WRITE_OFF_CATEGORIES.filter((cat) => !!loaded.data[cat.amountField]).map((cat) => cat.key))
|
||||
);
|
||||
}
|
||||
})
|
||||
.catch((e) => {
|
||||
@@ -130,11 +143,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
const active = !!pending && !pending.isDelegator && pending.phase !== APPROVAL_PHASE.execution;
|
||||
setHrRecordsEditable(active && canEditHrRecordsFields(pending?.position));
|
||||
setParkingEditable(active && canEditParkingField(pending?.position));
|
||||
// Суммы к списанию — без проверки должности: их вводит тот, кто сейчас
|
||||
// фактически согласует шаг, вне зависимости от отдела.
|
||||
setCanEditWriteOffs(active);
|
||||
})
|
||||
.catch(() => {
|
||||
if (alive) {
|
||||
setHrRecordsEditable(false);
|
||||
setParkingEditable(false);
|
||||
setCanEditWriteOffs(false);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
@@ -143,9 +160,24 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
// decisionSeq: после решения/делегирования активный шаг меняется — права пересчитываем.
|
||||
}, [itemId, approverService, decisionSeq]);
|
||||
|
||||
// Категории списания, которые может править ИМЕННО СЕЙЧАС этот пользователь:
|
||||
// ещё не заблокированы (см. lockedWriteOffs) И у него сейчас активный шаг.
|
||||
// Отдельная переменная, не «canEditWriteOffs && !lockedWriteOffs.has(...)»
|
||||
// на месте использования — нужна и в саму секцию (RequestSection), и здесь.
|
||||
const editableWriteOffKeys = useMemo(
|
||||
() =>
|
||||
canEditWriteOffs
|
||||
? new Set(WRITE_OFF_CATEGORIES.filter((cat) => !lockedWriteOffs.has(cat.key)).map((cat) => cat.key))
|
||||
: new Set<string>(),
|
||||
[canEditWriteOffs, lockedWriteOffs]
|
||||
);
|
||||
|
||||
// Пишем ТОЛЬКО те отметки, на которые у согласующего есть права: иначе он
|
||||
// затёр бы чужие поля значениями, которые видел у себя на экране.
|
||||
const saveApproverFields = useCallback((): Promise<void> => {
|
||||
// затёр бы чужие поля значениями, которые видел у себя на экране. Пары сумм к
|
||||
// списанию — только НЕПУСТЫЕ и только среди editableWriteOffKeys; частично
|
||||
// заполненная пара (сумма без комментария или наоборот) бросает ДО записи
|
||||
// чего бы то ни было — половинчатая запись хуже отказа сохранить.
|
||||
const saveApproverFields = useCallback(async (): Promise<void> => {
|
||||
const fields: Partial<IApproverEditableFields> = {};
|
||||
if (hrRecordsEditable) {
|
||||
fields.AccessCard = data.AccessCard;
|
||||
@@ -154,15 +186,36 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
if (parkingEditable) {
|
||||
fields.ParkingCard = data.ParkingCard;
|
||||
}
|
||||
return updateApproverFields(itemId, fields, listId);
|
||||
}, [itemId, listId, hrRecordsEditable, parkingEditable, data.AccessCard, data.TrainingAmount, data.ParkingCard]);
|
||||
|
||||
const writeOffFields: Partial<IWriteOffFields> = {};
|
||||
for (const cat of WRITE_OFF_CATEGORIES) {
|
||||
if (!editableWriteOffKeys.has(cat.key)) continue;
|
||||
const amount = data[cat.amountField].trim();
|
||||
const comment = data[cat.commentField].trim();
|
||||
if (!amount && !comment) continue; // не трогали — не пишем
|
||||
if (!amount || !comment) {
|
||||
throw new Error(
|
||||
`«${cat.label}»: заполните и сумму, и комментарий (за что конкретно) — или оставьте пару пустой.`
|
||||
);
|
||||
}
|
||||
writeOffFields[cat.amountField] = data[cat.amountField];
|
||||
writeOffFields[cat.commentField] = data[cat.commentField];
|
||||
}
|
||||
|
||||
await updateApproverFields(itemId, fields, listId);
|
||||
if (Object.keys(writeOffFields).length > 0) {
|
||||
await updateWriteOffFields(itemId, writeOffFields, listId);
|
||||
}
|
||||
}, [itemId, listId, hrRecordsEditable, parkingEditable, editableWriteOffKeys, data]);
|
||||
|
||||
const handleSaveFields = async (): Promise<void> => {
|
||||
setSaveState('saving');
|
||||
setSaveErrorMessage('');
|
||||
try {
|
||||
await saveApproverFields();
|
||||
setSaveState('saved');
|
||||
} catch {
|
||||
} catch (e) {
|
||||
setSaveErrorMessage(friendlyErrorMessage(e));
|
||||
setSaveState('error');
|
||||
}
|
||||
};
|
||||
@@ -178,8 +231,21 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
);
|
||||
}
|
||||
|
||||
const canEditAnything = hrRecordsEditable || parkingEditable;
|
||||
const sectionProps = { data, set, context, hrRecordsEditable, parkingEditable, printOrgIndex };
|
||||
const canEditAnything = hrRecordsEditable || parkingEditable || canEditWriteOffs;
|
||||
const reviewHints = [
|
||||
hrRecordsEditable && 'отметить карту СКУД и указать сумму за обучение',
|
||||
parkingEditable && 'отметить парковочную карту',
|
||||
editableWriteOffKeys.size > 0 && 'указать суммы к списанию (если применимо)'
|
||||
].filter((hint): hint is string => !!hint);
|
||||
const sectionProps = {
|
||||
data,
|
||||
set,
|
||||
context,
|
||||
hrRecordsEditable,
|
||||
parkingEditable,
|
||||
writeOffEditableKeys: editableWriteOffKeys,
|
||||
printOrgIndex
|
||||
};
|
||||
|
||||
const notify = (): void => {
|
||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||
@@ -203,15 +269,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
{canEditAnything && (
|
||||
<div className={`${styles.reviewBar} rp-no-print`}>
|
||||
<span className={styles.reviewHint}>
|
||||
{hrRecordsEditable
|
||||
? 'Как согласующий вы можете отметить карту СКУД и указать сумму за обучение.'
|
||||
: 'Как согласующий вы можете отметить парковочную карту.'}
|
||||
{reviewHints.length > 0 && `Как согласующий вы можете ${reviewHints.join('; ')}.`}
|
||||
</span>
|
||||
<Button variant="secondary" onClick={handleSaveFields} disabled={saveState === 'saving'}>
|
||||
Сохранить
|
||||
</Button>
|
||||
{saveState === 'saved' && <span className={styles.savedNote}>Сохранено</span>}
|
||||
{saveState === 'error' && <span className={styles.saveError}>Ошибка сохранения</span>}
|
||||
{saveState === 'error' && (
|
||||
<span className={styles.saveError}>{saveErrorMessage || 'Ошибка сохранения'}</span>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
|
||||
|
||||
@@ -39,8 +39,46 @@ RequestTypeId» в `docs/forms.md`). Тип уже зарегистрирова
|
||||
(в отличие от `EndDate` в «Заявке на отпуск», которая считается).
|
||||
- **Заголовок элемента** (`Title`): `Обходной лист — {ФИО} — дд.мм.гггг`.
|
||||
|
||||
## Связь с заявлением на увольнение
|
||||
Обходной лист может появиться **сам, без этой формы**: когда согласовано «Заявление
|
||||
на увольнение» (`hr-dismissal`), портал создаёт лист по нему и сразу отправляет на
|
||||
согласование — см. `forms/Dismissal/createClearance.ts` и README той формы. Такой
|
||||
лист приходит уже с заполненными сотрудником, должностью, подразделением и датой
|
||||
расторжения; отметки (парковка, СКУД, обучение) по-прежнему проставляют профильные
|
||||
согласующие. Подача этой формы руками остаётся — для увольнений, оформленных без
|
||||
заявления в портале.
|
||||
|
||||
Пара связана колонками-гиперссылками: `DismissalUrl` здесь → на заявление,
|
||||
`ClearanceUrl` в заявлении → на лист. Форма их не пишет (заполняет автосоздание либо
|
||||
вручную в SharePoint), но **показывает**: поле «Заявление на увольнение» —
|
||||
`LinkField` из `shared/ui`, read-only, открывается в той же вкладке; у листов,
|
||||
заведённых руками, ссылки нет и поле не рендерится.
|
||||
|
||||
## Суммы к списанию (согласование)
|
||||
6 НЕЗАВИСИМЫХ пар «сумма + обязательный комментарий (за что конкретно)», колонки
|
||||
`WriteOff{Assets,Ppe,Accountable,Training,Nma,Tmc}{Amount,Comment}` (см. `model.ts
|
||||
WRITE_OFF_CATEGORIES`): «ОС», «СИЗ», «Подотчётная сумма», «Обучение», «НМА», «ТМЦ».
|
||||
|
||||
- **Не привязаны к должности**, в отличие от отметок выше: заполнить может ЛЮБОЙ
|
||||
согласующий, у которого сейчас активный шаг (`ClearanceView.canEditWriteOffs`,
|
||||
фаза «Согласование» — исполнителям недоступно, как и остальным отметкам).
|
||||
- **Каждая пара блокируется НАВСЕГДА после первого ввода** — как только сумма
|
||||
непустая, поле становится read-only для всех, включая того, кто её ввёл.
|
||||
Признак блокировки — сама непустая сумма на МОМЕНТ ЗАГРУЗКИ страницы
|
||||
(`ClearanceView.lockedWriteOffs`, снимок при загрузке, а не реактивно от
|
||||
текущего `data` — иначе поле блокировалось бы прямо во время набора цифр).
|
||||
- **Комментарий обязателен вместе с суммой**: заполнить можно либо обе половины
|
||||
пары, либо ни одной — `saveApproverFields` бросает ДО записи чего бы то ни
|
||||
было, если половина пары осталась пустой.
|
||||
- Сохраняются той же кнопкой «Сохранить» (`reviewBar`), что и остальные отметки,
|
||||
и тем же `onBeforeDecide` — при решении несохранённые суммы уйдут вместе с ним.
|
||||
- Это ОТДЕЛЬНЫЙ механизм от `TrainingAmount` («Обучение: сумма» выше, привязана к
|
||||
КДП) — сознательно не объединялись, чтобы не менять уже установившееся
|
||||
поведение существующего поля.
|
||||
|
||||
## Секции формы
|
||||
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма обучения · парковочная карта · карта СКУД)
|
||||
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма
|
||||
обучения · парковочная карта · карта СКУД · суммы к списанию · ссылка на заявление)
|
||||
|
||||
## Точки входа
|
||||
- rptype: `clearance-form`
|
||||
|
||||
@@ -2,6 +2,11 @@ import { getSP } from '../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||
|
||||
/** Число или '' (SharePoint отдаёт null для незаполненного Number). */
|
||||
function numberField(value: unknown): string {
|
||||
return value === null || value === undefined ? '' : String(value);
|
||||
}
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
/** Ф.И.О. увольняемого сотрудника из поля Employee (для заголовка режима чтения). */
|
||||
@@ -34,6 +39,19 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
||||
'Organization',
|
||||
'Project',
|
||||
'ProjectId',
|
||||
'DismissalUrl',
|
||||
'WriteOffAssetsAmount',
|
||||
'WriteOffAssetsComment',
|
||||
'WriteOffPpeAmount',
|
||||
'WriteOffPpeComment',
|
||||
'WriteOffAccountableAmount',
|
||||
'WriteOffAccountableComment',
|
||||
'WriteOffTrainingAmount',
|
||||
'WriteOffTrainingComment',
|
||||
'WriteOffNmaAmount',
|
||||
'WriteOffNmaComment',
|
||||
'WriteOffTmcAmount',
|
||||
'WriteOffTmcComment',
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
'Employee/Title',
|
||||
@@ -56,7 +74,21 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
||||
TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
|
||||
Organization: (item.Organization as string) || '',
|
||||
Project: (item.Project as string) || '',
|
||||
ProjectId: (item.ProjectId as string) || ''
|
||||
ProjectId: (item.ProjectId as string) || '',
|
||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||
DismissalUrl: (item.DismissalUrl as { Url?: string } | undefined)?.Url || '',
|
||||
WriteOffAssetsAmount: numberField(item.WriteOffAssetsAmount),
|
||||
WriteOffAssetsComment: (item.WriteOffAssetsComment as string) || '',
|
||||
WriteOffPpeAmount: numberField(item.WriteOffPpeAmount),
|
||||
WriteOffPpeComment: (item.WriteOffPpeComment as string) || '',
|
||||
WriteOffAccountableAmount: numberField(item.WriteOffAccountableAmount),
|
||||
WriteOffAccountableComment: (item.WriteOffAccountableComment as string) || '',
|
||||
WriteOffTrainingAmount: numberField(item.WriteOffTrainingAmount),
|
||||
WriteOffTrainingComment: (item.WriteOffTrainingComment as string) || '',
|
||||
WriteOffNmaAmount: numberField(item.WriteOffNmaAmount),
|
||||
WriteOffNmaComment: (item.WriteOffNmaComment as string) || '',
|
||||
WriteOffTmcAmount: numberField(item.WriteOffTmcAmount),
|
||||
WriteOffTmcComment: (item.WriteOffTmcComment as string) || ''
|
||||
};
|
||||
|
||||
return {
|
||||
|
||||
@@ -35,8 +35,84 @@ export interface IFormData {
|
||||
Project: string;
|
||||
/** oid проекта ('' — если введён вручную без выбора из списка). */
|
||||
ProjectId: string;
|
||||
/**
|
||||
* Ссылка на заявление на увольнение, по которому создан этот лист — колонка-
|
||||
* гиперссылка `DismissalUrl`. Форма её не пишет (заполняет автосоздание, см.
|
||||
* forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
|
||||
*/
|
||||
DismissalUrl: string;
|
||||
|
||||
/**
|
||||
* Суммы к списанию по обходному листу — 6 независимых пар (сумма +
|
||||
* обязательный комментарий, «за что конкретно»), см. WRITE_OFF_CATEGORIES.
|
||||
* «Сырые» цифры без пробелов, как TrainingAmount (см. MoneyInput). Пусто =
|
||||
* не заполнено. КАЖДАЯ пара — независимая: заполнить может любой активный
|
||||
* согласующий (см. ClearanceView.canEditWriteOffs), но как только сумма
|
||||
* непустая — пара блокируется НАВСЕГДА, для всех (включая того, кто её ввёл).
|
||||
* Признак блокировки — сама непустая сумма, отдельного флага в списке нет.
|
||||
*/
|
||||
WriteOffAssetsAmount: string;
|
||||
WriteOffAssetsComment: string;
|
||||
WriteOffPpeAmount: string;
|
||||
WriteOffPpeComment: string;
|
||||
WriteOffAccountableAmount: string;
|
||||
WriteOffAccountableComment: string;
|
||||
WriteOffTrainingAmount: string;
|
||||
WriteOffTrainingComment: string;
|
||||
WriteOffNmaAmount: string;
|
||||
WriteOffNmaComment: string;
|
||||
WriteOffTmcAmount: string;
|
||||
WriteOffTmcComment: string;
|
||||
}
|
||||
|
||||
/** Имена всех 12 строковых полей сумм/комментариев к списанию — см. IFormData.WriteOff*. */
|
||||
export type WriteOffFieldKey =
|
||||
| 'WriteOffAssetsAmount'
|
||||
| 'WriteOffAssetsComment'
|
||||
| 'WriteOffPpeAmount'
|
||||
| 'WriteOffPpeComment'
|
||||
| 'WriteOffAccountableAmount'
|
||||
| 'WriteOffAccountableComment'
|
||||
| 'WriteOffTrainingAmount'
|
||||
| 'WriteOffTrainingComment'
|
||||
| 'WriteOffNmaAmount'
|
||||
| 'WriteOffNmaComment'
|
||||
| 'WriteOffTmcAmount'
|
||||
| 'WriteOffTmcComment';
|
||||
|
||||
/**
|
||||
* Одна из 6 независимых категорий списания — см. IFormData.WriteOff*.
|
||||
* amountField/commentField сужены до WriteOffFieldKey (а не keyof IFormData
|
||||
* целиком): у IFormData есть и булевы поля (ParkingCard/AccessCard), и
|
||||
* `data[cat.amountField]` должен типизироваться строго строкой — иначе
|
||||
* `.trim()` в валидации и передача в MoneyInput/TextArea не собираются.
|
||||
*/
|
||||
export interface IWriteOffCategory {
|
||||
key: string;
|
||||
label: string;
|
||||
amountField: WriteOffFieldKey;
|
||||
commentField: WriteOffFieldKey;
|
||||
}
|
||||
|
||||
export const WRITE_OFF_CATEGORIES: IWriteOffCategory[] = [
|
||||
{ key: 'assets', label: 'ОС', amountField: 'WriteOffAssetsAmount', commentField: 'WriteOffAssetsComment' },
|
||||
{ key: 'ppe', label: 'СИЗ', amountField: 'WriteOffPpeAmount', commentField: 'WriteOffPpeComment' },
|
||||
{
|
||||
key: 'accountable',
|
||||
label: 'Подотчётная сумма',
|
||||
amountField: 'WriteOffAccountableAmount',
|
||||
commentField: 'WriteOffAccountableComment'
|
||||
},
|
||||
{
|
||||
key: 'training',
|
||||
label: 'Обучение',
|
||||
amountField: 'WriteOffTrainingAmount',
|
||||
commentField: 'WriteOffTrainingComment'
|
||||
},
|
||||
{ key: 'nma', label: 'НМА', amountField: 'WriteOffNmaAmount', commentField: 'WriteOffNmaComment' },
|
||||
{ key: 'tmc', label: 'ТМЦ', amountField: 'WriteOffTmcAmount', commentField: 'WriteOffTmcComment' }
|
||||
];
|
||||
|
||||
/** Обновление одного поля формы с сохранением типа значения. */
|
||||
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||
|
||||
@@ -64,7 +140,20 @@ export const EMPTY_DATA: IFormData = {
|
||||
TrainingAmount: '',
|
||||
Organization: '',
|
||||
Project: '',
|
||||
ProjectId: ''
|
||||
ProjectId: '',
|
||||
DismissalUrl: '',
|
||||
WriteOffAssetsAmount: '',
|
||||
WriteOffAssetsComment: '',
|
||||
WriteOffPpeAmount: '',
|
||||
WriteOffPpeComment: '',
|
||||
WriteOffAccountableAmount: '',
|
||||
WriteOffAccountableComment: '',
|
||||
WriteOffTrainingAmount: '',
|
||||
WriteOffTrainingComment: '',
|
||||
WriteOffNmaAmount: '',
|
||||
WriteOffNmaComment: '',
|
||||
WriteOffTmcAmount: '',
|
||||
WriteOffTmcComment: ''
|
||||
};
|
||||
|
||||
/** Плейсхолдер для поля выбора сотрудника. */
|
||||
|
||||
@@ -14,6 +14,21 @@
|
||||
{ "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||
{ "internalName": "Project", "title": "Проект", "type": "Text" },
|
||||
{ "internalName": "ProjectId", "title": "Id проекта (справочник)", "type": "Text" }
|
||||
{ "internalName": "ProjectId", "title": "Id проекта (справочник)", "type": "Text" },
|
||||
|
||||
{ "internalName": "DismissalUrl", "title": "Ссылка на заявление на увольнение", "type": "Url" },
|
||||
|
||||
{ "internalName": "WriteOffAssetsAmount", "title": "Сумма к списанию: ОС", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffAssetsComment", "title": "Комментарий: ОС", "type": "Note" },
|
||||
{ "internalName": "WriteOffPpeAmount", "title": "Сумма к списанию: СИЗ", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffPpeComment", "title": "Комментарий: СИЗ", "type": "Note" },
|
||||
{ "internalName": "WriteOffAccountableAmount", "title": "Сумма к списанию: подотчётная сумма", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffAccountableComment", "title": "Комментарий: подотчётная сумма", "type": "Note" },
|
||||
{ "internalName": "WriteOffTrainingAmount", "title": "Сумма к списанию: обучение", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffTrainingComment", "title": "Комментарий: обучение", "type": "Note" },
|
||||
{ "internalName": "WriteOffNmaAmount", "title": "Сумма к списанию: НМА", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffNmaComment", "title": "Комментарий: НМА", "type": "Note" },
|
||||
{ "internalName": "WriteOffTmcAmount", "title": "Сумма к списанию: ТМЦ", "type": "Number", "decimals": 2 },
|
||||
{ "internalName": "WriteOffTmcComment", "title": "Комментарий: ТМЦ", "type": "Note" }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField } from '../../../shared/ui';
|
||||
import { CollapseSection, FormField, TextArea, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
|
||||
import { ProjectPicker } from '../../../shared/dictionary';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER, WRITE_OFF_CATEGORIES } from '../model';
|
||||
|
||||
// Подразделение подтягивается автоматически при выборе сотрудника (см.
|
||||
// ClearanceForm.handleEmployeeChange — SharePoint User Profile) — свободный
|
||||
@@ -13,6 +13,14 @@ interface IRequestSectionProps extends ISectionProps {
|
||||
hrRecordsEditable?: boolean;
|
||||
/** Согласующий из отдела подбора правит парковочную карту. */
|
||||
parkingEditable?: boolean;
|
||||
/**
|
||||
* Ключи категорий списания (см. WRITE_OFF_CATEGORIES), которые ЭТОТ
|
||||
* пользователь может сейчас заполнить — присутствие пропа (даже пустым
|
||||
* Set'ом) включает блок сумм к списанию; не задан вовсе (форма подачи, см.
|
||||
* ClearanceForm) — блок не показывается: до первого решения списывать
|
||||
* нечего. См. ClearanceView.editableWriteOffKeys.
|
||||
*/
|
||||
writeOffEditableKeys?: Set<string>;
|
||||
}
|
||||
|
||||
/** Единственная секция формы «Обходной лист»: увольняемый, должность, подразделение, даты, карты, обучение. */
|
||||
@@ -23,7 +31,8 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
onEmployeeChange,
|
||||
hrRecordsEditable,
|
||||
parkingEditable,
|
||||
printOrgIndex
|
||||
printOrgIndex,
|
||||
writeOffEditableKeys
|
||||
}) => (
|
||||
<CollapseSection title="Обходной лист" icon="people">
|
||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||
@@ -103,5 +112,47 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
readOnly={hrRecordsEditable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
{/* Суммы к списанию — 6 независимых пар (сумма + обязательный комментарий,
|
||||
за что конкретно). Каждую может заполнить ЛЮБОЙ активный согласующий
|
||||
(не только профильный, в отличие от отметок выше) — но как только сумма
|
||||
указана, пара блокируется навсегда для всех, поэтому у незаблокированных
|
||||
(writeOffEditableKeys.has(cat.key)) есть readOnly={false}, у остальных —
|
||||
обычное поведение FormMode (просмотр — заблокировано и так). */}
|
||||
{writeOffEditableKeys &&
|
||||
WRITE_OFF_CATEGORIES.map((cat) => {
|
||||
const editable = writeOffEditableKeys.has(cat.key);
|
||||
return (
|
||||
<React.Fragment key={cat.key}>
|
||||
<FormField label={`${cat.label}: сумма`} htmlFor={cat.amountField}>
|
||||
<MoneyInput
|
||||
id={cat.amountField}
|
||||
value={data[cat.amountField]}
|
||||
onChange={(v) => set(cat.amountField, v)}
|
||||
readOnly={editable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField
|
||||
label={`${cat.label}: за что конкретно`}
|
||||
htmlFor={cat.commentField}
|
||||
required={editable}
|
||||
full
|
||||
>
|
||||
<TextArea
|
||||
id={cat.commentField}
|
||||
value={data[cat.commentField]}
|
||||
onChange={(v) => set(cat.commentField, v)}
|
||||
readOnly={editable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
</React.Fragment>
|
||||
);
|
||||
})}
|
||||
{/* Есть только у листов, созданных автоматически по согласованному заявлению
|
||||
на увольнение (см. forms/Dismissal/createClearance.ts). */}
|
||||
<LinkField
|
||||
label="Заявление на увольнение"
|
||||
url={data.DismissalUrl}
|
||||
text="Открыть заявление, по которому создан этот лист"
|
||||
/>
|
||||
</CollapseSection>
|
||||
);
|
||||
|
||||
@@ -1,7 +1,40 @@
|
||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
||||
import { ensureEmployee } from '../../shared/employee';
|
||||
import { FORM_ID, IFormData } from './model';
|
||||
import { FORM_ID, IFormData, WriteOffFieldKey } from './model';
|
||||
|
||||
/** Одна из 12 колонок сумм/комментариев к списанию — см. model.ts WRITE_OFF_CATEGORIES. */
|
||||
export type IWriteOffFields = Pick<IFormData, WriteOffFieldKey>;
|
||||
|
||||
/**
|
||||
* Записать сумму(ы)/комментарий(и) к списанию. Пишет РОВНО переданные поля —
|
||||
* как updateApproverFields, каждая пара независима.
|
||||
*
|
||||
* ВАЖНО: вызывающая сторона (ClearanceView) обязана передавать сюда ТОЛЬКО те
|
||||
* пары, что ещё не заблокированы (см. IFormData.WriteOff* — блокировка по
|
||||
* непустой сумме) и заполнены целиком (сумма+комментарий вместе, см.
|
||||
* validateWriteOffPairs) — эта функция сама повторно ничего не проверяет и
|
||||
* молча перезапишет то, что ей передали.
|
||||
*/
|
||||
export async function updateWriteOffFields(
|
||||
id: number,
|
||||
fields: Partial<IWriteOffFields>,
|
||||
listId?: string
|
||||
): Promise<void> {
|
||||
const item: Record<string, unknown> = {};
|
||||
for (const key of Object.keys(fields) as Array<keyof IWriteOffFields>) {
|
||||
const raw = fields[key];
|
||||
if (raw === undefined) continue;
|
||||
if (key.endsWith('Amount')) {
|
||||
const amount = Number(raw);
|
||||
item[key] = Number.isFinite(amount) && raw.trim() !== '' ? amount : null;
|
||||
} else {
|
||||
item[key] = raw || null;
|
||||
}
|
||||
}
|
||||
if (Object.keys(item).length === 0) return;
|
||||
await resolveDataList(FORM_ID, listId).items.getById(id).update(item);
|
||||
}
|
||||
|
||||
/**
|
||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||
|
||||
@@ -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,336 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||
import styles from './DismissalForm.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
|
||||
} from '../../shared/approval';
|
||||
import { IRequestFormProps } from '../../models/types';
|
||||
import { getEmployeeOrganizations, getCompanyDirectorEmail, IEmployeeOrganization } from '../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { isoDatePlusMonths, formatIsoDate } from '../../shared/dateUtils';
|
||||
import {
|
||||
approvalListTitle,
|
||||
approvalListTitleForListId,
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField, MIN_NOTICE_MONTHS, IOrganizationRecord, primaryPosition } from './model';
|
||||
import { saveDismissalRequest, dismissalApprovalService } from './submit';
|
||||
import { loadDismissalRequest } from './load';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
|
||||
const DismissalForm: 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 (см. её комментарий) — если бы партиции
|
||||
// не нашлось в реестре, форма сюда вообще не смонтировалась бы, поэтому здесь
|
||||
// dismissalApprovalService можно звать не опасаясь исключения.
|
||||
const approval = useMemo(() => dismissalApprovalService(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;
|
||||
// Таблица организаций читается ЦЕЛИКОМ из самой заявки (loaded.data.Organization
|
||||
// — уже собранная зипом трёх столбцов, см. load.ts) — повторный поход в
|
||||
// Employee/ByEmail здесь не нужен: если при подаче убрали компанию, это уже
|
||||
// зафиксировано в сохранённых данных, а не в живом состоянии справочника.
|
||||
loadDismissalRequest(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]);
|
||||
|
||||
/** Employee/ByEmail → таблица организаций (см. IOrganizationRecord). */
|
||||
const toOrganization = (records: IEmployeeOrganization[]): IOrganizationRecord[] =>
|
||||
records.map((r) => ({ company: r.company, department: r.section, position: r.position }));
|
||||
|
||||
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя и его
|
||||
// таблицу организаций (Employee/ByEmail — см. shared/dictionary/
|
||||
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких).
|
||||
// Должность первой (основной) компании читает маршрут (см. primaryPosition) и
|
||||
// остаётся редактируемой на форме — см. OrganizationsTable.
|
||||
useEffect(() => {
|
||||
if (editId) {
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
const user = context.pageContext.user;
|
||||
setData((prev) => ({ ...prev, Employee: prev.Employee || user.email }));
|
||||
getEmployeeOrganizations(context, user.email)
|
||||
.then((records) => {
|
||||
if (!alive) return;
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Organization: prev.Organization.length > 0 ? prev.Organization : toOrganization(records)
|
||||
}));
|
||||
})
|
||||
.catch(() => undefined);
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId]);
|
||||
|
||||
// Выбор другого сотрудника подтягивает его таблицу организаций.
|
||||
const handleEmployeeChange = (login: string): void => {
|
||||
setData((prev) => ({ ...prev, Employee: login, Organization: [] }));
|
||||
if (!login) {
|
||||
return;
|
||||
}
|
||||
getEmployeeOrganizations(context, login)
|
||||
.then((records) => setData((prev) => ({ ...prev, Organization: toOrganization(records) })))
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
// Планируемый маршрут резолвится по e-mail ВЫБРАННОГО сотрудника (не текущего
|
||||
// пользователя) — так работает подача за другого; условие «IsManager» на бэкенде
|
||||
// считается по полю Position ЭТОЙ заявки, поэтому передаём его в fieldValues.
|
||||
// У заявки на редактировании маршрут читается из уже записанных строк, чтобы не
|
||||
// затереть правки инициатора.
|
||||
const loadMatrix = useCallback(
|
||||
() =>
|
||||
editId
|
||||
? approval.getMatrixForRequest(editId)
|
||||
: getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval', null, [
|
||||
{ fieldName: 'Position', value: primaryPosition(data.Organization) }
|
||||
]),
|
||||
[context, approval, editId, data.Employee, data.Organization, requestTypeId]
|
||||
);
|
||||
const matrix = useMatrixEditor(
|
||||
loadMatrix,
|
||||
`${data.Employee}-${editId ?? 'new'}-${primaryPosition(data.Organization)}`,
|
||||
!readOnly,
|
||||
!!editId || (!!data.Employee && !!requestTypeId),
|
||||
(login) => approval.getJobTitle(login)
|
||||
);
|
||||
|
||||
// Убрать компанию из заявления (совместитель, реально не увольняется из
|
||||
// ВСЕХ) — см. OrganizationsTable. Снимает компанию из data.Organization И, по
|
||||
// возможности, соответствующего согласующего (директора/должностного
|
||||
// эквивалента этой компании, см. shared/dictionary/employeeLookup.service —
|
||||
// тот же справочник, каким резолвит approval-route HeadType.CompanyDirectors)
|
||||
// из уже загруженной матрицы — искать и удалять его там вручную не нужно.
|
||||
//
|
||||
// Матрица планируется ОДНИМ шагом на все компании сразу (все директора — одна
|
||||
// и та же строка маршрута с несколькими исполнителями), поэтому убрать можно
|
||||
// только из уже пришедшего результата — если матрица ещё грузится или
|
||||
// директор этой компании в ней не нашёлся (например, маршрут ещё не готов),
|
||||
// компания всё равно убирается из заявления, а несовпадение тихо игнорируем:
|
||||
// HR в этом случае уберёт лишнего согласующего вручную через саму матрицу.
|
||||
const handleRemoveOrganization = (company: string): void => {
|
||||
setData((prev) => ({ ...prev, Organization: prev.Organization.filter((r) => r.company !== company) }));
|
||||
|
||||
getCompanyDirectorEmail(context, company)
|
||||
.then((email) => {
|
||||
if (!email) return;
|
||||
const idx = matrix.rows.findIndex((r) => r.email.toLowerCase() === email.toLowerCase());
|
||||
if (idx >= 0) matrix.remove(idx);
|
||||
})
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
// Последний рабочий день нужно назначать минимум за MIN_NOTICE_MONTHS месяц —
|
||||
// календарь (min у input type=date, см. RequestSection) не даёт выбрать более
|
||||
// раннюю дату, но проверяем и здесь на случай обхода UI.
|
||||
const minLastWorkingDay = isoDatePlusMonths(MIN_NOTICE_MONTHS);
|
||||
const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= minLastWorkingDay;
|
||||
const position = primaryPosition(data.Organization);
|
||||
const isValid = !!(data.Employee && position.trim() && data.LastWorkingDay && isLastDayValid && data.Phone.trim());
|
||||
const validate = (): string | undefined => {
|
||||
if (data.LastWorkingDay && !isLastDayValid) {
|
||||
return `Последний рабочий день нужно назначать минимум за ${MIN_NOTICE_MONTHS} месяц — минимально доступная дата: ${formatIsoDate(minLastWorkingDay)}.`;
|
||||
}
|
||||
if (!data.Employee || !position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
|
||||
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 saveDismissalRequest(
|
||||
requestId,
|
||||
rtId,
|
||||
data,
|
||||
toApprovers(matrix.rows),
|
||||
status,
|
||||
writeListId
|
||||
);
|
||||
setRequestId(id);
|
||||
setRequestStatus(status);
|
||||
if (code) {
|
||||
setRequestCode(code);
|
||||
}
|
||||
if (onSaved) {
|
||||
onSaved();
|
||||
}
|
||||
// Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
|
||||
// Имена списков — той же партиции, куда фактически записана заявка (writeListId),
|
||||
// не текущей: поток ищет строку маршрута именно в НЕЙ.
|
||||
if (status === REQUEST_STATUS.onApproval) {
|
||||
await notifyActiveStep(context, approval, id, {
|
||||
requestTypeId: rtId,
|
||||
dataListName: writeListId ? dataListTitleForListId(FORM_ID, writeListId) : dataListTitle(FORM_ID),
|
||||
approvalListName: writeListId ? approvalListTitleForListId(FORM_ID, writeListId) : approvalListTitle(FORM_ID)
|
||||
});
|
||||
}
|
||||
};
|
||||
|
||||
// На отправку (в отличие от черновика) маршрут должен быть полностью
|
||||
// укомплектован — иначе шаг без назначенного человека молча пропадёт при записи.
|
||||
const validateSubmit = (): string | undefined => {
|
||||
const formError = validate();
|
||||
if (formError) return formError;
|
||||
if (matrix.error) {
|
||||
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
|
||||
}
|
||||
const unassignedError = unassignedStepMessage(
|
||||
matrix.rows,
|
||||
(r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
|
||||
);
|
||||
if (unassignedError) return unassignedError;
|
||||
return undefined;
|
||||
};
|
||||
|
||||
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||
const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||
|
||||
const sectionProps = {
|
||||
data,
|
||||
set,
|
||||
context,
|
||||
onEmployeeChange: handleEmployeeChange,
|
||||
onRemoveOrganization: handleRemoveOrganization
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
<button type="button" className={styles.back} onClick={onCancel}>
|
||||
<Icon name="arrow-left" size="sm" />
|
||||
<span>К списку заявок</span>
|
||||
</button>
|
||||
|
||||
<FormCard
|
||||
title={requestType.title}
|
||||
subtitle="Категория: Отдел кадров"
|
||||
belowSubtitle={
|
||||
<InitiatorLine
|
||||
listTitle={editListId ? dataListTitleForListId(FORM_ID, editListId) : dataListTitle(FORM_ID)}
|
||||
itemId={requestId}
|
||||
/>
|
||||
}
|
||||
headerRight={
|
||||
requestId || requestStatus ? (
|
||||
<>
|
||||
{requestStatus && <StatusBadge status={requestStatus} />}
|
||||
{requestCode && <RequestNumber code={requestCode} />}
|
||||
</>
|
||||
) : undefined
|
||||
}
|
||||
>
|
||||
{submit.savedKind && !submit.error && (
|
||||
<Alert variant="ok">
|
||||
{submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
|
||||
</Alert>
|
||||
)}
|
||||
{submit.error && <Alert variant="err">{submit.error}</Alert>}
|
||||
|
||||
<FormModeProvider readOnly={readOnly}>
|
||||
<RequestSection {...sectionProps} />
|
||||
</FormModeProvider>
|
||||
|
||||
<ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
|
||||
|
||||
<SubmitActions
|
||||
submit={submit}
|
||||
isValid={isValid}
|
||||
readOnly={readOnly}
|
||||
onCancel={onCancel}
|
||||
onSaveDraft={handleSaveDraft}
|
||||
onSubmit={handleSubmit}
|
||||
submitLabel="Отправить на согласование"
|
||||
/>
|
||||
</FormCard>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default DismissalForm;
|
||||
@@ -0,0 +1,21 @@
|
||||
@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;
|
||||
}
|
||||
|
||||
.printBlocked {
|
||||
font-family: $font-sans;
|
||||
font-size: $fs-sm;
|
||||
color: $gray-500;
|
||||
cursor: help;
|
||||
}
|
||||
@@ -0,0 +1,309 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useEffect, useMemo, useCallback } from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import styles from './DismissalView.module.scss';
|
||||
import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintButton } from '../../shared/ui';
|
||||
import {
|
||||
ApproverService,
|
||||
DecisionPanel,
|
||||
StatusBadge,
|
||||
ApprovalMatrix,
|
||||
useMatrixEditor,
|
||||
notifyActiveStep,
|
||||
useRequestTypeId,
|
||||
REQUEST_STATUS
|
||||
} from '../../shared/approval';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { getManagerEmail } from '../../shared/dictionary';
|
||||
import { effectiveUserEmail } from '../../shared/impersonation';
|
||||
import {
|
||||
approvalListTitle,
|
||||
approvalListTitleForListId,
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { parseRoute } from '../../shared/routing';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { loadDismissalRequest } from './load';
|
||||
import { dismissalApprovalService, updateAssetsAcceptor } from './submit';
|
||||
import { loadClearanceRequest } from '../Clearance/load';
|
||||
import { ensureClearanceForDismissal } from './createClearance';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
|
||||
/**
|
||||
* Статусы обходного листа, при которых его СОГЛАСОВАНИЕ уже пройдено целиком
|
||||
* (независимо от фазы исполнения, которая у него есть) — печать заявления на
|
||||
* увольнение разрешена начиная отсюда. См. handlePrintGate ниже.
|
||||
*/
|
||||
const CLEARANCE_READY_STATUSES: ReadonlySet<string> = new Set([
|
||||
REQUEST_STATUS.approved,
|
||||
REQUEST_STATUS.execution,
|
||||
REQUEST_STATUS.closed
|
||||
]);
|
||||
|
||||
interface IDismissalViewProps {
|
||||
context: WebPartContext;
|
||||
itemId: number;
|
||||
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||
formKey: string;
|
||||
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||
listId?: string;
|
||||
}
|
||||
|
||||
// Заявление на увольнение только для просмотра (режим согласующего).
|
||||
// Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
|
||||
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||
const DismissalView: React.FC<IDismissalViewProps> = ({ 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);
|
||||
// Итог автосоздания обходного листа после согласования (см. onDecided ниже).
|
||||
const [clearance, setClearance] = useState<string>('');
|
||||
const [clearanceError, setClearanceError] = useState<string>('');
|
||||
// Печать разрешена только с этого момента — см. эффект ниже (printGate).
|
||||
const [printGate, setPrintGate] = useState<'checking' | 'blocked' | 'allowed'>('checking');
|
||||
const [assetsAcceptorEditable, setAssetsAcceptorEditable] = useState<boolean>(false);
|
||||
|
||||
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||
// dismissalApprovalService можно звать не опасаясь исключения.
|
||||
const approval = useMemo(() => dismissalApprovalService(listId), [listId]);
|
||||
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||
// Ref списка данных для ApproverService.updateRequestStatus: listId (url) для
|
||||
// архивной партиции, Title текущей — иначе (см. ApproverService.dataListRef).
|
||||
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||
|
||||
// Матрица маршрута из фактических строк заявки (read-only). decisionSeq в
|
||||
// reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
|
||||
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId), [approval, itemId]);
|
||||
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
|
||||
approval.getJobTitle(l)
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
let alive = true;
|
||||
setLoading(true);
|
||||
loadDismissalRequest(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]);
|
||||
|
||||
// Печать заявления запрещена до согласования ПАРНОГО обходного листа: сначала
|
||||
// должны отработать/подтвердиться все связанные с увольнением отметки (карты,
|
||||
// суммы к списанию) — печатать заявление раньше значит выдать документ, когда
|
||||
// процесс увольнения ещё не подтверждён целиком. Пока обходной лист не создан
|
||||
// (заявление ещё не согласовано, либо автосоздание не удалось) печать тоже
|
||||
// заблокирована — печатать нечего.
|
||||
//
|
||||
// Статус читаем НАПРЯМУЮ из ClearanceUrl (rpid/rplist в самой ссылке), а не
|
||||
// храним отдельным полем: ссылка и так единственный источник, откуда мы вообще
|
||||
// знаем, какой это обходной лист, дублировать его id/партицию незачем.
|
||||
useEffect(() => {
|
||||
if (!data.ClearanceUrl) {
|
||||
setPrintGate('blocked');
|
||||
return;
|
||||
}
|
||||
const route = parseRoute(new URL(data.ClearanceUrl).search);
|
||||
if (route.mode !== 'approve' || !route.itemId) {
|
||||
setPrintGate('blocked');
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
setPrintGate('checking');
|
||||
loadClearanceRequest(route.itemId, route.listId)
|
||||
.then((loaded) => {
|
||||
if (alive) setPrintGate(CLEARANCE_READY_STATUSES.has(loaded.status) ? 'allowed' : 'blocked');
|
||||
})
|
||||
.catch(() => {
|
||||
if (alive) setPrintGate('blocked');
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [data.ClearanceUrl]);
|
||||
|
||||
// Права на «Лицо, принимающее ОС/НМА» — по ИДЕНТИЧНОСТИ (это конкретно
|
||||
// непосредственный руководитель увольняемого, не любой согласующий с нужной
|
||||
// должностью, как в approverRights.ts «Обходного листа»), и только пока у него
|
||||
// сейчас активный шаг: getManagerEmail дублирует тот же запрос
|
||||
// (Employee/Manager, managerType=chief), что approval-route делает для
|
||||
// HeadType.Chief при планировании этого же маршрута (см. README формы).
|
||||
//
|
||||
// Сравниваем с effectiveUserEmail, а не с context.pageContext.user.email
|
||||
// напрямую: getPendingRowForCurrentUser (через ApprovalListService.
|
||||
// getCurrentUserId) уже учитывает отладочную подмену личности (см.
|
||||
// shared/impersonation.ts) — без того же самого здесь «активный шаг есть»
|
||||
// (active=true под подменённым) и «это я» (isManager=false, сравнили с
|
||||
// РЕАЛЬНЫМ логином) расходились бы, и поле оставалось бы заблокированным
|
||||
// даже когда подмена указывает именно на этого руководителя.
|
||||
useEffect(() => {
|
||||
if (!data.Employee) return;
|
||||
let alive = true;
|
||||
Promise.all([approverService.getPendingRowForCurrentUser(itemId), getManagerEmail(context, data.Employee, 'chief')])
|
||||
.then(([pending, managerEmail]) => {
|
||||
if (!alive) return;
|
||||
const active = !!pending && !pending.isDelegator;
|
||||
const isManager = !!managerEmail && managerEmail.toLowerCase() === effectiveUserEmail(context).toLowerCase();
|
||||
setAssetsAcceptorEditable(active && isManager);
|
||||
})
|
||||
.catch(() => {
|
||||
if (alive) setAssetsAcceptorEditable(false);
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
// decisionSeq: после решения активный шаг меняется — права пересчитываем.
|
||||
}, [itemId, approverService, context, data.Employee, decisionSeq]);
|
||||
|
||||
if (loading) {
|
||||
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||
}
|
||||
if (error) {
|
||||
return (
|
||||
<div className={styles.state}>
|
||||
<Alert variant="err">{error}</Alert>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// Реальный (не заглушка) сеттер: единственное поле, которое можно менять в
|
||||
// этом режиме, — «Лицо, принимающее ОС/НМА», и то только пока
|
||||
// assetsAcceptorEditable (остальные поля читают этот же set, но их readOnly
|
||||
// держит ambient FormModeProvider — сеттер для них просто никогда не вызовется).
|
||||
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||
const sectionProps = { data, set, context, assetsAcceptorEditable };
|
||||
|
||||
// Сохраняет «Лицо, принимающее ОС/НМА» ПЕРЕД решением непосредственного
|
||||
// руководителя (см. DecisionPanel.onBeforeDecide) и требует, чтобы поле было
|
||||
// заполнено, — иначе бросает, и панель не применяет решение вовсе (тот же
|
||||
// приём, что и обязательный комментарий при возврате/отклонении).
|
||||
const saveAssetsAcceptor = async (): Promise<void> => {
|
||||
if (!data.AssetsAcceptor) {
|
||||
throw new Error('Укажите лицо, принимающее ОС/НМА, перед решением.');
|
||||
}
|
||||
await updateAssetsAcceptor(itemId, data.AssetsAcceptor, listId);
|
||||
};
|
||||
|
||||
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);
|
||||
};
|
||||
|
||||
// Заявление согласовано целиком → сразу заводим обходной лист по нему (данные
|
||||
// выводятся из заявления, заполнять его руками нечего — см. createClearance.ts).
|
||||
// Свой статус решения при этом уже применён: неудача автосоздания не отменяет
|
||||
// согласование, поэтому она показывается предупреждением, а не ошибкой заявки.
|
||||
const createClearance = (): Promise<void> => {
|
||||
setClearanceError('');
|
||||
setClearance('Создаём обходной лист по этому заявлению…');
|
||||
return ensureClearanceForDismissal(context, itemId, listId)
|
||||
.then((result) => {
|
||||
setClearance(
|
||||
result.existing
|
||||
? 'Обходной лист по этому заявлению уже был создан.'
|
||||
: `Обходной лист создан автоматически${result.code ? ` — №${result.code}` : ''} и отправлен на согласование.`
|
||||
);
|
||||
// Поле-ссылка в секции заполняется из данных заявки, а они прочитаны ДО
|
||||
// создания листа — дописываем адрес в модель, иначе ссылка появилась бы
|
||||
// только после перезагрузки страницы.
|
||||
setData((prev) => ({ ...prev, ClearanceUrl: result.url }));
|
||||
})
|
||||
.catch((e) => {
|
||||
setClearance('');
|
||||
setClearanceError(
|
||||
`Заявление согласовано, но обходной лист создать не удалось: ${friendlyErrorMessage(e)} — заведите его вручную.`
|
||||
);
|
||||
});
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
<div className={`${styles.toolbar} rp-no-print`}>
|
||||
{printGate === 'allowed' ? (
|
||||
<PrintButton />
|
||||
) : (
|
||||
<span className={styles.printBlocked} title="Печать откроется после согласования обходного листа по этому увольнению">
|
||||
Печать станет доступна после согласования обходного листа
|
||||
</span>
|
||||
)}
|
||||
</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>
|
||||
<RequestSection {...sectionProps} />
|
||||
</FormModeProvider>
|
||||
</FormCard>
|
||||
|
||||
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||
</div>
|
||||
|
||||
{/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый).
|
||||
Итог автосоздания обходного листа — тут же, а не в шапке: он появляется
|
||||
именно как следствие решения «Согласовать», логичнее видеть его рядом. */}
|
||||
<div className="rp-no-print">
|
||||
{clearance && <Alert variant="ok">{clearance}</Alert>}
|
||||
{clearanceError && <Alert variant="err">{clearanceError}</Alert>}
|
||||
<DecisionPanel
|
||||
service={approverService}
|
||||
requestId={itemId}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
onBeforeDecide={assetsAcceptorEditable ? saveAssetsAcceptor : undefined}
|
||||
onDecided={(newStatus) => {
|
||||
setStatus(newStatus);
|
||||
setDecisionSeq((n) => n + 1);
|
||||
notify();
|
||||
// «Согласовано» = маршрут заявления пройден целиком (фазы исполнения у
|
||||
// него нет, см. README формы) — значит увольнение подтверждено и пора
|
||||
// заводить обходной лист. Промис ВОЗВРАЩАЕМ: пока он не разрешится,
|
||||
// панель решения не пишет «Решение сохранено» (см. её onDecided) —
|
||||
// иначе успех появлялся бы раньше, чем обходной лист создан.
|
||||
return newStatus === REQUEST_STATUS.approved ? createClearance() : undefined;
|
||||
}}
|
||||
onDelegated={() => {
|
||||
setDecisionSeq((n) => n + 1);
|
||||
notify();
|
||||
}}
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default DismissalView;
|
||||
@@ -0,0 +1,183 @@
|
||||
# Заявление на увольнение (hr-dismissal)
|
||||
|
||||
**Назначение:** заявление работника о расторжении трудового договора по собственному
|
||||
желанию (штатный сотрудник). Бумажный первоисточник — «Шаблон Заявление на увольнение ШТАТ.docx».
|
||||
**Категория:** Отдел кадров
|
||||
**Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
|
||||
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||
`pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
||||
RequestTypeId» в `docs/forms.md`). Тип заведён в админке approval-route (id 16,
|
||||
список данных `/sites/requests/Lists/18`).
|
||||
|
||||
## Маршрут
|
||||
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||
получает статус «Согласовано» (как «Обходной лист» / «Отпуск без содержания»).
|
||||
- **Матрица редактируема заявителем** при новой заявке / черновике / возврате:
|
||||
`useMatrixEditor(editable = !readOnly)`.
|
||||
- Условие `IsManager` в маршруте (если настроено в админке) резолвится по полю
|
||||
**Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
|
||||
планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
|
||||
«Обходном листе».
|
||||
- Настроенный шаблон маршрута (approval-route, route id 17): шаг 1 —
|
||||
`HeadType.Chief` (непосредственный руководитель увольняемого, тот же
|
||||
`Employee/Manager?managerType=chief`, что резолвит «Лицо, принимающее ОС/НМА»,
|
||||
см. ниже), шаг 2 — `HeadType.CompanyDirectors` (см. следующий раздел).
|
||||
|
||||
## Особое поведение
|
||||
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
||||
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
|
||||
reloadKey матрицы включает `data.Employee` и должность основной компании (см. ниже).
|
||||
- **Автоподстановка при выборе сотрудника:** вся таблица организаций — из ОДНОГО
|
||||
справочника `Employee/ByEmail` (`shared/dictionary`) — см. ниже.
|
||||
- **Таблица организаций** (`OrganizationsTable`, `forms/Dismissal/sections/`, без
|
||||
подписи над собой — у неё уже есть заголовки колонок «Компания» / «Структурное
|
||||
подразделение» / «Должность») — ЕДИНСТВЕННОЕ место для компании, подразделения и
|
||||
должности, и на форме подачи (редактируемая), и в режиме просмотра (read-only) —
|
||||
отдельных полей для них нет (были бы дублированием). `data.Organization:
|
||||
IOrganizationRecord[]` — массив `{company, department, position}`; поле называется
|
||||
`department` (тот же справочник `Section`, что и раньше — см. следующий абзац),
|
||||
колонка называется «Структурное подразделение», и то и другое read-only. Должность
|
||||
редактируема В ЛЮБОЙ строке (справочник не всегда точен), но маршрут (условие
|
||||
«IsManager») и обязательность по валидации завязаны ТОЛЬКО на должность ПЕРВОЙ
|
||||
(основной) записи — `primaryPosition(data.Organization)`; должности остальных
|
||||
компаний правятся, но ни на что не влияют. Справочник ничего не вернул (сотрудник
|
||||
не найден в api.tnsu.kz) — таблица всё равно рендерится одной строкой с прочерками
|
||||
вместо компании/подразделения и редактируемой должностью: иначе такому человеку
|
||||
нечем было бы заполнить обязательное поле.
|
||||
|
||||
**Хранение в SharePoint — три ПАРАЛЛЕЛЬНЫХ JSON-столбца**, не один общий блок:
|
||||
`Organization`/`Department`/`Position` — каждый содержит JSON-массив строк
|
||||
(компании / департаменты / должности), один и тот же индекс = одна и та же
|
||||
запись во всех трёх. Сборка при чтении и разборка при записи — `zipOrganization`
|
||||
/ `organizationColumn` в `model.ts`/`submit.ts`; не-JSON значение (заявка,
|
||||
сохранённая до перехода на этот формат) не роняет чтение — трактуется как одна
|
||||
компания (см. `parseOrganizationColumn`).
|
||||
- **Самостоятельное подразделение** (`StandaloneUnit`) — в справочнике его нет,
|
||||
свободный ввод, единственное текстовое поле, оставшееся отдельно от таблицы.
|
||||
- **Последний рабочий день** (`LastWorkingDay`) — обязателен, не раньше чем через
|
||||
`MIN_NOTICE_MONTHS` (1) календарный месяц от сегодня (`isoDatePlusMonths`,
|
||||
`min` у `input type=date` + проверка в `validate` на случай обхода UI) — срок
|
||||
предупреждения об увольнении по ТК. Более позднюю дату (по договорённости с
|
||||
работодателем) форма не ограничивает.
|
||||
- **Контактный телефон** (`Phone`) — обязателен, `PhoneInput` (маска).
|
||||
- **Комментарий** (`Comment`) — необязательный свободный текст. Причины увольнения
|
||||
отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
|
||||
- **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
|
||||
|
||||
## Совместители: организации таблицей, удаление синхронизировано с маршрутом
|
||||
Сотрудник может числиться сразу в НЕСКОЛЬКИХ компаниях (совместительство).
|
||||
Approval-route резолвит маршрут через `HeadType.CompanyDirectors` — ОДИН шаг
|
||||
разворачивается в по одному согласующему НА КАЖДУЮ компанию сотрудника (директор,
|
||||
а где нет такой штатной единицы — должностной эквивалент: `Главный механик` для
|
||||
«ТОО KazPromService», `Генеральный директор» для «ТОО СТ Global», иначе
|
||||
`Директор`, см. `DirectorPositionByCompany` в approval-route
|
||||
`TemplateRouteService`). Это уже работает БЕЗ участия портала — сам approval-route
|
||||
резолвит все компании сотрудника через `Employee/ByEmail`.
|
||||
|
||||
`OrganizationsTable` (см. предыдущий раздел) на форме подачи показывает кнопку
|
||||
«убрать» у каждой строки, когда компаний больше одной. Если сотрудник реально не
|
||||
увольняется из ВСЕХ компаний сразу, HR убирает лишние: `DismissalForm.handleRemoveOrganization`
|
||||
|
||||
1. снимает запись из `data.Organization` (массив всегда отражает ТЕКУЩИЙ, не
|
||||
первоначальный, набор — так же восстанавливается при повторном открытии
|
||||
черновика/возврата: `loadDismissalRequest` читает его из уже сохранённых
|
||||
`Organization`/`Department`/`Position`, без обращения к справочнику заново);
|
||||
2. независимо резолвит директора/эквивалента этой компании через
|
||||
`getCompanyDirectorEmail` (`shared/dictionary/employeeLookup.service.ts` —
|
||||
зеркало того же `DirectorPositionByCompany`, что и на бэкенде) и удаляет
|
||||
строку с этим email из уже загруженной ПЛАНИРУЕМОЙ матрицы (`matrix.remove`).
|
||||
|
||||
Убирать согласующего из матрицы вручную (кнопкой самой матрицы) при этом не нужно
|
||||
— это best-effort синхронизация: если матрица ещё не загрузилась или директор не
|
||||
нашёлся, компания всё равно снимается из заявления, а несовпадение в матрице HR
|
||||
поправит вручную через саму матрицу (она и так редактируема).
|
||||
|
||||
## Согласовано → обходной лист создаётся сам
|
||||
Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
|
||||
портал заводит по нему **обходной лист** — `ensureClearanceForDismissal`
|
||||
(`createClearance.ts`), вызывается из `DismissalView` в `onDecided` последнего
|
||||
согласующего.
|
||||
|
||||
Форма обходного листа при этом **не открывается**: маршрут резолвится через
|
||||
approval-route (`getPlannedMatrix` для фаз «Согласование» и «Исполнение» — по
|
||||
`Employee` и `Position` заявления), элемент пишется в текущую партицию списка
|
||||
«Обходной лист … — данные» и сразу уходит на согласование
|
||||
(`initialSubmitStatus` + `notifyActiveStep`, как при обычной подаче). Поля целиком
|
||||
выводятся из заявления: сотрудник, должность, подразделение, организация, а
|
||||
последний рабочий день становится **датой расторжения договора**; отметки
|
||||
(парковка, СКУД, обучение) остаются пустыми — их заполняют профильные согласующие.
|
||||
|
||||
Пара связывается **перекрёстными колонками-гиперссылками** (тип `Url`):
|
||||
`ClearanceUrl` в заявлении → на обходной лист, `DismissalUrl` в обходном листе → на
|
||||
заявление. Не Lookup намеренно: ссылка ведёт на страницу портала
|
||||
(`…?rpmode=approve&rptype=…&rpid=…&rplist=…`, см. `docs/routing.md`), а не на элемент
|
||||
списка, и не ломается, когда парная заявка уезжает в другую партицию.
|
||||
|
||||
Ссылки **видны на обеих формах** и кликабельны: поле «Обходной лист» в заявлении и
|
||||
«Заявление на увольнение» в обходном листе (`LinkField`, `shared/ui`) — read-only,
|
||||
открывают парную заявку в ТОЙ ЖЕ вкладке и появляются только когда связь есть.
|
||||
Переход идёт без перезагрузки страницы: ссылка ведёт на ту же страницу портала с
|
||||
другими rp-параметрами, поэтому клик перехватывается и уходит в `navigate()`
|
||||
(`navigateToRequestLink` в `shared/routing.ts`) — а Ctrl/⌘+клик по-прежнему открывает
|
||||
заявку в отдельной вкладке, потому что href настоящий. У согласующего, только что
|
||||
одобрившего заявление, ссылка появляется сразу, без перезагрузки.
|
||||
|
||||
Что важно знать про это поведение:
|
||||
- **Идемпотентность — по непустой `ClearanceUrl`.** Заявление можно согласовать
|
||||
повторно (возврат на доработку → отправка → согласование), и без этой проверки
|
||||
на каждый цикл появлялся бы новый обходной лист.
|
||||
- **Работает в браузере последнего согласующего.** Если создание упало (или он
|
||||
закрыл вкладку в этот момент), заявление всё равно согласовано, а обходного листа
|
||||
нет — портал покажет предупреждение «заведите вручную». Серверного повтора нет:
|
||||
фонового обработчика у портала пока не существует, всё делает клиент.
|
||||
- **Автором обходного листа** в SharePoint станет этот согласующий (в «Мои заявки»
|
||||
лист попадёт к нему). На маршрут это не влияет — он резолвится по `Employee`.
|
||||
- Тип заявки `clearance-form` должен быть заведён в админке approval-route — иначе
|
||||
создание падает на резолве `RequestTypeId`.
|
||||
|
||||
## Печать заблокирована до согласования обходного листа
|
||||
`DismissalView` не показывает `PrintButton`, пока парный обходной лист не дошёл
|
||||
хотя бы до статуса «Согласовано» (или дальше — «Выполнение»/«Закрыта», если у
|
||||
него есть исполнители): печатать заявление раньше значит выдать документ до того,
|
||||
как процесс увольнения (карты, суммы к списанию) подтверждён целиком. Статус
|
||||
читается НАПРЯМУЮ по `ClearanceUrl` (`parseRoute` вытаскивает `itemId`/`listId`
|
||||
из самой ссылки, `loadClearanceRequest` — статус) — отдельного поля-дублёра нет.
|
||||
Пока `ClearanceUrl` пуст (обходной лист ещё не создан/не удалось создать) —
|
||||
печать тоже заблокирована, печатать нечего.
|
||||
|
||||
## «Лицо, принимающее ОС/НМА»
|
||||
Колонка `AssetsAcceptor` (People) — кто принимает основные средства/НМА
|
||||
увольняемого. Обязательна, но заполняет её **не заявитель**, а **непосредственный
|
||||
руководитель** увольняемого — тот, кого approval-route резолвит для
|
||||
`HeadType.Chief` (`Employee/Manager?managerType=chief`, см. «Маршрут» выше).
|
||||
|
||||
- В форме подачи поле показывается read-only (обычно пустое) — просто
|
||||
информирует, что это будет заполнено позже.
|
||||
- В `DismissalView` поле редактируемо ТОЛЬКО когда одновременно: (а) у текущего
|
||||
пользователя сейчас активный шаг решения (`getPendingRowForCurrentUser`), и (б)
|
||||
его e-mail совпадает с результатом `getManagerEmail(..., 'chief')` для
|
||||
`data.Employee` — проверка по ИДЕНТИЧНОСТИ, а не по должности (в отличие от
|
||||
`approverRights.ts` «Обходного листа»: здесь должность руководителя может быть
|
||||
любой).
|
||||
- Обязательность применяется НЕ на уровне списка (иначе создание заявки падало
|
||||
бы — поле нечем заполнить до решения руководителя), а через
|
||||
`DecisionPanel.onBeforeDecide`: пустое поле бросает ошибку ДО применения
|
||||
решения (approve/return/reject — API не различает, какое именно) и сохраняет
|
||||
значение сразу перед ним, тем же приёмом, что «Обходной лист» использует для
|
||||
своих отметок.
|
||||
|
||||
## Отличия от «Обходной лист» (clearance-form)
|
||||
Обходной лист оформляет HR **после** решения об увольнении (обход подразделений,
|
||||
карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
|
||||
полей всего восемь, отметок подразделений нет.
|
||||
|
||||
## Секции формы
|
||||
RequestSection (сотрудник · организация/департамент/должность (таблица —
|
||||
редактируемая на форме подачи, read-only в просмотре) · самостоятельное
|
||||
подразделение · последний рабочий день · телефон · комментарий · ссылка на
|
||||
обходной лист · лицо, принимающее ОС/НМА)
|
||||
|
||||
## Точки входа
|
||||
- rptype: `hr-dismissal`
|
||||
- Режим согласующего (просмотр): есть (`DismissalView`)
|
||||
- «Создать на основе»: нет
|
||||
@@ -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,176 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import {
|
||||
IApproverToWrite,
|
||||
IMatrixRow,
|
||||
getPlannedMatrix,
|
||||
getRequestTypeIdByPageUrl,
|
||||
initialSubmitStatus,
|
||||
notifyActiveStep,
|
||||
resolveWriteListId
|
||||
} from '../../shared/approval';
|
||||
import { resolveDataList } from '../../shared/dataList';
|
||||
import {
|
||||
approvalListTitle,
|
||||
approvalListTitleForListId,
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { requestLinkUrl } from '../../shared/routing';
|
||||
import { FORM_ID as CLEARANCE_FORM_ID, EMPTY_DATA as CLEARANCE_EMPTY, IFormData as IClearanceData } from '../Clearance/model';
|
||||
import { clearanceApprovalService, saveClearanceRequest } from '../Clearance/submit';
|
||||
import { FORM_ID, primaryPosition, zipOrganization } from './model';
|
||||
|
||||
/** Результат автосоздания обходного листа по согласованному заявлению. */
|
||||
export interface IClearanceForDismissal {
|
||||
/** Id обходного листа. undefined — лист уже был создан раньше (ссылка есть, Id из неё не выводим). */
|
||||
id?: number;
|
||||
/** Уникальный код заявки, если обходной лист создан именно сейчас. */
|
||||
code?: string;
|
||||
/** Ссылка на обходной лист (та же, что записана в колонку ClearanceUrl). */
|
||||
url: string;
|
||||
/** true — ничего не создавали, обходной лист по этому заявлению уже был. */
|
||||
existing: boolean;
|
||||
}
|
||||
|
||||
/** Гиперссылка в SharePoint — объект {Url, Description}, а не строка. */
|
||||
interface ISpUrlValue {
|
||||
Url?: string;
|
||||
Description?: string;
|
||||
}
|
||||
|
||||
/** Матрица планируемого маршрута → строки для записи в список согласования. */
|
||||
function toApprovers(rows: IMatrixRow[]): IApproverToWrite[] {
|
||||
return rows.map((r) => ({
|
||||
email: r.email,
|
||||
position: r.position,
|
||||
allowReassign: r.allowReassign,
|
||||
order: r.order,
|
||||
slaHours: r.slaHours,
|
||||
askOverdueReason: r.askOverdueReason
|
||||
}));
|
||||
}
|
||||
|
||||
/**
|
||||
* Создать обходной лист по СОГЛАСОВАННОМУ заявлению на увольнение и связать их
|
||||
* перекрёстными ссылками (ClearanceUrl / DismissalUrl).
|
||||
*
|
||||
* Зачем: увольнение — это всегда пара «заявление + обходной лист», и раньше HR
|
||||
* заводил второй руками, переписывая те же сотрудника, должность, подразделение и
|
||||
* дату. Данные для обходного листа целиком выводятся из заявления, поэтому после
|
||||
* его согласования заводить лист вручную незачем.
|
||||
*
|
||||
* **Идемпотентность** — по колонке ClearanceUrl самого заявления: она заполняется
|
||||
* последним шагом, и непустая означает «лист уже есть». Это важнее, чем кажется:
|
||||
* заявление может быть согласовано повторно (вернули на доработку → отправили
|
||||
* снова → снова одобрили), и без этой проверки на каждый цикл появлялся бы новый
|
||||
* обходной лист. Проверка не абсолютна (два одновременных решения по одной заявке
|
||||
* прошли бы оба), но параллельных решений по одному последнему шагу не бывает:
|
||||
* шаг назначен на одного человека.
|
||||
*
|
||||
* **Кто автор.** Вызов идёт из браузера последнего согласующего, поэтому в
|
||||
* SharePoint автором обходного листа окажется он, а не увольняемый или HR. На
|
||||
* маршрут это не влияет (он резолвится по полю Employee, см. ниже), но в «Мои
|
||||
* заявки» этого согласующего лист попадёт.
|
||||
*
|
||||
* Ошибки НЕ глушим: вызывающая сторона (DismissalView) показывает их отдельным
|
||||
* предупреждением — согласование при этом уже применено, и молчаливая потеря
|
||||
* обходного листа хуже, чем сообщение «создайте вручную».
|
||||
*/
|
||||
export async function ensureClearanceForDismissal(
|
||||
context: WebPartContext,
|
||||
dismissalId: number,
|
||||
dismissalListId?: string
|
||||
): Promise<IClearanceForDismissal> {
|
||||
const dismissalList = resolveDataList(FORM_ID, dismissalListId);
|
||||
const item = (await dismissalList.items
|
||||
.getById(dismissalId)
|
||||
.select(
|
||||
'Id',
|
||||
'Position',
|
||||
'Department',
|
||||
'LastWorkingDay',
|
||||
'Organization',
|
||||
'ClearanceUrl',
|
||||
'Employee/EMail'
|
||||
)
|
||||
.expand('Employee')()) as Record<string, unknown>;
|
||||
|
||||
const existingLink = (item.ClearanceUrl as ISpUrlValue | undefined)?.Url;
|
||||
if (existingLink) {
|
||||
return { url: existingLink, existing: true };
|
||||
}
|
||||
|
||||
const employeeEmail = (item.Employee as { EMail?: string } | undefined)?.EMail || '';
|
||||
if (!employeeEmail) {
|
||||
throw new Error('В заявлении не заполнен сотрудник — обходной лист не создан.');
|
||||
}
|
||||
// Три параллельных JSON-столбца (см. IOrganizationRecord) → таблица компаний;
|
||||
// обходному листу нужна только ОСНОВНАЯ (первая) — должность для условия
|
||||
// «IsManager» и подразделение для карточки, плюс joined-текст для его
|
||||
// собственного read-only поля Organization (другой формат, см. Clearance/model.ts).
|
||||
const organization = zipOrganization(item.Organization, item.Department, item.Position);
|
||||
const position = primaryPosition(organization);
|
||||
const department = organization[0]?.department || '';
|
||||
const organizationText = organization
|
||||
.map((r) => (r.position ? `${r.company} — ${r.position}` : r.company))
|
||||
.join('\n');
|
||||
|
||||
// Тип заявки и партиция для записи — как у обычной подачи обходного листа
|
||||
// (см. ClearanceForm.save): партицию спрашиваем прямо сейчас, именно этот вызов
|
||||
// проверяет порог элементов и запускает архивацию.
|
||||
const requestTypeId = await getRequestTypeIdByPageUrl(context, CLEARANCE_FORM_ID);
|
||||
const writeListId = await resolveWriteListId(context, CLEARANCE_FORM_ID, requestTypeId, undefined, undefined);
|
||||
const approval = clearanceApprovalService(writeListId);
|
||||
|
||||
// Маршрут обходного листа резолвится по УВОЛЬНЯЕМОМУ (Employee заявления) и его
|
||||
// должности — условие «IsManager» на бэкенде считается по ней (см. README формы
|
||||
// «Обходной лист»). Обе фазы: согласование и исполнение.
|
||||
const fieldValues = [{ fieldName: 'Position', value: position }];
|
||||
const approvers = await getPlannedMatrix(context, requestTypeId, employeeEmail, approval, 'Approval', null, fieldValues);
|
||||
const executors = await getPlannedMatrix(context, requestTypeId, employeeEmail, approval, 'Execution', null, fieldValues);
|
||||
|
||||
const data: IClearanceData = {
|
||||
...CLEARANCE_EMPTY,
|
||||
Employee: employeeEmail,
|
||||
Position: position,
|
||||
Department: department,
|
||||
// Последний рабочий день заявления = дата расторжения договора в обходном листе.
|
||||
TerminationDate: ((item.LastWorkingDay as string) || '').slice(0, 10),
|
||||
Organization: organizationText
|
||||
};
|
||||
|
||||
// Статус — как при обычной отправке: с согласующими «На согласовании», без них
|
||||
// маршрут сразу уходит в исполнение/согласовано (см. initialSubmitStatus).
|
||||
const status = initialSubmitStatus(approvers.length, executors.length);
|
||||
const { id, code } = await saveClearanceRequest(
|
||||
undefined,
|
||||
requestTypeId,
|
||||
data,
|
||||
toApprovers(approvers),
|
||||
toApprovers(executors),
|
||||
status,
|
||||
writeListId
|
||||
);
|
||||
|
||||
// Перекрёстные ссылки: в заявлении — на лист, в листе — на заявление.
|
||||
const clearanceUrl = requestLinkUrl(CLEARANCE_FORM_ID, id, writeListId);
|
||||
const dismissalUrl = requestLinkUrl(FORM_ID, dismissalId, dismissalListId);
|
||||
await dismissalList.items.getById(dismissalId).update({
|
||||
ClearanceUrl: { Url: clearanceUrl, Description: `Обходной лист${code ? ` №${code}` : ''}` }
|
||||
});
|
||||
await resolveDataList(CLEARANCE_FORM_ID, writeListId)
|
||||
.items.getById(id)
|
||||
.update({ DismissalUrl: { Url: dismissalUrl, Description: 'Заявление на увольнение' } });
|
||||
|
||||
// Оповещение активного шага — как после обычной отправки. Некритично: сам
|
||||
// notifyActiveStep ошибки глотает, заявка уже создана и связана.
|
||||
await notifyActiveStep(context, approval, id, {
|
||||
requestTypeId,
|
||||
dataListName: writeListId ? dataListTitleForListId(CLEARANCE_FORM_ID, writeListId) : dataListTitle(CLEARANCE_FORM_ID),
|
||||
approvalListName: writeListId
|
||||
? approvalListTitleForListId(CLEARANCE_FORM_ID, writeListId)
|
||||
: approvalListTitle(CLEARANCE_FORM_ID)
|
||||
});
|
||||
|
||||
return { id, code, url: clearanceUrl, existing: false };
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
import { getSP } from '../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, zipOrganization } from './model';
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
/** Ф.И.О. сотрудника из поля Employee (для заголовка режима чтения). */
|
||||
employeeName: string;
|
||||
status: string;
|
||||
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||
code: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Прочитать заявление на увольнение по id: модель формы + статус (правка / просмотр).
|
||||
*
|
||||
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
|
||||
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
|
||||
* по url списка, а не по имени: так не нужно резолвить, как называется архивный
|
||||
* список, и запрос не зависит от реестра партиций.
|
||||
*/
|
||||
export async function loadDismissalRequest(itemId: number, listId?: string): Promise<ILoadedRequest> {
|
||||
const list = listId ? getSP().web.getList(listId) : getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
|
||||
const item = (await list
|
||||
.items.getById(itemId)
|
||||
.select(
|
||||
'Id',
|
||||
'Position',
|
||||
'Department',
|
||||
'StandaloneUnit',
|
||||
'LastWorkingDay',
|
||||
'Phone',
|
||||
'Comment',
|
||||
'Organization',
|
||||
'ClearanceUrl',
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
'Employee/Title',
|
||||
'Employee/EMail',
|
||||
'AssetsAcceptor/EMail'
|
||||
)
|
||||
.expand('Employee', 'AssetsAcceptor')()) as Record<string, unknown>;
|
||||
|
||||
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
|
||||
const assetsAcceptor = item.AssetsAcceptor as { EMail?: string } | undefined;
|
||||
const lastDay = (item.LastWorkingDay as string) || '';
|
||||
|
||||
const data: IFormData = {
|
||||
...EMPTY_DATA,
|
||||
Employee: employee?.EMail || '',
|
||||
StandaloneUnit: (item.StandaloneUnit as string) || '',
|
||||
LastWorkingDay: lastDay.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||
Phone: (item.Phone as string) || '',
|
||||
Comment: (item.Comment as string) || '',
|
||||
Organization: zipOrganization(item.Organization, item.Department, item.Position),
|
||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || '',
|
||||
AssetsAcceptor: assetsAcceptor?.EMail || ''
|
||||
};
|
||||
|
||||
return {
|
||||
data,
|
||||
employeeName: employee?.Title || '',
|
||||
status: (item.RequestStatus as string) || '',
|
||||
code: (item.RequestUniqueCode as string) || ''
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,154 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { RequestTypeId } from '../../models/types';
|
||||
|
||||
/**
|
||||
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||
*/
|
||||
export const FORM_ID: RequestTypeId = 'hr-dismissal';
|
||||
|
||||
/**
|
||||
* Одна строка таблицы организаций (см. forms/Dismissal/sections/
|
||||
* OrganizationsTable.tsx) — компания + департамент + должность СОТРУДНИКА В
|
||||
* ЭТОЙ компании.
|
||||
*
|
||||
* В списке SharePoint компания/департамент/должность хранятся КАЖДАЯ В СВОЁМ
|
||||
* столбце (`Organization`/`Department`/`Position` — три Note-колонки), но КАК
|
||||
* JSON-МАССИВ строк в каждой, а не как раньше — плоским значением/joined-строкой:
|
||||
* `Organization: '["ТОО A","ТОО B"]'`, `Department: '["Служба X","Служба Y"]'`,
|
||||
* `Position: '["Начальник","Инженер"]'` — три ПАРАЛЛЕЛЬНЫХ массива одной длины,
|
||||
* один индекс = одна компания. IFormData/приложение работают с ними уже
|
||||
* СОБРАННЫМИ в этот единый тип — сборка (load.ts, zipOrganization) и разборка
|
||||
* по трём столбцам (submit.ts, splitOrganization) — на границе с SharePoint,
|
||||
* остальной код таблицу как массив строк никогда не видит.
|
||||
*
|
||||
* Именно эта структура и позволяет показать таблицу целиком в режиме просмотра
|
||||
* заявки (DismissalView) — раньше Position/Department хранили только ПЕРВУЮ
|
||||
* компанию, а Organization — плоский текст без департамента.
|
||||
*/
|
||||
export interface IOrganizationRecord {
|
||||
company: string;
|
||||
department: string;
|
||||
position: string;
|
||||
}
|
||||
|
||||
/** Должность ОСНОВНОЙ (первой) компании — читает маршрут согласования (условие «IsManager»), требуется валидацией. '' — компания не выбрана/справочник пуст. */
|
||||
export function primaryPosition(organization: IOrganizationRecord[]): string {
|
||||
return organization[0]?.position || '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Разобрать один из трёх параллельных столбцов (Organization/Department/
|
||||
* Position, см. IOrganizationRecord) — JSON-массив строк. Не валидный JSON —
|
||||
* заявка сохранена ДО перехода на этот формат (столбец был скалярным Text/
|
||||
* joined-строкой): не роняем чтение, трактуем как ОДНУ компанию — единственное,
|
||||
* что старый формат вообще мог хранить (split(' — ')[0] на однострочном
|
||||
* скаляре — no-op, поэтому одна функция годится и для Position/Department, и
|
||||
* для легаси Organization вида «Компания — Должность» построчно).
|
||||
*/
|
||||
export function parseOrganizationColumn(raw: unknown): string[] {
|
||||
if (typeof raw !== 'string' || raw.trim() === '') return [];
|
||||
try {
|
||||
const parsed = JSON.parse(raw);
|
||||
return Array.isArray(parsed) ? parsed.map(String) : [String(parsed)];
|
||||
} catch {
|
||||
return raw.split('\n').map((line) => line.split(' — ')[0]);
|
||||
}
|
||||
}
|
||||
|
||||
/** Собрать таблицу организаций из трёх столбцов — см. IOrganizationRecord. */
|
||||
export function zipOrganization(
|
||||
companiesRaw: unknown,
|
||||
departmentsRaw: unknown,
|
||||
positionsRaw: unknown
|
||||
): IOrganizationRecord[] {
|
||||
const companies = parseOrganizationColumn(companiesRaw);
|
||||
const departments = parseOrganizationColumn(departmentsRaw);
|
||||
const positions = parseOrganizationColumn(positionsRaw);
|
||||
return companies.map((company, i) => ({
|
||||
company,
|
||||
department: departments[i] || '',
|
||||
position: positions[i] || ''
|
||||
}));
|
||||
}
|
||||
|
||||
/**
|
||||
* Данные формы «Заявление на увольнение» (штатный сотрудник) по бумажному шаблону
|
||||
* «Шаблон Заявление на увольнение ШТАТ.docx»: расторжение трудового договора по
|
||||
* собственному желанию. Ключи по возможности = internalName колонок списка данных
|
||||
* (см. shared/listTitles.ts). Employee хранит e-mail сотрудника (то, что отдаёт
|
||||
* PeopleField); по нему резолвится маршрут согласования, поэтому заявку можно
|
||||
* подать и за другого сотрудника (например, кадровик за работника без доступа).
|
||||
*
|
||||
* Причина увольнения в шаблоне фиксированная («по собственному желанию») — своего
|
||||
* поля под неё нет, поэтому в модели её тоже нет; свободный текст — в Comment.
|
||||
*/
|
||||
export interface IFormData {
|
||||
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
||||
Employee: string;
|
||||
/** Самостоятельное подразделение — в справочнике его нет, вводится вручную. */
|
||||
StandaloneUnit: string;
|
||||
/** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
|
||||
LastWorkingDay: string;
|
||||
/** Контактный телефон (маска, см. PhoneInput). */
|
||||
Phone: string;
|
||||
/** Необязательный комментарий заявителя. */
|
||||
Comment: string;
|
||||
/**
|
||||
* Таблица компаний сотрудника (компания · департамент · должность на
|
||||
* каждую) — подтягивается автоматически из Employee/ByEmail при выборе
|
||||
* Employee. Первая запись — основная компания: её должность используется
|
||||
* маршрутом (см. primaryPosition) и остаётся редактируемой (см.
|
||||
* OrganizationsTable); должности/департаменты остальных — только для
|
||||
* просмотра. О ХРАНЕНИИ В СПИСКЕ (три параллельных JSON-массива по
|
||||
* столбцам) — см. IOrganizationRecord.
|
||||
*/
|
||||
Organization: IOrganizationRecord[];
|
||||
/**
|
||||
* Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
|
||||
* `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
|
||||
* createClearance.ts) и не даёт править — только показывает переходом.
|
||||
*/
|
||||
ClearanceUrl: string;
|
||||
/**
|
||||
* Лицо, принимающее основные средства/нематериальные активы увольняемого —
|
||||
* People, колонка `AssetsAcceptor`. Заполняет НЕ заявитель, а непосредственный
|
||||
* руководитель увольняемого на своём шаге согласования (см. DismissalView) —
|
||||
* поэтому здесь нет отдельного плейсхолдера/секции формы подачи: поле в
|
||||
* IFormData только чтобы форма подачи не роняла это значение при пересохранении
|
||||
* (черновик/возврат), сама секция его не показывает и не редактирует.
|
||||
*/
|
||||
AssetsAcceptor: string;
|
||||
}
|
||||
|
||||
/** Обновление одного поля формы с сохранением типа значения. */
|
||||
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||
|
||||
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker). */
|
||||
export interface ISectionProps {
|
||||
data: IFormData;
|
||||
set: SetField;
|
||||
context: WebPartContext;
|
||||
/**
|
||||
* Выбор сотрудника подтягивает его должность, подразделение и организации —
|
||||
* поэтому у поля «Сотрудник» отдельный обработчик. Если не передан (режим
|
||||
* чтения) — правка через set.
|
||||
*/
|
||||
onEmployeeChange?: (login: string) => void;
|
||||
}
|
||||
|
||||
export const EMPTY_DATA: IFormData = {
|
||||
Employee: '',
|
||||
StandaloneUnit: '',
|
||||
LastWorkingDay: '',
|
||||
Phone: '',
|
||||
Comment: '',
|
||||
Organization: [],
|
||||
ClearanceUrl: '',
|
||||
AssetsAcceptor: ''
|
||||
};
|
||||
|
||||
/** Плейсхолдер для поля выбора сотрудника. */
|
||||
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
||||
/** Заявление нужно подавать не позднее чем за столько месяцев до последнего рабочего дня. */
|
||||
export const MIN_NOTICE_MONTHS = 1;
|
||||
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"dataListTitle": "Заявление на увольнение — данные",
|
||||
"columns": [
|
||||
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||
|
||||
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
||||
{ "internalName": "Position", "title": "Должность", "type": "Text" },
|
||||
{ "internalName": "Department", "title": "Департамент", "type": "Text" },
|
||||
{ "internalName": "StandaloneUnit", "title": "Самостоятельное подразделение", "type": "Text" },
|
||||
{ "internalName": "LastWorkingDay", "title": "Последний рабочий день", "type": "DateTime", "dateOnly": true },
|
||||
{ "internalName": "Phone", "title": "Контактный телефон", "type": "Text" },
|
||||
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||
|
||||
{ "internalName": "ClearanceUrl", "title": "Ссылка на обходной лист", "type": "Url" },
|
||||
|
||||
{ "internalName": "AssetsAcceptor", "title": "Лицо, принимающее ОС/НМА", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
@import '../../../../../styles/design-tokens';
|
||||
|
||||
// Занять обе колонки сетки формы — то же, что даёт проп full у FormField
|
||||
// (._full_1wk7n_8{grid-column:1/-1} в @tnsu/ui-kit), без самого FormField:
|
||||
// подпись над таблицей не нужна, у неё уже есть заголовки колонок.
|
||||
.wrapper {
|
||||
grid-column: 1 / -1;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
font-family: $font-sans;
|
||||
font-size: 13.5px;
|
||||
}
|
||||
|
||||
thead th {
|
||||
box-sizing: border-box;
|
||||
padding: 6px 13px;
|
||||
text-align: left;
|
||||
font-weight: 500;
|
||||
font-size: 12px;
|
||||
color: $gray-500;
|
||||
}
|
||||
|
||||
.company,
|
||||
.department,
|
||||
.position {
|
||||
box-sizing: border-box;
|
||||
padding: 11px 13px;
|
||||
border: 1px solid $gray-200;
|
||||
border-right: 0;
|
||||
background: $gray-50;
|
||||
color: $gray-700;
|
||||
}
|
||||
|
||||
.company {
|
||||
width: 35%;
|
||||
}
|
||||
|
||||
.department {
|
||||
width: 30%;
|
||||
}
|
||||
|
||||
// Ячейка должности ПЕРВОЙ строки хранит TextInput (у него свой паддинг/рамка) —
|
||||
// у самой ячейки паддинг убран, иначе поле ввода дублировало бы рамку карточки.
|
||||
.positionInput {
|
||||
box-sizing: border-box;
|
||||
border: 1px solid $gray-200;
|
||||
border-right: 0;
|
||||
padding: 0;
|
||||
|
||||
input {
|
||||
width: 100%;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
}
|
||||
|
||||
.action {
|
||||
width: 1%;
|
||||
white-space: nowrap;
|
||||
border: 1px solid $gray-200;
|
||||
border-left: 0;
|
||||
background: $gray-50;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.remove {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 4px;
|
||||
border: 0;
|
||||
border-radius: $r-sm;
|
||||
background: transparent;
|
||||
color: $gray-500;
|
||||
cursor: pointer;
|
||||
transition: color .18s, background .18s;
|
||||
|
||||
&:hover {
|
||||
color: $red-500;
|
||||
background: $red-50;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,101 @@
|
||||
import * as React from 'react';
|
||||
import { Icon, TextInput } from '../../../shared/ui';
|
||||
import { IOrganizationRecord } from '../model';
|
||||
import styles from './OrganizationsTable.module.scss';
|
||||
|
||||
interface IOrganizationsTableProps {
|
||||
records: IOrganizationRecord[];
|
||||
/**
|
||||
* Должность любой строки можно поправить — справочник не всегда точен, а
|
||||
* условие маршрута «IsManager» резолвится по должности ПЕРВОЙ (основной)
|
||||
* компании (см. DismissalForm — primaryPosition/fieldValues.Position), так
|
||||
* что расхождение со справочником там, где оно есть, важно уметь исправить.
|
||||
* Не задано — вся таблица read-only (режим просмотра, DismissalView).
|
||||
*/
|
||||
onChangePosition?: (index: number, value: string) => void;
|
||||
/**
|
||||
* Убрать компанию из заявления — есть только на форме подачи (см.
|
||||
* DismissalForm.handleRemoveOrganization), не в режиме просмотра: там состав
|
||||
* компаний уже зафиксирован в отправленной заявке и маршруте.
|
||||
*/
|
||||
onRemove?: (company: string) => void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Организации сотрудника — ЕДИНСТВЕННОЕ место для компании/подразделения/
|
||||
* должности, и на форме подачи (редактируемая — см. onChangePosition/onRemove),
|
||||
* и в режиме просмотра заявки (read-only, те же данные из сохранённой заявки,
|
||||
* а не live-запрос к справочнику — см. DismissalView). Раньше это были
|
||||
* отдельные поля над таблицей — убраны как дублирование того, что таблица и
|
||||
* так показывает.
|
||||
*
|
||||
* Интерактивная таблица, а не список строк: у сотрудника, оформленного в
|
||||
* НЕСКОЛЬКИХ компаниях одновременно, увольнение затрагивает директора/
|
||||
* должностного эквивалента КАЖДОЙ из них (маршрут `HeadType.CompanyDirectors`
|
||||
* в approval-route резолвит их всех). Если реально уходит только из одной —
|
||||
* заявитель убирает лишние компании ЗДЕСЬ, и соответствующий согласующий
|
||||
* убирается из матрицы автоматически (см. DismissalForm.handleRemoveOrganization)
|
||||
* — не нужно отдельно искать его в матрице и удалять там вручную.
|
||||
*
|
||||
* Пустой records в РЕДАКТИРУЕМОМ режиме (справочник api.tnsu.kz не нашёл
|
||||
* сотрудника) — не «ничего не показываем», а ОДНА строка с прочерками и
|
||||
* редактируемой должностью: без этого заявление на человека без карточки в
|
||||
* справочнике нельзя было бы подать вовсе (некуда вписать должность вручную —
|
||||
* а маршрут согласования без неё не резолвит условие «IsManager»).
|
||||
*
|
||||
* Без обёртки FormField/подписи над таблицей намеренно — у нёе уже есть
|
||||
* заголовки колонок, дублировать их общей подписью незачем; full-ширина взята
|
||||
* напрямую (см. .wrapper), а не через FormField (там label обязателен).
|
||||
*/
|
||||
export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({ records, onChangePosition, onRemove }) => {
|
||||
const rows = records.length > 0 ? records : [undefined];
|
||||
|
||||
return (
|
||||
<div className={styles.wrapper}>
|
||||
<table className={styles.table}>
|
||||
<thead>
|
||||
<tr>
|
||||
<th className={styles.company}>Компания</th>
|
||||
<th className={styles.department}>Структурное подразделение</th>
|
||||
<th className={styles.position}>Должность</th>
|
||||
{onRemove && <th className={styles.action} />}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((r, i) => (
|
||||
<tr key={r?.company || 'manual'}>
|
||||
<td className={styles.company}>{r?.company || '—'}</td>
|
||||
<td className={styles.department}>{r?.department || '—'}</td>
|
||||
{onChangePosition ? (
|
||||
<td className={styles.positionInput}>
|
||||
<TextInput
|
||||
value={r?.position || ''}
|
||||
onChange={(v) => onChangePosition(i, v)}
|
||||
placeholder="Введите должность"
|
||||
/>
|
||||
</td>
|
||||
) : (
|
||||
<td className={styles.position}>{r?.position || '—'}</td>
|
||||
)}
|
||||
{onRemove && (
|
||||
<td className={styles.action}>
|
||||
{r && records.length > 1 && (
|
||||
<button
|
||||
type="button"
|
||||
className={styles.remove}
|
||||
onClick={() => onRemove(r.company)}
|
||||
aria-label={`Убрать «${r.company}» из заявления`}
|
||||
title="Сотрудник не увольняется из этой компании — убрать из заявления"
|
||||
>
|
||||
<Icon name="close" size="sm" />
|
||||
</button>
|
||||
)}
|
||||
</td>
|
||||
)}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,98 @@
|
||||
import * as React from 'react';
|
||||
import { CollapseSection, FormField, TextInput, TextArea, PhoneInput, PeopleField, LinkField } from '../../../shared/ui';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER, MIN_NOTICE_MONTHS } from '../model';
|
||||
import { isoDatePlusMonths } from '../../../shared/dateUtils';
|
||||
import { OrganizationsTable } from './OrganizationsTable';
|
||||
|
||||
interface IRequestSectionProps extends ISectionProps {
|
||||
/**
|
||||
* Убрать компанию — есть только на форме подачи (DismissalForm), делает
|
||||
* OrganizationsTable редактируемой (кнопка «убрать» + должность первой
|
||||
* компании). Не задано — DismissalView, таблица read-only.
|
||||
*/
|
||||
onRemoveOrganization?: (company: string) => void;
|
||||
/** Поле «Лицо, принимающее ОС/НМА» редактируемо — см. DismissalView. */
|
||||
assetsAcceptorEditable?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Единственная секция формы «Заявление на увольнение»: кто увольняется, где
|
||||
* работает, последний рабочий день и контакты. Набор полей — с бумажного шаблона
|
||||
* «Заявление на увольнение ШТАТ».
|
||||
*/
|
||||
export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
data,
|
||||
set,
|
||||
context,
|
||||
onEmployeeChange,
|
||||
onRemoveOrganization,
|
||||
assetsAcceptorEditable
|
||||
}) => (
|
||||
<CollapseSection title="Заявление на увольнение" icon="document">
|
||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||
<PeopleField
|
||||
context={context}
|
||||
value={data.Employee}
|
||||
onChange={onEmployeeChange ?? ((v) => set('Employee', v))}
|
||||
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||
/>
|
||||
</FormField>
|
||||
{/* ЕДИНСТВЕННОЕ место для компании/подразделения/должности — и на форме
|
||||
подачи (редактируемая, onRemoveOrganization задан), и в просмотре
|
||||
(read-only, ничего не передано). Отдельных полей для них нет — были бы
|
||||
дублированием того, что уже показывает эта таблица. */}
|
||||
<OrganizationsTable
|
||||
records={data.Organization}
|
||||
onChangePosition={
|
||||
onRemoveOrganization &&
|
||||
((i, v) =>
|
||||
set(
|
||||
'Organization',
|
||||
data.Organization.length > 0
|
||||
? data.Organization.map((r, ri) => (ri === i ? { ...r, position: v } : r))
|
||||
: [{ company: '', department: '', position: v }]
|
||||
))
|
||||
}
|
||||
onRemove={onRemoveOrganization}
|
||||
/>
|
||||
<FormField label="Самостоятельное подразделение" htmlFor="StandaloneUnit">
|
||||
<TextInput id="StandaloneUnit" value={data.StandaloneUnit} onChange={(v) => set('StandaloneUnit', v)} />
|
||||
</FormField>
|
||||
{/* Заявление подаётся заранее — датой увольнения нельзя назначить ближе,
|
||||
чем через MIN_NOTICE_MONTHS месяц от сегодня (min). */}
|
||||
<FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
|
||||
<TextInput
|
||||
id="LastWorkingDay"
|
||||
type="date"
|
||||
value={data.LastWorkingDay}
|
||||
onChange={(v) => set('LastWorkingDay', v)}
|
||||
min={isoDatePlusMonths(MIN_NOTICE_MONTHS)}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Контактный телефон" htmlFor="Phone" required>
|
||||
<PhoneInput id="Phone" value={data.Phone} onChange={(v) => set('Phone', v)} />
|
||||
</FormField>
|
||||
<FormField label="Комментарий" htmlFor="Comment" full>
|
||||
<TextArea id="Comment" value={data.Comment} onChange={(v) => set('Comment', v)} />
|
||||
</FormField>
|
||||
{/* Появляется, только когда обходной лист уже создан (автоматически после
|
||||
согласования заявления — см. createClearance.ts). */}
|
||||
<LinkField
|
||||
label="Обходной лист"
|
||||
url={data.ClearanceUrl}
|
||||
text="Открыть обходной лист по этому увольнению"
|
||||
/>
|
||||
{/* Заполняет НЕ заявитель, а непосредственный руководитель увольняемого на
|
||||
своём шаге согласования (см. DismissalView) — здесь всегда read-only,
|
||||
кроме как для него самого в момент его решения (assetsAcceptorEditable). */}
|
||||
<FormField label="Лицо, принимающее ОС/НМА" htmlFor="AssetsAcceptor" required={assetsAcceptorEditable} full>
|
||||
<PeopleField
|
||||
context={context}
|
||||
value={data.AssetsAcceptor}
|
||||
onChange={(v) => set('AssetsAcceptor', v)}
|
||||
placeholder={assetsAcceptorEditable ? 'Начните вводить Ф.И.О. сотрудника…' : undefined}
|
||||
readOnly={assetsAcceptorEditable ? false : true}
|
||||
/>
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
@@ -0,0 +1,134 @@
|
||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
||||
import { ensureEmployee } from '../../shared/employee';
|
||||
import { FORM_ID, IFormData, IOrganizationRecord } from './model';
|
||||
|
||||
/**
|
||||
* Position/Department — ОБЩИЙ столбец сайта (эталон) для 8 форм портала, тип
|
||||
* Text (однострочный) — SharePoint не позволяет там больше 255 символов, и
|
||||
* перегрузка типа отсюда невозможна и не нужна: столбец общий, менять его тип
|
||||
* значило бы менять его для всех 8 форм разом. Organization уже Note
|
||||
* (многострочный, без этого лимита) — предел касается только двух из трёх.
|
||||
* У реального совместителя (2-3 компании) JSON обычно укладывается на порядок
|
||||
* ниже 255, но если однажды не уложится — лучше явная ошибка при сохранении,
|
||||
* чем молча обрезанная запись (SharePoint либо обрежет остаток, либо вернёт
|
||||
* ошибку на самом write — в обоих случаях тихо терять данные хуже).
|
||||
*/
|
||||
const TEXT_COLUMN_LIMIT = 255;
|
||||
|
||||
/**
|
||||
* Один из трёх параллельных столбцов таблицы организаций (см.
|
||||
* IOrganizationRecord) — JSON-массив значений по каждой компании, в том же
|
||||
* порядке для всех трёх столбцов. Пустая таблица → null (а не '[]'), как и
|
||||
* остальные необязательные поля здесь.
|
||||
*/
|
||||
function organizationColumn(
|
||||
records: IOrganizationRecord[],
|
||||
pick: (r: IOrganizationRecord) => string,
|
||||
columnTitle: string,
|
||||
limit?: number
|
||||
// eslint-disable-next-line @rushstack/no-new-null -- SharePoint REST ожидает null, чтобы очистить поле
|
||||
): string | null {
|
||||
if (records.length === 0) return null;
|
||||
const json = JSON.stringify(records.map(pick));
|
||||
if (limit !== undefined && json.length > limit) {
|
||||
throw new Error(
|
||||
`Слишком много компаний для сохранения (столбец «${columnTitle}»: ${json.length} символов, лимит ${limit}) — уберите лишние в таблице «Организация».`
|
||||
);
|
||||
}
|
||||
return json;
|
||||
}
|
||||
|
||||
/**
|
||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
|
||||
* именем формы для читаемости вызывающего кода.
|
||||
*/
|
||||
export function dismissalApprovalService(listId?: string): ApprovalListService {
|
||||
return approvalServiceFor(FORM_ID, listId);
|
||||
}
|
||||
|
||||
function pad2(n: number): string {
|
||||
return n < 10 ? `0${n}` : `${n}`;
|
||||
}
|
||||
|
||||
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||
function buildTitle(employeeName: string): string {
|
||||
const now = new Date();
|
||||
return `Заявление на увольнение — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Поля элемента списка данных из модели формы (+ Employee по Id).
|
||||
*
|
||||
* НЕ включает AssetsAcceptor: это поле заполняет непосредственный руководитель на
|
||||
* своём шаге согласования (см. updateAssetsAcceptor и DismissalView), а не
|
||||
* заявитель. Если бы buildItem писал его из data.AssetsAcceptor, повторное
|
||||
* сохранение формы подачи (доработка/повторная отправка) отправляло бы то же
|
||||
* значение назад — сейчас безвредно (round-trip), но при малейшем расхождении
|
||||
* состояния незаметно бы затёрло то, что руководитель уже проставил. Проще и
|
||||
* надёжнее вообще не трогать это поле из формы подачи.
|
||||
*/
|
||||
function buildItem(
|
||||
data: IFormData,
|
||||
status: string,
|
||||
employeeId: number,
|
||||
employeeName: string
|
||||
): Record<string, unknown> {
|
||||
return {
|
||||
Title: buildTitle(employeeName),
|
||||
RequestStatus: status,
|
||||
EmployeeId: employeeId,
|
||||
// Три параллельных JSON-массива, один индекс — одна компания (см.
|
||||
// IOrganizationRecord) — отдельные столбцы, а не общий блок. Лимит только
|
||||
// на Position/Department (Text, см. TEXT_COLUMN_LIMIT) — Organization это Note.
|
||||
Position: organizationColumn(data.Organization, (r) => r.position, 'Должность', TEXT_COLUMN_LIMIT),
|
||||
Department: organizationColumn(data.Organization, (r) => r.department, 'Департамент', TEXT_COLUMN_LIMIT),
|
||||
Organization: organizationColumn(data.Organization, (r) => r.company, 'Организация'),
|
||||
StandaloneUnit: data.StandaloneUnit || null,
|
||||
LastWorkingDay: data.LastWorkingDay || null,
|
||||
Phone: data.Phone || null,
|
||||
Comment: data.Comment || null
|
||||
};
|
||||
}
|
||||
|
||||
export type ISaveResult = ISaveItemResult;
|
||||
|
||||
/**
|
||||
* Сохранить заявление на увольнение: содержимое + маршрут согласования.
|
||||
* existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||
* Фазы исполнения нет — writeRoute вызывается с пустым списком исполнителей.
|
||||
* Возвращает Id заявки (+ код при создании).
|
||||
*
|
||||
* listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadDismissalRequest). Имеет смысл
|
||||
* только вместе с existingId: новая заявка всегда создаётся в ТЕКУЩЕЙ партиции —
|
||||
* писать новые заявки в архив незачем и нельзя (approval-route переключает
|
||||
* текущую партицию сам, по своему порогу элементов).
|
||||
*/
|
||||
export async function saveDismissalRequest(
|
||||
existingId: number | undefined,
|
||||
requestTypeId: number,
|
||||
data: IFormData,
|
||||
approvers: IApproverToWrite[],
|
||||
status: string,
|
||||
listId?: string
|
||||
): Promise<ISaveResult> {
|
||||
const employee = await ensureEmployee(data.Employee);
|
||||
const item = buildItem(data, status, employee.Id, employee.Title || data.Employee);
|
||||
|
||||
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
|
||||
await writeRoute(dismissalApprovalService(listId), result.id, approvers, [], status);
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Проставить «Лицо, принимающее ОС/НМА» — вызывается ИЗ DismissalView
|
||||
* непосредственным руководителем увольняемого перед его решением (см.
|
||||
* onBeforeDecide), не из формы подачи. email — People-значение (e-mail), пусто
|
||||
* не бывает: DismissalView не даёт согласовать шаг, пока поле не заполнено
|
||||
* (см. валидацию там же).
|
||||
*/
|
||||
export async function updateAssetsAcceptor(id: number, email: string, listId?: string): Promise<void> {
|
||||
const acceptor = await ensureEmployee(email);
|
||||
await resolveDataList(FORM_ID, listId).items.getById(id).update({ AssetsAcceptorId: acceptor.Id });
|
||||
}
|
||||
@@ -12,7 +12,7 @@ export async function loadPrefillFromHire(hireId: number): Promise<IFormData> {
|
||||
FullName: hire.CandidateName,
|
||||
Phone: hire.Phone,
|
||||
Position: hire.Position,
|
||||
Department: hire.SiteName,
|
||||
Department: hire.Department,
|
||||
WorkKind: hire.WorkKind,
|
||||
Location: hire.SiteLocation,
|
||||
StartDate: hire.HireDate
|
||||
|
||||
@@ -39,6 +39,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
||||
),
|
||||
'clearance-form': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-clearance' */ './Clearance/ClearanceForm')
|
||||
),
|
||||
'hr-dismissal': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-dismissal' */ './Dismissal/DismissalForm')
|
||||
)
|
||||
};
|
||||
|
||||
|
||||
@@ -52,6 +52,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
||||
),
|
||||
'clearance-form': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-clearance' */ './Clearance/ClearanceView')
|
||||
),
|
||||
'hr-dismissal': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-dismissal' */ './Dismissal/DismissalView')
|
||||
)
|
||||
};
|
||||
|
||||
|
||||
Reference in New Issue
Block a user