feat: совместители в заявлении на увольнение, печать после обходного листа, лицо принимающее ОС/НМА, суммы списания в обходном листе
Четыре независимых доработки поверх связки «Заявление на увольнение» ↔ «Обходной лист»: 1. Совместители (несколько компаний у одного сотрудника): approval-route уже резолвит директора/должностного эквивалента КАЖДОЙ компании отдельным шагом маршрута (HeadType.CompanyDirectors, шаблон route 17: Chief → CompanyDirectors). Organization на форме подачи заявления теперь интерактивная таблица (OrganizationsTable) вместо read-only списка — строку компании можно убрать, если сотрудник реально не увольняется отовсюду сразу; убранная компания сразу снимается и из уже спланированной матрицы (matrix.remove) — искать нужную строку вручную не надо. Новый shared/dictionary/employeeLookup.service.ts зеркалит DirectorPositionByCompany бэкенда (KazpromService → Главный механик, СТ Global → Генеральный директор, иначе Директор) и Employee/Manager (managerType=chief) — используется и здесь, и в следующем пункте. 2. Печать заявления заблокирована, пока парный обходной лист не согласован (статус читается напрямую по ClearanceUrl, без отдельного поля-дублёра). 3. «Лицо, принимающее ОС/НМА» (AssetsAcceptor, People) — обязательное поле, которое заполняет НЕ заявитель, а непосредственный руководитель увольняемого (identity-check по Employee/Manager, а не по должности, как в approverRights «Обходного листа») прямо перед своим решением (DecisionPanel.onBeforeDecide); пустое поле блокирует решение. 4. В обходном листе — 4 независимые пары «сумма к списанию + обязательный комментарий» (ОС/СИЗ/подотчёт, обучение, НМА, ТМЦ), отдельно от уже существующего TrainingAmount. Заполнить может любой активный согласующий (не только профильный), но как только сумма введена — пара блокируется навсегда для всех (лок по снимку на момент загрузки, не реактивно от текущего ввода — иначе поле блокировалось бы прямо во время набора цифр). Списки на /sites/requests обновлены: AssetsAcceptor (Заявление на увольнение), 8 колонок WriteOff* (Обходной лист). tsc --noEmit и heft test (build+lint+179 тестов) чистые. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
+2
-2
@@ -45,8 +45,8 @@
|
||||
| [`recruiting-referral`](../src/webparts/requestPortal/forms/Referral/README.md) | Реферальная рекомендация | Рекрутинг | да | да | да | кандидат — внешний (текстовые поля, не People); маршрут по рекомендателю; исполнитель переназначает на реального; условное уточнение «откуда знаете» | ✅ |
|
||||
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
|
||||
| [`it-1c-ticket`](../src/webparts/requestPortal/forms/Ticket1C/README.md) | Заявка в отдел 1С | IT | да | нет | да | контакты предзаполняются из Graph (/me); вместо фазы исполнения — карточка в Microsoft Planner (согласовано/сразу без согласования — рабочий бакет, отклонено — отдельный бакет) | ✅ |
|
||||
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker); условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД), сумма обучения | ✅ |
|
||||
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | по умолчанию на себя, но можно за другого; подразделение из профиля (read-only), должность/организация из справочника; последний рабочий день не в прошлом; **после согласования сам создаёт обходной лист** и связывает пару ссылками | ⏳ тип заявки не заведён в админке approval-route |
|
||||
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker) либо создаётся сам по согласованному «Заявлению на увольнение»; условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД); 4 независимые пары «сумма к списанию + комментарий» (ОС/СИЗ/подотчёт, обучение, НМА, ТМЦ) — вводит любой активный согласующий, блокируется навсегда после первого ввода | ✅ |
|
||||
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | совместители — таблица компаний с удалением строки (снимает и согласующего из матрицы); должность/организация из справочника; **после согласования сам создаёт обходной лист**; печать заблокирована до согласования обходного листа; «Лицо, принимающее ОС/НМА» — заполняет только непосредственный руководитель | ✅ |
|
||||
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
||||
|
||||
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
||||
|
||||
@@ -20,12 +20,14 @@ import {
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField, WRITE_OFF_CATEGORIES } from './model';
|
||||
import { loadClearanceRequest } from './load';
|
||||
import {
|
||||
clearanceApprovalService,
|
||||
updateApproverFields,
|
||||
IApproverEditableFields
|
||||
updateWriteOffFields,
|
||||
IApproverEditableFields,
|
||||
IWriteOffFields
|
||||
} from './submit';
|
||||
import { canEditHrRecordsFields, canEditParkingField } from './approverRights';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
@@ -52,7 +54,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [hrRecordsEditable, setHrRecordsEditable] = useState<boolean>(false);
|
||||
const [parkingEditable, setParkingEditable] = useState<boolean>(false);
|
||||
// Суммы к списанию, в отличие от отметок выше, не привязаны к должности — их
|
||||
// может заполнить ЛЮБОЙ активный согласующий (см. эффект прав ниже).
|
||||
const [canEditWriteOffs, setCanEditWriteOffs] = useState<boolean>(false);
|
||||
// Категории, УЖЕ заблокированные (сумма непустая) НА МОМЕНТ ЗАГРУЗКИ — не
|
||||
// реактивно от текущего data, иначе поле блокировалось бы прямо во время
|
||||
// ввода (набрал сумму → data стал непустым → поле сразу стало бы readOnly).
|
||||
const [lockedWriteOffs, setLockedWriteOffs] = useState<Set<string>>(new Set());
|
||||
const [saveState, setSaveState] = useState<SaveState>('idle');
|
||||
const [saveErrorMessage, setSaveErrorMessage] = useState<string>('');
|
||||
|
||||
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);
|
||||
setError(null);
|
||||
setLoading(false);
|
||||
setLockedWriteOffs(
|
||||
new Set(WRITE_OFF_CATEGORIES.filter((cat) => !!loaded.data[cat.amountField]).map((cat) => cat.key))
|
||||
);
|
||||
}
|
||||
})
|
||||
.catch((e) => {
|
||||
@@ -127,11 +140,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
const active = !!pending && !pending.isDelegator && pending.phase !== APPROVAL_PHASE.execution;
|
||||
setHrRecordsEditable(active && canEditHrRecordsFields(pending?.position));
|
||||
setParkingEditable(active && canEditParkingField(pending?.position));
|
||||
// Суммы к списанию — без проверки должности: их вводит тот, кто сейчас
|
||||
// фактически согласует шаг, вне зависимости от отдела.
|
||||
setCanEditWriteOffs(active);
|
||||
})
|
||||
.catch(() => {
|
||||
if (alive) {
|
||||
setHrRecordsEditable(false);
|
||||
setParkingEditable(false);
|
||||
setCanEditWriteOffs(false);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
@@ -140,9 +157,24 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
// decisionSeq: после решения/делегирования активный шаг меняется — права пересчитываем.
|
||||
}, [itemId, approverService, decisionSeq]);
|
||||
|
||||
// Категории списания, которые может править ИМЕННО СЕЙЧАС этот пользователь:
|
||||
// ещё не заблокированы (см. lockedWriteOffs) И у него сейчас активный шаг.
|
||||
// Отдельная переменная, не «canEditWriteOffs && !lockedWriteOffs.has(...)»
|
||||
// на месте использования — нужна и в саму секцию (RequestSection), и здесь.
|
||||
const editableWriteOffKeys = useMemo(
|
||||
() =>
|
||||
canEditWriteOffs
|
||||
? new Set(WRITE_OFF_CATEGORIES.filter((cat) => !lockedWriteOffs.has(cat.key)).map((cat) => cat.key))
|
||||
: new Set<string>(),
|
||||
[canEditWriteOffs, lockedWriteOffs]
|
||||
);
|
||||
|
||||
// Пишем ТОЛЬКО те отметки, на которые у согласующего есть права: иначе он
|
||||
// затёр бы чужие поля значениями, которые видел у себя на экране.
|
||||
const saveApproverFields = useCallback((): Promise<void> => {
|
||||
// затёр бы чужие поля значениями, которые видел у себя на экране. Пары сумм к
|
||||
// списанию — только НЕПУСТЫЕ и только среди editableWriteOffKeys; частично
|
||||
// заполненная пара (сумма без комментария или наоборот) бросает ДО записи
|
||||
// чего бы то ни было — половинчатая запись хуже отказа сохранить.
|
||||
const saveApproverFields = useCallback(async (): Promise<void> => {
|
||||
const fields: Partial<IApproverEditableFields> = {};
|
||||
if (hrRecordsEditable) {
|
||||
fields.AccessCard = data.AccessCard;
|
||||
@@ -151,15 +183,36 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
if (parkingEditable) {
|
||||
fields.ParkingCard = data.ParkingCard;
|
||||
}
|
||||
return updateApproverFields(itemId, fields, listId);
|
||||
}, [itemId, listId, hrRecordsEditable, parkingEditable, data.AccessCard, data.TrainingAmount, data.ParkingCard]);
|
||||
|
||||
const writeOffFields: Partial<IWriteOffFields> = {};
|
||||
for (const cat of WRITE_OFF_CATEGORIES) {
|
||||
if (!editableWriteOffKeys.has(cat.key)) continue;
|
||||
const amount = data[cat.amountField].trim();
|
||||
const comment = data[cat.commentField].trim();
|
||||
if (!amount && !comment) continue; // не трогали — не пишем
|
||||
if (!amount || !comment) {
|
||||
throw new Error(
|
||||
`«${cat.label}»: заполните и сумму, и комментарий (за что конкретно) — или оставьте пару пустой.`
|
||||
);
|
||||
}
|
||||
writeOffFields[cat.amountField] = data[cat.amountField];
|
||||
writeOffFields[cat.commentField] = data[cat.commentField];
|
||||
}
|
||||
|
||||
await updateApproverFields(itemId, fields, listId);
|
||||
if (Object.keys(writeOffFields).length > 0) {
|
||||
await updateWriteOffFields(itemId, writeOffFields, listId);
|
||||
}
|
||||
}, [itemId, listId, hrRecordsEditable, parkingEditable, editableWriteOffKeys, data]);
|
||||
|
||||
const handleSaveFields = async (): Promise<void> => {
|
||||
setSaveState('saving');
|
||||
setSaveErrorMessage('');
|
||||
try {
|
||||
await saveApproverFields();
|
||||
setSaveState('saved');
|
||||
} catch {
|
||||
} catch (e) {
|
||||
setSaveErrorMessage(friendlyErrorMessage(e));
|
||||
setSaveState('error');
|
||||
}
|
||||
};
|
||||
@@ -175,8 +228,20 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
);
|
||||
}
|
||||
|
||||
const canEditAnything = hrRecordsEditable || parkingEditable;
|
||||
const sectionProps = { data, set, context, hrRecordsEditable, parkingEditable };
|
||||
const canEditAnything = hrRecordsEditable || parkingEditable || canEditWriteOffs;
|
||||
const reviewHints = [
|
||||
hrRecordsEditable && 'отметить карту СКУД и указать сумму за обучение',
|
||||
parkingEditable && 'отметить парковочную карту',
|
||||
editableWriteOffKeys.size > 0 && 'указать суммы к списанию (если применимо)'
|
||||
].filter((hint): hint is string => !!hint);
|
||||
const sectionProps = {
|
||||
data,
|
||||
set,
|
||||
context,
|
||||
hrRecordsEditable,
|
||||
parkingEditable,
|
||||
writeOffEditableKeys: editableWriteOffKeys
|
||||
};
|
||||
|
||||
const notify = (): void => {
|
||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||
@@ -199,15 +264,15 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
|
||||
{canEditAnything && (
|
||||
<div className={`${styles.reviewBar} rp-no-print`}>
|
||||
<span className={styles.reviewHint}>
|
||||
{hrRecordsEditable
|
||||
? 'Как согласующий вы можете отметить карту СКУД и указать сумму за обучение.'
|
||||
: 'Как согласующий вы можете отметить парковочную карту.'}
|
||||
{reviewHints.length > 0 && `Как согласующий вы можете ${reviewHints.join('; ')}.`}
|
||||
</span>
|
||||
<Button variant="secondary" onClick={handleSaveFields} disabled={saveState === 'saving'}>
|
||||
Сохранить
|
||||
</Button>
|
||||
{saveState === 'saved' && <span className={styles.savedNote}>Сохранено</span>}
|
||||
{saveState === 'error' && <span className={styles.saveError}>Ошибка сохранения</span>}
|
||||
{saveState === 'error' && (
|
||||
<span className={styles.saveError}>{saveErrorMessage || 'Ошибка сохранения'}</span>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
|
||||
|
||||
@@ -54,8 +54,31 @@ RequestTypeId» в `docs/forms.md`). Тип уже зарегистрирова
|
||||
`LinkField` из `shared/ui`, read-only, открывается в той же вкладке; у листов,
|
||||
заведённых руками, ссылки нет и поле не рендерится.
|
||||
|
||||
## Суммы к списанию (согласование)
|
||||
4 НЕЗАВИСИМЫЕ пары «сумма + обязательный комментарий (за что конкретно)», колонки
|
||||
`WriteOff{Assets,Training,Nma,Tmc}{Amount,Comment}` (см. `model.ts
|
||||
WRITE_OFF_CATEGORIES`): «ОС / СИЗ / подотчётная сумма», «Обучение», «НМА», «ТМЦ».
|
||||
|
||||
- **Не привязаны к должности**, в отличие от отметок выше: заполнить может ЛЮБОЙ
|
||||
согласующий, у которого сейчас активный шаг (`ClearanceView.canEditWriteOffs`,
|
||||
фаза «Согласование» — исполнителям недоступно, как и остальным отметкам).
|
||||
- **Каждая пара блокируется НАВСЕГДА после первого ввода** — как только сумма
|
||||
непустая, поле становится read-only для всех, включая того, кто её ввёл.
|
||||
Признак блокировки — сама непустая сумма на МОМЕНТ ЗАГРУЗКИ страницы
|
||||
(`ClearanceView.lockedWriteOffs`, снимок при загрузке, а не реактивно от
|
||||
текущего `data` — иначе поле блокировалось бы прямо во время набора цифр).
|
||||
- **Комментарий обязателен вместе с суммой**: заполнить можно либо обе половины
|
||||
пары, либо ни одной — `saveApproverFields` бросает ДО записи чего бы то ни
|
||||
было, если половина пары осталась пустой.
|
||||
- Сохраняются той же кнопкой «Сохранить» (`reviewBar`), что и остальные отметки,
|
||||
и тем же `onBeforeDecide` — при решении несохранённые суммы уйдут вместе с ним.
|
||||
- Это ОТДЕЛЬНЫЙ механизм от `TrainingAmount` («Обучение: сумма» выше, привязана к
|
||||
КДП) — сознательно не объединялись, чтобы не менять уже установившееся
|
||||
поведение существующего поля.
|
||||
|
||||
## Секции формы
|
||||
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма обучения · парковочная карта · карта СКУД)
|
||||
RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма
|
||||
обучения · парковочная карта · карта СКУД · суммы к списанию · ссылка на заявление)
|
||||
|
||||
## Точки входа
|
||||
- rptype: `clearance-form`
|
||||
|
||||
@@ -2,6 +2,11 @@ import { getSP } from '../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||
|
||||
/** Число или '' (SharePoint отдаёт null для незаполненного Number). */
|
||||
function numberField(value: unknown): string {
|
||||
return value === null || value === undefined ? '' : String(value);
|
||||
}
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
/** Ф.И.О. увольняемого сотрудника из поля Employee (для заголовка режима чтения). */
|
||||
@@ -33,6 +38,14 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
||||
'TrainingAmount',
|
||||
'Organization',
|
||||
'DismissalUrl',
|
||||
'WriteOffAssetsAmount',
|
||||
'WriteOffAssetsComment',
|
||||
'WriteOffTrainingAmount',
|
||||
'WriteOffTrainingComment',
|
||||
'WriteOffNmaAmount',
|
||||
'WriteOffNmaComment',
|
||||
'WriteOffTmcAmount',
|
||||
'WriteOffTmcComment',
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
'Employee/Title',
|
||||
@@ -55,7 +68,15 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
|
||||
TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
|
||||
Organization: (item.Organization as string) || '',
|
||||
// Гиперссылка приходит объектом {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) || '',
|
||||
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 {
|
||||
|
||||
@@ -37,8 +37,68 @@ export interface IFormData {
|
||||
* forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
|
||||
*/
|
||||
DismissalUrl: string;
|
||||
|
||||
/**
|
||||
* Суммы к списанию по обходному листу — 4 независимые пары (сумма +
|
||||
* обязательный комментарий, «за что конкретно»), см. WRITE_OFF_CATEGORIES.
|
||||
* «Сырые» цифры без пробелов, как TrainingAmount (см. MoneyInput). Пусто =
|
||||
* не заполнено. КАЖДАЯ пара — независимая: заполнить может любой активный
|
||||
* согласующий (см. ClearanceView.canEditWriteOffs), но как только сумма
|
||||
* непустая — пара блокируется НАВСЕГДА, для всех (включая того, кто её ввёл).
|
||||
* Признак блокировки — сама непустая сумма, отдельного флага в списке нет.
|
||||
*/
|
||||
WriteOffAssetsAmount: string;
|
||||
WriteOffAssetsComment: string;
|
||||
WriteOffTrainingAmount: string;
|
||||
WriteOffTrainingComment: string;
|
||||
WriteOffNmaAmount: string;
|
||||
WriteOffNmaComment: string;
|
||||
WriteOffTmcAmount: string;
|
||||
WriteOffTmcComment: string;
|
||||
}
|
||||
|
||||
/** Имена всех 8 строковых полей сумм/комментариев к списанию — см. IFormData.WriteOff*. */
|
||||
export type WriteOffFieldKey =
|
||||
| 'WriteOffAssetsAmount'
|
||||
| 'WriteOffAssetsComment'
|
||||
| 'WriteOffTrainingAmount'
|
||||
| 'WriteOffTrainingComment'
|
||||
| 'WriteOffNmaAmount'
|
||||
| 'WriteOffNmaComment'
|
||||
| 'WriteOffTmcAmount'
|
||||
| 'WriteOffTmcComment';
|
||||
|
||||
/**
|
||||
* Одна из 4 независимых категорий списания — см. 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: '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;
|
||||
|
||||
@@ -63,7 +123,15 @@ export const EMPTY_DATA: IFormData = {
|
||||
AccessCard: false,
|
||||
TrainingAmount: '',
|
||||
Organization: '',
|
||||
DismissalUrl: ''
|
||||
DismissalUrl: '',
|
||||
WriteOffAssetsAmount: '',
|
||||
WriteOffAssetsComment: '',
|
||||
WriteOffTrainingAmount: '',
|
||||
WriteOffTrainingComment: '',
|
||||
WriteOffNmaAmount: '',
|
||||
WriteOffNmaComment: '',
|
||||
WriteOffTmcAmount: '',
|
||||
WriteOffTmcComment: ''
|
||||
};
|
||||
|
||||
/** Плейсхолдер для поля выбора сотрудника. */
|
||||
|
||||
@@ -14,6 +14,15 @@
|
||||
{ "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
|
||||
{ "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": "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 { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
||||
import { CollapseSection, FormField, TextArea, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER, WRITE_OFF_CATEGORIES } from '../model';
|
||||
|
||||
// Подразделение подтягивается автоматически при выборе сотрудника (см.
|
||||
// ClearanceForm.handleEmployeeChange — SharePoint User Profile) — свободный
|
||||
@@ -12,6 +12,14 @@ interface IRequestSectionProps extends ISectionProps {
|
||||
hrRecordsEditable?: boolean;
|
||||
/** Согласующий из отдела подбора правит парковочную карту. */
|
||||
parkingEditable?: boolean;
|
||||
/**
|
||||
* Ключи категорий списания (см. WRITE_OFF_CATEGORIES), которые ЭТОТ
|
||||
* пользователь может сейчас заполнить — присутствие пропа (даже пустым
|
||||
* Set'ом) включает блок сумм к списанию; не задан вовсе (форма подачи, см.
|
||||
* ClearanceForm) — блок не показывается: до первого решения списывать
|
||||
* нечего. См. ClearanceView.editableWriteOffKeys.
|
||||
*/
|
||||
writeOffEditableKeys?: Set<string>;
|
||||
}
|
||||
|
||||
/** Единственная секция формы «Обходной лист»: увольняемый, должность, подразделение, даты, карты, обучение. */
|
||||
@@ -21,7 +29,8 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
context,
|
||||
onEmployeeChange,
|
||||
hrRecordsEditable,
|
||||
parkingEditable
|
||||
parkingEditable,
|
||||
writeOffEditableKeys
|
||||
}) => (
|
||||
<CollapseSection title="Обходной лист" icon="people">
|
||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||
@@ -89,6 +98,41 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
readOnly={hrRecordsEditable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
{/* Суммы к списанию — 4 независимые пары (сумма + обязательный комментарий,
|
||||
за что конкретно). Каждую может заполнить ЛЮБОЙ активный согласующий
|
||||
(не только профильный, в отличие от отметок выше) — но как только сумма
|
||||
указана, пара блокируется навсегда для всех, поэтому у незаблокированных
|
||||
(writeOffEditableKeys.has(cat.key)) есть readOnly={false}, у остальных —
|
||||
обычное поведение FormMode (просмотр — заблокировано и так). */}
|
||||
{writeOffEditableKeys &&
|
||||
WRITE_OFF_CATEGORIES.map((cat) => {
|
||||
const editable = writeOffEditableKeys.has(cat.key);
|
||||
return (
|
||||
<React.Fragment key={cat.key}>
|
||||
<FormField label={`${cat.label}: сумма`} htmlFor={cat.amountField}>
|
||||
<MoneyInput
|
||||
id={cat.amountField}
|
||||
value={data[cat.amountField]}
|
||||
onChange={(v) => set(cat.amountField, v)}
|
||||
readOnly={editable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField
|
||||
label={`${cat.label}: за что конкретно`}
|
||||
htmlFor={cat.commentField}
|
||||
required={editable}
|
||||
full
|
||||
>
|
||||
<TextArea
|
||||
id={cat.commentField}
|
||||
value={data[cat.commentField]}
|
||||
onChange={(v) => set(cat.commentField, v)}
|
||||
readOnly={editable ? false : undefined}
|
||||
/>
|
||||
</FormField>
|
||||
</React.Fragment>
|
||||
);
|
||||
})}
|
||||
{/* Есть только у листов, созданных автоматически по согласованному заявлению
|
||||
на увольнение (см. forms/Dismissal/createClearance.ts). */}
|
||||
<LinkField
|
||||
|
||||
@@ -3,6 +3,49 @@ import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/
|
||||
import { ensureEmployee } from '../../shared/employee';
|
||||
import { FORM_ID, IFormData } from './model';
|
||||
|
||||
/** Одна из 8 колонок сумм/комментариев к списанию — см. model.ts WRITE_OFF_CATEGORIES. */
|
||||
export type IWriteOffFields = Pick<
|
||||
IFormData,
|
||||
| 'WriteOffAssetsAmount'
|
||||
| 'WriteOffAssetsComment'
|
||||
| 'WriteOffTrainingAmount'
|
||||
| 'WriteOffTrainingComment'
|
||||
| 'WriteOffNmaAmount'
|
||||
| 'WriteOffNmaComment'
|
||||
| 'WriteOffTmcAmount'
|
||||
| 'WriteOffTmcComment'
|
||||
>;
|
||||
|
||||
/**
|
||||
* Записать сумму(ы)/комментарий(и) к списанию. Пишет РОВНО переданные поля —
|
||||
* как 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);
|
||||
}
|
||||
|
||||
/**
|
||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||
* approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
|
||||
|
||||
@@ -25,7 +25,12 @@ import {
|
||||
resolveWriteListId
|
||||
} from '../../shared/approval';
|
||||
import { IRequestFormProps } from '../../models/types';
|
||||
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
|
||||
import {
|
||||
getEmployeeOrganizations,
|
||||
formatEmployeeOrganizations,
|
||||
getCompanyDirectorEmail,
|
||||
IEmployeeOrganization
|
||||
} from '../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { isoDatePlusDays, formatIsoDate } from '../../shared/dateUtils';
|
||||
import {
|
||||
@@ -51,6 +56,10 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
const [requestId, setRequestId] = useState<number | undefined>(editId);
|
||||
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
|
||||
const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
|
||||
// Организации сотрудника СПИСКОМ (не только joined-строка в data.Organization) —
|
||||
// нужны, чтобы «Убрать компанию» (см. handleRemoveOrganization) знало, какие
|
||||
// компании ещё остались, и могло найти в матрице директора именно убираемой.
|
||||
const [orgRecords, setOrgRecords] = useState<IEmployeeOrganization[]>([]);
|
||||
const submit = useRequestSubmit();
|
||||
|
||||
const readOnly = !isEditableStatus(requestStatus);
|
||||
@@ -78,6 +87,22 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
setRequestStatus(loaded.status);
|
||||
setRequestCode(loaded.code || undefined);
|
||||
}
|
||||
// Организации сотрудника — теми же, что уже сохранены в заявке: если
|
||||
// при подаче убрали компанию, она не должна вернуться в таблицу только
|
||||
// потому, что открыли заявку на редактирование. Сверяем ПОЛНЫЙ список
|
||||
// из справочника с тем, что осталось в сохранённом data.Organization
|
||||
// (одна компания на строку, см. formatEmployeeOrganizations), а не
|
||||
// берём справочник как есть.
|
||||
const savedCompanies = new Set(
|
||||
loaded.data.Organization.split('\n')
|
||||
.filter(Boolean)
|
||||
.map((line) => line.split(' — ')[0])
|
||||
);
|
||||
return getEmployeeOrganizations(context, loaded.data.Employee)
|
||||
.then((records) => {
|
||||
if (alive) setOrgRecords(records.filter((r) => savedCompanies.has(r.company)));
|
||||
})
|
||||
.catch(() => undefined);
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) {
|
||||
@@ -104,6 +129,7 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
getEmployeeOrganizations(context, user.email)
|
||||
.then((records) => {
|
||||
if (!alive) return;
|
||||
setOrgRecords(records);
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Position: prev.Position || records[0]?.position || prev.Position,
|
||||
@@ -127,6 +153,7 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
// Выбор другого сотрудника подтягивает его должность, подразделение и организации.
|
||||
const handleEmployeeChange = (login: string): void => {
|
||||
setData((prev) => ({ ...prev, Employee: login, Department: '', Organization: '' }));
|
||||
setOrgRecords([]);
|
||||
if (!login) {
|
||||
return;
|
||||
}
|
||||
@@ -135,13 +162,14 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
.then((profile) => setData((prev) => ({ ...prev, Department: profile.department })))
|
||||
.catch(() => undefined);
|
||||
getEmployeeOrganizations(context, login)
|
||||
.then((records) =>
|
||||
.then((records) => {
|
||||
setOrgRecords(records);
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Position: records[0]?.position || prev.Position,
|
||||
Organization: formatEmployeeOrganizations(records)
|
||||
}))
|
||||
)
|
||||
}));
|
||||
})
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
@@ -167,6 +195,33 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
(login) => approval.getJobTitle(login)
|
||||
);
|
||||
|
||||
// Убрать компанию из заявления (совместитель, реально не увольняется из
|
||||
// ВСЕХ) — см. OrganizationsTable. Снимает компанию из data.Organization И, по
|
||||
// возможности, соответствующего согласующего (директора/должностного
|
||||
// эквивалента этой компании, см. shared/dictionary/employeeLookup.service —
|
||||
// тот же справочник, каким резолвит approval-route HeadType.CompanyDirectors)
|
||||
// из уже загруженной матрицы — искать и удалять его там вручную не нужно.
|
||||
//
|
||||
// Матрица планируется ОДНИМ шагом на все компании сразу (все директора — одна
|
||||
// и та же строка маршрута с несколькими исполнителями), поэтому убрать можно
|
||||
// только из уже пришедшего результата — если матрица ещё грузится или
|
||||
// директор этой компании в ней не нашёлся (например, маршрут ещё не готов),
|
||||
// компания всё равно убирается из заявления, а несовпадение тихо игнорируем:
|
||||
// HR в этом случае уберёт лишнего согласующего вручную через саму матрицу.
|
||||
const handleRemoveOrganization = (company: string): void => {
|
||||
const remaining = orgRecords.filter((r) => r.company !== company);
|
||||
setOrgRecords(remaining);
|
||||
setData((prev) => ({ ...prev, Organization: formatEmployeeOrganizations(remaining) }));
|
||||
|
||||
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 у input type=date, см. RequestSection) не даёт выбрать более
|
||||
// раннюю дату, но проверяем и здесь на случай обхода UI.
|
||||
@@ -262,7 +317,14 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||
const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
|
||||
|
||||
const sectionProps = { data, set, context, onEmployeeChange: handleEmployeeChange };
|
||||
const sectionProps = {
|
||||
data,
|
||||
set,
|
||||
context,
|
||||
onEmployeeChange: handleEmployeeChange,
|
||||
orgRecords,
|
||||
onRemoveOrganization: handleRemoveOrganization
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
|
||||
@@ -12,3 +12,10 @@
|
||||
justify-content: flex-end;
|
||||
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
|
||||
} from '../../shared/approval';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { getManagerEmail } from '../../shared/dictionary';
|
||||
import {
|
||||
approvalListTitle,
|
||||
approvalListTitleForListId,
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { parseRoute } from '../../shared/routing';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { loadDismissalRequest } from './load';
|
||||
import { dismissalApprovalService } from './submit';
|
||||
import { dismissalApprovalService, updateAssetsAcceptor } from './submit';
|
||||
import { loadClearanceRequest } from '../Clearance/load';
|
||||
import { ensureClearanceForDismissal } from './createClearance';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
|
||||
/**
|
||||
* Статусы обходного листа, при которых его СОГЛАСОВАНИЕ уже пройдено целиком
|
||||
* (независимо от фазы исполнения, которая у него есть) — печать заявления на
|
||||
* увольнение разрешена начиная отсюда. См. handlePrintGate ниже.
|
||||
*/
|
||||
const CLEARANCE_READY_STATUSES: ReadonlySet<string> = new Set([
|
||||
REQUEST_STATUS.approved,
|
||||
REQUEST_STATUS.execution,
|
||||
REQUEST_STATUS.closed
|
||||
]);
|
||||
|
||||
interface IDismissalViewProps {
|
||||
context: WebPartContext;
|
||||
itemId: number;
|
||||
@@ -35,9 +49,6 @@ interface IDismissalViewProps {
|
||||
listId?: string;
|
||||
}
|
||||
|
||||
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
|
||||
const NOOP_SET: SetField = () => undefined;
|
||||
|
||||
// Заявление на увольнение только для просмотра (режим согласующего).
|
||||
// Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
|
||||
// <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
|
||||
@@ -50,6 +61,9 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
||||
// Итог автосоздания обходного листа после согласования (см. onDecided ниже).
|
||||
const [clearance, setClearance] = useState<string>('');
|
||||
const [clearanceError, setClearanceError] = useState<string>('');
|
||||
// Печать разрешена только с этого момента — см. эффект ниже (printGate).
|
||||
const [printGate, setPrintGate] = useState<'checking' | 'blocked' | 'allowed'>('checking');
|
||||
const [assetsAcceptorEditable, setAssetsAcceptorEditable] = useState<boolean>(false);
|
||||
|
||||
// listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
|
||||
// dismissalApprovalService можно звать не опасаясь исключения.
|
||||
@@ -92,6 +106,66 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
||||
};
|
||||
}, [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) {
|
||||
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 => {
|
||||
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
|
||||
@@ -147,7 +237,13 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
||||
return (
|
||||
<div>
|
||||
<div className={`${styles.toolbar} rp-no-print`}>
|
||||
<PrintButton />
|
||||
{printGate === 'allowed' ? (
|
||||
<PrintButton />
|
||||
) : (
|
||||
<span className={styles.printBlocked} title="Печать откроется после согласования обходного листа по этому увольнению">
|
||||
Печать станет доступна после согласования обходного листа
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="rp-no-print">
|
||||
@@ -181,6 +277,7 @@ const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey
|
||||
service={approverService}
|
||||
requestId={itemId}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
onBeforeDecide={assetsAcceptorEditable ? saveAssetsAcceptor : undefined}
|
||||
onDecided={(newStatus) => {
|
||||
setStatus(newStatus);
|
||||
setDecisionSeq((n) => n + 1);
|
||||
|
||||
@@ -6,9 +6,8 @@
|
||||
**Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
|
||||
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
|
||||
`pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
|
||||
RequestTypeId» в `docs/forms.md`). Тип нужно **завести в админке approval-route**
|
||||
(pageUrl «hr-dismissal» + ссылка на список данных) — до этого форма откроется, но
|
||||
отправить заявку не даст: маршрут не резолвится.
|
||||
RequestTypeId» в `docs/forms.md`). Тип заведён в админке approval-route (id 16,
|
||||
список данных `/sites/requests/Lists/18`).
|
||||
|
||||
## Маршрут
|
||||
- Фазы: только согласование. Фазы исполнения нет — после согласования заявка
|
||||
@@ -19,6 +18,10 @@ RequestTypeId» в `docs/forms.md`). Тип нужно **завести в ад
|
||||
**Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
|
||||
планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
|
||||
«Обходном листе».
|
||||
- Настроенный шаблон маршрута (approval-route, route id 17): шаг 1 —
|
||||
`HeadType.Chief` (непосредственный руководитель увольняемого, тот же
|
||||
`Employee/Manager?managerType=chief`, что резолвит «Лицо, принимающее ОС/НМА»,
|
||||
см. ниже), шаг 2 — `HeadType.CompanyDirectors` (см. следующий раздел).
|
||||
|
||||
## Особое поведение
|
||||
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
||||
@@ -40,6 +43,35 @@ RequestTypeId» в `docs/forms.md`). Тип нужно **завести в ад
|
||||
отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
|
||||
- **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
|
||||
|
||||
## Совместители: организации таблицей, удаление синхронизировано с маршрутом
|
||||
Сотрудник может числиться сразу в НЕСКОЛЬКИХ компаниях (совместительство).
|
||||
Approval-route резолвит маршрут через `HeadType.CompanyDirectors` — ОДИН шаг
|
||||
разворачивается в по одному согласующему НА КАЖДУЮ компанию сотрудника (директор,
|
||||
а где нет такой штатной единицы — должностной эквивалент: `Главный механик` для
|
||||
«ТОО KazPromService», `Генеральный директор» для «ТОО СТ Global», иначе
|
||||
`Директор`, см. `DirectorPositionByCompany` в approval-route
|
||||
`TemplateRouteService`). Это уже работает БЕЗ участия портала — сам approval-route
|
||||
резолвит все компании сотрудника через `Employee/ByEmail`.
|
||||
|
||||
Когда `Employee/ByEmail` вернул больше одной записи, `RequestSection` рендерит
|
||||
`OrganizationsTable` (не read-only `OrganizationField`) — таблицу «Компания —
|
||||
Должность» с кнопкой «убрать» у каждой строки (только на форме подачи, не в
|
||||
просмотре). Если сотрудник реально не увольняется из ВСЕХ компаний сразу, HR
|
||||
убирает лишние: `DismissalForm.handleRemoveOrganization`
|
||||
|
||||
1. снимает компанию из `data.Organization` (сохранённый текст всегда отражает
|
||||
ТЕКУЩИЙ, не первоначальный, набор — так же восстанавливается при повторном
|
||||
открытии черновика/возврата, см. загрузку `orgRecords` в `DismissalForm`);
|
||||
2. независимо резолвит директора/эквивалента этой компании через
|
||||
`getCompanyDirectorEmail` (`shared/dictionary/employeeLookup.service.ts` —
|
||||
зеркало того же `DirectorPositionByCompany`, что и на бэкенде) и удаляет
|
||||
строку с этим email из уже загруженной ПЛАНИРУЕМОЙ матрицы (`matrix.remove`).
|
||||
|
||||
Убирать согласующего из матрицы вручную (кнопкой самой матрицы) при этом не нужно
|
||||
— это best-effort синхронизация: если матрица ещё не загрузилась или директор не
|
||||
нашёлся, компания всё равно снимается из заявления, а несовпадение в матрице HR
|
||||
поправит вручную через саму матрицу (она и так редактируема).
|
||||
|
||||
## Согласовано → обходной лист создаётся сам
|
||||
Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
|
||||
портал заводит по нему **обходной лист** — `ensureClearanceForDismissal`
|
||||
@@ -83,6 +115,37 @@ approval-route (`getPlannedMatrix` для фаз «Согласование» и
|
||||
- Тип заявки `clearance-form` должен быть заведён в админке approval-route — иначе
|
||||
создание падает на резолве `RequestTypeId`.
|
||||
|
||||
## Печать заблокирована до согласования обходного листа
|
||||
`DismissalView` не показывает `PrintButton`, пока парный обходной лист не дошёл
|
||||
хотя бы до статуса «Согласовано» (или дальше — «Выполнение»/«Закрыта», если у
|
||||
него есть исполнители): печатать заявление раньше значит выдать документ до того,
|
||||
как процесс увольнения (карты, суммы к списанию) подтверждён целиком. Статус
|
||||
читается НАПРЯМУЮ по `ClearanceUrl` (`parseRoute` вытаскивает `itemId`/`listId`
|
||||
из самой ссылки, `loadClearanceRequest` — статус) — отдельного поля-дублёра нет.
|
||||
Пока `ClearanceUrl` пуст (обходной лист ещё не создан/не удалось создать) —
|
||||
печать тоже заблокирована, печатать нечего.
|
||||
|
||||
## «Лицо, принимающее ОС/НМА»
|
||||
Колонка `AssetsAcceptor` (People) — кто принимает основные средства/НМА
|
||||
увольняемого. Обязательна, но заполняет её **не заявитель**, а **непосредственный
|
||||
руководитель** увольняемого — тот, кого approval-route резолвит для
|
||||
`HeadType.Chief` (`Employee/Manager?managerType=chief`, см. «Маршрут» выше).
|
||||
|
||||
- В форме подачи поле показывается read-only (обычно пустое) — просто
|
||||
информирует, что это будет заполнено позже.
|
||||
- В `DismissalView` поле редактируемо ТОЛЬКО когда одновременно: (а) у текущего
|
||||
пользователя сейчас активный шаг решения (`getPendingRowForCurrentUser`), и (б)
|
||||
его e-mail совпадает с результатом `getManagerEmail(..., 'chief')` для
|
||||
`data.Employee` — проверка по ИДЕНТИЧНОСТИ, а не по должности (в отличие от
|
||||
`approverRights.ts` «Обходного листа»: здесь должность руководителя может быть
|
||||
любой).
|
||||
- Обязательность применяется НЕ на уровне списка (иначе создание заявки падало
|
||||
бы — поле нечем заполнить до решения руководителя), а через
|
||||
`DecisionPanel.onBeforeDecide`: пустое поле бросает ошибку ДО применения
|
||||
решения (approve/return/reject — API не различает, какое именно) и сохраняет
|
||||
значение сразу перед ним, тем же приёмом, что «Обходной лист» использует для
|
||||
своих отметок.
|
||||
|
||||
## Отличия от «Обходной лист» (clearance-form)
|
||||
Обходной лист оформляет HR **после** решения об увольнении (обход подразделений,
|
||||
карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
|
||||
@@ -90,7 +153,8 @@ approval-route (`getPlannedMatrix` для фаз «Согласование» и
|
||||
|
||||
## Секции формы
|
||||
RequestSection (сотрудник · должность · структурное подразделение · самостоятельное
|
||||
подразделение · организация · последний рабочий день · телефон · комментарий)
|
||||
подразделение · организация (таблица у совместителей) · последний рабочий день ·
|
||||
телефон · комментарий · ссылка на обходной лист · лицо, принимающее ОС/НМА)
|
||||
|
||||
## Точки входа
|
||||
- rptype: `hr-dismissal`
|
||||
|
||||
@@ -36,11 +36,13 @@ export async function loadDismissalRequest(itemId: number, listId?: string): Pro
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
'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 assetsAcceptor = item.AssetsAcceptor as { EMail?: string } | undefined;
|
||||
const lastDay = (item.LastWorkingDay as string) || '';
|
||||
|
||||
const data: IFormData = {
|
||||
@@ -54,7 +56,8 @@ export async function loadDismissalRequest(itemId: number, listId?: string): Pro
|
||||
Comment: (item.Comment as string) || '',
|
||||
Organization: (item.Organization as string) || '',
|
||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || ''
|
||||
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || '',
|
||||
AssetsAcceptor: assetsAcceptor?.EMail || ''
|
||||
};
|
||||
|
||||
return {
|
||||
|
||||
@@ -44,6 +44,15 @@ export interface IFormData {
|
||||
* createClearance.ts) и не даёт править — только показывает переходом.
|
||||
*/
|
||||
ClearanceUrl: string;
|
||||
/**
|
||||
* Лицо, принимающее основные средства/нематериальные активы увольняемого —
|
||||
* People, колонка `AssetsAcceptor`. Заполняет НЕ заявитель, а непосредственный
|
||||
* руководитель увольняемого на своём шаге согласования (см. DismissalView) —
|
||||
* поэтому здесь нет отдельного плейсхолдера/секции формы подачи: поле в
|
||||
* IFormData только чтобы форма подачи не роняла это значение при пересохранении
|
||||
* (черновик/возврат), сама секция его не показывает и не редактирует.
|
||||
*/
|
||||
AssetsAcceptor: string;
|
||||
}
|
||||
|
||||
/** Обновление одного поля формы с сохранением типа значения. */
|
||||
@@ -71,7 +80,8 @@ export const EMPTY_DATA: IFormData = {
|
||||
Phone: '',
|
||||
Comment: '',
|
||||
Organization: '',
|
||||
ClearanceUrl: ''
|
||||
ClearanceUrl: '',
|
||||
AssetsAcceptor: ''
|
||||
};
|
||||
|
||||
/** Плейсхолдер для поля выбора сотрудника. */
|
||||
|
||||
@@ -13,6 +13,8 @@
|
||||
{ "internalName": "Comment", "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,53 @@
|
||||
@import '../../../../../styles/design-tokens';
|
||||
|
||||
.table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
font-family: $font-sans;
|
||||
font-size: 13.5px;
|
||||
}
|
||||
|
||||
.company,
|
||||
.position {
|
||||
box-sizing: border-box;
|
||||
padding: 11px 13px;
|
||||
border: 1px solid $gray-200;
|
||||
background: $gray-50;
|
||||
color: $gray-700;
|
||||
}
|
||||
|
||||
.company {
|
||||
border-right: 0;
|
||||
width: 55%;
|
||||
}
|
||||
|
||||
.position {
|
||||
border-right: 0;
|
||||
}
|
||||
|
||||
.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,56 @@
|
||||
import * as React from 'react';
|
||||
import { FormField, Icon } from '../../../shared/ui';
|
||||
import { IEmployeeOrganization } from '../../../shared/dictionary';
|
||||
import styles from './OrganizationsTable.module.scss';
|
||||
|
||||
interface IOrganizationsTableProps {
|
||||
records: IEmployeeOrganization[];
|
||||
/**
|
||||
* Убрать компанию из заявления — есть только на форме подачи (см.
|
||||
* DismissalForm.handleRemoveOrganization), не в режиме просмотра: там состав
|
||||
* компаний уже зафиксирован в отправленной заявке и маршруте.
|
||||
*/
|
||||
onRemove?: (company: string) => void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Организации совместителя — интерактивная таблица (не просто список строк, как
|
||||
* OrganizationField): у сотрудника, оформленного в НЕСКОЛЬКИХ компаниях
|
||||
* одновременно, увольнение затрагивает директора/должностного эквивалента КАЖДОЙ
|
||||
* из них (маршрут `HeadType.CompanyDirectors` в approval-route резолвит их всех).
|
||||
* Если реально уходит только из одной — заявитель убирает лишние компании ЗДЕСЬ,
|
||||
* и соответствующий согласующий убирается из матрицы автоматически (см.
|
||||
* DismissalForm.handleRemoveOrganization) — не нужно отдельно искать его в матрице
|
||||
* и удалять там вручную.
|
||||
*/
|
||||
export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({ records, onRemove }) => {
|
||||
if (records.length === 0) return null;
|
||||
|
||||
return (
|
||||
<FormField label="Организация" full>
|
||||
<table className={styles.table}>
|
||||
<tbody>
|
||||
{records.map((r) => (
|
||||
<tr key={r.companyId || r.company}>
|
||||
<td className={styles.company}>{r.company}</td>
|
||||
<td className={styles.position}>{r.position}</td>
|
||||
{onRemove && (
|
||||
<td className={styles.action}>
|
||||
<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>
|
||||
);
|
||||
};
|
||||
@@ -9,20 +9,45 @@ import {
|
||||
OrganizationField,
|
||||
LinkField
|
||||
} from '../../../shared/ui';
|
||||
import { IEmployeeOrganization } from '../../../shared/dictionary';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
|
||||
import { isoDatePlusDays } from '../../../shared/dateUtils';
|
||||
import { OrganizationsTable } from './OrganizationsTable';
|
||||
|
||||
// Структурное подразделение подтягивается из профиля при выборе сотрудника (см.
|
||||
// DismissalForm.handleEmployeeChange — SharePoint User Profile), свободный ввод
|
||||
// намеренно убран, чтобы не расходиться с профилем — как в «Обходном листе».
|
||||
const NOOP = (): void => undefined;
|
||||
|
||||
interface IRequestSectionProps extends ISectionProps {
|
||||
/**
|
||||
* Организации сотрудника СПИСКОМ (не joined-строкой из data.Organization) —
|
||||
* нужны, только когда таблицу можно редактировать (форма подачи): без них
|
||||
* пришлось бы разбирать обратно уже отформатированный текст. Не задано —
|
||||
* секция показывает data.Organization как раньше, одной read-only колонкой
|
||||
* (OrganizationField) — так работает режим просмотра (DismissalView).
|
||||
*/
|
||||
orgRecords?: IEmployeeOrganization[];
|
||||
/** Убрать компанию — см. OrganizationsTable. Только форма подачи. */
|
||||
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,
|
||||
orgRecords,
|
||||
onRemoveOrganization,
|
||||
assetsAcceptorEditable
|
||||
}) => (
|
||||
<CollapseSection title="Заявление на увольнение" icon="document">
|
||||
<FormField label="Сотрудник" htmlFor="Employee" required full>
|
||||
<PeopleField
|
||||
@@ -59,7 +84,11 @@ export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, on
|
||||
onChange={(v) => set('StandaloneUnit', v)}
|
||||
/>
|
||||
</FormField>
|
||||
<OrganizationField value={data.Organization} />
|
||||
{orgRecords && orgRecords.length > 1 ? (
|
||||
<OrganizationsTable records={orgRecords} onRemove={onRemoveOrganization} />
|
||||
) : (
|
||||
<OrganizationField value={data.Organization} />
|
||||
)}
|
||||
{/* Датой увольнения нельзя назначить прошедший день: заявление подаётся
|
||||
заранее, а не задним числом (min = сегодня). */}
|
||||
<FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
|
||||
@@ -84,5 +113,17 @@ export const RequestSection: React.FC<ISectionProps> = ({ data, set, context, on
|
||||
url={data.ClearanceUrl}
|
||||
text="Открыть обходной лист по этому увольнению"
|
||||
/>
|
||||
{/* Заполняет НЕ заявитель, а непосредственный руководитель увольняемого на
|
||||
своём шаге согласования (см. DismissalView) — здесь всегда read-only,
|
||||
кроме как для него самого в момент его решения (assetsAcceptorEditable). */}
|
||||
<FormField label="Лицо, принимающее ОС/НМА" htmlFor="AssetsAcceptor" required={assetsAcceptorEditable} full>
|
||||
<PeopleField
|
||||
context={context}
|
||||
value={data.AssetsAcceptor}
|
||||
onChange={(v) => set('AssetsAcceptor', v)}
|
||||
placeholder="Начните вводить Ф.И.О. сотрудника…"
|
||||
readOnly={assetsAcceptorEditable ? false : true}
|
||||
/>
|
||||
</FormField>
|
||||
</CollapseSection>
|
||||
);
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
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 { FORM_ID, IFormData } from './model';
|
||||
|
||||
@@ -22,7 +22,17 @@ function buildTitle(employeeName: string): string {
|
||||
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(
|
||||
data: IFormData,
|
||||
status: string,
|
||||
@@ -71,3 +81,15 @@ export async function saveDismissalRequest(
|
||||
await writeRoute(dismissalApprovalService(listId), result.id, approvers, [], status);
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Проставить «Лицо, принимающее ОС/НМА» — вызывается ИЗ DismissalView
|
||||
* непосредственным руководителем увольняемого перед его решением (см.
|
||||
* onBeforeDecide), не из формы подачи. email — People-значение (e-mail), пусто
|
||||
* не бывает: DismissalView не даёт согласовать шаг, пока поле не заполнено
|
||||
* (см. валидацию там же).
|
||||
*/
|
||||
export async function updateAssetsAcceptor(id: number, email: string, listId?: string): Promise<void> {
|
||||
const acceptor = await ensureEmployee(email);
|
||||
await resolveDataList(FORM_ID, listId).items.getById(id).update({ AssetsAcceptorId: acceptor.Id });
|
||||
}
|
||||
|
||||
@@ -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 { getEmployeeOrganizations, formatEmployeeOrganizations } from './employeeOrganizations.service';
|
||||
export type { IEmployeeOrganization } from './models/IEmployeeOrganization';
|
||||
export {
|
||||
directorPositionFor,
|
||||
getEmployeeEmailByPosition,
|
||||
getCompanyDirectorEmail,
|
||||
getManagerEmail
|
||||
} from './employeeLookup.service';
|
||||
|
||||
Reference in New Issue
Block a user