4 Commits

Author SHA1 Message Date
gorbenko.pavel cda68f86b0 Merge remote-tracking branch 'origin/main' into fired-request
Tests / frontend-test (pull_request) Successful in 1m22s
2026-08-25 13:24:23 +05:00
gorbenko.pavel 0e582dceb8 feat: ссылки между заявлением на увольнение и обходным листом видны на формах
Поле-ссылка LinkField (shared/ui): read-only «карточка» как у OrganizationField,
но кликабельная, открывается в новой вкладке (портал — одна страница, переход в
текущей означал бы перезагрузку с потерей открытого). Пустой адрес — поле не
рендерится: связь есть не у всех заявок.

В заявлении показывается «Обходной лист» (ClearanceUrl), в обходном листе —
«Заявление на увольнение» (DismissalUrl); обе колонки читаются в load.ts (адрес из
объекта {Url, Description}) и не пишутся формами. Согласующему, который только что
одобрил заявление, ссылка дописывается в модель сразу после автосоздания листа —
иначе появилась бы только после перезагрузки.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 13:04:52 +05:00
gorbenko.pavel c174eb8688 feat: согласованное заявление на увольнение само создаёт обходной лист
Как только маршрут заявления пройден целиком (статус «Согласовано»), портал
заводит обходной лист по нему: форма не открывается — маршрут резолвится через
approval-route (обе фазы, по Employee и Position заявления), элемент пишется в
текущую партицию списка «Обходной лист … — данные» и сразу уходит на согласование
с оповещением активного шага.

Поля выводятся из заявления (сотрудник, должность, подразделение, организация,
последний рабочий день → дата расторжения договора); отметки парковки/СКУД/обучения
остаются профильным согласующим. Пара связывается перекрёстными гиперссылками
ClearanceUrl / DismissalUrl — для них добавлен requestLinkUrl: абсолютная ссылка на
заявку без посторонних параметров страницы, в отличие от routeUrl.

Повторное создание отсекается непустой ClearanceUrl: заявление можно согласовать
второй раз после возврата на доработку, и без этой проверки на каждый цикл
появлялся бы новый обходной лист. Создание идёт в браузере последнего согласующего —
если оно упало, согласование не отменяется, а портал показывает предупреждение
«заведите вручную».

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 12:56:50 +05:00
gorbenko.pavel ca1d7512d6 feat: форма «Заявление на увольнение» (hr-dismissal)
Новая форма отдела кадров по бумажному шаблону «Заявление на увольнение ШТАТ»:
сотрудник, должность, структурное и самостоятельное подразделение, последний
рабочий день, контактный телефон, комментарий. По умолчанию заявка на себя, но
можно подать за другого — маршрут резолвится по выбранному сотруднику.

Подразделение подтягивается из профиля (SPS-Department, read-only), должность и
организации — из справочника Employee/ByEmail. Последний рабочий день не может
быть в прошлом; срок предупреждения об увольнении форма не проверяет — дату
согласуют с работодателем.

Перекрёстные ссылки с «Обходным листом»: колонки-гиперссылки ClearanceUrl /
DismissalUrl (только в списках, формы их пока не пишут). Для них в провижинере
появился тип колонки Url, а сам скрипт разбит на два прохода — сначала все
списки, потом колонки: иначе Lookup на список другой формы держится на алфавитном
порядке обхода манифестов.

