feat: таблица организаций хранится в списке — три JSON-столбца, видна в просмотре
Tests / frontend-test (pull_request) Successful in 1m11s
Tests / frontend-test (pull_request) Successful in 1m11s
Position, Department, Organization (Заявление на увольнение) теперь хранят JSON-массив строк каждый — компания/департамент/должность по каждой компании сотрудника, один и тот же индекс во всех трёх столбцах = одна запись (model.ts: IOrganizationRecord, zipOrganization/parseOrganizationColumn на чтение, submit.ts: organizationColumn на запись). Раньше Position/Department хранили только ПЕРВУЮ компанию, а Organization — плоский текст без департамента; полную таблицу теперь можно восстановить и показать где угодно. Модель данных формы существенно упростилась: вместо трёх независимых data.Position/Department/Organization + отдельного live-состояния orgRecords — один data.Organization: IOrganizationRecord[], primaryPosition() читает должность основной компании для маршрута и валидации. Загрузка на редактирование больше не ходит в Employee/ByEmail за живыми организациями — таблица целиком восстанавливается из уже сохранённой заявки. OrganizationsTable — теперь ЕДИНСТВЕННЫЙ рендерер таблицы и на форме подачи (редактируемая, editable-проп передан), и в режиме просмотра (read-only, проп не передан) — отдельных read-only полей для просмотра больше нет. createClearance.ts обновлён под новый формат (иначе автосоздание обходного листа читало бы Position/Department как сырой JSON-текст). Легаси: значения, сохранённые ДО перехода на JSON (не валидный JSON), не роняют чтение — трактуются как одна компания (parseOrganizationColumn). Риск: Position/Department — ОБЩИЙ столбец сайта на 8 форм портала, тип Text (лимит SharePoint 255 символов) — менять тип нельзя, задело бы все 8. Явная ошибка при сохранении, если JSON не укладывается (TEXT_COLUMN_LIMIT в submit.ts), вместо тихого обрезания данных. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -25,12 +25,7 @@ import {
|
||||
resolveWriteListId
|
||||
} from '../../shared/approval';
|
||||
import { IRequestFormProps } from '../../models/types';
|
||||
import {
|
||||
getEmployeeOrganizations,
|
||||
formatEmployeeOrganizations,
|
||||
getCompanyDirectorEmail,
|
||||
IEmployeeOrganization
|
||||
} from '../../shared/dictionary';
|
||||
import { getEmployeeOrganizations, getCompanyDirectorEmail, IEmployeeOrganization } from '../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { isoDatePlusMonths, formatIsoDate } from '../../shared/dateUtils';
|
||||
import {
|
||||
@@ -39,7 +34,7 @@ import {
|
||||
dataListTitle,
|
||||
dataListTitleForListId
|
||||
} from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField, MIN_NOTICE_MONTHS } from './model';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField, MIN_NOTICE_MONTHS, IOrganizationRecord, primaryPosition } from './model';
|
||||
import { saveDismissalRequest, dismissalApprovalService } from './submit';
|
||||
import { loadDismissalRequest } from './load';
|
||||
import { RequestSection } from './sections/RequestSection';
|
||||
@@ -56,10 +51,6 @@ 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);
|
||||
@@ -80,6 +71,10 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
// Таблица организаций читается ЦЕЛИКОМ из самой заявки (loaded.data.Organization
|
||||
// — уже собранная зипом трёх столбцов, см. load.ts) — повторный поход в
|
||||
// Employee/ByEmail здесь не нужен: если при подаче убрали компанию, это уже
|
||||
// зафиксировано в сохранённых данных, а не в живом состоянии справочника.
|
||||
loadDismissalRequest(editId, editListId)
|
||||
.then((loaded) => {
|
||||
if (alive) {
|
||||
@@ -87,22 +82,6 @@ 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) {
|
||||
@@ -115,11 +94,15 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId, editListId]);
|
||||
|
||||
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя, его
|
||||
// должность и департамент (Employee/ByEmail — см. shared/dictionary/
|
||||
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких
|
||||
// организациях, должность/департамент берём из ПЕРВОЙ записи — см.
|
||||
// OrganizationsTable, там же их можно поправить).
|
||||
/** Employee/ByEmail → таблица организаций (см. IOrganizationRecord). */
|
||||
const toOrganization = (records: IEmployeeOrganization[]): IOrganizationRecord[] =>
|
||||
records.map((r) => ({ company: r.company, department: r.section, position: r.position }));
|
||||
|
||||
// Новая заявка — по умолчанию на себя: подставляем текущего пользователя и его
|
||||
// таблицу организаций (Employee/ByEmail — см. shared/dictionary/
|
||||
// employeeOrganizations.service.ts; сотрудник может состоять сразу в нескольких).
|
||||
// Должность первой (основной) компании читает маршрут (см. primaryPosition) и
|
||||
// остаётся редактируемой на форме — см. OrganizationsTable.
|
||||
useEffect(() => {
|
||||
if (editId) {
|
||||
return;
|
||||
@@ -130,12 +113,9 @@ 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,
|
||||
Department: prev.Department || records[0]?.section || prev.Department,
|
||||
Organization: formatEmployeeOrganizations(records)
|
||||
Organization: prev.Organization.length > 0 ? prev.Organization : toOrganization(records)
|
||||
}));
|
||||
})
|
||||
.catch(() => undefined);
|
||||
@@ -145,23 +125,14 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId]);
|
||||
|
||||
// Выбор другого сотрудника подтягивает его должность, департамент и организации.
|
||||
// Выбор другого сотрудника подтягивает его таблицу организаций.
|
||||
const handleEmployeeChange = (login: string): void => {
|
||||
setData((prev) => ({ ...prev, Employee: login, Department: '', Organization: '' }));
|
||||
setOrgRecords([]);
|
||||
setData((prev) => ({ ...prev, Employee: login, Organization: [] }));
|
||||
if (!login) {
|
||||
return;
|
||||
}
|
||||
getEmployeeOrganizations(context, login)
|
||||
.then((records) => {
|
||||
setOrgRecords(records);
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Position: records[0]?.position || prev.Position,
|
||||
Department: records[0]?.section || prev.Department,
|
||||
Organization: formatEmployeeOrganizations(records)
|
||||
}));
|
||||
})
|
||||
.then((records) => setData((prev) => ({ ...prev, Organization: toOrganization(records) })))
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
@@ -175,13 +146,13 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
editId
|
||||
? approval.getMatrixForRequest(editId)
|
||||
: 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(
|
||||
loadMatrix,
|
||||
`${data.Employee}-${editId ?? 'new'}-${data.Position}`,
|
||||
`${data.Employee}-${editId ?? 'new'}-${primaryPosition(data.Organization)}`,
|
||||
!readOnly,
|
||||
!!editId || (!!data.Employee && !!requestTypeId),
|
||||
(login) => approval.getJobTitle(login)
|
||||
@@ -201,9 +172,7 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
// компания всё равно убирается из заявления, а несовпадение тихо игнорируем:
|
||||
// HR в этом случае уберёт лишнего согласующего вручную через саму матрицу.
|
||||
const handleRemoveOrganization = (company: string): void => {
|
||||
const remaining = orgRecords.filter((r) => r.company !== company);
|
||||
setOrgRecords(remaining);
|
||||
setData((prev) => ({ ...prev, Organization: formatEmployeeOrganizations(remaining) }));
|
||||
setData((prev) => ({ ...prev, Organization: prev.Organization.filter((r) => r.company !== company) }));
|
||||
|
||||
getCompanyDirectorEmail(context, company)
|
||||
.then((email) => {
|
||||
@@ -219,18 +188,13 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
// раннюю дату, но проверяем и здесь на случай обхода UI.
|
||||
const minLastWorkingDay = isoDatePlusMonths(MIN_NOTICE_MONTHS);
|
||||
const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= minLastWorkingDay;
|
||||
const isValid = !!(
|
||||
data.Employee &&
|
||||
data.Position.trim() &&
|
||||
data.LastWorkingDay &&
|
||||
isLastDayValid &&
|
||||
data.Phone.trim()
|
||||
);
|
||||
const position = primaryPosition(data.Organization);
|
||||
const isValid = !!(data.Employee && position.trim() && data.LastWorkingDay && isLastDayValid && data.Phone.trim());
|
||||
const validate = (): string | undefined => {
|
||||
if (data.LastWorkingDay && !isLastDayValid) {
|
||||
return `Последний рабочий день нужно назначать минимум за ${MIN_NOTICE_MONTHS} месяц — минимально доступная дата: ${formatIsoDate(minLastWorkingDay)}.`;
|
||||
}
|
||||
if (!data.Employee || !data.Position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
|
||||
if (!data.Employee || !position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
|
||||
return 'Заполните обязательные поля: сотрудник, должность, последний рабочий день, контактный телефон.';
|
||||
}
|
||||
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
|
||||
@@ -314,7 +278,6 @@ const DismissalForm: React.FC<IRequestFormProps> = ({
|
||||
set,
|
||||
context,
|
||||
onEmployeeChange: handleEmployeeChange,
|
||||
orgRecords,
|
||||
onRemoveOrganization: handleRemoveOrganization
|
||||
};
|
||||
|
||||
|
||||
@@ -26,25 +26,30 @@ RequestTypeId» в `docs/forms.md`). Тип заведён в админке app
|
||||
## Особое поведение
|
||||
- **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
|
||||
People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
|
||||
reloadKey матрицы включает `data.Employee` и `data.Position`.
|
||||
- **Автоподстановка при выборе сотрудника:** должность, департамент и организации —
|
||||
всё из ОДНОГО справочника `Employee/ByEmail` (`shared/dictionary`), должность и
|
||||
департамент — из ПЕРВОЙ записи (основная компания), чтобы были парой из одной
|
||||
записи. Совместитель с должностями/департаментами, различающимися по компаниям, —
|
||||
см. ниже «Организация · подразделение · должность».
|
||||
reloadKey матрицы включает `data.Employee` и должность основной компании (см. ниже).
|
||||
- **Автоподстановка при выборе сотрудника:** вся таблица организаций — из ОДНОГО
|
||||
справочника `Employee/ByEmail` (`shared/dictionary`) — см. «Организация ·
|
||||
подразделение · должность».
|
||||
- **«Организация · подразделение · должность»** (`OrganizationsTable`,
|
||||
`forms/Dismissal/sections/`) — на форме подачи ЕДИНСТВЕННОЕ место для компании,
|
||||
департамента и должности; отдельных полей для них больше нет (были дублированием
|
||||
того же, что уже показывала эта таблица). Компания и департамент по каждой
|
||||
компании — read-only; редактируется только должность ПЕРВОЙ (основной) компании —
|
||||
она и есть `data.Position`, используется маршрутом (условие «IsManager») и пишется
|
||||
в заявку; должности остальных компаний — информационные, не редактируются.
|
||||
Справочник ничего не вернул (сотрудник не найден в api.tnsu.kz) — таблица всё равно
|
||||
рендерится одной строкой с прочерками вместо компании/департамента и редактируемой
|
||||
должностью: иначе такому человеку нечем было бы заполнить обязательное поле.
|
||||
В режиме просмотра (`DismissalView`) — не таблица, а простые read-only поля
|
||||
«Должность»/«Департамент» + список организаций, как раньше (без live-запроса к
|
||||
справочнику: показывается то, что реально сохранено в заявке).
|
||||
`forms/Dismissal/sections/`) — ЕДИНСТВЕННОЕ место для компании, департамента и
|
||||
должности, и на форме подачи (редактируемая), и в режиме просмотра (read-only) —
|
||||
отдельных полей для них нет (были бы дублированием). `data.Organization:
|
||||
IOrganizationRecord[]` — массив `{company, department, position}`, компания и
|
||||
департамент по каждой строке 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`) — обязателен, не раньше чем через
|
||||
@@ -67,15 +72,14 @@ Approval-route резолвит маршрут через `HeadType.CompanyDirec
|
||||
`TemplateRouteService`). Это уже работает БЕЗ участия портала — сам approval-route
|
||||
резолвит все компании сотрудника через `Employee/ByEmail`.
|
||||
|
||||
Когда `Employee/ByEmail` вернул больше одной записи, `RequestSection` рендерит
|
||||
`OrganizationsTable` (не read-only `OrganizationField`) — таблицу «Компания —
|
||||
Должность» с кнопкой «убрать» у каждой строки (только на форме подачи, не в
|
||||
просмотре). Если сотрудник реально не увольняется из ВСЕХ компаний сразу, HR
|
||||
убирает лишние: `DismissalForm.handleRemoveOrganization`
|
||||
`OrganizationsTable` (см. предыдущий раздел) на форме подачи показывает кнопку
|
||||
«убрать» у каждой строки, когда компаний больше одной. Если сотрудник реально не
|
||||
увольняется из ВСЕХ компаний сразу, HR убирает лишние: `DismissalForm.handleRemoveOrganization`
|
||||
|
||||
1. снимает компанию из `data.Organization` (сохранённый текст всегда отражает
|
||||
ТЕКУЩИЙ, не первоначальный, набор — так же восстанавливается при повторном
|
||||
открытии черновика/возврата, см. загрузку `orgRecords` в `DismissalForm`);
|
||||
1. снимает запись из `data.Organization` (массив всегда отражает ТЕКУЩИЙ, не
|
||||
первоначальный, набор — так же восстанавливается при повторном открытии
|
||||
черновика/возврата: `loadDismissalRequest` читает его из уже сохранённых
|
||||
`Organization`/`Department`/`Position`, без обращения к справочнику заново);
|
||||
2. независимо резолвит директора/эквивалента этой компании через
|
||||
`getCompanyDirectorEmail` (`shared/dictionary/employeeLookup.service.ts` —
|
||||
зеркало того же `DirectorPositionByCompany`, что и на бэкенде) и удаляет
|
||||
@@ -166,8 +170,8 @@ approval-route (`getPlannedMatrix` для фаз «Согласование» и
|
||||
полей всего восемь, отметок подразделений нет.
|
||||
|
||||
## Секции формы
|
||||
RequestSection (сотрудник · организация/департамент/должность (таблица — форма
|
||||
подачи; должность/департамент/список компаний — просмотр) · самостоятельное
|
||||
RequestSection (сотрудник · организация/департамент/должность (таблица —
|
||||
редактируемая на форме подачи, read-only в просмотре) · самостоятельное
|
||||
подразделение · последний рабочий день · телефон · комментарий · ссылка на
|
||||
обходной лист · лицо, принимающее ОС/НМА)
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ import {
|
||||
import { requestLinkUrl } from '../../shared/routing';
|
||||
import { FORM_ID as CLEARANCE_FORM_ID, EMPTY_DATA as CLEARANCE_EMPTY, IFormData as IClearanceData } from '../Clearance/model';
|
||||
import { clearanceApprovalService, saveClearanceRequest } from '../Clearance/submit';
|
||||
import { FORM_ID } from './model';
|
||||
import { FORM_ID, primaryPosition, zipOrganization } from './model';
|
||||
|
||||
/** Результат автосоздания обходного листа по согласованному заявлению. */
|
||||
export interface IClearanceForDismissal {
|
||||
@@ -104,7 +104,16 @@ export async function ensureClearanceForDismissal(
|
||||
if (!employeeEmail) {
|
||||
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): партицию спрашиваем прямо сейчас, именно этот вызов
|
||||
@@ -124,10 +133,10 @@ export async function ensureClearanceForDismissal(
|
||||
...CLEARANCE_EMPTY,
|
||||
Employee: employeeEmail,
|
||||
Position: position,
|
||||
Department: (item.Department as string) || '',
|
||||
Department: department,
|
||||
// Последний рабочий день заявления = дата расторжения договора в обходном листе.
|
||||
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 { dataListTitle } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, zipOrganization } from './model';
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
@@ -48,13 +48,11 @@ export async function loadDismissalRequest(itemId: number, listId?: string): Pro
|
||||
const data: IFormData = {
|
||||
...EMPTY_DATA,
|
||||
Employee: employee?.EMail || '',
|
||||
Position: (item.Position as string) || '',
|
||||
Department: (item.Department as string) || '',
|
||||
StandaloneUnit: (item.StandaloneUnit as string) || '',
|
||||
LastWorkingDay: lastDay.slice(0, 10), // ISO → YYYY-MM-DD для input type=date
|
||||
Phone: (item.Phone as string) || '',
|
||||
Comment: (item.Comment as string) || '',
|
||||
Organization: (item.Organization as string) || '',
|
||||
Organization: zipOrganization(item.Organization, item.Department, item.Position),
|
||||
// Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
|
||||
ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || '',
|
||||
AssetsAcceptor: assetsAcceptor?.EMail || ''
|
||||
|
||||
@@ -7,6 +7,71 @@ import { RequestTypeId } from '../../models/types';
|
||||
*/
|
||||
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»: расторжение трудового договора по
|
||||
@@ -21,16 +86,6 @@ export const FORM_ID: RequestTypeId = 'hr-dismissal';
|
||||
export interface IFormData {
|
||||
/** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
|
||||
Employee: string;
|
||||
Position: string;
|
||||
/**
|
||||
* Департамент — поле Section из Employee/ByEmail (справочник api.tnsu.kz),
|
||||
* ПЕРВОЙ компании сотрудника (см. shared/dictionary/employeeOrganizations.
|
||||
* service.ts). Read-only, как раньше со «Структурным подразделением» из
|
||||
* профиля SharePoint — просто источник сменился на 1С/справочник портала.
|
||||
* На форме подачи виден внутри OrganizationsTable (колонка «Департамент» по
|
||||
* каждой компании), отдельного поля для него больше нет.
|
||||
*/
|
||||
Department: string;
|
||||
/** Самостоятельное подразделение — в справочнике его нет, вводится вручную. */
|
||||
StandaloneUnit: string;
|
||||
/** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
|
||||
@@ -40,11 +95,15 @@ export interface IFormData {
|
||||
/** Необязательный комментарий заявителя. */
|
||||
Comment: string;
|
||||
/**
|
||||
* Организации сотрудника (`\n`-joined «Компания — должность» на строку) —
|
||||
* подтягивается автоматически из Employee/ByEmail при выборе Employee,
|
||||
* read-only (см. shared/ui/OrganizationField).
|
||||
* Таблица компаний сотрудника (компания · департамент · должность на
|
||||
* каждую) — подтягивается автоматически из Employee/ByEmail при выборе
|
||||
* Employee. Первая запись — основная компания: её должность используется
|
||||
* маршрутом (см. primaryPosition) и остаётся редактируемой (см.
|
||||
* OrganizationsTable); должности/департаменты остальных — только для
|
||||
* просмотра. О ХРАНЕНИИ В СПИСКЕ (три параллельных JSON-массива по
|
||||
* столбцам) — см. IOrganizationRecord.
|
||||
*/
|
||||
Organization: string;
|
||||
Organization: IOrganizationRecord[];
|
||||
/**
|
||||
* Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
|
||||
* `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
|
||||
@@ -80,13 +139,11 @@ export interface ISectionProps {
|
||||
|
||||
export const EMPTY_DATA: IFormData = {
|
||||
Employee: '',
|
||||
Position: '',
|
||||
Department: '',
|
||||
StandaloneUnit: '',
|
||||
LastWorkingDay: '',
|
||||
Phone: '',
|
||||
Comment: '',
|
||||
Organization: '',
|
||||
Organization: [],
|
||||
ClearanceUrl: '',
|
||||
AssetsAcceptor: ''
|
||||
};
|
||||
|
||||
@@ -1,20 +1,18 @@
|
||||
import * as React from 'react';
|
||||
import { FormField, Icon, TextInput } from '../../../shared/ui';
|
||||
import { IEmployeeOrganization } from '../../../shared/dictionary';
|
||||
import { IOrganizationRecord } from '../model';
|
||||
import styles from './OrganizationsTable.module.scss';
|
||||
|
||||
interface IOrganizationsTableProps {
|
||||
records: IEmployeeOrganization[];
|
||||
records: IOrganizationRecord[];
|
||||
/**
|
||||
* Должность из ПЕРВОЙ (основной) компании — сюда же пишет форма (data.Position),
|
||||
* единственная ячейка «Должность», которая реально редактируется. У остальных
|
||||
* компаний (если сотрудник — совместитель) своя должность показывается как
|
||||
* есть в справочнике, но не редактируется: маршрут согласования резолвится по
|
||||
* ОДНОЙ должности основной компании (см. DismissalForm — fieldValues.Position),
|
||||
* ставить в соответствие ей должности других компаний незачем.
|
||||
* Должность ПЕРВОЙ (основной) компании редактируема — единственная ячейка
|
||||
* таблицы, у которой это так: маршрут согласования резолвится по НЕЙ (см.
|
||||
* DismissalForm — fieldValues.Position), должности остальных компаний
|
||||
* (совместитель) — только для просмотра, ставить им что-то в соответствие
|
||||
* незачем. Не задано — вся таблица read-only (режим просмотра, DismissalView).
|
||||
*/
|
||||
position: string;
|
||||
onChangePosition: (value: string) => void;
|
||||
onChangePosition?: (value: string) => void;
|
||||
/**
|
||||
* Убрать компанию из заявления — есть только на форме подачи (см.
|
||||
* DismissalForm.handleRemoveOrganization), не в режиме просмотра: там состав
|
||||
@@ -24,34 +22,32 @@ interface IOrganizationsTableProps {
|
||||
}
|
||||
|
||||
/**
|
||||
* Организации сотрудника — ЕДИНСТВЕННОЕ место на форме подачи, где видны и
|
||||
* правятся должность и подразделение (раньше были отдельными полями над этой
|
||||
* таблицей — убраны как дублирование, см. историю формы). Интерактивная
|
||||
* таблица, а не список строк (как OrganizationField в режиме просмотра): у
|
||||
* сотрудника, оформленного в НЕСКОЛЬКИХ компаниях одновременно, увольнение
|
||||
* затрагивает директора/должностного эквивалента КАЖДОЙ из них (маршрут
|
||||
* `HeadType.CompanyDirectors` в approval-route резолвит их всех). Если реально
|
||||
* уходит только из одной — заявитель убирает лишние компании ЗДЕСЬ, и
|
||||
* соответствующий согласующий убирается из матрицы автоматически (см.
|
||||
* DismissalForm.handleRemoveOrganization) — не нужно отдельно искать его в
|
||||
* матрице и удалять там вручную.
|
||||
* Организации сотрудника — ЕДИНСТВЕННОЕ место для компании/департамента/
|
||||
* должности, и на форме подачи (редактируемая — см. onChangePosition/onRemove),
|
||||
* и в режиме просмотра заявки (read-only, те же данные из сохранённой заявки,
|
||||
* а не live-запрос к справочнику — см. DismissalView). Раньше это были
|
||||
* отдельные поля над таблицей — убраны как дублирование того, что таблица и
|
||||
* так показывает.
|
||||
*
|
||||
* Пустой records (справочник api.tnsu.kz не нашёл сотрудника, см.
|
||||
* employeeOrganizations.service) — не «ничего не показываем», а ОДНА строка с
|
||||
* прочерками и редактируемой должностью: без этого заявление на человека без
|
||||
* карточки в справочнике нельзя было бы подать вовсе (некуда вписать должность
|
||||
* вручную — а маршрут согласования без неё не резолвит условие «IsManager»).
|
||||
* Интерактивная таблица, а не список строк: у сотрудника, оформленного в
|
||||
* НЕСКОЛЬКИХ компаниях одновременно, увольнение затрагивает директора/
|
||||
* должностного эквивалента КАЖДОЙ из них (маршрут `HeadType.CompanyDirectors`
|
||||
* в approval-route резолвит их всех). Если реально уходит только из одной —
|
||||
* заявитель убирает лишние компании ЗДЕСЬ, и соответствующий согласующий
|
||||
* убирается из матрицы автоматически (см. DismissalForm.handleRemoveOrganization)
|
||||
* — не нужно отдельно искать его в матрице и удалять там вручную.
|
||||
*
|
||||
* Пустой records в РЕДАКТИРУЕМОМ режиме (справочник api.tnsu.kz не нашёл
|
||||
* сотрудника) — не «ничего не показываем», а ОДНА строка с прочерками и
|
||||
* редактируемой должностью: без этого заявление на человека без карточки в
|
||||
* справочнике нельзя было бы подать вовсе (некуда вписать должность вручную —
|
||||
* а маршрут согласования без неё не резолвит условие «IsManager»).
|
||||
*/
|
||||
export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({
|
||||
records,
|
||||
position,
|
||||
onChangePosition,
|
||||
onRemove
|
||||
}) => {
|
||||
export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({ records, onChangePosition, onRemove }) => {
|
||||
const rows = records.length > 0 ? records : [undefined];
|
||||
|
||||
return (
|
||||
<FormField label="Организация · подразделение · должность" required full>
|
||||
<FormField label="Организация · подразделение · должность" required={!!onChangePosition} full>
|
||||
<table className={styles.table}>
|
||||
<thead>
|
||||
<tr>
|
||||
@@ -63,12 +59,12 @@ export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((r, i) => (
|
||||
<tr key={r?.companyId || r?.company || 'manual'}>
|
||||
<tr key={r?.company || 'manual'}>
|
||||
<td className={styles.company}>{r?.company || '—'}</td>
|
||||
<td className={styles.department}>{r?.section || '—'}</td>
|
||||
{i === 0 ? (
|
||||
<td className={styles.department}>{r?.department || '—'}</td>
|
||||
{i === 0 && onChangePosition ? (
|
||||
<td className={styles.positionInput}>
|
||||
<TextInput value={position} onChange={onChangePosition} placeholder="Введите должность" />
|
||||
<TextInput value={r?.position || ''} onChange={onChangePosition} placeholder="Введите должность" />
|
||||
</td>
|
||||
) : (
|
||||
<td className={styles.position}>{r?.position || '—'}</td>
|
||||
|
||||
@@ -1,31 +1,15 @@
|
||||
import * as React from 'react';
|
||||
import {
|
||||
CollapseSection,
|
||||
FormField,
|
||||
TextInput,
|
||||
TextArea,
|
||||
PhoneInput,
|
||||
PeopleField,
|
||||
OrganizationField,
|
||||
LinkField
|
||||
} from '../../../shared/ui';
|
||||
import { IEmployeeOrganization } from '../../../shared/dictionary';
|
||||
import { CollapseSection, FormField, TextInput, TextArea, PhoneInput, PeopleField, LinkField } from '../../../shared/ui';
|
||||
import { ISectionProps, EMPLOYEE_PLACEHOLDER, MIN_NOTICE_MONTHS } from '../model';
|
||||
import { isoDatePlusMonths } from '../../../shared/dateUtils';
|
||||
import { OrganizationsTable } from './OrganizationsTable';
|
||||
|
||||
interface IRequestSectionProps extends ISectionProps {
|
||||
/**
|
||||
* Организации сотрудника СПИСКОМ (не joined-строкой из data.Organization) —
|
||||
* заданы ТОЛЬКО на форме подачи (DismissalForm), где вместо read-only
|
||||
* OrganizationField показывается интерактивная OrganizationsTable: она же
|
||||
* теперь единственное место для должности и подразделения (см. её комментарий) —
|
||||
* отдельных полей выше больше нет, дублировать одно и то же дважды незачем.
|
||||
* Не задано (DismissalView, режим просмотра) — секция показывает Должность,
|
||||
* Подразделение и Организацию как раньше, простыми read-only полями.
|
||||
* Убрать компанию — есть только на форме подачи (DismissalForm), делает
|
||||
* OrganizationsTable редактируемой (кнопка «убрать» + должность первой
|
||||
* компании). Не задано — DismissalView, таблица read-only.
|
||||
*/
|
||||
orgRecords?: IEmployeeOrganization[];
|
||||
/** Убрать компанию — см. OrganizationsTable. Только форма подачи. */
|
||||
onRemoveOrganization?: (company: string) => void;
|
||||
/** Поле «Лицо, принимающее ОС/НМА» редактируемо — см. DismissalView. */
|
||||
assetsAcceptorEditable?: boolean;
|
||||
@@ -41,7 +25,6 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
set,
|
||||
context,
|
||||
onEmployeeChange,
|
||||
orgRecords,
|
||||
onRemoveOrganization,
|
||||
assetsAcceptorEditable
|
||||
}) => (
|
||||
@@ -54,27 +37,24 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
|
||||
placeholder={EMPLOYEE_PLACEHOLDER}
|
||||
/>
|
||||
</FormField>
|
||||
{orgRecords ? (
|
||||
// Форма подачи: должность, департамент и компании — только здесь, ниже.
|
||||
// Стоит ПЕРЕД «Самостоятельным подразделением» специально: остальные поля
|
||||
// формы читают уже подставленную должность/компанию, а не наоборот.
|
||||
<OrganizationsTable
|
||||
records={orgRecords}
|
||||
position={data.Position}
|
||||
onChangePosition={(v) => set('Position', v)}
|
||||
onRemove={onRemoveOrganization}
|
||||
/>
|
||||
) : (
|
||||
<>
|
||||
<FormField label="Должность" htmlFor="Position">
|
||||
<TextInput id="Position" value={data.Position} onChange={(v) => set('Position', v)} />
|
||||
</FormField>
|
||||
<FormField label="Департамент" htmlFor="Department">
|
||||
<TextInput id="Department" value={data.Department} onChange={(v) => set('Department', v)} />
|
||||
</FormField>
|
||||
<OrganizationField value={data.Organization} />
|
||||
</>
|
||||
)}
|
||||
{/* ЕДИНСТВЕННОЕ место для компании/департамента/должности — и на форме
|
||||
подачи (редактируемая, onRemoveOrganization задан), и в просмотре
|
||||
(read-only, ничего не передано). Отдельных полей для них нет — были бы
|
||||
дублированием того, что уже показывает эта таблица. */}
|
||||
<OrganizationsTable
|
||||
records={data.Organization}
|
||||
onChangePosition={
|
||||
onRemoveOrganization &&
|
||||
((v) =>
|
||||
set(
|
||||
'Organization',
|
||||
data.Organization.length > 0
|
||||
? data.Organization.map((r, i) => (i === 0 ? { ...r, position: v } : r))
|
||||
: [{ company: '', department: '', position: v }]
|
||||
))
|
||||
}
|
||||
onRemove={onRemoveOrganization}
|
||||
/>
|
||||
<FormField label="Самостоятельное подразделение" htmlFor="StandaloneUnit">
|
||||
<TextInput id="StandaloneUnit" value={data.StandaloneUnit} onChange={(v) => set('StandaloneUnit', v)} />
|
||||
</FormField>
|
||||
|
||||
@@ -1,7 +1,43 @@
|
||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||
import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
|
||||
import { ensureEmployee } from '../../shared/employee';
|
||||
import { FORM_ID, IFormData } from './model';
|
||||
import { FORM_ID, IFormData, 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;
|
||||
}
|
||||
|
||||
/**
|
||||
* Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
|
||||
@@ -43,13 +79,16 @@ function buildItem(
|
||||
Title: buildTitle(employeeName),
|
||||
RequestStatus: status,
|
||||
EmployeeId: employeeId,
|
||||
Position: data.Position || null,
|
||||
Department: data.Department || null,
|
||||
// Три параллельных JSON-массива, один индекс — одна компания (см.
|
||||
// IOrganizationRecord) — отдельные столбцы, а не общий блок. Лимит только
|
||||
// на Position/Department (Text, см. TEXT_COLUMN_LIMIT) — Organization это Note.
|
||||
Position: organizationColumn(data.Organization, (r) => r.position, 'Должность', TEXT_COLUMN_LIMIT),
|
||||
Department: organizationColumn(data.Organization, (r) => r.department, 'Департамент', TEXT_COLUMN_LIMIT),
|
||||
Organization: organizationColumn(data.Organization, (r) => r.company, 'Организация'),
|
||||
StandaloneUnit: data.StandaloneUnit || null,
|
||||
LastWorkingDay: data.LastWorkingDay || null,
|
||||
Phone: data.Phone || null,
|
||||
Comment: data.Comment || null,
|
||||
Organization: data.Organization || null
|
||||
Comment: data.Comment || null
|
||||
};
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user