refactor: общий хук маршрута по фазам (usePhasedRoute)

Хук, который грузит маршрут согласования отдельно по фазам «Согласование»
и «Исполнение», был в папке «Объяснительной по СКУД». Он понадобился и
заявке на командировку, поэтому перенесён в shared/approval под общим
именем. Поведение СКУД не меняется — поменялись только импорты.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

src/webparts/requestPortal/forms/SkudExplanation/README.md

@@ -10,7 +10,7 @@
 ## Маршрут
 - Фазы: согласование (напр. непосредственный руководитель) + исполнение (напр. кадры) —
   обе фазы грузятся отдельными запросами `getPlannedMatrix(..., 'Approval' | 'Execution')`
-  в `useSkudRoute` (паттерн Referral). Без запроса 'Execution' шаг исполнения пропадает.
+  в общем `usePhasedRoute` (shared/approval, паттерн Referral). Без запроса 'Execution' шаг исполнения пропадает.
 - Планируемый маршрут резолвится по e-mail сотрудника; согласующих заявитель может
   править (новая / черновик / возврат), исполнителей — нет (только чтение).
 - Нет согласующих вовсе — `initialSubmitStatus` сразу ставит «Выполнение».

src/webparts/requestPortal/forms/SkudExplanation/SkudExplanationForm.tsx

@@ -23,7 +23,8 @@ import {
   initialSubmitStatus,
   IApproverToWrite,
   unassignedStepMessage,
-  resolveWriteListId
+  resolveWriteListId,
+  usePhasedRoute
 } from '../../shared/approval';
 import { IRequestFormProps } from '../../models/types';
 import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
@@ -43,7 +44,6 @@ import { loadSkudExplanationRequest } from './load';
 import { submittedConflictMessage } from './submittedDays';
 import { getSubmittedDays } from './submittedDays.service';
 import { useSubmittedDays } from './useSubmittedDays';
-import { useSkudRoute } from './useSkudRoute';
 import { todayDateKey } from './skud/skudDays';
 import { EmployeeSection } from './sections/EmployeeSection';
 import { DaysSection } from './sections/DaysSection';
@@ -126,7 +126,7 @@ const SkudExplanationForm: React.FC<IRequestFormProps> = ({
   }, [editId, context]);
 
   // Маршрут по сотруднику; у открытой заявки — из уже записанных строк, чтобы не затереть правки.
-  const { approvers: matrix, executors } = useSkudRoute({
+  const { approvers: matrix, executors } = usePhasedRoute({
     context,
     approval,
     requestId: editId,

src/webparts/requestPortal/forms/SkudExplanation/SkudExplanationView.tsx

@@ -9,7 +9,8 @@ import {
   StatusBadge,
   ApprovalHistory,
   notifyActiveStep,
-  useRequestTypeId
+  useRequestTypeId,
+  usePhasedRoute
 } from '../../shared/approval';
 import type { ISiteUser } from '../../shared/approval';
 import { friendlyErrorMessage } from '../../shared/diagnostics';
@@ -23,7 +24,6 @@ import { useStableCallback } from '../../shared/useStableCallback';
 import { FORM_ID, FORM_TITLE, IFormData, EMPTY_DATA, SetField } from './model';
 import { loadSkudExplanationRequest } from './load';
 import { skudExplanationApprovalService } from './submit';
-import { useSkudRoute } from './useSkudRoute';
 import { EmployeeSection } from './sections/EmployeeSection';
 import { DaysSection } from './sections/DaysSection';
 import { ExplanationSection } from './sections/ExplanationSection';
@@ -65,7 +65,7 @@ const SkudExplanationView: React.FC<ISkudExplanationViewProps> = ({ context, ite
 
   // decisionSeq: после решения строки маршрута меняются — перечитываем обе фазы.
   const [decisionSeq, setDecisionSeq] = useState<number>(0);
-  const { approvers, executors } = useSkudRoute({
+  const { approvers, executors } = usePhasedRoute({
     context,
     approval,
     requestId: itemId,

src/webparts/requestPortal/forms/SkudExplanation/useSkudRoute.ts

@@ -1,67 +0,0 @@
-import { useCallback } from 'react';
-import { WebPartContext } from '@microsoft/sp-webpart-base';
-import {
-  APPROVAL_PHASE,
-  ApprovalListService,
-  IMatrixRow,
-  getPlannedMatrix,
-  resolveApproverOrgInfo,
-  useMatrixEditor
-} from '../../shared/approval';
-
-type MatrixEditor = ReturnType<typeof useMatrixEditor>;
-
-export interface ISkudRoute {
-  /** Согласующие — редактируемы заявителем в новой заявке / черновике / доработке. */
-  approvers: MatrixEditor;
-  /** Исполнители по маршруту (фаза «Исполнение») — только чтение. */
-  executors: MatrixEditor;
-}
-
-interface IRouteSource {
-  context: WebPartContext;
-  approval: ApprovalListService;
-  /** Заявка уже записана — маршрут читаем из её строк, а не планируем заново. */
-  requestId: number | undefined;
-  employeeEmail: string;
-  requestTypeId: number | undefined;
-  /** Можно ли править согласующих. */
-  editable: boolean;
-  /** Меняется после решения согласующего — перечитать строки. */
-  reloadSeq?: number;
-}
-
-const byPhase = (execution: boolean) => (rows: IMatrixRow[]): IMatrixRow[] =>
-  rows.filter((r) => (r.phase === APPROVAL_PHASE.execution) === execution);
-
-/**
- * Маршрут объяснительной по двум фазам. Без отдельного запроса фазы
- * 'Execution' getPlannedMatrix исполнителей не резолвит — шаг кадров из
- * маршрута «пропадал» бы. Паттерн тот же, что в Referral.
- */
-export function useSkudRoute(source: IRouteSource): ISkudRoute {
-  const { context, approval, requestId, employeeEmail, requestTypeId, editable, reloadSeq = 0 } = source;
-  const canLoad = !!requestId || (!!employeeEmail && !!requestTypeId);
-  const reloadKey = `${employeeEmail}-${requestId ?? 'new'}-${reloadSeq}`;
-
-  const loadPhase = useCallback(
-    (execution: boolean) =>
-      requestId
-        ? approval.getMatrixForRequest(requestId).then(byPhase(execution))
-        : getPlannedMatrix(
-            context,
-            requestTypeId as number,
-            employeeEmail,
-            approval,
-            execution ? 'Execution' : 'Approval'
-          ),
-    [context, approval, requestId, employeeEmail, requestTypeId]
-  );
-  const loadApprovers = useCallback(() => loadPhase(false), [loadPhase]);
-  const loadExecutors = useCallback(() => loadPhase(true), [loadPhase]);
-  const jobTitle = (login: string): Promise<string> => approval.getJobTitle(login);
-
-  const approvers = useMatrixEditor(loadApprovers, reloadKey, editable, canLoad, jobTitle, resolveApproverOrgInfo(context));
-  const executors = useMatrixEditor(loadExecutors, reloadKey, false, canLoad, jobTitle, resolveApproverOrgInfo(context));
-  return { approvers, executors };
-}