feat: added optin to add delegant for executor and change delegant

This commit is contained in:
Тимур Городецкий
2026-08-10 13:55:05 +05:00
parent 3a15d83ded
commit 99f0946968
23 changed files with 407 additions and 40 deletions
@@ -25,6 +25,7 @@ const FIELDS = {
// скрытое системное поле SharePoint (не видно в UI списка).
allowReassign: 'AllowReassignToOtherApprovers', // «Можно перепоручать» (Да/Нет)
phase: 'Phase', // «Фаза» (Choice): Согласование | Исполнение
delegatedBy: 'DelegatedBy', // «Кем переназначено» (User) → DelegatedById
};
// Согласующий для записи в список.
@@ -140,12 +141,16 @@ export class ApprovalListService {
}
// Добавляет одну строку согласования с заданным Order (для делегата).
// delegatedById — Id пользователя, который выполнил переназначение (не строки
// из маршрута — у них делегата нет). Он сохраняет право переназначить эту
// строку ещё раз, если делегат недоступен (см. ApproverService.delegate).
public async addApproverRow(
requestId: number,
approver: IApproverToWrite,
order: number,
status: string,
phase: string = APPROVAL_PHASE.approval
phase: string = APPROVAL_PHASE.approval,
delegatedById?: number
): Promise<void> {
const approverId = await this.resolveUserId(approver.email);
await this.list().items.add({
@@ -156,6 +161,7 @@ export class ApprovalListService {
[FIELDS.order]: order,
[FIELDS.allowReassign]: approver.allowReassign,
[FIELDS.phase]: phase,
...(delegatedById ? { [`${FIELDS.delegatedBy}Id`]: delegatedById } : {}),
});
}
@@ -163,12 +169,21 @@ export class ApprovalListService {
public async getForRequest(requestId: number): Promise<IApprovalRow[]> {
const rows = (await this.list()
.items.filter(`${FIELDS.ticket}Id eq ${requestId}`)
.select('Id', FIELDS.status, FIELDS.order, FIELDS.allowReassign, FIELDS.phase, `${FIELDS.approver}/Id`)
.expand(FIELDS.approver)
.select(
'Id',
FIELDS.status,
FIELDS.order,
FIELDS.allowReassign,
FIELDS.phase,
`${FIELDS.approver}/Id`,
`${FIELDS.delegatedBy}/Id`
)
.expand(FIELDS.approver, FIELDS.delegatedBy)
.orderBy(FIELDS.order, true)()) as Array<Record<string, unknown>>;
return rows.map((r) => {
const approver = r[FIELDS.approver] as { Id?: number } | undefined;
const delegatedBy = r[FIELDS.delegatedBy] as { Id?: number } | undefined;
return {
id: r.Id as number,
status: (r[FIELDS.status] as string) || '',
@@ -177,6 +192,7 @@ export class ApprovalListService {
allowReassign: (r[FIELDS.allowReassign] as boolean) ?? false,
// Пустая фаза (старые строки без колонки) трактуется как «Согласование».
phase: (r[FIELDS.phase] as string) || APPROVAL_PHASE.approval,
delegatedById: delegatedBy?.Id ?? 0,
};
});
}
@@ -34,7 +34,8 @@ export async function resolveRoute(
context: WebPartContext,
requestTypeId: number,
userEmail: string,
status: ApprovalStatus = 'Approval'
status: ApprovalStatus = 'Approval',
departmentId: string | null = null
): Promise<IResolvedRoute> {
const c = await client(context);
const url = `${APPROVAL_API_BASE_URL}/api/template-routes/resolve`;
@@ -50,7 +51,8 @@ export async function resolveRoute(
userEmail,
projectId: null,
status,
fieldValues: []
fieldValues: [],
departmentId: departmentId || null
})
});
if (!response.ok) {
@@ -8,15 +8,17 @@ import { APPROVAL_PHASE, REQUEST_STATUS } from './models/statuses';
// Планируемый маршрут для НОВОЙ заявки: resolve по email инициатора → строки матрицы.
// status выбирает фазу: 'Approval' (согласующие, по умолчанию) или 'Execution'
// (исполнители). Имена подтягиваются по executorEmail (бэкенд отдаёт email + должность).
// departmentId — Id отдела из справочника (влияет на маршрут, если он различается по отделу).
export async function getPlannedMatrix(
context: WebPartContext,
requestTypeId: number,
userEmail: string,
approval: ApprovalListService,
status: ApprovalStatus = 'Approval'
status: ApprovalStatus = 'Approval',
departmentId?: string | null
): Promise<IMatrixRow[]> {
if (!userEmail) return [];
const route = await resolveRoute(context, requestTypeId, userEmail, status);
const route = await resolveRoute(context, requestTypeId, userEmail, status, departmentId);
const phase = status === 'Execution' ? APPROVAL_PHASE.execution : APPROVAL_PHASE.approval;
const ordered = route.steps.slice().sort((a, b) => a.orderNo - b.orderNo);
return Promise.all(
@@ -11,6 +11,13 @@ import { emitRequestsChanged } from '../requestEvents';
// approve/return/reject — согласующий; execute — исполнитель отметил «Выполнено».
export type ApproverDecision = 'approve' | 'return' | 'reject' | 'execute';
// Активная строка текущего пользователя: либо он сам назначен на неё
// (isDelegator=false), либо это его делегат недоступен (в отпуске и т.п.) и он,
// как делегировавший, вправе переназначить шаг ещё раз (isDelegator=true).
export interface IPendingRow extends IApprovalRow {
isDelegator: boolean;
}
// Решение → статус его строки в списке согласования.
const ROW_STATUS: Record<ApproverDecision, string> = {
approve: REQUEST_STATUS.approved,
@@ -35,7 +42,12 @@ export class ApproverService {
// Очередь уже проставлена на запись (см. createSteps/advanceQueue) — активна
// ровно одна строка со статусом «На согласовании» на фазу, искать «первую по
// порядку» не нужно.
public async getPendingRowForCurrentUser(requestId: number): Promise<IApprovalRow | undefined> {
//
// Если пользователь сам не назначен на активную строку, но именно он когда-то
// делегировал её текущему держателю (delegatedById) — строка тоже считается
// «его», но с isDelegator=true: DecisionPanel в этом случае даёт только
// переназначить (не решать за делегата), см. её использование там.
public async getPendingRowForCurrentUser(requestId: number): Promise<IPendingRow | undefined> {
const rows = await this.approval.getForRequest(requestId);
const userId = await this.approval.getCurrentUserId();
// Активные строки текущего шага: согласующий («На согласовании») или, когда
@@ -45,11 +57,17 @@ export class ApproverService {
const active = rows.filter(
(r) => r.status === REQUEST_STATUS.onApproval || r.status === REQUEST_STATUS.onExecution
);
return active.filter((r) => r.approverId === userId)[0];
const own = active.filter((r) => r.approverId === userId)[0];
if (own) return { ...own, isDelegator: false };
const delegated = active.filter((r) => r.delegatedById === userId)[0];
return delegated ? { ...delegated, isDelegator: true } : undefined;
}
// Делегирование: согласующий добавляет делеганта ПЕРЕД собой (Order — между
// предыдущей строкой и своей). Делегат согласует раньше и сам не делегирует.
// предыдущей строкой и своей). Делегат согласует раньше и сам не делегирует
// (allowReassign всегда false у новой строки) — зато делегировавший (текущий
// пользователь) сохраняет право переназначить эту строку ещё раз, если делегат
// тоже окажется недоступен (см. getPendingRowForCurrentUser/isDelegator).
public async delegate(
requestId: number,
currentRowId: number,
@@ -62,6 +80,7 @@ export class ApproverService {
const prevOrder = before.length > 0 ? before[before.length - 1].order : current.order - 1;
const newOrder = (prevOrder + current.order) / 2;
const position = await this.approval.getJobTitle(user.loginName);
const delegatedById = await this.approval.getCurrentUserId();
// Делегат наследует фазу той строки, вместо которой согласует (согласование/исполнение).
// Обе строки — делегат и прежний согласующий — уходят в «Ждёт очереди»,
// activateNextQueued затем активирует делегата (у него меньший order).
@@ -70,7 +89,8 @@ export class ApproverService {
{ email: user.email, position, allowReassign: false },
newOrder,
REQUEST_STATUS.queued,
current.phase
current.phase,
delegatedById
);
await this.approval.setStatus(current.id, REQUEST_STATUS.queued);
await this.approval.activateNextQueued(requestId);
@@ -22,7 +22,7 @@ export { getRequestTypes, resolveRoute } from './approvalRoute.service';
export { ApprovalListService } from './approvalList.service';
export type { IApproverToWrite } from './approvalList.service';
export { ApproverService } from './approverDecision.service';
export type { ApproverDecision } from './approverDecision.service';
export type { ApproverDecision, IPendingRow } from './approverDecision.service';
export { getPlannedMatrix, writeApprovers, writeRoute } from './approvalSubmission.service';
export { notifyActiveStep } from './notify.service';
export type { INotifyTarget } from './notify.service';
@@ -6,4 +6,8 @@ export interface IApprovalRow {
order: number; // колонка Order (очередь согласования)
allowReassign: boolean; // AllowReassignToOtherApprovers
phase: string; // Phase: «Согласование» | «Исполнение» (см. APPROVAL_PHASE)
/** Id пользователя сайта, который делегировал ЭТУ строку (DelegatedBy). 0 — строка не делегирована
* (пришла из маршрута напрямую). Позволяет делегировавшему переназначить шаг ещё раз,
* если делегат недоступен (например, в отпуске) — см. ApproverService.getPendingRowForCurrentUser. */
delegatedById: number;
}
@@ -24,6 +24,13 @@
margin-top: 16px;
}
// Блок переназначения (делегирования) — отделён от кнопок решения тонкой линией.
.delegate {
margin-top: 16px;
padding-top: 16px;
border-top: 1px solid $gray-200;
}
.state {
margin-top: 16px;
padding: 24px;
@@ -2,8 +2,10 @@ import * as React from 'react';
import { useState, useEffect } from 'react';
import styles from './DecisionPanel.module.scss';
import { Button, Alert, FormField, TextArea, Icon } from '../../ui';
import { ApproverService, ApproverDecision } from '../approverDecision.service';
import { ApproverService, ApproverDecision, IPendingRow } from '../approverDecision.service';
import { APPROVAL_PHASE } from '../models/statuses';
import { ISiteUser } from '../models/ISiteUser';
import { UserPicker } from './UserPicker';
interface IDecisionPanelProps {
service: ApproverService;
@@ -14,22 +16,31 @@ interface IDecisionPanelProps {
/** Выполнить ПЕРЕД применением решения (напр. сохранить поля, заполненные
* согласующим). Если бросит — решение не применяется, показывается ошибка. */
onBeforeDecide?: () => Promise<void>;
/** Поиск пользователей — нужен для переназначения (делегирования). Без него
* кнопка «Переназначить» не показывается. */
search?: (query: string) => Promise<ISiteUser[]>;
/** Вызывается после успешного переназначения (обновить экран/матрицу). */
onDelegated?: () => void;
}
// Панель решения согласующего: проверяет, его ли сейчас очередь, и если да —
// показывает комментарий и кнопки Согласовать / Вернуть / Отклонить.
// Панель решения текущего шага: согласующий (Согласовать/Вернуть/Отклонить) или
// исполнитель («Выполнено»). Если у шага разрешено переназначение (allowReassign)
// — можно передать шаг другому сотруднику (делегат встаёт перед текущим).
export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
service,
requestId,
onDecided,
onBeforeDecide,
search,
onDelegated,
}) => {
const [checking, setChecking] = useState<boolean>(true);
const [rowId, setRowId] = useState<number | undefined>(undefined);
const [phase, setPhase] = useState<string>(APPROVAL_PHASE.approval);
const [pendingRow, setPendingRow] = useState<IPendingRow | undefined>(undefined);
const [comment, setComment] = useState<string>('');
const [submitting, setSubmitting] = useState<boolean>(false);
const [resultStatus, setResultStatus] = useState<string | undefined>(undefined);
const [delegated, setDelegated] = useState<boolean>(false);
const [showDelegate, setShowDelegate] = useState<boolean>(false);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
@@ -39,16 +50,13 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
.getPendingRowForCurrentUser(requestId)
.then((row) => {
if (alive) {
setRowId(row?.id);
if (row) {
setPhase(row.phase);
}
setPendingRow(row);
setChecking(false);
}
})
.catch((e) => {
if (alive) {
setError(`Не удалось проверить очередь согласования: ${(e as Error).message}`);
setError(`Не удалось проверить очередь: ${(e as Error).message}`);
setChecking(false);
}
});
@@ -58,7 +66,7 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
}, [requestId, service]);
async function decide(decision: ApproverDecision): Promise<void> {
if (rowId === undefined) {
if (!pendingRow) {
return;
}
if ((decision === 'return' || decision === 'reject') && comment.trim().length === 0) {
@@ -68,11 +76,10 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
setError(null);
setSubmitting(true);
try {
// Сохраняем правки согласующего (если есть) ДО применения решения.
if (onBeforeDecide) {
await onBeforeDecide();
}
const status = await service.decide(requestId, rowId, decision, comment.trim());
const status = await service.decide(requestId, pendingRow.id, decision, comment.trim());
setResultStatus(status);
setSubmitting(false);
if (onDecided) {
@@ -84,14 +91,46 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
}
}
async function handleDelegate(user: ISiteUser): Promise<void> {
if (!pendingRow) {
return;
}
setError(null);
setSubmitting(true);
try {
await service.delegate(requestId, pendingRow.id, user);
setDelegated(true);
setSubmitting(false);
if (onDelegated) {
onDelegated();
}
} catch (e) {
setError(`Не удалось переназначить: ${(e as Error).message}`);
setSubmitting(false);
}
}
const phase = pendingRow?.phase ?? APPROVAL_PHASE.approval;
const isExecution = phase === APPROVAL_PHASE.execution;
// Делегировавший переназначает вне зависимости от allowReassign строки — это
// его собственное право (создал шаг — может его поправить), а не право делегата.
const canDelegate = !!search && !!pendingRow && (pendingRow.isDelegator || pendingRow.allowReassign);
const isDelegator = !!pendingRow?.isDelegator;
// Пока проверяем очередь или если действий нет (не твоя очередь / заявка
// обработана / тебя нет в маршруте) — панель не показываем вовсе.
if (checking || rowId === undefined) {
if (checking || !pendingRow) {
return null;
}
if (delegated) {
return (
<div className={styles.panel}>
<Alert variant="ok">Шаг переназначен — заявка передана выбранному сотруднику.</Alert>
</div>
);
}
if (resultStatus) {
return (
<div className={styles.panel}>
@@ -103,9 +142,42 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
);
}
// Фаза исполнения: одно действие «Выполнено» (без обязательного комментария),
// строка помечается как «Согласовано» → computeRequestStatus переведёт заявку в
// «Выполнение»/«Закрыта».
// Блок переназначения — общий для согласующего и исполнителя (когда разрешено).
const delegateBlock = canDelegate ? (
<div className={styles.delegate}>
{showDelegate ? (
<FormField label="Кому переназначить">
<UserPicker
search={search}
onPick={handleDelegate}
placeholder="Начните вводить ФИО сотрудника…"
/>
</FormField>
) : (
<Button variant="secondary" disabled={submitting} onClick={() => setShowDelegate(true)}>
<Icon name="people" size="sm" />
Переназначить
</Button>
)}
</div>
) : null;
// Строка сейчас у делегата, а не у самого пользователя — решать за делегата
// нельзя, только переназначить (если он, например, недоступен — в отпуске).
if (isDelegator) {
return (
<div className={styles.panel}>
<div className={styles.title}>{isExecution ? 'Исполнение' : 'Ваше решение'}</div>
<Alert variant="warn">
Этот шаг сейчас у сотрудника, которому вы его переназначили. Если он недоступен —
переназначьте шаг ещё раз.
</Alert>
{error && <Alert variant="err">{error}</Alert>}
{delegateBlock}
</div>
);
}
if (isExecution) {
return (
<div className={styles.panel}>
@@ -125,6 +197,7 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
Выполнено
</Button>
</div>
{delegateBlock}
</div>
);
}
@@ -155,6 +228,7 @@ export const DecisionPanel: React.FC<IDecisionPanelProps> = ({
Отклонить
</Button>
</div>
{delegateBlock}
</div>
);
};