merge branch

2026-08-26 16:03:49 +05:00
parent a4bc54def2 df29d080ed
commit 418e30dfc3
40 changed files with 2462 additions and 47 deletions
@@ -45,7 +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» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД), сумма обучения | ✅ |
+| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker) либо создаётся сам по согласованному «Заявлению на увольнение»; условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД); 6 независимых пар «сумма к списанию + комментарий» (ОС, СИЗ, подотчётная сумма, обучение, НМА, ТМЦ) — вводит любой активный согласующий, блокируется навсегда после первого ввода | ✅ |
 | [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | совместители — таблица компаний с удалением строки (снимает и согласующего из матрицы); должность/организация из справочника; **после согласования сам создаёт обходной лист**; печать заблокирована до согласования обходного листа; «Лицо, принимающее ОС/НМА» — заполняет только непосредственный руководитель | ✅ |
 | `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
 Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
@@ -44,6 +44,8 @@
 | `recruiting-hire` | Заявка на прием | Рекрутинг | да | да | — |
 | `it-workplace-setup` | Организация рабочего места | IT | да | да | из `recruiting-hire` |
 | `it-1c-ticket` | Заявка в отдел 1С | IT | да | да | — |
 | `hr-dismissal` | Заявление на увольнение | Отдел кадров | да | да | — |
 | `clearance-form` | Обходной лист | Отдел кадров | да | да | создаётся сам по согласованному `hr-dismissal` |
 | `hr-transfer` | На перемещение сотрудников | Отдел кадров | (в разработке) | — | — |
 ---
@@ -4,11 +4,14 @@
  по манифестам provisioning.json (единый источник правды по колонкам).
 .DESCRIPTION
-  Обходит ВСЕ манифесты forms/**/provisioning.json (в т.ч. подпапки approval/) и для
+  Обходит ВСЕ манифесты forms/**/provisioning.json (в т.ч. подпапки approval/)
-  каждого:
+  ДВУМЯ проходами:
-    1) создаёт список (если его ещё нет);
+    1) создаёт ВСЕ списки (которых ещё нет);
-    2) при необходимости переименовывает колонку Title;
+    2) по каждому манифесту: при необходимости переименовывает колонку Title и
-    3) обеспечивает колонки.
+       обеспечивает колонки.
  Проходы разделены из-за Lookup'ов между формами: список-источник должен
  существовать раньше колонки, а при перекрёстных ссылках (две формы ссылаются
  друг на друга) одним проходом это недостижимо ни при каком порядке обхода.
  Имена списков НУМЕРОВАННЫЕ: «<Форма> <N> — данные» / «<Форма> <N> — согласование».
  Номер собирает сам скрипт из имени в манифесте (см. Get-NumberedListTitle) — в
@@ -170,6 +173,7 @@ function Ensure-SiteColumn {
    }
    'Choice' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type Choice -Choices $Col.choices -Group $g | Out-Null }
    'Number' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type Number -Group $g | Out-Null }
    'Url' { Add-PnPField -InternalName $Col.internalName -DisplayName $Col.title -Type URL -Group $g | Out-Null }
    default { throw "Неизвестный тип столбца сайта '$($Col.type)'" }
  }
  Write-Host "  [+эталон] $($Col.internalName) — «$($Col.title)» [$($Col.type)]" -ForegroundColor Green
@@ -214,6 +218,7 @@ function Add-ListColumn {
        }
      }
      'Choice' { Add-PnPField -List $List -InternalName $Col.internalName -DisplayName $Col.title -Type Choice -Choices $Col.choices -AddToDefaultView | Out-Null }
      'Url' { Add-PnPField -List $List -InternalName $Col.internalName -DisplayName $Col.title -Type URL -AddToDefaultView | Out-Null }
      'Number' {
        if ($null -ne $Col.decimals) {
          $xml = "<Field Type='Number' DisplayName='$(ConvertTo-XmlSafe $Col.title)' Name='$($Col.internalName)' Decimals='$($Col.decimals)' />"
@@ -325,21 +330,35 @@ if ($ListNumber -eq 1 -and -not $SkipRename) {
  }
 }
 # Проход 1: САМИ СПИСКИ — все до единого, ДО колонок.
 #
 # Раньше список и его колонки создавались одним проходом по манифесту, и Lookup на
 # список ДРУГОЙ формы (WorkplaceSetup.SourceHire → «Прием на работу … — данные»)
 # резолвился только если та форма попадалась в обходе раньше — то есть держался на
 # алфавитном везении, а для взаимных ссылок был бы невозможен в принципе. Поэтому
 # сначала все списки, потом все колонки: к моменту разрешения любого Lookup'а
 # список-источник уже существует.
 Write-Host "`n=== Списки ===" -ForegroundColor Cyan
 foreach ($manifest in $manifests) {
  $def = Get-Content -Path $manifest.FullName -Raw -Encoding UTF8 | ConvertFrom-Json
  $listTitle = Get-NumberedListTitle -Title $def.dataListTitle -Number $ListNumber
  if (-not (Get-PnPList -Identity $listTitle -ErrorAction SilentlyContinue)) {
    New-PnPList -Title $listTitle -Template GenericList -EnableVersioning | Out-Null
    Write-Host "  [+] создан список «$listTitle»" -ForegroundColor Green
  }
  else {
    Write-Host "  [=] список уже существует: «$listTitle»" -ForegroundColor DarkGray
  }
 }
 # Проход 2: колонки (и переименование Title) — по одному манифесту за раз.
 foreach ($manifest in $manifests) {
  $def = Get-Content -Path $manifest.FullName -Raw -Encoding UTF8 | ConvertFrom-Json
  $listTitle = Get-NumberedListTitle -Title $def.dataListTitle -Number $ListNumber
  Write-Host "`n=== Форма: $($manifest.Directory.Name) → список «$listTitle» ===" -ForegroundColor Cyan
-  # 1) Список (идемпотентно)
+  # 1) Переименование Title (если задано)
  if (-not (Get-PnPList -Identity $listTitle -ErrorAction SilentlyContinue)) {
    New-PnPList -Title $listTitle -Template GenericList -EnableVersioning | Out-Null
    Write-Host "  [+] создан список" -ForegroundColor Green
  }
  else {
    Write-Host "  [=] список уже существует" -ForegroundColor DarkGray
  }
  # 2) Переименование Title (если задано)
  if ($def.titleColumnName) {
    try {
      Set-PnPField -List $listTitle -Identity 'Title' -Values @{ Title = $def.titleColumnName } | Out-Null
@@ -350,7 +369,7 @@ foreach ($manifest in $manifests) {
    }
  }
-  # 3) Колонки (идемпотентно): не-Lookup — через эталоны (столбцы сайта), Lookup — на список.
+  # 2) Колонки (идемпотентно): не-Lookup — через эталоны (столбцы сайта), Lookup — на список.
  foreach ($col in $def.columns) {
    Add-ColumnToList -List $listTitle -Col $col
  }
@@ -25,12 +25,15 @@
 | `DateTime` | дата/время         | —         |
 | `Boolean`  | да/нет             | —         |
 | `User`     | пользователь       | —         |
 | `Url`      | гиперссылка (адрес + подпись) | — |
 | `Lookup`   | подстановка        | `lookupList` (заголовок источника), `lookupShowField` (по умолч. `Title`) |
 Плюс на уровне формы: `titleColumnName` — переименовать стандартную колонку `Title`.
 > **Порядок для Lookup:** список-источник должен существовать раньше, чем колонка,
-> которая на него ссылается. Если источник в другой форме — сначала прогоните её манифест.
+> которая на него ссылается — но следить за этим руками не нужно: скрипт сначала
 > создаёт ВСЕ списки, и только потом колонки, поэтому порядок обхода манифестов
 > не важен (и взаимные ссылки тоже разрешимы).
 ## Разовая подготовка
@@ -17,6 +17,7 @@ export const REQUEST_TYPES: IRequestType[] = [
  // Отдел кадров
  { id: 'hr-vacation', categoryId: 'hr', title: 'Заявка на трудовой отпуск', icon: 'calendar' },
  { id: 'hr-unpaid-leave', categoryId: 'hr', title: 'Заявка на отпуск без содержания', icon: 'document' },
  { id: 'hr-dismissal', categoryId: 'hr', title: 'Заявление на увольнение', icon: 'document' },
  { id: 'clearance-form', categoryId: 'hr', title: 'Обходной лист', icon: 'clipboard' },
  { id: 'hr-transfer', categoryId: 'hr', title: 'Заявка на перемещение сотрудников', icon: 'people' },
@@ -421,6 +421,12 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
          ? undefined
          : (partial: IPage): void => {
              if (cancelled) return;
              // ПУСТОЙ промежуточный результат не показываем: смысл onPartial —
              // не держать экран пустым, пока отвечает более медленный источник,
              // а пустая страница как раз пустой экран и даёт, только вместо
              // «Загрузка…» на нём появляется «Вы ещё не создавали заявок» —
              // и через мгновение исчезает, когда придёт второй источник.
              if (partial.rows.length === 0) return;
              setRows(partial.rows);
              setTotalRows(partial.totalRows);
            };
@@ -477,6 +483,18 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
  const q = debouncedQuery.trim();
  const total = totalRows;
  const visible = rows || [];
  /**
   * Можно ли уже судить о содержимом таблицы.
   *
   * Пустоту («Вы ещё не создавали заявок») объявляем ТОЛЬКО по завершённой
   * загрузке именно ЭТОЙ таблицы (loadedKey), а не по любому пустому rows: до
   * этого rows может быть пустым по совершенно другой причине — часть источников
   * ещё в пути (см. onPartial выше, «Мои заявки» собираются из Search + REST).
   * Промежуточный НЕПУСТОЙ результат показывать можно и нужно — в нём уже есть
   * что смотреть.
   */
  const loaded = loadedKey === dataKey || visible.length > 0;
  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
  // Страница может оказаться за пределами набора: пришла из старой ссылки или
@@ -527,8 +545,8 @@ export const RequestsTableView: React.FC<IRequestsTableViewProps> = ({
      </div>
      {error && <div className={styles.error}>Не удалось загрузить заявки: {error}</div>}
-      {!error && rows === undefined && <div className={styles.empty}>Загрузка…</div>}
+      {!error && !loaded && <div className={styles.empty}>Загрузка…</div>}
-      {!error && rows && total === 0 && (
+      {!error && loaded && total === 0 && (
        <div className={styles.empty}>
          {q ? `По запросу «${debouncedQuery}» ничего не найдено.` : EMPTY_TEXTS[view]}
        </div>
@@ -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,10 +54,18 @@ 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');
  // Какая из организаций сотрудника (см. OrganizationField) идёт в печать —
  // выбор в тулбаре через PrintOrgSelect, по умолчанию первая.
  const [printOrgIndex, setPrintOrgIndex] = useState<number>(0);
  const [saveErrorMessage, setSaveErrorMessage] = useState<string>('');
  const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
@@ -105,6 +115,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) => {
@@ -130,11 +143,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 () => {
@@ -143,9 +160,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;
@@ -154,15 +186,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');
    }
  };
@@ -178,8 +231,21 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
    );
  }
-  const canEditAnything = hrRecordsEditable || parkingEditable;
+  const canEditAnything = hrRecordsEditable || parkingEditable || canEditWriteOffs;
-  const sectionProps = { data, set, context, hrRecordsEditable, parkingEditable, printOrgIndex };
+  const reviewHints = [
    hrRecordsEditable && 'отметить карту СКУД и указать сумму за обучение',
    parkingEditable && 'отметить парковочную карту',
    editableWriteOffKeys.size > 0 && 'указать суммы к списанию (если применимо)'
  ].filter((hint): hint is string => !!hint);
  const sectionProps = {
    data,
    set,
    context,
    hrRecordsEditable,
    parkingEditable,
    writeOffEditableKeys: editableWriteOffKeys,
    printOrgIndex
  };
  const notify = (): void => {
    // requestTypeId ещё не резолвился — решение уже применилось (строка списка
@@ -203,15 +269,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>
      )}
@@ -39,8 +39,46 @@ RequestTypeId» в `docs/forms.md`). Тип уже зарегистрирова
  (в отличие от `EndDate` в «Заявке на отпуск», которая считается).
 - **Заголовок элемента** (`Title`): `Обходной лист — {ФИО} — дд.мм.гггг`.
 ## Связь с заявлением на увольнение
 Обходной лист может появиться **сам, без этой формы**: когда согласовано «Заявление
 на увольнение» (`hr-dismissal`), портал создаёт лист по нему и сразу отправляет на
 согласование — см. `forms/Dismissal/createClearance.ts` и README той формы. Такой
 лист приходит уже с заполненными сотрудником, должностью, подразделением и датой
 расторжения; отметки (парковка, СКУД, обучение) по-прежнему проставляют профильные
 согласующие. Подача этой формы руками остаётся — для увольнений, оформленных без
 заявления в портале.
 Пара связана колонками-гиперссылками: `DismissalUrl` здесь → на заявление,
 `ClearanceUrl` в заявлении → на лист. Форма их не пишет (заполняет автосоздание либо
 вручную в SharePoint), но **показывает**: поле «Заявление на увольнение» —
 `LinkField` из `shared/ui`, read-only, открывается в той же вкладке; у листов,
 заведённых руками, ссылки нет и поле не рендерится.
 ## Суммы к списанию (согласование)
 6 НЕЗАВИСИМЫХ пар «сумма + обязательный комментарий (за что конкретно)», колонки
 `WriteOff{Assets,Ppe,Accountable,Training,Nma,Tmc}{Amount,Comment}` (см. `model.ts
 WRITE_OFF_CATEGORIES`): «ОС», «СИЗ», «Подотчётная сумма», «Обучение», «НМА», «ТМЦ».
 - **Не привязаны к должности**, в отличие от отметок выше: заполнить может ЛЮБОЙ
  согласующий, у которого сейчас активный шаг (`ClearanceView.canEditWriteOffs`,
  фаза «Согласование» — исполнителям недоступно, как и остальным отметкам).
 - **Каждая пара блокируется НАВСЕГДА после первого ввода** — как только сумма
  непустая, поле становится read-only для всех, включая того, кто её ввёл.
  Признак блокировки — сама непустая сумма на МОМЕНТ ЗАГРУЗКИ страницы
  (`ClearanceView.lockedWriteOffs`, снимок при загрузке, а не реактивно от
  текущего `data` — иначе поле блокировалось бы прямо во время набора цифр).
 - **Комментарий обязателен вместе с суммой**: заполнить можно либо обе половины
  пары, либо ни одной — `saveApproverFields` бросает ДО записи чего бы то ни
  было, если половина пары осталась пустой.
 - Сохраняются той же кнопкой «Сохранить» (`reviewBar`), что и остальные отметки,
  и тем же `onBeforeDecide` — при решении несохранённые суммы уйдут вместе с ним.
 - Это ОТДЕЛЬНЫЙ механизм от `TrainingAmount` («Обучение: сумма» выше, привязана к
  КДП) — сознательно не объединялись, чтобы не менять уже установившееся
  поведение существующего поля.
 ## Секции формы
-RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма обучения · парковочная карта · карта СКУД)
+RequestSection (сотрудник · должность · подразделение · дата расторжения · сумма
 обучения · парковочная карта · карта СКУД · суммы к списанию · ссылка на заявление)
 ## Точки входа
 - rptype: `clearance-form`
@@ -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 (для заголовка режима чтения). */
@@ -34,6 +39,19 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
      'Organization',
      'Project',
      'ProjectId',
      'DismissalUrl',
      'WriteOffAssetsAmount',
      'WriteOffAssetsComment',
      'WriteOffPpeAmount',
      'WriteOffPpeComment',
      'WriteOffAccountableAmount',
      'WriteOffAccountableComment',
      'WriteOffTrainingAmount',
      'WriteOffTrainingComment',
      'WriteOffNmaAmount',
      'WriteOffNmaComment',
      'WriteOffTmcAmount',
      'WriteOffTmcComment',
      'RequestStatus',
      'RequestUniqueCode',
      'Employee/Title',
@@ -56,7 +74,21 @@ export async function loadClearanceRequest(itemId: number, listId?: string): Pro
    TrainingAmount: amount === null || amount === undefined ? '' : String(amount),
    Organization: (item.Organization as string) || '',
    Project: (item.Project as string) || '',
-    ProjectId: (item.ProjectId as string) || ''
+    ProjectId: (item.ProjectId as string) || '',
    // Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
    DismissalUrl: (item.DismissalUrl as { Url?: string } | undefined)?.Url || '',
    WriteOffAssetsAmount: numberField(item.WriteOffAssetsAmount),
    WriteOffAssetsComment: (item.WriteOffAssetsComment as string) || '',
    WriteOffPpeAmount: numberField(item.WriteOffPpeAmount),
    WriteOffPpeComment: (item.WriteOffPpeComment as string) || '',
    WriteOffAccountableAmount: numberField(item.WriteOffAccountableAmount),
    WriteOffAccountableComment: (item.WriteOffAccountableComment as string) || '',
    WriteOffTrainingAmount: numberField(item.WriteOffTrainingAmount),
    WriteOffTrainingComment: (item.WriteOffTrainingComment as string) || '',
    WriteOffNmaAmount: numberField(item.WriteOffNmaAmount),
    WriteOffNmaComment: (item.WriteOffNmaComment as string) || '',
    WriteOffTmcAmount: numberField(item.WriteOffTmcAmount),
    WriteOffTmcComment: (item.WriteOffTmcComment as string) || ''
  };
  return {
@@ -35,8 +35,84 @@ export interface IFormData {
  Project: string;
  /** oid проекта ('' — если введён вручную без выбора из списка). */
  ProjectId: string;
  /**
   * Ссылка на заявление на увольнение, по которому создан этот лист — колонка-
   * гиперссылка `DismissalUrl`. Форма её не пишет (заполняет автосоздание, см.
   * forms/Dismissal/createClearance.ts) и не даёт править — только показывает.
   */
  DismissalUrl: string;
  /**
   * Суммы к списанию по обходному листу — 6 независимых пар (сумма +
   * обязательный комментарий, «за что конкретно»), см. WRITE_OFF_CATEGORIES.
   * «Сырые» цифры без пробелов, как TrainingAmount (см. MoneyInput). Пусто =
   * не заполнено. КАЖДАЯ пара — независимая: заполнить может любой активный
   * согласующий (см. ClearanceView.canEditWriteOffs), но как только сумма
   * непустая — пара блокируется НАВСЕГДА, для всех (включая того, кто её ввёл).
   * Признак блокировки — сама непустая сумма, отдельного флага в списке нет.
   */
  WriteOffAssetsAmount: string;
  WriteOffAssetsComment: string;
  WriteOffPpeAmount: string;
  WriteOffPpeComment: string;
  WriteOffAccountableAmount: string;
  WriteOffAccountableComment: string;
  WriteOffTrainingAmount: string;
  WriteOffTrainingComment: string;
  WriteOffNmaAmount: string;
  WriteOffNmaComment: string;
  WriteOffTmcAmount: string;
  WriteOffTmcComment: string;
 }
 /** Имена всех 12 строковых полей сумм/комментариев к списанию — см. IFormData.WriteOff*. */
 export type WriteOffFieldKey =
  | 'WriteOffAssetsAmount'
  | 'WriteOffAssetsComment'
  | 'WriteOffPpeAmount'
  | 'WriteOffPpeComment'
  | 'WriteOffAccountableAmount'
  | 'WriteOffAccountableComment'
  | 'WriteOffTrainingAmount'
  | 'WriteOffTrainingComment'
  | 'WriteOffNmaAmount'
  | 'WriteOffNmaComment'
  | 'WriteOffTmcAmount'
  | 'WriteOffTmcComment';
 /**
 * Одна из 6 независимых категорий списания — см. IFormData.WriteOff*.
 * amountField/commentField сужены до WriteOffFieldKey (а не keyof IFormData
 * целиком): у IFormData есть и булевы поля (ParkingCard/AccessCard), и
 * `data[cat.amountField]` должен типизироваться строго строкой — иначе
 * `.trim()` в валидации и передача в MoneyInput/TextArea не собираются.
 */
 export interface IWriteOffCategory {
  key: string;
  label: string;
  amountField: WriteOffFieldKey;
  commentField: WriteOffFieldKey;
 }
 export const WRITE_OFF_CATEGORIES: IWriteOffCategory[] = [
  { key: 'assets', label: 'ОС', amountField: 'WriteOffAssetsAmount', commentField: 'WriteOffAssetsComment' },
  { key: 'ppe', label: 'СИЗ', amountField: 'WriteOffPpeAmount', commentField: 'WriteOffPpeComment' },
  {
    key: 'accountable',
    label: 'Подотчётная сумма',
    amountField: 'WriteOffAccountableAmount',
    commentField: 'WriteOffAccountableComment'
  },
  {
    key: 'training',
    label: 'Обучение',
    amountField: 'WriteOffTrainingAmount',
    commentField: 'WriteOffTrainingComment'
  },
  { key: 'nma', label: 'НМА', amountField: 'WriteOffNmaAmount', commentField: 'WriteOffNmaComment' },
  { key: 'tmc', label: 'ТМЦ', amountField: 'WriteOffTmcAmount', commentField: 'WriteOffTmcComment' }
 ];
 /** Обновление одного поля формы с сохранением типа значения. */
 export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
@@ -64,7 +140,20 @@ export const EMPTY_DATA: IFormData = {
  TrainingAmount: '',
  Organization: '',
  Project: '',
-  ProjectId: ''
+  ProjectId: '',
  DismissalUrl: '',
  WriteOffAssetsAmount: '',
  WriteOffAssetsComment: '',
  WriteOffPpeAmount: '',
  WriteOffPpeComment: '',
  WriteOffAccountableAmount: '',
  WriteOffAccountableComment: '',
  WriteOffTrainingAmount: '',
  WriteOffTrainingComment: '',
  WriteOffNmaAmount: '',
  WriteOffNmaComment: '',
  WriteOffTmcAmount: '',
  WriteOffTmcComment: ''
 };
 /** Плейсхолдер для поля выбора сотрудника. */
@@ -14,6 +14,21 @@
    { "internalName": "TrainingAmount", "title": "Обучение: сумма", "type": "Number", "decimals": 2 },
    { "internalName": "Organization", "title": "Организация", "type": "Note" },
    { "internalName": "Project", "title": "Проект", "type": "Text" },
-    { "internalName": "ProjectId", "title": "Id проекта (справочник)", "type": "Text" }
+    { "internalName": "ProjectId", "title": "Id проекта (справочник)", "type": "Text" },
    { "internalName": "DismissalUrl", "title": "Ссылка на заявление на увольнение", "type": "Url" },
    { "internalName": "WriteOffAssetsAmount", "title": "Сумма к списанию: ОС", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffAssetsComment", "title": "Комментарий: ОС", "type": "Note" },
    { "internalName": "WriteOffPpeAmount", "title": "Сумма к списанию: СИЗ", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffPpeComment", "title": "Комментарий: СИЗ", "type": "Note" },
    { "internalName": "WriteOffAccountableAmount", "title": "Сумма к списанию: подотчётная сумма", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffAccountableComment", "title": "Комментарий: подотчётная сумма", "type": "Note" },
    { "internalName": "WriteOffTrainingAmount", "title": "Сумма к списанию: обучение", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffTrainingComment", "title": "Комментарий: обучение", "type": "Note" },
    { "internalName": "WriteOffNmaAmount", "title": "Сумма к списанию: НМА", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffNmaComment", "title": "Комментарий: НМА", "type": "Note" },
    { "internalName": "WriteOffTmcAmount", "title": "Сумма к списанию: ТМЦ", "type": "Number", "decimals": 2 },
    { "internalName": "WriteOffTmcComment", "title": "Комментарий: ТМЦ", "type": "Note" }
  ]
 }
@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { CollapseSection, FormField, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField } from '../../../shared/ui';
+import { CollapseSection, FormField, TextArea, TextInput, MoneyInput, Toggle, PeopleField, OrganizationField, LinkField } from '../../../shared/ui';
 import { ProjectPicker } from '../../../shared/dictionary';
-import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
+import { ISectionProps, EMPLOYEE_PLACEHOLDER, WRITE_OFF_CATEGORIES } from '../model';
 // Подразделение подтягивается автоматически при выборе сотрудника (см.
 // ClearanceForm.handleEmployeeChange — SharePoint User Profile) — свободный
@@ -13,6 +13,14 @@ interface IRequestSectionProps extends ISectionProps {
  hrRecordsEditable?: boolean;
  /** Согласующий из отдела подбора правит парковочную карту. */
  parkingEditable?: boolean;
  /**
   * Ключи категорий списания (см. WRITE_OFF_CATEGORIES), которые ЭТОТ
   * пользователь может сейчас заполнить — присутствие пропа (даже пустым
   * Set'ом) включает блок сумм к списанию; не задан вовсе (форма подачи, см.
   * ClearanceForm) — блок не показывается: до первого решения списывать
   * нечего. См. ClearanceView.editableWriteOffKeys.
   */
  writeOffEditableKeys?: Set<string>;
 }
 /** Единственная секция формы «Обходной лист»: увольняемый, должность, подразделение, даты, карты, обучение. */
@@ -23,7 +31,8 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
  onEmployeeChange,
  hrRecordsEditable,
  parkingEditable,
-  printOrgIndex
+  printOrgIndex,
  writeOffEditableKeys
 }) => (
  <CollapseSection title="Обходной лист" icon="people">
    <FormField label="Сотрудник" htmlFor="Employee" required full>
@@ -103,5 +112,47 @@ export const RequestSection: React.FC<IRequestSectionProps> = ({
        readOnly={hrRecordsEditable ? false : undefined}
      />
    </FormField>
    {/* Суммы к списанию — 6 независимых пар (сумма + обязательный комментарий,
        за что конкретно). Каждую может заполнить ЛЮБОЙ активный согласующий
        (не только профильный, в отличие от отметок выше) — но как только сумма
        указана, пара блокируется навсегда для всех, поэтому у незаблокированных
        (writeOffEditableKeys.has(cat.key)) есть readOnly={false}, у остальных —
        обычное поведение FormMode (просмотр — заблокировано и так). */}
    {writeOffEditableKeys &&
      WRITE_OFF_CATEGORIES.map((cat) => {
        const editable = writeOffEditableKeys.has(cat.key);
        return (
          <React.Fragment key={cat.key}>
            <FormField label={`${cat.label}: сумма`} htmlFor={cat.amountField}>
              <MoneyInput
                id={cat.amountField}
                value={data[cat.amountField]}
                onChange={(v) => set(cat.amountField, v)}
                readOnly={editable ? false : undefined}
              />
            </FormField>
            <FormField
              label={`${cat.label}: за что конкретно`}
              htmlFor={cat.commentField}
              required={editable}
              full
            >
              <TextArea
                id={cat.commentField}
                value={data[cat.commentField]}
                onChange={(v) => set(cat.commentField, v)}
                readOnly={editable ? false : undefined}
              />
            </FormField>
          </React.Fragment>
        );
      })}
    {/* Есть только у листов, созданных автоматически по согласованному заявлению
        на увольнение (см. forms/Dismissal/createClearance.ts). */}
    <LinkField
      label="Заявление на увольнение"
      url={data.DismissalUrl}
      text="Открыть заявление, по которому создан этот лист"
    />
  </CollapseSection>
 );
@@ -1,7 +1,40 @@
 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, WriteOffFieldKey } from './model';
 /** Одна из 12 колонок сумм/комментариев к списанию — см. model.ts WRITE_OFF_CATEGORIES. */
 export type IWriteOffFields = Pick<IFormData, WriteOffFieldKey>;
 /**
 * Записать сумму(ы)/комментарий(и) к списанию. Пишет РОВНО переданные поля —
 * как updateApproverFields, каждая пара независима.
 *
 * ВАЖНО: вызывающая сторона (ClearanceView) обязана передавать сюда ТОЛЬКО те
 * пары, что ещё не заблокированы (см. IFormData.WriteOff* — блокировка по
 * непустой сумме) и заполнены целиком (сумма+комментарий вместе, см.
 * validateWriteOffPairs) — эта функция сама повторно ничего не проверяет и
 * молча перезапишет то, что ей передали.
 */
 export async function updateWriteOffFields(
  id: number,
  fields: Partial<IWriteOffFields>,
  listId?: string
 ): Promise<void> {
  const item: Record<string, unknown> = {};
  for (const key of Object.keys(fields) as Array<keyof IWriteOffFields>) {
    const raw = fields[key];
    if (raw === undefined) continue;
    if (key.endsWith('Amount')) {
      const amount = Number(raw);
      item[key] = Number.isFinite(amount) && raw.trim() !== '' ? amount : null;
    } else {
      item[key] = raw || null;
    }
  }
  if (Object.keys(item).length === 0) return;
  await resolveDataList(FORM_ID, listId).items.getById(id).update(item);
 }
 /**
 * Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
@@ -0,0 +1,20 @@
@import '../../../../styles/design-tokens';
 .back {
  display: inline-flex;
  align-items: center;
  gap: $sp-2;
  margin-bottom: $sp-4;
  padding: 0;
  border: 0;
  background: transparent;
  color: $navy-700;
  font-family: $font-sans;
  font-size: $fs-sm;
  cursor: pointer;
  transition: color .18s;
  &:hover {
    color: $gold-600;
  }
 }
@@ -0,0 +1,336 @@
 import * as React from 'react';
 import { useState, useMemo, useCallback, useEffect } from 'react';
 import styles from './DismissalForm.module.scss';
 import {
  Alert,
  FormCard,
  InitiatorLine,
  FormModeProvider,
  Icon,
  RequestNumber,
  SubmitActions,
  useRequestSubmit
 } from '../../shared/ui';
 import {
  ApprovalMatrix,
  StatusBadge,
  useMatrixEditor,
  getPlannedMatrix,
  notifyActiveStep,
  useRequestTypeId,
  REQUEST_STATUS,
  isEditableStatus,
  IApproverToWrite,
  unassignedStepMessage,
  resolveWriteListId
 } from '../../shared/approval';
 import { IRequestFormProps } from '../../models/types';
 import { getEmployeeOrganizations, getCompanyDirectorEmail, IEmployeeOrganization } from '../../shared/dictionary';
 import { friendlyErrorMessage } from '../../shared/diagnostics';
 import { isoDatePlusMonths, formatIsoDate } from '../../shared/dateUtils';
 import {
  approvalListTitle,
  approvalListTitleForListId,
  dataListTitle,
  dataListTitleForListId
 } from '../../shared/listTitles';
 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';
 const DismissalForm: React.FC<IRequestFormProps> = ({
  requestType,
  context,
  onCancel,
  onSaved,
  editId,
  editListId
 }) => {
  const [data, setData] = useState<IFormData>(EMPTY_DATA);
  const [requestId, setRequestId] = useState<number | undefined>(editId);
  const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
  const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
  const submit = useRequestSubmit();
  const readOnly = !isEditableStatus(requestStatus);
  const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
  // editListId уже проверен в EditFeature (см. её комментарий) — если бы партиции
  // не нашлось в реестре, форма сюда вообще не смонтировалась бы, поэтому здесь
  // dismissalApprovalService можно звать не опасаясь исключения.
  const approval = useMemo(() => dismissalApprovalService(editListId), [editListId]);
  // pageUrl формы (requestType.id совпадает с ним по конвенции портала, см.
  // data/requests.ts) → числовой RequestTypeId, нужный approval-route API.
  const requestTypeIdState = useRequestTypeId(context, requestType.id);
  const requestTypeId = requestTypeIdState.id;
  // Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое и статус.
  useEffect(() => {
    if (!editId) {
      return;
    }
    let alive = true;
    // Таблица организаций читается ЦЕЛИКОМ из самой заявки (loaded.data.Organization
    // — уже собранная зипом трёх столбцов, см. load.ts) — повторный поход в
    // Employee/ByEmail здесь не нужен: если при подаче убрали компанию, это уже
    // зафиксировано в сохранённых данных, а не в живом состоянии справочника.
    loadDismissalRequest(editId, editListId)
      .then((loaded) => {
        if (alive) {
          setData(loaded.data);
          setRequestStatus(loaded.status);
          setRequestCode(loaded.code || undefined);
        }
      })
      .catch((e) => {
        if (alive) {
          submit.setError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
        }
      });
    return () => {
      alive = false;
    };
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [editId, editListId]);
  /** Employee/ByEmail → таблица организаций (см. 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;
    }
    let alive = true;
    const user = context.pageContext.user;
    setData((prev) => ({ ...prev, Employee: prev.Employee || user.email }));
    getEmployeeOrganizations(context, user.email)
      .then((records) => {
        if (!alive) return;
        setData((prev) => ({
          ...prev,
          Organization: prev.Organization.length > 0 ? prev.Organization : toOrganization(records)
        }));
      })
      .catch(() => undefined);
    return () => {
      alive = false;
    };
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [editId]);
  // Выбор другого сотрудника подтягивает его таблицу организаций.
  const handleEmployeeChange = (login: string): void => {
    setData((prev) => ({ ...prev, Employee: login, Organization: [] }));
    if (!login) {
      return;
    }
    getEmployeeOrganizations(context, login)
      .then((records) => setData((prev) => ({ ...prev, Organization: toOrganization(records) })))
      .catch(() => undefined);
  };
  // Планируемый маршрут резолвится по e-mail ВЫБРАННОГО сотрудника (не текущего
  // пользователя) — так работает подача за другого; условие «IsManager» на бэкенде
  // считается по полю Position ЭТОЙ заявки, поэтому передаём его в fieldValues.
  // У заявки на редактировании маршрут читается из уже записанных строк, чтобы не
  // затереть правки инициатора.
  const loadMatrix = useCallback(
    () =>
      editId
        ? approval.getMatrixForRequest(editId)
        : getPlannedMatrix(context, requestTypeId as number, data.Employee, approval, 'Approval', null, [
            { fieldName: 'Position', value: primaryPosition(data.Organization) }
          ]),
    [context, approval, editId, data.Employee, data.Organization, requestTypeId]
  );
  const matrix = useMatrixEditor(
    loadMatrix,
    `${data.Employee}-${editId ?? 'new'}-${primaryPosition(data.Organization)}`,
    !readOnly,
    !!editId || (!!data.Employee && !!requestTypeId),
    (login) => approval.getJobTitle(login)
  );
  // Убрать компанию из заявления (совместитель, реально не увольняется из
  // ВСЕХ) — см. OrganizationsTable. Снимает компанию из data.Organization И, по
  // возможности, соответствующего согласующего (директора/должностного
  // эквивалента этой компании, см. shared/dictionary/employeeLookup.service —
  // тот же справочник, каким резолвит approval-route HeadType.CompanyDirectors)
  // из уже загруженной матрицы — искать и удалять его там вручную не нужно.
  //
  // Матрица планируется ОДНИМ шагом на все компании сразу (все директора — одна
  // и та же строка маршрута с несколькими исполнителями), поэтому убрать можно
  // только из уже пришедшего результата — если матрица ещё грузится или
  // директор этой компании в ней не нашёлся (например, маршрут ещё не готов),
  // компания всё равно убирается из заявления, а несовпадение тихо игнорируем:
  // HR в этом случае уберёт лишнего согласующего вручную через саму матрицу.
  const handleRemoveOrganization = (company: string): void => {
    setData((prev) => ({ ...prev, Organization: prev.Organization.filter((r) => r.company !== company) }));
    getCompanyDirectorEmail(context, company)
      .then((email) => {
        if (!email) return;
        const idx = matrix.rows.findIndex((r) => r.email.toLowerCase() === email.toLowerCase());
        if (idx >= 0) matrix.remove(idx);
      })
      .catch(() => undefined);
  };
  // Последний рабочий день нужно назначать минимум за MIN_NOTICE_MONTHS месяц —
  // календарь (min у input type=date, см. RequestSection) не даёт выбрать более
  // раннюю дату, но проверяем и здесь на случай обхода UI.
  const minLastWorkingDay = isoDatePlusMonths(MIN_NOTICE_MONTHS);
  const isLastDayValid = !data.LastWorkingDay || data.LastWorkingDay >= minLastWorkingDay;
  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 || !position.trim() || !data.LastWorkingDay || !data.Phone.trim()) {
      return 'Заполните обязательные поля: сотрудник, должность, последний рабочий день, контактный телефон.';
    }
    if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
    if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
    return undefined;
  };
  const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
    rows.map((r) => ({
      email: r.email,
      position: r.position,
      allowReassign: r.allowReassign,
      order: r.order,
      // Транзитом из маршрута в строку списка: наследование бэкенд применил
      // при resolve, форма только переносит значения (см. IMatrixRow.slaHours).
      slaHours: r.slaHours,
      askOverdueReason: r.askOverdueReason
    }));
  const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
    // validate()/validateSubmit() уже гарантировали requestTypeId к моменту вызова
    // (см. useRequestSubmit.run — валидирует ДО save), но TS этого через границу
    // замыкания не видит — локальный const и явная проверка снимают обе проблемы.
    const rtId = requestTypeId;
    if (!rtId) {
      throw new Error('Тип заявки не определён — обновите страницу и повторите.');
    }
    // Новая заявка пишется в ТЕКУЩУЮ партицию — запрашиваем её у approval-route
    // API непосредственно перед записью (не кеш из onInit): именно этот вызов
    // проверяет порог элементов и запускает архивацию следующей партиции.
    const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
    const { id, code } = await saveDismissalRequest(
      requestId,
      rtId,
      data,
      toApprovers(matrix.rows),
      status,
      writeListId
    );
    setRequestId(id);
    setRequestStatus(status);
    if (code) {
      setRequestCode(code);
    }
    if (onSaved) {
      onSaved();
    }
    // Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
    // Имена списков — той же партиции, куда фактически записана заявка (writeListId),
    // не текущей: поток ищет строку маршрута именно в НЕЙ.
    if (status === REQUEST_STATUS.onApproval) {
      await notifyActiveStep(context, approval, id, {
        requestTypeId: rtId,
        dataListName: writeListId ? dataListTitleForListId(FORM_ID, writeListId) : dataListTitle(FORM_ID),
        approvalListName: writeListId ? approvalListTitleForListId(FORM_ID, writeListId) : approvalListTitle(FORM_ID)
      });
    }
  };
  // На отправку (в отличие от черновика) маршрут должен быть полностью
  // укомплектован — иначе шаг без назначенного человека молча пропадёт при записи.
  const validateSubmit = (): string | undefined => {
    const formError = validate();
    if (formError) return formError;
    if (matrix.error) {
      return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
    }
    const unassignedError = unassignedStepMessage(
      matrix.rows,
      (r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
    );
    if (unassignedError) return unassignedError;
    return undefined;
  };
  const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
  const handleSubmit = (): Promise<void> => submit.run('submit', save(REQUEST_STATUS.onApproval), validateSubmit);
  const sectionProps = {
    data,
    set,
    context,
    onEmployeeChange: handleEmployeeChange,
    onRemoveOrganization: handleRemoveOrganization
  };
  return (
    <div>
      <button type="button" className={styles.back} onClick={onCancel}>
        <Icon name="arrow-left" size="sm" />
        <span>К списку заявок</span>
      </button>
      <FormCard
        title={requestType.title}
        subtitle="Категория: Отдел кадров"
        belowSubtitle={
          <InitiatorLine
            listTitle={editListId ? dataListTitleForListId(FORM_ID, editListId) : dataListTitle(FORM_ID)}
            itemId={requestId}
          />
        }
        headerRight={
          requestId || requestStatus ? (
            <>
              {requestStatus && <StatusBadge status={requestStatus} />}
              {requestCode && <RequestNumber code={requestCode} />}
            </>
          ) : undefined
        }
      >
        {submit.savedKind && !submit.error && (
          <Alert variant="ok">
            {submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
          </Alert>
        )}
        {submit.error && <Alert variant="err">{submit.error}</Alert>}
        <FormModeProvider readOnly={readOnly}>
          <RequestSection {...sectionProps} />
        </FormModeProvider>
        <ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
        <SubmitActions
          submit={submit}
          isValid={isValid}
          readOnly={readOnly}
          onCancel={onCancel}
          onSaveDraft={handleSaveDraft}
          onSubmit={handleSubmit}
          submitLabel="Отправить на согласование"
        />
      </FormCard>
    </div>
  );
 };
 export default DismissalForm;
@@ -0,0 +1,21 @@
@import '../../../../styles/design-tokens';
 .state {
  padding: $sp-8;
  color: $gray-500;
  font-size: $fs-sm;
  text-align: center;
 }
 .toolbar {
  display: flex;
  justify-content: flex-end;
  margin-bottom: $sp-4;
 }
 .printBlocked {
  font-family: $font-sans;
  font-size: $fs-sm;
  color: $gray-500;
  cursor: help;
 }
@@ -0,0 +1,309 @@
 import * as React from 'react';
 import { useState, useEffect, useMemo, useCallback } from 'react';
 import type { WebPartContext } from '@microsoft/sp-webpart-base';
 import styles from './DismissalView.module.scss';
 import { Alert, FormCard, InitiatorLine, FormModeProvider, PrintButton } from '../../shared/ui';
 import {
  ApproverService,
  DecisionPanel,
  StatusBadge,
  ApprovalMatrix,
  useMatrixEditor,
  notifyActiveStep,
  useRequestTypeId,
  REQUEST_STATUS
 } from '../../shared/approval';
 import { friendlyErrorMessage } from '../../shared/diagnostics';
 import { getManagerEmail } from '../../shared/dictionary';
 import { effectiveUserEmail } from '../../shared/impersonation';
 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, 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;
  /** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
  formKey: string;
  /** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
  listId?: string;
 }
 // Заявление на увольнение только для просмотра (режим согласующего).
 // Переиспользует ту же секцию, что и форма подачи; редактирование выключено через
 // <FormModeProvider readOnly> — поля сами становятся неизменяемыми.
 const DismissalView: React.FC<IDismissalViewProps> = ({ context, itemId, formKey, listId }) => {
  const [data, setData] = useState<IFormData>(EMPTY_DATA);
  const [status, setStatus] = useState<string>('');
  const [code, setCode] = useState<string>('');
  const [loading, setLoading] = useState<boolean>(true);
  const [error, setError] = useState<string | null>(null);
  // Итог автосоздания обходного листа после согласования (см. onDecided ниже).
  const [clearance, setClearance] = useState<string>('');
  const [clearanceError, setClearanceError] = useState<string>('');
  // Печать разрешена только с этого момента — см. эффект ниже (printGate).
  const [printGate, setPrintGate] = useState<'checking' | 'blocked' | 'allowed'>('checking');
  const [assetsAcceptorEditable, setAssetsAcceptorEditable] = useState<boolean>(false);
  // listId уже проверен в ApproveFeature (не смонтировались бы сюда иначе) —
  // dismissalApprovalService можно звать не опасаясь исключения.
  const approval = useMemo(() => dismissalApprovalService(listId), [listId]);
  const { id: requestTypeId } = useRequestTypeId(context, formKey);
  // Ref списка данных для ApproverService.updateRequestStatus: listId (url) для
  // архивной партиции, Title текущей — иначе (см. ApproverService.dataListRef).
  const dataListRef = listId || dataListTitle(FORM_ID);
  const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
  // Матрица маршрута из фактических строк заявки (read-only). decisionSeq в
  // reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
  const [decisionSeq, setDecisionSeq] = useState<number>(0);
  const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId), [approval, itemId]);
  const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
    approval.getJobTitle(l)
  );
  useEffect(() => {
    let alive = true;
    setLoading(true);
    loadDismissalRequest(itemId, listId)
      .then((loaded) => {
        if (alive) {
          setData(loaded.data);
          setStatus(loaded.status);
          setCode(loaded.code);
          setError(null);
          setLoading(false);
        }
      })
      .catch((e) => {
        if (alive) {
          setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
          setLoading(false);
        }
      });
    return () => {
      alive = false;
    };
  }, [itemId, listId]);
  // Печать заявления запрещена до согласования ПАРНОГО обходного листа: сначала
  // должны отработать/подтвердиться все связанные с увольнением отметки (карты,
  // суммы к списанию) — печатать заявление раньше значит выдать документ, когда
  // процесс увольнения ещё не подтверждён целиком. Пока обходной лист не создан
  // (заявление ещё не согласовано, либо автосоздание не удалось) печать тоже
  // заблокирована — печатать нечего.
  //
  // Статус читаем НАПРЯМУЮ из 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 формы).
  //
  // Сравниваем с effectiveUserEmail, а не с context.pageContext.user.email
  // напрямую: getPendingRowForCurrentUser (через ApprovalListService.
  // getCurrentUserId) уже учитывает отладочную подмену личности (см.
  // shared/impersonation.ts) — без того же самого здесь «активный шаг есть»
  // (active=true под подменённым) и «это я» (isManager=false, сравнили с
  // РЕАЛЬНЫМ логином) расходились бы, и поле оставалось бы заблокированным
  // даже когда подмена указывает именно на этого руководителя.
  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() === effectiveUserEmail(context).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>;
  }
  if (error) {
    return (
      <div className={styles.state}>
        <Alert variant="err">{error}</Alert>
      </div>
    );
  }
  // Реальный (не заглушка) сеттер: единственное поле, которое можно менять в
  // этом режиме, — «Лицо, принимающее ОС/НМА», и то только пока
  // 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 ещё не резолвился — решение уже применилось (строка списка
    // обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
    // весь UI ради необязательного оповещения.
    if (!requestTypeId) return;
    notifyActiveStep(context, approval, itemId, {
      requestTypeId,
      dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
      approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
    }).catch(() => undefined);
  };
  // Заявление согласовано целиком → сразу заводим обходной лист по нему (данные
  // выводятся из заявления, заполнять его руками нечего — см. createClearance.ts).
  // Свой статус решения при этом уже применён: неудача автосоздания не отменяет
  // согласование, поэтому она показывается предупреждением, а не ошибкой заявки.
  const createClearance = (): Promise<void> => {
    setClearanceError('');
    setClearance('Создаём обходной лист по этому заявлению…');
    return ensureClearanceForDismissal(context, itemId, listId)
      .then((result) => {
        setClearance(
          result.existing
            ? 'Обходной лист по этому заявлению уже был создан.'
            : `Обходной лист создан автоматически${result.code ? ` — №${result.code}` : ''} и отправлен на согласование.`
        );
        // Поле-ссылка в секции заполняется из данных заявки, а они прочитаны ДО
        // создания листа — дописываем адрес в модель, иначе ссылка появилась бы
        // только после перезагрузки страницы.
        setData((prev) => ({ ...prev, ClearanceUrl: result.url }));
      })
      .catch((e) => {
        setClearance('');
        setClearanceError(
          `Заявление согласовано, но обходной лист создать не удалось: ${friendlyErrorMessage(e)} — заведите его вручную.`
        );
      });
  };
  return (
    <div>
      <div className={`${styles.toolbar} rp-no-print`}>
        {printGate === 'allowed' ? (
          <PrintButton />
        ) : (
          <span className={styles.printBlocked} title="Печать откроется после согласования обходного листа по этому увольнению">
            Печать станет доступна после согласования обходного листа
          </span>
        )}
      </div>
      <div className="rp-print-root">
        <FormCard
          title="Заявление на увольнение"
          subtitle={`№${code || itemId}`}
          belowSubtitle={
            <InitiatorLine
              listTitle={listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID)}
              itemId={itemId}
            />
          }
          headerRight={status ? <StatusBadge status={status} /> : undefined}
        >
          <FormModeProvider readOnly>
            <RequestSection {...sectionProps} />
          </FormModeProvider>
        </FormCard>
        <ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
      </div>
      {/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый).
          Итог автосоздания обходного листа — тут же, а не в шапке: он появляется
          именно как следствие решения «Согласовать», логичнее видеть его рядом. */}
      <div className="rp-no-print">
        {clearance && <Alert variant="ok">{clearance}</Alert>}
        {clearanceError && <Alert variant="err">{clearanceError}</Alert>}
        <DecisionPanel
          service={approverService}
          requestId={itemId}
          search={(q) => approval.searchUsers(q)}
          onBeforeDecide={assetsAcceptorEditable ? saveAssetsAcceptor : undefined}
          onDecided={(newStatus) => {
            setStatus(newStatus);
            setDecisionSeq((n) => n + 1);
            notify();
            // «Согласовано» = маршрут заявления пройден целиком (фазы исполнения у
            // него нет, см. README формы) — значит увольнение подтверждено и пора
            // заводить обходной лист. Промис ВОЗВРАЩАЕМ: пока он не разрешится,
            // панель решения не пишет «Решение сохранено» (см. её onDecided) —
            // иначе успех появлялся бы раньше, чем обходной лист создан.
            return newStatus === REQUEST_STATUS.approved ? createClearance() : undefined;
          }}
          onDelegated={() => {
            setDecisionSeq((n) => n + 1);
            notify();
          }}
        />
      </div>
    </div>
  );
 };
 export default DismissalView;
@@ -0,0 +1,183 @@
 # Заявление на увольнение (hr-dismissal)
 **Назначение:** заявление работника о расторжении трудового договора по собственному
 желанию (штатный сотрудник). Бумажный первоисточник — «Шаблон Заявление на увольнение ШТАТ.docx».
 **Категория:** Отдел кадров
 **Списки SP:** «Заявление на увольнение 1 — данные» / «Заявление на увольнение 1 — согласование»
 **RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
 `pageUrl` («hr-dismissal») через `useRequestTypeId` (см. «Формы больше не хардкодят
 RequestTypeId» в `docs/forms.md`). Тип заведён в админке approval-route (id 16,
 список данных `/sites/requests/Lists/18`).
 ## Маршрут
 - Фазы: только согласование. Фазы исполнения нет — после согласования заявка
  получает статус «Согласовано» (как «Обходной лист» / «Отпуск без содержания»).
 - **Матрица редактируема заявителем** при новой заявке / черновике / возврате:
  `useMatrixEditor(editable = !readOnly)`.
 - Условие `IsManager` в маршруте (если настроено в админке) резолвится по полю
  **Position ЭТОЙ заявки**, поэтому `Position` передаётся в `fieldValues` при
  планировании (`getPlannedMatrix(..., [{ fieldName: 'Position', ... }])`) — как в
  «Обходном листе».
 - Настроенный шаблон маршрута (approval-route, route id 17): шаг 1 —
  `HeadType.Chief` (непосредственный руководитель увольняемого, тот же
  `Employee/Manager?managerType=chief`, что резолвит «Лицо, принимающее ОС/НМА»,
  см. ниже), шаг 2 — `HeadType.CompanyDirectors` (см. следующий раздел).
 ## Особое поведение
 - **По умолчанию заявка на себя**, но подать можно и за другого: «Сотрудник» —
  People-picker (`Employee`), маршрут резолвится по e-mail **выбранного** сотрудника,
  reloadKey матрицы включает `data.Employee` и должность основной компании (см. ниже).
 - **Автоподстановка при выборе сотрудника:** вся таблица организаций — из ОДНОГО
  справочника `Employee/ByEmail` (`shared/dictionary`) — см. ниже.
 - **Таблица организаций** (`OrganizationsTable`, `forms/Dismissal/sections/`, без
  подписи над собой — у неё уже есть заголовки колонок «Компания» / «Структурное
  подразделение» / «Должность») — ЕДИНСТВЕННОЕ место для компании, подразделения и
  должности, и на форме подачи (редактируемая), и в режиме просмотра (read-only) —
  отдельных полей для них нет (были бы дублированием). `data.Organization:
  IOrganizationRecord[]` — массив `{company, department, position}`; поле называется
  `department` (тот же справочник `Section`, что и раньше — см. следующий абзац),
  колонка называется «Структурное подразделение», и то и другое read-only. Должность
  редактируема В ЛЮБОЙ строке (справочник не всегда точен), но маршрут (условие
  «IsManager») и обязательность по валидации завязаны ТОЛЬКО на должность ПЕРВОЙ
  (основной) записи — `primaryPosition(data.Organization)`; должности остальных
  компаний правятся, но ни на что не влияют. Справочник ничего не вернул (сотрудник
  не найден в api.tnsu.kz) — таблица всё равно рендерится одной строкой с прочерками
  вместо компании/подразделения и редактируемой должностью: иначе такому человеку
  нечем было бы заполнить обязательное поле.
  **Хранение в SharePoint — три ПАРАЛЛЕЛЬНЫХ JSON-столбца**, не один общий блок:
  `Organization`/`Department`/`Position` — каждый содержит JSON-массив строк
  (компании / департаменты / должности), один и тот же индекс = одна и та же
  запись во всех трёх. Сборка при чтении и разборка при записи — `zipOrganization`
  / `organizationColumn` в `model.ts`/`submit.ts`; не-JSON значение (заявка,
  сохранённая до перехода на этот формат) не роняет чтение — трактуется как одна
  компания (см. `parseOrganizationColumn`).
 - **Самостоятельное подразделение** (`StandaloneUnit`) — в справочнике его нет,
  свободный ввод, единственное текстовое поле, оставшееся отдельно от таблицы.
 - **Последний рабочий день** (`LastWorkingDay`) — обязателен, не раньше чем через
  `MIN_NOTICE_MONTHS` (1) календарный месяц от сегодня (`isoDatePlusMonths`,
  `min` у `input type=date` + проверка в `validate` на случай обхода UI) — срок
  предупреждения об увольнении по ТК. Более позднюю дату (по договорённости с
  работодателем) форма не ограничивает.
 - **Контактный телефон** (`Phone`) — обязателен, `PhoneInput` (маска).
 - **Комментарий** (`Comment`) — необязательный свободный текст. Причины увольнения
  отдельного поля нет: в шаблоне формулировка фиксированная («по собственному желанию»).
 - **Заголовок элемента** (`Title`): `Заявление на увольнение — {ФИО} — дд.мм.гггг`.
 ## Совместители: организации таблицей, удаление синхронизировано с маршрутом
 Сотрудник может числиться сразу в НЕСКОЛЬКИХ компаниях (совместительство).
 Approval-route резолвит маршрут через `HeadType.CompanyDirectors` — ОДИН шаг
 разворачивается в по одному согласующему НА КАЖДУЮ компанию сотрудника (директор,
 а где нет такой штатной единицы — должностной эквивалент: `Главный механик` для
 «ТОО KazPromService», `Генеральный директор» для «ТОО СТ Global», иначе
 `Директор`, см. `DirectorPositionByCompany` в approval-route
 `TemplateRouteService`). Это уже работает БЕЗ участия портала — сам approval-route
 резолвит все компании сотрудника через `Employee/ByEmail`.
 `OrganizationsTable` (см. предыдущий раздел) на форме подачи показывает кнопку
 «убрать» у каждой строки, когда компаний больше одной. Если сотрудник реально не
 увольняется из ВСЕХ компаний сразу, HR убирает лишние: `DismissalForm.handleRemoveOrganization`
 1. снимает запись из `data.Organization` (массив всегда отражает ТЕКУЩИЙ, не
   первоначальный, набор — так же восстанавливается при повторном открытии
   черновика/возврата: `loadDismissalRequest` читает его из уже сохранённых
   `Organization`/`Department`/`Position`, без обращения к справочнику заново);
 2. независимо резолвит директора/эквивалента этой компании через
   `getCompanyDirectorEmail` (`shared/dictionary/employeeLookup.service.ts` —
   зеркало того же `DirectorPositionByCompany`, что и на бэкенде) и удаляет
   строку с этим email из уже загруженной ПЛАНИРУЕМОЙ матрицы (`matrix.remove`).
 Убирать согласующего из матрицы вручную (кнопкой самой матрицы) при этом не нужно
 — это best-effort синхронизация: если матрица ещё не загрузилась или директор не
 нашёлся, компания всё равно снимается из заявления, а несовпадение в матрице HR
 поправит вручную через саму матрицу (она и так редактируема).
 ## Согласовано → обходной лист создаётся сам
 Как только заявление получает статус **«Согласовано»** (маршрут пройден целиком),
 портал заводит по нему **обходной лист** — `ensureClearanceForDismissal`
 (`createClearance.ts`), вызывается из `DismissalView` в `onDecided` последнего
 согласующего.
 Форма обходного листа при этом **не открывается**: маршрут резолвится через
 approval-route (`getPlannedMatrix` для фаз «Согласование» и «Исполнение» — по
 `Employee` и `Position` заявления), элемент пишется в текущую партицию списка
 «Обходной лист … — данные» и сразу уходит на согласование
 (`initialSubmitStatus` + `notifyActiveStep`, как при обычной подаче). Поля целиком
 выводятся из заявления: сотрудник, должность, подразделение, организация, а
 последний рабочий день становится **датой расторжения договора**; отметки
 (парковка, СКУД, обучение) остаются пустыми — их заполняют профильные согласующие.
 Пара связывается **перекрёстными колонками-гиперссылками** (тип `Url`):
 `ClearanceUrl` в заявлении → на обходной лист, `DismissalUrl` в обходном листе → на
 заявление. Не Lookup намеренно: ссылка ведёт на страницу портала
 (`…?rpmode=approve&rptype=…&rpid=…&rplist=…`, см. `docs/routing.md`), а не на элемент
 списка, и не ломается, когда парная заявка уезжает в другую партицию.
 Ссылки **видны на обеих формах** и кликабельны: поле «Обходной лист» в заявлении и
 «Заявление на увольнение» в обходном листе (`LinkField`, `shared/ui`) — read-only,
 открывают парную заявку в ТОЙ ЖЕ вкладке и появляются только когда связь есть.
 Переход идёт без перезагрузки страницы: ссылка ведёт на ту же страницу портала с
 другими rp-параметрами, поэтому клик перехватывается и уходит в `navigate()`
 (`navigateToRequestLink` в `shared/routing.ts`) — а Ctrl/⌘+клик по-прежнему открывает
 заявку в отдельной вкладке, потому что href настоящий. У согласующего, только что
 одобрившего заявление, ссылка появляется сразу, без перезагрузки.
 Что важно знать про это поведение:
 - **Идемпотентность — по непустой `ClearanceUrl`.** Заявление можно согласовать
  повторно (возврат на доработку → отправка → согласование), и без этой проверки
  на каждый цикл появлялся бы новый обходной лист.
 - **Работает в браузере последнего согласующего.** Если создание упало (или он
  закрыл вкладку в этот момент), заявление всё равно согласовано, а обходного листа
  нет — портал покажет предупреждение «заведите вручную». Серверного повтора нет:
  фонового обработчика у портала пока не существует, всё делает клиент.
 - **Автором обходного листа** в SharePoint станет этот согласующий (в «Мои заявки»
  лист попадёт к нему). На маршрут это не влияет — он резолвится по `Employee`.
 - Тип заявки `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 **после** решения об увольнении (обход подразделений,
 карты, обучение). Это заявление — **вход** в процесс: его подаёт сам работник,
 полей всего восемь, отметок подразделений нет.
 ## Секции формы
 RequestSection (сотрудник · организация/департамент/должность (таблица —
 редактируемая на форме подачи, read-only в просмотре) · самостоятельное
 подразделение · последний рабочий день · телефон · комментарий · ссылка на
 обходной лист · лицо, принимающее ОС/НМА)
 ## Точки входа
 - rptype: `hr-dismissal`
 - Режим согласующего (просмотр): есть (`DismissalView`)
 - «Создать на основе»: нет
@@ -0,0 +1,16 @@
 {
  "dataListTitle": "Заявление на увольнение — согласование",
  "columns": [
    { "internalName": "TansuSiteApprover", "title": "Согласующий", "type": "User", "userSelectionMode": "PeopleOnly" },
    { "internalName": "ApprovalStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "Ждёт очереди", "На согласовании", "На исполнении", "Согласовано", "Выполнено", "Отклонено", "Возвращена на доработку"] },
    { "internalName": "Ticket", "title": "Заявка", "type": "Lookup", "lookupList": "Заявление на увольнение — данные", "lookupShowField": "Title" },
    { "internalName": "Date", "title": "Дата", "type": "DateTime" },
    { "internalName": "Comment", "title": "Комментарий", "type": "Note" },
    { "internalName": "StepOrder", "title": "Порядок", "type": "Number" },
    { "internalName": "AllowReassignToOtherApprovers", "title": "Можно перепоручать", "type": "Boolean" },
    { "internalName": "Phase", "title": "Фаза", "type": "Choice", "choices": ["Согласование", "Исполнение"] },
    { "internalName": "SLAhours", "title": "SLA, часов", "type": "Number" },
    { "internalName": "AskOverdueReason", "title": "Опрос причины просрочки", "type": "Boolean" },
    { "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
  ]
 }
@@ -0,0 +1,176 @@
 import { WebPartContext } from '@microsoft/sp-webpart-base';
 import {
  IApproverToWrite,
  IMatrixRow,
  getPlannedMatrix,
  getRequestTypeIdByPageUrl,
  initialSubmitStatus,
  notifyActiveStep,
  resolveWriteListId
 } from '../../shared/approval';
 import { resolveDataList } from '../../shared/dataList';
 import {
  approvalListTitle,
  approvalListTitleForListId,
  dataListTitle,
  dataListTitleForListId
 } from '../../shared/listTitles';
 import { requestLinkUrl } from '../../shared/routing';
 import { FORM_ID as CLEARANCE_FORM_ID, EMPTY_DATA as CLEARANCE_EMPTY, IFormData as IClearanceData } from '../Clearance/model';
 import { clearanceApprovalService, saveClearanceRequest } from '../Clearance/submit';
 import { FORM_ID, primaryPosition, zipOrganization } from './model';
 /** Результат автосоздания обходного листа по согласованному заявлению. */
 export interface IClearanceForDismissal {
  /** Id обходного листа. undefined — лист уже был создан раньше (ссылка есть, Id из неё не выводим). */
  id?: number;
  /** Уникальный код заявки, если обходной лист создан именно сейчас. */
  code?: string;
  /** Ссылка на обходной лист (та же, что записана в колонку ClearanceUrl). */
  url: string;
  /** true — ничего не создавали, обходной лист по этому заявлению уже был. */
  existing: boolean;
 }
 /** Гиперссылка в SharePoint — объект {Url, Description}, а не строка. */
 interface ISpUrlValue {
  Url?: string;
  Description?: string;
 }
 /** Матрица планируемого маршрута → строки для записи в список согласования. */
 function toApprovers(rows: IMatrixRow[]): IApproverToWrite[] {
  return rows.map((r) => ({
    email: r.email,
    position: r.position,
    allowReassign: r.allowReassign,
    order: r.order,
    slaHours: r.slaHours,
    askOverdueReason: r.askOverdueReason
  }));
 }
 /**
 * Создать обходной лист по СОГЛАСОВАННОМУ заявлению на увольнение и связать их
 * перекрёстными ссылками (ClearanceUrl / DismissalUrl).
 *
 * Зачем: увольнение — это всегда пара «заявление + обходной лист», и раньше HR
 * заводил второй руками, переписывая те же сотрудника, должность, подразделение и
 * дату. Данные для обходного листа целиком выводятся из заявления, поэтому после
 * его согласования заводить лист вручную незачем.
 *
 * **Идемпотентность** — по колонке ClearanceUrl самого заявления: она заполняется
 * последним шагом, и непустая означает «лист уже есть». Это важнее, чем кажется:
 * заявление может быть согласовано повторно (вернули на доработку → отправили
 * снова → снова одобрили), и без этой проверки на каждый цикл появлялся бы новый
 * обходной лист. Проверка не абсолютна (два одновременных решения по одной заявке
 * прошли бы оба), но параллельных решений по одному последнему шагу не бывает:
 * шаг назначен на одного человека.
 *
 * **Кто автор.** Вызов идёт из браузера последнего согласующего, поэтому в
 * SharePoint автором обходного листа окажется он, а не увольняемый или HR. На
 * маршрут это не влияет (он резолвится по полю Employee, см. ниже), но в «Мои
 * заявки» этого согласующего лист попадёт.
 *
 * Ошибки НЕ глушим: вызывающая сторона (DismissalView) показывает их отдельным
 * предупреждением — согласование при этом уже применено, и молчаливая потеря
 * обходного листа хуже, чем сообщение «создайте вручную».
 */
 export async function ensureClearanceForDismissal(
  context: WebPartContext,
  dismissalId: number,
  dismissalListId?: string
 ): Promise<IClearanceForDismissal> {
  const dismissalList = resolveDataList(FORM_ID, dismissalListId);
  const item = (await dismissalList.items
    .getById(dismissalId)
    .select(
      'Id',
      'Position',
      'Department',
      'LastWorkingDay',
      'Organization',
      'ClearanceUrl',
      'Employee/EMail'
    )
    .expand('Employee')()) as Record<string, unknown>;
  const existingLink = (item.ClearanceUrl as ISpUrlValue | undefined)?.Url;
  if (existingLink) {
    return { url: existingLink, existing: true };
  }
  const employeeEmail = (item.Employee as { EMail?: string } | undefined)?.EMail || '';
  if (!employeeEmail) {
    throw new Error('В заявлении не заполнен сотрудник — обходной лист не создан.');
  }
  // Три параллельных 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): партицию спрашиваем прямо сейчас, именно этот вызов
  // проверяет порог элементов и запускает архивацию.
  const requestTypeId = await getRequestTypeIdByPageUrl(context, CLEARANCE_FORM_ID);
  const writeListId = await resolveWriteListId(context, CLEARANCE_FORM_ID, requestTypeId, undefined, undefined);
  const approval = clearanceApprovalService(writeListId);
  // Маршрут обходного листа резолвится по УВОЛЬНЯЕМОМУ (Employee заявления) и его
  // должности — условие «IsManager» на бэкенде считается по ней (см. README формы
  // «Обходной лист»). Обе фазы: согласование и исполнение.
  const fieldValues = [{ fieldName: 'Position', value: position }];
  const approvers = await getPlannedMatrix(context, requestTypeId, employeeEmail, approval, 'Approval', null, fieldValues);
  const executors = await getPlannedMatrix(context, requestTypeId, employeeEmail, approval, 'Execution', null, fieldValues);
  const data: IClearanceData = {
    ...CLEARANCE_EMPTY,
    Employee: employeeEmail,
    Position: position,
    Department: department,
    // Последний рабочий день заявления = дата расторжения договора в обходном листе.
    TerminationDate: ((item.LastWorkingDay as string) || '').slice(0, 10),
    Organization: organizationText
  };
  // Статус — как при обычной отправке: с согласующими «На согласовании», без них
  // маршрут сразу уходит в исполнение/согласовано (см. initialSubmitStatus).
  const status = initialSubmitStatus(approvers.length, executors.length);
  const { id, code } = await saveClearanceRequest(
    undefined,
    requestTypeId,
    data,
    toApprovers(approvers),
    toApprovers(executors),
    status,
    writeListId
  );
  // Перекрёстные ссылки: в заявлении — на лист, в листе — на заявление.
  const clearanceUrl = requestLinkUrl(CLEARANCE_FORM_ID, id, writeListId);
  const dismissalUrl = requestLinkUrl(FORM_ID, dismissalId, dismissalListId);
  await dismissalList.items.getById(dismissalId).update({
    ClearanceUrl: { Url: clearanceUrl, Description: `Обходной лист${code ? ` №${code}` : ''}` }
  });
  await resolveDataList(CLEARANCE_FORM_ID, writeListId)
    .items.getById(id)
    .update({ DismissalUrl: { Url: dismissalUrl, Description: 'Заявление на увольнение' } });
  // Оповещение активного шага — как после обычной отправки. Некритично: сам
  // notifyActiveStep ошибки глотает, заявка уже создана и связана.
  await notifyActiveStep(context, approval, id, {
    requestTypeId,
    dataListName: writeListId ? dataListTitleForListId(CLEARANCE_FORM_ID, writeListId) : dataListTitle(CLEARANCE_FORM_ID),
    approvalListName: writeListId
      ? approvalListTitleForListId(CLEARANCE_FORM_ID, writeListId)
      : approvalListTitle(CLEARANCE_FORM_ID)
  });
  return { id, code, url: clearanceUrl, existing: false };
 }
@@ -0,0 +1,67 @@
 import { getSP } from '../../shared/pnp/pnpjs';
 import { dataListTitle } from '../../shared/listTitles';
 import { FORM_ID, IFormData, EMPTY_DATA, zipOrganization } from './model';
 export interface ILoadedRequest {
  data: IFormData;
  /** Ф.И.О. сотрудника из поля Employee (для заголовка режима чтения). */
  employeeName: string;
  status: string;
  /** Уникальный код заявки; '' — если запись создана до появления поля. */
  code: string;
 }
 /**
 * Прочитать заявление на увольнение по id: модель формы + статус (правка / просмотр).
 *
 * listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
 * listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
 * по url списка, а не по имени: так не нужно резолвить, как называется архивный
 * список, и запрос не зависит от реестра партиций.
 */
 export async function loadDismissalRequest(itemId: number, listId?: string): Promise<ILoadedRequest> {
  const list = listId ? getSP().web.getList(listId) : getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
  const item = (await list
    .items.getById(itemId)
    .select(
      'Id',
      'Position',
      'Department',
      'StandaloneUnit',
      'LastWorkingDay',
      'Phone',
      'Comment',
      'Organization',
      'ClearanceUrl',
      'RequestStatus',
      'RequestUniqueCode',
      'Employee/Title',
      'Employee/EMail',
      'AssetsAcceptor/EMail'
    )
    .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 = {
    ...EMPTY_DATA,
    Employee: employee?.EMail || '',
    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: zipOrganization(item.Organization, item.Department, item.Position),
    // Гиперссылка приходит объектом {Url, Description} — модели нужен только адрес.
    ClearanceUrl: (item.ClearanceUrl as { Url?: string } | undefined)?.Url || '',
    AssetsAcceptor: assetsAcceptor?.EMail || ''
  };
  return {
    data,
    employeeName: employee?.Title || '',
    status: (item.RequestStatus as string) || '',
    code: (item.RequestUniqueCode as string) || ''
  };
 }
@@ -0,0 +1,154 @@
 import { WebPartContext } from '@microsoft/sp-webpart-base';
 import { RequestTypeId } from '../../models/types';
 /**
 * Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
 * SharePoint выводятся из него, см. shared/listTitles.ts.
 */
 export const FORM_ID: RequestTypeId = 'hr-dismissal';
 /**
 * Одна строка таблицы организаций (см. 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»: расторжение трудового договора по
 * собственному желанию. Ключи по возможности = internalName колонок списка данных
 * (см. shared/listTitles.ts). Employee хранит e-mail сотрудника (то, что отдаёт
 * PeopleField); по нему резолвится маршрут согласования, поэтому заявку можно
 * подать и за другого сотрудника (например, кадровик за работника без доступа).
 *
 * Причина увольнения в шаблоне фиксированная («по собственному желанию») — своего
 * поля под неё нет, поэтому в модели её тоже нет; свободный текст — в Comment.
 */
 export interface IFormData {
  /** E-mail сотрудника, за которого заявка (People). Пусто = не выбран. */
  Employee: string;
  /** Самостоятельное подразделение — в справочнике его нет, вводится вручную. */
  StandaloneUnit: string;
  /** Последний рабочий день, ISO YYYY-MM-DD (input type=date). */
  LastWorkingDay: string;
  /** Контактный телефон (маска, см. PhoneInput). */
  Phone: string;
  /** Необязательный комментарий заявителя. */
  Comment: string;
  /**
   * Таблица компаний сотрудника (компания · департамент · должность на
   * каждую) — подтягивается автоматически из Employee/ByEmail при выборе
   * Employee. Первая запись — основная компания: её должность используется
   * маршрутом (см. primaryPosition) и остаётся редактируемой (см.
   * OrganizationsTable); должности/департаменты остальных — только для
   * просмотра. О ХРАНЕНИИ В СПИСКЕ (три параллельных JSON-массива по
   * столбцам) — см. IOrganizationRecord.
   */
  Organization: IOrganizationRecord[];
  /**
   * Ссылка на обходной лист, созданный по этому заявлению — колонка-гиперссылка
   * `ClearanceUrl`. Форма её не пишет (заполняет автосоздание, см.
   * createClearance.ts) и не даёт править — только показывает переходом.
   */
  ClearanceUrl: string;
  /**
   * Лицо, принимающее основные средства/нематериальные активы увольняемого —
   * People, колонка `AssetsAcceptor`. Заполняет НЕ заявитель, а непосредственный
   * руководитель увольняемого на своём шаге согласования (см. DismissalView) —
   * поэтому здесь нет отдельного плейсхолдера/секции формы подачи: поле в
   * IFormData только чтобы форма подачи не роняла это значение при пересохранении
   * (черновик/возврат), сама секция его не показывает и не редактирует.
   */
  AssetsAcceptor: string;
 }
 /** Обновление одного поля формы с сохранением типа значения. */
 export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
 /** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker). */
 export interface ISectionProps {
  data: IFormData;
  set: SetField;
  context: WebPartContext;
  /**
   * Выбор сотрудника подтягивает его должность, подразделение и организации —
   * поэтому у поля «Сотрудник» отдельный обработчик. Если не передан (режим
   * чтения) — правка через set.
   */
  onEmployeeChange?: (login: string) => void;
 }
 export const EMPTY_DATA: IFormData = {
  Employee: '',
  StandaloneUnit: '',
  LastWorkingDay: '',
  Phone: '',
  Comment: '',
  Organization: [],
  ClearanceUrl: '',
  AssetsAcceptor: ''
 };
 /** Плейсхолдер для поля выбора сотрудника. */
 export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
 /** Заявление нужно подавать не позднее чем за столько месяцев до последнего рабочего дня. */
 export const MIN_NOTICE_MONTHS = 1;
@@ -0,0 +1,20 @@
 {
  "dataListTitle": "Заявление на увольнение — данные",
  "columns": [
    { "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
    { "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
    { "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
    { "internalName": "Position", "title": "Должность", "type": "Text" },
    { "internalName": "Department", "title": "Департамент", "type": "Text" },
    { "internalName": "StandaloneUnit", "title": "Самостоятельное подразделение", "type": "Text" },
    { "internalName": "LastWorkingDay", "title": "Последний рабочий день", "type": "DateTime", "dateOnly": true },
    { "internalName": "Phone", "title": "Контактный телефон", "type": "Text" },
    { "internalName": "Comment", "title": "Комментарий", "type": "Note" },
    { "internalName": "Organization", "title": "Организация", "type": "Note" },
    { "internalName": "ClearanceUrl", "title": "Ссылка на обходной лист", "type": "Url" },
    { "internalName": "AssetsAcceptor", "title": "Лицо, принимающее ОС/НМА", "type": "User", "userSelectionMode": "PeopleOnly" }
  ]
 }
@@ -0,0 +1,85 @@
@import '../../../../../styles/design-tokens';
 // Занять обе колонки сетки формы — то же, что даёт проп full у FormField
 // (._full_1wk7n_8{grid-column:1/-1} в @tnsu/ui-kit), без самого FormField:
 // подпись над таблицей не нужна, у неё уже есть заголовки колонок.
 .wrapper {
  grid-column: 1 / -1;
  min-width: 0;
 }
 .table {
  width: 100%;
  border-collapse: collapse;
  font-family: $font-sans;
  font-size: 13.5px;
 }
 thead th {
  box-sizing: border-box;
  padding: 6px 13px;
  text-align: left;
  font-weight: 500;
  font-size: 12px;
  color: $gray-500;
 }
 .company,
 .department,
 .position {
  box-sizing: border-box;
  padding: 11px 13px;
  border: 1px solid $gray-200;
  border-right: 0;
  background: $gray-50;
  color: $gray-700;
 }
 .company {
  width: 35%;
 }
 .department {
  width: 30%;
 }
 // Ячейка должности ПЕРВОЙ строки хранит TextInput (у него свой паддинг/рамка) —
 // у самой ячейки паддинг убран, иначе поле ввода дублировало бы рамку карточки.
 .positionInput {
  box-sizing: border-box;
  border: 1px solid $gray-200;
  border-right: 0;
  padding: 0;
  input {
    width: 100%;
    box-sizing: border-box;
  }
 }
 .action {
  width: 1%;
  white-space: nowrap;
  border: 1px solid $gray-200;
  border-left: 0;
  background: $gray-50;
  text-align: center;
 }
 .remove {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 4px;
  border: 0;
  border-radius: $r-sm;
  background: transparent;
  color: $gray-500;
  cursor: pointer;
  transition: color .18s, background .18s;
  &:hover {
    color: $red-500;
    background: $red-50;
  }
 }
@@ -0,0 +1,101 @@
 import * as React from 'react';
 import { Icon, TextInput } from '../../../shared/ui';
 import { IOrganizationRecord } from '../model';
 import styles from './OrganizationsTable.module.scss';
 interface IOrganizationsTableProps {
  records: IOrganizationRecord[];
  /**
   * Должность любой строки можно поправить — справочник не всегда точен, а
   * условие маршрута «IsManager» резолвится по должности ПЕРВОЙ (основной)
   * компании (см. DismissalForm — primaryPosition/fieldValues.Position), так
   * что расхождение со справочником там, где оно есть, важно уметь исправить.
   * Не задано — вся таблица read-only (режим просмотра, DismissalView).
   */
  onChangePosition?: (index: number, value: string) => void;
  /**
   * Убрать компанию из заявления — есть только на форме подачи (см.
   * DismissalForm.handleRemoveOrganization), не в режиме просмотра: там состав
   * компаний уже зафиксирован в отправленной заявке и маршруте.
   */
  onRemove?: (company: string) => void;
 }
 /**
 * Организации сотрудника — ЕДИНСТВЕННОЕ место для компании/подразделения/
 * должности, и на форме подачи (редактируемая — см. onChangePosition/onRemove),
 * и в режиме просмотра заявки (read-only, те же данные из сохранённой заявки,
 * а не live-запрос к справочнику — см. DismissalView). Раньше это были
 * отдельные поля над таблицей — убраны как дублирование того, что таблица и
 * так показывает.
 *
 * Интерактивная таблица, а не список строк: у сотрудника, оформленного в
 * НЕСКОЛЬКИХ компаниях одновременно, увольнение затрагивает директора/
 * должностного эквивалента КАЖДОЙ из них (маршрут `HeadType.CompanyDirectors`
 * в approval-route резолвит их всех). Если реально уходит только из одной —
 * заявитель убирает лишние компании ЗДЕСЬ, и соответствующий согласующий
 * убирается из матрицы автоматически (см. DismissalForm.handleRemoveOrganization)
 * — не нужно отдельно искать его в матрице и удалять там вручную.
 *
 * Пустой records в РЕДАКТИРУЕМОМ режиме (справочник api.tnsu.kz не нашёл
 * сотрудника) — не «ничего не показываем», а ОДНА строка с прочерками и
 * редактируемой должностью: без этого заявление на человека без карточки в
 * справочнике нельзя было бы подать вовсе (некуда вписать должность вручную —
 * а маршрут согласования без неё не резолвит условие «IsManager»).
 *
 * Без обёртки FormField/подписи над таблицей намеренно — у нёе уже есть
 * заголовки колонок, дублировать их общей подписью незачем; full-ширина взята
 * напрямую (см. .wrapper), а не через FormField (там label обязателен).
 */
 export const OrganizationsTable: React.FC<IOrganizationsTableProps> = ({ records, onChangePosition, onRemove }) => {
  const rows = records.length > 0 ? records : [undefined];
  return (
    <div className={styles.wrapper}>
      <table className={styles.table}>
        <thead>
          <tr>
            <th className={styles.company}>Компания</th>
            <th className={styles.department}>Структурное подразделение</th>
            <th className={styles.position}>Должность</th>
            {onRemove && <th className={styles.action} />}
          </tr>
        </thead>
        <tbody>
          {rows.map((r, i) => (
            <tr key={r?.company || 'manual'}>
              <td className={styles.company}>{r?.company || '—'}</td>
              <td className={styles.department}>{r?.department || '—'}</td>
              {onChangePosition ? (
                <td className={styles.positionInput}>
                  <TextInput
                    value={r?.position || ''}
                    onChange={(v) => onChangePosition(i, v)}
                    placeholder="Введите должность"
                  />
                </td>
              ) : (
                <td className={styles.position}>{r?.position || '—'}</td>
              )}
              {onRemove && (
                <td className={styles.action}>
                  {r && records.length > 1 && (
                    <button
                      type="button"
                      className={styles.remove}
                      onClick={() => onRemove(r.company)}
                      aria-label={`Убрать «${r.company}» из заявления`}
                      title="Сотрудник не увольняется из этой компании — убрать из заявления"
                    >
                      <Icon name="close" size="sm" />
                    </button>
                  )}
                </td>
              )}
            </tr>
          ))}
        </tbody>
      </table>
    </div>
  );
 };
@@ -0,0 +1,98 @@
 import * as React from 'react';
 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 {
  /**
   * Убрать компанию — есть только на форме подачи (DismissalForm), делает
   * OrganizationsTable редактируемой (кнопка «убрать» + должность первой
   * компании). Не задано — DismissalView, таблица read-only.
   */
  onRemoveOrganization?: (company: string) => void;
  /** Поле «Лицо, принимающее ОС/НМА» редактируемо — см. DismissalView. */
  assetsAcceptorEditable?: boolean;
 }
 /**
 * Единственная секция формы «Заявление на увольнение»: кто увольняется, где
 * работает, последний рабочий день и контакты. Набор полей — с бумажного шаблона
 * «Заявление на увольнение ШТАТ».
 */
 export const RequestSection: React.FC<IRequestSectionProps> = ({
  data,
  set,
  context,
  onEmployeeChange,
  onRemoveOrganization,
  assetsAcceptorEditable
 }) => (
  <CollapseSection title="Заявление на увольнение" icon="document">
    <FormField label="Сотрудник" htmlFor="Employee" required full>
      <PeopleField
        context={context}
        value={data.Employee}
        onChange={onEmployeeChange ?? ((v) => set('Employee', v))}
        placeholder={EMPLOYEE_PLACEHOLDER}
      />
    </FormField>
    {/* ЕДИНСТВЕННОЕ место для компании/подразделения/должности — и на форме
        подачи (редактируемая, onRemoveOrganization задан), и в просмотре
        (read-only, ничего не передано). Отдельных полей для них нет — были бы
        дублированием того, что уже показывает эта таблица. */}
    <OrganizationsTable
      records={data.Organization}
      onChangePosition={
        onRemoveOrganization &&
        ((i, v) =>
          set(
            'Organization',
            data.Organization.length > 0
              ? data.Organization.map((r, ri) => (ri === i ? { ...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>
    {/* Заявление подаётся заранее — датой увольнения нельзя назначить ближе,
        чем через MIN_NOTICE_MONTHS месяц от сегодня (min). */}
    <FormField label="Последний рабочий день" htmlFor="LastWorkingDay" required>
      <TextInput
        id="LastWorkingDay"
        type="date"
        value={data.LastWorkingDay}
        onChange={(v) => set('LastWorkingDay', v)}
        min={isoDatePlusMonths(MIN_NOTICE_MONTHS)}
      />
    </FormField>
    <FormField label="Контактный телефон" htmlFor="Phone" required>
      <PhoneInput id="Phone" value={data.Phone} onChange={(v) => set('Phone', v)} />
    </FormField>
    <FormField label="Комментарий" htmlFor="Comment" full>
      <TextArea id="Comment" value={data.Comment} onChange={(v) => set('Comment', v)} />
    </FormField>
    {/* Появляется, только когда обходной лист уже создан (автоматически после
        согласования заявления — см. createClearance.ts). */}
    <LinkField
      label="Обходной лист"
      url={data.ClearanceUrl}
      text="Открыть обходной лист по этому увольнению"
    />
    {/* Заполняет НЕ заявитель, а непосредственный руководитель увольняемого на
        своём шаге согласования (см. DismissalView) — здесь всегда read-only,
        кроме как для него самого в момент его решения (assetsAcceptorEditable). */}
    <FormField label="Лицо, принимающее ОС/НМА" htmlFor="AssetsAcceptor" required={assetsAcceptorEditable} full>
      <PeopleField
        context={context}
        value={data.AssetsAcceptor}
        onChange={(v) => set('AssetsAcceptor', v)}
        placeholder={assetsAcceptorEditable ? 'Начните вводить Ф.И.О. сотрудника…' : undefined}
        readOnly={assetsAcceptorEditable ? false : true}
      />
    </FormField>
  </CollapseSection>
 );
@@ -0,0 +1,134 @@
 import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
 import { ISaveItemResult, resolveDataList, saveRequestItem } from '../../shared/dataList';
 import { ensureEmployee } from '../../shared/employee';
 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;
 }
 /**
 * Экземпляр сервиса списка согласования этой формы — тонкая обёртка над
 * approvalServiceFor (см. shared/approval/approvalServiceFactory.ts), под
 * именем формы для читаемости вызывающего кода.
 */
 export function dismissalApprovalService(listId?: string): ApprovalListService {
  return approvalServiceFor(FORM_ID, listId);
 }
 function pad2(n: number): string {
  return n < 10 ? `0${n}` : `${n}`;
 }
 /** Осмысленный заголовок элемента (системная колонка Title). */
 function buildTitle(employeeName: string): string {
  const now = new Date();
  return `Заявление на увольнение — ${employeeName} — ${pad2(now.getDate())}.${pad2(now.getMonth() + 1)}.${now.getFullYear()}`;
 }
 /**
 * Поля элемента списка данных из модели формы (+ Employee по Id).
 *
 * НЕ включает AssetsAcceptor: это поле заполняет непосредственный руководитель на
 * своём шаге согласования (см. updateAssetsAcceptor и DismissalView), а не
 * заявитель. Если бы buildItem писал его из data.AssetsAcceptor, повторное
 * сохранение формы подачи (доработка/повторная отправка) отправляло бы то же
 * значение назад — сейчас безвредно (round-trip), но при малейшем расхождении
 * состояния незаметно бы затёрло то, что руководитель уже проставил. Проще и
 * надёжнее вообще не трогать это поле из формы подачи.
 */
 function buildItem(
  data: IFormData,
  status: string,
  employeeId: number,
  employeeName: string
 ): Record<string, unknown> {
  return {
    Title: buildTitle(employeeName),
    RequestStatus: status,
    EmployeeId: employeeId,
    // Три параллельных 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
  };
 }
 export type ISaveResult = ISaveItemResult;
 /**
 * Сохранить заявление на увольнение: содержимое + маршрут согласования.
 * existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
 * Фазы исполнения нет — writeRoute вызывается с пустым списком исполнителей.
 * Возвращает Id заявки (+ код при создании).
 *
 * listId — партиция ОБНОВЛЯЕМОЙ заявки (см. loadDismissalRequest). Имеет смысл
 * только вместе с existingId: новая заявка всегда создаётся в ТЕКУЩЕЙ партиции —
 * писать новые заявки в архив незачем и нельзя (approval-route переключает
 * текущую партицию сам, по своему порогу элементов).
 */
 export async function saveDismissalRequest(
  existingId: number | undefined,
  requestTypeId: number,
  data: IFormData,
  approvers: IApproverToWrite[],
  status: string,
  listId?: string
 ): Promise<ISaveResult> {
  const employee = await ensureEmployee(data.Employee);
  const item = buildItem(data, status, employee.Id, employee.Title || data.Employee);
  const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, item);
  await writeRoute(dismissalApprovalService(listId), result.id, approvers, [], status);
  return result;
 }
 /**
 * Проставить «Лицо, принимающее ОС/НМА» — вызывается ИЗ 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 });
 }
@@ -12,7 +12,7 @@ export async function loadPrefillFromHire(hireId: number): Promise<IFormData> {
    FullName: hire.CandidateName,
    Phone: hire.Phone,
    Position: hire.Position,
-    Department: hire.SiteName,
+    Department: hire.Department,
    WorkKind: hire.WorkKind,
    Location: hire.SiteLocation,
    StartDate: hire.HireDate
@@ -39,6 +39,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
  ),
  'clearance-form': React.lazy(
    () => import(/* webpackChunkName: 'form-clearance' */ './Clearance/ClearanceForm')
  ),
  'hr-dismissal': React.lazy(
    () => import(/* webpackChunkName: 'form-dismissal' */ './Dismissal/DismissalForm')
  )
 };
@@ -52,6 +52,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
  ),
  'clearance-form': React.lazy(
    () => import(/* webpackChunkName: 'view-clearance' */ './Clearance/ClearanceView')
  ),
  'hr-dismissal': React.lazy(
    () => import(/* webpackChunkName: 'view-dismissal' */ './Dismissal/DismissalView')
  )
 };
@@ -11,8 +11,20 @@ interface IDecisionPanelProps {
  service: ApproverService;
  /** Id заявки (элемент списка данных). */
  requestId: number;
-  /** Уведомление после сохранения решения (например, обновить статус на экране). */
+  /**
-  onDecided?: (status: string) => void;
+   * Уведомление после сохранения решения (например, обновить статус на экране).
   *
   * Может вернуть Promise — тогда панель ДОЖДЁТСЯ его и только потом покажет
   * «Решение сохранено». Так работают побочные действия решения, без которых
   * ответ «согласовано» неполон: по согласованному заявлению на увольнение
   * автоматически создаётся обходной лист (см. forms/Dismissal), и сообщать об
   * успехе, пока он не создан, — значит показывать успех раньше времени.
   *
   * Отказ (reject) панель НЕ считает провалом решения — решение к этому моменту
   * уже применено на сервере; сообщить о проблеме побочного действия должен сам
   * обработчик (у него для этого есть своя область экрана).
   */
  onDecided?: (status: string) => void | Promise<void>;
  /** Выполнить ПЕРЕД применением решения (напр. сохранить поля, заполненные
   *  согласующим). Если бросит — решение не применяется, показывается ошибка. */
  onBeforeDecide?: () => Promise<void>;
@@ -83,11 +95,19 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
        await onBeforeDecide();
      }
      const status = await service.decide(requestId, pendingRow.id, decision, comment.trim());
      // Сначала побочные действия решения, потом «сохранено»: пока onDecided не
      // отработал, кнопки остаются заблокированными (submitting), и пользователь не
      // видит успеха раньше, чем всё сделано. Провал onDecided на статус решения не
      // влияет — оно уже применено, поэтому сообщение показываем всё равно.
      if (onDecided) {
        try {
          await onDecided(status);
        } catch (e) {
          console.error('Побочное действие после решения не выполнилось', e);
        }
      }
      setResultStatus(status);
      setSubmitting(false);
      if (onDecided) {
        onDecided(status);
      }
    } catch (e) {
      setError(`Не удалось сохранить решение: ${(e as Error).message}`);
      setSubmitting(false);
@@ -9,6 +9,22 @@ export function isoDatePlusDays(days: number): string {
  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
 }
 /**
 * Сегодня + n КАЛЕНДАРНЫХ месяцев в формате YYYY-MM-DD (для min/max у input
 * type=date) — не приближение через 30 дней: `setMonth` сам разносит месяцы
 * разной длины (28–31 день) и года на границе декабря/января.
 *
 * 31 января + 1 месяц → JS даёт 3 марта (переносит лишние дни на следующий
 * месяц, а не откатывает до последнего числа) — для месячного уведомления это
 * не проблема (крайняя ранняя дата и так сдвигается на несколько дней позже,
 * не раньше), но не считать это «ровно через месяц» в общем случае.
 */
 export function isoDatePlusMonths(months: number): string {
  const d = new Date();
  d.setMonth(d.getMonth() + months);
  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
 }
 /** YYYY-MM-DD → дд.мм.гггг, для текста ошибок валидации. Невалидную строку возвращает как есть. */
 export function formatIsoDate(iso: string): string {
  const [y, m, d] = iso.split('-');
@@ -0,0 +1,99 @@
 import { AadHttpClient, HttpClientResponse } from '@microsoft/sp-http';
 import { WebPartContext } from '@microsoft/sp-webpart-base';
 import { APPROVAL_API_CLIENT_ID, DICTIONARY_API_BASE_URL } from '../config';
 /**
 * Название должности директора по компании — ЗЕРКАЛО того же справочника, что
 * использует approval-route на бэкенде для маршрута HeadType.CompanyDirectors
 * (см. tnsu-approval-route TemplateRouteService.DirectorPositionByCompany).
 * Держим копию здесь, а не тянем с бэкенда: нужен только на фронте, чтобы найти
 * СТРОКУ МАТРИЦЫ, соответствующую конкретной компании (см.
 * forms/Dismissal/sections/OrganizationsTable.tsx) — сама матрица уже пришла
 * готовой от approval-route, эта функция лишь опознаёт в ней директора нужной
 * компании тем же способом, каким его туда положил бэкенд.
 *
 * Если бэкендный справочник изменится — эту копию нужно поправить вручную,
 * отдельного источника правды на два репозитория нет.
 */
 const DIRECTOR_POSITION_BY_COMPANY: Record<string, string> = {
  'ТОО KazPromService': 'Главный механик',
  'ТОО СТ Global': 'Генеральный директор'
 };
 const DEFAULT_DIRECTOR_POSITION = 'Директор';
 function normalizeCompany(company: string): string {
  return company.trim().toLowerCase();
 }
 const DIRECTOR_POSITION_BY_COMPANY_NORMALIZED: Record<string, string> = Object.keys(
  DIRECTOR_POSITION_BY_COMPANY
 ).reduce<Record<string, string>>((acc, key) => {
  acc[normalizeCompany(key)] = DIRECTOR_POSITION_BY_COMPANY[key];
  return acc;
 }, {});
 /** Название должности директора для компании (регистронезависимо). */
 export function directorPositionFor(company: string): string {
  return DIRECTOR_POSITION_BY_COMPANY_NORMALIZED[normalizeCompany(company)] || DEFAULT_DIRECTOR_POSITION;
 }
 async function getClient(context: WebPartContext): Promise<AadHttpClient> {
  return context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
 }
 /**
 * GET /Employee/ByPosition — сотрудник на должности в компании (напр. директор).
 * 404/«не найден» — не ошибка формы, просто вернуть '' (см. вызывающий код:
 * отсутствие директора не должно ронять форму, только не даст найти строку матрицы).
 */
 export async function getEmployeeEmailByPosition(
  context: WebPartContext,
  position: string,
  company: string
 ): Promise<string> {
  const client = await getClient(context);
  const response: HttpClientResponse = await client.get(
    `${DICTIONARY_API_BASE_URL}/Employee/ByPosition?position=${encodeURIComponent(
      position
    )}&company=${encodeURIComponent(company)}`,
    AadHttpClient.configurations.v1
  );
  if (response.status === 404) return '';
  if (!response.ok) {
    throw new Error(`Employee/ByPosition: ${response.status} ${response.statusText}`);
  }
  const body = (await response.json()) as { Email?: string; error?: string };
  return body.Email || '';
 }
 /** Директор (или должностной эквивалент, см. directorPositionFor) компании. */
 export function getCompanyDirectorEmail(context: WebPartContext, company: string): Promise<string> {
  return getEmployeeEmailByPosition(context, directorPositionFor(company), company);
 }
 /**
 * GET /Employee/Manager — руководитель сотрудника по типу связи. 'chief' —
 * непосредственный руководитель (тот же managerType, что использует
 * approval-route для HeadType.Chief — см. TemplateRouteService.ResolveStepAsync).
 * Не найден/сотрудник без руководителя — '' (не ошибка).
 */
 export async function getManagerEmail(
  context: WebPartContext,
  email: string,
  managerType: 'chief' | 'directionHead' = 'chief'
 ): Promise<string> {
  if (!email) return '';
  const client = await getClient(context);
  const response: HttpClientResponse = await client.get(
    `${DICTIONARY_API_BASE_URL}/Employee/Manager?email=${encodeURIComponent(email)}&managerType=${encodeURIComponent(
      managerType
    )}`,
    AadHttpClient.configurations.v1
  );
  if (response.status === 404) return '';
  if (!response.ok) {
    throw new Error(`Employee/Manager: ${response.status} ${response.statusText}`);
  }
  const body = (await response.json()) as { managerEmail?: string };
  return body.managerEmail || '';
 }
@@ -12,3 +12,9 @@ export { CompanyPickerMulti } from './ui/CompanyPickerMulti';
 export type { ICompanyPickerMultiProps } from './ui/CompanyPickerMulti';
 export { getEmployeeOrganizations, formatEmployeeOrganizations } from './employeeOrganizations.service';
 export type { IEmployeeOrganization } from './models/IEmployeeOrganization';
 export {
  directorPositionFor,
  getEmployeeEmailByPosition,
  getCompanyDirectorEmail,
  getManagerEmail
 } from './employeeLookup.service';
@@ -27,6 +27,7 @@ import {
 /** База имени по типу заявки. Ключи — те же, что в реестре форм (forms/registry.ts). */
 const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
  'clearance-form': 'Обходной лист',
  'hr-dismissal': 'Заявление на увольнение',
  'hr-vacation': 'Заявка на отпуск',
  'hr-unpaid-leave': 'Отпуск без содержания',
  'it-1c-ticket': 'Заявка в отдел 1С',
@@ -1,11 +1,13 @@
 import {
  IRoute,
  navigate,
  navigateToRequestLink,
  parseRoute,
  persistOwnStatus,
  persistOwnTab,
  persistPage,
  persistQuery,
  requestLinkUrl,
  routeUrl,
  storedOwnStatus,
  storedOwnTab,
@@ -527,3 +529,34 @@ describe('navigate', () => {
    expect(seen[0]).toContain('rpnav=approvals');
  });
 });
 describe('requestLinkUrl / navigateToRequestLink', () => {
  it('ссылка абсолютна и не тащит посторонние параметры текущей страницы', () => {
    window.history.replaceState({}, '', '/?foo=bar&rpnav=own');
    expect(requestLinkUrl('clearance-form', 7, '/sites/requests/Lists/List10')).toBe(
      'http://localhost/?rpmode=approve&rptype=clearance-form&rpid=7&rplist=%2Fsites%2Frequests%2FLists%2FList10'
    );
  });
  it('ссылка на заявку этого же портала открывается навигацией, без перезагрузки', () => {
    window.history.replaceState({}, '', '/?rpnav=own');
    expect(navigateToRequestLink(requestLinkUrl('clearance-form', 7))).toBe(true);
    const route = parseRoute();
    expect(route.mode).toBe('approve');
    expect(route.formKey).toBe('clearance-form');
    expect(route.itemId).toBe(7);
    // Раздел под панелью заявки остаётся тем же, что был открыт.
    expect(route.nav).toBe('own');
  });
  it('чужой сайт, другая страница и ссылка не на заявку — клик отдаётся браузеру', () => {
    expect(navigateToRequestLink('https://example.com/p?rpmode=approve&rptype=a&rpid=1')).toBe(false);
    expect(navigateToRequestLink('/OtherPage.aspx?rpmode=approve&rptype=a&rpid=1')).toBe(false);
    expect(navigateToRequestLink('http://localhost/?rpnav=own')).toBe(false);
  });
  it('мусор вместо адреса не роняет обработчик клика', () => {
    expect(navigateToRequestLink('не ссылка')).toBe(false);
  });
 });
@@ -412,6 +412,69 @@ export function routeUrl(route: IRoute): string {
  return buildQuery(route);
 }
 /**
 * АБСОЛЮТНАЯ ссылка на просмотр заявки — для того, что переживёт текущую сессию:
 * колонка-гиперссылка в списке SharePoint, письмо, сообщение в чат.
 *
 * Отличается от routeUrl() двумя вещами, и обе важны именно для «хранимой» ссылки:
 * она с origin (в списке относительный путь бесполезен — его открывают из
 * представления SharePoint, а не со страницы портала) и без посторонних
 * query-параметров текущей страницы (routeUrl их намеренно сохраняет, потому что
 * это навигация ВНУТРИ открытой страницы).
 *
 * Страница портала берётся из адреса текущей — портал живёт на одной странице,
 * другого способа узнать её путь у клиентского кода нет.
 */
 export function requestLinkUrl(formKey: string, itemId: number, listId?: string): string {
  const params = new URLSearchParams();
  params.set('rpmode', 'approve');
  params.set('rptype', formKey);
  params.set('rpid', String(itemId));
  if (listId) {
    params.set('rplist', listId);
  }
  return `${window.location.origin}${window.location.pathname}?${params.toString()}`;
 }
 /**
 * Открыть заявку по её АБСОЛЮТНОЙ ссылке (см. requestLinkUrl) БЕЗ перезагрузки
 * страницы — если ссылка ведёт на эту же страницу портала.
 *
 * Зачем: страница SharePoint со SPFx грузится секунды, а ссылка между парными
 * заявками (заявление на увольнение ↔ обходной лист) — это по сути та же страница
 * с другими rp-параметрами, то есть ровно то, что умеет navigate(). Полная
 * перезагрузка здесь ничего не даёт.
 *
 * Возвращает false, если ссылка ведёт куда-то ещё (другой сайт, другая страница,
 * не на просмотр заявки) — тогда вызывающий НЕ должен подавлять клик и обязан
 * дать браузеру перейти по ней обычным образом.
 */
 export function navigateToRequestLink(url: string): boolean {
  let target: URL;
  try {
    target = new URL(url, window.location.href);
  } catch {
    return false;
  }
  // Путь в SharePoint регистронезависим, а ссылка могла быть записана в список
  // когда-то с другим регистром — сравниваем в нижнем.
  if (
    target.origin !== window.location.origin ||
    target.pathname.toLowerCase() !== window.location.pathname.toLowerCase()
  ) {
    return false;
  }
  const route = parseRoute(target.search);
  if (route.mode !== 'approve' || !route.formKey || !route.itemId) {
    return false;
  }
  // Раздел бокового меню берём ТЕКУЩИЙ, а не из ссылки: заявка показывается в
  // панели поверх раздела, и уход по ссылке не должен переключать раздел под ней.
  navigate({ ...route, nav: parseRoute().nav });
  return true;
 }
 /** Текущий маршрут, реактивно обновляется по navigate() и кнопке «назад». */
 export function useRoute(): IRoute {
  const [route, setRoute] = React.useState<IRoute>(() => parseRoute());
@@ -0,0 +1,30 @@
@import '../../../../../styles/design-tokens';
 // Read-only «карточка» со ссылкой — те же радиус/паддинг/приглушённый фон, что у
 // OrganizationField (сигнал «подставлено автоматически, не редактируется»),
 // отличается только тем, что содержимое кликабельно.
 .box {
  box-sizing: border-box;
  padding: 11px 13px;
  border: 1px solid $gray-200;
  border-radius: $r-sm;
  background: $gray-50;
  font-family: $font-sans;
  font-size: 13.5px;
  color: $gray-700;
 }
 .link {
  display: inline-flex;
  align-items: center;
  gap: $sp-2;
  color: $navy-700;
  text-decoration: none;
  transition: color .18s;
  &:hover,
  &:focus {
    color: $gold-600;
    text-decoration: underline;
  }
 }
@@ -0,0 +1,52 @@
 import * as React from 'react';
 import styles from './LinkField.module.scss';
 import { FormField, Icon } from '@tnsu/ui-kit';
 import { navigateToRequestLink } from '../../routing';
 interface ILinkFieldProps {
  label: string;
  /** Адрес. Пусто — поле не рендерится вовсе (см. ниже). */
  url: string;
  /** Текст ссылки. По умолчанию — сам адрес. */
  text?: string;
 }
 /**
 * Поле-ссылка: read-only, кликабельное, руками не редактируется.
 *
 * Пустой url — ничего не рендерим (а не пустую рамку): такие поля появляются
 * только когда связь уже есть (напр. ClearanceUrl заявления на увольнение
 * заполняется автосозданием обходного листа), и до этого момента их нет смысла
 * показывать.
 *
 * Открывается в ТОЙ ЖЕ вкладке, и если ссылка ведёт на заявку этого же портала —
 * вообще без перезагрузки страницы (navigateToRequestLink: та же страница, другие
 * rp-параметры). href при этом настоящий, а не «#»: ссылку можно скопировать,
 * открыть в новой вкладке через Ctrl/⌘+клик или среднюю кнопку — такие клики
 * перехват намеренно пропускает.
 */
 export const LinkField: React.FC<ILinkFieldProps> = ({ label, url, text }) => {
  if (!url) return null;
  const handleClick = (e: React.MouseEvent<HTMLAnchorElement>): void => {
    // Клик с модификатором или не левой кнопкой — осознанное «открыть отдельно»,
    // отдаём браузеру. Иначе пробуем перейти внутри портала.
    if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {
      return;
    }
    if (navigateToRequestLink(url)) {
      e.preventDefault();
    }
  };
  return (
    <FormField label={label} full>
      <div className={styles.box}>
        <a className={styles.link} href={url} onClick={handleClick}>
          <span>{text || url}</span>
          <Icon name="chevron-right" size="sm" />
        </a>
      </div>
    </FormField>
  );
 };
@@ -41,6 +41,7 @@ export { PeopleFieldMulti } from './PeopleField/PeopleFieldMulti';
 export { OrganizationField } from './OrganizationField/OrganizationField';
 export { PrintOrgSelect } from './PrintOrgSelect/PrintOrgSelect';
 export { OrgLetterhead } from './OrgLetterhead/OrgLetterhead';
 export { LinkField } from './LinkField/LinkField';
 export { ErrorOverlay } from './ErrorOverlay/ErrorOverlay';
 export { SubmitActions } from './SubmitActions/SubmitActions';
 export { InitiatorLine } from './InitiatorLine/InitiatorLine';