feat: finished recruitin selection form

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

@@ -2,29 +2,29 @@
 
 **Назначение:** заявка на подбор персонала / открытие вакансии.
 **Категория:** Отдел рекрутинга
-**Списки SP:** «Заявка на подбор — данные» (только данные — согласования нет)
-**RequestTypeId (внешний API маршрутов):** — (маршрут не используется)
+**Списки SP:** «Заявка на подбор — данные» / «Заявка на подбор — согласование»
+**RequestTypeId (внешний API маршрутов):** 4
 
 ## Маршрут
-- Фаз нет: отправка = запись в список данных, без согласования и исполнения.
+- Фазы: только согласование (как RecruitingHire, но без фазы исполнения — как Vacation).
+  Маршрут резолвится по email инициатора (текущего пользователя), матрица
+  **редактируема** заявителем при новой заявке / черновике / возврате.
+- После согласования заявка получает статус «Согласовано».
 
 ## Особое поведение
 - **Самая большая форма (~42 поля).**
 - **Поля-люди:** `Responsible`, `ProposedMentor`, `DirectManager` — один человек;
   `HiringDecisionMaker` — несколько (мульти). Пишутся как `<Field>Id`
-  (см. `submit.ts` → `resolveUserId`).
-- **Нет режима согласующего** (в `viewRegistry` не зарегистрирована) и **нет общего
-  жизненного цикла** (черновик/статус/upsert) — это ранняя форма, простая отправка
-  через `submitRecruitingSelection`.
+  (см. `submit.ts` → `applyPeople`/`resolveUserId`), читаются с `expand` по `EMail`
+  (`load.ts`). Пустое значение при обновлении очищает поле (`…Id = null` / `[]`).
+- **Общий жизненный цикл:** черновик / отправка / статус (`RequestStatus`), upsert по
+  `existingId`, вложения, оповещение согласующего при отправке (`notifyActiveStep`) —
+  всё через `shared/approval` и `shared/ui`, как в Hire/1C/Vacation.
 
 ## Секции формы
-См. `sections/` формы.
+ApplicationSection · DepartmentSection · VacancySection · HealthTripsSection · ConditionsSection
 
 ## Точки входа
 - rptype: `recruiting-selection`
-- Режим согласующего (просмотр): нет
+- Режим согласующего (просмотр): есть (`RecruitingSelectionView`)
 - «Создать на основе»: —
-
-> Замечание: сделана до введения общего жизненного цикла и согласования. При
-> необходимости приводится к общему шаблону (`useRequestSubmit` + `SubmitActions`
-> + маршрут согласования), как в остальных формах.

src/webparts/requestPortal/forms/RecruitingSelection/RecruitingSelectionForm.tsx

@@ -1,53 +1,176 @@
 import * as React from 'react';
-import { useState } from 'react';
+import { useState, useMemo, useCallback, useEffect } from 'react';
 import styles from './RecruitingSelectionForm.module.scss';
-import { Button, Alert, FormCard, FormActions, Icon } from '../../shared/ui';
+import {
+  Alert,
+  FormCard,
+  FormModeProvider,
+  FileDropzone,
+  AttachmentList,
+  CollapseSection,
+  FormField,
+  Icon,
+  RequestNumber,
+  SubmitActions,
+  useRequestSubmit
+} from '../../shared/ui';
+import {
+  ApprovalMatrix,
+  StatusBadge,
+  useMatrixEditor,
+  getPlannedMatrix,
+  notifyActiveStep,
+  REQUEST_STATUS,
+  isEditableStatus,
+  IApproverToWrite,
+  findUnassignedStep
+} from '../../shared/approval';
+import {
+  uploadAttachments,
+  getAttachments,
+  deleteAttachment,
+  IAttachmentInfo
+} from '../../shared/attachments/attachments.service';
 import { IRequestFormProps } from '../../models/types';
 import { IFormData, EMPTY_DATA, SetField } from './model';
