Compare commits
5 Commits
b3dee2047c
...
435aceb83f
| Author | SHA1 | Date | |
|---|---|---|---|
| 435aceb83f | |||
| 0b7729a6b9 | |||
| 179999c02a | |||
| 2d2194047b | |||
| 467ceb0d48 |
+2
-2
@@ -45,8 +45,8 @@
|
|||||||
| [`recruiting-referral`](../src/webparts/requestPortal/forms/Referral/README.md) | Реферальная рекомендация | Рекрутинг | да | да | да | кандидат — внешний (текстовые поля, не People); маршрут по рекомендателю; исполнитель переназначает на реального; условное уточнение «откуда знаете» | ✅ |
|
| [`recruiting-referral`](../src/webparts/requestPortal/forms/Referral/README.md) | Реферальная рекомендация | Рекрутинг | да | да | да | кандидат — внешний (текстовые поля, не People); маршрут по рекомендателю; исполнитель переназначает на реального; условное уточнение «откуда знаете» | ✅ |
|
||||||
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
|
| [`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 (согласовано/сразу без согласования — рабочий бакет, отклонено — отдельный бакет) | ✅ |
|
| [`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» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД), сумма обучения | ✅ |
|
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker) либо создаётся сам по согласованному «Заявлению на увольнение»; условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД); 6 независимых пар «сумма к списанию + комментарий» (ОС, СИЗ, подотчётная сумма, обучение, НМА, ТМЦ) — вводит любой активный согласующий, блокируется навсегда после первого ввода | ✅ |
|
||||||
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | по умолчанию на себя, но можно за другого; подразделение из профиля (read-only), должность/организация из справочника; последний рабочий день не в прошлом; **после согласования сам создаёт обходной лист** и связывает пару ссылками | ⏳ тип заявки не заведён в админке approval-route |
|
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | совместители — таблица компаний с удалением строки (снимает и согласующего из матрицы); должность/организация из справочника; **после согласования сам создаёт обходной лист**; печать заблокирована до согласования обходного листа; «Лицо, принимающее ОС/НМА» — заполняет только непосредственный руководитель | ✅ |
|
||||||
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
||||||
|
|
||||||
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
||||||
|
|||||||
@@ -421,6 +421,12 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
|
|||||||
? undefined
|
? undefined
|
||||||
: (partial: IPage): void => {
|
: (partial: IPage): void => {
|
||||||
if (cancelled) return;
|
if (cancelled) return;
|
||||||
|
// ПУСТОЙ промежуточный результат не показываем: смысл onPartial —
|
||||||
|
// не держать экран пустым, пока отвечает более медленный источник,
|
||||||
|
// а пустая страница как раз пустой экран и даёт, только вместо
|
||||||
|
// «Загрузка…» на нём появляется «Вы ещё не создавали заявок» —
|
||||||
|
// и через мгновение исчезает, когда придёт второй источник.
|
||||||
|
if (partial.rows.length === 0) return;
|
||||||
setRows(partial.rows);
|
setRows(partial.rows);
|
||||||
setTotalRows(partial.totalRows);
|
setTotalRows(partial.totalRows);
|
||||||
};
|
};
|
||||||
@@ -477,6 +483,18 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
|
|||||||
const q = debouncedQuery.trim();
|
const q = debouncedQuery.trim();
|
||||||
const total = totalRows;
|
const total = totalRows;
|
||||||
const visible = rows || [];
|
const visible = rows || [];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Можно ли уже судить о содержимом таблицы.
|
||||||
|
*
|
||||||
|
* Пустоту («Вы ещё не создавали заявок») объявляем ТОЛЬКО по завершённой
|
||||||
|
* загрузке именно ЭТОЙ таблицы (loadedKey), а не по любому пустому rows: до
|
||||||
|
* этого rows может быть пустым по совершенно другой причине — часть источников
|
||||||
|
* ещё в пути (см. onPartial выше, «Мои заявки» собираются из Search + REST).
|
||||||
|
* Промежуточный НЕПУСТОЙ результат показывать можно и нужно — в нём уже есть
|
||||||
|
* что смотреть.
|
||||||
|
*/
|
||||||
|
const loaded = loadedKey === dataKey || visible.length > 0;
|
||||||
const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
|
const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
|
||||||
|
|
||||||
// Страница может оказаться за пределами набора: пришла из старой ссылки или
|
// Страница может оказаться за пределами набора: пришла из старой ссылки или
|
||||||
@@ -527,8 +545,8 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
{error && <div className={styles.error}>Не удалось загрузить заявки: {error}</div>}
|
{error && <div className={styles.error}>Не удалось загрузить заявки: {error}</div>}
|
||||||
{!error && rows === undefined && <div className={styles.empty}>Загрузка…</div>}
|
{!error && !loaded && <div className={styles.empty}>Загрузка…</div>}
|
||||||
{!error && rows && total === 0 && (
|
{!error && loaded && total === 0 && (
|
||||||
<div className={styles.empty}>
|
<div className={styles.empty}>
|
||||||
{q ? `По запросу «${debouncedQuery}» ничего не найдено.` : EMPTY_TEXTS[view]}
|
{q ? `По запросу «${debouncedQuery}» ничего не найдено.` : EMPTY_TEXTS[view]}
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@@ -20,12 +20,14 @@ import {
|
|||||||
dataListTitle,
|
dataListTitle,
|
||||||
dataListTitleForListId
|
dataListTitleForListId
|
||||||
} from '../../shared/listTitles';
|
} from '../../shared/listTitles';
|
||||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField, WRITE_OFF_CATEGORIES } from './model';
|
||||||
import { loadClearanceRequest } from './load';
|
import { loadClearanceRequest } from './load';
|
||||||
import {
|
import {
|
||||||
clearanceApprovalService,
|
clearanceApprovalService,
|
||||||
updateApproverFields,
|
updateApproverFields,
|
||||||
IApproverEditableFields
|
updateWriteOffFields,
|
||||||
|
IApproverEditableFields,
|
||||||
|
IWriteOffFields
|
||||||
} from './submit';
|
} from './submit';
|
||||||
import { canEditHrRecordsFields, canEditParkingField } from './approverRights';
|
import { canEditHrRecordsFields, canEditParkingField } from './approverRights';
|
||||||
import { RequestSection } from './sections/RequestSection';
|
import { RequestSection } from './sections/RequestSection';
|
||||||
@@ -52,7 +54,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
const [error, setError] = useState<string | null>(null);
|
const [error, setError] = useState<string | null>(null);
|
||||||
const [hrRecordsEditable, setHrRecordsEditable] = useState<boolean>(false);
|
const [hrRecordsEditable, setHrRecordsEditable] = useState<boolean>(false);
|
||||||
const [parkingEditable, setParkingEditable] = useState<boolean>(false);
|
const [parkingEditable, setParkingEditable] = useState<boolean>(false);
|
||||||
|
// Суммы к списанию, в отличие от отметок выше, не привязаны к должности — их
|
||||||
|
// может заполнить ЛЮБОЙ активный согласующий (см. эффект прав ниже).
|
||||||
|
const [canEditWriteOffs, setCanEditWriteOffs] = useState<boolean>(false);
|
||||||
|
// Категории, УЖЕ заблокированные (сумма непустая) НА МОМЕНТ ЗАГРУЗКИ — не
|
||||||
|
// реактивно от текущего data, иначе поле блокировалось бы прямо во время
|
||||||
|
// ввода (набрал сумму → data стал непустым → поле сразу стало бы readOnly).
|
||||||
|
const [lockedWriteOffs, setLockedWriteOffs] = useState<Set<string>>(new Set());
|
||||||
const [saveState, setSaveState] = useState<SaveState>('idle');
|
const [saveState, setSaveState] = useState<SaveState>('idle');
|
||||||
|
const [saveErrorMessage, setSaveErrorMessage] = useState<string>('');
|
||||||
|
|
||||||
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
|
||||||
@@ -102,6 +112,9 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
setCode(loaded.code);
|
setCode(loaded.code);
|
||||||
setError(null);
|
setError(null);
|
||||||
setLoading(false);
|
setLoading(false);
|
||||||
|
setLockedWriteOffs(
|
||||||
|
new Set(WRITE_OFF_CATEGORIES.filter((cat) => !!loaded.data[cat.amountField]).map((cat) => cat.key))
|
||||||
|
);
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
.catch((e) => {
|
.catch((e) => {
|
||||||
@@ -127,11 +140,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
const active = !!pending && !pending.isDelegator && pending.phase !== APPROVAL_PHASE.execution;
|
const active = !!pending && !pending.isDelegator && pending.phase !== APPROVAL_PHASE.execution;
|
||||||
setHrRecordsEditable(active && canEditHrRecordsFields(pending?.position));
|
setHrRecordsEditable(active && canEditHrRecordsFields(pending?.position));
|
||||||
setParkingEditable(active && canEditParkingField(pending?.position));
|
setParkingEditable(active && canEditParkingField(pending?.position));
|
||||||
|
// Суммы к списанию — без проверки должности: их вводит тот, кто сейчас
|
||||||
|
// фактически согласует шаг, вне зависимости от отдела.
|
||||||
|
setCanEditWriteOffs(active);
|
||||||
})
|
})
|
||||||
.catch(() => {
|
.catch(() => {
|
||||||
if (alive) {
|
if (alive) {
|
||||||
setHrRecordsEditable(false);
|
setHrRecordsEditable(false);
|
||||||
setParkingEditable(false);
|
setParkingEditable(false);
|
||||||
|
setCanEditWriteOffs(false);
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
return () => {
|
return () => {
|
||||||
@@ -140,9 +157,24 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
// decisionSeq: после решения/делегирования активный шаг меняется — права пересчитываем.
|
// decisionSeq: после решения/делегирования активный шаг меняется — права пересчитываем.
|
||||||
}, [itemId, approverService, decisionSeq]);
|
}, [itemId, approverService, decisionSeq]);
|
||||||
|
|
||||||
|
// Категории списания, которые может править ИМЕННО СЕЙЧАС этот пользователь:
|
||||||
|
// ещё не заблокированы (см. lockedWriteOffs) И у него сейчас активный шаг.
|
||||||
|
// Отдельная переменная, не «canEditWriteOffs && !lockedWriteOffs.has(...)»
|
||||||
|
// на месте использования — нужна и в саму секцию (RequestSection), и здесь.
|
||||||
|
const editableWriteOffKeys = useMemo(
|
||||||
|
() =>
|
||||||
|
canEditWriteOffs
|
||||||
|
? new Set(WRITE_OFF_CATEGORIES.filter((cat) => !lockedWriteOffs.has(cat.key)).map((cat) => cat.key))
|
||||||
|
: new Set<string>(),
|
||||||
|
[canEditWriteOffs, lockedWriteOffs]
|
||||||
|
);
|
||||||
|
|
||||||
// Пишем ТОЛЬКО те отметки, на которые у согласующего есть права: иначе он
|
// Пишем ТОЛЬКО те отметки, на которые у согласующего есть права: иначе он
|
||||||
// затёр бы чужие поля значениями, которые видел у себя на экране.
|
// затёр бы чужие поля значениями, которые видел у себя на экране. Пары сумм к
|
||||||
const saveApproverFields = useCallback((): Promise<void> => {
|
// списанию — только НЕПУСТЫЕ и только среди editableWriteOffKeys; частично
|
||||||
|
// заполненная пара (сумма без комментария или наоборот) бросает ДО записи
|
||||||
|
// чего бы то ни было — половинчатая запись хуже отказа сохранить.
|
||||||
|
const saveApproverFields = useCallback(async (): Promise<void> => {
|
||||||
const fields: Partial<IApproverEditableFields> = {};
|
const fields: Partial<IApproverEditableFields> = {};
|
||||||
if (hrRecordsEditable) {
|
if (hrRecordsEditable) {
|
||||||
fields.AccessCard = data.AccessCard;
|
fields.AccessCard = data.AccessCard;
|
||||||
@@ -151,15 +183,36 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
if (parkingEditable) {
|
if (parkingEditable) {
|
||||||
fields.ParkingCard = data.ParkingCard;
|
fields.ParkingCard = data.ParkingCard;
|
||||||
}
|
}
|
||||||
return updateApproverFields(itemId, fields, listId);
|
|
||||||
}, [itemId, listId, hrRecordsEditable, parkingEditable, data.AccessCard, data.TrainingAmount, data.ParkingCard]);
|
const writeOffFields: Partial<IWriteOffFields> = {};
|
||||||
|
for (const cat of WRITE_OFF_CATEGORIES) {
|
||||||
|
if (!editableWriteOffKeys.has(cat.key)) continue;
|
||||||
|
const amount = data[cat.amountField].trim();
|
||||||
|
const comment = data[cat.commentField].trim();
|
||||||
|
if (!amount && !comment) continue; // не трогали — не пишем
|
||||||
|
if (!amount || !comment) {
|
||||||
|
throw new Error(
|
||||||
|
`«${cat.label}»: заполните и сумму, и комментарий (за что конкретно) — или оставьте пару пустой.`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
writeOffFields[cat.amountField] = data[cat.amountField];
|
||||||
|
writeOffFields[cat.commentField] = data[cat.commentField];
|
||||||
|
}
|
||||||
|
|
||||||
|
await updateApproverFields(itemId, fields, listId);
|
||||||
|
if (Object.keys(writeOffFields).length > 0) {
|
||||||
|
await updateWriteOffFields(itemId, writeOffFields, listId);
|
||||||
|
}
|
||||||
|
}, [itemId, listId, hrRecordsEditable, parkingEditable, editableWriteOffKeys, data]);
|
||||||
|
|
||||||
const handleSaveFields = async (): Promise<void> => {
|
const handleSaveFields = async (): Promise<void> => {
|
||||||
setSaveState('saving');
|
setSaveState('saving');
|
||||||
|
setSaveErrorMessage('');
|
||||||
try {
|
try {
|
||||||
await saveApproverFields();
|
await saveApproverFields();
|
||||||
setSaveState('saved');
|
setSaveState('saved');
|
||||||
} catch {
|
} catch (e) {
|
||||||
|
setSaveErrorMessage(friendlyErrorMessage(e));
|
||||||
setSaveState('error');
|
setSaveState('error');
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
@@ -175,8 +228,20 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
const canEditAnything = hrRecordsEditable || parkingEditable;
|
const canEditAnything = hrRecordsEditable || parkingEditable || canEditWriteOffs;
|
||||||
const sectionProps = { data, set, context, hrRecordsEditable, parkingEditable };
|
const reviewHints = [
|
||||||
|
hrRecordsEditable && 'отметить карту СКУД и указать сумму за обучение',
|
||||||
|
parkingEditable && 'отметить парковочную карту',
|
||||||
|
editableWriteOffKeys.size > 0 && 'указать суммы к списанию (если применимо)'
|
||||||
|
].filter((hint): hint is string => !!hint);
|
||||||
|
const sectionProps = {
|
||||||
|
data,
|
||||||
|
set,
|
||||||
|
context,
|
||||||
|
hrRecordsEditable,
|
||||||
|
parkingEditable,
|
||||||
|
writeOffEditableKeys: editableWriteOffKeys
|
||||||
|
};
|
||||||
|
|
||||||
const notify = (): void => {
|
const notify = (): void => {
|
||||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||||
@@ -199,15 +264,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
|||||||
{canEditAnything && (
|
{canEditAnything && (
|
||||||
<div className={`${styles.reviewBar} rp-no-print`}>
|
<div className={`${styles.reviewBar} rp-no-print`}>
|
||||||
<span className={styles.reviewHint}>
|
<span className={styles.reviewHint}>
|
||||||
{hrRecordsEditable
|
{reviewHints.length > 0 && `Как согласующий вы можете ${reviewHints.join('; ')}.`}
|
||||||
? 'Как согласующий вы можете отметить карту СКУД и указать сумму за обучение.'
|
|
||||||
: 'Как согласующий вы можете отметить парковочную карту.'}
|
|
||||||
</span>
|
</span>
|
||||||
<Button variant="secondary" onClick={handleSaveFields} disabled={saveState === 'saving'}>
|
<Button variant="secondary" onClick={handleSaveFields} disabled={saveState === 'saving'}>
|
||||||
Сохранить
|
Сохранить
|
||||||
</Button>
|
</Button>
|
||||||
{saveState === 'saved' && <span className={styles.savedNote}>Сохранено</span>}
|
{saveState === 'saved' && <span className={styles.savedNote}>Сохранено</span>}
|
||||||
{saveState === 'error' && <span className={styles.saveError}>Ошибка сохранения</span>}
|
{saveState === 'error' && (
|
||||||
|
<span className={styles.saveError}>{saveErrorMessage || 'Ошибка сохранения'}</span>
|
||||||
|
)}
|
||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
|
|||||||
@@ -54,8 +54,31 @@ RequestTypeId» в `docs/forms.md`). Тип уже зарегистрирова
|
|||||||
`LinkField` из `shared/ui`, read-only, открывается в той же вкладке; у листов,
|
`LinkField` из `shared/ui`, read-only, открывается в той же вкладке; у листов,
|
||||||
заведённых руками, ссылки нет и поле не рендерится.
|
заведённых руками, ссылки нет и поле не рендерится.
|
||||||
|
|
||||||
|
## Суммы к списанию (согласование)
|
||||||
|
6 НЕЗАВИСИМЫХ пар «сумма + обязательный комментарий (за что конкретно)», колонки
|
||||||
|
`WriteOff{Assets,Ppe,Accountable,Training,Nma,Tmc}{Amount,Comment}` (см. `model.ts
|
||||||
|
WRITE_OFF_CATEGORIES`): «ОС», «СИЗ», «Подотчётная сумма», «Обучение», «НМА», «ТМЦ».
|
||||||
|
|
||||||
|
- **Не привязаны к должности**, в отличие от отметок выше: заполнить может ЛЮБОЙ
|
||||||
|
согласующий, у которого сейчас активный шаг (`ClearanceView.canEditWriteOffs`,
|
||||||
|
фаза «Согласование» — исполнителям недоступно, как и остальным отметкам).
|
||||||
|
- **Каждая пара блокируется НАВСЕГДА после первого ввода** — как только сумма
|
||||||
|
непустая, поле становится read-only для всех, включая того, кто её ввёл.
|
||||||
|
Признак блокировки — сама непустая сумма на МОМЕНТ ЗАГРУЗКИ страницы
|
||||||
|
(`ClearanceView.lockedWriteOffs`, снимок при загрузке, а не реактивно от
|
||||||
|
текущего `data` — иначе поле блокировалось бы прямо во время набора цифр).
|
||||||
|
- **Комментарий обязателен вместе с суммой**: заполнить можно либо обе половины
|
||||||
|
пары, либо ни одной — `saveApproverFields` бросает ДО записи чего бы то ни
|
||||||
|
было, если половина пары осталась пустой.
|
||||||
|
- Сохраняются той же кнопкой «Сохранить» (`reviewBar`), что и остальные отметки,
|
||||||
|
и тем же `onBeforeDecide` — при решении несохранённые суммы уйдут вместе с ним.
|
||||||
|
- Это ОТДЕЛЬНЫЙ механизм от `TrainingAmount` («Обучение: сумма» выше, привязана к
|
||||||
|
КДП) — сознательно не объединялись, чтобы не менять уже установившееся
|
||||||
|
поведение существующего поля.
|
||||||
|
|
||||||
## Секции формы
|
## Секции формы
|
||||||
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма обучения · парковочная карта · карта СКУД)
|
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма
|
||||||
|
обучения · парковочная карта · карта СКУД · суммы к списанию · ссылка на заявление)
|
||||||
|
|
||||||
## Точки входа
|
## Точки входа
|
||||||
- rptype: `clearance-form`
|
- rptype: `clearance-form`
|
||||||
|
|||||||
@@ -2,6 +2,11 @@ import { getSP } from '../../shared/pnp/pnpjs';
|
|||||||
import { dataListTitle } from '../../shared/listTitles';
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||||
|
|
||||||
|
/** Число или '' (SharePoint отдаёт null для незаполненного Number). */
|
||||||
|
function numberField(value: unknown): string {
|
||||||
|
return value === null || value === undefined ? '' : String(value);
|
||||||
|
}
|
||||||
|
|
||||||
export interface ILoadedRequest {
|
export interface ILoadedRequest {
|
||||||
data: IFormData;
|
data: IFormData;
|
||||||
/** Ф.И.О. увольняемого сотрудника из поля Employee (для заголовка режима чтения). */
|
/** Ф.И.О. увольняемого сотрудника из поля Employee (для заголовка режима чтения). */
|
||||||
@@ -33,6 +38,18 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
|||||||
'TrainingAmount',
|
'TrainingAmount',
|
||||||
'Organization',
|
'Organization',
|
||||||
'DismissalUrl',
|
'DismissalUrl',
|
||||||
|
'WriteOffAssetsAmount',
|
||||||
|
'WriteOffAssetsComment',
|
||||||
|
'WriteOffPpeAmount',
|
||||||
|
'WriteOffPpeComment',
|
||||||
|
'WriteOffAccountableAmount',
|
||||||
|
'WriteOffAccountableComment',
|
||||||
|
'WriteOffTrainingAmount',
|
||||||
|
'WriteOffTrainingComment',
|
||||||
|
'WriteOffNmaAmount',
|
||||||
|
'WriteOffNmaComment',
|
||||||
|
'WriteOffTmcAmount',
|
||||||
|
'WriteOffTmcComment',
|
||||||
'RequestStatus',
|
'RequestStatus',
|
||||||
'RequestUniqueCode',
|
'RequestUniqueCode',
|
||||||
'Employee/Title',
|
'Employee/Title',
|
||||||
@@ -55,7 +72,19 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
|||||||
TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
|
TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
|
||||||
Organization: (item.Organization as string) || '',
|
Organization: (item.Organization as string) || '',
|
||||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||||
DismissalUrl: (item.DismissalUrl as { Url?: string } | undefined)?.Url || ''
|
DismissalUrl: (item.DismissalUrl as { Url?: string } | undefined)?.Url || '',
|
||||||
|
WriteOffAssetsAmount: numberField(item.WriteOffAssetsAmount),
|
||||||
|
WriteOffAssetsComment: (item.WriteOffAssetsComment as string) || '',
|
||||||
|
WriteOffPpeAmount: numberField(item.WriteOffPpeAmount),
|
||||||
|
WriteOffPpeComment: (item.WriteOffPpeComment as string) || '',
|
||||||
|
WriteOffAccountableAmount: numberField(item.WriteOffAccountableAmount),
|
||||||
|
WriteOffAccountableComment: (item.WriteOffAccountableComment as string) || '',
|
||||||
|
WriteOffTrainingAmount: numberField(item.WriteOffTrainingAmount),
|
||||||
|
WriteOffTrainingComment: (item.WriteOffTrainingComment as string) || '',
|
||||||
|
WriteOffNmaAmount: numberField(item.WriteOffNmaAmount),
|
||||||
|
WriteOffNmaComment: (item.WriteOffNmaComment as string) || '',
|
||||||
|
WriteOffTmcAmount: numberField(item.WriteOffTmcAmount),
|
||||||
|
WriteOffTmcComment: (item.WriteOffTmcComment as string) || ''
|
||||||
};
|
};
|
||||||
|
|
||||||
return {
|
return {
|
||||||
|
|||||||
@@ -37,8 +37,78 @@ export interface IFormData {
|
|||||||
* forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
|
* forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
|
||||||
*/
|
*/
|
||||||
DismissalUrl: string;
|
DismissalUrl: string;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Суммы к списанию по обходному листу — 6 независимых пар (сумма +
|
||||||
|
* обязательный комментарий, «за что конкретно»), см. WRITE_OFF_CATEGORIES.
|
||||||
|
* «Сырые» цифры без пробелов, как TrainingAmount (см. MoneyInput). Пусто =
|
||||||
|
* не заполнено. КАЖДАЯ пара — независимая: заполнить может любой активный
|
||||||
|
* согласующий (см. ClearanceView.canEditWriteOffs), но как только сумма
|
||||||
|
* непустая — пара блокируется НАВСЕГДА, для всех (включая того, кто её ввёл).
|
||||||
|
* Признак блокировки — сама непустая сумма, отдельного флага в списке нет.
|
||||||
|
*/
|
||||||
|
WriteOffAssetsAmount: string;
|
||||||
|
WriteOffAssetsComment: string;
|
||||||
|
WriteOffPpeAmount: string;
|
||||||
|
WriteOffPpeComment: string;
|
||||||
|
WriteOffAccountableAmount: string;
|
||||||
|
WriteOffAccountableComment: string;
|
||||||
|
WriteOffTrainingAmount: string;
|
||||||
|
WriteOffTrainingComment: string;
|
||||||
|
WriteOffNmaAmount: string;
|
||||||
|
WriteOffNmaComment: string;
|
||||||
|
WriteOffTmcAmount: string;
|
||||||
|
WriteOffTmcComment: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Имена всех 12 строковых полей сумм/комментариев к списанию — см. IFormData.WriteOff*. */
|
||||||
|
export type WriteOffFieldKey =
|
||||||
|
| 'WriteOffAssetsAmount'
|
||||||
|
| 'WriteOffAssetsComment'
|
||||||
|
| 'WriteOffPpeAmount'
|
||||||
|
| 'WriteOffPpeComment'
|
||||||
|
| 'WriteOffAccountableAmount'
|
||||||
|
| 'WriteOffAccountableComment'
|
||||||
|
| 'WriteOffTrainingAmount'
|
||||||
|
| 'WriteOffTrainingComment'
|
||||||
|
| 'WriteOffNmaAmount'
|
||||||
|
| 'WriteOffNmaComment'
|
||||||
|
| 'WriteOffTmcAmount'
|
||||||
|
| 'WriteOffTmcComment';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Одна из 6 независимых категорий списания — см. IFormData.WriteOff*.
|
||||||
|
* amountField/commentField сужены до WriteOffFieldKey (а не keyof IFormData
|
||||||
|
* целиком): у IFormData есть и булевы поля (ParkingCard/AccessCard), и
|
||||||
|
* `data[cat.amountField]` должен типизироваться строго строкой — иначе
|
||||||
|
* `.trim()` в валидации и передача в MoneyInput/TextArea не собираются.
|
||||||
|
*/
|
||||||
|
export interface IWriteOffCategory {
|
||||||
|
key: string;
|
||||||
|
label: string;
|
||||||
|
amountField: WriteOffFieldKey;
|
||||||
|
commentField: WriteOffFieldKey;
|
||||||
|
}
|
||||||
|
|
||||||
|
export const WRITE_OFF_CATEGORIES: IWriteOffCategory[] = [
|
||||||
|
{ key: 'assets', label: 'ОС', amountField: 'WriteOffAssetsAmount', commentField: 'WriteOffAssetsComment' },
|
||||||
|
{ key: 'ppe', label: 'СИЗ', amountField: 'WriteOffPpeAmount', commentField: 'WriteOffPpeComment' },
|
||||||
|
{
|
||||||
|
key: 'accountable',
|
||||||
|
label: 'Подотчётная сумма',
|
||||||
|
amountField: 'WriteOffAccountableAmount',
|
||||||
|
commentField: 'WriteOffAccountableComment'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
key: 'training',
|
||||||
|
label: 'Обучение',
|
||||||
|
amountField: 'WriteOffTrainingAmount',
|
||||||
|
commentField: 'WriteOffTrainingComment'
|
||||||
|
},
|
||||||
|
{ key: 'nma', label: 'НМА', amountField: 'WriteOffNmaAmount', commentField: 'WriteOffNmaComment' },
|
||||||
|
{ key: 'tmc', label: 'ТМЦ', amountField: 'WriteOffTmcAmount', commentField: 'WriteOffTmcComment' }
|
||||||
|
];
|
||||||
|
|
||||||
/** Обновление одного поля формы с сохранением типа значения. */
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||||
|
|
||||||
@@ -63,7 +133,19 @@ export const EMPTY_DATA: IFormData = {
|
|||||||
AccessCard: false,
|
AccessCard: false,
|
||||||
TrainingAmount: '',
|
TrainingAmount: '',
|
||||||
Organization: '',
|
Organization: '',
|
||||||
DismissalUrl: ''
|
DismissalUrl: '',
|
||||||
|
WriteOffAssetsAmount: '',
|
||||||
|
WriteOffAssetsComment: '',
|
||||||
|
WriteOffPpeAmount: '',
|
||||||
|
WriteOffPpeComment: '',
|
||||||
|
WriteOffAccountableAmount: '',
|
||||||
|
WriteOffAccountableComment: '',
|
||||||
|
WriteOffTrainingAmount: '',
|
||||||
|
WriteOffTrainingComment: '',
|
||||||
|
WriteOffNmaAmount: '',
|
||||||
|
WriteOffNmaComment: '',
|
||||||
|
WriteOffTmcAmount: '',
|
||||||
|
WriteOffTmcComment: ''
|
||||||
};
|
};
|
||||||
|
|
||||||
/** Плейсхолдер для поля выбора сотрудника. */
|
/** Плейсхолдер для поля выбора сотрудника. */
|
||||||
|
|||||||
@@ -14,6 +14,19 @@
|
|||||||
{ "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
|
{ "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
|
||||||
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||||
|
|
||||||
{ "internalName": "DismissalUrl", "title": "Ссылка на заявление на увольнение", "type": "Url" }
|
{ "internalName": "DismissalUrl", "title": "Ссылка на заявление на увольнение", "type": "Url" },
|
||||||
|
|
||||||
|
{ "internalName": "WriteOffAssetsAmount", "title": "Сумма к списанию: ОС", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffAssetsComment", "title": "Комментарий: ОС", "type": "Note" },
|
||||||
|
{ "internalName": "WriteOffPpeAmount", "title": "Сумма к списанию: СИЗ", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffPpeComment", "title": "Комментарий: СИЗ", "type": "Note" },
|
||||||
|
{ "internalName": "WriteOffAccountableAmount", "title": "Сумма к списанию: подотчётная сумма", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffAccountableComment", "title": "Комментарий: подотчётная сумма", "type": "Note" },
|
||||||
|
{ "internalName": "WriteOffTrainingAmount", "title": "Сумма к списанию: обучение", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffTrainingComment", "title": "Комментарий: обучение", "type": "Note" },
|
||||||
|
{ "internalName": "WriteOffNmaAmount", "title": "Сумма к списанию: НМА", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffNmaComment", "title": "Комментарий: НМА", "type": "Note" },
|
||||||
|
{ "internalName": "WriteOffTmcAmount", "title": "Сумма к списанию: ТМЦ", "type": "Number", "decimals": 2 },
|
||||||
|
{ "internalName": "WriteOffTmcComment", "title": "Комментарий: ТМЦ", "type": "Note" }
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import * as React from 'react';
|
import * as React from 'react';
|
||||||
import { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
|
import { CollapseSection, FormField, TextArea, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
|
||||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
import { ISectionProps, EMPLOYEE_PLACEHOLDER, WRITE_OFF_CATEGORIES } from '../model';
|
||||||
|
|
||||||
// Подразделение подтягивается автоматически при выборе сотрудника (см.
|
// Подразделение подтягивается автоматически при выборе сотрудника (см.
|
||||||
// ClearanceForm.handleEmployeeChange — SharePoint User Profile) — свободный
|
// ClearanceForm.handleEmployeeChange — SharePoint User Profile) — свободный
|
||||||
@@ -12,6 +12,14 @@ interface IRequestSectionProps extends ISectionProps {
|
|||||||
hrRecordsEditable?: boolean;
|
hrRecordsEditable?: boolean;
|
||||||
/** Согласующий из отдела подбора правит парковочную карту. */
|
/** Согласующий из отдела подбора правит парковочную карту. */
|
||||||
parkingEditable?: boolean;
|
parkingEditable?: boolean;
|
||||||
|
/**
|
||||||
|
* Ключи категорий списания (см. WRITE_OFF_CATEGORIES), которые ЭТОТ
|
||||||
|
* пользователь может сейчас заполнить — присутствие пропа (даже пустым
|
||||||
|
* Set'ом) включает блок сумм к списанию; не задан вовсе (форма подачи, см.
|
||||||
|
* ClearanceForm) — блок не показывается: до первого решения списывать
|
||||||
|
* нечего. См. ClearanceView.editableWriteOffKeys.
|
||||||
|
*/
|
||||||
|
writeOffEditableKeys?: Set<string>;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Единственная секция формы «Обходной лист»: увольняемый, должность, подразделение, даты, карты, обучение. */
|
/** Единственная секция формы «Обходной лист»: увольняемый, должность, подразделение, даты, карты, обучение. */
|
||||||
@@ -21,7 +29,8 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
|||||||
context,
|
context,
|
||||||
onEmployeeChange,
|
onEmployeeChange,
|
||||||
hrRecordsEditable,
|
hrRecordsEditable,
|
||||||
parkingEditable
|
parkingEditable,
|
||||||
|
writeOffEditableKeys
|
||||||
}) => (
|
}) => (
|
||||||
<CollapseSection title="Обходной лист" icon="people">
|
<CollapseSection title="Обходной лист" icon="people">
|
||||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||||
@@ -89,6 +98,41 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
|||||||
readOnly={hrRecordsEditable ? false : undefined}
|
readOnly={hrRecordsEditable ? false : undefined}
|
||||||
/>
|
/>
|
||||||
</FormField>
|
</FormField>
|
||||||
|
{/* Суммы к списанию — 6 независимых пар (сумма + обязательный комментарий,
|
||||||
|
за что конкретно). Каждую может заполнить ЛЮБОЙ активный согласующий
|
||||||
|
(не только профильный, в отличие от отметок выше) — но как только сумма
|
||||||
|
указана, пара блокируется навсегда для всех, поэтому у незаблокированных
|
||||||
|
(writeOffEditableKeys.has(cat.key)) есть readOnly={false}, у остальных —
|
||||||
|
обычное поведение FormMode (просмотр — заблокировано и так). */}
|
||||||
|
{writeOffEditableKeys &&
|
||||||
|
WRITE_OFF_CATEGORIES.map((cat) => {
|
||||||
|
const editable = writeOffEditableKeys.has(cat.key);
|
||||||
|
return (
|
||||||
|
<React.Fragment key={cat.key}>
|
||||||
|
<FormField label={`${cat.label}: сумма`} htmlFor={cat.amountField}>
|
||||||
|
<MoneyInput
|
||||||
|
id={cat.amountField}
|
||||||
|
value={data[cat.amountField]}
|
||||||
|
onChange={(v) => set(cat.amountField, v)}
|
||||||
|
readOnly={editable ? false : undefined}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
<FormField
|
||||||
|
label={`${cat.label}: за что конкретно`}
|
||||||
|
htmlFor={cat.commentField}
|
||||||
|
required={editable}
|
||||||
|
full
|
||||||
|
>
|
||||||
|
<TextArea
|
||||||
|
id={cat.commentField}
|
||||||
|
value={data[cat.commentField]}
|
||||||
|
onChange={(v) => set(cat.commentField, v)}
|
||||||
|
readOnly={editable ? false : undefined}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
|
</React.Fragment>
|
||||||
|
);
|
||||||
|
})}
|
||||||
{/* Есть только у листов, созданных автоматически по согласованному заявлению
|
{/* Есть только у листов, созданных автоматически по согласованному заявлению
|
||||||
на увольнение (см. forms/Dismissal/createClearance.ts). */}
|
на увольнение (см. forms/Dismissal/createClearance.ts). */}
|
||||||
<LinkField
|
<LinkField
|
||||||
|
|||||||
@@ -1,7 +1,40 @@
|
|||||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||||
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
||||||
import { ensureEmployee } from '../../shared/employee';
|
import { ensureEmployee } from '../../shared/employee';
|
||||||
import { FORM_ID, IFormData } from './model';
|
import { FORM_ID, IFormData, WriteOffFieldKey } from './model';
|
||||||
|
|
||||||
|
/** Одна из 12 колонок сумм/комментариев к списанию — см. model.ts WRITE_OFF_CATEGORIES. */
|
||||||
|
export type IWriteOffFields = Pick<IFormData, WriteOffFieldKey>;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Записать сумму(ы)/комментарий(и) к списанию. Пишет РОВНО переданные поля —
|
||||||
|
* как updateApproverFields, каждая пара независима.
|
||||||
|
*
|
||||||
|
* ВАЖНО: вызывающая сторона (ClearanceView) обязана передавать сюда ТОЛЬКО те
|
||||||
|
* пары, что ещё не заблокированы (см. IFormData.WriteOff* — блокировка по
|
||||||
|
* непустой сумме) и заполнены целиком (сумма+комментарий вместе, см.
|
||||||
|
* validateWriteOffPairs) — эта функция сама повторно ничего не проверяет и
|
||||||
|
* молча перезапишет то, что ей передали.
|
||||||
|
*/
|
||||||
|
export async function updateWriteOffFields(
|
||||||
|
id: number,
|
||||||
|
fields: Partial<IWriteOffFields>,
|
||||||
|
listId?: string
|
||||||
|
): Promise<void> {
|
||||||
|
const item: Record<string, unknown> = {};
|
||||||
|
for (const key of Object.keys(fields) as Array<keyof IWriteOffFields>) {
|
||||||
|
const raw = fields[key];
|
||||||
|
if (raw === undefined) continue;
|
||||||
|
if (key.endsWith('Amount')) {
|
||||||
|
const amount = Number(raw);
|
||||||
|
item[key] = Number.isFinite(amount) && raw.trim() !== '' ? amount : null;
|
||||||
|
} else {
|
||||||
|
item[key] = raw || null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (Object.keys(item).length === 0) return;
|
||||||
|
await resolveDataList(FORM_ID, listId).items.getById(id).update(item);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||||
|
|||||||
@@ -25,16 +25,16 @@ import {
|
|||||||
resolveWriteListId
|
resolveWriteListId
|
||||||
} from '../../shared/approval';
|
} from '../../shared/approval';
|
||||||
import { IRequestFormProps } from '../../models/types';
|
import { IRequestFormProps } from '../../models/types';
|
||||||
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
|
import { getEmployeeOrganizations, getCompanyDirectorEmail, IEmployeeOrganization } from '../../shared/dictionary';
|
||||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
import { isoDatePlusDays, formatIsoDate } from '../../shared/dateUtils';
|
import { isoDatePlusMonths, formatIsoDate } from '../../shared/dateUtils';
|
||||||
import {
|
import {
|
||||||
approvalListTitle,
|
approvalListTitle,
|
||||||
approvalListTitleForListId,
|
approvalListTitleForListId,
|
||||||
dataListTitle,
|
dataListTitle,
|
||||||
dataListTitleForListId
|
dataListTitleForListId
|
||||||
} from '../../shared/listTitles';
|
} from '../../shared/listTitles';
|
||||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField, MIN_NOTICE_MONTHS, IOrganizationRecord, primaryPosition } from './model';
|
||||||
import { saveDismissalRequest, dismissalApprovalService } from './submit';
|
import { saveDismissalRequest, dismissalApprovalService } from './submit';
|
||||||
import { loadDismissalRequest } from './load';
|
import { loadDismissalRequest } from './load';
|
||||||
import { RequestSection } from './sections/RequestSection';
|
import { RequestSection } from './sections/RequestSection';
|
||||||
@@ -71,6 +71,10 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
let alive = true;
|
let alive = true;
|
||||||
|
// Таблица организаций читается ЦЕЛИКОМ из самой заявки (loaded.data.Organization
|
||||||
|
// — уже собранная зипом трёх столбцов, см. load.ts) — повторный поход в
|
||||||
|
// Employee/ByEmail здесь не нужен: если при подаче убрали компанию, это уже
|
||||||
|
// зафиксировано в сохранённых данных, а не в живом состоянии справочника.
|
||||||
loadDismissalRequest(editId, editListId)
|
loadDismissalRequest(editId, editListId)
|
||||||
.then((loaded) => {
|
.then((loaded) => {
|
||||||
if (alive) {
|
if (alive) {
|
||||||
@@ -90,10 +94,15 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
|||||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
}, [editId, editListId]);
|
}, [editId, editListId]);
|
||||||
|
|
||||||
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя, его
|
/** Employee/ByEmail → таблица организаций (см. IOrganizationRecord). */
|
||||||
// должность и организации (Employee/ByEmail — см. shared/dictionary/
|
const toOrganization = (records: IEmployeeOrganization[]): IOrganizationRecord[] =>
|
||||||
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких
|
records.map((r) => ({ company: r.company, department: r.section, position: r.position }));
|
||||||
// организациях, должность берём из ПЕРВОЙ записи), подразделение — из профиля.
|
|
||||||
|
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя и его
|
||||||
|
// таблицу организаций (Employee/ByEmail — см. shared/dictionary/
|
||||||
|
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких).
|
||||||
|
// Должность первой (основной) компании читает маршрут (см. primaryPosition) и
|
||||||
|
// остаётся редактируемой на форме — см. OrganizationsTable.
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
if (editId) {
|
if (editId) {
|
||||||
return;
|
return;
|
||||||
@@ -106,42 +115,24 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
|||||||
if (!alive) return;
|
if (!alive) return;
|
||||||
setData((prev) => ({
|
setData((prev) => ({
|
||||||
...prev,
|
...prev,
|
||||||
Position: prev.Position || records[0]?.position || prev.Position,
|
Organization: prev.Organization.length > 0 ? prev.Organization : toOrganization(records)
|
||||||
Organization: formatEmployeeOrganizations(records)
|
|
||||||
}));
|
}));
|
||||||
})
|
})
|
||||||
.catch(() => undefined);
|
.catch(() => undefined);
|
||||||
approval
|
|
||||||
.getProfileFields(user.email)
|
|
||||||
.then((profile) => {
|
|
||||||
if (!alive) return;
|
|
||||||
setData((prev) => ({ ...prev, Department: prev.Department || profile.department }));
|
|
||||||
})
|
|
||||||
.catch(() => undefined);
|
|
||||||
return () => {
|
return () => {
|
||||||
alive = false;
|
alive = false;
|
||||||
};
|
};
|
||||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
}, [editId]);
|
}, [editId]);
|
||||||
|
|
||||||
// Выбор другого сотрудника подтягивает его должность, подразделение и организации.
|
// Выбор другого сотрудника подтягивает его таблицу организаций.
|
||||||
const handleEmployeeChange = (login: string): void => {
|
const handleEmployeeChange = (login: string): void => {
|
||||||
setData((prev) => ({ ...prev, Employee: login, Department: '', Organization: '' }));
|
setData((prev) => ({ ...prev, Employee: login, Organization: [] }));
|
||||||
if (!login) {
|
if (!login) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
approval
|
|
||||||
.getProfileFields(login)
|
|
||||||
.then((profile) => setData((prev) => ({ ...prev, Department: profile.department })))
|
|
||||||
.catch(() => undefined);
|
|
||||||
getEmployeeOrganizations(context, login)
|
getEmployeeOrganizations(context, login)
|
||||||
.then((records) =>
|
.then((records) => setData((prev) => ({ ...prev, Organization: toOrganization(records) })))
|
||||||
setData((prev) => ({
|
|
||||||
...prev,
|
|
||||||
Position: records[0]?.position || prev.Position,
|
|
||||||
Organization: formatEmployeeOrganizations(records)
|
|
||||||
}))
|
|
||||||
)
|
|
||||||
.catch(() => undefined);
|
.catch(() => undefined);
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -155,35 +146,55 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
|||||||
editId
|
editId
|
||||||
? approval.getMatrixForRequest(editId)
|
? approval.getMatrixForRequest(editId)
|
||||||
: getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval', null, [
|
: getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval', null, [
|
||||||
{ fieldName: 'Position', value: data.Position }
|
{ fieldName: 'Position', value: primaryPosition(data.Organization) }
|
||||||
]),
|
]),
|
||||||
[context, approval, editId, data.Employee, data.Position, requestTypeId]
|
[context, approval, editId, data.Employee, data.Organization, requestTypeId]
|
||||||
);
|
);
|
||||||
const matrix = useMatrixEditor(
|
const matrix = useMatrixEditor(
|
||||||
loadMatrix,
|
loadMatrix,
|
||||||
`${data.Employee}-${editId ?? 'new'}-${data.Position}`,
|
`${data.Employee}-${editId ?? 'new'}-${primaryPosition(data.Organization)}`,
|
||||||
!readOnly,
|
!readOnly,
|
||||||
!!editId || (!!data.Employee && !!requestTypeId),
|
!!editId || (!!data.Employee && !!requestTypeId),
|
||||||
(login) => approval.getJobTitle(login)
|
(login) => approval.getJobTitle(login)
|
||||||
);
|
);
|
||||||
|
|
||||||
// Последний рабочий день не может быть в прошлом: заявление подаётся заранее.
|
// Убрать компанию из заявления (совместитель, реально не увольняется из
|
||||||
// Календарь (min у input type=date, см. RequestSection) не даёт выбрать более
|
// ВСЕХ) — см. OrganizationsTable. Снимает компанию из data.Organization И, по
|
||||||
|
// возможности, соответствующего согласующего (директора/должностного
|
||||||
|
// эквивалента этой компании, см. shared/dictionary/employeeLookup.service —
|
||||||
|
// тот же справочник, каким резолвит approval-route HeadType.CompanyDirectors)
|
||||||
|
// из уже загруженной матрицы — искать и удалять его там вручную не нужно.
|
||||||
|
//
|
||||||
|
// Матрица планируется ОДНИМ шагом на все компании сразу (все директора — одна
|
||||||
|
// и та же строка маршрута с несколькими исполнителями), поэтому убрать можно
|
||||||
|
// только из уже пришедшего результата — если матрица ещё грузится или
|
||||||
|
// директор этой компании в ней не нашёлся (например, маршрут ещё не готов),
|
||||||
|
// компания всё равно убирается из заявления, а несовпадение тихо игнорируем:
|
||||||
|
// HR в этом случае уберёт лишнего согласующего вручную через саму матрицу.
|
||||||
|
const handleRemoveOrganization = (company: string): void => {
|
||||||
|
setData((prev) => ({ ...prev, Organization: prev.Organization.filter((r) => r.company !== company) }));
|
||||||
|
|
||||||
|
getCompanyDirectorEmail(context, company)
|
||||||
|
.then((email) => {
|
||||||
|
if (!email) return;
|
||||||
|
const idx = matrix.rows.findIndex((r) => r.email.toLowerCase() === email.toLowerCase());
|
||||||
|
if (idx >= 0) matrix.remove(idx);
|
||||||
|
})
|
||||||
|
.catch(() => undefined);
|
||||||
|
};
|
||||||
|
|
||||||
|
// Последний рабочий день нужно назначать минимум за MIN_NOTICE_MONTHS месяц —
|
||||||
|
// календарь (min у input type=date, см. RequestSection) не даёт выбрать более
|
||||||
// раннюю дату, но проверяем и здесь на случай обхода UI.
|
// раннюю дату, но проверяем и здесь на случай обхода UI.
|
||||||
const today = isoDatePlusDays(0);
|
const minLastWorkingDay = isoDatePlusMonths(MIN_NOTICE_MONTHS);
|
||||||
const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= today;
|
const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= minLastWorkingDay;
|
||||||
const isValid = !!(
|
const position = primaryPosition(data.Organization);
|
||||||
data.Employee &&
|
const isValid = !!(data.Employee && position.trim() && data.LastWorkingDay && isLastDayValid && data.Phone.trim());
|
||||||
data.Position.trim() &&
|
|
||||||
data.LastWorkingDay &&
|
|
||||||
isLastDayValid &&
|
|
||||||
data.Phone.trim()
|
|
||||||
);
|
|
||||||
const validate = (): string | undefined => {
|
const validate = (): string | undefined => {
|
||||||
if (data.LastWorkingDay && !isLastDayValid) {
|
if (data.LastWorkingDay && !isLastDayValid) {
|
||||||
return `Последний рабочий день не может быть раньше сегодняшней даты (${formatIsoDate(today)}).`;
|
return `Последний рабочий день нужно назначать минимум за ${MIN_NOTICE_MONTHS} месяц — минимально доступная дата: ${formatIsoDate(minLastWorkingDay)}.`;
|
||||||
}
|
}
|
||||||
if (!data.Employee || !data.Position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
|
if (!data.Employee || !position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
|
||||||
return 'Заполните обязательные поля: сотрудник, должность, последний рабочий день, контактный телефон.';
|
return 'Заполните обязательные поля: сотрудник, должность, последний рабочий день, контактный телефон.';
|
||||||
}
|
}
|
||||||
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||||
@@ -262,7 +273,13 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
|||||||
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
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 handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||||
|
|
||||||
const sectionProps = { data, set, context, onEmployeeChange: handleEmployeeChange };
|
const sectionProps = {
|
||||||
|
data,
|
||||||
|
set,
|
||||||
|
context,
|
||||||
|
onEmployeeChange: handleEmployeeChange,
|
||||||
|
onRemoveOrganization: handleRemoveOrganization
|
||||||
|
};
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div>
|
<div>
|
||||||
|
|||||||
@@ -12,3 +12,10 @@
|
|||||||
justify-content: flex-end;
|
justify-content: flex-end;
|
||||||
margin-bottom: $sp-4;
|
margin-bottom: $sp-4;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.printBlocked {
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: $fs-sm;
|
||||||
|
color: $gray-500;
|
||||||
|
cursor: help;
|
||||||
|
}
|
||||||
|
|||||||
@@ -14,18 +14,32 @@ import {
|
|||||||
REQUEST_STATUS
|
REQUEST_STATUS
|
||||||
} from '../../shared/approval';
|
} from '../../shared/approval';
|
||||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||||
|
import { getManagerEmail } from '../../shared/dictionary';
|
||||||
import {
|
import {
|
||||||
approvalListTitle,
|
approvalListTitle,
|
||||||
approvalListTitleForListId,
|
approvalListTitleForListId,
|
||||||
dataListTitle,
|
dataListTitle,
|
||||||
dataListTitleForListId
|
dataListTitleForListId
|
||||||
} from '../../shared/listTitles';
|
} from '../../shared/listTitles';
|
||||||
|
import { parseRoute } from '../../shared/routing';
|
||||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||||
import { loadDismissalRequest } from './load';
|
import { loadDismissalRequest } from './load';
|
||||||
import { dismissalApprovalService } from './submit';
|
import { dismissalApprovalService, updateAssetsAcceptor } from './submit';
|
||||||
|
import { loadClearanceRequest } from '../Clearance/load';
|
||||||
import { ensureClearanceForDismissal } from './createClearance';
|
import { ensureClearanceForDismissal } from './createClearance';
|
||||||
import { RequestSection } from './sections/RequestSection';
|
import { RequestSection } from './sections/RequestSection';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Статусы обходного листа, при которых его СОГЛАСОВАНИЕ уже пройдено целиком
|
||||||
|
* (независимо от фазы исполнения, которая у него есть) — печать заявления на
|
||||||
|
* увольнение разрешена начиная отсюда. См. handlePrintGate ниже.
|
||||||
|
*/
|
||||||
|
const CLEARANCE_READY_STATUSES: ReadonlySet<string> = new Set([
|
||||||
|
REQUEST_STATUS.approved,
|
||||||
|
REQUEST_STATUS.execution,
|
||||||
|
REQUEST_STATUS.closed
|
||||||
|
]);
|
||||||
|
|
||||||
interface IDismissalViewProps {
|
interface IDismissalViewProps {
|
||||||
context: WebPartContext;
|
context: WebPartContext;
|
||||||
itemId: number;
|
itemId: number;
|
||||||
@@ -35,9 +49,6 @@ interface IDismissalViewProps {
|
|||||||
listId?: string;
|
listId?: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
|
||||||
const NOOP_SET: SetField = () => undefined;
|
|
||||||
|
|
||||||
// Заявление на увольнение только для просмотра (режим согласующего).
|
// Заявление на увольнение только для просмотра (режим согласующего).
|
||||||
// Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
|
// Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
|
||||||
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||||
@@ -50,6 +61,9 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
// Итог автосоздания обходного листа после согласования (см. onDecided ниже).
|
// Итог автосоздания обходного листа после согласования (см. onDecided ниже).
|
||||||
const [clearance, setClearance] = useState<string>('');
|
const [clearance, setClearance] = useState<string>('');
|
||||||
const [clearanceError, setClearanceError] = useState<string>('');
|
const [clearanceError, setClearanceError] = useState<string>('');
|
||||||
|
// Печать разрешена только с этого момента — см. эффект ниже (printGate).
|
||||||
|
const [printGate, setPrintGate] = useState<'checking' | 'blocked' | 'allowed'>('checking');
|
||||||
|
const [assetsAcceptorEditable, setAssetsAcceptorEditable] = useState<boolean>(false);
|
||||||
|
|
||||||
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||||
// dismissalApprovalService можно звать не опасаясь исключения.
|
// dismissalApprovalService можно звать не опасаясь исключения.
|
||||||
@@ -92,6 +106,66 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
};
|
};
|
||||||
}, [itemId, listId]);
|
}, [itemId, listId]);
|
||||||
|
|
||||||
|
// Печать заявления запрещена до согласования ПАРНОГО обходного листа: сначала
|
||||||
|
// должны отработать/подтвердиться все связанные с увольнением отметки (карты,
|
||||||
|
// суммы к списанию) — печатать заявление раньше значит выдать документ, когда
|
||||||
|
// процесс увольнения ещё не подтверждён целиком. Пока обходной лист не создан
|
||||||
|
// (заявление ещё не согласовано, либо автосоздание не удалось) печать тоже
|
||||||
|
// заблокирована — печатать нечего.
|
||||||
|
//
|
||||||
|
// Статус читаем НАПРЯМУЮ из ClearanceUrl (rpid/rplist в самой ссылке), а не
|
||||||
|
// храним отдельным полем: ссылка и так единственный источник, откуда мы вообще
|
||||||
|
// знаем, какой это обходной лист, дублировать его id/партицию незачем.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!data.ClearanceUrl) {
|
||||||
|
setPrintGate('blocked');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const route = parseRoute(new URL(data.ClearanceUrl).search);
|
||||||
|
if (route.mode !== 'approve' || !route.itemId) {
|
||||||
|
setPrintGate('blocked');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
let alive = true;
|
||||||
|
setPrintGate('checking');
|
||||||
|
loadClearanceRequest(route.itemId, route.listId)
|
||||||
|
.then((loaded) => {
|
||||||
|
if (alive) setPrintGate(CLEARANCE_READY_STATUSES.has(loaded.status) ? 'allowed' : 'blocked');
|
||||||
|
})
|
||||||
|
.catch(() => {
|
||||||
|
if (alive) setPrintGate('blocked');
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
}, [data.ClearanceUrl]);
|
||||||
|
|
||||||
|
// Права на «Лицо, принимающее ОС/НМА» — по ИДЕНТИЧНОСТИ (это конкретно
|
||||||
|
// непосредственный руководитель увольняемого, не любой согласующий с нужной
|
||||||
|
// должностью, как в approverRights.ts «Обходного листа»), и только пока у него
|
||||||
|
// сейчас активный шаг: getManagerEmail дублирует тот же запрос
|
||||||
|
// (Employee/Manager, managerType=chief), что approval-route делает для
|
||||||
|
// HeadType.Chief при планировании этого же маршрута (см. README формы).
|
||||||
|
useEffect(() => {
|
||||||
|
if (!data.Employee) return;
|
||||||
|
let alive = true;
|
||||||
|
Promise.all([approverService.getPendingRowForCurrentUser(itemId), getManagerEmail(context, data.Employee, 'chief')])
|
||||||
|
.then(([pending, managerEmail]) => {
|
||||||
|
if (!alive) return;
|
||||||
|
const active = !!pending && !pending.isDelegator;
|
||||||
|
const isManager =
|
||||||
|
!!managerEmail && managerEmail.toLowerCase() === context.pageContext.user.email.toLowerCase();
|
||||||
|
setAssetsAcceptorEditable(active && isManager);
|
||||||
|
})
|
||||||
|
.catch(() => {
|
||||||
|
if (alive) setAssetsAcceptorEditable(false);
|
||||||
|
});
|
||||||
|
return () => {
|
||||||
|
alive = false;
|
||||||
|
};
|
||||||
|
// decisionSeq: после решения активный шаг меняется — права пересчитываем.
|
||||||
|
}, [itemId, approverService, context, data.Employee, decisionSeq]);
|
||||||
|
|
||||||
if (loading) {
|
if (loading) {
|
||||||
return <div className={styles.state}>Загрузка заявки…</div>;
|
return <div className={styles.state}>Загрузка заявки…</div>;
|
||||||
}
|
}
|
||||||
@@ -103,7 +177,23 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
const sectionProps = { data, set: NOOP_SET, context };
|
// Реальный (не заглушка) сеттер: единственное поле, которое можно менять в
|
||||||
|
// этом режиме, — «Лицо, принимающее ОС/НМА», и то только пока
|
||||||
|
// assetsAcceptorEditable (остальные поля читают этот же set, но их readOnly
|
||||||
|
// держит ambient FormModeProvider — сеттер для них просто никогда не вызовется).
|
||||||
|
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
|
||||||
|
const sectionProps = { data, set, context, assetsAcceptorEditable };
|
||||||
|
|
||||||
|
// Сохраняет «Лицо, принимающее ОС/НМА» ПЕРЕД решением непосредственного
|
||||||
|
// руководителя (см. DecisionPanel.onBeforeDecide) и требует, чтобы поле было
|
||||||
|
// заполнено, — иначе бросает, и панель не применяет решение вовсе (тот же
|
||||||
|
// приём, что и обязательный комментарий при возврате/отклонении).
|
||||||
|
const saveAssetsAcceptor = async (): Promise<void> => {
|
||||||
|
if (!data.AssetsAcceptor) {
|
||||||
|
throw new Error('Укажите лицо, принимающее ОС/НМА, перед решением.');
|
||||||
|
}
|
||||||
|
await updateAssetsAcceptor(itemId, data.AssetsAcceptor, listId);
|
||||||
|
};
|
||||||
|
|
||||||
const notify = (): void => {
|
const notify = (): void => {
|
||||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||||
@@ -121,9 +211,10 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
// выводятся из заявления, заполнять его руками нечего — см. createClearance.ts).
|
// выводятся из заявления, заполнять его руками нечего — см. createClearance.ts).
|
||||||
// Свой статус решения при этом уже применён: неудача автосоздания не отменяет
|
// Свой статус решения при этом уже применён: неудача автосоздания не отменяет
|
||||||
// согласование, поэтому она показывается предупреждением, а не ошибкой заявки.
|
// согласование, поэтому она показывается предупреждением, а не ошибкой заявки.
|
||||||
const createClearance = (): void => {
|
const createClearance = (): Promise<void> => {
|
||||||
setClearanceError('');
|
setClearanceError('');
|
||||||
ensureClearanceForDismissal(context, itemId, listId)
|
setClearance('Создаём обходной лист по этому заявлению…');
|
||||||
|
return ensureClearanceForDismissal(context, itemId, listId)
|
||||||
.then((result) => {
|
.then((result) => {
|
||||||
setClearance(
|
setClearance(
|
||||||
result.existing
|
result.existing
|
||||||
@@ -135,17 +226,24 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
// только после перезагрузки страницы.
|
// только после перезагрузки страницы.
|
||||||
setData((prev) => ({ ...prev, ClearanceUrl: result.url }));
|
setData((prev) => ({ ...prev, ClearanceUrl: result.url }));
|
||||||
})
|
})
|
||||||
.catch((e) =>
|
.catch((e) => {
|
||||||
|
setClearance('');
|
||||||
setClearanceError(
|
setClearanceError(
|
||||||
`Заявление согласовано, но обходной лист создать не удалось: ${friendlyErrorMessage(e)} — заведите его вручную.`
|
`Заявление согласовано, но обходной лист создать не удалось: ${friendlyErrorMessage(e)} — заведите его вручную.`
|
||||||
)
|
);
|
||||||
);
|
});
|
||||||
};
|
};
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div>
|
<div>
|
||||||
<div className={`${styles.toolbar} rp-no-print`}>
|
<div className={`${styles.toolbar} rp-no-print`}>
|
||||||
<PrintButton />
|
{printGate === 'allowed' ? (
|
||||||
|
<PrintButton />
|
||||||
|
) : (
|
||||||
|
<span className={styles.printBlocked} title="Печать откроется после согласования обходного листа по этому увольнению">
|
||||||
|
Печать станет доступна после согласования обходного листа
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div className="rp-no-print">
|
<div className="rp-no-print">
|
||||||
@@ -179,16 +277,17 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
|||||||
service={approverService}
|
service={approverService}
|
||||||
requestId={itemId}
|
requestId={itemId}
|
||||||
search={(q) => approval.searchUsers(q)}
|
search={(q) => approval.searchUsers(q)}
|
||||||
|
onBeforeDecide={assetsAcceptorEditable ? saveAssetsAcceptor : undefined}
|
||||||
onDecided={(newStatus) => {
|
onDecided={(newStatus) => {
|
||||||
setStatus(newStatus);
|
setStatus(newStatus);
|
||||||
setDecisionSeq((n) => n + 1);
|
setDecisionSeq((n) => n + 1);
|
||||||
notify();
|
notify();
|
||||||
// «Согласовано» = маршрут заявления пройден целиком (фазы исполнения у
|
// «Согласовано» = маршрут заявления пройден целиком (фазы исполнения у
|
||||||
// него нет, см. README формы) — значит увольнение подтверждено и пора
|
// него нет, см. README формы) — значит увольнение подтверждено и пора
|
||||||
// заводить обходной лист.
|
// заводить обходной лист. Промис ВОЗВРАЩАЕМ: пока он не разрешится,
|
||||||
if (newStatus === REQUEST_STATUS.approved) {
|
// панель решения не пишет «Решение сохранено» (см. её onDecided) —
|
||||||
createClearance();
|
// иначе успех появлялся бы раньше, чем обходной лист создан.
|
||||||
}
|
return newStatus === REQUEST_STATUS.approved ? createClearance() : undefined;
|
||||||
}}
|
}}
|
||||||
onDelegated={() => {
|
onDelegated={() => {
|
||||||
setDecisionSeq((n) => n + 1);
|
setDecisionSeq((n) => n + 1);
|
||||||
|
|||||||
@@ -6,9 +6,8 @@
|
|||||||
**Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
|
**Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
|
||||||
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||||
`pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
`pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
||||||
RequestTypeId» в `docs/forms.md`). Тип нужно **завести в админке approval-route**
|
RequestTypeId» в `docs/forms.md`). Тип заведён в админке approval-route (id 16,
|
||||||
(pageUrl «hr-dismissal» + ссылка на список данных) — до этого форма откроется, но
|
список данных `/sites/requests/Lists/18`).
|
||||||
отправить заявку не даст: маршрут не резолвится.
|
|
||||||
|
|
||||||
## Маршрут
|
## Маршрут
|
||||||
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||||
@@ -19,27 +18,78 @@ RequestTypeId» в `docs/forms.md`). Тип нужно **завести в ад
|
|||||||
**Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
|
**Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
|
||||||
планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
|
планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
|
||||||
«Обходном листе».
|
«Обходном листе».
|
||||||
|
- Настроенный шаблон маршрута (approval-route, route id 17): шаг 1 —
|
||||||
|
`HeadType.Chief` (непосредственный руководитель увольняемого, тот же
|
||||||
|
`Employee/Manager?managerType=chief`, что резолвит «Лицо, принимающее ОС/НМА»,
|
||||||
|
см. ниже), шаг 2 — `HeadType.CompanyDirectors` (см. следующий раздел).
|
||||||
|
|
||||||
## Особое поведение
|
## Особое поведение
|
||||||
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
||||||
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
|
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
|
||||||
reloadKey матрицы включает `data.Employee` и `data.Position`.
|
reloadKey матрицы включает `data.Employee` и должность основной компании (см. ниже).
|
||||||
- **Автоподстановка при выборе сотрудника:** должность и организации — из справочника
|
- **Автоподстановка при выборе сотрудника:** вся таблица организаций — из ОДНОГО
|
||||||
`Employee/ByEmail` (`shared/dictionary`, должность из ПЕРВОЙ записи, чтобы должность
|
справочника `Employee/ByEmail` (`shared/dictionary`) — см. «Организация ·
|
||||||
и организация были парой из одной записи); структурное подразделение — из профиля
|
подразделение · должность».
|
||||||
SharePoint (`SPS-Department` через `approval.getProfileFields`).
|
- **«Организация · подразделение · должность»** (`OrganizationsTable`,
|
||||||
- **Структурное подразделение** (`Department`) — read-only, только из профиля: чтобы
|
`forms/Dismissal/sections/`) — ЕДИНСТВЕННОЕ место для компании, департамента и
|
||||||
не расходиться с профилем (как в «Обходном листе»). **Самостоятельное
|
должности, и на форме подачи (редактируемая), и в режиме просмотра (read-only) —
|
||||||
подразделение** (`StandaloneUnit`) в профиле не хранится — свободный ввод.
|
отдельных полей для них нет (были бы дублированием). `data.Organization:
|
||||||
- **Последний рабочий день** (`LastWorkingDay`) — обязателен, не может быть в прошлом
|
IOrganizationRecord[]` — массив `{company, department, position}`, компания и
|
||||||
(`min` у `input type=date` + проверка в `validate` на случай обхода UI).
|
департамент по каждой строке read-only; редактируется только должность ПЕРВОЙ
|
||||||
Срок предупреждения об увольнении (обычно месяц) **не** проверяется — договорную
|
(основной) записи — `primaryPosition(data.Organization)`, используется маршрутом
|
||||||
дату согласуют с работодателем, форма её только фиксирует.
|
(условие «IsManager») и обязательна валидацией; должности остальных компаний
|
||||||
|
(совместитель) — информационные. Справочник ничего не вернул (сотрудник не найден
|
||||||
|
в api.tnsu.kz) — таблица всё равно рендерится одной строкой с прочерками вместо
|
||||||
|
компании/департамента и редактируемой должностью: иначе такому человеку нечем было
|
||||||
|
бы заполнить обязательное поле.
|
||||||
|
|
||||||
|
**Хранение в SharePoint — три ПАРАЛЛЕЛЬНЫХ JSON-столбца**, не один общий блок:
|
||||||
|
`Organization`/`Department`/`Position` — каждый содержит JSON-массив строк
|
||||||
|
(компании / департаменты / должности), один и тот же индекс = одна и та же
|
||||||
|
запись во всех трёх. Сборка при чтении и разборка при записи — `zipOrganization`
|
||||||
|
/ `organizationColumn` в `model.ts`/`submit.ts`; не-JSON значение (заявка,
|
||||||
|
сохранённая до перехода на этот формат) не роняет чтение — трактуется как одна
|
||||||
|
компания (см. `parseOrganizationColumn`).
|
||||||
|
- **Самостоятельное подразделение** (`StandaloneUnit`) — в справочнике его нет,
|
||||||
|
свободный ввод, единственное текстовое поле, оставшееся отдельно от таблицы.
|
||||||
|
- **Последний рабочий день** (`LastWorkingDay`) — обязателен, не раньше чем через
|
||||||
|
`MIN_NOTICE_MONTHS` (1) календарный месяц от сегодня (`isoDatePlusMonths`,
|
||||||
|
`min` у `input type=date` + проверка в `validate` на случай обхода UI) — срок
|
||||||
|
предупреждения об увольнении по ТК. Более позднюю дату (по договорённости с
|
||||||
|
работодателем) форма не ограничивает.
|
||||||
- **Контактный телефон** (`Phone`) — обязателен, `PhoneInput` (маска).
|
- **Контактный телефон** (`Phone`) — обязателен, `PhoneInput` (маска).
|
||||||
- **Комментарий** (`Comment`) — необязательный свободный текст. Причины увольнения
|
- **Комментарий** (`Comment`) — необязательный свободный текст. Причины увольнения
|
||||||
отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
|
отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
|
||||||
- **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
|
- **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
|
||||||
|
|
||||||
|
## Совместители: организации таблицей, удаление синхронизировано с маршрутом
|
||||||
|
Сотрудник может числиться сразу в НЕСКОЛЬКИХ компаниях (совместительство).
|
||||||
|
Approval-route резолвит маршрут через `HeadType.CompanyDirectors` — ОДИН шаг
|
||||||
|
разворачивается в по одному согласующему НА КАЖДУЮ компанию сотрудника (директор,
|
||||||
|
а где нет такой штатной единицы — должностной эквивалент: `Главный механик` для
|
||||||
|
«ТОО KazPromService», `Генеральный директор» для «ТОО СТ Global», иначе
|
||||||
|
`Директор`, см. `DirectorPositionByCompany` в approval-route
|
||||||
|
`TemplateRouteService`). Это уже работает БЕЗ участия портала — сам approval-route
|
||||||
|
резолвит все компании сотрудника через `Employee/ByEmail`.
|
||||||
|
|
||||||
|
`OrganizationsTable` (см. предыдущий раздел) на форме подачи показывает кнопку
|
||||||
|
«убрать» у каждой строки, когда компаний больше одной. Если сотрудник реально не
|
||||||
|
увольняется из ВСЕХ компаний сразу, HR убирает лишние: `DismissalForm.handleRemoveOrganization`
|
||||||
|
|
||||||
|
1. снимает запись из `data.Organization` (массив всегда отражает ТЕКУЩИЙ, не
|
||||||
|
первоначальный, набор — так же восстанавливается при повторном открытии
|
||||||
|
черновика/возврата: `loadDismissalRequest` читает его из уже сохранённых
|
||||||
|
`Organization`/`Department`/`Position`, без обращения к справочнику заново);
|
||||||
|
2. независимо резолвит директора/эквивалента этой компании через
|
||||||
|
`getCompanyDirectorEmail` (`shared/dictionary/employeeLookup.service.ts` —
|
||||||
|
зеркало того же `DirectorPositionByCompany`, что и на бэкенде) и удаляет
|
||||||
|
строку с этим email из уже загруженной ПЛАНИРУЕМОЙ матрицы (`matrix.remove`).
|
||||||
|
|
||||||
|
Убирать согласующего из матрицы вручную (кнопкой самой матрицы) при этом не нужно
|
||||||
|
— это best-effort синхронизация: если матрица ещё не загрузилась или директор не
|
||||||
|
нашёлся, компания всё равно снимается из заявления, а несовпадение в матрице HR
|
||||||
|
поправит вручную через саму матрицу (она и так редактируема).
|
||||||
|
|
||||||
## Согласовано → обходной лист создаётся сам
|
## Согласовано → обходной лист создаётся сам
|
||||||
Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
|
Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
|
||||||
портал заводит по нему **обходной лист** — `ensureClearanceForDismissal`
|
портал заводит по нему **обходной лист** — `ensureClearanceForDismissal`
|
||||||
@@ -83,14 +133,47 @@ approval-route (`getPlannedMatrix` для фаз «Согласование» и
|
|||||||
- Тип заявки `clearance-form` должен быть заведён в админке approval-route — иначе
|
- Тип заявки `clearance-form` должен быть заведён в админке approval-route — иначе
|
||||||
создание падает на резолве `RequestTypeId`.
|
создание падает на резолве `RequestTypeId`.
|
||||||
|
|
||||||
|
## Печать заблокирована до согласования обходного листа
|
||||||
|
`DismissalView` не показывает `PrintButton`, пока парный обходной лист не дошёл
|
||||||
|
хотя бы до статуса «Согласовано» (или дальше — «Выполнение»/«Закрыта», если у
|
||||||
|
него есть исполнители): печатать заявление раньше значит выдать документ до того,
|
||||||
|
как процесс увольнения (карты, суммы к списанию) подтверждён целиком. Статус
|
||||||
|
читается НАПРЯМУЮ по `ClearanceUrl` (`parseRoute` вытаскивает `itemId`/`listId`
|
||||||
|
из самой ссылки, `loadClearanceRequest` — статус) — отдельного поля-дублёра нет.
|
||||||
|
Пока `ClearanceUrl` пуст (обходной лист ещё не создан/не удалось создать) —
|
||||||
|
печать тоже заблокирована, печатать нечего.
|
||||||
|
|
||||||
|
## «Лицо, принимающее ОС/НМА»
|
||||||
|
Колонка `AssetsAcceptor` (People) — кто принимает основные средства/НМА
|
||||||
|
увольняемого. Обязательна, но заполняет её **не заявитель**, а **непосредственный
|
||||||
|
руководитель** увольняемого — тот, кого approval-route резолвит для
|
||||||
|
`HeadType.Chief` (`Employee/Manager?managerType=chief`, см. «Маршрут» выше).
|
||||||
|
|
||||||
|
- В форме подачи поле показывается read-only (обычно пустое) — просто
|
||||||
|
информирует, что это будет заполнено позже.
|
||||||
|
- В `DismissalView` поле редактируемо ТОЛЬКО когда одновременно: (а) у текущего
|
||||||
|
пользователя сейчас активный шаг решения (`getPendingRowForCurrentUser`), и (б)
|
||||||
|
его e-mail совпадает с результатом `getManagerEmail(..., 'chief')` для
|
||||||
|
`data.Employee` — проверка по ИДЕНТИЧНОСТИ, а не по должности (в отличие от
|
||||||
|
`approverRights.ts` «Обходного листа»: здесь должность руководителя может быть
|
||||||
|
любой).
|
||||||
|
- Обязательность применяется НЕ на уровне списка (иначе создание заявки падало
|
||||||
|
бы — поле нечем заполнить до решения руководителя), а через
|
||||||
|
`DecisionPanel.onBeforeDecide`: пустое поле бросает ошибку ДО применения
|
||||||
|
решения (approve/return/reject — API не различает, какое именно) и сохраняет
|
||||||
|
значение сразу перед ним, тем же приёмом, что «Обходной лист» использует для
|
||||||
|
своих отметок.
|
||||||
|
|
||||||
## Отличия от «Обходной лист» (clearance-form)
|
## Отличия от «Обходной лист» (clearance-form)
|
||||||
Обходной лист оформляет HR **после** решения об увольнении (обход подразделений,
|
Обходной лист оформляет HR **после** решения об увольнении (обход подразделений,
|
||||||
карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
|
карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
|
||||||
полей всего восемь, отметок подразделений нет.
|
полей всего восемь, отметок подразделений нет.
|
||||||
|
|
||||||
## Секции формы
|
## Секции формы
|
||||||
RequestSection (сотрудник · должность · структурное подразделение · самостоятельное
|
RequestSection (сотрудник · организация/департамент/должность (таблица —
|
||||||
подразделение · организация · последний рабочий день · телефон · комментарий)
|
редактируемая на форме подачи, read-only в просмотре) · самостоятельное
|
||||||
|
подразделение · последний рабочий день · телефон · комментарий · ссылка на
|
||||||
|
обходной лист · лицо, принимающее ОС/НМА)
|
||||||
|
|
||||||
## Точки входа
|
## Точки входа
|
||||||
- rptype: `hr-dismissal`
|
- rptype: `hr-dismissal`
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ import {
|
|||||||
import { requestLinkUrl } from '../../shared/routing';
|
import { requestLinkUrl } from '../../shared/routing';
|
||||||
import { FORM_ID as CLEARANCE_FORM_ID, EMPTY_DATA as CLEARANCE_EMPTY, IFormData as IClearanceData } from '../Clearance/model';
|
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 { clearanceApprovalService, saveClearanceRequest } from '../Clearance/submit';
|
||||||
import { FORM_ID } from './model';
|
import { FORM_ID, primaryPosition, zipOrganization } from './model';
|
||||||
|
|
||||||
/** Результат автосоздания обходного листа по согласованному заявлению. */
|
/** Результат автосоздания обходного листа по согласованному заявлению. */
|
||||||
export interface IClearanceForDismissal {
|
export interface IClearanceForDismissal {
|
||||||
@@ -104,7 +104,16 @@ export async function ensureClearanceForDismissal(
|
|||||||
if (!employeeEmail) {
|
if (!employeeEmail) {
|
||||||
throw new Error('В заявлении не заполнен сотрудник — обходной лист не создан.');
|
throw new Error('В заявлении не заполнен сотрудник — обходной лист не создан.');
|
||||||
}
|
}
|
||||||
const position = (item.Position as string) || '';
|
// Три параллельных JSON-столбца (см. IOrganizationRecord) → таблица компаний;
|
||||||
|
// обходному листу нужна только ОСНОВНАЯ (первая) — должность для условия
|
||||||
|
// «IsManager» и подразделение для карточки, плюс joined-текст для его
|
||||||
|
// собственного read-only поля Organization (другой формат, см. Clearance/model.ts).
|
||||||
|
const organization = zipOrganization(item.Organization, item.Department, item.Position);
|
||||||
|
const position = primaryPosition(organization);
|
||||||
|
const department = organization[0]?.department || '';
|
||||||
|
const organizationText = organization
|
||||||
|
.map((r) => (r.position ? `${r.company} — ${r.position}` : r.company))
|
||||||
|
.join('\n');
|
||||||
|
|
||||||
// Тип заявки и партиция для записи — как у обычной подачи обходного листа
|
// Тип заявки и партиция для записи — как у обычной подачи обходного листа
|
||||||
// (см. ClearanceForm.save): партицию спрашиваем прямо сейчас, именно этот вызов
|
// (см. ClearanceForm.save): партицию спрашиваем прямо сейчас, именно этот вызов
|
||||||
@@ -124,10 +133,10 @@ export async function ensureClearanceForDismissal(
|
|||||||
...CLEARANCE_EMPTY,
|
...CLEARANCE_EMPTY,
|
||||||
Employee: employeeEmail,
|
Employee: employeeEmail,
|
||||||
Position: position,
|
Position: position,
|
||||||
Department: (item.Department as string) || '',
|
Department: department,
|
||||||
// Последний рабочий день заявления = дата расторжения договора в обходном листе.
|
// Последний рабочий день заявления = дата расторжения договора в обходном листе.
|
||||||
TerminationDate: ((item.LastWorkingDay as string) || '').slice(0, 10),
|
TerminationDate: ((item.LastWorkingDay as string) || '').slice(0, 10),
|
||||||
Organization: (item.Organization as string) || ''
|
Organization: organizationText
|
||||||
};
|
};
|
||||||
|
|
||||||
// Статус — как при обычной отправке: с согласующими «На согласовании», без них
|
// Статус — как при обычной отправке: с согласующими «На согласовании», без них
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import { getSP } from '../../shared/pnp/pnpjs';
|
import { getSP } from '../../shared/pnp/pnpjs';
|
||||||
import { dataListTitle } from '../../shared/listTitles';
|
import { dataListTitle } from '../../shared/listTitles';
|
||||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
import { FORM_ID, IFormData, EMPTY_DATA, zipOrganization } from './model';
|
||||||
|
|
||||||
export interface ILoadedRequest {
|
export interface ILoadedRequest {
|
||||||
data: IFormData;
|
data: IFormData;
|
||||||
@@ -36,25 +36,26 @@ export async function loadDismissalRequest(itemId: number, listId?: string): Pro
|
|||||||
'RequestStatus',
|
'RequestStatus',
|
||||||
'RequestUniqueCode',
|
'RequestUniqueCode',
|
||||||
'Employee/Title',
|
'Employee/Title',
|
||||||
'Employee/EMail'
|
'Employee/EMail',
|
||||||
|
'AssetsAcceptor/EMail'
|
||||||
)
|
)
|
||||||
.expand('Employee')()) as Record<string, unknown>;
|
.expand('Employee', 'AssetsAcceptor')()) as Record<string, unknown>;
|
||||||
|
|
||||||
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
|
const employee = item.Employee as { Title?: string; EMail?: string } | undefined;
|
||||||
|
const assetsAcceptor = item.AssetsAcceptor as { EMail?: string } | undefined;
|
||||||
const lastDay = (item.LastWorkingDay as string) || '';
|
const lastDay = (item.LastWorkingDay as string) || '';
|
||||||
|
|
||||||
const data: IFormData = {
|
const data: IFormData = {
|
||||||
...EMPTY_DATA,
|
...EMPTY_DATA,
|
||||||
Employee: employee?.EMail || '',
|
Employee: employee?.EMail || '',
|
||||||
Position: (item.Position as string) || '',
|
|
||||||
Department: (item.Department as string) || '',
|
|
||||||
StandaloneUnit: (item.StandaloneUnit as string) || '',
|
StandaloneUnit: (item.StandaloneUnit as string) || '',
|
||||||
LastWorkingDay: lastDay.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
LastWorkingDay: lastDay.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||||
Phone: (item.Phone as string) || '',
|
Phone: (item.Phone as string) || '',
|
||||||
Comment: (item.Comment as string) || '',
|
Comment: (item.Comment as string) || '',
|
||||||
Organization: (item.Organization as string) || '',
|
Organization: zipOrganization(item.Organization, item.Department, item.Position),
|
||||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||||
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || ''
|
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || '',
|
||||||
|
AssetsAcceptor: assetsAcceptor?.EMail || ''
|
||||||
};
|
};
|
||||||
|
|
||||||
return {
|
return {
|
||||||
|
|||||||
@@ -7,6 +7,71 @@ import { RequestTypeId } from '../../models/types';
|
|||||||
*/
|
*/
|
||||||
export const FORM_ID: RequestTypeId = 'hr-dismissal';
|
export const FORM_ID: RequestTypeId = 'hr-dismissal';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Одна строка таблицы организаций (см. forms/Dismissal/sections/
|
||||||
|
* OrganizationsTable.tsx) — компания + департамент + должность СОТРУДНИКА В
|
||||||
|
* ЭТОЙ компании.
|
||||||
|
*
|
||||||
|
* В списке SharePoint компания/департамент/должность хранятся КАЖДАЯ В СВОЁМ
|
||||||
|
* столбце (`Organization`/`Department`/`Position` — три Note-колонки), но КАК
|
||||||
|
* JSON-МАССИВ строк в каждой, а не как раньше — плоским значением/joined-строкой:
|
||||||
|
* `Organization: '["ТОО A","ТОО B"]'`, `Department: '["Служба X","Служба Y"]'`,
|
||||||
|
* `Position: '["Начальник","Инженер"]'` — три ПАРАЛЛЕЛЬНЫХ массива одной длины,
|
||||||
|
* один индекс = одна компания. IFormData/приложение работают с ними уже
|
||||||
|
* СОБРАННЫМИ в этот единый тип — сборка (load.ts, zipOrganization) и разборка
|
||||||
|
* по трём столбцам (submit.ts, splitOrganization) — на границе с SharePoint,
|
||||||
|
* остальной код таблицу как массив строк никогда не видит.
|
||||||
|
*
|
||||||
|
* Именно эта структура и позволяет показать таблицу целиком в режиме просмотра
|
||||||
|
* заявки (DismissalView) — раньше Position/Department хранили только ПЕРВУЮ
|
||||||
|
* компанию, а Organization — плоский текст без департамента.
|
||||||
|
*/
|
||||||
|
export interface IOrganizationRecord {
|
||||||
|
company: string;
|
||||||
|
department: string;
|
||||||
|
position: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Должность ОСНОВНОЙ (первой) компании — читает маршрут согласования (условие «IsManager»), требуется валидацией. '' — компания не выбрана/справочник пуст. */
|
||||||
|
export function primaryPosition(organization: IOrganizationRecord[]): string {
|
||||||
|
return organization[0]?.position || '';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Разобрать один из трёх параллельных столбцов (Organization/Department/
|
||||||
|
* Position, см. IOrganizationRecord) — JSON-массив строк. Не валидный JSON —
|
||||||
|
* заявка сохранена ДО перехода на этот формат (столбец был скалярным Text/
|
||||||
|
* joined-строкой): не роняем чтение, трактуем как ОДНУ компанию — единственное,
|
||||||
|
* что старый формат вообще мог хранить (split(' — ')[0] на однострочном
|
||||||
|
* скаляре — no-op, поэтому одна функция годится и для Position/Department, и
|
||||||
|
* для легаси Organization вида «Компания — Должность» построчно).
|
||||||
|
*/
|
||||||
|
export function parseOrganizationColumn(raw: unknown): string[] {
|
||||||
|
if (typeof raw !== 'string' || raw.trim() === '') return [];
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(raw);
|
||||||
|
return Array.isArray(parsed) ? parsed.map(String) : [String(parsed)];
|
||||||
|
} catch {
|
||||||
|
return raw.split('\n').map((line) => line.split(' — ')[0]);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Собрать таблицу организаций из трёх столбцов — см. IOrganizationRecord. */
|
||||||
|
export function zipOrganization(
|
||||||
|
companiesRaw: unknown,
|
||||||
|
departmentsRaw: unknown,
|
||||||
|
positionsRaw: unknown
|
||||||
|
): IOrganizationRecord[] {
|
||||||
|
const companies = parseOrganizationColumn(companiesRaw);
|
||||||
|
const departments = parseOrganizationColumn(departmentsRaw);
|
||||||
|
const positions = parseOrganizationColumn(positionsRaw);
|
||||||
|
return companies.map((company, i) => ({
|
||||||
|
company,
|
||||||
|
department: departments[i] || '',
|
||||||
|
position: positions[i] || ''
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Данные формы «Заявление на увольнение» (штатный сотрудник) по бумажному шаблону
|
* Данные формы «Заявление на увольнение» (штатный сотрудник) по бумажному шаблону
|
||||||
* «Шаблон Заявление на увольнение ШТАТ.docx»: расторжение трудового договора по
|
* «Шаблон Заявление на увольнение ШТАТ.docx»: расторжение трудового договора по
|
||||||
@@ -21,10 +86,7 @@ export const FORM_ID: RequestTypeId = 'hr-dismissal';
|
|||||||
export interface IFormData {
|
export interface IFormData {
|
||||||
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
||||||
Employee: string;
|
Employee: string;
|
||||||
Position: string;
|
/** Самостоятельное подразделение — в справочнике его нет, вводится вручную. */
|
||||||
/** Структурное подразделение — из профиля (SPS-Department), read-only. */
|
|
||||||
Department: string;
|
|
||||||
/** Самостоятельное подразделение — в профиле его нет, вводится вручную. */
|
|
||||||
StandaloneUnit: string;
|
StandaloneUnit: string;
|
||||||
/** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
|
/** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
|
||||||
LastWorkingDay: string;
|
LastWorkingDay: string;
|
||||||
@@ -33,17 +95,30 @@ export interface IFormData {
|
|||||||
/** Необязательный комментарий заявителя. */
|
/** Необязательный комментарий заявителя. */
|
||||||
Comment: string;
|
Comment: string;
|
||||||
/**
|
/**
|
||||||
* Организации сотрудника (`\n`-joined «Компания — должность» на строку) —
|
* Таблица компаний сотрудника (компания · департамент · должность на
|
||||||
* подтягивается автоматически из Employee/ByEmail при выборе Employee,
|
* каждую) — подтягивается автоматически из Employee/ByEmail при выборе
|
||||||
* read-only (см. shared/ui/OrganizationField).
|
* Employee. Первая запись — основная компания: её должность используется
|
||||||
|
* маршрутом (см. primaryPosition) и остаётся редактируемой (см.
|
||||||
|
* OrganizationsTable); должности/департаменты остальных — только для
|
||||||
|
* просмотра. О ХРАНЕНИИ В СПИСКЕ (три параллельных JSON-массива по
|
||||||
|
* столбцам) — см. IOrganizationRecord.
|
||||||
*/
|
*/
|
||||||
Organization: string;
|
Organization: IOrganizationRecord[];
|
||||||
/**
|
/**
|
||||||
* Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
|
* Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
|
||||||
* `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
|
* `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
|
||||||
* createClearance.ts) и не даёт править — только показывает переходом.
|
* createClearance.ts) и не даёт править — только показывает переходом.
|
||||||
*/
|
*/
|
||||||
ClearanceUrl: string;
|
ClearanceUrl: string;
|
||||||
|
/**
|
||||||
|
* Лицо, принимающее основные средства/нематериальные активы увольняемого —
|
||||||
|
* People, колонка `AssetsAcceptor`. Заполняет НЕ заявитель, а непосредственный
|
||||||
|
* руководитель увольняемого на своём шаге согласования (см. DismissalView) —
|
||||||
|
* поэтому здесь нет отдельного плейсхолдера/секции формы подачи: поле в
|
||||||
|
* IFormData только чтобы форма подачи не роняла это значение при пересохранении
|
||||||
|
* (черновик/возврат), сама секция его не показывает и не редактирует.
|
||||||
|
*/
|
||||||
|
AssetsAcceptor: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Обновление одного поля формы с сохранением типа значения. */
|
/** Обновление одного поля формы с сохранением типа значения. */
|
||||||
@@ -64,15 +139,16 @@ export interface ISectionProps {
|
|||||||
|
|
||||||
export const EMPTY_DATA: IFormData = {
|
export const EMPTY_DATA: IFormData = {
|
||||||
Employee: '',
|
Employee: '',
|
||||||
Position: '',
|
|
||||||
Department: '',
|
|
||||||
StandaloneUnit: '',
|
StandaloneUnit: '',
|
||||||
LastWorkingDay: '',
|
LastWorkingDay: '',
|
||||||
Phone: '',
|
Phone: '',
|
||||||
Comment: '',
|
Comment: '',
|
||||||
Organization: '',
|
Organization: [],
|
||||||
ClearanceUrl: ''
|
ClearanceUrl: '',
|
||||||
|
AssetsAcceptor: ''
|
||||||
};
|
};
|
||||||
|
|
||||||
/** Плейсхолдер для поля выбора сотрудника. */
|
/** Плейсхолдер для поля выбора сотрудника. */
|
||||||
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
|
||||||
|
/** Заявление нужно подавать не позднее чем за столько месяцев до последнего рабочего дня. */
|
||||||
|
export const MIN_NOTICE_MONTHS = 1;
|
||||||
|
|||||||
@@ -6,13 +6,15 @@
|
|||||||
|
|
||||||
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
|
||||||
{ "internalName": "Position", "title": "Должность", "type": "Text" },
|
{ "internalName": "Position", "title": "Должность", "type": "Text" },
|
||||||
{ "internalName": "Department", "title": "Структурное подразделение", "type": "Text" },
|
{ "internalName": "Department", "title": "Департамент", "type": "Text" },
|
||||||
{ "internalName": "StandaloneUnit", "title": "Самостоятельное подразделение", "type": "Text" },
|
{ "internalName": "StandaloneUnit", "title": "Самостоятельное подразделение", "type": "Text" },
|
||||||
{ "internalName": "LastWorkingDay", "title": "Последний рабочий день", "type": "DateTime", "dateOnly": true },
|
{ "internalName": "LastWorkingDay", "title": "Последний рабочий день", "type": "DateTime", "dateOnly": true },
|
||||||
{ "internalName": "Phone", "title": "Контактный телефон", "type": "Text" },
|
{ "internalName": "Phone", "title": "Контактный телефон", "type": "Text" },
|
||||||
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||||
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||||
|
|
||||||
{ "internalName": "ClearanceUrl", "title": "Ссылка на обходной лист", "type": "Url" }
|
{ "internalName": "ClearanceUrl", "title": "Ссылка на обходной лист", "type": "Url" },
|
||||||
|
|
||||||
|
{ "internalName": "AssetsAcceptor", "title": "Лицо, принимающее ОС/НМА", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,77 @@
|
|||||||
|
@import '../../../../../styles/design-tokens';
|
||||||
|
|
||||||
|
.table {
|
||||||
|
width: 100%;
|
||||||
|
border-collapse: collapse;
|
||||||
|
font-family: $font-sans;
|
||||||
|
font-size: 13.5px;
|
||||||
|
}
|
||||||
|
|
||||||
|
thead th {
|
||||||
|
box-sizing: border-box;
|
||||||
|
padding: 6px 13px;
|
||||||
|
text-align: left;
|
||||||
|
font-weight: 500;
|
||||||
|
font-size: 12px;
|
||||||
|
color: $gray-500;
|
||||||
|
}
|
||||||
|
|
||||||
|
.company,
|
||||||
|
.department,
|
||||||
|
.position {
|
||||||
|
box-sizing: border-box;
|
||||||
|
padding: 11px 13px;
|
||||||
|
border: 1px solid $gray-200;
|
||||||
|
border-right: 0;
|
||||||
|
background: $gray-50;
|
||||||
|
color: $gray-700;
|
||||||
|
}
|
||||||
|
|
||||||
|
.company {
|
||||||
|
width: 35%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.department {
|
||||||
|
width: 30%;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Ячейка должности ПЕРВОЙ строки хранит TextInput (у него свой паддинг/рамка) —
|
||||||
|
// у самой ячейки паддинг убран, иначе поле ввода дублировало бы рамку карточки.
|
||||||
|
.positionInput {
|
||||||
|
box-sizing: border-box;
|
||||||
|
border: 1px solid $gray-200;
|
||||||
|
border-right: 0;
|
||||||
|
padding: 0;
|
||||||
|
|
||||||
|
input {
|
||||||
|
width: 100%;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.action {
|
||||||
|
width: 1%;
|
||||||
|
white-space: nowrap;
|
||||||
|
border: 1px solid $gray-200;
|
||||||
|
border-left: 0;
|
||||||
|
background: $gray-50;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.remove {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
padding: 4px;
|
||||||
|
border: 0;
|
||||||
|
border-radius: $r-sm;
|
||||||
|
background: transparent;
|
||||||
|
color: $gray-500;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: color .18s, background .18s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
color: $red-500;
|
||||||
|
background: $red-50;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
import * as React from 'react';
|
||||||
|
import { FormField, Icon, TextInput } from '../../../shared/ui';
|
||||||
|
import { IOrganizationRecord } from '../model';
|
||||||
|
import styles from './OrganizationsTable.module.scss';
|
||||||
|
|
||||||
|
interface IOrganizationsTableProps {
|
||||||
|
records: IOrganizationRecord[];
|
||||||
|
/**
|
||||||
|
* Должность ПЕРВОЙ (основной) компании редактируема — единственная ячейка
|
||||||
|
* таблицы, у которой это так: маршрут согласования резолвится по НЕЙ (см.
|
||||||
|
* DismissalForm — fieldValues.Position), должности остальных компаний
|
||||||
|
* (совместитель) — только для просмотра, ставить им что-то в соответствие
|
||||||
|
* незачем. Не задано — вся таблица read-only (режим просмотра, DismissalView).
|
||||||
|
*/
|
||||||
|
onChangePosition?: (value: string) => void;
|
||||||
|
/**
|
||||||
|
* Убрать компанию из заявления — есть только на форме подачи (см.
|
||||||
|
* DismissalForm.handleRemoveOrganization), не в режиме просмотра: там состав
|
||||||
|
* компаний уже зафиксирован в отправленной заявке и маршруте.
|
||||||
|
*/
|
||||||
|
onRemove?: (company: string) => void;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Организации сотрудника — ЕДИНСТВЕННОЕ место для компании/департамента/
|
||||||
|
* должности, и на форме подачи (редактируемая — см. onChangePosition/onRemove),
|
||||||
|
* и в режиме просмотра заявки (read-only, те же данные из сохранённой заявки,
|
||||||
|
* а не live-запрос к справочнику — см. DismissalView). Раньше это были
|
||||||
|
* отдельные поля над таблицей — убраны как дублирование того, что таблица и
|
||||||
|
* так показывает.
|
||||||
|
*
|
||||||
|
* Интерактивная таблица, а не список строк: у сотрудника, оформленного в
|
||||||
|
* НЕСКОЛЬКИХ компаниях одновременно, увольнение затрагивает директора/
|
||||||
|
* должностного эквивалента КАЖДОЙ из них (маршрут `HeadType.CompanyDirectors`
|
||||||
|
* в approval-route резолвит их всех). Если реально уходит только из одной —
|
||||||
|
* заявитель убирает лишние компании ЗДЕСЬ, и соответствующий согласующий
|
||||||
|
* убирается из матрицы автоматически (см. DismissalForm.handleRemoveOrganization)
|
||||||
|
* — не нужно отдельно искать его в матрице и удалять там вручную.
|
||||||
|
*
|
||||||
|
* Пустой records в РЕДАКТИРУЕМОМ режиме (справочник api.tnsu.kz не нашёл
|
||||||
|
* сотрудника) — не «ничего не показываем», а ОДНА строка с прочерками и
|
||||||
|
* редактируемой должностью: без этого заявление на человека без карточки в
|
||||||
|
* справочнике нельзя было бы подать вовсе (некуда вписать должность вручную —
|
||||||
|
* а маршрут согласования без неё не резолвит условие «IsManager»).
|
||||||
|
*/
|
||||||
|
export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({ records, onChangePosition, onRemove }) => {
|
||||||
|
const rows = records.length > 0 ? records : [undefined];
|
||||||
|
|
||||||
|
return (
|
||||||
|
<FormField label="Организация · подразделение · должность" required={!!onChangePosition} full>
|
||||||
|
<table className={styles.table}>
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th className={styles.company}>Компания</th>
|
||||||
|
<th className={styles.department}>Департамент</th>
|
||||||
|
<th className={styles.position}>Должность</th>
|
||||||
|
{onRemove && <th className={styles.action} />}
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{rows.map((r, i) => (
|
||||||
|
<tr key={r?.company || 'manual'}>
|
||||||
|
<td className={styles.company}>{r?.company || '—'}</td>
|
||||||
|
<td className={styles.department}>{r?.department || '—'}</td>
|
||||||
|
{i === 0 && onChangePosition ? (
|
||||||
|
<td className={styles.positionInput}>
|
||||||
|
<TextInput value={r?.position || ''} onChange={onChangePosition} placeholder="Введите должность" />
|
||||||
|
</td>
|
||||||
|
) : (
|
||||||
|
<td className={styles.position}>{r?.position || '—'}</td>
|
||||||
|
)}
|
||||||
|
{onRemove && (
|
||||||
|
<td className={styles.action}>
|
||||||
|
{r && records.length > 1 && (
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className={styles.remove}
|
||||||
|
onClick={() => onRemove(r.company)}
|
||||||
|
aria-label={`Убрать «${r.company}» из заявления`}
|
||||||
|
title="Сотрудник не увольняется из этой компании — убрать из заявления"
|
||||||
|
>
|
||||||
|
<Icon name="close" size="sm" />
|
||||||
|
</button>
|
||||||
|
)}
|
||||||
|
</td>
|
||||||
|
)}
|
||||||
|
</tr>
|
||||||
|
))}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</FormField>
|
||||||
|
);
|
||||||
|
};
|
||||||
@@ -1,28 +1,33 @@
|
|||||||
import * as React from 'react';
|
import * as React from 'react';
|
||||||
import {
|
import { CollapseSection, FormField, TextInput, TextArea, PhoneInput, PeopleField, LinkField } from '../../../shared/ui';
|
||||||
CollapseSection,
|
import { ISectionProps, EMPLOYEE_PLACEHOLDER, MIN_NOTICE_MONTHS } from '../model';
|
||||||
FormField,
|
import { isoDatePlusMonths } from '../../../shared/dateUtils';
|
||||||
TextInput,
|
import { OrganizationsTable } from './OrganizationsTable';
|
||||||
TextArea,
|
|
||||||
PhoneInput,
|
|
||||||
PeopleField,
|
|
||||||
OrganizationField,
|
|
||||||
LinkField
|
|
||||||
} from '../../../shared/ui';
|
|
||||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
|
||||||
import { isoDatePlusDays } from '../../../shared/dateUtils';
|
|
||||||
|
|
||||||
// Структурное подразделение подтягивается из профиля при выборе сотрудника (см.
|
interface IRequestSectionProps extends ISectionProps {
|
||||||
// DismissalForm.handleEmployeeChange — SharePoint User Profile), свободный ввод
|
/**
|
||||||
// намеренно убран, чтобы не расходиться с профилем — как в «Обходном листе».
|
* Убрать компанию — есть только на форме подачи (DismissalForm), делает
|
||||||
const NOOP = (): void => undefined;
|
* OrganizationsTable редактируемой (кнопка «убрать» + должность первой
|
||||||
|
* компании). Не задано — DismissalView, таблица read-only.
|
||||||
|
*/
|
||||||
|
onRemoveOrganization?: (company: string) => void;
|
||||||
|
/** Поле «Лицо, принимающее ОС/НМА» редактируемо — см. DismissalView. */
|
||||||
|
assetsAcceptorEditable?: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Единственная секция формы «Заявление на увольнение»: кто увольняется, где
|
* Единственная секция формы «Заявление на увольнение»: кто увольняется, где
|
||||||
* работает, последний рабочий день и контакты. Набор полей — с бумажного шаблона
|
* работает, последний рабочий день и контакты. Набор полей — с бумажного шаблона
|
||||||
* «Заявление на увольнение ШТАТ».
|
* «Заявление на увольнение ШТАТ».
|
||||||
*/
|
*/
|
||||||
export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, onEmployeeChange }) => (
|
export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||||
|
data,
|
||||||
|
set,
|
||||||
|
context,
|
||||||
|
onEmployeeChange,
|
||||||
|
onRemoveOrganization,
|
||||||
|
assetsAcceptorEditable
|
||||||
|
}) => (
|
||||||
<CollapseSection title="Заявление на увольнение" icon="document">
|
<CollapseSection title="Заявление на увольнение" icon="document">
|
||||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||||
<PeopleField
|
<PeopleField
|
||||||
@@ -32,43 +37,36 @@ export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, on
|
|||||||
placeholder={EMPLOYEE_PLACEHOLDER}
|
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||||
/>
|
/>
|
||||||
</FormField>
|
</FormField>
|
||||||
{/* Подставляется по выбранному сотруднику, но остаётся редактируемым: если
|
{/* ЕДИНСТВЕННОЕ место для компании/департамента/должности — и на форме
|
||||||
справочник организаций не заполнен, должность нужно ввести вручную —
|
подачи (редактируемая, onRemoveOrganization задан), и в просмотре
|
||||||
иначе шаг маршрута с условием по должности не соберётся. */}
|
(read-only, ничего не передано). Отдельных полей для них нет — были бы
|
||||||
<FormField label="Должность" htmlFor="Position" required>
|
дублированием того, что уже показывает эта таблица. */}
|
||||||
<TextInput
|
<OrganizationsTable
|
||||||
id="Position"
|
records={data.Organization}
|
||||||
value={data.Position}
|
onChangePosition={
|
||||||
onChange={(v) => set('Position', v)}
|
onRemoveOrganization &&
|
||||||
placeholder="Подставится автоматически по выбранному сотруднику"
|
((v) =>
|
||||||
/>
|
set(
|
||||||
</FormField>
|
'Organization',
|
||||||
<FormField label="Структурное подразделение" htmlFor="Department">
|
data.Organization.length > 0
|
||||||
<TextInput
|
? data.Organization.map((r, i) => (i === 0 ? { ...r, position: v } : r))
|
||||||
id="Department"
|
: [{ company: '', department: '', position: v }]
|
||||||
value={data.Department}
|
))
|
||||||
onChange={NOOP}
|
}
|
||||||
readOnly
|
onRemove={onRemoveOrganization}
|
||||||
placeholder="Подставится автоматически по выбранному сотруднику"
|
/>
|
||||||
/>
|
|
||||||
</FormField>
|
|
||||||
<FormField label="Самостоятельное подразделение" htmlFor="StandaloneUnit">
|
<FormField label="Самостоятельное подразделение" htmlFor="StandaloneUnit">
|
||||||
<TextInput
|
<TextInput id="StandaloneUnit" value={data.StandaloneUnit} onChange={(v) => set('StandaloneUnit', v)} />
|
||||||
id="StandaloneUnit"
|
|
||||||
value={data.StandaloneUnit}
|
|
||||||
onChange={(v) => set('StandaloneUnit', v)}
|
|
||||||
/>
|
|
||||||
</FormField>
|
</FormField>
|
||||||
<OrganizationField value={data.Organization} />
|
{/* Заявление подаётся заранее — датой увольнения нельзя назначить ближе,
|
||||||
{/* Датой увольнения нельзя назначить прошедший день: заявление подаётся
|
чем через MIN_NOTICE_MONTHS месяц от сегодня (min). */}
|
||||||
заранее, а не задним числом (min = сегодня). */}
|
|
||||||
<FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
|
<FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
|
||||||
<TextInput
|
<TextInput
|
||||||
id="LastWorkingDay"
|
id="LastWorkingDay"
|
||||||
type="date"
|
type="date"
|
||||||
value={data.LastWorkingDay}
|
value={data.LastWorkingDay}
|
||||||
onChange={(v) => set('LastWorkingDay', v)}
|
onChange={(v) => set('LastWorkingDay', v)}
|
||||||
min={isoDatePlusDays(0)}
|
min={isoDatePlusMonths(MIN_NOTICE_MONTHS)}
|
||||||
/>
|
/>
|
||||||
</FormField>
|
</FormField>
|
||||||
<FormField label="Контактный телефон" htmlFor="Phone" required>
|
<FormField label="Контактный телефон" htmlFor="Phone" required>
|
||||||
@@ -84,5 +82,17 @@ export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, on
|
|||||||
url={data.ClearanceUrl}
|
url={data.ClearanceUrl}
|
||||||
text="Открыть обходной лист по этому увольнению"
|
text="Открыть обходной лист по этому увольнению"
|
||||||
/>
|
/>
|
||||||
|
{/* Заполняет НЕ заявитель, а непосредственный руководитель увольняемого на
|
||||||
|
своём шаге согласования (см. DismissalView) — здесь всегда read-only,
|
||||||
|
кроме как для него самого в момент его решения (assetsAcceptorEditable). */}
|
||||||
|
<FormField label="Лицо, принимающее ОС/НМА" htmlFor="AssetsAcceptor" required={assetsAcceptorEditable} full>
|
||||||
|
<PeopleField
|
||||||
|
context={context}
|
||||||
|
value={data.AssetsAcceptor}
|
||||||
|
onChange={(v) => set('AssetsAcceptor', v)}
|
||||||
|
placeholder="Начните вводить Ф.И.О. сотрудника…"
|
||||||
|
readOnly={assetsAcceptorEditable ? false : true}
|
||||||
|
/>
|
||||||
|
</FormField>
|
||||||
</CollapseSection>
|
</CollapseSection>
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -1,7 +1,43 @@
|
|||||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||||
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
||||||
import { ensureEmployee } from '../../shared/employee';
|
import { ensureEmployee } from '../../shared/employee';
|
||||||
import { FORM_ID, IFormData } from './model';
|
import { FORM_ID, IFormData, IOrganizationRecord } from './model';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Position/Department — ОБЩИЙ столбец сайта (эталон) для 8 форм портала, тип
|
||||||
|
* Text (однострочный) — SharePoint не позволяет там больше 255 символов, и
|
||||||
|
* перегрузка типа отсюда невозможна и не нужна: столбец общий, менять его тип
|
||||||
|
* значило бы менять его для всех 8 форм разом. Organization уже Note
|
||||||
|
* (многострочный, без этого лимита) — предел касается только двух из трёх.
|
||||||
|
* У реального совместителя (2-3 компании) JSON обычно укладывается на порядок
|
||||||
|
* ниже 255, но если однажды не уложится — лучше явная ошибка при сохранении,
|
||||||
|
* чем молча обрезанная запись (SharePoint либо обрежет остаток, либо вернёт
|
||||||
|
* ошибку на самом write — в обоих случаях тихо терять данные хуже).
|
||||||
|
*/
|
||||||
|
const TEXT_COLUMN_LIMIT = 255;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Один из трёх параллельных столбцов таблицы организаций (см.
|
||||||
|
* IOrganizationRecord) — JSON-массив значений по каждой компании, в том же
|
||||||
|
* порядке для всех трёх столбцов. Пустая таблица → null (а не '[]'), как и
|
||||||
|
* остальные необязательные поля здесь.
|
||||||
|
*/
|
||||||
|
function organizationColumn(
|
||||||
|
records: IOrganizationRecord[],
|
||||||
|
pick: (r: IOrganizationRecord) => string,
|
||||||
|
columnTitle: string,
|
||||||
|
limit?: number
|
||||||
|
// eslint-disable-next-line @rushstack/no-new-null -- SharePoint REST ожидает null, чтобы очистить поле
|
||||||
|
): string | null {
|
||||||
|
if (records.length === 0) return null;
|
||||||
|
const json = JSON.stringify(records.map(pick));
|
||||||
|
if (limit !== undefined && json.length > limit) {
|
||||||
|
throw new Error(
|
||||||
|
`Слишком много компаний для сохранения (столбец «${columnTitle}»: ${json.length} символов, лимит ${limit}) — уберите лишние в таблице «Организация».`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return json;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||||
@@ -22,7 +58,17 @@ function buildTitle(employeeName: string): string {
|
|||||||
return `Заявление на увольнение — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
return `Заявление на увольнение — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Поля элемента списка данных из модели формы (+ Employee по Id). */
|
/**
|
||||||
|
* Поля элемента списка данных из модели формы (+ Employee по Id).
|
||||||
|
*
|
||||||
|
* НЕ включает AssetsAcceptor: это поле заполняет непосредственный руководитель на
|
||||||
|
* своём шаге согласования (см. updateAssetsAcceptor и DismissalView), а не
|
||||||
|
* заявитель. Если бы buildItem писал его из data.AssetsAcceptor, повторное
|
||||||
|
* сохранение формы подачи (доработка/повторная отправка) отправляло бы то же
|
||||||
|
* значение назад — сейчас безвредно (round-trip), но при малейшем расхождении
|
||||||
|
* состояния незаметно бы затёрло то, что руководитель уже проставил. Проще и
|
||||||
|
* надёжнее вообще не трогать это поле из формы подачи.
|
||||||
|
*/
|
||||||
function buildItem(
|
function buildItem(
|
||||||
data: IFormData,
|
data: IFormData,
|
||||||
status: string,
|
status: string,
|
||||||
@@ -33,13 +79,16 @@ function buildItem(
|
|||||||
Title: buildTitle(employeeName),
|
Title: buildTitle(employeeName),
|
||||||
RequestStatus: status,
|
RequestStatus: status,
|
||||||
EmployeeId: employeeId,
|
EmployeeId: employeeId,
|
||||||
Position: data.Position || null,
|
// Три параллельных JSON-массива, один индекс — одна компания (см.
|
||||||
Department: data.Department || null,
|
// IOrganizationRecord) — отдельные столбцы, а не общий блок. Лимит только
|
||||||
|
// на Position/Department (Text, см. TEXT_COLUMN_LIMIT) — Organization это Note.
|
||||||
|
Position: organizationColumn(data.Organization, (r) => r.position, 'Должность', TEXT_COLUMN_LIMIT),
|
||||||
|
Department: organizationColumn(data.Organization, (r) => r.department, 'Департамент', TEXT_COLUMN_LIMIT),
|
||||||
|
Organization: organizationColumn(data.Organization, (r) => r.company, 'Организация'),
|
||||||
StandaloneUnit: data.StandaloneUnit || null,
|
StandaloneUnit: data.StandaloneUnit || null,
|
||||||
LastWorkingDay: data.LastWorkingDay || null,
|
LastWorkingDay: data.LastWorkingDay || null,
|
||||||
Phone: data.Phone || null,
|
Phone: data.Phone || null,
|
||||||
Comment: data.Comment || null,
|
Comment: data.Comment || null
|
||||||
Organization: data.Organization || null
|
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -71,3 +120,15 @@ export async function saveDismissalRequest(
|
|||||||
await writeRoute(dismissalApprovalService(listId), result.id, approvers, [], status);
|
await writeRoute(dismissalApprovalService(listId), result.id, approvers, [], status);
|
||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Проставить «Лицо, принимающее ОС/НМА» — вызывается ИЗ DismissalView
|
||||||
|
* непосредственным руководителем увольняемого перед его решением (см.
|
||||||
|
* onBeforeDecide), не из формы подачи. email — People-значение (e-mail), пусто
|
||||||
|
* не бывает: DismissalView не даёт согласовать шаг, пока поле не заполнено
|
||||||
|
* (см. валидацию там же).
|
||||||
|
*/
|
||||||
|
export async function updateAssetsAcceptor(id: number, email: string, listId?: string): Promise<void> {
|
||||||
|
const acceptor = await ensureEmployee(email);
|
||||||
|
await resolveDataList(FORM_ID, listId).items.getById(id).update({ AssetsAcceptorId: acceptor.Id });
|
||||||
|
}
|
||||||
|
|||||||
@@ -11,8 +11,20 @@ interface IDecisionPanelProps {
|
|||||||
service: ApproverService;
|
service: ApproverService;
|
||||||
/** Id заявки (элемент списка данных). */
|
/** Id заявки (элемент списка данных). */
|
||||||
requestId: number;
|
requestId: number;
|
||||||
/** Уведомление после сохранения решения (например, обновить статус на экране). */
|
/**
|
||||||
onDecided?: (status: string) => void;
|
* Уведомление после сохранения решения (например, обновить статус на экране).
|
||||||
|
*
|
||||||
|
* Может вернуть Promise — тогда панель ДОЖДЁТСЯ его и только потом покажет
|
||||||
|
* «Решение сохранено». Так работают побочные действия решения, без которых
|
||||||
|
* ответ «согласовано» неполон: по согласованному заявлению на увольнение
|
||||||
|
* автоматически создаётся обходной лист (см. forms/Dismissal), и сообщать об
|
||||||
|
* успехе, пока он не создан, — значит показывать успех раньше времени.
|
||||||
|
*
|
||||||
|
* Отказ (reject) панель НЕ считает провалом решения — решение к этому моменту
|
||||||
|
* уже применено на сервере; сообщить о проблеме побочного действия должен сам
|
||||||
|
* обработчик (у него для этого есть своя область экрана).
|
||||||
|
*/
|
||||||
|
onDecided?: (status: string) => void | Promise<void>;
|
||||||
/** Выполнить ПЕРЕД применением решения (напр. сохранить поля, заполненные
|
/** Выполнить ПЕРЕД применением решения (напр. сохранить поля, заполненные
|
||||||
* согласующим). Если бросит — решение не применяется, показывается ошибка. */
|
* согласующим). Если бросит — решение не применяется, показывается ошибка. */
|
||||||
onBeforeDecide?: () => Promise<void>;
|
onBeforeDecide?: () => Promise<void>;
|
||||||
@@ -83,11 +95,19 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
|
|||||||
await onBeforeDecide();
|
await onBeforeDecide();
|
||||||
}
|
}
|
||||||
const status = await service.decide(requestId, pendingRow.id, decision, comment.trim());
|
const status = await service.decide(requestId, pendingRow.id, decision, comment.trim());
|
||||||
|
// Сначала побочные действия решения, потом «сохранено»: пока onDecided не
|
||||||
|
// отработал, кнопки остаются заблокированными (submitting), и пользователь не
|
||||||
|
// видит успеха раньше, чем всё сделано. Провал onDecided на статус решения не
|
||||||
|
// влияет — оно уже применено, поэтому сообщение показываем всё равно.
|
||||||
|
if (onDecided) {
|
||||||
|
try {
|
||||||
|
await onDecided(status);
|
||||||
|
} catch (e) {
|
||||||
|
console.error('Побочное действие после решения не выполнилось', e);
|
||||||
|
}
|
||||||
|
}
|
||||||
setResultStatus(status);
|
setResultStatus(status);
|
||||||
setSubmitting(false);
|
setSubmitting(false);
|
||||||
if (onDecided) {
|
|
||||||
onDecided(status);
|
|
||||||
}
|
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
setError(`Не удалось сохранить решение: ${(e as Error).message}`);
|
setError(`Не удалось сохранить решение: ${(e as Error).message}`);
|
||||||
setSubmitting(false);
|
setSubmitting(false);
|
||||||
|
|||||||
@@ -9,6 +9,22 @@ export function isoDatePlusDays(days: number): string {
|
|||||||
return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
|
return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сегодня + n КАЛЕНДАРНЫХ месяцев в формате YYYY-MM-DD (для min/max у input
|
||||||
|
* type=date) — не приближение через 30 дней: `setMonth` сам разносит месяцы
|
||||||
|
* разной длины (28–31 день) и года на границе декабря/января.
|
||||||
|
*
|
||||||
|
* 31 января + 1 месяц → JS даёт 3 марта (переносит лишние дни на следующий
|
||||||
|
* месяц, а не откатывает до последнего числа) — для месячного уведомления это
|
||||||
|
* не проблема (крайняя ранняя дата и так сдвигается на несколько дней позже,
|
||||||
|
* не раньше), но не считать это «ровно через месяц» в общем случае.
|
||||||
|
*/
|
||||||
|
export function isoDatePlusMonths(months: number): string {
|
||||||
|
const d = new Date();
|
||||||
|
d.setMonth(d.getMonth() + months);
|
||||||
|
return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
|
||||||
|
}
|
||||||
|
|
||||||
/** YYYY-MM-DD → дд.мм.гггг, для текста ошибок валидации. Невалидную строку возвращает как есть. */
|
/** YYYY-MM-DD → дд.мм.гггг, для текста ошибок валидации. Невалидную строку возвращает как есть. */
|
||||||
export function formatIsoDate(iso: string): string {
|
export function formatIsoDate(iso: string): string {
|
||||||
const [y, m, d] = iso.split('-');
|
const [y, m, d] = iso.split('-');
|
||||||
|
|||||||
@@ -0,0 +1,99 @@
|
|||||||
|
import { AadHttpClient, HttpClientResponse } from '@microsoft/sp-http';
|
||||||
|
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||||
|
import { APPROVAL_API_CLIENT_ID, DICTIONARY_API_BASE_URL } from '../config';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Название должности директора по компании — ЗЕРКАЛО того же справочника, что
|
||||||
|
* использует approval-route на бэкенде для маршрута HeadType.CompanyDirectors
|
||||||
|
* (см. tnsu-approval-route TemplateRouteService.DirectorPositionByCompany).
|
||||||
|
* Держим копию здесь, а не тянем с бэкенда: нужен только на фронте, чтобы найти
|
||||||
|
* СТРОКУ МАТРИЦЫ, соответствующую конкретной компании (см.
|
||||||
|
* forms/Dismissal/sections/OrganizationsTable.tsx) — сама матрица уже пришла
|
||||||
|
* готовой от approval-route, эта функция лишь опознаёт в ней директора нужной
|
||||||
|
* компании тем же способом, каким его туда положил бэкенд.
|
||||||
|
*
|
||||||
|
* Если бэкендный справочник изменится — эту копию нужно поправить вручную,
|
||||||
|
* отдельного источника правды на два репозитория нет.
|
||||||
|
*/
|
||||||
|
const DIRECTOR_POSITION_BY_COMPANY: Record<string, string> = {
|
||||||
|
'ТОО KazPromService': 'Главный механик',
|
||||||
|
'ТОО СТ Global': 'Генеральный директор'
|
||||||
|
};
|
||||||
|
const DEFAULT_DIRECTOR_POSITION = 'Директор';
|
||||||
|
|
||||||
|
function normalizeCompany(company: string): string {
|
||||||
|
return company.trim().toLowerCase();
|
||||||
|
}
|
||||||
|
|
||||||
|
const DIRECTOR_POSITION_BY_COMPANY_NORMALIZED: Record<string, string> = Object.keys(
|
||||||
|
DIRECTOR_POSITION_BY_COMPANY
|
||||||
|
).reduce<Record<string, string>>((acc, key) => {
|
||||||
|
acc[normalizeCompany(key)] = DIRECTOR_POSITION_BY_COMPANY[key];
|
||||||
|
return acc;
|
||||||
|
}, {});
|
||||||
|
|
||||||
|
/** Название должности директора для компании (регистронезависимо). */
|
||||||
|
export function directorPositionFor(company: string): string {
|
||||||
|
return DIRECTOR_POSITION_BY_COMPANY_NORMALIZED[normalizeCompany(company)] || DEFAULT_DIRECTOR_POSITION;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function getClient(context: WebPartContext): Promise<AadHttpClient> {
|
||||||
|
return context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* GET /Employee/ByPosition — сотрудник на должности в компании (напр. директор).
|
||||||
|
* 404/«не найден» — не ошибка формы, просто вернуть '' (см. вызывающий код:
|
||||||
|
* отсутствие директора не должно ронять форму, только не даст найти строку матрицы).
|
||||||
|
*/
|
||||||
|
export async function getEmployeeEmailByPosition(
|
||||||
|
context: WebPartContext,
|
||||||
|
position: string,
|
||||||
|
company: string
|
||||||
|
): Promise<string> {
|
||||||
|
const client = await getClient(context);
|
||||||
|
const response: HttpClientResponse = await client.get(
|
||||||
|
`${DICTIONARY_API_BASE_URL}/Employee/ByPosition?position=${encodeURIComponent(
|
||||||
|
position
|
||||||
|
)}&company=${encodeURIComponent(company)}`,
|
||||||
|
AadHttpClient.configurations.v1
|
||||||
|
);
|
||||||
|
if (response.status === 404) return '';
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`Employee/ByPosition: ${response.status} ${response.statusText}`);
|
||||||
|
}
|
||||||
|
const body = (await response.json()) as { Email?: string; error?: string };
|
||||||
|
return body.Email || '';
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Директор (или должностной эквивалент, см. directorPositionFor) компании. */
|
||||||
|
export function getCompanyDirectorEmail(context: WebPartContext, company: string): Promise<string> {
|
||||||
|
return getEmployeeEmailByPosition(context, directorPositionFor(company), company);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* GET /Employee/Manager — руководитель сотрудника по типу связи. 'chief' —
|
||||||
|
* непосредственный руководитель (тот же managerType, что использует
|
||||||
|
* approval-route для HeadType.Chief — см. TemplateRouteService.ResolveStepAsync).
|
||||||
|
* Не найден/сотрудник без руководителя — '' (не ошибка).
|
||||||
|
*/
|
||||||
|
export async function getManagerEmail(
|
||||||
|
context: WebPartContext,
|
||||||
|
email: string,
|
||||||
|
managerType: 'chief' | 'directionHead' = 'chief'
|
||||||
|
): Promise<string> {
|
||||||
|
if (!email) return '';
|
||||||
|
const client = await getClient(context);
|
||||||
|
const response: HttpClientResponse = await client.get(
|
||||||
|
`${DICTIONARY_API_BASE_URL}/Employee/Manager?email=${encodeURIComponent(email)}&managerType=${encodeURIComponent(
|
||||||
|
managerType
|
||||||
|
)}`,
|
||||||
|
AadHttpClient.configurations.v1
|
||||||
|
);
|
||||||
|
if (response.status === 404) return '';
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`Employee/Manager: ${response.status} ${response.statusText}`);
|
||||||
|
}
|
||||||
|
const body = (await response.json()) as { managerEmail?: string };
|
||||||
|
return body.managerEmail || '';
|
||||||
|
}
|
||||||
@@ -12,3 +12,9 @@ export { CompanyPickerMulti } from './ui/CompanyPickerMulti';
|
|||||||
export type { ICompanyPickerMultiProps } from './ui/CompanyPickerMulti';
|
export type { ICompanyPickerMultiProps } from './ui/CompanyPickerMulti';
|
||||||
export { getEmployeeOrganizations, formatEmployeeOrganizations } from './employeeOrganizations.service';
|
export { getEmployeeOrganizations, formatEmployeeOrganizations } from './employeeOrganizations.service';
|
||||||
export type { IEmployeeOrganization } from './models/IEmployeeOrganization';
|
export type { IEmployeeOrganization } from './models/IEmployeeOrganization';
|
||||||
|
export {
|
||||||
|
directorPositionFor,
|
||||||
|
getEmployeeEmailByPosition,
|
||||||
|
getCompanyDirectorEmail,
|
||||||
|
getManagerEmail
|
||||||
|
} from './employeeLookup.service';
|
||||||
|
|||||||
Reference in New Issue
Block a user