Списки «Заявление на увольнение 1 — данные» / «… — согласование» созданы на
/sites/requests. Тип заявки в админке approval-route ещё не заведён — до этого
форма откроется, но отправить заявку не даст.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-25 12:45:17 +05:00
28 changed files with 1335 additions and 21 deletions
+1
View File
@@ -46,6 +46,7 @@
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
| [`it-1c-ticket`](../src/webparts/requestPortal/forms/Ticket1C/README.md) | Заявка в отдел 1С | IT | да | нет | да | контакты предзаполняются из Graph (/me); вместо фазы исполнения — карточка в Microsoft Planner (согласовано/сразу без согласования — рабочий бакет, отклонено — отдельный бакет) | ✅ |
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker); условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД), сумма обучения | ✅ |
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | по умолчанию на себя, но можно за другого; подразделение из профиля (read-only), должность/организация из справочника; последний рабочий день не в прошлом; **после согласования сам создаёт обходной лист** и связывает пару ссылками | ⏳ тип заявки не заведён в админке approval-route |
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
+35 -16
View File
@@ -4,11 +4,14 @@
по манифестам provisioning.json (единый источник правды по колонкам).
.DESCRIPTION
Обходит ВСЕ манифесты forms/**/provisioning.json (в т.ч. подпапки approval/) и для
каждого:
1) создаёт список (если его ещё нет);
2) при необходимости переименовывает колонку Title;
3) обеспечивает колонки.
Обходит ВСЕ манифесты forms/**/provisioning.json (в т.ч. подпапки approval/)
ДВУМЯ проходами:
1) создаёт ВСЕ списки (которых ещё нет);
2) по каждому манифесту: при необходимости переименовывает колонку Title и
обеспечивает колонки.
Проходы разделены из-за Lookup'ов между формами: список-источник должен
существовать раньше колонки, а при перекрёстных ссылках (две формы ссылаются
друг на друга) одним проходом это недостижимо ни при каком порядке обхода.
Имена списков НУМЕРОВАННЫЕ: «<Форма> <N> — данные» / «<Форма> <N> — согласование».
Номер собирает сам скрипт из имени в манифесте (см. Get-NumberedListTitle) — в
@@ -170,6 +173,7 @@ function Ensure-SiteColumn {
}
'Choice' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type Choice -Choices $Col.choices -Group $g | Out-Null }
'Number' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type Number -Group $g | Out-Null }
'Url' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type URL -Group $g | Out-Null }
default { throw "Неизвестный тип столбца сайта '$($Col.type)'" }
}
Write-Host " [+эталон] $($Col.internalName) — «$($Col.title)» [$($Col.type)]" -ForegroundColor Green
@@ -214,6 +218,7 @@ function Add-ListColumn {
}
}
'Choice' { Add-PnPField -List $List -InternalName $Col.internalName -DisplayName $Col.title -Type Choice -Choices $Col.choices -AddToDefaultView | Out-Null }
'Url' { Add-PnPField -List $List -InternalName $Col.internalName -DisplayName $Col.title -Type URL -AddToDefaultView | Out-Null }
'Number' {
if ($null -ne $Col.decimals) {
$xml = "<Field Type='Number' DisplayName='$(ConvertTo-XmlSafe $Col.title)' Name='$($Col.internalName)' Decimals='$($Col.decimals)' />"
@@ -325,21 +330,35 @@ if ($ListNumber -eq 1 -and -not $SkipRename) {
}
}
# Проход 1: САМИ СПИСКИ — все до единого, ДО колонок.
#
# Раньше список и его колонки создавались одним проходом по манифесту, и Lookup на
# список ДРУГОЙ формы (WorkplaceSetup.SourceHire → «Прием на работу … — данные»)
# резолвился только если та форма попадалась в обходе раньше — то есть держался на
# алфавитном везении, а для взаимных ссылок был бы невозможен в принципе. Поэтому
# сначала все списки, потом все колонки: к моменту разрешения любого Lookup'а
# список-источник уже существует.
Write-Host "`n=== Списки ===" -ForegroundColor Cyan
foreach ($manifest in $manifests) {
$def = Get-Content -Path $manifest.FullName -Raw -Encoding UTF8 | ConvertFrom-Json
$listTitle = Get-NumberedListTitle -Title $def.dataListTitle -Number $ListNumber
if (-not (Get-PnPList -Identity $listTitle -ErrorAction SilentlyContinue)) {
New-PnPList -Title $listTitle -Template GenericList -EnableVersioning | Out-Null
Write-Host " [+] создан список «$listTitle»" -ForegroundColor Green
}
else {
Write-Host " [=] список уже существует: «$listTitle»" -ForegroundColor DarkGray
}
}
# Проход 2: колонки (и переименование Title) — по одному манифесту за раз.
foreach ($manifest in $manifests) {
$def = Get-Content -Path $manifest.FullName -Raw -Encoding UTF8 | ConvertFrom-Json
$listTitle = Get-NumberedListTitle -Title $def.dataListTitle -Number $ListNumber
Write-Host "`n=== Форма: $($manifest.Directory.Name) → список «$listTitle» ===" -ForegroundColor Cyan
# 1) Список (идемпотентно)
if (-not (Get-PnPList -Identity $listTitle -ErrorAction SilentlyContinue)) {
New-PnPList -Title $listTitle -Template GenericList -EnableVersioning | Out-Null
Write-Host " [+] создан список" -ForegroundColor Green
}
else {
Write-Host " [=] список уже существует" -ForegroundColor DarkGray
}
# 2) Переименование Title (если задано)
# 1) Переименование Title (если задано)
if ($def.titleColumnName) {
try {
Set-PnPField -List $listTitle -Identity 'Title' -Values @{ Title = $def.titleColumnName } | Out-Null
@@ -350,7 +369,7 @@ foreach ($manifest in $manifests) {
}
}
# 3) Колонки (идемпотентно): не-Lookup — через эталоны (столбцы сайта), Lookup — на список.
# 2) Колонки (идемпотентно): не-Lookup — через эталоны (столбцы сайта), Lookup — на список.
foreach ($col in $def.columns) {
Add-ColumnToList -List $listTitle -Col $col
}
+4 -1
View File
@@ -25,12 +25,15 @@
| `DateTime` | дата/время | — |
| `Boolean` | да/нет | — |
| `User` | пользователь | — |
| `Url` | гиперссылка (адрес + подпись) | — |
| `Lookup` | подстановка | `lookupList` (заголовок источника), `lookupShowField` (по умолч. `Title`) |
Плюс на уровне формы: `titleColumnName` — переименовать стандартную колонку `Title`.
> **Порядок для Lookup:** список-источник должен существовать раньше, чем колонка,
> которая на него ссылается. Если источник в другой форме — сначала прогоните её манифест.
> которая на него ссылается — но следить за этим руками не нужно: скрипт сначала
> создаёт ВСЕ списки, и только потом колонки, поэтому порядок обхода манифестов
> не важен (и взаимные ссылки тоже разрешимы).
## Разовая подготовка
@@ -17,6 +17,7 @@ export const REQUEST_TYPES: IRequestType[] = [
// Отдел кадров
{ id: 'hr-vacation', categoryId: 'hr', title: 'Заявка на трудовой отпуск', icon: 'calendar' },
{ id: 'hr-unpaid-leave', categoryId: 'hr', title: 'Заявка на отпуск без содержания', icon: 'document' },
{ id: 'hr-dismissal', categoryId: 'hr', title: 'Заявление на увольнение', icon: 'document' },
{ id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
{ id: 'hr-transfer', categoryId: 'hr', title: 'Заявка на перемещение сотрудников', icon: 'people' },
@@ -39,6 +39,21 @@ RequestTypeId» в `docs/forms.md`). Тип уже зарегистрирова
(в отличие от `EndDate` в «Заявке на отпуск», которая считается).
- **Заголовок элемента** (`Title`): `Обходной лист — {ФИО} — дд.мм.гггг`.
## Связь с заявлением на увольнение
Обходной лист может появиться **сам, без этой формы**: когда согласовано «Заявление
на увольнение» (`hr-dismissal`), портал создаёт лист по нему и сразу отправляет на
согласование — см. `forms/Dismissal/createClearance.ts` и README той формы. Такой
лист приходит уже с заполненными сотрудником, должностью, подразделением и датой
расторжения; отметки (парковка, СКУД, обучение) по-прежнему проставляют профильные
согласующие. Подача этой формы руками остаётся — для увольнений, оформленных без
заявления в портале.
Пара связана колонками-гиперссылками: `DismissalUrl` здесь → на заявление,
`ClearanceUrl` в заявлении → на лист. Форма их не пишет (заполняет автосоздание либо
вручную в SharePoint), но **показывает**: поле «Заявление на увольнение» —
`LinkField` из `shared/ui`, read-only, открывается в новой вкладке; у листов,
заведённых руками, ссылки нет и поле не рендерится.
## Секции формы
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма обучения · парковочная карта · карта СКУД)
@@ -32,6 +32,7 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
'AccessCard',
'TrainingAmount',
'Organization',
'DismissalUrl',
'RequestStatus',
'RequestUniqueCode',
'Employee/Title',
@@ -52,7 +53,9 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
ParkingCard: !!item.ParkingCard,
AccessCard: !!item.AccessCard,
TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
Organization: (item.Organization as string) || ''
Organization: (item.Organization as string) || '',
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
DismissalUrl: (item.DismissalUrl as { Url?: string } | undefined)?.Url || ''
};
return {
@@ -31,6 +31,12 @@ export interface IFormData {
* read-only (см. shared/ui/OrganizationField).
*/
Organization: string;
/**
* Ссылка на заявление на увольнение, по которому создан этот лист — колонка-
* гиперссылка `DismissalUrl`. Форма её не пишет (заполняет автосоздание, см.
* forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
*/
DismissalUrl: string;
}
/** Обновление одного поля формы с сохранением типа значения. */
@@ -56,7 +62,8 @@ export const EMPTY_DATA: IFormData = {
ParkingCard: false,
AccessCard: false,
TrainingAmount: '',
Organization: ''
Organization: '',
DismissalUrl: ''
};
/** Плейсхолдер для поля выбора сотрудника. */
@@ -12,6 +12,8 @@
{ "internalName": "ParkingCard", "title": "Парковочная карта", "type": "Boolean" },
{ "internalName": "AccessCard", "title": "Карта СКУД", "type": "Boolean" },
{ "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
{ "internalName": "Organization", "title": "Организация", "type": "Note" }
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
{ "internalName": "DismissalUrl", "title": "Ссылка на заявление на увольнение", "type": "Url" }
]
}
@@ -1,5 +1,5 @@
import * as React from 'react';
import { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField } from '../../../shared/ui';
import { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
// Подразделение подтягивается автоматически при выборе сотрудника (см.
@@ -89,5 +89,12 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
readOnly={hrRecordsEditable ? false : undefined}
/>
</FormField>
{/* Есть только у листов, созданных автоматически по согласованному заявлению
на увольнение (см. forms/Dismissal/createClearance.ts). */}
<LinkField
label="Заявление на увольнение"
url={data.DismissalUrl}
text="Открыть заявление, по которому создан этот лист"
/>
</CollapseSection>
);
@@ -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,319 @@
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, formatEmployeeOrganizations } from '../../shared/dictionary';
import { friendlyErrorMessage } from '../../shared/diagnostics';
import { isoDatePlusDays, formatIsoDate } from '../../shared/dateUtils';
import {
approvalListTitle,
approvalListTitleForListId,
dataListTitle,
dataListTitleForListId
} from '../../shared/listTitles';
import { FORM_ID, IFormData, EMPTY_DATA, SetField } 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;
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 — см. shared/dictionary/
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких
// организациях, должность берём из ПЕРВОЙ записи), подразделение — из профиля.
useEffect(() => {
if (editId) {
return;
}
let alive = true;
const user = context.pageContext.user;
setData((prev) => ({ ...prev, Employee: prev.Employee || user.email }));
getEmployeeOrganizations(context, user.email)
.then((records) => {
if (!alive) return;
setData((prev) => ({
...prev,
Position: prev.Position || records[0]?.position || prev.Position,
Organization: formatEmployeeOrganizations(records)
}));
})
.catch(() => undefined);
approval
.getProfileFields(user.email)
.then((profile) => {
if (!alive) return;
setData((prev) => ({ ...prev, Department: prev.Department || profile.department }));
})
.catch(() => undefined);
return () => {
alive = false;
};
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [editId]);
// Выбор другого сотрудника подтягивает его должность, подразделение и организации.
const handleEmployeeChange = (login: string): void => {
setData((prev) => ({ ...prev, Employee: login, Department: '', Organization: '' }));
if (!login) {
return;
}
approval
.getProfileFields(login)
.then((profile) => setData((prev) => ({ ...prev, Department: profile.department })))
.catch(() => undefined);
getEmployeeOrganizations(context, login)
.then((records) =>
setData((prev) => ({
...prev,
Position: records[0]?.position || prev.Position,
Organization: formatEmployeeOrganizations(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: data.Position }
]),
[context, approval, editId, data.Employee, data.Position, requestTypeId]
);
const matrix = useMatrixEditor(
loadMatrix,
`${data.Employee}-${editId ?? 'new'}-${data.Position}`,
!readOnly,
!!editId || (!!data.Employee && !!requestTypeId),
(login) => approval.getJobTitle(login)
);
// Последний рабочий день не может быть в прошлом: заявление подаётся заранее.
// Календарь (min у input type=date, см. RequestSection) не даёт выбрать более
// раннюю дату, но проверяем и здесь на случай обхода UI.
const today = isoDatePlusDays(0);
const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= today;
const isValid = !!(
data.Employee &&
data.Position.trim() &&
data.LastWorkingDay &&
isLastDayValid &&
data.Phone.trim()
);
const validate = (): string | undefined => {
if (data.LastWorkingDay && !isLastDayValid) {
return `Последний рабочий день не может быть раньше сегодняшней даты (${formatIsoDate(today)}).`;
}
if (!data.Employee || !data.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 };
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,14 @@
@import '../../../../styles/design-tokens';
.state {
padding: $sp-8;
color: $gray-500;
font-size: $fs-sm;
text-align: center;
}
.toolbar {
display: flex;
justify-content: flex-end;
margin-bottom: $sp-4;
}
@@ -0,0 +1,203 @@
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 {
approvalListTitle,
approvalListTitleForListId,
dataListTitle,
dataListTitleForListId
} from '../../shared/listTitles';
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
import { loadDismissalRequest } from './load';
import { dismissalApprovalService } from './submit';
import { ensureClearanceForDismissal } from './createClearance';
import { RequestSection } from './sections/RequestSection';
interface IDismissalViewProps {
context: WebPartContext;
itemId: number;
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
formKey: string;
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
listId?: string;
}
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
const NOOP_SET: SetField = () => undefined;
// Заявление на увольнение только для просмотра (режим согласующего).
// Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
// <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>('');
// 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]);
if (loading) {
return <div className={styles.state}>Загрузка заявки…</div>;
}
if (error) {
return (
<div className={styles.state}>
<Alert variant="err">{error}</Alert>
</div>
);
}
const sectionProps = { data, set: NOOP_SET, context };
const notify = (): void => {
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
// весь UI ради необязательного оповещения.
if (!requestTypeId) return;
notifyActiveStep(context, approval, itemId, {
requestTypeId,
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
}).catch(() => undefined);
};
// Заявление согласовано целиком → сразу заводим обходной лист по нему (данные
// выводятся из заявления, заполнять его руками нечего — см. createClearance.ts).
// Свой статус решения при этом уже применён: неудача автосоздания не отменяет
// согласование, поэтому она показывается предупреждением, а не ошибкой заявки.
const createClearance = (): void => {
setClearanceError('');
ensureClearanceForDismissal(context, itemId, listId)
.then((result) => {
setClearance(
result.existing
? 'Обходной лист по этому заявлению уже был создан.'
: `Обходной лист создан автоматически${result.code ? ` — №${result.code}` : ''} и отправлен на согласование.`
);
// Поле-ссылка в секции заполняется из данных заявки, а они прочитаны ДО
// создания листа — дописываем адрес в модель, иначе ссылка появилась бы
// только после перезагрузки страницы.
setData((prev) => ({ ...prev, ClearanceUrl: result.url }));
})
.catch((e) =>
setClearanceError(
`Заявление согласовано, но обходной лист создать не удалось: ${friendlyErrorMessage(e)} — заведите его вручную.`
)
);
};
return (
<div>
<div className={`${styles.toolbar} rp-no-print`}>
<PrintButton />
</div>
<div className="rp-no-print">
{clearance && <Alert variant="ok">{clearance}</Alert>}
{clearanceError && <Alert variant="err">{clearanceError}</Alert>}
</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">
<DecisionPanel
service={approverService}
requestId={itemId}
search={(q) => approval.searchUsers(q)}
onDecided={(newStatus) => {
setStatus(newStatus);
setDecisionSeq((n) => n + 1);
notify();
// «Согласовано» = маршрут заявления пройден целиком (фазы исполнения у
// него нет, см. README формы) — значит увольнение подтверждено и пора
// заводить обходной лист.
if (newStatus === REQUEST_STATUS.approved) {
createClearance();
}
}}
onDelegated={() => {
setDecisionSeq((n) => n + 1);
notify();
}}
/>
</div>
</div>
);
};
export default DismissalView;
@@ -0,0 +1,94 @@
# Заявление на увольнение (hr-dismissal)
**Назначение:** заявление работника о расторжении трудового договора по собственному
желанию (штатный сотрудник). Бумажный первоисточник — «Шаблон Заявление на увольнение ШТАТ.docx».
**Категория:** Отдел кадров
**Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
`pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
RequestTypeId» в `docs/forms.md`). Тип нужно **завести в админке approval-route**
(pageUrl «hr-dismissal» + ссылка на список данных) — до этого форма откроется, но
отправить заявку не даст: маршрут не резолвится.
## Маршрут
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
получает статус «Согласовано» (как «Обходной лист» / «Отпуск без содержания»).
- **Матрица редактируема заявителем** при новой заявке / черновике / возврате:
`useMatrixEditor(editable = !readOnly)`.
- Условие `IsManager` в маршруте (если настроено в админке) резолвится по полю
**Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
«Обходном листе».
## Особое поведение
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
reloadKey матрицы включает `data.Employee` и `data.Position`.
- **Автоподстановка при выборе сотрудника:** должность и организации — из справочника
`Employee/ByEmail` (`shared/dictionary`, должность из ПЕРВОЙ записи, чтобы должность
и организация были парой из одной записи); структурное подразделение — из профиля
SharePoint (`SPS-Department` через `approval.getProfileFields`).
- **Структурное подразделение** (`Department`) — read-only, только из профиля: чтобы
не расходиться с профилем (как в «Обходном листе»). **Самостоятельное
подразделение** (`StandaloneUnit`) в профиле не хранится — свободный ввод.
- **Последний рабочий день** (`LastWorkingDay`) — обязателен, не может быть в прошлом
(`min` у `input type=date` + проверка в `validate` на случай обхода UI).
Срок предупреждения об увольнении (обычно месяц) **не** проверяется — договорную
дату согласуют с работодателем, форма её только фиксирует.
- **Контактный телефон** (`Phone`) — обязателен, `PhoneInput` (маска).
- **Комментарий** (`Comment`) — необязательный свободный текст. Причины увольнения
отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
- **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
## Согласовано → обходной лист создаётся сам
Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
портал заводит по нему **обходной лист** — `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,
открываются в новой вкладке и появляются только когда связь есть. У согласующего,
только что одобрившего заявление, ссылка появляется сразу, без перезагрузки.
Что важно знать про это поведение:
- **Идемпотентность — по непустой `ClearanceUrl`.** Заявление можно согласовать
повторно (возврат на доработку → отправка → согласование), и без этой проверки
на каждый цикл появлялся бы новый обходной лист.
- **Работает в браузере последнего согласующего.** Если создание упало (или он
закрыл вкладку в этот момент), заявление всё равно согласовано, а обходного листа
нет — портал покажет предупреждение «заведите вручную». Серверного повтора нет:
фонового обработчика у портала пока не существует, всё делает клиент.
- **Автором обходного листа** в SharePoint станет этот согласующий (в «Мои заявки»
лист попадёт к нему). На маршрут это не влияет — он резолвится по `Employee`.
- Тип заявки `clearance-form` должен быть заведён в админке approval-route — иначе
создание падает на резолве `RequestTypeId`.
## Отличия от «Обходной лист» (clearance-form)
Обходной лист оформляет HR **после** решения об увольнении (обход подразделений,
карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
полей всего восемь, отметок подразделений нет.
## Секции формы
RequestSection (сотрудник · должность · структурное подразделение · самостоятельное
подразделение · организация · последний рабочий день · телефон · комментарий)
## Точки входа
- 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,167 @@
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 } 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('В заявлении не заполнен сотрудник — обходной лист не создан.');
}
const position = (item.Position as string) || '';
// Тип заявки и партиция для записи — как у обычной подачи обходного листа
// (см. 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: (item.Department as string) || '',
// Последний рабочий день заявления = дата расторжения договора в обходном листе.
TerminationDate: ((item.LastWorkingDay as string) || '').slice(0, 10),
Organization: (item.Organization as string) || ''
};
// Статус — как при обычной отправке: с согласующими «На согласовании», без них
// маршрут сразу уходит в исполнение/согласовано (см. 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,66 @@
import { getSP } from '../../shared/pnp/pnpjs';
import { dataListTitle } from '../../shared/listTitles';
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
export interface ILoadedRequest {
data: IFormData;
/** Ф.И.О. сотрудника из поля Employee (для заголовка режима чтения). */
employeeName: string;
status: string;
/** Уникальный код заявки; '' — если запись создана до появления поля. */
code: string;
}
/**
* Прочитать заявление на увольнение по id: модель формы + статус (правка / просмотр).
*
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
* по url списка, а не по имени: так не нужно резолвить, как называется архивный
* список, и запрос не зависит от реестра партиций.
*/
export async function 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'
)
.expand('Employee')()) as Record<string, unknown>;
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
const lastDay = (item.LastWorkingDay as string) || '';
const data: IFormData = {
...EMPTY_DATA,
Employee: employee?.EMail || '',
Position: (item.Position as string) || '',
Department: (item.Department as string) || '',
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: (item.Organization as string) || '',
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || ''
};
return {
data,
employeeName: employee?.Title || '',
status: (item.RequestStatus as string) || '',
code: (item.RequestUniqueCode as string) || ''
};
}
@@ -0,0 +1,78 @@
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';
/**
* Данные формы «Заявление на увольнение» (штатный сотрудник) по бумажному шаблону
* «Шаблон Заявление на увольнение ШТАТ.docx»: расторжение трудового договора по
* собственному желанию. Ключи по возможности = internalName колонок списка данных
* (см. shared/listTitles.ts). Employee хранит e-mail сотрудника (то, что отдаёт
* PeopleField); по нему резолвится маршрут согласования, поэтому заявку можно
* подать и за другого сотрудника (например, кадровик за работника без доступа).
*
* Причина увольнения в шаблоне фиксированная («по собственному желанию») — своего
* поля под неё нет, поэтому в модели её тоже нет; свободный текст — в Comment.
*/
export interface IFormData {
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
Employee: string;
Position: string;
/** Структурное подразделение — из профиля (SPS-Department), read-only. */
Department: string;
/** Самостоятельное подразделение — в профиле его нет, вводится вручную. */
StandaloneUnit: string;
/** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
LastWorkingDay: string;
/** Контактный телефон (маска, см. PhoneInput). */
Phone: string;
/** Необязательный комментарий заявителя. */
Comment: string;
/**
* Организации сотрудника (`\n`-joined «Компания — должность» на строку) —
* подтягивается автоматически из Employee/ByEmail при выборе Employee,
* read-only (см. shared/ui/OrganizationField).
*/
Organization: string;
/**
* Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
* `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
* createClearance.ts) и не даёт править — только показывает переходом.
*/
ClearanceUrl: 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: '',
Position: '',
Department: '',
StandaloneUnit: '',
LastWorkingDay: '',
Phone: '',
Comment: '',
Organization: '',
ClearanceUrl: ''
};
/** Плейсхолдер для поля выбора сотрудника. */
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
@@ -0,0 +1,18 @@
{
"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" }
]
}
@@ -0,0 +1,88 @@
import * as React from 'react';
import {
CollapseSection,
FormField,
TextInput,
TextArea,
PhoneInput,
PeopleField,
OrganizationField,
LinkField
} from '../../../shared/ui';
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
import { isoDatePlusDays } from '../../../shared/dateUtils';
// Структурное подразделение подтягивается из профиля при выборе сотрудника (см.
// DismissalForm.handleEmployeeChange — SharePoint User Profile), свободный ввод
// намеренно убран, чтобы не расходиться с профилем — как в «Обходном листе».
const NOOP = (): void => undefined;
/**
* Единственная секция формы «Заявление на увольнение»: кто увольняется, где
* работает, последний рабочий день и контакты. Набор полей — с бумажного шаблона
* «Заявление на увольнение ШТАТ».
*/
export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, onEmployeeChange }) => (
<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>
{/* Подставляется по выбранному сотруднику, но остаётся редактируемым: если
справочник организаций не заполнен, должность нужно ввести вручную —
иначе шаг маршрута с условием по должности не соберётся. */}
<FormField label="Должность" htmlFor="Position" required>
<TextInput
id="Position"
value={data.Position}
onChange={(v) => set('Position', v)}
placeholder="Подставится автоматически по выбранному сотруднику"
/>
</FormField>
<FormField label="Структурное подразделение" htmlFor="Department">
<TextInput
id="Department"
value={data.Department}
onChange={NOOP}
readOnly
placeholder="Подставится автоматически по выбранному сотруднику"
/>
</FormField>
<FormField label="Самостоятельное подразделение" htmlFor="StandaloneUnit">
<TextInput
id="StandaloneUnit"
value={data.StandaloneUnit}
onChange={(v) => set('StandaloneUnit', v)}
/>
</FormField>
<OrganizationField value={data.Organization} />
{/* Датой увольнения нельзя назначить прошедший день: заявление подаётся
заранее, а не задним числом (min = сегодня). */}
<FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
<TextInput
id="LastWorkingDay"
type="date"
value={data.LastWorkingDay}
onChange={(v) => set('LastWorkingDay', v)}
min={isoDatePlusDays(0)}
/>
</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="Открыть обходной лист по этому увольнению"
/>
</CollapseSection>
);
@@ -0,0 +1,73 @@
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
import { ensureEmployee } from '../../shared/employee';
import { FORM_ID, IFormData } from './model';
/**
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
* именем формы для читаемости вызывающего кода.
*/
export function 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). */
function buildItem(
data: IFormData,
status: string,
employeeId: number,
employeeName: string
): Record<string, unknown> {
return {
Title: buildTitle(employeeName),
RequestStatus: status,
EmployeeId: employeeId,
Position: data.Position || null,
Department: data.Department || null,
StandaloneUnit: data.StandaloneUnit || null,
LastWorkingDay: data.LastWorkingDay || null,
Phone: data.Phone || null,
Comment: data.Comment || null,
Organization: data.Organization || 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;
}
@@ -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')
)
};
@@ -27,6 +27,7 @@ import {
/** База имени по типу заявки. Ключи — те же, что в реестре форм (forms/registry.ts). */
const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
'clearance-form': 'Обходной лист',
'hr-dismissal': 'Заявление на увольнение',
'hr-vacation': 'Заявка на отпуск',
'hr-unpaid-leave': 'Отпуск без содержания',
'it-1c-ticket': 'Заявка в отдел 1С',
@@ -412,6 +412,30 @@ export function routeUrl(route: IRoute): string {
return buildQuery(route);
}
/**
* АБСОЛЮТНАЯ ссылка на просмотр заявки — для того, что переживёт текущую сессию:
* колонка-гиперссылка в списке SharePoint, письмо, сообщение в чат.
*
* Отличается от routeUrl() двумя вещами, и обе важны именно для «хранимой» ссылки:
* она с origin (в списке относительный путь бесполезен — его открывают из
* представления SharePoint, а не со страницы портала) и без посторонних
* query-параметров текущей страницы (routeUrl их намеренно сохраняет, потому что
* это навигация ВНУТРИ открытой страницы).
*
* Страница портала берётся из адреса текущей — портал живёт на одной странице,
* другого способа узнать её путь у клиентского кода нет.
*/
export function requestLinkUrl(formKey: string, itemId: number, listId?: string): string {
const params = new URLSearchParams();
params.set('rpmode', 'approve');
params.set('rptype', formKey);
params.set('rpid', String(itemId));
if (listId) {
params.set('rplist', listId);
}
return `${window.location.origin}${window.location.pathname}?${params.toString()}`;
}
/** Текущий маршрут, реактивно обновляется по navigate() и кнопке «назад». */
export function useRoute(): IRoute {
const [route, setRoute] = React.useState<IRoute>(() => parseRoute());
@@ -0,0 +1,30 @@
@import '../../../../../styles/design-tokens';
// Read-only «карточка» со ссылкой — те же радиус/паддинг/приглушённый фон, что у
// OrganizationField (сигнал «подставлено автоматически, не редактируется»),
// отличается только тем, что содержимое кликабельно.
.box {
box-sizing: border-box;
padding: 11px 13px;
border: 1px solid $gray-200;
border-radius: $r-sm;
background: $gray-50;
font-family: $font-sans;
font-size: 13.5px;
color: $gray-700;
}
.link {
display: inline-flex;
align-items: center;
gap: $sp-2;
color: $navy-700;
text-decoration: none;
transition: color .18s;
&:hover,
&:focus {
color: $gold-600;
text-decoration: underline;
}
}
@@ -0,0 +1,38 @@
import * as React from 'react';
import styles from './LinkField.module.scss';
import { FormField, Icon } from '@tnsu/ui-kit';
interface ILinkFieldProps {
label: string;
/** Адрес. Пусто — поле не рендерится вовсе (см. ниже). */
url: string;
/** Текст ссылки. По умолчанию — сам адрес. */
text?: string;
}
/**
* Поле-ссылка: read-only, кликабельное, руками не редактируется.
*
* Пустой url — ничего не рендерим (а не пустую рамку): такие поля появляются
* только когда связь уже есть (напр. ClearanceUrl заявления на увольнение
* заполняется автосозданием обходного листа), и до этого момента их нет смысла
* показывать.
*
* Открывается в НОВОЙ вкладке: портал — одна страница, и переход по ссылке в
* текущей означал бы полную перезагрузку с потерей того, что открыто и, возможно,
* не сохранено.
*/
export const LinkField: React.FC<ILinkFieldProps> = ({ label, url, text }) => {
if (!url) return null;
return (
<FormField label={label} full>
<div className={styles.box}>
<a className={styles.link} href={url} target="_blank" rel="noreferrer">
<span>{text || url}</span>
<Icon name="chevron-right" size="sm" />
</a>
</div>
</FormField>
);
};
@@ -39,6 +39,7 @@ export { parseExcelRows } from './ItemsTable/parseExcelRows';
export { PeopleField } from './PeopleField/PeopleField';
export { PeopleFieldMulti } from './PeopleField/PeopleFieldMulti';
export { OrganizationField } from './OrganizationField/OrganizationField';
export { LinkField } from './LinkField/LinkField';
export { ErrorOverlay } from './ErrorOverlay/ErrorOverlay';
export { SubmitActions } from './SubmitActions/SubmitActions';
export { InitiatorLine } from './InitiatorLine/InitiatorLine';