2 Commits

Author SHA1 Message Date
gorbenko.pavel d5832179fb куча разных нюансов сделано 2026-08-06 17:04:41 +05:00
gorbenko.pavel 13833217d0 основное готово 2026-08-06 16:01:33 +05:00
20 changed files with 762 additions and 140 deletions
@@ -73,6 +73,14 @@
margin-bottom: $sp-6;
}
// Раздел «Новая заявка», когда открыта другая вкладка. Именно скрытие, а не
// размонтирование: заполненная форма должна пережить переключение вкладок
// (см. RequestPortal.tsx). display:none выводит содержимое и из потока, и из
// последовательности табуляции — скрытая форма не ловит фокус с клавиатуры.
.hiddenPane {
display: none;
}
// На узких экранах рейл уходит наверх.
@media (max-width: 900px) {
.layout {
@@ -4,6 +4,7 @@ import type { IRequestPortalProps } from './IRequestPortalProps';
import { IconSprite } from '../shared/ui/Icon/IconSprite';
import { navigate, useRoute, NavSection } from '../shared/routing';
import { onRequestsChanged, emitRequestsChanged } from '../shared/requestEvents';
import { confirmDiscardFormChanges, markFormClean, markFormDirty } from '../shared/unsavedChanges';
import { SideNav } from './SideNav/SideNav';
import { Drawer } from './Drawer/Drawer';
import { CategoryTabs } from './CategoryTabs/CategoryTabs';
@@ -11,9 +12,12 @@ import { CATEGORIES, DEFAULT_CATEGORY_ID } from '../data/categories';
import { REQUEST_TYPES } from '../data/requests';
import SubmitFeature from '../features/submit/SubmitFeature';
import ApproveFeature from '../features/approve/ApproveFeature';
import EditFeature from '../features/edit/EditFeature';
import { RequestsTableView } from '../features/myRequests/RequestsTableView';
import { SearchView } from '../features/myRequests/SearchView';
import { getPendingApproval } from '../features/myRequests/myRequests.service';
import { IMyRequest } from '../features/myRequests/models/IMyRequest';
import { isEditableStatus } from '../shared/approval';
// Оболочка портала: тёмное боковое меню (разделы) + основная область.
// Логики фич тут нет — файл общий, меняется редко.
@@ -68,13 +72,28 @@ const RequestPortal: React.FC<IRequestPortalProps> = ({ hasTeamsContext, context
// Переход «создать на основе» (в т.ч. из открытой заявки в панели): переключаем
// вкладку категорий на категорию целевой формы, чтобы она совпала с открытой формой.
// Форма при этом пересоздаётся (см. key у SubmitFeature), поэтому прежние
// несохранённые правки к ней уже не относятся — снимаем флаг.
React.useEffect(() => {
if (route.mode === 'create' && route.formKey) {
const found = REQUEST_TYPES.filter((r) => r.id === route.formKey)[0];
if (found) setActiveCategoryId(found.categoryId);
markFormClean();
}
}, [route.mode, route.formKey]);
// Сохранение (в том числе черновика) шлёт rp-requests-changed — после него
// терять нечего, предупреждать при «создать на основе» больше не о чем.
React.useEffect(() => onRequestsChanged(markFormClean), []);
// Смена категории закрывает открытую форму (SubmitFeature сбрасывает выбор,
// когда категория перестаёт совпадать) — значит введённое пропадёт.
const changeCategory = (categoryId: string): void => {
if (!confirmDiscardFormChanges()) return;
markFormClean();
setActiveCategoryId(categoryId);
};
const goto = (nav: NavSection): void => {
// Клик по УЖЕ активному пункту меню не меняет маршрут, значит эффект
// загрузки в таблице не перезапустится сам. Шлём событие обновления —
@@ -83,8 +102,28 @@ const RequestPortal: React.FC<IRequestPortalProps> = ({ hasTeamsContext, context
if (nav === route.nav && route.mode === 'submit') emitRequestsChanged();
navigate({ mode: 'submit', nav });
};
// Клик по строке таблицы. СВОЯ заявка в незавершённом статусе (черновик,
// возвращённая, отклонённая) открывается на редактирование, всё остальное —
// на просмотр: чужую заявку править нельзя, а свою уже ушедшую по маршруту —
// тем более (её статус в isEditableStatus не входит).
const openRequest = (request: IMyRequest): void =>
navigate({
mode: request.kind === 'own' && isEditableStatus(request.status) ? 'edit' : 'approve',
nav: route.nav,
formKey: request.formKey,
itemId: request.id,
});
const closeDrawer = (): void => navigate({ mode: 'submit', nav: route.nav });
// Закрытие панели РЕДАКТИРОВАНИЯ: там открыта форма, и её содержимое живёт
// только в памяти — уходя без сохранения, пользователь теряет правки.
const closeEditDrawer = (): void => {
if (!confirmDiscardFormChanges()) return;
markFormClean();
closeDrawer();
};
return (
<section className={rootClasses}>
<IconSprite />
@@ -100,16 +139,35 @@ const RequestPortal: React.FC<IRequestPortalProps> = ({ hasTeamsContext, context
</div>
<main className={styles.main}>
{route.nav === 'new' ? (
<>
{/* Раздел «Новая заявка» держим СМОНТИРОВАННЫМ и просто прячем стилем,
когда открыта другая вкладка. Иначе React размонтировал бы форму, и
всё введённое пропадало бы при переключении на «Мои заявки» и
обратно. Ключ завязан на «создать на основе»: обычные переключения
вкладок его не меняют (состояние живёт), а вот открытие новой
заявки на основе исходной пересоздаёт форму — SubmitFeature читает
initialForm только при монтировании. */}
<div
className={route.nav === 'new' ? undefined : styles.hiddenPane}
// Делегирование: любой пользовательский ввод внутри раздела помечает
// форму изменённой. Так не нужно инструментировать каждую форму по
// отдельности, и программное заполнение (предзаполнение «на основе»)
// сюда не попадает — React выставляет значения без этих событий.
onInput={markFormDirty}
onChange={markFormDirty}
>
<div className={styles.tabsWrap}>
<CategoryTabs
categories={CATEGORIES}
activeId={activeCategoryId}
onChange={setActiveCategoryId}
onChange={changeCategory}
/>
</div>
<SubmitFeature
key={
route.mode === 'create' && route.formKey && route.sourceId
? `create-${route.formKey}-${route.sourceId}`
: 'blank'
}
context={context}
activeCategoryId={activeCategoryId}
initialForm={
@@ -118,31 +176,20 @@ const RequestPortal: React.FC<IRequestPortalProps> = ({ hasTeamsContext, context
: undefined
}
/>
</>
) : route.nav === 'search' ? (
</div>
{route.nav === 'search' && (
<SearchView
context={context}
onOpen={(request) =>
navigate({
mode: 'approve',
nav: route.nav,
formKey: request.formKey,
itemId: request.id,
})
}
onOpen={openRequest}
/>
) : (
)}
{(route.nav === 'approvals' || route.nav === 'own') && (
<RequestsTableView
context={context}
kind={route.nav === 'approvals' ? 'approvals' : 'own'}
onOpen={(request) =>
navigate({
mode: 'approve',
nav: route.nav,
formKey: request.formKey,
itemId: request.id,
})
}
onOpen={openRequest}
onMyTurnCountChange={route.nav === 'approvals' ? setApprovalsCount : undefined}
/>
)}
@@ -154,6 +201,21 @@ const RequestPortal: React.FC<IRequestPortalProps> = ({ hasTeamsContext, context
<ApproveFeature context={context} formKey={route.formKey} itemId={route.itemId} />
</Drawer>
)}
{/* Своя незавершённая заявка — та же панель, но с формой. Ввод здесь тоже
помечает состояние изменённым, поэтому обёртка ловит input/change. */}
{route.mode === 'edit' && route.formKey && route.itemId && (
<Drawer title={`Заявка №${route.itemId}`} onClose={closeEditDrawer}>
<div onInput={markFormDirty} onChange={markFormDirty}>
<EditFeature
context={context}
formKey={route.formKey}
itemId={route.itemId}
onClose={closeDrawer}
/>
</div>
</Drawer>
)}
</section>
);
};
@@ -0,0 +1,51 @@
import * as React from 'react';
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import styles from '../approve/ApproveFeature.module.scss';
import { getFormComponent } from '../../forms/registry';
import { REQUEST_TYPES } from '../../data/requests';
import { emitRequestsChanged } from '../../shared/requestEvents';
export interface IEditFeatureProps {
context: WebPartContext;
/** Ключ формы (тип заявки) из URL. */
formKey: string;
/** RowID редактируемой заявки из URL. */
itemId: number;
/** Закрыть панель (после сохранения). */
onClose: () => void;
}
// Фича «Редактирование»: открывает СВОЮ незавершённую заявку (черновик,
// возвращённую, отклонённую) в той же выезжающей панели, где обычно показывается
// просмотр. Рендерит ту же форму, что и подача, но с editId — форма подгружает
// существующую запись и сохраняет в неё же.
//
// Отдельно от features/submit намеренно: там форма живёт в потоке «плитки →
// новая заявка», а тут — точечное открытие конкретной записи по ссылке.
const EditFeature: React.FC<IEditFeatureProps> = ({ context, formKey, itemId, onClose }) => {
const FormComponent = getFormComponent(formKey);
const requestType = REQUEST_TYPES.filter((r) => r.id === formKey)[0];
if (!FormComponent || !requestType) {
return <div className={styles.state}>Для формы «{formKey}» редактирование не настроено.</div>;
}
return (
<div className={styles.content}>
<React.Suspense fallback={<div className={styles.state}>Загрузка формы…</div>}>
<FormComponent
requestType={requestType}
context={context}
editId={itemId}
onCancel={onClose}
onSaved={() => {
emitRequestsChanged();
onClose();
}}
/>
</React.Suspense>
</div>
);
};
export default EditFeature;
@@ -19,6 +19,13 @@ import styles from './RequestsTableView.module.scss';
const PAGE_SIZE = 20;
// Автообновление открытых таблиц: раз в 10 минут перечитываем данные, чтобы
// вкладка, оставленная открытой надолго, не показывала устаревший список.
// Обновление фоновое — строки с экрана не пропадают и перерисовываются, только
// если данные реально изменились (см. pageSignature).
const AUTO_REFRESH_MS = 10 * 60 * 1000;
export interface IRequestsTableViewProps {
context: WebPartContext;
/** 'approvals' — ждут решения текущего пользователя; 'own' — созданные им. */
@@ -239,9 +246,15 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
const unsubscribe = onRequestsChanged(() => {
load().catch(() => undefined);
});
// Пока вкладка браузера скрыта, обновляться незачем — при возврате к ней
// сработает ближайший тик.
const timer = window.setInterval(() => {
if (!document.hidden) load().catch(() => undefined);
}, AUTO_REFRESH_MS);
return () => {
cancelled = true;
unsubscribe();
window.clearInterval(timer);
};
}, [context, types, kind, debouncedQuery, page]);
@@ -11,6 +11,13 @@ import styles from './SearchView.module.scss';
const PAGE_SIZE = 20;
// Автообновление открытых таблиц: раз в 10 минут перечитываем данные, чтобы
// вкладка, оставленная открытой надолго, не показывала устаревший список.
// Обновление фоновое — строки с экрана не пропадают и перерисовываются, только
// если данные реально изменились (см. pageSignature).
const AUTO_REFRESH_MS = 10 * 60 * 1000;
export interface ISearchViewProps {
context: WebPartContext;
/** Клик по строке — открыть заявку (в выезжающей панели). */
@@ -169,9 +176,13 @@ export const SearchView: React.FC<ISearchViewProps> = ({ context, onOpen }) => {
const unsubscribe = onRequestsChanged(() => {
load().catch(() => undefined);
});
const timer = window.setInterval(() => {
if (!document.hidden) load().catch(() => undefined);
}, AUTO_REFRESH_MS);
return () => {
cancelled = true;
unsubscribe();
window.clearInterval(timer);
};
}, [context, types, debouncedQuery, page]);
@@ -28,6 +28,11 @@ const RECENT_MS = 10 * 60 * 1000;
// лимита пишем предупреждение в лог, а не молча обрезаем.
const SEARCH_ROW_LIMIT = 500;
// Сколько последних заявок автора дочитываем через REST в довесок к Search
// в разделе «Мои заявки» (см. getFreshOwnRowsForType). Это записи ОДНОГО
// пользователя, поэтому лимит с запасом; при упоре в него пишем предупреждение.
const OWN_REST_TOP = 200;
// Managed properties списка согласования. Имена включают группу колонок сайта
// (TansuSite) — SharePoint генерирует их так, поэтому «ожидаемого»
// ApproverOWSUSER в схеме поиска не находилось (разбирались 2026-08-06).
@@ -513,14 +518,33 @@ async function getFreshOwnRowsForType(context: WebPartContext, type: IRequestTyp
const me = await sp.web.currentUser.select('Id')();
const cutoff = new Date(Date.now() - RECENT_MS).toISOString();
// Фильтруем только по AuthorId, а «свежая или черновик» решаем в JS: статус
// в $filter не используем, потому что кириллица в сравнении там уже подводила
// (см. indexApprovalsForType). Берём последние OWN_REST_TOP заявок автора —
// это его собственные записи, их немного, и запрос ограничен по объёму.
const rows = (await sp.web
.getList(type.listId as string)
.items.filter(`AuthorId eq ${me.Id} and Created ge '${cutoff}'`)
.items.filter(`AuthorId eq ${me.Id}`)
.select('Id', 'Title', 'Status', 'Created', 'Author/EMail', 'Author/Title')
.expand('Author')
.top(50)()) as Array<Record<string, unknown>>;
.orderBy('Created', false)
.top(OWN_REST_TOP)()) as Array<Record<string, unknown>>;
return rows.map((r) => toMyRequest(r, r.Author as { EMail?: string; Title?: string } | undefined, type, 'own'));
if (rows.length === OWN_REST_TOP) {
console.warn(
`[Текущие заявки] «${type.name}»: REST-довесок упёрся в ${OWN_REST_TOP} заявок — более старые черновики сюда не попадут`
);
}
// Черновик берём ЛЮБОГО возраста: он живёт только у автора, правится часто и
// именно по нему индекс Search отстаёт заметнее всего, а увидеть свой
// черновик в «Моих заявках» пользователь ожидает сразу.
return rows
.filter((r) => {
const created = (r.Created as string) || '';
return r.Status === REQUEST_STATUS.draft || created >= cutoff;
})
.map((r) => toMyRequest(r, r.Author as { EMail?: string; Title?: string } | undefined, type, 'own'));
} catch (e) {
console.error(`[Текущие заявки] «${type.name}»: не удалось дочитать свежие заявки:`, (e as Error).message);
return [];
@@ -8,6 +8,7 @@ import { getRequestsByCategory, REQUEST_TYPES } from '../../data/requests';
import { getFormComponent } from '../../forms/registry';
import { IRequestType } from '../../models/types';
import { emitRequestsChanged } from '../../shared/requestEvents';
import { confirmDiscardFormChanges, markFormClean } from '../../shared/unsavedChanges';
export interface ISubmitFeatureProps {
context: WebPartContext;
@@ -43,7 +44,15 @@ const SubmitFeature: React.FC<ISubmitFeatureProps> = ({ context, activeCategoryI
const requests = getRequestsByCategory(activeCategoryId);
const handleBack = (): void => setSelectedRequest(null);
// Возврат к плиткам закрывает форму и теряет введённое (раздел остаётся
// смонтированным, но состояние формы живёт в самом FormComponent). Спрашиваем,
// если правки есть и они не сохранены; после согласия флаг снимаем — терять
// уже нечего.
const handleBack = (): void => {
if (!confirmDiscardFormChanges()) return;
markFormClean();
setSelectedRequest(null);
};
const renderSelected = (request: IRequestType): React.ReactNode => {
const FormComponent = getFormComponent(request.id);
@@ -1,5 +1,5 @@
import * as React from 'react';
import { useState, useMemo, useCallback } from 'react';
import { useState, useMemo, useCallback, useEffect } from 'react';
import styles from './RecruitingHireForm.module.scss';
import {
Alert,
@@ -20,21 +20,26 @@ import {
getPlannedMatrix,
REQUEST_STATUS,
isEditableStatus,
IApproverToWrite
IApproverToWrite,
APPROVAL_PHASE,
findUnassignedStep
} from '../../shared/approval';
import { uploadAttachments } from '../../shared/attachments/attachments.service';
import { IRequestFormProps } from '../../models/types';
import { IFormData, EMPTY_DATA, SetField } from './model';
import { saveHireRequest, hireApprovalService, HIRE_REQUEST_TYPE_ID, DATA_LIST_TITLE } from './submit';
import { loadHireRequest } from './load';
import { ApplicationSection } from './sections/ApplicationSection';
import { CandidateSection } from './sections/CandidateSection';
import { PpeSection } from './sections/PpeSection';
import { ConditionsSection } from './sections/ConditionsSection';
const RecruitingHireForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved }) => {
const RecruitingHireForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved, editId }) => {
const [data, setData] = useState<IFormData>(EMPTY_DATA);
const [files, setFiles] = useState<File[]>([]);
const [requestId, setRequestId] = useState<number | undefined>(undefined);
// При открытии на редактирование (editId) — сразу известен, иначе появится
// после первого сохранения.
const [requestId, setRequestId] = useState<number | undefined>(editId);
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
const submit = useRequestSubmit();
@@ -42,25 +47,68 @@ const RecruitingHireForm: React.FC<IRequestFormProps> = ({ requestType, context,
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
// Открыта СВОЯ заявка на редактирование — подгружаем её содержимое и статус.
useEffect(() => {
if (!editId) {
return;
}
let alive = true;
loadHireRequest(editId)
.then((loaded) => {
if (alive) {
setData(loaded.data);
setRequestStatus(loaded.status);
}
})
.catch((e) => {
if (alive) {
submit.setError(`Не удалось загрузить заявку №${editId}: ${(e as Error).message}`);
}
});
return () => {
alive = false;
};
}, [editId]);
// Маршрут согласования (планируемый) резолвится по email инициатора — текущего
// пользователя (кандидата ещё нет в системе).
// пользователя (кандидата ещё нет в системе). У заявки, открытой на
// редактирование, маршрут читается из уже записанных строк — планирование
// затёрло бы правки, сделанные при первом сохранении.
const approval = useMemo(() => hireApprovalService(), []);
const userEmail = context.pageContext.user.email;
const loadMatrix = useCallback(
() => getPlannedMatrix(context, HIRE_REQUEST_TYPE_ID, userEmail, approval, 'Approval'),
[context, userEmail, approval]
() =>
editId
? approval
.getMatrixForRequest(editId)
.then((rows) => rows.filter((r) => r.phase !== APPROVAL_PHASE.execution))
: getPlannedMatrix(context, HIRE_REQUEST_TYPE_ID, userEmail, approval, 'Approval'),
[context, userEmail, approval, editId]
);
const matrix = useMatrixEditor(loadMatrix, userEmail, !readOnly, true, (login) =>
approval.getJobTitle(login)
const matrix = useMatrixEditor(
loadMatrix,
`${userEmail}-${editId ?? 'new'}`,
!readOnly,
true,
(login) => approval.getJobTitle(login)
);
// Фаза исполнения: исполнители из маршрута (status='Execution'), только для чтения.
const loadExecutors = useCallback(
() => getPlannedMatrix(context, HIRE_REQUEST_TYPE_ID, userEmail, approval, 'Execution'),
[context, userEmail, approval]
() =>
editId
? approval
.getMatrixForRequest(editId)
.then((rows) => rows.filter((r) => r.phase === APPROVAL_PHASE.execution))
: getPlannedMatrix(context, HIRE_REQUEST_TYPE_ID, userEmail, approval, 'Execution'),
[context, userEmail, approval, editId]
);
const executors = useMatrixEditor(loadExecutors, userEmail, false, true, (login) =>
approval.getJobTitle(login)
const executors = useMatrixEditor(
loadExecutors,
`${userEmail}-${editId ?? 'new'}`,
false,
true,
(login) => approval.getJobTitle(login)
);
const isValid = data.CandidateName.trim().length > 0 && data.Position.trim().length > 0;
@@ -68,7 +116,14 @@ const RecruitingHireForm: React.FC<IRequestFormProps> = ({ requestType, context,
isValid ? undefined : 'Заполните обязательные поля: Ф.И.О. кандидата, Должность.';
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
rows.map((r) => ({ email: r.email, position: r.position, allowReassign: r.allowReassign }));
// order обязателен: параллельные шаги делят один номер, по позиции в
// массиве его не восстановить (см. useMatrixEditor/withOrders).
rows.map((r) => ({
email: r.email,
position: r.position,
allowReassign: r.allowReassign,
order: r.order,
}));
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
const id = await saveHireRequest(
@@ -89,10 +144,28 @@ const RecruitingHireForm: React.FC<IRequestFormProps> = ({ requestType, context,
}
};
// На отправку (в отличие от черновика) маршрут должен быть полностью
// укомплектован — иначе шаг без назначенного человека молча пропадёт при
// записи в SharePoint (createSteps не может записать Person-поле без
// значения), и согласующие в середине маршрута просто не увидят заявку.
const validateSubmit = (): string | undefined => {
const formError = validate();
if (formError) return formError;
const unassigned = findUnassignedStep(matrix.rows);
if (unassigned) {
return `Шаг ${unassigned.order} маршрута согласования («${unassigned.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`;
}
const unassignedExecutor = findUnassignedStep(executors.rows);
if (unassignedExecutor) {
return `Шаг ${unassignedExecutor.order} исполнения («${unassignedExecutor.position || 'без должности'}») без назначенного человека — выберите исполнителя или удалите шаг.`;
}
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), validate);
submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
const sectionProps = { data, set, context };
@@ -15,6 +15,7 @@ import { navigate } from '../../shared/routing';
import { getAttachments, IAttachmentInfo } from '../../shared/attachments/attachments.service';
import { IFormData, EMPTY_DATA, SetField } from './model';
import { loadHireRequest } from './load';
import { confirmDiscardFormChanges } from '../../shared/unsavedChanges';
import { hireApprovalService, DATA_LIST_TITLE } from './submit';
import { ApplicationSection } from './sections/ApplicationSection';
import { CandidateSection } from './sections/CandidateSection';
@@ -121,9 +122,13 @@ const RecruitingHireView: React.FC<IRecruitingHireViewProps> = ({ context, itemI
<div className={`${styles.toolbar} rp-no-print`}>
<Button
variant="secondary"
onClick={() =>
navigate({ mode: 'create', nav: 'new', formKey: WORKPLACE_FORM_KEY, sourceId: itemId })
}
onClick={() => {
// Раздел «Новая заявка» остаётся смонтированным при переключении
// вкладок, но переход «на основе» пересоздаёт форму — если там
// остались несохранённые правки, спрашиваем перед их потерей.
if (!confirmDiscardFormChanges()) return;
navigate({ mode: 'create', nav: 'new', formKey: WORKPLACE_FORM_KEY, sourceId: itemId });
}}
>
<Icon name="copy" size="sm" />
Организация рабочего места на основе этой
@@ -20,7 +20,9 @@ import {
getPlannedMatrix,
REQUEST_STATUS,
isEditableStatus,
IApproverToWrite
IApproverToWrite,
APPROVAL_PHASE,
findUnassignedStep
} from '../../shared/approval';
import { uploadAttachments } from '../../shared/attachments/attachments.service';
import { IRequestFormProps } from '../../models/types';
@@ -32,14 +34,16 @@ import {
DATA_LIST_TITLE
} from './submit';
import { loadPrefillFromHire } from './prefill';
import { loadWorkplaceRequest } from './load';
import { EmployeeSection } from './sections/EmployeeSection';
import { EquipmentSection } from './sections/EquipmentSection';
const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved, sourceId }) => {
const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved, sourceId, editId }) => {
const [data, setData] = useState<IFormData>(EMPTY_DATA);
const [files, setFiles] = useState<File[]>([]);
// Id и статус текущей заявки: заполняются после первого сохранения.
const [requestId, setRequestId] = useState<number | undefined>(undefined);
// Id и статус текущей заявки: заполняются после первого сохранения, а при
// открытии на редактирование (editId) — сразу из загруженной записи.
const [requestId, setRequestId] = useState<number | undefined>(editId);
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
const submit = useRequestSubmit();
@@ -48,6 +52,31 @@ const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context,
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
// Открыта СВОЯ заявка на редактирование — подгружаем её содержимое и статус.
// От предзаполнения «на основе» (ниже) отличается тем, что это та же запись:
// сохранение уйдёт в неё, а не создаст новую.
useEffect(() => {
if (!editId) {
return;
}
let alive = true;
loadWorkplaceRequest(editId)
.then((loaded) => {
if (alive) {
setData(loaded.data);
setRequestStatus(loaded.status);
}
})
.catch((e) => {
if (alive) {
submit.setError(`Не удалось загрузить заявку №${editId}: ${(e as Error).message}`);
}
});
return () => {
alive = false;
};
}, [editId]);
// Предзаполнение из «Заявки на прием», если форма открыта «на основе» (rpsource).
useEffect(() => {
if (!sourceId) {
@@ -72,19 +101,42 @@ const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context,
const approval = useMemo(() => workplaceApprovalService(), []);
const userEmail = context.pageContext.user.email;
// У новой заявки маршрут ПЛАНИРУЕТСЯ (resolve по внешнему API), у открытой на
// редактирование — читается из уже записанных строк: их могли поправить
// вручную при первом сохранении, и планирование затёрло бы эти правки.
const loadMatrix = useCallback(
() => getPlannedMatrix(context, WORKPLACE_REQUEST_TYPE_ID, userEmail, approval, 'Approval'),
[context, userEmail, approval]
() =>
editId
? approval
.getMatrixForRequest(editId)
.then((rows) => rows.filter((r) => r.phase !== APPROVAL_PHASE.execution))
: getPlannedMatrix(context, WORKPLACE_REQUEST_TYPE_ID, userEmail, approval, 'Approval'),
[context, userEmail, approval, editId]
);
const matrix = useMatrixEditor(
loadMatrix,
`${userEmail}-${editId ?? 'new'}`,
!readOnly,
true,
(login) => approval.getJobTitle(login)
);
const matrix = useMatrixEditor(loadMatrix, userEmail, !readOnly, true, (login) => approval.getJobTitle(login));
// Фаза исполнения: исполнители из маршрута (status='Execution'), только для чтения.
const loadExecutors = useCallback(
() => getPlannedMatrix(context, WORKPLACE_REQUEST_TYPE_ID, userEmail, approval, 'Execution'),
[context, userEmail, approval]
() =>
editId
? approval
.getMatrixForRequest(editId)
.then((rows) => rows.filter((r) => r.phase === APPROVAL_PHASE.execution))
: getPlannedMatrix(context, WORKPLACE_REQUEST_TYPE_ID, userEmail, approval, 'Execution'),
[context, userEmail, approval, editId]
);
const executors = useMatrixEditor(loadExecutors, userEmail, false, true, (login) =>
approval.getJobTitle(login)
const executors = useMatrixEditor(
loadExecutors,
`${userEmail}-${editId ?? 'new'}`,
false,
true,
(login) => approval.getJobTitle(login)
);
const isValid = data.FullName.trim().length > 0 && data.Position.trim().length > 0;
@@ -92,7 +144,14 @@ const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context,
isValid ? undefined : 'Заполните обязательные поля: Ф.И.О., Должность.';
const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
rows.map((r) => ({ email: r.email, position: r.position, allowReassign: r.allowReassign }));
// order обязателен: параллельные шаги делят один номер, по позиции в
// массиве его не восстановить (см. useMatrixEditor/withOrders).
rows.map((r) => ({
email: r.email,
position: r.position,
allowReassign: r.allowReassign,
order: r.order,
}));
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
const id = await saveWorkplaceRequest(
@@ -114,10 +173,28 @@ const WorkplaceSetupForm: React.FC<IRequestFormProps> = ({ requestType, context,
}
};
// На отправку (в отличие от черновика) маршрут должен быть полностью
// укомплектован — иначе шаг без назначенного человека молча пропадёт при
// записи в SharePoint (createSteps не может записать Person-поле без
// значения), и согласующие в середине маршрута просто не увидят заявку.
const validateSubmit = (): string | undefined => {
const formError = validate();
if (formError) return formError;
const unassigned = findUnassignedStep(matrix.rows);
if (unassigned) {
return `Шаг ${unassigned.order} маршрута согласования («${unassigned.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`;
}
const unassignedExecutor = findUnassignedStep(executors.rows);
if (unassignedExecutor) {
return `Шаг ${unassignedExecutor.order} исполнения («${unassignedExecutor.position || 'без должности'}») без назначенного человека — выберите исполнителя или удалите шаг.`;
}
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), validate);
submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
const sectionProps = { data, set, context };
@@ -37,4 +37,11 @@ export interface IRequestFormProps {
* Формы, не поддерживающие производные заявки, игнорируют.
*/
sourceId?: number;
/**
* Id СВОЕЙ заявки, открытой на редактирование (черновик / возвращённая /
* отклонённая). В отличие от sourceId это не предзаполнение новой заявки, а
* та же самая запись: сохранение обновляет её, а не создаёт новую, и маршрут
* согласования читается из уже записанных строк, а не планируется заново.
*/
editId?: number;
}
@@ -63,11 +63,28 @@ export class ApprovalListService {
phase: string = APPROVAL_PHASE.approval,
orderStart: number = 1
): Promise<void> {
const withOrder = approvers
.map((a, i) => ({ a, order: a.order ?? orderStart + i }))
.filter((x) => !!x.a.email);
// orderStart — СМЕЩЕНИЕ фазы: у согласующих оно 1, у исполнителей начинается
// после последнего согласующего (обе фазы живут в одном списке и делят
// сквозную нумерацию). a.order — номер шага ВНУТРИ фазы (1..N), и у
// параллельных шагов он совпадает, поэтому нумеровать по позиции в массиве
// нельзя. Без a.order падаем на позицию — для вызовов, где параллельности нет.
const withOrder = approvers.map((a, i) => ({ a, order: orderStart - 1 + (a.order ?? i + 1) }));
for (const { a, order } of withOrder) {
// Строку без email в SharePoint не записать (Person-поле обязательного
// значения) — раньше такие шаги пропадали отсюда молча, и согласующие в
// середине маршрута просто не получали заявку (см. findUnassignedStep —
// это должно было быть отловлено валидацией ДО вызова createSteps; лог
// здесь — на случай, если её обошли, например прямым вызовом сервиса).
const missing = withOrder.filter((x) => !x.a.email);
if (missing.length > 0) {
console.error(
`[Согласование] createSteps: пропущены шаги без назначенного человека (order ${missing
.map((x) => x.order)
.join(', ')}) — заявка №${requestId}`
);
}
for (const { a, order } of withOrder.filter((x) => !!x.a.email)) {
const approverId = await this.resolveUserId(a.email);
await this.list().items.add({
Title: a.position || a.email,
@@ -165,6 +182,12 @@ export class ApprovalListService {
}
// Строки согласования для отображения матрицы (ФИО, должность, статус, дата, комментарий).
//
// Approver/EMail нужен не только для показа: при редактировании черновика
// (см. useMatrixEditor с editable=true в WorkplaceSetupForm/RecruitingHireForm)
// это ЕДИНСТВЕННЫЙ источник email для уже существующих строк — без него
// findUnassignedStep решает, что назначенного человека нет, хотя он есть
// (баг: пропущенный email тут выглядел так же, как реально пустой шаг).
public async getMatrixForRequest(requestId: number): Promise<IMatrixRow[]> {
const rows = (await this.list()
.items.filter(`${FIELDS.ticket}Id eq ${requestId}`)
@@ -177,17 +200,18 @@ export class ApprovalListService {
FIELDS.order,
FIELDS.allowReassign,
FIELDS.phase,
`${FIELDS.approver}/Title`
`${FIELDS.approver}/Title`,
`${FIELDS.approver}/EMail`
)
.expand(FIELDS.approver)
.orderBy(FIELDS.order, true)()) as Array<Record<string, unknown>>;
return rows.map((r, i) => {
const approver = r[FIELDS.approver] as { Title?: string } | undefined;
const approver = r[FIELDS.approver] as { Title?: string; EMail?: string } | undefined;
return {
order: (r[FIELDS.order] as number) ?? i + 1,
who: approver?.Title || '',
email: '',
email: approver?.EMail || '',
position: (r.Title as string) || '',
status: (r[FIELDS.status] as string) || '',
date: this.formatDate((r[FIELDS.date] as string) || ''),
@@ -76,13 +76,24 @@ export async function writeRoute(
const submitted = status === REQUEST_STATUS.onApproval;
const rowStatus = submitted ? REQUEST_STATUS.queued : status;
// Смещение фазы исполнения — по МАКСИМАЛЬНОМУ номеру шага согласующих, а не по
// их количеству: при параллельных шагах несколько согласующих делят один номер,
// поэтому approvers.length больше последнего реального шага (три согласующих,
// из которых двое параллельны, — это шаги 1 и 2, а не 1..3). На очередь это не
// влияет (activateNextQueued берёт минимальный order среди ждущих, разрывы ему
// безразличны) — но нумерация шагов в таблице «Исполнение» шла бы с пропуском.
const lastApprovalStep = approvers.reduce(
(max, a, i) => Math.max(max, a.order ?? i + 1),
0
);
await approval.createSteps(requestId, approvers, rowStatus, APPROVAL_PHASE.approval, 1);
await approval.createSteps(
requestId,
executors,
rowStatus,
APPROVAL_PHASE.execution,
approvers.length + 1
lastApprovalStep + 1
);
if (submitted) {
@@ -24,7 +24,7 @@ export type { IApproverToWrite } from './approvalList.service';
export { ApproverService } from './approverDecision.service';
export type { ApproverDecision } from './approverDecision.service';
export { getPlannedMatrix, writeApprovers, writeRoute } from './approvalSubmission.service';
export { useMatrixEditor } from './useMatrixEditor';
export { useMatrixEditor, findUnassignedStep } from './useMatrixEditor';
export type { IUseMatrixEditor } from './useMatrixEditor';
export { ApprovalMatrix } from './ui/ApprovalMatrix';
export { UserPicker } from './ui/UserPicker';
@@ -9,4 +9,10 @@ export interface IMatrixRow {
comment: string;
allowReassign: boolean; // может ли этот согласующий добавить делеганта
phase?: string; // фаза строки: «Согласование» | «Исполнение» (см. APPROVAL_PHASE)
// Шаг идёт ОДНОВРЕМЕННО с предыдущим (у обоих одинаковый order — так
// activateNextQueued активирует их вместе). У первой строки всегда false.
// При загрузке выводится из совпадения order с предыдущей строкой, при
// редактировании — переключается кнопкой и заново раздаёт order (см.
// useMatrixEditor/withOrders).
parallelWithPrev?: boolean;
}
@@ -28,7 +28,22 @@ export const ApprovalMatrix: React.FC<IApprovalMatrixProps> = ({
emptyText = 'Согласующие не заданы.',
pickerPlaceholder = 'Добавить согласующего: начните вводить ФИО…',
}) => {
const { rows, loading, error, editable } = editor;
const { rows, loading, error, editable, blocks } = editor;
// Строка → шаг, которому она принадлежит. Нужно, чтобы отрисовать ячейку
// «Шаг» один раз на весь шаг (rowSpan) и понять, можно ли двигать его выше/ниже.
const blockByRow: Array<{ index: number; start: number; size: number }> = [];
blocks.forEach((b, bi) => {
for (let i = b.start; i <= b.end; i += 1) {
blockByRow[i] = { index: bi, start: b.start, size: b.end - b.start + 1 };
}
});
// Пока по маршруту не принято ни одного решения (заявка не отправлена на
// согласование — черновик, доработка), колонки «Статус» и «Дата» пустые у всех
// строк: показывать столбец из одних прочерков смысла нет. Как только
// появляется первое решение — колонки возвращаются.
const hasDecisions = rows.some((r) => (r.status && r.status !== '—') || r.date);
return (
<div className={styles.matrixWrap}>
@@ -42,39 +57,49 @@ export const ApprovalMatrix: React.FC<IApprovalMatrixProps> = ({
<table className={styles.matrix}>
<thead>
<tr>
<th className={styles.matrixStepCol}>Шаг</th>
<th>{roleLabel}</th>
<th>Должность</th>
<th>Статус</th>
<th>Дата</th>
{hasDecisions && <th>Статус</th>}
{hasDecisions && <th>Дата</th>}
{editable && <th />}
{editable && <th />}
</tr>
</thead>
<tbody>
{rows.map((r, i) => (
<tr key={i}>
{rows.map((r, i) => {
const block = blockByRow[i];
// Ячейка «Шаг» рисуется один раз на весь шаг и растягивается на его
// строки. Кнопки перемещения живут в ней же: двигать параллельные
// строки поодиночке бессмысленно — шаг переезжает целиком.
const isBlockStart = block.start === i;
return (
<tr key={i} className={block.size > 1 ? styles.parallelRow : undefined}>
{isBlockStart && (
<td className={styles.matrixStepCol} rowSpan={block.size}>
<span className={styles.stepNo}>{r.order}</span>
</td>
)}
<td>{r.who}</td>
<td>{r.position}</td>
{hasDecisions && (
<td>{r.status && r.status !== '—' ? <StatusBadge status={r.status} /> : '—'}</td>
<td>{r.date}</td>
)}
{hasDecisions && <td>{r.date}</td>}
{editable && (
<td className={styles.matrixActions}>
<button
type="button"
className={styles.iconBtn}
className={`${styles.iconBtn} ${r.parallelWithPrev ? styles.iconBtnActive : ''}`}
disabled={i === 0}
onClick={() => editor.moveUp(i)}
title="Выше"
onClick={() => editor.toggleParallel(i)}
title={
r.parallelWithPrev
? 'Отцепить: выполнять после предыдущего шага'
: 'Объединить: выполнять одновременно с предыдущим шагом'
}
>
<Icon name="chevron-down" size="sm" className={styles.flipY} />
</button>
<button
type="button"
className={styles.iconBtn}
disabled={i === rows.length - 1}
onClick={() => editor.moveDown(i)}
title="Ниже"
>
<Icon name="chevron-down" size="sm" />
<Icon name="user-check" size="sm" />
</button>
<button
type="button"
@@ -86,8 +111,33 @@ export const ApprovalMatrix: React.FC<IApprovalMatrixProps> = ({
</button>
</td>
)}
{/* Перемещение — одно на весь шаг: параллельные строки
переезжают вместе, поэтому ячейка объединена по rowSpan. */}
{editable && isBlockStart && (
<td className={styles.matrixBlockMove} rowSpan={block.size}>
<button
type="button"
className={styles.iconBtn}
disabled={block.index === 0}
onClick={() => editor.moveBlockUp(i)}
title="Шаг выше"
>
<Icon name="chevron-down" size="sm" className={styles.flipY} />
</button>
<button
type="button"
className={styles.iconBtn}
disabled={block.index === blocks.length - 1}
onClick={() => editor.moveBlockDown(i)}
title="Шаг ниже"
>
<Icon name="chevron-down" size="sm" />
</button>
</td>
)}
</tr>
))}
);
})}
</tbody>
</table>
)}
@@ -115,6 +115,7 @@
.matrixActions {
display: flex;
align-items: center;
gap: $sp-1;
justify-content: flex-end;
}
@@ -151,6 +152,55 @@
}
}
// Включённый режим-переключатель (шаг помечен как параллельный) — в отличие от
// остальных кнопок это состояние, а не разовое действие, поэтому оно залито.
.iconBtnActive {
border-color: $gold-500;
background: $gold-500;
color: $navy-950;
&:hover:not(:disabled) {
border-color: $gold-600;
background: $gold-600;
color: $navy-950;
}
}
// Колонка с номером шага. Объединяется по вертикали (rowSpan) на все строки
// одного шага, поэтому содержимое центрируем — иначе номер и кнопки прижимались
// бы к верхней строке блока.
.matrixStepCol {
width: 48px;
white-space: nowrap;
vertical-align: middle;
}
.stepNo {
font-weight: 600;
color: $navy-700;
}
// Перемещение шага целиком — тоже объединённая по вертикали ячейка, поэтому
// кнопки центрируем относительно всего блока.
// Та же flex-раскладка, что и у .matrixActions — иначе кнопки здесь (обычные
// инлайновые элементы) выравниваются по baseline и «прыгают» относительно
// кнопок соседней колонки, которая уже flex-контейнер.
.matrixBlockMove {
display: flex;
align-items: center;
justify-content: flex-end;
gap: $sp-1;
width: 64px;
white-space: nowrap;
}
// Строки, входящие в шаг из нескольких параллельных согласующих — лёгкая
// заливка, чтобы блок читался как единое целое (границы ячейки «Шаг» его уже
// объединяют, но без фона строки визуально распадаются).
.parallelRow > td {
background: rgba($gold-500, .06);
}
.flipY {
transform: scaleY(-1);
}
@@ -8,15 +8,84 @@ export interface IUseMatrixEditor {
error: string | undefined;
editable: boolean;
addApprover: (user: ISiteUser) => void;
moveUp: (index: number) => void;
moveDown: (index: number) => void;
/** Переместить ШАГ целиком (вместе со всеми параллельными строками) выше/ниже. */
moveBlockUp: (index: number) => void;
moveBlockDown: (index: number) => void;
remove: (index: number) => void;
/** Переключить «идёт параллельно с предыдущим шагом». Для первой строки — no-op. */
toggleParallel: (index: number) => void;
/** Границы шагов: индексы строк, объединённых общим order. */
blocks: IMatrixBlock[];
}
function swap(rows: IMatrixRow[], a: number, b: number): IMatrixRow[] {
const next = [...rows];
[next[a], next[b]] = [next[b], next[a]];
return next;
/** Один шаг маршрута: одна строка либо несколько параллельных (общий order). */
export interface IMatrixBlock {
start: number;
end: number;
}
// Разбивает строки на шаги: новый шаг начинается там, где нет флага
// parallelWithPrev. Используется и для перемещения (двигаем шаг целиком), и для
// отрисовки (одна ячейка «Шаг» на все строки шага, см. ApprovalMatrix/rowSpan).
export function blockRanges(rows: IMatrixRow[]): IMatrixBlock[] {
const ranges: IMatrixBlock[] = [];
rows.forEach((r, i) => {
if (i === 0 || !r.parallelWithPrev) ranges.push({ start: i, end: i });
else ranges[ranges.length - 1].end = i;
});
return ranges;
}
// Индекс шага, которому принадлежит строка (-1 — не найдено).
function blockIndexOf(ranges: IMatrixBlock[], row: number): number {
for (let i = 0; i < ranges.length; i += 1) {
if (row >= ranges[i].start && row <= ranges[i].end) return i;
}
return -1;
}
// Меняет местами два СОСЕДНИХ шага целиком. Флаги parallelWithPrev внутри шага
// остаются верными сами собой: у первой строки шага флаг снят, у остальных —
// стоит, а порядок строк внутри шага не меняется.
function swapBlocks(rows: IMatrixRow[], a: IMatrixBlock, b: IMatrixBlock): IMatrixRow[] {
return [
...rows.slice(0, a.start),
...rows.slice(b.start, b.end + 1),
...rows.slice(a.start, a.end + 1),
...rows.slice(b.end + 1),
];
}
// Раздаёт order по флагу parallelWithPrev: у параллельных шагов order общий с
// предыдущим, у последовательных — на единицу больше. Вызывается после КАЖДОГО
// изменения состава/порядка, иначе order разъедется с тем, что видно на экране.
// Первая строка параллельной быть не может — ей всегда достаётся order 1.
function withOrders(rows: IMatrixRow[]): IMatrixRow[] {
let order = 0;
return rows.map((r, i) => {
const parallel = i > 0 && !!r.parallelWithPrev;
if (!parallel) order += 1;
return { ...r, order, parallelWithPrev: parallel };
});
}
// Обратное преобразование для загруженных строк: одинаковый order у соседей
// означает параллельный шаг.
function markParallel(rows: IMatrixRow[]): IMatrixRow[] {
return rows.map((r, i) => ({
...r,
parallelWithPrev: i > 0 && r.order === rows[i - 1].order,
}));
}
// Первый шаг без назначенного человека (email пуст) — обычно шаг маршрута,
// который внешний approval-route API вернул как роль без привязанного
// исполнителя. Писать такую строку в SharePoint нельзя (Person-поле требует
// значение) — approvalList.service.ts/createSteps молча пропускает её при
// записи, поэтому перед отправкой это нужно поймать здесь и не дать заявке уйти
// на согласование с пропущенным шагом (см. RecruitingHireForm/WorkplaceSetupForm).
export function findUnassignedStep(rows: IMatrixRow[]): IMatrixRow | undefined {
return rows.filter((r) => !r.email).sort((a, b) => a.order - b.order)[0];
}
/**
@@ -45,7 +114,7 @@ export function useMatrixEditor(
load()
.then((r) => {
if (!active) return;
setRows(r);
setRows(markParallel(r));
setError(undefined);
setLoading(false);
})
@@ -65,7 +134,7 @@ export function useMatrixEditor(
setRows((prev) => {
if (user.email && prev.some((r) => r.email === user.email)) return prev;
const row: IMatrixRow = {
order: prev.length + 1,
order: 0, // проставит withOrders
who: user.name,
email: user.email,
position,
@@ -73,8 +142,9 @@ export function useMatrixEditor(
date: '',
comment: '',
allowReassign: false,
parallelWithPrev: false,
};
return [...prev, row];
return withOrders([...prev, row]);
});
};
@@ -85,10 +155,42 @@ export function useMatrixEditor(
.catch(() => appendUser(user, ''));
};
const moveUp = (i: number): void => setRows((prev) => (i <= 0 ? prev : swap(prev, i, i - 1)));
const moveDown = (i: number): void =>
setRows((prev) => (i >= prev.length - 1 ? prev : swap(prev, i, i + 1)));
const remove = (i: number): void => setRows((prev) => prev.filter((_, idx) => idx !== i));
const moveBlockUp = (i: number): void =>
setRows((prev) => {
const ranges = blockRanges(prev);
const bi = blockIndexOf(ranges, i);
if (bi <= 0) return prev;
return withOrders(swapBlocks(prev, ranges[bi - 1], ranges[bi]));
});
return { rows, loading, error, editable, addApprover, moveUp, moveDown, remove };
const moveBlockDown = (i: number): void =>
setRows((prev) => {
const ranges = blockRanges(prev);
const bi = blockIndexOf(ranges, i);
if (bi < 0 || bi >= ranges.length - 1) return prev;
return withOrders(swapBlocks(prev, ranges[bi], ranges[bi + 1]));
});
const remove = (i: number): void =>
setRows((prev) => withOrders(prev.filter((_, idx) => idx !== i)));
const toggleParallel = (i: number): void =>
setRows((prev) =>
i <= 0
? prev
: withOrders(prev.map((r, idx) => (idx === i ? { ...r, parallelWithPrev: !r.parallelWithPrev } : r)))
);
return {
rows,
loading,
error,
editable,
addApprover,
moveBlockUp,
moveBlockDown,
remove,
toggleParallel,
blocks: blockRanges(rows),
};
}
+11 -5
View File
@@ -20,7 +20,9 @@ import * as React from 'react';
// перезагрузки страницы. useRoute() подписан и на popstate (кнопка «назад»),
// и на её собственное событие, поэтому реагирует на оба способа смены URL.
export type PortalMode = 'submit' | 'approve' | 'create';
// 'edit' — открыть СВОЮ незавершённую заявку (черновик / возвращённую /
// отклонённую) на редактирование в той же выезжающей панели, что и просмотр.
export type PortalMode = 'submit' | 'approve' | 'create' | 'edit';
/** Раздел бокового меню. */
export type NavSection = 'new' | 'approvals' | 'own' | 'search';
@@ -29,9 +31,9 @@ export interface IRoute {
mode: PortalMode;
/** Раздел бокового меню; сохраняется и когда поверх открыта заявка. */
nav: NavSection;
/** Ключ формы (тип заявки) — для 'approve' и 'create'. */
/** Ключ формы (тип заявки) — для 'approve', 'edit' и 'create'. */
formKey?: string;
/** Id заявки в списке данных — для 'approve'. */
/** Id заявки в списке данных — для 'approve' и 'edit'. */
itemId?: number;
/** Id исходной заявки для предзаполнения — для 'create' (напр. орг. места на основе прием). */
sourceId?: number;
@@ -59,6 +61,10 @@ export function parseRoute(search: string = window.location.search): IRoute {
if (mode === 'approve' && formKey && itemId && !isNaN(itemId)) {
return { mode: 'approve', nav, formKey, itemId };
}
// Редактирование собственной незавершённой заявки — та же панель, но с формой.
if (mode === 'edit' && formKey && itemId && !isNaN(itemId)) {
return { mode: 'edit', nav, formKey, itemId };
}
// Создание производной заявки с предзаполнением из исходной.
if (formKey && sourceId && !isNaN(sourceId)) {
return { mode: 'create', nav: 'new', formKey, sourceId };
@@ -78,8 +84,8 @@ function buildQuery(route: IRoute): string {
if (route.nav !== 'new') {
params.set('rpnav', route.nav);
}
if (route.mode === 'approve' && route.formKey && route.itemId) {
params.set('rpmode', 'approve');
if ((route.mode === 'approve' || route.mode === 'edit') && route.formKey && route.itemId) {
params.set('rpmode', route.mode);
params.set('rptype', route.formKey);
params.set('rpid', String(route.itemId));
} else if (route.mode === 'create' && route.formKey && route.sourceId) {
@@ -0,0 +1,33 @@
// Есть ли в открытой форме «Новая заявка» правки, которые ещё не сохранены.
//
// Нужно, потому что раздел «Новая заявка» держится смонтированным при
// переключении вкладок (см. RequestPortal.tsx), и единственное, что реально
// пересоздаёт форму, — переход «создать на основе». Перед ним и спрашиваем,
// но только если терять действительно есть что.
//
// Флаг ставится по факту пользовательского ввода (событие input/change из
// раздела формы — см. RequestPortal), а снимается после сохранения: черновик
// тоже считается сохранением, форма зовёт onSaved и в обоих случаях
// («Сохранить черновик» и «Отправить»), см. forms/*/Form.tsx.
let dirty = false;
export function markFormDirty(): void {
dirty = true;
}
export function markFormClean(): void {
dirty = false;
}
export function hasUnsavedFormChanges(): boolean {
return dirty;
}
// Спросить подтверждение, если несохранённые правки есть. true — можно
// продолжать (правок нет либо пользователь согласился их потерять).
export function confirmDiscardFormChanges(): boolean {
if (!dirty) return true;
return window.confirm(
'В открытой форме «Новая заявка» есть несохранённые изменения — они будут потеряны. Продолжить?'
);
}