-import { submitRecruitingSelection } from './submit';
+import {
+  saveSelectionRequest,
+  selectionApprovalService,
+  RECRUITING_SELECTION_REQUEST_TYPE_ID,
+  DATA_LIST_TITLE,
+  APPROVAL_LIST_TITLE
+} from './submit';
+import { loadSelectionRequest } from './load';
 import { ApplicationSection } from './sections/ApplicationSection';
 import { DepartmentSection } from './sections/DepartmentSection';
 import { VacancySection } from './sections/VacancySection';
 import { HealthTripsSection } from './sections/HealthTripsSection';
 import { ConditionsSection } from './sections/ConditionsSection';
 
-const RecruitingSelectionForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved }) => {
+const RecruitingSelectionForm: React.FC<IRequestFormProps> = ({ requestType, context, onCancel, onSaved, editId }) => {
   const [data, setData] = useState<IFormData>(EMPTY_DATA);
-  const [saving, setSaving] = useState<boolean>(false);
-  const [saved, setSaved] = useState<boolean>(false);
-  const [savedCode, setSavedCode] = useState<string | undefined>(undefined);
-  const [error, setError] = useState<string | null>(null);
+  const [files, setFiles] = useState<File[]>([]);
+  const [existingAttachments, setExistingAttachments] = useState<IAttachmentInfo[]>([]);
+  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 set: SetField = (key, value) => {
-    setData((prev) => ({ ...prev, [key]: value }));
-    setSaved(false);
-  };
+  const readOnly = !isEditableStatus(requestStatus);
+  const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
 
-  async function handleSave(): Promise<void> {
-    const missing: string[] = [];
-    if (!data.Responsible) missing.push('Ответственный за подачу заявки');
-    if (!data.DepartmentName) missing.push('Название отдела/департамента');
-    if (!data.Position) missing.push('Должность');
-    if (missing.length > 0) {
-      setError(`Заполните обязательные поля: ${missing.join(', ')}`);
+  // Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое,
+  // статус и уже прикреплённые вложения.
+  useEffect(() => {
+    if (!editId) {
       return;
     }
+    let alive = true;
+    Promise.all([loadSelectionRequest(editId), getAttachments(DATA_LIST_TITLE, editId)])
+      .then(([loaded, atts]) => {
+        if (alive) {
+          setData(loaded.data);
+          setRequestStatus(loaded.status);
+          setRequestCode(loaded.code || undefined);
+          setExistingAttachments(atts);
+        }
+      })
+      .catch((e) => {
+        if (alive) {
+          submit.setError(`Не удалось загрузить заявку №${editId}: ${(e as Error).message}`);
+        }
+      });
+    return () => {
+      alive = false;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [editId]);
 
-    setError(null);
-    setSaving(true);
-    try {
-      const code = await submitRecruitingSelection(data);
-      setSaved(true);
-      setSavedCode(code);
+  // Маршрут согласования резолвится по email инициатора (текущего пользователя).
+  // У заявки на редактировании маршрут читается из уже записанных строк, чтобы не
+  // затереть правки инициатора при первом сохранении.
+  const approval = useMemo(() => selectionApprovalService(), []);
+  const userEmail = context.pageContext.user.email;
+  const loadMatrix = useCallback(
+    () =>
+      editId
+        ? approval.getMatrixForRequest(editId)
+        : getPlannedMatrix(context, RECRUITING_SELECTION_REQUEST_TYPE_ID, userEmail, approval, 'Approval'),
+    [context, userEmail, approval, editId]
+  );
+  const matrix = useMatrixEditor(
+    loadMatrix,
+    `${userEmail}-${editId ?? 'new'}`,
+    !readOnly,
+    true,
+    (login) => approval.getJobTitle(login)
+  );
+
+  const isValid = !!(data.Responsible && data.DepartmentName.trim() && data.Position.trim());
+  const validate = (): string | undefined =>
+    isValid
+      ? undefined
+      : 'Заполните обязательные поля: ответственный за подачу, название отдела, должность.';
+
+  const toApprovers = (rows: typeof matrix.rows): IApproverToWrite[] =>
+    rows.map((r) => ({
+      email: r.email,
+      position: r.position,
+      allowReassign: r.allowReassign,
+      order: r.order
+    }));
+
+  const handleRemoveAttachment = (fileName: string): void => {
+    if (requestId === undefined) {
+      return;
+    }
+    deleteAttachment(DATA_LIST_TITLE, requestId, fileName)
+      .then(() => setExistingAttachments((prev) => prev.filter((a) => a.fileName !== fileName)))
+      .catch(() => undefined);
+  };
+
+  const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
+    const { id, code } = await saveSelectionRequest(requestId, data, toApprovers(matrix.rows), status);
+    setRequestId(id);
+    setRequestStatus(status);
+    if (code) {
+      setRequestCode(code);
+    }
+    if (files.length > 0) {
+      await uploadAttachments(DATA_LIST_TITLE, id, files); // файлы — после создания элемента
+      setFiles([]); // выгруженные файлы убираем, чтобы пересохранение не дублировало
+      setExistingAttachments(await getAttachments(DATA_LIST_TITLE, id));
+    }
     if (onSaved) {
       onSaved();
     }
-    } catch (e) {
-      setError(`Ошибка сохранения: ${(e as Error).message}`);
-    } finally {
-      setSaving(false);
+    // Отправка на согласование — уведомляем первый активный шаг (поток оповещения).
+    if (status === REQUEST_STATUS.onApproval) {
+      await notifyActiveStep(context, approval, id, {
+        requestTypeId: RECRUITING_SELECTION_REQUEST_TYPE_ID,
+        dataListName: DATA_LIST_TITLE,
+        approvalListName: APPROVAL_LIST_TITLE
+      });
     }
+  };
+
+  // На отправку (в отличие от черновика) маршрут должен быть полностью укомплектован —
+  // иначе шаг без назначенного человека молча пропадёт при записи в SharePoint.
+  const validateSubmit = (): string | undefined => {
+    const formError = validate();
+    if (formError) return formError;
+    if (matrix.error) {
+      return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
     }
+    const unassigned = findUnassignedStep(matrix.rows);
+    if (unassigned) {
+      return `Шаг ${unassigned.order} маршрута согласования («${unassigned.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`;
+    }
+    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 };
 
@@ -58,27 +181,57 @@ const RecruitingSelectionForm: React.FC<IRequestFormProps> = ({ requestType, con
         <span>К списку заявок</span>
       </button>
 
-      <FormCard title={requestType.title} subtitle="Категория: Отдел рекрутинга">
-        {saved && (
-          <Alert variant="ok">Заявка сохранена в SharePoint. Код заявки: №{savedCode}.</Alert>
+      <FormCard
+        title={requestType.title}
+        subtitle="Категория: Отдел рекрутинга"
+        headerRight={
+          requestId || requestStatus ? (
+            <>
+              {requestStatus && <StatusBadge status={requestStatus} />}
+              {requestCode && <RequestNumber code={requestCode} />}
+            </>
+          ) : undefined
+        }
+      >
+        {submit.savedKind && !submit.error && (
+          <Alert variant="ok">
+            {submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
+          </Alert>
         )}
-        {error && <Alert variant="err">{error}</Alert>}
+        {submit.error && <Alert variant="err">{submit.error}</Alert>}
 
+        <FormModeProvider readOnly={readOnly}>
           <ApplicationSection {...sectionProps} />
           <DepartmentSection {...sectionProps} />
           <VacancySection {...sectionProps} />
           <HealthTripsSection {...sectionProps} />
           <ConditionsSection {...sectionProps} />
+        </FormModeProvider>
 
-        <FormActions>
-          <Button variant="secondary" onClick={onCancel} disabled={saving}>
-            Отмена
-          </Button>
-          <Button variant="accent" onClick={handleSave} disabled={saving}>
-            <Icon name="check" size="sm" />
-            {saving ? 'Сохранение…' : 'Сохранить заявку'}
-          </Button>
-        </FormActions>
+        {!readOnly && (
+          <CollapseSection title="Вложения" icon="upload">
+            {existingAttachments.length > 0 && (
+              <FormField label="Прикреплённые файлы" full>
+                <AttachmentList items={existingAttachments} onRemove={handleRemoveAttachment} />
+              </FormField>
+            )}
+            <FormField label={existingAttachments.length > 0 ? 'Добавить файлы' : 'Файлы'} full>
+              <FileDropzone files={files} onChange={setFiles} />
+            </FormField>
+          </CollapseSection>
+        )}
+
+        <ApprovalMatrix editor={matrix} search={(q) => approval.searchUsers(q)} />
+
+        <SubmitActions
+          submit={submit}
+          isValid={isValid}
+          readOnly={readOnly}
+          onCancel={onCancel}
+          onSaveDraft={handleSaveDraft}
+          onSubmit={handleSubmit}
+          submitLabel="Отправить на согласование"
+        />
       </FormCard>
     </div>
   );

src/webparts/requestPortal/forms/RecruitingSelection/RecruitingSelectionView.module.scss

@@ -0,0 +1,14 @@
+@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;
+}

src/webparts/requestPortal/forms/RecruitingSelection/RecruitingSelectionView.tsx

@@ -0,0 +1,157 @@
+import * as React from 'react';
+import { useState, useEffect, useMemo, useCallback } from 'react';
+import type { WebPartContext } from '@microsoft/sp-webpart-base';
+import styles from './RecruitingSelectionView.module.scss';
+import { Alert, FormCard, FormModeProvider, CollapseSection, FormField, AttachmentList, PrintButton } from '../../shared/ui';
+import {
+  ApproverService,
+  DecisionPanel,
+  StatusBadge,
+  ApprovalMatrix,
+  useMatrixEditor,
+  notifyActiveStep
+} from '../../shared/approval';
+import { getAttachments, IAttachmentInfo } from '../../shared/attachments/attachments.service';
+import { IFormData, EMPTY_DATA, SetField } from './model';
+import { loadSelectionRequest } from './load';
+import {
+  selectionApprovalService,
+  RECRUITING_SELECTION_REQUEST_TYPE_ID,
+  DATA_LIST_TITLE,
+  APPROVAL_LIST_TITLE
+} from './submit';
+import { ApplicationSection } from './sections/ApplicationSection';
+import { DepartmentSection } from './sections/DepartmentSection';
+import { VacancySection } from './sections/VacancySection';
+import { HealthTripsSection } from './sections/HealthTripsSection';
+import { ConditionsSection } from './sections/ConditionsSection';
+
+interface IRecruitingSelectionViewProps {
+  context: WebPartContext;
+  itemId: number;
+}
+
+// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
+const NOOP_SET: SetField = () => undefined;
+
+// Заявка «на подбор» только для просмотра (режим согласующего). Переиспользует те же
+// секции, что и форма подачи; редактирование выключено через <FormModeProvider readOnly>.
+const RecruitingSelectionView: React.FC<IRecruitingSelectionViewProps> = ({ context, itemId }) => {
+  const [data, setData] = useState<IFormData>(EMPTY_DATA);
+  const [status, setStatus] = useState<string>('');
+  const [code, setCode] = useState<string>('');
+  const [attachments, setAttachments] = useState<IAttachmentInfo[]>([]);
+  const [loading, setLoading] = useState<boolean>(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const approval = useMemo(() => selectionApprovalService(), []);
+  const approverService = useMemo(() => new ApproverService(approval, DATA_LIST_TITLE), [approval]);
+
+  // Матрица маршрута из фактических строк заявки (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);
+    Promise.all([loadSelectionRequest(itemId), getAttachments(DATA_LIST_TITLE, itemId)])
+      .then(([loaded, files]) => {
+        if (alive) {
+          setData(loaded.data);
+          setStatus(loaded.status);
+          setCode(loaded.code);
+          setAttachments(files);
+          setError(null);
+          setLoading(false);
+        }
+      })
+      .catch((e) => {
+        if (alive) {
+          setError(`Не удалось загрузить заявку №${itemId}: ${(e as Error).message}`);
+          setLoading(false);
+        }
+      });
+    return () => {
+      alive = false;
+    };
+  }, [itemId]);
+
+  if (loading) {
+    return <div className={styles.state}>Загрузка заявки…</div>;
+  }
+  if (error) {
+    return (
+      <div className={styles.state}>
+        <Alert variant="err">{error}</Alert>
+      </div>
+    );
+  }
+
+  const sectionProps = { data, set: NOOP_SET, context };
+
+  const notify = (): void => {
+    notifyActiveStep(context, approval, itemId, {
+      requestTypeId: RECRUITING_SELECTION_REQUEST_TYPE_ID,
+      dataListName: DATA_LIST_TITLE,
+      approvalListName: APPROVAL_LIST_TITLE
+    }).catch(() => undefined);
+  };
+
+  return (
+    <div>
+      <div className={`${styles.toolbar} rp-no-print`}>
+        <PrintButton />
+      </div>
+
+      <div className="rp-print-root">
+        <FormCard
+          title="Заявка на подбор"
+          subtitle={`№${code || itemId}`}
+          headerRight={status ? <StatusBadge status={status} /> : undefined}
+        >
+          <FormModeProvider readOnly>
+            <ApplicationSection {...sectionProps} />
+            <DepartmentSection {...sectionProps} />
+            <VacancySection {...sectionProps} />
+            <HealthTripsSection {...sectionProps} />
+            <ConditionsSection {...sectionProps} />
+          </FormModeProvider>
+
+          <div className="rp-no-print">
+            <CollapseSection title="Вложения" icon="upload">
+              <FormField label="Файлы" full>
+                <AttachmentList items={attachments} />
+              </FormField>
+            </CollapseSection>
+          </div>
+        </FormCard>
+
+        <ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
+      </div>
+
+      {/* Панель решения — ВНЕ печати и FormModeProvider (комментарий редактируемый). */}
+      <div className="rp-no-print">
+        <DecisionPanel
+          service={approverService}
+          requestId={itemId}
+          search={(q) => approval.searchUsers(q)}
+          onDecided={(newStatus) => {
+            setStatus(newStatus);
+            setDecisionSeq((n) => n + 1);
+            notify();
+          }}
+          onDelegated={() => {
+            setDecisionSeq((n) => n + 1);
+            notify();
+          }}
+        />
+      </div>
+    </div>
+  );
+};
+
+export default RecruitingSelectionView;

src/webparts/requestPortal/forms/RecruitingSelection/approval/provisioning.json

@@ -0,0 +1,14 @@
+{
+  "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": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
+  ]
+}

src/webparts/requestPortal/forms/RecruitingSelection/load.ts

@@ -0,0 +1,66 @@
+import { getSP } from '../../shared/pnp/pnpjs';
+import { IFormData, EMPTY_DATA } from './model';
+
+const LIST_TITLE = 'Заявка на подбор — данные';
+
+// Категории полей — определяют, как читать значение из элемента списка.
+const PERSON_FIELDS: (keyof IFormData)[] = ['Responsible', 'ProposedMentor', 'DirectManager'];
+const MULTI_PERSON_FIELDS: (keyof IFormData)[] = ['HiringDecisionMaker'];
+const BOOL_FIELDS: (keyof IFormData)[] = ['IsRegistered', 'IsApproved', 'CompletionMark', 'MaterialResponsibility'];
+const DATE_FIELDS: (keyof IFormData)[] = ['SubmitDate', 'ClosingDeadline'];
+
+type PersonValue = { EMail?: string } | undefined;
+
+export interface ILoadedRequest {
+  data: IFormData;
+  status: string;
+  /** Уникальный код заявки; '' — если запись создана до появления поля. */
+  code: string;
+}
+
+/** Прочитать заявку «на подбор» по id: модель формы + статус (правка / просмотр). */
+export async function loadSelectionRequest(itemId: number): Promise<ILoadedRequest> {
+  const keys = Object.keys(EMPTY_DATA) as (keyof IFormData)[];
+  const isPerson = (k: keyof IFormData): boolean =>
+    PERSON_FIELDS.indexOf(k) !== -1 || MULTI_PERSON_FIELDS.indexOf(k) !== -1;
+
+  // Скалярные поля — по имени; поля-люди — вложенный EMail (+ expand).
+  const scalarSelects = keys.filter((k) => !isPerson(k));
+  const personSelects = [...PERSON_FIELDS, ...MULTI_PERSON_FIELDS].map((k) => `${k}/EMail`);
+  const expands = [...PERSON_FIELDS, ...MULTI_PERSON_FIELDS];
+
+  const item = (await getSP()
+    .web.lists.getByTitle(LIST_TITLE)
+    .items.getById(itemId)
+    .select(...scalarSelects, 'RequestStatus', 'RequestUniqueCode', ...personSelects)
+    .expand(...expands)()) as Record<string, unknown>;
+
+  const data: IFormData = { ...EMPTY_DATA };
+  const writable = data as unknown as Record<string, unknown>;
+
+  keys.forEach((key) => {
+    if (PERSON_FIELDS.indexOf(key) !== -1) {
+      writable[key] = (item[key] as PersonValue)?.EMail || '';
+    } else if (MULTI_PERSON_FIELDS.indexOf(key) !== -1) {
+      const list = (item[key] as PersonValue[]) || [];
+      writable[key] = list.map((u) => u?.EMail || '').filter((e) => e.length > 0);
+    } else if (BOOL_FIELDS.indexOf(key) !== -1) {
+      writable[key] = !!item[key];
+    } else {
+      const value = item[key];
+      if (value === null || value === undefined) {
+        writable[key] = '';
+      } else if (DATE_FIELDS.indexOf(key) !== -1 && typeof value === 'string') {
+        writable[key] = value.slice(0, 10); // ISO → YYYY-MM-DD для input type=date
+      } else {
+        writable[key] = String(value);
+      }
+    }
+  });
+
+  return {
+    data,
+    status: (item.RequestStatus as string) || '',
+    code: (item.RequestUniqueCode as string) || ''
+  };
+}

src/webparts/requestPortal/forms/RecruitingSelection/provisioning.json

@@ -2,6 +2,7 @@
   "dataListTitle": "Заявка на подбор — данные",
   "columns": [
     { "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
+    { "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
     { "internalName": "Responsible", "title": "Ответственный за подачу заявки", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
     { "internalName": "SubmitDate", "title": "Дата подачи заявки", "type": "DateTime", "dateOnly": true },
     { "internalName": "IsRegistered", "title": "Зарегистрирована", "type": "Boolean" },

src/webparts/requestPortal/forms/RecruitingSelection/submit.ts

@@ -1,10 +1,12 @@
 import { getSP } from '../../shared/pnp/pnpjs';
+import { ApprovalListService, IApproverToWrite, writeRoute } from '../../shared/approval';
 import { buildRequestUniqueCode } from '../../shared/requestCode';
 import { IFormData } from './model';
 
-const LIST_TITLE = 'Заявка на подбор — данные';
+export const DATA_LIST_TITLE = 'Заявка на подбор — данные';
+export const APPROVAL_LIST_TITLE = 'Заявка на подбор — согласование';
 // Тип заявки во внешнем approval-route API (GET /api/request-types → id 4).
-const RECRUITING_SELECTION_REQUEST_TYPE_ID = 4;
+export const RECRUITING_SELECTION_REQUEST_TYPE_ID = 4;
 
 // Поля-люди (один человек): логин → ensureUser → Id в колонку <Field>Id.
 const PERSON_FIELDS: (keyof IFormData)[] = ['Responsible', 'ProposedMentor', 'DirectManager'];
@@ -13,18 +15,20 @@ const MULTI_PERSON_FIELDS: (keyof IFormData)[] = ['HiringDecisionMaker'];
 // Числовые поля: пустая строка → null, иначе Number().
 const NUMBER_FIELDS: (keyof IFormData)[] = ['DepartmentHeadcount', 'RateProbation', 'RateAfterProbation'];
 
+/** Экземпляр сервиса списка согласования этой формы. */
+export function selectionApprovalService(): ApprovalListService {
+  return new ApprovalListService(APPROVAL_LIST_TITLE);
+}
+
 /** Логин → числовой Id пользователя на текущем сайте. */
 async function resolveUserId(login: string): Promise<number> {
   const ensured = await getSP().web.ensureUser(login); // v4: возвращает ISiteUserInfo с .Id
   return ensured.Id;
 }
 
-/** Записать заявку «на подбор» в список данных SharePoint. Возвращает уникальный код заявки. */
-export async function submitRecruitingSelection(data: IFormData): Promise<string> {
-  const sp = getSP();
+/** Скалярные/числовые/да-нет поля из модели (людей и статус пропускаем — они отдельно). */
+function buildScalarBody(data: IFormData): Record<string, unknown> {
   const item: Record<string, unknown> = {};
-
-  // Текст/заметки/выбор/даты/да-нет/числа (людей пропускаем — они ниже).
   (Object.keys(data) as (keyof IFormData)[]).forEach((key) => {
     if (PERSON_FIELDS.indexOf(key) !== -1 || MULTI_PERSON_FIELDS.indexOf(key) !== -1) {
       return;
@@ -38,29 +42,61 @@ export async function submitRecruitingSelection(data: IFormData): Promise<string
       item[key] = value === '' ? null : value;
     }
   });
+  return item;
+}
 
-  // Один человек → <Field>Id.
+/** Дописать в тело поля-люди: один человек → <Field>Id, несколько → массив Id. Пусто → очистка. */
+async function applyPeople(item: Record<string, unknown>, data: IFormData): Promise<void> {
   for (let i = 0; i < PERSON_FIELDS.length; i++) {
     const login = data[PERSON_FIELDS[i]] as string;
-    if (login) {
-      item[`${PERSON_FIELDS[i]}Id`] = await resolveUserId(login);
+    item[`${PERSON_FIELDS[i]}Id`] = login ? await resolveUserId(login) : null;
   }
-  }
-
-  // Несколько человек → <Field>Id = массив Id.
   for (let i = 0; i < MULTI_PERSON_FIELDS.length; i++) {
-    const logins = data[MULTI_PERSON_FIELDS[i]] as string[];
+    const logins = (data[MULTI_PERSON_FIELDS[i]] as string[]) || [];
     const ids: number[] = [];
     for (let j = 0; j < logins.length; j++) {
       ids.push(await resolveUserId(logins[j]));
     }
     item[`${MULTI_PERSON_FIELDS[i]}Id`] = ids;
   }
-
-  const added = await sp.web.lists.getByTitle(LIST_TITLE).items.add(item);
-  const id = (added as { Id: number }).Id;
-  // Код известен только после создания элемента (нужен его Id).
-  const code = buildRequestUniqueCode(RECRUITING_SELECTION_REQUEST_TYPE_ID, id, new Date());
-  await sp.web.lists.getByTitle(LIST_TITLE).items.getById(id).update({ RequestUniqueCode: code });
-  return code;
+}
+
+export interface ISaveResult {
+  id: number;
+  /** Задан только при создании новой заявки (существующий код не меняется). */
+  code?: string;
+}
+
+/**
+ * Сохранить заявку «на подбор»: содержимое + маршрут согласования.
+ * existingId задан → обновляем ту же запись (черновик/доработка), иначе создаём новую.
+ * status = «Черновик» (сохранение) или «На согласовании» (отправка). Фазы исполнения
+ * нет — writeRoute вызывается с пустым списком исполнителей. Возвращает Id (+ код при создании).
+ */
+export async function saveSelectionRequest(
+  existingId: number | undefined,
+  data: IFormData,
+  approvers: IApproverToWrite[],
+  status: string
+): Promise<ISaveResult> {
+  const list = getSP().web.lists.getByTitle(DATA_LIST_TITLE);
+  const item = buildScalarBody(data);
+  item.RequestStatus = status;
+  await applyPeople(item, data);
+
+  let id: number;
+  let code: string | undefined;
+  if (existingId) {
+    await list.items.getById(existingId).update(item);
+    id = existingId;
+  } else {
+    const added = await list.items.add(item);
+    id = (added as { Id: number }).Id;
+    // Код известен только после создания элемента (нужен его Id).
+    code = buildRequestUniqueCode(RECRUITING_SELECTION_REQUEST_TYPE_ID, id, new Date());
+    await list.items.getById(id).update({ RequestUniqueCode: code });
+  }
+
+  await writeRoute(selectionApprovalService(), id, approvers, [], status);
+  return { id, code };
 }

src/webparts/requestPortal/forms/viewRegistry.ts

@@ -13,6 +13,9 @@ type ViewComponent = React.ComponentType<IApprovalViewProps>;
  * Добавить просмотр = создать <Форма>View.tsx + строка здесь.
  */
 const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
+  'recruiting-selection': React.lazy(
+    () => import(/* webpackChunkName: 'view-recruiting-selection' */ './RecruitingSelection/RecruitingSelectionView')
+  ),
   'recruiting-hire': React.lazy(
     () => import(/* webpackChunkName: 'view-recruiting-hire' */ './RecruitingHire/RecruitingHireView')
   ),