feat: форма «Заявка на оплату» (СТ/потребность, счёт через OCR и ИИ) #27
@@ -52,6 +52,7 @@
|
||||
| [`hr-business-trip`](../src/webparts/requestPortal/forms/BusinessTrip/README.md) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; маршрут лентой (точки = город + объект из справочника + даты, участки с видом транспорта); задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
|
||||
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
||||
| [`wh-service-request`](../src/webparts/requestPortal/forms/ServiceRequest/README.md) | Заявка на услуги | Склад / Снабжение | да | нет | да | маршрут по проекту (руководитель проекта/ПТО); табличные части «Приложения» и «Смета» (JSON-колонки); сумма по смете считается на лету (qty × цена), итог дублируется числовой колонкой для отчётов | ✅ |
|
||||
| [`acc-payment-request`](../src/webparts/requestPortal/forms/PaymentRequest/README.md) | Заявка на оплату | Бухгалтерия | да | нет | да | основание — согласованная СТ (сайт СТ) или потребность; счёт PDF → библиотека → OCR → ИИ (реквизиты, суммы, позиции); сверка позиций счёта с СТ; подсветка чужого получателя и превышения общей суммы СТ; справочники 1С | ⏳ код готов, списки/библиотека/тип/маршрут не заведены |
|
||||
|
||||
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
||||
**Просмотр** — есть режим согласующего (`<Форма>View`).
|
||||
|
||||
@@ -53,6 +53,12 @@ export const REQUEST_TYPES: IRequestType[] = [
|
||||
title: 'Заявка на услуги',
|
||||
icon: 'document'
|
||||
},
|
||||
{
|
||||
id: 'acc-payment-request',
|
||||
categoryId: 'accounting',
|
||||
title: 'Заявка на оплату',
|
||||
icon: 'calculator'
|
||||
},
|
||||
{
|
||||
id: 'wh-concrete-request',
|
||||
categoryId: 'warehouse',
|
||||
|
||||
@@ -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,328 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useMemo, useCallback, useEffect } from 'react';
|
||||
import styles from './PaymentRequestForm.module.scss';
|
||||
import {
|
||||
Alert,
|
||||
CollapseSection,
|
||||
FormCard,
|
||||
InitiatorLine,
|
||||
FormModeProvider,
|
||||
Icon,
|
||||
RequestNumber,
|
||||
SubmitActions,
|
||||
getDraftDeleteHandler,
|
||||
useRequestSubmit
|
||||
} from '../../shared/ui';
|
||||
import {
|
||||
composeRemoveRowRule,
|
||||
ApprovalMatrix,
|
||||
ApprovalHistory,
|
||||
StatusBadge,
|
||||
useMatrixEditor,
|
||||
getPlannedMatrix,
|
||||
loadRoutePhase,
|
||||
isOpenedRouteReady,
|
||||
notifyActiveStep,
|
||||
useRequestTypeId,
|
||||
REQUEST_STATUS,
|
||||
isEditableStatus,
|
||||
IApproverToWrite,
|
||||
unassignedStepMessage,
|
||||
resolveWriteListId,
|
||||
useFormExecutors,
|
||||
ExecutorsMatrix,
|
||||
executorsToWrite,
|
||||
initialSubmitStatus
|
||||
} from '../../shared/approval';
|
||||
import { effectiveUserEmail } from '../../shared/impersonation';
|
||||
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { todayIsoDate } from '../../shared/dateUtils';
|
||||
import { IRequestFormProps } from '../../models/types';
|
||||
import { approvalListTitle, approvalListTitleForListId, dataListTitle, dataListTitleForListId } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { savePaymentRequest, paymentRequestApprovalService } from './submit';
|
||||
import { loadPaymentRequest } from './load';
|
||||
import { validatePayment } from './validation';
|
||||
import { useBasisSelection } from './useBasisSelection';
|
||||
import { useInvoiceFlow } from './useInvoiceFlow';
|
||||
import { HeaderSection } from './sections/HeaderSection';
|
||||
import { BasisSection } from './sections/BasisSection';
|
||||
import { PaymentSection } from './sections/PaymentSection';
|
||||
import { AmountsSection } from './sections/AmountsSection';
|
||||
import { InvoiceSection } from './sections/InvoiceSection';
|
||||
import { PositionsSection } from './sections/PositionsSection';
|
||||
|
||||
const PaymentRequestForm: React.FC<IRequestFormProps> = ({
|
||||
requestType,
|
||||
context,
|
||||
onCancel,
|
||||
onSaved,
|
||||
editId,
|
||||
editListId,
|
||||
onCodeLoaded
|
||||
}) => {
|
||||
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 }));
|
||||
const patch = useCallback((changes: Partial<IFormData>): void => setData((prev) => ({ ...prev, ...changes })), []);
|
||||
|
||||
const basis = useBasisSelection(context, patch, requestId);
|
||||
const invoice = useInvoiceFlow(context, data, patch);
|
||||
|
||||
// Новая заявка — предзаполняем заявителя текущим пользователем и дату сегодняшней.
|
||||
useEffect(() => {
|
||||
if (editId) return undefined;
|
||||
const requesterEmail = effectiveUserEmail(context);
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
RequesterEmail: requesterEmail,
|
||||
RequesterName: context.pageContext.user.displayName || '',
|
||||
RequestDate: prev.RequestDate || todayIsoDate()
|
||||
}));
|
||||
let alive = true;
|
||||
getEmployeeOrganizations(context, requesterEmail)
|
||||
.then((records) => {
|
||||
if (alive) {
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
Organization: formatEmployeeOrganizations(records),
|
||||
RequesterJobTitle: prev.RequesterJobTitle || records[0]?.position || '',
|
||||
Department: prev.Department || records[0]?.section || '',
|
||||
DepartmentId: prev.DepartmentId || records[0]?.departmentId || ''
|
||||
}));
|
||||
}
|
||||
})
|
||||
.catch(() => undefined);
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [editId, context]);
|
||||
|
||||
// Выбор другого заявителя подтягивает его ФИО, должность, подразделение и организации.
|
||||
const handleRequesterChange = (login: string): void => {
|
||||
patch({ RequesterEmail: login });
|
||||
if (!login) {
|
||||
patch({ Organization: '' });
|
||||
return;
|
||||
}
|
||||
getEmployeeOrganizations(context, login)
|
||||
.then((records) =>
|
||||
setData((prev) => ({
|
||||
...prev,
|
||||
RequesterName: records[0]?.fio || prev.RequesterName,
|
||||
RequesterJobTitle: records[0]?.position || prev.RequesterJobTitle,
|
||||
Department: records[0]?.section || prev.Department,
|
||||
DepartmentId: records[0]?.departmentId || prev.DepartmentId,
|
||||
Organization: formatEmployeeOrganizations(records)
|
||||
}))
|
||||
)
|
||||
.catch(() => undefined);
|
||||
};
|
||||
|
||||
// Открыта СВОЯ заявка на редактирование — подгружаем содержимое и статус.
|
||||
useEffect(() => {
|
||||
if (!editId) return undefined;
|
||||
let alive = true;
|
||||
loadPaymentRequest(editId, editListId)
|
||||
.then((loaded) => {
|
||||
if (!alive) return;
|
||||
setData(loaded.data);
|
||||
setRequestStatus(loaded.status);
|
||||
setRequestCode(loaded.code || undefined);
|
||||
if (loaded.code) onCodeLoaded?.(loaded.code);
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) submit.setError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [editId, editListId]);
|
||||
|
||||
const approval = useMemo(() => paymentRequestApprovalService(editListId), [editListId]);
|
||||
const userEmail = data.RequesterEmail;
|
||||
const requestTypeIdState = useRequestTypeId(context, requestType.id);
|
||||
const requestTypeId = requestTypeIdState.id;
|
||||
// Маршрут зависит от проекта — пока он не выбран, resolve вернёт 404.
|
||||
const projectId = data.ProjectId || null;
|
||||
const matrixReady =
|
||||
isOpenedRouteReady(editId, requestStatus, requestTypeId) && (!!editId || (!!userEmail && !!projectId && !!requestTypeId));
|
||||
const loadMatrix = useCallback(
|
||||
() =>
|
||||
loadRoutePhase(approval, editId, requestStatus, 'Approval', () =>
|
||||
getPlannedMatrix(context, requestTypeId as number, userEmail, approval, 'Approval', null, undefined, projectId)
|
||||
),
|
||||
[context, userEmail, approval, editId, requestStatus, projectId, requestTypeId]
|
||||
);
|
||||
const matrix = useMatrixEditor(loadMatrix, `${userEmail}-${editId ?? 'new'}-${projectId}`, !readOnly, matrixReady, (login) =>
|
||||
approval.getJobTitle(login)
|
||||
);
|
||||
const executors = useFormExecutors({
|
||||
readOnly,
|
||||
context,
|
||||
approval,
|
||||
requestTypeId,
|
||||
userEmail: matrixReady ? userEmail : '',
|
||||
editId,
|
||||
requestStatus,
|
||||
projectId
|
||||
});
|
||||
|
||||
const formError = validatePayment(data);
|
||||
const isValid = !formError;
|
||||
const validate = (): string | undefined => {
|
||||
if (formError) return formError;
|
||||
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 }));
|
||||
|
||||
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
|
||||
const rtId = requestTypeId;
|
||||
if (!rtId) {
|
||||
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
|
||||
}
|
||||
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
|
||||
const { id, code } = await savePaymentRequest(requestId, rtId, data, toApprovers(matrix.rows), executorsToWrite(executors.rows), status, writeListId);
|
||||
setRequestId(id);
|
||||
setRequestStatus(status);
|
||||
if (code) setRequestCode(code);
|
||||
if (onSaved) onSaved();
|
||||
if (status === REQUEST_STATUS.onApproval || status === REQUEST_STATUS.execution) {
|
||||
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 error = validate();
|
||||
if (error) return error;
|
||||
if (matrix.error) {
|
||||
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
|
||||
}
|
||||
return (
|
||||
unassignedStepMessage(
|
||||
matrix.rows,
|
||||
(r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
|
||||
) ||
|
||||
unassignedStepMessage(
|
||||
executors.rows,
|
||||
(r) => `Шаг ${r.order} исполнения («${r.position || 'без должности'}») без назначенного человека — обратитесь к администратору маршрута.`
|
||||
)
|
||||
);
|
||||
};
|
||||
|
||||
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
|
||||
const handleSubmit = (): Promise<void> =>
|
||||
submit.run(
|
||||
'submit',
|
||||
save(executors.rows.length > 0 ? initialSubmitStatus(matrix.rows.length, executors.rows.length) : REQUEST_STATUS.onApproval),
|
||||
validateSubmit
|
||||
);
|
||||
|
||||
const sectionProps = { data, set, patch, context, onRequesterChange: handleRequesterChange };
|
||||
|
||||
const handleDelete = getDraftDeleteHandler({
|
||||
formKey: FORM_ID,
|
||||
requestId,
|
||||
requestStatus,
|
||||
listId: editListId,
|
||||
code: requestCode,
|
||||
submit,
|
||||
onDeleted: onCancel
|
||||
});
|
||||
|
||||
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}
|
||||
fallback={{ name: data.RequesterName, email: data.RequesterEmail }}
|
||||
/>
|
||||
}
|
||||
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}>
|
||||
<HeaderSection {...sectionProps} />
|
||||
<CollapseSection title="Основание" icon="document">
|
||||
<BasisSection {...sectionProps} basis={basis} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Вложения — счёт на оплату" icon="document">
|
||||
<InvoiceSection data={data} invoice={invoice} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Реквизиты платежа" icon="calculator">
|
||||
<PaymentSection {...sectionProps} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Суммы" icon="calculator">
|
||||
<AmountsSection {...sectionProps} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Позиции" icon="clipboard">
|
||||
<PositionsSection rows={data.Positions} compared={!!data.InvoiceFileName} />
|
||||
</CollapseSection>
|
||||
</FormModeProvider>
|
||||
|
||||
<ApprovalMatrix
|
||||
editor={matrix}
|
||||
canRemoveRow={composeRemoveRowRule(effectiveUserEmail(context))}
|
||||
search={(q) => approval.searchUsers(q)}
|
||||
waiting={!matrixReady}
|
||||
waitingText="Укажите заявителя и проект, чтобы построить маршрут согласования."
|
||||
/>
|
||||
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
|
||||
|
||||
{editId && (
|
||||
<div className="rp-no-print">
|
||||
<ApprovalHistory approval={approval} dataListRef={editListId || dataListTitle(FORM_ID)} requestId={editId} reloadKey={requestStatus} />
|
||||
</div>
|
||||
)}
|
||||
|
||||
<SubmitActions
|
||||
onDelete={handleDelete}
|
||||
submit={submit}
|
||||
isValid={isValid}
|
||||
readOnly={readOnly}
|
||||
onCancel={onCancel}
|
||||
onSaveDraft={handleSaveDraft}
|
||||
onSubmit={handleSubmit}
|
||||
/>
|
||||
</FormCard>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default PaymentRequestForm;
|
||||
@@ -0,0 +1,17 @@
|
||||
@import '../../../../styles/design-tokens';
|
||||
|
||||
.state {
|
||||
padding: $sp-8;
|
||||
color: $gray-500;
|
||||
font-size: $fs-sm;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.toolbar {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
justify-content: flex-end;
|
||||
gap: $sp-3;
|
||||
margin-bottom: $sp-4;
|
||||
}
|
||||
@@ -0,0 +1,197 @@
|
||||
import * as React from 'react';
|
||||
import { useState, useEffect, useMemo } from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import styles from './PaymentRequestView.module.scss';
|
||||
import {
|
||||
Alert,
|
||||
Button,
|
||||
CollapseSection,
|
||||
FormCard,
|
||||
InitiatorLine,
|
||||
FormModeProvider,
|
||||
PrintSplitButton,
|
||||
OrgLetterhead,
|
||||
Icon
|
||||
} from '../../shared/ui';
|
||||
import { navigate } from '../../shared/routing';
|
||||
import {
|
||||
ApproverService,
|
||||
DecisionPanel,
|
||||
StatusBadge,
|
||||
ApprovalMatrix,
|
||||
ApprovalHistory,
|
||||
useMatrixEditor,
|
||||
useViewExecutors,
|
||||
ExecutorsMatrix,
|
||||
approvalPhaseRows,
|
||||
notifyActiveStep,
|
||||
useRequestTypeId,
|
||||
isEditableStatus
|
||||
} from '../../shared/approval';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { useStableCallback } from '../../shared/useStableCallback';
|
||||
import { approvalListTitle, approvalListTitleForListId, dataListTitle, dataListTitleForListId } from '../../shared/listTitles';
|
||||
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
|
||||
import { loadPaymentRequest } from './load';
|
||||
import { paymentRequestApprovalService } from './submit';
|
||||
import { HeaderSection } from './sections/HeaderSection';
|
||||
import { PaymentSection } from './sections/PaymentSection';
|
||||
import { AmountsSection } from './sections/AmountsSection';
|
||||
import { InvoiceSection } from './sections/InvoiceSection';
|
||||
import { PositionsSection } from './sections/PositionsSection';
|
||||
import { IInvoiceFlow } from './useInvoiceFlow';
|
||||
|
||||
interface IPaymentRequestViewProps {
|
||||
context: WebPartContext;
|
||||
itemId: number;
|
||||
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
|
||||
formKey: string;
|
||||
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
|
||||
listId?: string;
|
||||
/** Уведомление о загруженном уникальном коде заявки — см. IApprovalViewProps.onCodeLoaded. */
|
||||
onCodeLoaded?: (code: string) => void;
|
||||
}
|
||||
|
||||
/** В просмотре счёт не загружается: поток нужен только секции как заглушка пропсов. */
|
||||
const IDLE_INVOICE: IInvoiceFlow = { stage: 'idle', error: '', attach: () => Promise.resolve() };
|
||||
|
||||
// Заявка на оплату только для просмотра (режим согласующего).
|
||||
const PaymentRequestView: React.FC<IPaymentRequestViewProps> = ({ context, itemId, formKey, listId, onCodeLoaded }) => {
|
||||
const notifyCode = useStableCallback(onCodeLoaded);
|
||||
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);
|
||||
const [printOrgIndex, setPrintOrgIndex] = useState<number>(0);
|
||||
|
||||
const { id: requestTypeId } = useRequestTypeId(context, formKey);
|
||||
const set: SetField = () => undefined;
|
||||
const patch = (): void => undefined;
|
||||
|
||||
const approval = useMemo(() => paymentRequestApprovalService(listId), [listId]);
|
||||
const dataListRef = listId || dataListTitle(FORM_ID);
|
||||
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
|
||||
|
||||
const [decisionSeq, setDecisionSeq] = useState<number>(0);
|
||||
const loadApprovers = React.useCallback(() => approval.getMatrixForRequest(itemId).then(approvalPhaseRows), [approval, itemId]);
|
||||
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) => approval.getJobTitle(l));
|
||||
const executors = useViewExecutors(context, approval, itemId, decisionSeq);
|
||||
|
||||
useEffect(() => {
|
||||
let alive = true;
|
||||
setLoading(true);
|
||||
loadPaymentRequest(itemId, listId)
|
||||
.then((loaded) => {
|
||||
if (!alive) return;
|
||||
setData(loaded.data);
|
||||
setStatus(loaded.status);
|
||||
setCode(loaded.code);
|
||||
notifyCode(loaded.code);
|
||||
setError(null);
|
||||
setLoading(false);
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) {
|
||||
setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
|
||||
setLoading(false);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [itemId, listId, notifyCode]);
|
||||
|
||||
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, patch, context, printOrgIndex };
|
||||
|
||||
const notify = (): void => {
|
||||
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);
|
||||
};
|
||||
|
||||
return (
|
||||
<div>
|
||||
<div className={`${styles.toolbar} rp-no-print`}>
|
||||
{isEditableStatus(status) && (
|
||||
<Button variant="secondary" onClick={() => navigate({ mode: 'edit', nav: 'new', formKey, itemId, listId })}>
|
||||
<Icon name="edit" size="sm" />
|
||||
Редактировать
|
||||
</Button>
|
||||
)}
|
||||
<PrintSplitButton value={data.Organization} selectedIndex={printOrgIndex} onChange={setPrintOrgIndex} />
|
||||
</div>
|
||||
|
||||
<div className="rp-print-root">
|
||||
<OrgLetterhead value={data.Organization} selectedIndex={printOrgIndex} />
|
||||
<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>
|
||||
<HeaderSection {...sectionProps} />
|
||||
<CollapseSection title="Основание" icon="document">
|
||||
<div>
|
||||
{data.BasisTitle} · {data.ProjectName} · {data.CompanyName}
|
||||
</div>
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Вложения — счёт на оплату" icon="document">
|
||||
<InvoiceSection data={data} invoice={IDLE_INVOICE} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Реквизиты платежа" icon="calculator">
|
||||
<PaymentSection {...sectionProps} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Суммы" icon="calculator">
|
||||
<AmountsSection {...sectionProps} />
|
||||
</CollapseSection>
|
||||
<CollapseSection title="Позиции" icon="clipboard">
|
||||
<PositionsSection rows={data.Positions} compared={!!data.InvoiceFileName} />
|
||||
</CollapseSection>
|
||||
</FormModeProvider>
|
||||
</FormCard>
|
||||
|
||||
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
|
||||
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
|
||||
</div>
|
||||
|
||||
<div className="rp-no-print">
|
||||
<ApprovalHistory approval={approval} dataListRef={dataListRef} requestId={itemId} reloadKey={decisionSeq} />
|
||||
</div>
|
||||
|
||||
<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 PaymentRequestView;
|
||||
@@ -0,0 +1,36 @@
|
||||
# Заявка на оплату (`acc-payment-request`)
|
||||
|
||||
**Назначение:** оплата по согласованной СТ (сравнительной таблице) или по потребности — счёт, получатель, суммы и сверка позиций счёта с СТ.
|
||||
**Категория:** Бухгалтерия
|
||||
**Списки SP:** «Заявка на оплату — данные», «Заявка на оплату — согласование»; библиотека «Счета на оплату» (создаётся вручную, колонка `file_content` — многострочный текст)
|
||||
**RequestTypeId (внешний API маршрутов):** резолвится в рантайме по `pageUrl` (см. `docs/forms.md`) — тип `acc-payment-request` нужно завести в админке маршрутов
|
||||
|
||||
## Маршрут
|
||||
- Фазы: согласование (исполнителей нет)
|
||||
- Маршрут зависит от проекта (`ProjectId`) — как у «Заявки на услуг»: пока проект не выбран, матрица не строится.
|
||||
|
||||
## Особое поведение
|
||||
- **Основание** — согласованная СТ (`status = Согласовано` в списке «Сравнительная таблица» сайта СТ, `CT_SITE_URL`) либо потребность (`GET /Requests/365`, позиции — `/Requests/{oid}/positions`; тот же источник, что шаг 1 СТ). Выбор подставляет проект, компанию (если известна), получателя, раздел, вид работ, условия, общую сумму и позиции (`basisPatch.ts`); всё остаётся редактируемым.
|
||||
- **Получатель** — выигравший поставщик СТ (`winSupplier` → «Поставщики»). Если в счёте указан другой контрагент (БИН, иначе название без формы собственности) — поле подсвечивается (`recipientMatchesInvoice`).
|
||||
- **Раздел / вид работ** у СТ — из позиций СТ (`disciplineCode` / `SMR`), у потребности — `discipline` / `workType` заявки.
|
||||
- **Условия оплаты, доставки и срок** — из «Критериев» СТ по победителю.
|
||||
- **Общая сумма** СТ — сумма предложений победителя в «Оценке поставщиков» (смешанные валюты — в тенге). У потребности её нет, берётся из счёта.
|
||||
- **Сумма оплаты** может быть меньше общей (транши). Сумма всех оплат по основанию (прежние + эта) не может превышать общую — при превышении поле подсвечивается, отправку это **не** блокирует.
|
||||
- **Ранее поданные заявки на оплату** — читаются из списка данных этой же формы по `BasisKey` (`ct:<Id СТ>` / `need:<oid>`), без черновиков, отклонённых и возвращённых. Только текущая партиция списка. Снимок пишется в `PreviousPaymentsJson`.
|
||||
- **Счёт (PDF)**: сначала сохраняется в библиотеку «Счета на оплату», затем `POST /Document/extractPDF` (OCR кладёт текст в `file_content`), затем ИИ (`/Proxy/Gemini`) достаёт номер счёта, поставщика, БИН, IBAN, валюту, суммы и позиции и подставляет их (назначение платежа — «Оплата по счёту № …»). При сбое OCR/ИИ счёт остаётся приложенным, поля заполняются вручную.
|
||||
- **Таблица позиций**: код, наименование, ед. изм. и количество — из СТ/потребности; позиция поставщика — из его КП; позиция из счёта. ИИ сопоставляет позиции по смыслу, а количество и единицы сверяет код (`positions.ts`). Статусы: совпало / расхождение / нет в счёте / нет в СТ. Результат пишется в `PositionsJson`.
|
||||
- Справочники 1С (банковские счета, договоры, группы и статьи ДДС) — `DictionaryPicker`; недоступный справочник не блокирует заявку (поле становится текстовым).
|
||||
|
||||
## Что не проверено на живом API
|
||||
- Форма ответов и параметры фильтра `Dictionary/BankAccounts` (`companyId`, `projectId`), `Dictionary/Contracts` (`companyId`), `Dictionary/CashFlowItemGroups`, `Dictionary/CashFlowItems` (`groupId` — адрес и параметр статьи ДДС в ТЗ не указаны, взяты по аналогии). Поля записи читаются по списку вероятных имён (`dictionaryList.service.ts`).
|
||||
- Тело запроса `Document/extractPDF` — взято по аналогии с `extractPDFText` из СТ (`siteUrl`, `libraryName`, `itemId`).
|
||||
- «Потребности» взяты из `/Requests/{дни}`, а не из `/Dictionary/Positions`: в портале это справочник должностей.
|
||||
- Доступ пользователей портала на чтение списков сайта СТ.
|
||||
|
||||
## Секции формы
|
||||
HeaderSection, BasisSection (BasisPicker), InvoiceSection, PaymentSection, AmountsSection, PositionsSection
|
||||
|
||||
## Точки входа
|
||||
- rptype: `acc-payment-request`
|
||||
- Режим согласующего (просмотр): есть (`PaymentRequestView`)
|
||||
- «Создать на основе»: —
|
||||
@@ -0,0 +1,47 @@
|
||||
import { overLimitAmount, parseAmount, previousPaymentsTotal, recipientMatchesInvoice } from './amounts';
|
||||
|
||||
describe('parseAmount', () => {
|
||||
it('понимает пробелы и запятую', () => {
|
||||
expect(parseAmount('1 234,50')).toBe(1234.5);
|
||||
});
|
||||
it('мусор и пустая строка — 0', () => {
|
||||
expect(parseAmount('abc')).toBe(0);
|
||||
expect(parseAmount('')).toBe(0);
|
||||
});
|
||||
});
|
||||
|
||||
describe('overLimitAmount', () => {
|
||||
const prev = [
|
||||
{ code: 'A', amount: 600 },
|
||||
{ code: 'B', amount: 100 }
|
||||
];
|
||||
it('не превышает, пока сумма всех оплат не больше общей', () => {
|
||||
expect(overLimitAmount({ TotalAmount: 1000, PayAmount: 300, PreviousPayments: prev })).toBe(0);
|
||||
});
|
||||
it('возвращает величину превышения', () => {
|
||||
expect(overLimitAmount({ TotalAmount: 1000, PayAmount: 400, PreviousPayments: prev })).toBe(100);
|
||||
});
|
||||
it('копейки округления не считаются превышением', () => {
|
||||
expect(overLimitAmount({ TotalAmount: 1000, PayAmount: 300.004, PreviousPayments: prev })).toBe(0);
|
||||
});
|
||||
it('без общей суммы сравнивать не с чем', () => {
|
||||
expect(overLimitAmount({ TotalAmount: 0, PayAmount: 5, PreviousPayments: prev })).toBe(0);
|
||||
});
|
||||
it('считает сумму прежних оплат', () => {
|
||||
expect(previousPaymentsTotal(prev)).toBe(700);
|
||||
});
|
||||
});
|
||||
|
||||
describe('recipientMatchesInvoice', () => {
|
||||
it('БИН решает, когда он есть у обеих сторон', () => {
|
||||
expect(recipientMatchesInvoice({ name: 'А', bin: '1' }, { name: 'Б', bin: '1' })).toBe(true);
|
||||
expect(recipientMatchesInvoice({ name: 'А', bin: '1' }, { name: 'А', bin: '2' })).toBe(false);
|
||||
});
|
||||
it('без БИН сравнивает названия без формы собственности и кавычек', () => {
|
||||
expect(recipientMatchesInvoice({ name: 'ТОО «Альфа Строй»', bin: '' }, { name: 'Альфа Строй, ТОО', bin: '' })).toBe(true);
|
||||
expect(recipientMatchesInvoice({ name: 'ТОО «Альфа»', bin: '' }, { name: 'ТОО «Бета»', bin: '' })).toBe(false);
|
||||
});
|
||||
it('нет данных по счёту — расхождения нет', () => {
|
||||
expect(recipientMatchesInvoice({ name: 'ТОО «Альфа»', bin: '1' }, { name: '', bin: '' })).toBe(true);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,59 @@
|
||||
import { IFormData, IPreviousPayment } from './model';
|
||||
|
||||
/** Допуск при сравнении денег: копейки округления не считаем превышением. */
|
||||
const MONEY_EPSILON = 0.005;
|
||||
|
||||
/** Число из текста поля ввода: пробелы и запятая допустимы; мусор → 0. */
|
||||
export function parseAmount(raw: string): number {
|
||||
const value = Number(raw.replace(/\s/g, '').replace(',', '.'));
|
||||
return Number.isFinite(value) ? value : 0;
|
||||
}
|
||||
|
||||
/** Сумма ранее поданных оплат по основанию. */
|
||||
export function previousPaymentsTotal(payments: IPreviousPayment[]): number {
|
||||
return payments.reduce((sum, p) => sum + p.amount, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
* На сколько все оплаты по основанию (прежние + эта) превышают общую сумму СТ.
|
||||
* 0 — не превышают; общая сумма не задана — сравнивать не с чем, тоже 0.
|
||||
*/
|
||||
export function overLimitAmount(data: Pick<IFormData, 'TotalAmount' | 'PayAmount' | 'PreviousPayments'>): number {
|
||||
if (data.TotalAmount <= 0) return 0;
|
||||
const over = previousPaymentsTotal(data.PreviousPayments) + data.PayAmount - data.TotalAmount;
|
||||
return over > MONEY_EPSILON ? over : 0;
|
||||
}
|
||||
|
||||
/** Сумма с разрядами для показа («1 234 567,5»). */
|
||||
export function formatAmount(value: number): string {
|
||||
return value.toLocaleString('ru-RU', { maximumFractionDigits: 2 });
|
||||
}
|
||||
|
||||
const LEGAL_FORMS = /(^|\s)(тоо|ао|ип|llp|ооо|товарищество с ограниченной ответственностью)(?=\s|$)/gi;
|
||||
|
||||
/** Название контрагента для сравнения: без формы собственности, кавычек и регистра. */
|
||||
export function normalizeCounterparty(name: string): string {
|
||||
return name
|
||||
.toLowerCase()
|
||||
.replace(/[^a-zа-яё0-9]+/gi, ' ')
|
||||
.replace(LEGAL_FORMS, ' ')
|
||||
.replace(/\s+/g, ' ')
|
||||
.trim();
|
||||
}
|
||||
|
||||
/**
|
||||
* Совпадает ли получатель из СТ с поставщиком из счёта. БИН надёжнее названия:
|
||||
* если он есть у обеих сторон — решает он. Нет данных по счёту — расхождения нет
|
||||
* (подсвечивать нечего).
|
||||
*/
|
||||
export function recipientMatchesInvoice(
|
||||
recipient: { name: string; bin: string },
|
||||
invoice: { name: string; bin: string }
|
||||
): boolean {
|
||||
if (!invoice.name && !invoice.bin) return true;
|
||||
if (recipient.bin && invoice.bin) return recipient.bin === invoice.bin;
|
||||
const a = normalizeCounterparty(recipient.name);
|
||||
const b = normalizeCounterparty(invoice.name);
|
||||
if (!a || !b) return true;
|
||||
return a === b || a.indexOf(b) !== -1 || b.indexOf(a) !== -1;
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"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": "AutoApprove", "title": "Автосогласование", "type": "Boolean" },
|
||||
{ "internalName": "DelegatedBy", "title": "Кем переназначено", "type": "User", "userSelectionMode": "PeopleOnly" }
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,54 @@
|
||||
import { ICompany, IProject } from '../../shared/dictionary';
|
||||
import { normalizeCounterparty } from './amounts';
|
||||
import { IFormData, IPreviousPayment } from './model';
|
||||
import { rowsFromBasis } from './positions';
|
||||
import { IBasisInfo } from './services/basis.types';
|
||||
|
||||
/** Проект из справочника по названию: в СТ и потребности проект хранится только текстом. */
|
||||
function findProject(projects: IProject[], name: string): IProject | undefined {
|
||||
const wanted = name.trim().toLowerCase();
|
||||
return wanted ? projects.filter((p) => p.name.trim().toLowerCase() === wanted)[0] : undefined;
|
||||
}
|
||||
|
||||
/** Компания из справочника по подсказке (организация потребности). */
|
||||
function findCompany(companies: ICompany[], hint: string): ICompany | undefined {
|
||||
const wanted = normalizeCounterparty(hint);
|
||||
if (!wanted) return undefined;
|
||||
return companies.filter((c) => normalizeCounterparty(c.Name) === wanted)[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* Поля формы, которые подставляет выбранное основание. Всё подставленное остаётся
|
||||
* редактируемым: справочники не всегда точны, а заявитель лучше знает, что платит.
|
||||
* Счёт и сумма оплаты основанием не затрагиваются.
|
||||
*/
|
||||
export function basisPatch(
|
||||
info: IBasisInfo,
|
||||
previous: IPreviousPayment[],
|
||||
projects: IProject[],
|
||||
companies: ICompany[]
|
||||
): Partial<IFormData> {
|
||||
const project = findProject(projects, info.projectName);
|
||||
const company = findCompany(companies, info.companyHint);
|
||||
return {
|
||||
BasisKind: info.kind,
|
||||
BasisKey: info.key,
|
||||
BasisTitle: info.title,
|
||||
ProjectName: info.projectName,
|
||||
ProjectId: project ? project.oid : '',
|
||||
ProjectManager: project ? project.projectManager || '' : '',
|
||||
CompanyId: company ? company.Id : '',
|
||||
CompanyName: company ? company.Name : '',
|
||||
RecipientName: info.recipientName,
|
||||
RecipientBin: info.recipientBin,
|
||||
Section: info.section,
|
||||
WorkKind: info.workKind,
|
||||
TotalAmount: info.total,
|
||||
Currency: info.currency,
|
||||
DeliveryTerms: info.deliveryTerms,
|
||||
PaymentTerms: info.paymentTerms,
|
||||
DeliveryTime: info.deliveryTime,
|
||||
PreviousPayments: previous,
|
||||
Positions: rowsFromBasis(info.positions)
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,62 @@
|
||||
import { IFormData, IPositionRow } from './model';
|
||||
import { buildRows, IInvoiceItem, IPositionPair } from './positions';
|
||||
import { IInvoiceData } from './services/invoiceAi.service';
|
||||
import { IBasisPosition } from './services/basis.types';
|
||||
|
||||
/** Назначение платежа по номеру счёта. */
|
||||
export function purposeForInvoice(invoiceNumber: string): string {
|
||||
return invoiceNumber ? `Оплата по счёту № ${invoiceNumber}` : '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Позиции основания из уже собранной таблицы (строки «нет в СТ» — это позиции
|
||||
* счёта, к основанию они не относятся). Нужны, чтобы повторно сверить таблицу с
|
||||
* другим счётом, не перезагружая СТ.
|
||||
*/
|
||||
export function basisPositionsFromRows(rows: IPositionRow[]): IBasisPosition[] {
|
||||
return rows
|
||||
.filter((row) => row.status !== 'extra')
|
||||
.map((row) => ({
|
||||
code: row.code,
|
||||
name: row.name,
|
||||
unit: row.unit,
|
||||
qty: row.qty,
|
||||
supplierName: row.supplierName,
|
||||
supplierQty: row.supplierQty,
|
||||
supplierPrice: row.supplierPrice
|
||||
}));
|
||||
}
|
||||
|
||||
/**
|
||||
* Что счёт подставляет в форму. Пустое значение из счёта поле не затирает.
|
||||
* Общая сумма берётся из счёта только когда основание её не дало (потребность):
|
||||
* у СТ общая сумма — предел для всех оплат, и счёт его менять не должен.
|
||||
* Получатель у потребности — поставщик из счёта; у СТ — победитель, и расхождение
|
||||
* со счётом подсвечивается, а не затирается.
|
||||
*/
|
||||
export function invoicePatch(
|
||||
data: IFormData,
|
||||
invoice: IInvoiceData,
|
||||
items: IInvoiceItem[],
|
||||
pairs: IPositionPair[]
|
||||
): Partial<IFormData> {
|
||||
const patch: Partial<IFormData> = {
|
||||
InvoiceNumber: invoice.invoiceNumber,
|
||||
InvoiceSupplierName: invoice.supplierName,
|
||||
InvoiceSupplierBin: invoice.supplierBin,
|
||||
Positions: buildRows(basisPositionsFromRows(data.Positions), items, pairs)
|
||||
};
|
||||
if (invoice.recipientAccount) patch.RecipientAccount = invoice.recipientAccount;
|
||||
if (invoice.currency) patch.Currency = invoice.currency;
|
||||
if (invoice.invoiceNumber) patch.PaymentPurpose = purposeForInvoice(invoice.invoiceNumber);
|
||||
if (invoice.vatAmount > 0) patch.VatAmount = invoice.vatAmount;
|
||||
if (invoice.totalAmount > 0) {
|
||||
patch.PayAmount = invoice.totalAmount;
|
||||
if (data.TotalAmount <= 0) patch.TotalAmount = invoice.totalAmount;
|
||||
}
|
||||
if (!data.RecipientName && invoice.supplierName) {
|
||||
patch.RecipientName = invoice.supplierName;
|
||||
patch.RecipientBin = invoice.supplierBin;
|
||||
}
|
||||
return patch;
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
import { getSP } from '../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../shared/listTitles';
|
||||
import { spDateOnlyToIso } from '../../shared/dateUtils';
|
||||
import { EMPTY_DATA, FORM_ID, IFormData, IPositionRow, IPreviousPayment, BasisKind } from './model';
|
||||
|
||||
export interface ILoadedRequest {
|
||||
data: IFormData;
|
||||
status: string;
|
||||
/** Уникальный код заявки; '' — если запись создана до появления поля. */
|
||||
code: string;
|
||||
}
|
||||
|
||||
/** Текстовые колонки, которые читаются как есть (имя поля формы = имя колонки). */
|
||||
const TEXT_KEYS = [
|
||||
'RequesterEmail',
|
||||
'RequesterName',
|
||||
'RequesterJobTitle',
|
||||
'Organization',
|
||||
'Department',
|
||||
'DepartmentId',
|
||||
'BasisKey',
|
||||
'BasisTitle',
|
||||
'ProjectName',
|
||||
'ProjectId',
|
||||
'ProjectManager',
|
||||
'CompanyId',
|
||||
'CompanyName',
|
||||
'BankAccountId',
|
||||
'BankAccountName',
|
||||
'RecipientName',
|
||||
'RecipientBin',
|
||||
'RecipientAccount',
|
||||
'Section',
|
||||
'WorkKind',
|
||||
'ContractId',
|
||||
'ContractName',
|
||||
'CashFlowGroupId',
|
||||
'CashFlowGroupName',
|
||||
'CashFlowItemId',
|
||||
'CashFlowItemName',
|
||||
'PaymentPurpose',
|
||||
'DeliveryTerms',
|
||||
'PaymentTerms',
|
||||
'Currency',
|
||||
'DeliveryTime',
|
||||
'Comment',
|
||||
'InvoiceFileName',
|
||||
'InvoiceUrl',
|
||||
'InvoiceNumber',
|
||||
'InvoiceSupplierName',
|
||||
'InvoiceSupplierBin'
|
||||
] as const;
|
||||
|
||||
const NUMBER_KEYS = ['TotalAmount', 'VatAmount', 'PayAmount'] as const;
|
||||
|
||||
const SELECT_FIELDS = [
|
||||
'Id',
|
||||
'RequestDate',
|
||||
'BasisKind',
|
||||
'PreviousPaymentsJson',
|
||||
'PositionsJson',
|
||||
'RequestStatus',
|
||||
'RequestUniqueCode',
|
||||
...TEXT_KEYS,
|
||||
...NUMBER_KEYS
|
||||
];
|
||||
|
||||
/**
|
||||
* Безопасный разбор JSON-колонки табличной части: пустой массив при пустом
|
||||
* значении или битом JSON — заявка должна открываться даже с испорченной
|
||||
* таблицей, иначе её нельзя было бы починить через форму.
|
||||
*/
|
||||
function parseRows<T>(raw: unknown): T[] {
|
||||
if (typeof raw !== 'string' || raw.trim() === '') return [];
|
||||
try {
|
||||
const parsed = JSON.parse(raw);
|
||||
return Array.isArray(parsed) ? (parsed as T[]) : [];
|
||||
} catch {
|
||||
return [];
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Прочитать «Заявку на оплату» по id: модель формы + статус + код.
|
||||
* listId — партиция, где лежит именно эта заявка; не задан — текущая.
|
||||
*/
|
||||
export async function loadPaymentRequest(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(...SELECT_FIELDS)()) as Record<string, unknown>;
|
||||
|
||||
const data: IFormData = {
|
||||
...EMPTY_DATA,
|
||||
RequestDate: spDateOnlyToIso(item.RequestDate),
|
||||
BasisKind: item.BasisKind === 'need' ? ('need' as BasisKind) : 'ct',
|
||||
PreviousPayments: parseRows<IPreviousPayment>(item.PreviousPaymentsJson),
|
||||
Positions: parseRows<IPositionRow>(item.PositionsJson)
|
||||
};
|
||||
TEXT_KEYS.forEach((key) => {
|
||||
data[key] = (item[key] as string) || '';
|
||||
});
|
||||
NUMBER_KEYS.forEach((key) => {
|
||||
data[key] = Number(item[key] || 0);
|
||||
});
|
||||
|
||||
return {
|
||||
data,
|
||||
status: (item.RequestStatus as string) || '',
|
||||
code: (item.RequestUniqueCode as string) || ''
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,183 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { RequestTypeId } from '../../models/types';
|
||||
|
||||
/**
|
||||
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
|
||||
* SharePoint выводятся из него, см. shared/listTitles.ts.
|
||||
*/
|
||||
export const FORM_ID: RequestTypeId = 'acc-payment-request';
|
||||
|
||||
/** На чём основана оплата: согласованная СТ либо потребность (когда СТ не было). */
|
||||
export type BasisKind = 'ct' | 'need';
|
||||
|
||||
export const BASIS_OPTIONS: Array<{ value: BasisKind; label: string }> = [
|
||||
{ value: 'ct', label: 'Сравнительная таблица (СТ)' },
|
||||
{ value: 'need', label: 'Потребность' }
|
||||
];
|
||||
|
||||
/** Ранее поданная заявка на оплату по той же СТ/потребности. */
|
||||
export interface IPreviousPayment {
|
||||
/** Уникальный код заявки на оплату. */
|
||||
code: string;
|
||||
amount: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Результат сверки строки с позициями счёта:
|
||||
* ok — совпало; diff — позиция та же, но отличается количество/ед. изм.;
|
||||
* missing — есть в СТ/потребности, в счёте нет; extra — есть в счёте, в СТ нет.
|
||||
*/
|
||||
export type RowStatus = 'ok' | 'diff' | 'missing' | 'extra';
|
||||
|
||||
/** Строка таблицы позиций: СТ/потребность ↔ поставщик ↔ счёт. */
|
||||
export interface IPositionRow {
|
||||
/** Уникальный код позиции потребности. */
|
||||
code: string;
|
||||
/** Наименование и ед. изм. из потребности (в СТ они есть). */
|
||||
name: string;
|
||||
unit: string;
|
||||
qty: number;
|
||||
/** Позиция поставщика из его КП (только при основании «СТ»). */
|
||||
supplierName: string;
|
||||
supplierQty: number;
|
||||
supplierPrice: number;
|
||||
/** Позиция из счёта. */
|
||||
invoiceName: string;
|
||||
invoiceUnit: string;
|
||||
invoiceQty: number;
|
||||
invoicePrice: number;
|
||||
invoiceSum: number;
|
||||
status: RowStatus;
|
||||
/** Пояснение к расхождению; '' — нет. */
|
||||
note: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Данные формы «Заявка на оплату». Ключи = internalName колонок SP-списка
|
||||
* «Заявка на оплату — данные». Табличные части уходят в JSON-колонки
|
||||
* (PreviousPaymentsJson, PositionsJson), суммы — в числовые колонки (для отчётов).
|
||||
*/
|
||||
export interface IFormData {
|
||||
// --- Заявитель ---
|
||||
RequesterEmail: string;
|
||||
RequesterName: string;
|
||||
RequesterJobTitle: string;
|
||||
Organization: string;
|
||||
Department: string;
|
||||
DepartmentId: string;
|
||||
RequestDate: string;
|
||||
|
||||
// --- Основание ---
|
||||
BasisKind: BasisKind;
|
||||
/** Ключ основания для поиска прежних оплат: «ct:<Id СТ>» либо «need:<oid потребности>». */
|
||||
BasisKey: string;
|
||||
/** Подпись основания: «СТ №3 — Проект» либо «Потребность 081/26-04/0017». */
|
||||
BasisTitle: string;
|
||||
ProjectName: string;
|
||||
/** oid проекта: по нему бэкенд резолвит маршрут согласования. */
|
||||
ProjectId: string;
|
||||
ProjectManager: string;
|
||||
CompanyId: string;
|
||||
CompanyName: string;
|
||||
|
||||
// --- Платёж ---
|
||||
BankAccountId: string;
|
||||
BankAccountName: string;
|
||||
RecipientName: string;
|
||||
RecipientBin: string;
|
||||
/** Счёт получателя (IBAN) — из файла счёта. */
|
||||
RecipientAccount: string;
|
||||
Section: string;
|
||||
WorkKind: string;
|
||||
ContractId: string;
|
||||
ContractName: string;
|
||||
CashFlowGroupId: string;
|
||||
CashFlowGroupName: string;
|
||||
CashFlowItemId: string;
|
||||
CashFlowItemName: string;
|
||||
PaymentPurpose: string;
|
||||
DeliveryTerms: string;
|
||||
PaymentTerms: string;
|
||||
|
||||
// --- Суммы ---
|
||||
/** Суммы хранятся числом: 0 — не заполнено. */
|
||||
TotalAmount: number;
|
||||
VatAmount: number;
|
||||
Currency: string;
|
||||
PayAmount: number;
|
||||
DeliveryTime: string;
|
||||
Comment: string;
|
||||
|
||||
// --- Счёт ---
|
||||
InvoiceFileName: string;
|
||||
/** Адрес файла в библиотеке счетов (ServerRelativeUrl). */
|
||||
InvoiceUrl: string;
|
||||
InvoiceNumber: string;
|
||||
/** Поставщик, как он назван в самом счёте, — сверяется с получателем из СТ. */
|
||||
InvoiceSupplierName: string;
|
||||
InvoiceSupplierBin: string;
|
||||
|
||||
// --- Табличные части ---
|
||||
PreviousPayments: IPreviousPayment[];
|
||||
Positions: IPositionRow[];
|
||||
}
|
||||
|
||||
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
|
||||
|
||||
/** Пропсы каждой секции формы. */
|
||||
export interface ISectionProps {
|
||||
data: IFormData;
|
||||
set: SetField;
|
||||
context: WebPartContext;
|
||||
/** Подставить сразу несколько полей (выбор основания меняет их пачкой). */
|
||||
patch: (changes: Partial<IFormData>) => void;
|
||||
printOrgIndex?: number;
|
||||
onRequesterChange?: (login: string) => void;
|
||||
}
|
||||
|
||||
export const EMPTY_DATA: IFormData = {
|
||||
RequesterEmail: '',
|
||||
RequesterName: '',
|
||||
RequesterJobTitle: '',
|
||||
Organization: '',
|
||||
Department: '',
|
||||
DepartmentId: '',
|
||||
RequestDate: '',
|
||||
BasisKind: 'ct',
|
||||
BasisKey: '',
|
||||
BasisTitle: '',
|
||||
ProjectName: '',
|
||||
ProjectId: '',
|
||||
ProjectManager: '',
|
||||
CompanyId: '',
|
||||
CompanyName: '',
|
||||
BankAccountId: '',
|
||||
BankAccountName: '',
|
||||
RecipientName: '',
|
||||
RecipientBin: '',
|
||||
RecipientAccount: '',
|
||||
Section: '',
|
||||
WorkKind: '',
|
||||
ContractId: '',
|
||||
ContractName: '',
|
||||
CashFlowGroupId: '',
|
||||
CashFlowGroupName: '',
|
||||
CashFlowItemId: '',
|
||||
CashFlowItemName: '',
|
||||
PaymentPurpose: '',
|
||||
DeliveryTerms: '',
|
||||
PaymentTerms: '',
|
||||
TotalAmount: 0,
|
||||
VatAmount: 0,
|
||||
Currency: '',
|
||||
PayAmount: 0,
|
||||
DeliveryTime: '',
|
||||
Comment: '',
|
||||
InvoiceFileName: '',
|
||||
InvoiceUrl: '',
|
||||
InvoiceNumber: '',
|
||||
InvoiceSupplierName: '',
|
||||
InvoiceSupplierBin: '',
|
||||
PreviousPayments: [],
|
||||
Positions: []
|
||||
};
|
||||
@@ -0,0 +1,63 @@
|
||||
import { buildRows, hasPositionIssues, IInvoiceItem } from './positions';
|
||||
import { IBasisPosition } from './services/basis.types';
|
||||
|
||||
const base = (name: string, qty: number, unit = 'шт'): IBasisPosition => ({
|
||||
code: `K-${name}`,
|
||||
name,
|
||||
unit,
|
||||
qty,
|
||||
supplierName: '',
|
||||
supplierQty: 0,
|
||||
supplierPrice: 0
|
||||
});
|
||||
|
||||
const item = (name: string, quantity: number, unit = 'шт'): IInvoiceItem => ({
|
||||
name,
|
||||
unit,
|
||||
quantity,
|
||||
price: 10,
|
||||
sum: 10 * quantity
|
||||
});
|
||||
|
||||
describe('buildRows', () => {
|
||||
it('совпавшая пара — ok', () => {
|
||||
const rows = buildRows([base('Цемент', 5)], [item('Цемент М400', 5)], [{ baseIndex: 0, invoiceIndex: 0, note: '' }]);
|
||||
expect(rows).toHaveLength(1);
|
||||
expect(rows[0].status).toBe('ok');
|
||||
expect(rows[0].invoiceName).toBe('Цемент М400');
|
||||
});
|
||||
|
||||
it('разное количество — diff с пояснением', () => {
|
||||
const rows = buildRows([base('Цемент', 5)], [item('Цемент', 7)], [{ baseIndex: 0, invoiceIndex: 0, note: '' }]);
|
||||
expect(rows[0].status).toBe('diff');
|
||||
expect(rows[0].note).toContain('количество');
|
||||
});
|
||||
|
||||
it('единицы измерения сравниваются без регистра и точек', () => {
|
||||
const rows = buildRows([base('Труба', 2, 'Шт.')], [item('Труба', 2, 'шт')], [{ baseIndex: 0, invoiceIndex: 0, note: '' }]);
|
||||
expect(rows[0].status).toBe('ok');
|
||||
});
|
||||
|
||||
it('позиция, которую ИИ не упомянул, не пропадает', () => {
|
||||
const rows = buildRows([base('А', 1), base('Б', 1)], [item('А', 1), item('В', 1)], [{ baseIndex: 0, invoiceIndex: 0, note: '' }]);
|
||||
expect(rows.map((r) => r.status)).toEqual(['ok', 'missing', 'extra']);
|
||||
});
|
||||
|
||||
it('пары с неверными индексами и повторы отбрасываются', () => {
|
||||
const rows = buildRows(
|
||||
[base('А', 1)],
|
||||
[item('А', 1), item('Б', 1)],
|
||||
[
|
||||
{ baseIndex: 0, invoiceIndex: 0, note: '' },
|
||||
{ baseIndex: 0, invoiceIndex: 1, note: '' },
|
||||
{ baseIndex: 9, invoiceIndex: 1, note: '' }
|
||||
]
|
||||
);
|
||||
expect(rows.map((r) => r.status)).toEqual(['ok', 'extra']);
|
||||
});
|
||||
|
||||
it('hasPositionIssues видит любое расхождение', () => {
|
||||
expect(hasPositionIssues(buildRows([base('А', 1)], [], []))).toBe(true);
|
||||
expect(hasPositionIssues(buildRows([base('А', 1)], [item('А', 1)], [{ baseIndex: 0, invoiceIndex: 0, note: '' }]))).toBe(false);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,129 @@
|
||||
import { IPositionRow } from './model';
|
||||
import { IBasisPosition } from './services/basis.types';
|
||||
|
||||
/** Позиция, распознанная в счёте. */
|
||||
export interface IInvoiceItem {
|
||||
name: string;
|
||||
unit: string;
|
||||
quantity: number;
|
||||
price: number;
|
||||
sum: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Пара, которую вернула ИИ: какой позиции основания (baseIndex) соответствует
|
||||
* какая позиция счёта (invoiceIndex). −1 с одной из сторон — пары нет.
|
||||
*/
|
||||
export interface IPositionPair {
|
||||
baseIndex: number;
|
||||
invoiceIndex: number;
|
||||
note: string;
|
||||
}
|
||||
|
||||
const QTY_EPSILON = 0.0001;
|
||||
|
||||
function emptyInvoicePart(): Pick<IPositionRow, 'invoiceName' | 'invoiceUnit' | 'invoiceQty' | 'invoicePrice' | 'invoiceSum'> {
|
||||
return { invoiceName: '', invoiceUnit: '', invoiceQty: 0, invoicePrice: 0, invoiceSum: 0 };
|
||||
}
|
||||
|
||||
function invoicePart(item: IInvoiceItem): ReturnType<typeof emptyInvoicePart> {
|
||||
return {
|
||||
invoiceName: item.name,
|
||||
invoiceUnit: item.unit,
|
||||
invoiceQty: item.quantity,
|
||||
invoicePrice: item.price,
|
||||
invoiceSum: item.sum
|
||||
};
|
||||
}
|
||||
|
||||
/** Ед. изм. для сравнения: «шт.», «Шт» и «шт» — одно и то же. */
|
||||
function normalizeUnit(unit: string): string {
|
||||
return unit.toLowerCase().replace(/[.\s]/g, '');
|
||||
}
|
||||
|
||||
function basisPart(position: IBasisPosition): Pick<IPositionRow, 'code' | 'name' | 'unit' | 'qty' | 'supplierName' | 'supplierQty' | 'supplierPrice'> {
|
||||
return {
|
||||
code: position.code,
|
||||
name: position.name,
|
||||
unit: position.unit,
|
||||
qty: position.qty,
|
||||
supplierName: position.supplierName,
|
||||
supplierQty: position.supplierQty,
|
||||
supplierPrice: position.supplierPrice
|
||||
};
|
||||
}
|
||||
|
||||
/** Строки таблицы до загрузки счёта: только основание, сверять пока не с чем. */
|
||||
export function rowsFromBasis(base: IBasisPosition[]): IPositionRow[] {
|
||||
return base.map((position) => ({
|
||||
...basisPart(position),
|
||||
...emptyInvoicePart(),
|
||||
status: 'ok',
|
||||
note: ''
|
||||
}));
|
||||
}
|
||||
|
||||
/** Расхождения парной строки: ед. изм. и количество сравниваем сами, не полагаясь на ИИ. */
|
||||
function diffNote(position: IBasisPosition, item: IInvoiceItem, aiNote: string): string {
|
||||
const notes: string[] = [];
|
||||
if (position.unit && item.unit && normalizeUnit(position.unit) !== normalizeUnit(item.unit)) {
|
||||
notes.push(`ед. изм.: ${position.unit} → ${item.unit}`);
|
||||
}
|
||||
if (Math.abs(position.qty - item.quantity) > QTY_EPSILON) {
|
||||
notes.push(`количество: ${position.qty} → ${item.quantity}`);
|
||||
}
|
||||
// Смысловое отличие названия (другая марка, размер) видит только ИИ — его пометка сама по себе расхождение.
|
||||
if (aiNote) notes.push(aiNote);
|
||||
return notes.join('; ');
|
||||
}
|
||||
|
||||
/**
|
||||
* Собрать таблицу сверки из ответа ИИ. Пары с неверными индексами и повторы
|
||||
* отбрасываются, а всё, что ИИ не упомянул, попадает в таблицу как «нет в счёте» /
|
||||
* «нет в основании»: ни одна позиция не должна пропасть молча.
|
||||
*/
|
||||
export function buildRows(base: IBasisPosition[], invoice: IInvoiceItem[], pairs: IPositionPair[]): IPositionRow[] {
|
||||
const invoiceByBase = new Map<number, { index: number; note: string }>();
|
||||
const usedInvoice = new Set<number>();
|
||||
|
||||
pairs.forEach((pair) => {
|
||||
const validBase = pair.baseIndex >= 0 && pair.baseIndex < base.length;
|
||||
const validInvoice = pair.invoiceIndex >= 0 && pair.invoiceIndex < invoice.length;
|
||||
if (!validBase || !validInvoice) return;
|
||||
if (invoiceByBase.has(pair.baseIndex) || usedInvoice.has(pair.invoiceIndex)) return;
|
||||
invoiceByBase.set(pair.baseIndex, { index: pair.invoiceIndex, note: pair.note });
|
||||
usedInvoice.add(pair.invoiceIndex);
|
||||
});
|
||||
|
||||
const rows: IPositionRow[] = base.map((position, baseIndex) => {
|
||||
const match = invoiceByBase.get(baseIndex);
|
||||
if (!match) {
|
||||
return { ...basisPart(position), ...emptyInvoicePart(), status: 'missing', note: 'Нет в счёте' };
|
||||
}
|
||||
const item = invoice[match.index];
|
||||
const note = diffNote(position, item, match.note);
|
||||
return { ...basisPart(position), ...invoicePart(item), status: note ? 'diff' : 'ok', note };
|
||||
});
|
||||
|
||||
invoice.forEach((item, index) => {
|
||||
if (usedInvoice.has(index)) return;
|
||||
rows.push({
|
||||
code: '',
|
||||
name: '',
|
||||
unit: '',
|
||||
qty: 0,
|
||||
supplierName: '',
|
||||
supplierQty: 0,
|
||||
supplierPrice: 0,
|
||||
...invoicePart(item),
|
||||
status: 'extra',
|
||||
note: 'Нет в СТ / потребности'
|
||||
});
|
||||
});
|
||||
return rows;
|
||||
}
|
||||
|
||||
/** Есть ли в таблице хоть одно расхождение со счётом. */
|
||||
export function hasPositionIssues(rows: IPositionRow[]): boolean {
|
||||
return rows.some((row) => row.status !== 'ok');
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
{
|
||||
"dataListTitle": "Заявка на оплату — данные",
|
||||
"columns": [
|
||||
{ "internalName": "RequestUniqueCode", "title": "Уникальный код заявки", "type": "Text" },
|
||||
{ "internalName": "RequestStatus", "title": "Статус", "type": "Choice", "choices": ["Черновик", "На согласовании", "Согласовано", "Отклонено", "Возвращена на доработку", "Выполнение", "Закрыта"] },
|
||||
|
||||
{ "internalName": "RequesterEmail", "title": "Заявитель (email)", "type": "Text" },
|
||||
{ "internalName": "RequesterName", "title": "Заявитель (Ф.И.О.)", "type": "Text" },
|
||||
{ "internalName": "RequesterJobTitle", "title": "Должность заявителя", "type": "Text" },
|
||||
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
|
||||
{ "internalName": "Department", "title": "Подразделение", "type": "Text" },
|
||||
{ "internalName": "DepartmentId", "title": "Id подразделения (справочник)", "type": "Text" },
|
||||
{ "internalName": "RequestDate", "title": "Дата заявки", "type": "DateTime", "dateOnly": true },
|
||||
|
||||
{ "internalName": "BasisKind", "title": "Основание (ct / need)", "type": "Text" },
|
||||
{ "internalName": "BasisKey", "title": "Ключ основания (ct:Id / need:oid)", "type": "Text" },
|
||||
{ "internalName": "BasisTitle", "title": "Основание", "type": "Text" },
|
||||
{ "internalName": "ProjectName", "title": "Проект", "type": "Text" },
|
||||
{ "internalName": "ProjectId", "title": "Id проекта", "type": "Text" },
|
||||
{ "internalName": "ProjectManager", "title": "Руководитель проекта (email)", "type": "Text" },
|
||||
{ "internalName": "CompanyId", "title": "Id компании", "type": "Text" },
|
||||
{ "internalName": "CompanyName", "title": "Компания", "type": "Text" },
|
||||
|
||||
{ "internalName": "BankAccountId", "title": "Id банковского счёта (1С)", "type": "Text" },
|
||||
{ "internalName": "BankAccountName", "title": "Банковский счёт", "type": "Text" },
|
||||
{ "internalName": "RecipientName", "title": "Получатель", "type": "Text" },
|
||||
{ "internalName": "RecipientBin", "title": "БИН получателя", "type": "Text" },
|
||||
{ "internalName": "RecipientAccount", "title": "Счёт получателя", "type": "Text" },
|
||||
{ "internalName": "Section", "title": "Раздел", "type": "Text" },
|
||||
{ "internalName": "WorkKind", "title": "Вид работ", "type": "Text" },
|
||||
{ "internalName": "ContractId", "title": "Id договора (1С)", "type": "Text" },
|
||||
{ "internalName": "ContractName", "title": "Договор", "type": "Text" },
|
||||
{ "internalName": "CashFlowGroupId", "title": "Id группы статьи ДДС", "type": "Text" },
|
||||
{ "internalName": "CashFlowGroupName", "title": "Группа статьи ДДС", "type": "Text" },
|
||||
{ "internalName": "CashFlowItemId", "title": "Id статьи ДДС", "type": "Text" },
|
||||
{ "internalName": "CashFlowItemName", "title": "Статья ДДС", "type": "Text" },
|
||||
{ "internalName": "PaymentPurpose", "title": "Назначение платежа", "type": "Note" },
|
||||
{ "internalName": "DeliveryTerms", "title": "Условия доставки", "type": "Note" },
|
||||
{ "internalName": "PaymentTerms", "title": "Условия оплаты", "type": "Note" },
|
||||
|
||||
{ "internalName": "TotalAmount", "title": "Общая сумма", "type": "Number" },
|
||||
{ "internalName": "VatAmount", "title": "НДС", "type": "Number" },
|
||||
{ "internalName": "Currency", "title": "Валюта", "type": "Text" },
|
||||
{ "internalName": "PayAmount", "title": "Сумма оплаты", "type": "Number" },
|
||||
{ "internalName": "DeliveryTime", "title": "Общий срок поставки", "type": "Text" },
|
||||
{ "internalName": "Comment", "title": "Комментарий", "type": "Note" },
|
||||
|
||||
{ "internalName": "InvoiceFileName", "title": "Файл счёта", "type": "Text" },
|
||||
{ "internalName": "InvoiceUrl", "title": "Адрес файла счёта", "type": "Text" },
|
||||
{ "internalName": "InvoiceNumber", "title": "Номер счёта", "type": "Text" },
|
||||
{ "internalName": "InvoiceSupplierName", "title": "Поставщик по счёту", "type": "Text" },
|
||||
{ "internalName": "InvoiceSupplierBin", "title": "БИН поставщика по счёту", "type": "Text" },
|
||||
|
||||
{ "internalName": "PreviousPaymentsJson", "title": "Ранее поданные оплаты (JSON)", "type": "Note" },
|
||||
{ "internalName": "PositionsJson", "title": "Позиции: СТ, поставщик, счёт (JSON)", "type": "Note" }
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
import * as React from 'react';
|
||||
import { TextInput } from '../../../shared/ui';
|
||||
import { parseAmount } from '../amounts';
|
||||
|
||||
interface IAmountInputProps {
|
||||
id?: string;
|
||||
value: number;
|
||||
onChange: (value: number) => void;
|
||||
}
|
||||
|
||||
const toText = (value: number): string => (value ? String(value) : '');
|
||||
|
||||
/**
|
||||
* Поле суммы с десятичной частью. Хранит значение числом, но пока пользователь
|
||||
* печатает, держит собственный текст: иначе «12,» превращалось бы в «12» на
|
||||
* каждом нажатии и дробную часть ввести было бы нельзя.
|
||||
*/
|
||||
export const AmountInput: React.FC<IAmountInputProps> = ({ id, value, onChange }) => {
|
||||
const [text, setText] = React.useState<string>(toText(value));
|
||||
|
||||
// Значение изменили снаружи (подставил счёт, загрузилась заявка) — показываем его.
|
||||
React.useEffect(() => {
|
||||
setText((current) => (parseAmount(current) === value ? current : toText(value)));
|
||||
}, [value]);
|
||||
|
||||
return (
|
||||
<TextInput
|
||||
id={id}
|
||||
value={text}
|
||||
onChange={(next) => {
|
||||
setText(next);
|
||||
onChange(parseAmount(next));
|
||||
}}
|
||||
/>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,78 @@
|
||||
import * as React from 'react';
|
||||
import styles from './PaymentSections.module.scss';
|
||||
import { FormGrid, FormField, TextInput, TextArea } from '../../../shared/ui';
|
||||
import { formatAmount, overLimitAmount, previousPaymentsTotal } from '../amounts';
|
||||
import { ISectionProps } from '../model';
|
||||
import { AmountInput } from './AmountInput';
|
||||
|
||||
/**
|
||||
* Суммы платежа. Сумма всех оплат по СТ (прежние заявки + эта) не может превышать
|
||||
* общую сумму СТ — при превышении сумма оплаты подсвечивается, отправку это не блокирует.
|
||||
*/
|
||||
export const AmountsSection: React.FC<ISectionProps> = ({ data, set }) => {
|
||||
const over = overLimitAmount(data);
|
||||
const previousTotal = previousPaymentsTotal(data.PreviousPayments);
|
||||
|
||||
return (
|
||||
<>
|
||||
<FormGrid>
|
||||
<FormField label="Общая сумма" htmlFor="TotalAmount">
|
||||
<AmountInput id="TotalAmount" value={data.TotalAmount} onChange={(v) => set('TotalAmount', v)} />
|
||||
</FormField>
|
||||
<FormField label="Валюта" htmlFor="Currency">
|
||||
<TextInput id="Currency" value={data.Currency} onChange={(v) => set('Currency', v.toUpperCase())} placeholder="KZT" />
|
||||
</FormField>
|
||||
<FormField label="НДС" htmlFor="VatAmount">
|
||||
<AmountInput id="VatAmount" value={data.VatAmount} onChange={(v) => set('VatAmount', v)} />
|
||||
</FormField>
|
||||
<FormField label="Сумма оплаты" htmlFor="PayAmount" required>
|
||||
<div className={over > 0 ? styles.warnBox : undefined}>
|
||||
<AmountInput id="PayAmount" value={data.PayAmount} onChange={(v) => set('PayAmount', v)} />
|
||||
{over > 0 && (
|
||||
<div className={styles.warnText}>
|
||||
Все оплаты по основанию превышают общую сумму на {formatAmount(over)} {data.Currency}.
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</FormField>
|
||||
|
||||
<FormField label="Общий срок поставки" htmlFor="DeliveryTime">
|
||||
<TextInput id="DeliveryTime" value={data.DeliveryTime} onChange={(v) => set('DeliveryTime', v)} />
|
||||
</FormField>
|
||||
<FormField label="Комментарий" htmlFor="Comment" full>
|
||||
<TextArea id="Comment" value={data.Comment} onChange={(v) => set('Comment', v)} rows={2} />
|
||||
</FormField>
|
||||
</FormGrid>
|
||||
|
||||
<h4>Заявки на оплату по этому основанию</h4>
|
||||
{data.PreviousPayments.length === 0 ? (
|
||||
<div className={styles.empty}>Ранее заявок на оплату по этому основанию не было.</div>
|
||||
) : (
|
||||
<div className={styles.tableWrap}>
|
||||
<table className={styles.table}>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Номер заявки на оплату</th>
|
||||
<th className={styles.num}>Сумма оплаты</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{data.PreviousPayments.map((p) => (
|
||||
<tr key={p.code}>
|
||||
<td>{p.code}</td>
|
||||
<td className={styles.num}>{formatAmount(p.amount)}</td>
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
<tfoot>
|
||||
<tr>
|
||||
<td>Итого ранее</td>
|
||||
<td className={styles.num}>{formatAmount(previousTotal)}</td>
|
||||
</tr>
|
||||
</tfoot>
|
||||
</table>
|
||||
</div>
|
||||
)}
|
||||
</>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,65 @@
|
||||
import * as React from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { IDictionaryItem, ItemPicker } from '../../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../../shared/diagnostics';
|
||||
import { BasisKind } from '../model';
|
||||
import { IBasisOption } from '../services/basis.types';
|
||||
import { listApprovedCts } from '../services/ctBasis.service';
|
||||
import { listNeeds } from '../services/needBasis.service';
|
||||
|
||||
interface IBasisPickerProps {
|
||||
context: WebPartContext;
|
||||
kind: BasisKind;
|
||||
/** Подпись выбранного основания. */
|
||||
value: string;
|
||||
onPick: (id: string) => void;
|
||||
readOnly?: boolean;
|
||||
}
|
||||
|
||||
function toPickerItem(option: IBasisOption): IDictionaryItem {
|
||||
return { id: option.id, label: option.title, note: option.note };
|
||||
}
|
||||
|
||||
/**
|
||||
* Поиск основания: согласованные СТ либо потребности (по выбранному виду основания).
|
||||
* Выбор запускает загрузку СТ/потребности целиком (см. useBasisSelection), поэтому
|
||||
* ручной ввод текста основанием не считается — onPick зовётся только с id записи.
|
||||
*/
|
||||
export const BasisPicker: React.FC<IBasisPickerProps> = ({ context, kind, value, onPick, readOnly }) => {
|
||||
const [items, setItems] = React.useState<IDictionaryItem[]>([]);
|
||||
const [error, setError] = React.useState<string>('');
|
||||
// null — показываем выбранное основание; строка — пользователь печатает запрос (в т.ч. пустой).
|
||||
const [query, setQuery] = React.useState<string | null>(null);
|
||||
|
||||
React.useEffect(() => {
|
||||
if (readOnly) return undefined;
|
||||
let alive = true;
|
||||
setError('');
|
||||
setItems([]);
|
||||
(kind === 'ct' ? listApprovedCts(context) : listNeeds(context))
|
||||
.then((options) => {
|
||||
if (alive) setItems(options.map(toPickerItem));
|
||||
})
|
||||
.catch((e) => {
|
||||
if (alive) setError(`Не удалось загрузить список: ${friendlyErrorMessage(e)}`);
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [context, kind, readOnly]);
|
||||
|
||||
return (
|
||||
<ItemPicker
|
||||
id="BasisTitle"
|
||||
items={items}
|
||||
value={query ?? value}
|
||||
readOnly={readOnly}
|
||||
placeholder={kind === 'ct' ? 'Найдите согласованную СТ по номеру или проекту…' : 'Найдите потребность по номеру или проекту…'}
|
||||
hint={error}
|
||||
onChange={(label, id) => {
|
||||
setQuery(id ? null : label);
|
||||
if (id) onPick(id);
|
||||
}}
|
||||
/>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,88 @@
|
||||
import * as React from 'react';
|
||||
import { Alert, FormGrid, FormField, Select, ISelectOption } from '../../../shared/ui';
|
||||
import { ICompany, ProjectPicker, getCompanies } from '../../../shared/dictionary';
|
||||
import { BASIS_OPTIONS, BasisKind, ISectionProps } from '../model';
|
||||
import { IBasisSelection } from '../useBasisSelection';
|
||||
import { BasisPicker } from './BasisPicker';
|
||||
|
||||
interface IBasisSectionProps extends ISectionProps {
|
||||
basis: IBasisSelection;
|
||||
}
|
||||
|
||||
const KIND_OPTIONS: ISelectOption[] = BASIS_OPTIONS.map((o) => ({ value: o.value, label: o.label }));
|
||||
|
||||
/**
|
||||
* Основание оплаты: согласованная СТ либо потребность. Выбор основания подставляет
|
||||
* проект, раздел, вид работ, условия, суммы и позиции (см. basisPatch) — всё это
|
||||
* остаётся редактируемым. Проект определяет маршрут согласования.
|
||||
*/
|
||||
export const BasisSection: React.FC<IBasisSectionProps> = ({ data, patch, context, basis }) => {
|
||||
const [companies, setCompanies] = React.useState<ICompany[]>([]);
|
||||
|
||||
React.useEffect(() => {
|
||||
let alive = true;
|
||||
getCompanies(context)
|
||||
.then((list) => {
|
||||
if (alive) setCompanies(list);
|
||||
})
|
||||
.catch(() => undefined);
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [context]);
|
||||
|
||||
const companyOptions: ISelectOption[] = companies.map((c) => ({ value: c.Id, label: c.Name }));
|
||||
// Компания из заявки может отсутствовать в справочнике (его не удалось загрузить) — показываем её как есть.
|
||||
if (data.CompanyId && !companies.some((c) => c.Id === data.CompanyId)) {
|
||||
companyOptions.push({ value: data.CompanyId, label: data.CompanyName });
|
||||
}
|
||||
|
||||
const handleKindChange = (value: string): void => {
|
||||
patch({ BasisKind: value as BasisKind, BasisKey: '', BasisTitle: '', PreviousPayments: [], Positions: [] });
|
||||
};
|
||||
|
||||
return (
|
||||
<>
|
||||
<FormGrid>
|
||||
<FormField label="Основание" htmlFor="BasisKind" required>
|
||||
<Select id="BasisKind" value={data.BasisKind} onChange={handleKindChange} options={KIND_OPTIONS} />
|
||||
</FormField>
|
||||
<FormField label={data.BasisKind === 'ct' ? 'Согласованная СТ' : 'Потребность'} htmlFor="BasisTitle" required>
|
||||
<BasisPicker
|
||||
context={context}
|
||||
kind={data.BasisKind}
|
||||
value={data.BasisTitle}
|
||||
onPick={(id) => {
|
||||
basis.select(data.BasisKind, id).catch(() => undefined);
|
||||
}}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Проект" htmlFor="ProjectName" required>
|
||||
<ProjectPicker
|
||||
id="ProjectName"
|
||||
context={context}
|
||||
value={data.ProjectName}
|
||||
placeholder="Начните вводить название проекта…"
|
||||
onChange={(name, id, project) => {
|
||||
patch({ ProjectName: name, ProjectId: id, ProjectManager: project ? project.projectManager || '' : '' });
|
||||
}}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Компания" htmlFor="CompanyId" required>
|
||||
<Select
|
||||
id="CompanyId"
|
||||
value={data.CompanyId}
|
||||
onChange={(id) => {
|
||||
const company = companies.filter((c) => c.Id === id)[0];
|
||||
patch({ CompanyId: id, CompanyName: company ? company.Name : '' });
|
||||
}}
|
||||
options={companyOptions}
|
||||
placeholder="Выберите компанию…"
|
||||
/>
|
||||
</FormField>
|
||||
</FormGrid>
|
||||
{basis.loading && <Alert variant="info">Загружаем данные основания…</Alert>}
|
||||
{basis.error && <Alert variant="err">{basis.error}</Alert>}
|
||||
</>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,37 @@
|
||||
import * as React from 'react';
|
||||
import { FormGrid, FormField, TextInput, PeopleField, OrganizationField } from '../../../shared/ui';
|
||||
import { DepartmentPicker } from '../../../shared/dictionary';
|
||||
import { ISectionProps } from '../model';
|
||||
|
||||
/** Шапка заявки: кто подаёт (по умолчанию текущий пользователь), должность, подразделение, дата. */
|
||||
export const HeaderSection: React.FC<ISectionProps> = ({ data, set, context, printOrgIndex, onRequesterChange }) => (
|
||||
<FormGrid>
|
||||
<FormField label="Заявитель" htmlFor="RequesterEmail" required full>
|
||||
<PeopleField
|
||||
context={context}
|
||||
value={data.RequesterEmail}
|
||||
onChange={onRequesterChange ?? ((v) => set('RequesterEmail', v))}
|
||||
placeholder="Начните вводить Ф.И.О. заявителя…"
|
||||
/>
|
||||
</FormField>
|
||||
<OrganizationField value={data.Organization} printIndex={printOrgIndex} />
|
||||
|
||||
<FormField label="Должность заявителя" htmlFor="RequesterJobTitle">
|
||||
<TextInput id="RequesterJobTitle" value={data.RequesterJobTitle} onChange={(v) => set('RequesterJobTitle', v)} />
|
||||
</FormField>
|
||||
<FormField label="Подразделение" htmlFor="Department">
|
||||
<DepartmentPicker
|
||||
id="Department"
|
||||
context={context}
|
||||
value={data.Department}
|
||||
onChange={(name, id) => {
|
||||
set('Department', name);
|
||||
set('DepartmentId', id);
|
||||
}}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Дата заявки" htmlFor="RequestDate">
|
||||
<TextInput id="RequestDate" type="date" value={data.RequestDate} onChange={(v) => set('RequestDate', v)} />
|
||||
</FormField>
|
||||
</FormGrid>
|
||||
);
|
||||
@@ -0,0 +1,70 @@
|
||||
import * as React from 'react';
|
||||
import styles from './PaymentSections.module.scss';
|
||||
import { Alert, Button, Icon, useFormReadOnly } from '../../../shared/ui';
|
||||
import { DATA_SITE_URL } from '../../../shared/config';
|
||||
import { IFormData } from '../model';
|
||||
import { INVOICE_STAGE_TEXT, IInvoiceFlow } from '../useInvoiceFlow';
|
||||
|
||||
interface IInvoiceSectionProps {
|
||||
data: IFormData;
|
||||
invoice: IInvoiceFlow;
|
||||
}
|
||||
|
||||
/** Ссылка на файл счёта: в данных лежит серверный относительный адрес. */
|
||||
function invoiceHref(serverRelativeUrl: string): string {
|
||||
return new URL(serverRelativeUrl, DATA_SITE_URL).href;
|
||||
}
|
||||
|
||||
/**
|
||||
* Вложение — счёт на оплату (PDF). Файл сохраняется в библиотеку и уходит на OCR;
|
||||
* ИИ достаёт из текста реквизиты, суммы и позиции и подставляет их в форму.
|
||||
* Если распознать не вышло, счёт всё равно остаётся приложенным — поля заполняются руками.
|
||||
*/
|
||||
export const InvoiceSection: React.FC<IInvoiceSectionProps> = ({ data, invoice }) => {
|
||||
const readOnly = useFormReadOnly();
|
||||
const inputRef = React.useRef<HTMLInputElement>(null);
|
||||
const busy = invoice.stage !== 'idle';
|
||||
|
||||
return (
|
||||
<div>
|
||||
<div className={styles.invoiceRow}>
|
||||
{data.InvoiceFileName ? (
|
||||
<span>
|
||||
<Icon name="document" size="sm" />{' '}
|
||||
{data.InvoiceUrl ? (
|
||||
<a href={invoiceHref(data.InvoiceUrl)} target="_blank" rel="noreferrer">
|
||||
{data.InvoiceFileName}
|
||||
</a>
|
||||
) : (
|
||||
data.InvoiceFileName
|
||||
)}
|
||||
{data.InvoiceNumber && ` — счёт № ${data.InvoiceNumber}`}
|
||||
</span>
|
||||
) : (
|
||||
<span className={styles.hint}>Счёт ещё не приложен.</span>
|
||||
)}
|
||||
{!readOnly && (
|
||||
<>
|
||||
<input
|
||||
ref={inputRef}
|
||||
className={styles.fileInput}
|
||||
type="file"
|
||||
accept="application/pdf,.pdf"
|
||||
onChange={(e) => {
|
||||
const file = e.target.files?.[0];
|
||||
e.target.value = '';
|
||||
if (file) invoice.attach(file).catch(() => undefined);
|
||||
}}
|
||||
/>
|
||||
<Button variant="secondary" disabled={busy} onClick={() => inputRef.current?.click()}>
|
||||
<Icon name="upload" size="sm" />
|
||||
{data.InvoiceFileName ? 'Заменить счёт' : 'Приложить счёт (PDF)'}
|
||||
</Button>
|
||||
</>
|
||||
)}
|
||||
{busy && <span className={styles.stage}>{INVOICE_STAGE_TEXT[invoice.stage]}</span>}
|
||||
</div>
|
||||
{invoice.error && <Alert variant="warn">{invoice.error}</Alert>}
|
||||
</div>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,98 @@
|
||||
import * as React from 'react';
|
||||
import styles from './PaymentSections.module.scss';
|
||||
import { FormGrid, FormField, TextInput, TextArea } from '../../../shared/ui';
|
||||
import { DictionaryPicker } from '../../../shared/dictionary';
|
||||
import { recipientMatchesInvoice } from '../amounts';
|
||||
import { ISectionProps } from '../model';
|
||||
|
||||
/**
|
||||
* Реквизиты платежа. Банковский счёт, договор и статьи ДДС — из справочников 1С
|
||||
* (счета и договоры фильтруются по выбранной компании и проекту). Получатель — победитель
|
||||
* СТ; если в самом счёте указан другой контрагент, поле подсвечивается.
|
||||
*/
|
||||
export const PaymentSection: React.FC<ISectionProps> = ({ data, set, patch, context }) => {
|
||||
const recipientMatches = recipientMatchesInvoice(
|
||||
{ name: data.RecipientName, bin: data.RecipientBin },
|
||||
{ name: data.InvoiceSupplierName, bin: data.InvoiceSupplierBin }
|
||||
);
|
||||
const accountParams = { companyId: data.CompanyId, projectId: data.ProjectId };
|
||||
|
||||
return (
|
||||
<FormGrid>
|
||||
<FormField label="Банковский счёт" htmlFor="BankAccountName" required>
|
||||
<DictionaryPicker
|
||||
id="BankAccountName"
|
||||
context={context}
|
||||
path="BankAccounts"
|
||||
params={accountParams}
|
||||
value={data.BankAccountName}
|
||||
placeholder="Счёт компании в 1С…"
|
||||
onChange={(label, id) => patch({ BankAccountName: label, BankAccountId: id })}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Договор" htmlFor="ContractName">
|
||||
<DictionaryPicker
|
||||
id="ContractName"
|
||||
context={context}
|
||||
path="Contracts"
|
||||
params={{ companyId: data.CompanyId }}
|
||||
value={data.ContractName}
|
||||
placeholder="Договор из 1С…"
|
||||
onChange={(label, id) => patch({ ContractName: label, ContractId: id })}
|
||||
/>
|
||||
</FormField>
|
||||
|
||||
<FormField label="Получатель" htmlFor="RecipientName" required>
|
||||
<div className={recipientMatches ? undefined : styles.warnBox}>
|
||||
<TextInput id="RecipientName" value={data.RecipientName} onChange={(v) => set('RecipientName', v)} />
|
||||
{!recipientMatches && (
|
||||
<div className={styles.warnText}>
|
||||
В счёте указан другой контрагент: {data.InvoiceSupplierName || '—'}
|
||||
{data.InvoiceSupplierBin ? ` (БИН ${data.InvoiceSupplierBin})` : ''}. Проверьте получателя.
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</FormField>
|
||||
<FormField label="Счёт получателя (IBAN)" htmlFor="RecipientAccount" required>
|
||||
<TextInput id="RecipientAccount" value={data.RecipientAccount} onChange={(v) => set('RecipientAccount', v)} />
|
||||
</FormField>
|
||||
|
||||
<FormField label="Раздел" htmlFor="Section">
|
||||
<TextInput id="Section" value={data.Section} onChange={(v) => set('Section', v)} />
|
||||
</FormField>
|
||||
<FormField label="Вид работ" htmlFor="WorkKind">
|
||||
<TextInput id="WorkKind" value={data.WorkKind} onChange={(v) => set('WorkKind', v)} />
|
||||
</FormField>
|
||||
|
||||
<FormField label="Группа статьи ДДС" htmlFor="CashFlowGroupName" required>
|
||||
<DictionaryPicker
|
||||
id="CashFlowGroupName"
|
||||
context={context}
|
||||
path="CashFlowItemGroups"
|
||||
value={data.CashFlowGroupName}
|
||||
onChange={(label, id) => patch({ CashFlowGroupName: label, CashFlowGroupId: id, CashFlowItemName: '', CashFlowItemId: '' })}
|
||||
/>
|
||||
</FormField>
|
||||
<FormField label="Статья ДДС" htmlFor="CashFlowItemName" required>
|
||||
<DictionaryPicker
|
||||
id="CashFlowItemName"
|
||||
context={context}
|
||||
path="CashFlowItems"
|
||||
params={{ groupId: data.CashFlowGroupId }}
|
||||
value={data.CashFlowItemName}
|
||||
onChange={(label, id) => patch({ CashFlowItemName: label, CashFlowItemId: id })}
|
||||
/>
|
||||
</FormField>
|
||||
|
||||
<FormField label="Назначение платежа" htmlFor="PaymentPurpose" required full>
|
||||
<TextArea id="PaymentPurpose" value={data.PaymentPurpose} onChange={(v) => set('PaymentPurpose', v)} rows={2} />
|
||||
</FormField>
|
||||
<FormField label="Условия доставки" htmlFor="DeliveryTerms">
|
||||
<TextArea id="DeliveryTerms" value={data.DeliveryTerms} onChange={(v) => set('DeliveryTerms', v)} rows={2} />
|
||||
</FormField>
|
||||
<FormField label="Условия оплаты" htmlFor="PaymentTerms">
|
||||
<TextArea id="PaymentTerms" value={data.PaymentTerms} onChange={(v) => set('PaymentTerms', v)} rows={2} />
|
||||
</FormField>
|
||||
</FormGrid>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,99 @@
|
||||
@import '../../../../../styles/design-tokens';
|
||||
|
||||
// Подсветка расхождений: поле, значение которого стоит перепроверить, обводится
|
||||
// красным, а под ним — пояснение. Подсветка не блокирует отправку: решает человек.
|
||||
.warnBox {
|
||||
padding: $sp-1;
|
||||
border: 1px solid $red-500;
|
||||
border-radius: $r-sm;
|
||||
background: $red-50;
|
||||
}
|
||||
|
||||
.warnText {
|
||||
margin-top: $sp-1;
|
||||
font-size: $fs-caption;
|
||||
color: $red-500;
|
||||
}
|
||||
|
||||
.hint {
|
||||
margin-top: $sp-1;
|
||||
font-size: $fs-caption;
|
||||
color: $gray-500;
|
||||
}
|
||||
|
||||
.invoiceRow {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
gap: $sp-4;
|
||||
}
|
||||
|
||||
.fileInput {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.stage {
|
||||
font-size: $fs-sm;
|
||||
color: $navy-700;
|
||||
}
|
||||
|
||||
.tableWrap {
|
||||
overflow-x: auto;
|
||||
border: 1px solid $gray-200;
|
||||
border-radius: $r-sm;
|
||||
}
|
||||
|
||||
.table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
font-size: $fs-sm;
|
||||
|
||||
th,
|
||||
td {
|
||||
padding: 8px 10px;
|
||||
border-bottom: 1px solid $gray-200;
|
||||
text-align: left;
|
||||
vertical-align: top;
|
||||
}
|
||||
|
||||
th {
|
||||
background: $gray-50;
|
||||
font-size: $fs-caption;
|
||||
font-weight: 600;
|
||||
color: $gray-700;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
tfoot td {
|
||||
font-weight: 600;
|
||||
background: $gray-50;
|
||||
}
|
||||
}
|
||||
|
||||
.num {
|
||||
text-align: right !important;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.rowDiff {
|
||||
background: $gold-50;
|
||||
}
|
||||
|
||||
.rowBad {
|
||||
background: $red-50;
|
||||
}
|
||||
|
||||
.rowOk {
|
||||
color: $green-600;
|
||||
}
|
||||
|
||||
.statusBad {
|
||||
color: $red-500;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.empty {
|
||||
padding: $sp-4;
|
||||
color: $gray-500;
|
||||
font-size: $fs-sm;
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
import * as React from 'react';
|
||||
import styles from './PaymentSections.module.scss';
|
||||
import { Alert } from '../../../shared/ui';
|
||||
import { formatAmount } from '../amounts';
|
||||
import { IPositionRow, RowStatus } from '../model';
|
||||
import { hasPositionIssues } from '../positions';
|
||||
|
||||
interface IPositionsSectionProps {
|
||||
rows: IPositionRow[];
|
||||
/** Счёт приложен и сверка выполнялась — только тогда статусы строк что-то значат. */
|
||||
compared: boolean;
|
||||
}
|
||||
|
||||
const STATUS_LABEL: Record<RowStatus, string> = {
|
||||
ok: 'Совпадает',
|
||||
diff: 'Расхождение',
|
||||
missing: 'Нет в счёте',
|
||||
extra: 'Нет в СТ'
|
||||
};
|
||||
|
||||
function rowClass(row: IPositionRow, compared: boolean): string | undefined {
|
||||
if (!compared) return undefined;
|
||||
if (row.status === 'diff') return styles.rowDiff;
|
||||
if (row.status === 'missing' || row.status === 'extra') return styles.rowBad;
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const cell = (value: number): string => (value ? formatAmount(value) : '');
|
||||
|
||||
/**
|
||||
* Позиции: из СТ/потребности (код, наименование, ед. изм.), позиции поставщика и
|
||||
* позиции из счёта. Строки с расхождениями подсвечены; сверку выполняет ИИ при
|
||||
* загрузке счёта, количество и единицы сверяются кодом.
|
||||
*/
|
||||
export const PositionsSection: React.FC<IPositionsSectionProps> = ({ rows, compared }) => {
|
||||
if (rows.length === 0) {
|
||||
return <div className={styles.empty}>Позиции появятся после выбора основания.</div>;
|
||||
}
|
||||
return (
|
||||
<>
|
||||
{compared && hasPositionIssues(rows) && (
|
||||
<Alert variant="warn">Позиции счёта отличаются от СТ/потребности — расхождения подсвечены.</Alert>
|
||||
)}
|
||||
<div className={styles.tableWrap}>
|
||||
<table className={styles.table}>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Код</th>
|
||||
<th>Наименование (потребность)</th>
|
||||
<th>Ед. изм.</th>
|
||||
<th className={styles.num}>Кол-во</th>
|
||||
<th>Позиция поставщика</th>
|
||||
<th>Позиция из счёта</th>
|
||||
<th className={styles.num}>Кол-во в счёте</th>
|
||||
<th className={styles.num}>Цена</th>
|
||||
<th className={styles.num}>Сумма</th>
|
||||
{compared && <th>Сверка</th>}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((row, index) => (
|
||||
<tr key={`${row.code}-${index}`} className={rowClass(row, compared)}>
|
||||
<td>{row.code}</td>
|
||||
<td>{row.name}</td>
|
||||
<td>{row.unit}</td>
|
||||
<td className={styles.num}>{cell(row.qty)}</td>
|
||||
<td>{row.supplierName}</td>
|
||||
<td>{row.invoiceName}</td>
|
||||
<td className={styles.num}>{cell(row.invoiceQty)}</td>
|
||||
<td className={styles.num}>{cell(row.invoicePrice)}</td>
|
||||
<td className={styles.num}>{cell(row.invoiceSum)}</td>
|
||||
{compared && (
|
||||
<td className={row.status === 'ok' ? styles.rowOk : styles.statusBad}>
|
||||
{STATUS_LABEL[row.status]}
|
||||
{row.note && row.status !== 'ok' && <div>{row.note}</div>}
|
||||
</td>
|
||||
)}
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</>
|
||||
);
|
||||
};
|
||||
@@ -0,0 +1,47 @@
|
||||
import { BasisKind } from '../model';
|
||||
|
||||
/** Позиция основания: из СТ (с предложением победителя) либо из потребности. */
|
||||
export interface IBasisPosition {
|
||||
/** Уникальный код позиции потребности; '' — у потребности его нет. */
|
||||
code: string;
|
||||
name: string;
|
||||
unit: string;
|
||||
qty: number;
|
||||
/** Позиция поставщика из его КП; '' / 0 — у потребности КП нет. */
|
||||
supplierName: string;
|
||||
supplierQty: number;
|
||||
supplierPrice: number;
|
||||
}
|
||||
|
||||
/** Всё, что форма берёт из выбранной СТ или потребности. */
|
||||
export interface IBasisInfo {
|
||||
kind: BasisKind;
|
||||
/** «ct:<Id СТ>» / «need:<oid потребности>» — по нему ищем прежние оплаты. */
|
||||
key: string;
|
||||
title: string;
|
||||
projectName: string;
|
||||
/** Раздел и вид работ. */
|
||||
section: string;
|
||||
workKind: string;
|
||||
/** Компания-заказчик, если известна (подбирается по справочнику компаний). */
|
||||
companyHint: string;
|
||||
/** Выигравший поставщик СТ; у потребности пустой. */
|
||||
recipientName: string;
|
||||
recipientBin: string;
|
||||
/** Общая сумма основания и её валюта; 0 — не определена. */
|
||||
total: number;
|
||||
currency: string;
|
||||
deliveryTerms: string;
|
||||
paymentTerms: string;
|
||||
deliveryTime: string;
|
||||
positions: IBasisPosition[];
|
||||
}
|
||||
|
||||
/** Строка выпадающего списка выбора основания. */
|
||||
export interface IBasisOption {
|
||||
/** Id СТ либо oid потребности. */
|
||||
id: string;
|
||||
title: string;
|
||||
/** Пояснение: проект, дата, число позиций. */
|
||||
note: string;
|
||||
}
|
||||
@@ -0,0 +1,210 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { CT_SITE_URL } from '../../../shared/config';
|
||||
import { spForSite } from '../../../shared/pnp/pnpjs';
|
||||
import { IBasisInfo, IBasisOption, IBasisPosition } from './basis.types';
|
||||
|
||||
// Списки сайта СТ (см. ct-forms-portal, CtService.LISTS) — имена те же.
|
||||
const CT_LISTS = {
|
||||
ct: 'Сравнительная таблица',
|
||||
positions: 'Позиции СТ',
|
||||
offers: 'Оценка поставщиков',
|
||||
suppliers: 'Поставщики',
|
||||
criteria: 'Критерии',
|
||||
rates: 'Курс Валют'
|
||||
};
|
||||
|
||||
/** Значение Choice «Статус» у согласованной СТ. */
|
||||
const CT_STATUS_APPROVED = 'Согласовано';
|
||||
/** Валюта предложений без подстановки «Валюта» — в СТ это тенге. */
|
||||
const DEFAULT_CURRENCY = 'KZT';
|
||||
const MAX_CTS = 500;
|
||||
const MAX_POSITIONS = 500;
|
||||
/** Сколько позиций кладём в один OR-фильтр: длинная строка запроса SharePoint не принимает. */
|
||||
const FILTER_CHUNK = 20;
|
||||
|
||||
interface ICtRow {
|
||||
Id: number;
|
||||
number?: number | string;
|
||||
project?: string;
|
||||
winSupplierId?: number;
|
||||
}
|
||||
|
||||
interface IPositionRow {
|
||||
Id: number;
|
||||
Title?: string;
|
||||
unit?: string;
|
||||
quantity?: number;
|
||||
disciplineCode?: string;
|
||||
SMR?: string;
|
||||
uniqueCode?: string;
|
||||
}
|
||||
|
||||
interface IOfferRow {
|
||||
positionId: number;
|
||||
supplierPosition?: string;
|
||||
quantity?: number;
|
||||
price?: number;
|
||||
summa?: number;
|
||||
summaTenge?: number;
|
||||
valutaId?: number;
|
||||
}
|
||||
|
||||
interface ICriteriaRow {
|
||||
paymentType?: string;
|
||||
deliveryType?: string;
|
||||
deadline?: string;
|
||||
criteriaLabel?: string;
|
||||
}
|
||||
|
||||
function ctWeb(context: WebPartContext): ReturnType<typeof spForSite>['web'] {
|
||||
return spForSite(CT_SITE_URL, context).web;
|
||||
}
|
||||
|
||||
function chunk<T>(items: T[], size: number): T[][] {
|
||||
const result: T[][] = [];
|
||||
for (let i = 0; i < items.length; i += size) result.push(items.slice(i, i + size));
|
||||
return result;
|
||||
}
|
||||
|
||||
function unique(values: Array<string | undefined>): string[] {
|
||||
const seen: string[] = [];
|
||||
values.forEach((v) => {
|
||||
const value = (v || '').trim();
|
||||
if (value && seen.indexOf(value) === -1) seen.push(value);
|
||||
});
|
||||
return seen;
|
||||
}
|
||||
|
||||
function ctTitle(row: ICtRow): string {
|
||||
return `СТ №${row.number ?? row.Id}${row.project ? ` — ${row.project}` : ''}`;
|
||||
}
|
||||
|
||||
/** Согласованные СТ для выбора основания, новые сверху. */
|
||||
export async function listApprovedCts(context: WebPartContext): Promise<IBasisOption[]> {
|
||||
const rows = (await ctWeb(context)
|
||||
.lists.getByTitle(CT_LISTS.ct)
|
||||
.items.select('Id', 'number', 'project', 'winSupplierId')
|
||||
.filter(`status eq '${CT_STATUS_APPROVED}'`)
|
||||
.orderBy('Id', false)
|
||||
.top(MAX_CTS)()) as ICtRow[];
|
||||
return rows.map((row) => ({
|
||||
id: String(row.Id),
|
||||
title: ctTitle(row),
|
||||
note: row.winSupplierId ? '' : 'победитель не выбран'
|
||||
}));
|
||||
}
|
||||
|
||||
/** Предложения победителя по позициям СТ (по чанкам — см. FILTER_CHUNK). */
|
||||
async function loadWinnerOffers(
|
||||
context: WebPartContext,
|
||||
supplierId: number,
|
||||
positionIds: number[]
|
||||
): Promise<IOfferRow[]> {
|
||||
const lists = ctWeb(context).lists;
|
||||
const parts = await Promise.all(
|
||||
chunk(positionIds, FILTER_CHUNK).map((ids) =>
|
||||
lists
|
||||
.getByTitle(CT_LISTS.offers)
|
||||
.items.select('Id', 'positionId', 'supplierPosition', 'quantity', 'price', 'summa', 'summaTenge', 'valutaId')
|
||||
.filter(`supplierId eq ${supplierId} and (${ids.map((id) => `positionId eq ${id}`).join(' or ')})`)
|
||||
.top(MAX_POSITIONS)()
|
||||
)
|
||||
);
|
||||
return ([] as IOfferRow[]).concat(...(parts as IOfferRow[][]));
|
||||
}
|
||||
|
||||
/** Код валюты по Id записи «Курс Валют»; пустая подстановка — тенге. */
|
||||
async function loadCurrencyCodes(context: WebPartContext, ids: number[]): Promise<Map<number, string>> {
|
||||
const codes = new Map<number, string>();
|
||||
await Promise.all(
|
||||
ids.map(async (id) => {
|
||||
const rate = (await ctWeb(context).lists.getByTitle(CT_LISTS.rates).items.getById(id).select('code')()) as { code?: string };
|
||||
codes.set(id, rate.code || DEFAULT_CURRENCY);
|
||||
})
|
||||
);
|
||||
return codes;
|
||||
}
|
||||
|
||||
/** Условия победителя из «Критериев» СТ: оплата, доставка, срок. */
|
||||
async function loadWinnerTerms(context: WebPartContext, ctId: number, supplierId: number): Promise<ICriteriaRow> {
|
||||
const rows = (await ctWeb(context)
|
||||
.lists.getByTitle(CT_LISTS.criteria)
|
||||
.items.select('Id', 'paymentType', 'deliveryType', 'deadline', 'criteriaLabel')
|
||||
.filter(`CTId eq ${ctId} and supplierId eq ${supplierId}`)
|
||||
.top(MAX_POSITIONS)()) as ICriteriaRow[];
|
||||
// Строки с criteriaLabel — произвольные критерии, а не условия поставки.
|
||||
return rows.filter((r) => !r.criteriaLabel && (r.paymentType || r.deliveryType || r.deadline))[0] || {};
|
||||
}
|
||||
|
||||
function toBasisPosition(position: IPositionRow, offers: IOfferRow[]): IBasisPosition {
|
||||
return {
|
||||
code: position.uniqueCode || '',
|
||||
name: position.Title || '',
|
||||
unit: position.unit || '',
|
||||
qty: Number(position.quantity || 0),
|
||||
supplierName: unique(offers.map((o) => o.supplierPosition)).join(' / '),
|
||||
supplierQty: offers.reduce((sum, o) => sum + Number(o.quantity || 0), 0),
|
||||
supplierPrice: Number(offers[0]?.price || 0)
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Общая сумма предложений победителя. Все в одной валюте — суммируем «Сумма» в
|
||||
* этой валюте; смешанные — берём «Сумма в тенге», иначе числа несопоставимы.
|
||||
*/
|
||||
function offersTotal(offers: IOfferRow[], codes: Map<number, string>): { total: number; currency: string } {
|
||||
const currencies = unique(offers.map((o) => (o.valutaId ? codes.get(o.valutaId) : DEFAULT_CURRENCY)));
|
||||
if (currencies.length > 1) {
|
||||
return { total: offers.reduce((s, o) => s + Number(o.summaTenge || 0), 0), currency: DEFAULT_CURRENCY };
|
||||
}
|
||||
return { total: offers.reduce((s, o) => s + Number(o.summa || 0), 0), currency: currencies[0] || DEFAULT_CURRENCY };
|
||||
}
|
||||
|
||||
/** Всё, что форма берёт из согласованной СТ: победитель, позиции, суммы, условия. */
|
||||
export async function loadCtBasis(context: WebPartContext, ctId: string): Promise<IBasisInfo> {
|
||||
const web = ctWeb(context);
|
||||
const id = parseInt(ctId, 10);
|
||||
const [ct, positions] = await Promise.all([
|
||||
web.lists.getByTitle(CT_LISTS.ct).items.getById(id).select('Id', 'number', 'project', 'winSupplierId')() as Promise<ICtRow>,
|
||||
web.lists
|
||||
.getByTitle(CT_LISTS.positions)
|
||||
.items.select('Id', 'Title', 'unit', 'quantity', 'disciplineCode', 'SMR', 'uniqueCode')
|
||||
.filter(`CTId eq ${id}`)
|
||||
.top(MAX_POSITIONS)() as Promise<IPositionRow[]>
|
||||
]);
|
||||
|
||||
const winnerId = ct.winSupplierId || 0;
|
||||
const [winner, offers, terms] = await Promise.all([
|
||||
winnerId
|
||||
? (web.lists.getByTitle(CT_LISTS.suppliers).items.getById(winnerId).select('name', 'bin')() as Promise<{ name?: string; bin?: string }>)
|
||||
: Promise.resolve({} as { name?: string; bin?: string }),
|
||||
winnerId && positions.length > 0 ? loadWinnerOffers(context, winnerId, positions.map((p) => p.Id)) : Promise.resolve([] as IOfferRow[]),
|
||||
winnerId ? loadWinnerTerms(context, id, winnerId) : Promise.resolve({} as ICriteriaRow)
|
||||
]);
|
||||
const currencyIds = unique(offers.map((o) => (o.valutaId ? String(o.valutaId) : ''))).map(Number);
|
||||
const codes = await loadCurrencyCodes(context, currencyIds);
|
||||
const { total, currency } = offersTotal(offers, codes);
|
||||
|
||||
return {
|
||||
kind: 'ct',
|
||||
key: `ct:${ct.Id}`,
|
||||
title: ctTitle(ct),
|
||||
projectName: ct.project || '',
|
||||
section: unique(positions.map((p) => p.disciplineCode)).join(', '),
|
||||
workKind: unique(positions.map((p) => p.SMR)).join(', '),
|
||||
companyHint: '',
|
||||
recipientName: winner.name || '',
|
||||
recipientBin: winner.bin || '',
|
||||
total,
|
||||
currency,
|
||||
deliveryTerms: terms.deliveryType || '',
|
||||
paymentTerms: terms.paymentType || '',
|
||||
deliveryTime: terms.deadline || '',
|
||||
positions: positions.map((p) =>
|
||||
toBasisPosition(
|
||||
p,
|
||||
offers.filter((o) => o.positionId === p.Id)
|
||||
)
|
||||
)
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
import '@pnp/sp/webs';
|
||||
import '@pnp/sp/lists';
|
||||
import '@pnp/sp/items';
|
||||
import '@pnp/sp/folders';
|
||||
import '@pnp/sp/files';
|
||||
import { AadHttpClient, HttpClientResponse } from '@microsoft/sp-http';
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { APPROVAL_API_CLIENT_ID, DATA_SITE_URL, DICTIONARY_API_BASE_URL } from '../../../shared/config';
|
||||
import { PAYMENT_INVOICES_LIBRARY_TITLE } from '../../../shared/listTitles';
|
||||
import { getSP } from '../../../shared/pnp/pnpjs';
|
||||
import { fileStamp, storedFileName } from '../../../shared/chat/chatFileNames';
|
||||
|
||||
/** Колонка библиотеки, куда OCR кладёт распознанный текст счёта. */
|
||||
const FILE_CONTENT_FIELD = 'file_content';
|
||||
/** Распознавание идёт на стороне сервиса — ждём появления текста, но не бесконечно. */
|
||||
const OCR_POLL_ATTEMPTS = 8;
|
||||
const OCR_POLL_INTERVAL_MS = 2500;
|
||||
|
||||
export const MAX_INVOICE_SIZE_BYTES = 15 * 1024 * 1024;
|
||||
|
||||
export interface IStoredInvoice {
|
||||
/** Id элемента библиотеки — по нему сервис OCR находит файл. */
|
||||
itemId: number;
|
||||
/** Имя файла, как он назван в библиотеке (с отметкой времени). */
|
||||
storedName: string;
|
||||
serverRelativeUrl: string;
|
||||
}
|
||||
|
||||
/** Проверка файла счёта до загрузки. Возвращает текст ошибки или undefined. */
|
||||
export function validateInvoiceFile(file: File): string | undefined {
|
||||
if (!/\.pdf$/i.test(file.name)) {
|
||||
return 'Счёт должен быть в формате PDF — другие форматы сервис распознавания не читает.';
|
||||
}
|
||||
if (file.size > MAX_INVOICE_SIZE_BYTES) {
|
||||
return `Файл больше ${Math.round(MAX_INVOICE_SIZE_BYTES / (1024 * 1024))} МБ.`;
|
||||
}
|
||||
return undefined;
|
||||
}
|
||||
|
||||
/**
|
||||
* Сохранить файл счёта в библиотеку. Делаем это сразу при выборе файла, до
|
||||
* сохранения самой заявки: OCR работает с элементом библиотеки, а не с вложением.
|
||||
* Отметка времени в имени исключает перезапись счёта с тем же именем из другой заявки.
|
||||
*/
|
||||
export async function storeInvoice(file: File): Promise<IStoredInvoice> {
|
||||
const storedName = storedFileName(fileStamp(new Date()), 1, file.name);
|
||||
const root = getSP().web.lists.getByTitle(PAYMENT_INVOICES_LIBRARY_TITLE).rootFolder;
|
||||
const added = await root.files.addUsingPath(storedName, file);
|
||||
// Id элемента библиотеки нужен OCR, а addUsingPath отдаёт только сведения о файле.
|
||||
const item = (await getSP()
|
||||
.web.getFileByServerRelativePath(added.ServerRelativeUrl)
|
||||
.listItemAllFields.select('Id')()) as { Id: number };
|
||||
return { itemId: item.Id, storedName, serverRelativeUrl: added.ServerRelativeUrl };
|
||||
}
|
||||
|
||||
function wait(ms: number): Promise<void> {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
|
||||
async function readFileContent(itemId: number): Promise<string> {
|
||||
const item = (await getSP()
|
||||
.web.lists.getByTitle(PAYMENT_INVOICES_LIBRARY_TITLE)
|
||||
.items.getById(itemId)
|
||||
.select(FILE_CONTENT_FIELD)()) as Record<string, unknown>;
|
||||
return typeof item[FILE_CONTENT_FIELD] === 'string' ? (item[FILE_CONTENT_FIELD] as string).trim() : '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Отправить сохранённый счёт на OCR и вернуть распознанный текст из колонки
|
||||
* file_content. Сервис отвечает до того, как текст записан в колонку, поэтому
|
||||
* колонку опрашиваем несколько раз.
|
||||
*/
|
||||
export async function recognizeInvoice(context: WebPartContext, itemId: number): Promise<string> {
|
||||
const client = await context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
|
||||
const response: HttpClientResponse = await client.post(
|
||||
`${DICTIONARY_API_BASE_URL}/Document/extractPDF`,
|
||||
AadHttpClient.configurations.v1,
|
||||
{
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({
|
||||
siteUrl: DATA_SITE_URL,
|
||||
libraryName: PAYMENT_INVOICES_LIBRARY_TITLE,
|
||||
itemId: String(itemId)
|
||||
})
|
||||
}
|
||||
);
|
||||
if (!response.ok) {
|
||||
throw new Error(`Не удалось распознать счёт (Document/extractPDF): ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
for (let attempt = 0; attempt < OCR_POLL_ATTEMPTS; attempt++) {
|
||||
const text = await readFileContent(itemId);
|
||||
if (text) return text;
|
||||
await wait(OCR_POLL_INTERVAL_MS);
|
||||
}
|
||||
throw new Error('Текст счёта не появился в колонке file_content — повторите распознавание позже.');
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { askGemini, IGeminiSchema } from '../../../shared/ai/gemini.service';
|
||||
import { IInvoiceItem, IPositionPair } from '../positions';
|
||||
import { IBasisPosition } from './basis.types';
|
||||
|
||||
/** Текст счёта режем: прокси ИИ ограничен по размеру запроса, а хвост счёта — реквизиты и подписи. */
|
||||
const MAX_INVOICE_TEXT_CHARS = 30000;
|
||||
|
||||
/** Что ИИ достаёт из текста счёта. */
|
||||
export interface IInvoiceData {
|
||||
invoiceNumber: string;
|
||||
supplierName: string;
|
||||
supplierBin: string;
|
||||
/** Счёт получателя (IBAN). */
|
||||
recipientAccount: string;
|
||||
currency: string;
|
||||
totalAmount: number;
|
||||
vatAmount: number;
|
||||
items: IInvoiceItem[];
|
||||
}
|
||||
|
||||
const STRING: IGeminiSchema = { type: 'string' };
|
||||
const NUMBER: IGeminiSchema = { type: 'number' };
|
||||
|
||||
const INVOICE_SCHEMA: IGeminiSchema = {
|
||||
type: 'object',
|
||||
properties: {
|
||||
invoiceNumber: STRING,
|
||||
supplierName: STRING,
|
||||
supplierBin: STRING,
|
||||
recipientAccount: STRING,
|
||||
currency: STRING,
|
||||
totalAmount: NUMBER,
|
||||
vatAmount: NUMBER,
|
||||
items: {
|
||||
type: 'array',
|
||||
items: {
|
||||
type: 'object',
|
||||
properties: { name: STRING, unit: STRING, quantity: NUMBER, price: NUMBER, sum: NUMBER },
|
||||
required: ['name', 'quantity']
|
||||
}
|
||||
}
|
||||
},
|
||||
required: ['invoiceNumber', 'totalAmount', 'items']
|
||||
};
|
||||
|
||||
const PAIRS_SCHEMA: IGeminiSchema = {
|
||||
type: 'object',
|
||||
properties: {
|
||||
pairs: {
|
||||
type: 'array',
|
||||
items: {
|
||||
type: 'object',
|
||||
properties: { baseIndex: { type: 'integer' }, invoiceIndex: { type: 'integer' }, note: STRING },
|
||||
required: ['baseIndex', 'invoiceIndex']
|
||||
}
|
||||
}
|
||||
},
|
||||
required: ['pairs']
|
||||
};
|
||||
|
||||
/** Разобрать текст счёта: номер, поставщик, реквизиты, суммы, позиции. */
|
||||
export async function parseInvoiceText(context: WebPartContext, text: string): Promise<IInvoiceData> {
|
||||
const prompt =
|
||||
'Ниже распознанный текст счёта на оплату. Извлеки: номер счёта, наименование поставщика (продавца), ' +
|
||||
'его БИН/ИИН (12 цифр, пустая строка если нет), счёт получателя платежа (IBAN, например KZ…), ' +
|
||||
'валюту (код: KZT, USD, EUR, RUB, CNY), итоговую сумму к оплате, сумму НДС (0 если нет) и все позиции ' +
|
||||
'таблицы (наименование, единица измерения, количество, цена за единицу, сумма по строке). ' +
|
||||
'Числа — без пробелов и валютных знаков. Ничего не выдумывай: чего нет в тексте — пустая строка или 0.\n\n' +
|
||||
`Текст счёта:\n${text.slice(0, MAX_INVOICE_TEXT_CHARS)}`;
|
||||
const data = await askGemini<Partial<IInvoiceData>>(context, prompt, INVOICE_SCHEMA);
|
||||
return {
|
||||
invoiceNumber: data.invoiceNumber || '',
|
||||
supplierName: data.supplierName || '',
|
||||
supplierBin: (data.supplierBin || '').replace(/\D/g, ''),
|
||||
recipientAccount: (data.recipientAccount || '').replace(/\s/g, ''),
|
||||
currency: (data.currency || '').toUpperCase(),
|
||||
totalAmount: Number(data.totalAmount || 0),
|
||||
vatAmount: Number(data.vatAmount || 0),
|
||||
items: (data.items || []).map((item) => ({
|
||||
name: item.name || '',
|
||||
unit: item.unit || '',
|
||||
quantity: Number(item.quantity || 0),
|
||||
price: Number(item.price || 0),
|
||||
sum: Number(item.sum || 0)
|
||||
}))
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Попросить ИИ сопоставить позиции основания (СТ/потребности) с позициями счёта.
|
||||
* Названия в счёте поставщик пишет по-своему, поэтому сопоставляем по смыслу;
|
||||
* количества и единицы потом сверяет код (см. buildRows), а не ИИ.
|
||||
*/
|
||||
export async function matchPositions(
|
||||
context: WebPartContext,
|
||||
base: IBasisPosition[],
|
||||
invoice: IInvoiceItem[]
|
||||
): Promise<IPositionPair[]> {
|
||||
if (base.length === 0 || invoice.length === 0) return [];
|
||||
const baseLines = base.map((p, i) => `${i}. ${p.name} (${p.unit}, ${p.qty})${p.supplierName ? ` — у поставщика: ${p.supplierName}` : ''}`);
|
||||
const invoiceLines = invoice.map((p, i) => `${i}. ${p.name} (${p.unit}, ${p.quantity})`);
|
||||
const prompt =
|
||||
'Сопоставь позиции заявки с позициями счёта поставщика. Одна позиция заявки соответствует не более чем ' +
|
||||
'одной позиции счёта и наоборот. Для каждой найденной пары верни baseIndex и invoiceIndex. ' +
|
||||
'Позиции без пары верни с индексом −1 с отсутствующей стороны. В note коротко (до 10 слов) опиши отличие ' +
|
||||
'в названии, если оно смысловое (другая марка, размер, материал); если названия по смыслу совпадают — пустая строка.\n\n' +
|
||||
`Позиции заявки:\n${baseLines.join('\n')}\n\nПозиции счёта:\n${invoiceLines.join('\n')}`;
|
||||
const result = await askGemini<{ pairs?: IPositionPair[] }>(context, prompt, PAIRS_SCHEMA);
|
||||
return (result.pairs || []).map((pair) => ({
|
||||
baseIndex: Number(pair.baseIndex),
|
||||
invoiceIndex: Number(pair.invoiceIndex),
|
||||
note: pair.note || ''
|
||||
}));
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
import { AadHttpClient, HttpClientResponse } from '@microsoft/sp-http';
|
||||
import { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { APPROVAL_API_CLIENT_ID, DICTIONARY_API_BASE_URL } from '../../../shared/config';
|
||||
import { IBasisInfo, IBasisOption, IBasisPosition } from './basis.types';
|
||||
|
||||
/** За сколько дней показываем потребности — как шаг выбора позиций в СТ. */
|
||||
const NEEDS_LOOKBACK_DAYS = 365;
|
||||
|
||||
type RawRecord = Record<string, unknown>;
|
||||
|
||||
interface INeed {
|
||||
id: string;
|
||||
requestNumber: string;
|
||||
project: string;
|
||||
section: string;
|
||||
workKind: string;
|
||||
organization: string;
|
||||
createdAt: string;
|
||||
positionsCount: number;
|
||||
}
|
||||
|
||||
async function apiGet(context: WebPartContext, path: string): Promise<unknown> {
|
||||
const client = await context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
|
||||
const response: HttpClientResponse = await client.get(`${DICTIONARY_API_BASE_URL}${path}`, AadHttpClient.configurations.v1);
|
||||
if (!response.ok) {
|
||||
throw new Error(`${path}: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
return response.json();
|
||||
}
|
||||
|
||||
function mapNeed(item: RawRecord): INeed {
|
||||
return {
|
||||
id: String(item.id ?? ''),
|
||||
requestNumber: String(item.requestNumber ?? ''),
|
||||
// В API нет отдельной сущности «проект» — description и есть название проекта (как в шаге 1 СТ).
|
||||
project: String(item.description ?? ''),
|
||||
section: String(item.discipline ?? ''),
|
||||
workKind: String(item.workType ?? ''),
|
||||
organization: String(item.organization ?? ''),
|
||||
createdAt: String(item.requestDate ?? ''),
|
||||
positionsCount: Number(item.positionsCount ?? 0)
|
||||
};
|
||||
}
|
||||
|
||||
// Список потребностей большой и в рамках сессии не меняется — грузим один раз.
|
||||
let needsCache: Promise<INeed[]> | undefined;
|
||||
|
||||
function getNeeds(context: WebPartContext): Promise<INeed[]> {
|
||||
if (!needsCache) {
|
||||
needsCache = (apiGet(context, `/Requests/${NEEDS_LOOKBACK_DAYS}`) as Promise<RawRecord[]>)
|
||||
.then((rows) => rows.map(mapNeed))
|
||||
.catch((e) => {
|
||||
needsCache = undefined;
|
||||
throw e;
|
||||
});
|
||||
}
|
||||
return needsCache;
|
||||
}
|
||||
|
||||
/** Потребности для выбора основания. */
|
||||
export async function listNeeds(context: WebPartContext): Promise<IBasisOption[]> {
|
||||
const needs = await getNeeds(context);
|
||||
return needs.map((need) => ({
|
||||
id: need.id,
|
||||
title: `Потребность ${need.requestNumber}`,
|
||||
note: [need.project, need.organization].filter(Boolean).join(' · ')
|
||||
}));
|
||||
}
|
||||
|
||||
/** Основание «Потребность»: проект, раздел, вид работ и позиции без КП и победителя. */
|
||||
export async function loadNeedBasis(context: WebPartContext, needId: string): Promise<IBasisInfo> {
|
||||
const needs = await getNeeds(context);
|
||||
const need = needs.filter((n) => n.id === needId)[0];
|
||||
if (!need) {
|
||||
throw new Error('Потребность не найдена в списке — обновите страницу.');
|
||||
}
|
||||
const rows = (await apiGet(context, `/Requests/${encodeURIComponent(needId)}/positions`)) as RawRecord[];
|
||||
const positions: IBasisPosition[] = rows.map((row) => ({
|
||||
code: String(row.uniqueCode ?? ''),
|
||||
name: String(row.materialName ?? ''),
|
||||
unit: String(row.unit ?? ''),
|
||||
qty: Number(row.quantity ?? 0),
|
||||
supplierName: '',
|
||||
supplierQty: 0,
|
||||
supplierPrice: 0
|
||||
}));
|
||||
return {
|
||||
kind: 'need',
|
||||
key: `need:${need.id}`,
|
||||
title: `Потребность ${need.requestNumber}`,
|
||||
projectName: need.project,
|
||||
section: need.section,
|
||||
workKind: need.workKind,
|
||||
companyHint: need.organization,
|
||||
recipientName: '',
|
||||
recipientBin: '',
|
||||
total: 0,
|
||||
currency: '',
|
||||
deliveryTerms: '',
|
||||
paymentTerms: '',
|
||||
deliveryTime: '',
|
||||
positions
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
import { getSP } from '../../../shared/pnp/pnpjs';
|
||||
import { dataListTitle } from '../../../shared/listTitles';
|
||||
import { REQUEST_STATUS } from '../../../shared/approval';
|
||||
import { FORM_ID, IPreviousPayment } from '../model';
|
||||
|
||||
/**
|
||||
* Статусы, которые в «уже оплачено/заявлено» не входят: черновик ещё не подан,
|
||||
* отклонённая и возвращённая заявки платёж не создают.
|
||||
*/
|
||||
const NOT_COUNTED_STATUSES: string[] = [REQUEST_STATUS.draft, REQUEST_STATUS.rejected, REQUEST_STATUS.returned];
|
||||
|
||||
const MAX_PAYMENTS = 500;
|
||||
|
||||
interface IPaymentRow {
|
||||
Id: number;
|
||||
RequestUniqueCode?: string;
|
||||
PayAmount?: number;
|
||||
RequestStatus?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Прежние заявки на оплату по тому же основанию (СТ или потребности). Читаем
|
||||
* текущую партицию списка: архивные пары списков сюда не заглядывают — оплаты
|
||||
* по одной СТ укладываются во время жизни одной партиции.
|
||||
*
|
||||
* excludeId — сама редактируемая заявка: себя в «ранее поданных» показывать нельзя.
|
||||
*/
|
||||
export async function loadPreviousPayments(basisKey: string, excludeId?: number): Promise<IPreviousPayment[]> {
|
||||
if (!basisKey) return [];
|
||||
const safeKey = basisKey.replace(/'/g, "''");
|
||||
const rows = (await getSP()
|
||||
.web.lists.getByTitle(dataListTitle(FORM_ID))
|
||||
.items.select('Id', 'RequestUniqueCode', 'PayAmount', 'RequestStatus')
|
||||
.filter(`BasisKey eq '${safeKey}'`)
|
||||
.top(MAX_PAYMENTS)()) as IPaymentRow[];
|
||||
|
||||
return rows
|
||||
.filter((row) => row.Id !== excludeId && NOT_COUNTED_STATUSES.indexOf(row.RequestStatus || '') === -1)
|
||||
.map((row) => ({ code: row.RequestUniqueCode || `№${row.Id}`, amount: Number(row.PayAmount || 0) }));
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
import { ApprovalListService, IApproverToWrite, approvalServiceFor, writeRoute } from '../../shared/approval';
|
||||
import { ISaveItemResult, saveRequestItem } from '../../shared/dataList';
|
||||
import { FORM_ID, IFormData } from './model';
|
||||
|
||||
/** Экземпляр сервиса списка согласования этой формы (см. approvalServiceFactory). */
|
||||
export function paymentRequestApprovalService(listId?: string): ApprovalListService {
|
||||
return approvalServiceFor(FORM_ID, listId);
|
||||
}
|
||||
|
||||
/** Осмысленный заголовок элемента (системная колонка Title). */
|
||||
function buildTitle(data: IFormData): string {
|
||||
const subject = data.RecipientName.trim() || data.BasisTitle;
|
||||
return ['Заявка на оплату', [subject, data.InvoiceNumber ? `счёт ${data.InvoiceNumber}` : ''].filter(Boolean).join(', ')]
|
||||
.filter(Boolean)
|
||||
.join(': ');
|
||||
}
|
||||
|
||||
/** Колонки, которые не копируются как есть: табличные части идут в JSON. */
|
||||
const JSON_KEYS: Array<keyof IFormData> = ['PreviousPayments', 'Positions'];
|
||||
|
||||
/** Поля элемента списка данных из модели формы. Пустая строка → null, чтобы не хранить пустые значения. */
|
||||
function buildItem(data: IFormData, status: string): Record<string, unknown> {
|
||||
const item: Record<string, unknown> = { Title: buildTitle(data), RequestStatus: status };
|
||||
|
||||
(Object.keys(data) as Array<keyof IFormData>).forEach((key) => {
|
||||
if (JSON_KEYS.indexOf(key) !== -1) return;
|
||||
const value = data[key];
|
||||
item[key] = value === '' ? null : value;
|
||||
});
|
||||
|
||||
item.PreviousPaymentsJson = data.PreviousPayments.length > 0 ? JSON.stringify(data.PreviousPayments) : null;
|
||||
item.PositionsJson = data.Positions.length > 0 ? JSON.stringify(data.Positions) : null;
|
||||
return item;
|
||||
}
|
||||
|
||||
export type ISaveResult = ISaveItemResult;
|
||||
|
||||
/**
|
||||
* Сохранить «Заявку на оплату»: контент + маршрут согласования. existingId задан →
|
||||
* обновляем ту же запись (черновик/доработка), иначе создаём новую.
|
||||
* listId — партиция, в которую пишем (см. resolveWriteListId).
|
||||
*/
|
||||
export async function savePaymentRequest(
|
||||
existingId: number | undefined,
|
||||
requestTypeId: number,
|
||||
data: IFormData,
|
||||
approvers: IApproverToWrite[],
|
||||
executors: IApproverToWrite[],
|
||||
status: string,
|
||||
listId?: string
|
||||
): Promise<ISaveResult> {
|
||||
const result = await saveRequestItem(FORM_ID, existingId, listId, requestTypeId, buildItem(data, status));
|
||||
await writeRoute(paymentRequestApprovalService(listId), result.id, approvers, executors, status);
|
||||
return result;
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
import { useCallback, useState } from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { getCompanies, getProjects } from '../../shared/dictionary';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { basisPatch } from './basisPatch';
|
||||
import { BasisKind, IFormData } from './model';
|
||||
import { loadCtBasis } from './services/ctBasis.service';
|
||||
import { loadNeedBasis } from './services/needBasis.service';
|
||||
import { loadPreviousPayments } from './services/previousPayments.service';
|
||||
|
||||
export interface IBasisSelection {
|
||||
loading: boolean;
|
||||
error: string;
|
||||
/** Загрузить выбранную СТ/потребность и подставить её данные в форму. */
|
||||
select: (kind: BasisKind, id: string) => Promise<void>;
|
||||
}
|
||||
|
||||
/**
|
||||
* Выбор основания оплаты. Справочники проектов и компаний нужны только для
|
||||
* подбора oid/Id по тексту (в СТ проект — строка), поэтому их сбой не мешает:
|
||||
* без них проект/компания просто выбираются руками.
|
||||
*/
|
||||
export function useBasisSelection(
|
||||
context: WebPartContext,
|
||||
patch: (changes: Partial<IFormData>) => void,
|
||||
editId: number | undefined
|
||||
): IBasisSelection {
|
||||
const [loading, setLoading] = useState<boolean>(false);
|
||||
const [error, setError] = useState<string>('');
|
||||
|
||||
const select = useCallback(
|
||||
async (kind: BasisKind, id: string): Promise<void> => {
|
||||
setLoading(true);
|
||||
setError('');
|
||||
try {
|
||||
const info = kind === 'ct' ? await loadCtBasis(context, id) : await loadNeedBasis(context, id);
|
||||
const [previous, projects, companies] = await Promise.all([
|
||||
loadPreviousPayments(info.key, editId),
|
||||
getProjects(context).catch(() => []),
|
||||
getCompanies(context).catch(() => [])
|
||||
]);
|
||||
patch(basisPatch(info, previous, projects, companies));
|
||||
} catch (e) {
|
||||
setError(`Не удалось загрузить основание: ${friendlyErrorMessage(e)}`);
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
},
|
||||
[context, patch, editId]
|
||||
);
|
||||
|
||||
return { loading, error, select };
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
import { useCallback, useState } from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { friendlyErrorMessage } from '../../shared/diagnostics';
|
||||
import { IFormData } from './model';
|
||||
import { basisPositionsFromRows, invoicePatch } from './invoicePatch';
|
||||
import { recognizeInvoice, storeInvoice, validateInvoiceFile } from './services/invoice.service';
|
||||
import { matchPositions, parseInvoiceText } from './services/invoiceAi.service';
|
||||
|
||||
export type InvoiceStage = 'idle' | 'upload' | 'ocr' | 'analyze';
|
||||
|
||||
export const INVOICE_STAGE_TEXT: Record<InvoiceStage, string> = {
|
||||
idle: '',
|
||||
upload: 'Сохраняем счёт в библиотеку…',
|
||||
ocr: 'Распознаём текст счёта (OCR)…',
|
||||
analyze: 'ИИ разбирает счёт и сверяет позиции…'
|
||||
};
|
||||
|
||||
export interface IInvoiceFlow {
|
||||
stage: InvoiceStage;
|
||||
/** Ошибка последнего шага; файл при этом уже сохранён, форму можно заполнить руками. */
|
||||
error: string;
|
||||
attach: (file: File) => Promise<void>;
|
||||
}
|
||||
|
||||
/**
|
||||
* Конвейер счёта: библиотека → OCR → ИИ (реквизиты и позиции) → сверка с основанием.
|
||||
* Каждый шаг после сохранения файла необязателен: при сбое OCR или ИИ счёт остаётся
|
||||
* приложенным, а поля заполняются вручную — заявку из-за внешнего сервиса не блокируем.
|
||||
*/
|
||||
export function useInvoiceFlow(
|
||||
context: WebPartContext,
|
||||
data: IFormData,
|
||||
patch: (changes: Partial<IFormData>) => void
|
||||
): IInvoiceFlow {
|
||||
const [stage, setStage] = useState<InvoiceStage>('idle');
|
||||
const [error, setError] = useState<string>('');
|
||||
|
||||
const attach = useCallback(
|
||||
async (file: File): Promise<void> => {
|
||||
const invalid = validateInvoiceFile(file);
|
||||
if (invalid) {
|
||||
setError(invalid);
|
||||
return;
|
||||
}
|
||||
setError('');
|
||||
try {
|
||||
setStage('upload');
|
||||
const stored = await storeInvoice(file);
|
||||
patch({ InvoiceFileName: file.name, InvoiceUrl: stored.serverRelativeUrl });
|
||||
|
||||
setStage('ocr');
|
||||
const text = await recognizeInvoice(context, stored.itemId);
|
||||
|
||||
setStage('analyze');
|
||||
const invoice = await parseInvoiceText(context, text);
|
||||
const pairs = await matchPositions(context, basisPositionsFromRows(data.Positions), invoice.items);
|
||||
patch(invoicePatch(data, invoice, invoice.items, pairs));
|
||||
} catch (e) {
|
||||
setError(`${friendlyErrorMessage(e)} Заполните поля по счёту вручную.`);
|
||||
} finally {
|
||||
setStage('idle');
|
||||
}
|
||||
},
|
||||
[context, data, patch]
|
||||
);
|
||||
|
||||
return { stage, error, attach };
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
import { IFormData } from './model';
|
||||
|
||||
/**
|
||||
* Обязательные поля заявки на оплату. Возвращает текст ошибки или undefined.
|
||||
* Превышение общей суммы и расхождения со счётом сюда НЕ входят: они только
|
||||
* подсвечиваются, решение — за согласующими.
|
||||
*/
|
||||
export function validatePayment(data: IFormData): string | undefined {
|
||||
const missing: string[] = [];
|
||||
if (!data.RequesterEmail) missing.push('заявитель');
|
||||
if (!data.BasisKey) missing.push('основание (СТ или потребность)');
|
||||
if (!data.ProjectName.trim()) missing.push('проект');
|
||||
if (!data.CompanyName.trim()) missing.push('компания');
|
||||
if (!data.BankAccountName.trim()) missing.push('банковский счёт');
|
||||
if (!data.RecipientName.trim()) missing.push('получатель');
|
||||
if (!data.RecipientAccount.trim()) missing.push('счёт получателя');
|
||||
if (!data.CashFlowGroupName.trim()) missing.push('группа статьи ДДС');
|
||||
if (!data.CashFlowItemName.trim()) missing.push('статья ДДС');
|
||||
if (!data.PaymentPurpose.trim()) missing.push('назначение платежа');
|
||||
if (data.PayAmount <= 0) missing.push('сумма оплаты');
|
||||
if (!data.InvoiceFileName) missing.push('счёт на оплату');
|
||||
return missing.length > 0 ? `Заполните обязательные поля: ${missing.join(', ')}.` : undefined;
|
||||
}
|
||||
@@ -55,6 +55,9 @@ const formRegistry: Record<string, React.LazyExoticComponent<FormComponent>> = {
|
||||
'hr-transfer': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-employee-transfer' */ './EmployeeTransfer/EmployeeTransferForm')
|
||||
),
|
||||
'acc-payment-request': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-payment-request' */ './PaymentRequest/PaymentRequestForm')
|
||||
),
|
||||
'wh-concrete-request': React.lazy(
|
||||
() => import(/* webpackChunkName: 'form-concrete-request' */ './ConcreteRequest/ConcreteRequestForm')
|
||||
)
|
||||
|
||||
@@ -74,6 +74,9 @@ const viewRegistry: Record<string, React.LazyExoticComponent<ViewComponent>> = {
|
||||
'hr-transfer': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-employee-transfer' */ './EmployeeTransfer/EmployeeTransferView')
|
||||
),
|
||||
'acc-payment-request': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-payment-request' */ './PaymentRequest/PaymentRequestView')
|
||||
),
|
||||
'wh-concrete-request': React.lazy(
|
||||
() => import(/* webpackChunkName: 'view-concrete-request' */ './ConcreteRequest/ConcreteRequestView')
|
||||
)
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
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';
|
||||
|
||||
/** JSON-схема ответа в формате, который принимает прокси Gemini (как в СТ). */
|
||||
export interface IGeminiSchema {
|
||||
type: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean';
|
||||
properties?: Record<string, IGeminiSchema>;
|
||||
items?: IGeminiSchema;
|
||||
required?: string[];
|
||||
}
|
||||
|
||||
/**
|
||||
* POST /Proxy/Gemini { prompt, responseSchema } → объект, подогнанный под схему.
|
||||
* Тот же вызов делает СТ (CtService.scorePaymentTerms); ответ прокси — уже
|
||||
* разобранный JSON, без обёртки.
|
||||
*/
|
||||
export async function askGemini<T>(context: WebPartContext, prompt: string, responseSchema: IGeminiSchema): Promise<T> {
|
||||
const client = await context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
|
||||
const response: HttpClientResponse = await client.post(
|
||||
`${DICTIONARY_API_BASE_URL}/Proxy/Gemini`,
|
||||
AadHttpClient.configurations.v1,
|
||||
{
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({ prompt, responseSchema })
|
||||
}
|
||||
);
|
||||
if (!response.ok) {
|
||||
throw new Error(`Proxy/Gemini: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
return (await response.json()) as T;
|
||||
}
|
||||
@@ -240,3 +240,10 @@ export const DATAVERSE_LZKPOSITION_LZK_LOOKUP_FIELD = 'cree9_lzkid';
|
||||
export const DATAVERSE_LZK_ENTITY_SET = 'cree9_lzks';
|
||||
/** Колонка «project id» на LZK — GUID проекта текстом, совпадает по формату с oid из /Project. */
|
||||
export const DATAVERSE_LZK_PROJECT_FIELD = 'cree9_projectid';
|
||||
|
||||
/**
|
||||
* Сайт сравнительных таблиц (СТ): списки «Сравнительная таблица», «Позиции СТ»,
|
||||
* «Оценка поставщиков», «Критерии», «Поставщики», «Курс Валют» живут здесь, а не
|
||||
* на сайте данных портала. Читаем их из «Заявки на оплату» (forms/PaymentRequest).
|
||||
*/
|
||||
export const CT_SITE_URL = 'https://tnsukz.sharepoint.com/sites/sed';
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
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';
|
||||
|
||||
/** Запись справочника 1С в том виде, в каком её показывает выпадающий список. */
|
||||
export interface IDictionaryItem {
|
||||
id: string;
|
||||
/** Основная подпись (название, номер счёта). */
|
||||
label: string;
|
||||
/** Пояснение под подписью (банк, компания и т.п.); '' — нет. */
|
||||
note: string;
|
||||
}
|
||||
|
||||
type RawRecord = Record<string, unknown>;
|
||||
|
||||
// Справочники 1С (BankAccounts, Contracts, CashFlowItemGroups, …) отдают записи
|
||||
// без единой схемы, а точные имена полей на живом API не сверены, поэтому
|
||||
// поле читаем по списку вероятных имён, а не по одному жёсткому ключу.
|
||||
const ID_KEYS = ['id', 'Id', 'oid', 'Oid', 'code', 'Code'];
|
||||
const LABEL_KEYS = ['name', 'Name', 'title', 'Title', 'number', 'Number', 'accountNumber', 'AccountNumber', 'description', 'Description'];
|
||||
const NOTE_KEYS = ['bankName', 'BankName', 'bank', 'Bank', 'iban', 'Iban', 'IBAN', 'company', 'Company', 'counterparty', 'Counterparty'];
|
||||
|
||||
function pickString(record: RawRecord, keys: string[]): string {
|
||||
for (const key of keys) {
|
||||
const value = record[key];
|
||||
if (typeof value === 'string' && value.trim() !== '') return value.trim();
|
||||
if (typeof value === 'number') return String(value);
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/** Ответ — либо плоский массив, либо { items: [...] } (как у /Project). */
|
||||
function extractRecords(body: unknown): RawRecord[] {
|
||||
if (Array.isArray(body)) return body as RawRecord[];
|
||||
const items = (body as { items?: unknown } | null)?.items;
|
||||
return Array.isArray(items) ? (items as RawRecord[]) : [];
|
||||
}
|
||||
|
||||
export function mapDictionaryRecord(record: RawRecord): IDictionaryItem {
|
||||
const label = pickString(record, LABEL_KEYS);
|
||||
const id = pickString(record, ID_KEYS) || label;
|
||||
const noteRaw = pickString(record, NOTE_KEYS);
|
||||
return { id, label, note: noteRaw === label ? '' : noteRaw };
|
||||
}
|
||||
|
||||
// Справочник с теми же параметрами в рамках сессии не меняется — один промис на
|
||||
// (путь + параметры), ошибку не кешируем (следующий вызов попробует снова).
|
||||
const cache = new Map<string, Promise<IDictionaryItem[]>>();
|
||||
|
||||
/**
|
||||
* GET {api}/Dictionary/<path>?<params> → список записей. Пустые параметры в
|
||||
* запрос не попадают: фильтр по компании/проекту включается, только когда они выбраны.
|
||||
*/
|
||||
export function getDictionaryList(
|
||||
context: WebPartContext,
|
||||
path: string,
|
||||
params: Record<string, string> = {}
|
||||
): Promise<IDictionaryItem[]> {
|
||||
const query = Object.keys(params)
|
||||
.filter((key) => params[key] !== '')
|
||||
.map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`)
|
||||
.join('&');
|
||||
const url = `${DICTIONARY_API_BASE_URL}/Dictionary/${path}${query ? `?${query}` : ''}`;
|
||||
|
||||
const cached = cache.get(url);
|
||||
if (cached) return cached;
|
||||
|
||||
const request = (async (): Promise<IDictionaryItem[]> => {
|
||||
const client = await context.aadHttpClientFactory.getClient(APPROVAL_API_CLIENT_ID);
|
||||
const response: HttpClientResponse = await client.get(url, AadHttpClient.configurations.v1);
|
||||
if (!response.ok) {
|
||||
throw new Error(`Dictionary/${path}: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
return extractRecords(await response.json())
|
||||
.map(mapDictionaryRecord)
|
||||
.filter((item) => item.label !== '');
|
||||
})().catch((e) => {
|
||||
cache.delete(url);
|
||||
throw e;
|
||||
});
|
||||
cache.set(url, request);
|
||||
return request;
|
||||
}
|
||||
@@ -33,3 +33,9 @@ export {
|
||||
} from './employeeLookup.service';
|
||||
export { formatEmployeeOrganizationsWithDepartment, parseOrganizationLine } from './organizationLines';
|
||||
export type { IOrganizationLine } from './organizationLines';
|
||||
export { getDictionaryList } from './dictionaryList.service';
|
||||
export type { IDictionaryItem } from './dictionaryList.service';
|
||||
export { DictionaryPicker } from './ui/DictionaryPicker';
|
||||
export type { IDictionaryPickerProps } from './ui/DictionaryPicker';
|
||||
export { ItemPicker } from './ui/ItemPicker';
|
||||
export type { IItemPickerProps } from './ui/ItemPicker';
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
import * as React from 'react';
|
||||
import type { WebPartContext } from '@microsoft/sp-webpart-base';
|
||||
import { useFormReadOnly } from '@tnsu/ui-kit';
|
||||
import { getDictionaryList, IDictionaryItem } from '../dictionaryList.service';
|
||||
import { ItemPicker } from './ItemPicker';
|
||||
|
||||
export interface IDictionaryPickerProps {
|
||||
context: WebPartContext;
|
||||
/** Путь справочника после /Dictionary/, напр. «BankAccounts». */
|
||||
path: string;
|
||||
/** Параметры фильтра (companyId, projectId…); пустые значения в запрос не идут. */
|
||||
params?: Record<string, string>;
|
||||
id?: string;
|
||||
value: string;
|
||||
/** label — текст поля; id — id записи справочника ('' — текст введён вручную). */
|
||||
onChange: (label: string, id: string) => void;
|
||||
placeholder?: string;
|
||||
readOnly?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Выбор записи справочника 1С (GET /Dictionary/<path>). Если справочник не
|
||||
* загрузился — поле остаётся обычным текстовым (заявку не блокируем из-за
|
||||
* недоступности справочника), а под ним показывается причина.
|
||||
*/
|
||||
export const DictionaryPicker: React.FC<IDictionaryPickerProps> = ({ context, path, params, readOnly, ...rest }) => {
|
||||
const contextReadOnly = useFormReadOnly();
|
||||
const effectiveReadOnly = readOnly ?? contextReadOnly;
|
||||
|
||||
const [items, setItems] = React.useState<IDictionaryItem[]>([]);
|
||||
const [loadError, setLoadError] = React.useState<string>('');
|
||||
|
||||
// Параметры — объект, новый на каждом рендере родителя; в зависимость идёт стабильная строка.
|
||||
const paramsKey = JSON.stringify(params || {});
|
||||
|
||||
React.useEffect(() => {
|
||||
// В режиме чтения список не нужен — справочник не дёргаем.
|
||||
if (effectiveReadOnly) return undefined;
|
||||
let alive = true;
|
||||
setLoadError('');
|
||||
getDictionaryList(context, path, JSON.parse(paramsKey) as Record<string, string>)
|
||||
.then((list) => {
|
||||
if (alive) setItems(list);
|
||||
})
|
||||
.catch((e: Error) => {
|
||||
if (alive) {
|
||||
setItems([]);
|
||||
setLoadError(`Справочник «${path}» недоступен (${e.message}) — введите значение вручную.`);
|
||||
}
|
||||
});
|
||||
return () => {
|
||||
alive = false;
|
||||
};
|
||||
}, [context, path, paramsKey, effectiveReadOnly]);
|
||||
|
||||
return <ItemPicker {...rest} items={items} readOnly={readOnly} hint={loadError} />;
|
||||
};
|
||||
@@ -0,0 +1,92 @@
|
||||
import * as React from 'react';
|
||||
import styles from './ProjectPicker.module.scss';
|
||||
import { useFormReadOnly } from '@tnsu/ui-kit';
|
||||
import { IDictionaryItem } from '../dictionaryList.service';
|
||||
|
||||
export interface IItemPickerProps {
|
||||
/** Варианты для выбора; пустой список — поле остаётся обычным текстовым. */
|
||||
items: IDictionaryItem[];
|
||||
id?: string;
|
||||
/** Выбранная подпись (то, что видно в поле). */
|
||||
value: string;
|
||||
/** label — текст поля; id — id выбранной записи ('' — текст введён вручную). */
|
||||
onChange: (label: string, id: string) => void;
|
||||
placeholder?: string;
|
||||
readOnly?: boolean;
|
||||
/** Пояснение под полем (напр. почему список пуст). */
|
||||
hint?: string;
|
||||
}
|
||||
|
||||
const MAX_SUGGESTIONS = 40;
|
||||
|
||||
/**
|
||||
* Поле «ввод + выпадающий список»: ввод фильтрует варианты, выбор проставляет id.
|
||||
* Показывает варианты и при пустом тексте (в отличие от ProjectPicker): справочники
|
||||
* банковских счетов и статей короткие, их удобнее пролистать, чем угадывать запрос.
|
||||
*/
|
||||
export const ItemPicker: React.FC<IItemPickerProps> = ({ items, id, value, onChange, placeholder, readOnly, hint }) => {
|
||||
const contextReadOnly = useFormReadOnly();
|
||||
const effectiveReadOnly = readOnly ?? contextReadOnly;
|
||||
const [open, setOpen] = React.useState<boolean>(false);
|
||||
|
||||
const suggestions = React.useMemo(() => {
|
||||
const query = value.trim().toLowerCase();
|
||||
return items
|
||||
.filter((item) => !query || item.label.toLowerCase().indexOf(query) !== -1 || item.note.toLowerCase().indexOf(query) !== -1)
|
||||
.slice(0, MAX_SUGGESTIONS);
|
||||
}, [items, value]);
|
||||
|
||||
return (
|
||||
<div className={styles.wrap}>
|
||||
<input
|
||||
id={id}
|
||||
className={styles.input}
|
||||
value={value}
|
||||
placeholder={placeholder}
|
||||
readOnly={effectiveReadOnly}
|
||||
onChange={(e) => {
|
||||
onChange(e.target.value, '');
|
||||
setOpen(true);
|
||||
}}
|
||||
onFocus={() => setOpen(true)}
|
||||
onBlur={() => setOpen(false)}
|
||||
/>
|
||||
{!effectiveReadOnly && value.length > 0 && (
|
||||
<button
|
||||
type="button"
|
||||
className={styles.clear}
|
||||
aria-label="Очистить"
|
||||
title="Очистить"
|
||||
onMouseDown={(e) => e.preventDefault()}
|
||||
onClick={() => {
|
||||
onChange('', '');
|
||||
setOpen(false);
|
||||
}}
|
||||
>
|
||||
×
|
||||
</button>
|
||||
)}
|
||||
{!effectiveReadOnly && open && suggestions.length > 0 && (
|
||||
<div className={styles.list}>
|
||||
{suggestions.map((item) => (
|
||||
<button
|
||||
key={`${item.id}-${item.label}`}
|
||||
type="button"
|
||||
className={styles.item}
|
||||
// preventDefault на mousedown — иначе input теряет фокус раньше onClick и список закрывается до выбора.
|
||||
onMouseDown={(e) => e.preventDefault()}
|
||||
onClick={() => {
|
||||
onChange(item.label, item.id);
|
||||
setOpen(false);
|
||||
}}
|
||||
>
|
||||
{item.label}
|
||||
{item.note && <span className={styles.meta}>{item.note}</span>}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
{hint && <div className={styles.meta}>{hint}</div>}
|
||||
</div>
|
||||
);
|
||||
};
|
||||
@@ -40,7 +40,8 @@ const LIST_TITLE_BASE: Record<RequestTypeId, string> = {
|
||||
'recruiting-referral': 'Реферальная рекомендация',
|
||||
'recruiting-selection': 'Заявка на подбор',
|
||||
'wh-tmc-transfer': 'СЗ на перемещение ТМЦ',
|
||||
'wh-service-request': 'Заявка на услуги'
|
||||
'wh-service-request': 'Заявка на услуги',
|
||||
'acc-payment-request': 'Заявка на оплату'
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -159,3 +160,10 @@ export function approvalListTitleForListId(id: RequestTypeId, listId: string): s
|
||||
* через представление, поэтому порог в 5000 элементов на такой доступ не влияет.
|
||||
*/
|
||||
export const CHAT_FILES_LIBRARY_TITLE = 'Файлы чата';
|
||||
|
||||
/**
|
||||
* Библиотека счетов «Заявки на оплату»: сюда сохраняем файл счёта, чтобы сервис
|
||||
* OCR (Document/extractPDF) мог положить распознанный текст в многострочную
|
||||
* колонку file_content. Создаётся вручную на сайте данных (колонка file_content — Note).
|
||||
*/
|
||||
export const PAYMENT_INVOICES_LIBRARY_TITLE = 'Счета на оплату';
|
||||
|
||||
Reference in New Issue
Block a user