wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 5 软件包 项目 发布 百科 活动

feat(detail-page-structure-progress-actions): 统一详情处理进度与操作区

浏览代码
这个提交包含在：
wangsli
2026-08-03 16:00:42 +08:00
父节点 8d428bd51d
当前提交 b7d5761067
共修改 31 个文件，包含 1453 行新增和 383 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
server/src/routes/paymentBatches.js
+70 -12
查看文件
@@ -19,6 +19,11 @@ const { enqueueReimbursementJournalExport } = require("../services/integrations/
const { ensureRiskFlag, buildPersistedRiskFlag, toMoneyNumber, toMoneyString } = require("../services/feeControl");
const { decryptStringOrThrow, maskBankAccount } = require("../services/crypto");
const { generatePaymentOrderXls, PaymentOrderXlsError } = require("../services/paymentOrderXls");
const {
buildPaymentProcessingSemantics,
requiresBankReceipt,
resolveItemPaymentChannel,
} = require("../services/paymentProcessingProgress");
const { deleteObject, openReadStream, StorageNotFoundError, writeBuffer } = require("../services/storage");
const {
buildAttachmentContentDisposition,
@@ -138,16 +143,8 @@ function mapReceiptAttachment(item) {
};
}
function resolveItemPaymentChannel(batch, item) {
return item.payment_channel_override ?? batch.default_payment_channel ??
(batch.entity_type === "reimbursement" ? "bank" : null);
}
async function ensureBankReceiptForExecutableBatch(tx, batch) {
const requiresBankReceipt = (batch.items ?? []).some((item) =>
["pending", "failed"].includes(item.status) && resolveItemPaymentChannel(batch, item) === "bank",
);
if (!requiresBankReceipt) {
if (!requiresBankReceipt(batch)) {
return;
}
@@ -817,9 +814,64 @@ function mapBatch(batch, openRiskFlags = [], legacyPayees = new Map(), options =
};
}
function isoDateTimeOrNull(value) {
if (!value) return null;
const date = value instanceof Date ? value : new Date(value);
return Number.isNaN(date.getTime()) ? null : date.toISOString();
}
function buildPaymentBatchProcessingProgress(batch, actorNames) {
const semantics = buildPaymentProcessingSemantics({
status: batch.status,
createdAt: batch.created_at,
reviewedAt: batch.reviewed_at,
executedAt: batch.executed_at,
cancelledAt: batch.cancelled_at,
cancelledReason: batch.cancelled_reason,
requiresBankReceipt: requiresBankReceipt(batch),
receiptCount: batch._count?.receipt_attachments ?? 0,
paymentOrderExportCount: batch.payment_order_export_count ?? 0,
});
const actorIds = {
creator: batch.created_by,
reviewer: batch.reviewed_by,
executor: batch.executed_by,
canceller: batch.cancelled_by,
};
return {
stages: [semantics.created, semantics.review, semantics.payment].map((stage) => ({
key: stage.key,
label: stage.label,
state: stage.state,
actorName: stage.actorSource ? actorNames.get(actorIds[stage.actorSource]) ?? null : null,
occurredAt: isoDateTimeOrNull(stage.occurredAt),
result: stage.result,
comment: stage.comment,
detail: stage.detail,
targetHref: null,
})),
};
}
async function mapBatchForResponse(tx, batch, openRiskFlags, config) {
const legacyPayees = await loadLegacyPayees(tx, batch, config);
return mapBatch(batch, openRiskFlags, legacyPayees, { includePayee: true });
const actorIds = Array.from(new Set([
batch.created_by,
batch.reviewed_by,
batch.executed_by,
batch.cancelled_by,
].filter(Boolean)));
const actors = actorIds.length
? await tx.employee.findMany({
where: { id: { in: actorIds } },
select: { id: true, name: true },
})
: [];
const actorNames = new Map(actors.map((actor) => [actor.id, actor.name]));
return {
...mapBatch(batch, openRiskFlags, legacyPayees, { includePayee: true }),
processingProgress: buildPaymentBatchProcessingProgress(batch, actorNames),
};
}
async function listOpenRiskFlagsForBatch(tx, batch) {
@@ -2183,7 +2235,10 @@ async function paymentBatchesRoutes(fastify) {
reviewed_by: request.employee.id,
updated_by: request.employee.id,
},
include: { items: true },
include: {
items: true,
_count: { select: { receipt_attachments: { where: { archived_at: null } } } },
},
});
await tx.auditLog.create({
@@ -2359,7 +2414,10 @@ async function paymentBatchesRoutes(fastify) {
executed_by: request.employee.id,
updated_by: request.employee.id,
},
include: { items: true },
include: {
items: true,
_count: { select: { receipt_attachments: { where: { archived_at: null } } } },
},
});
await tx.auditLog.create({
server/src/routes/reimbursements.js
+50 -55
查看文件
@@ -33,6 +33,11 @@ const {
resolveEntityPrecheck,
} = require("../services/feeControl");
const { issueDocumentNumber } = require("../services/documentSequence");
const {
PAYMENT_PROCESSING_STAGE_DEFINITIONS,
buildPaymentProcessingSemantics,
requiresBankReceipt,
} = require("../services/paymentProcessingProgress");
const { openReadStream, readFileBuffer, StorageNotFoundError, writeBuffer } = require("../services/storage");
const {
MaterialPreviewError,
@@ -333,8 +338,8 @@ const PROCESSING_STAGE_DEFINITIONS = Object.freeze([
{ key: "submitted", label: "申请提交" },
{ key: "manager_approval", label: "主管审批" },
{ key: "finance_review", label: "财务复核" },
{ key: "payment_batch_review", label: "付款复核" },
{ key: "payment_and_receipt", label: "付款完成" },
PAYMENT_PROCESSING_STAGE_DEFINITIONS.review,
PAYMENT_PROCESSING_STAGE_DEFINITIONS.payment,
]);
function isoDateTimeOrNull(value) {
@@ -514,68 +519,48 @@ function buildProcessingProgress({ reimbursement, workflowInstance, paymentBatch
? { state: "current", result: "待安排", detail: "待财务安排付款" }
: { detail: "待财务安排付款" });
paymentStage.detail = "待付款复核后由财务登记，非审批环节";
} else if (batch.status === "draft") {
Object.assign(batchReviewStage, {
state: "current",
result: "待复核",
detail: "待非制单人复核付款",
targetHref: batchTargetHref,
} else {
const semantics = buildPaymentProcessingSemantics({
status: batch.status,
createdAt: batch.created_at,
reviewedAt: batch.reviewed_at,
executedAt: batch.executed_at,
cancelledAt: batch.cancelled_at,
cancelledReason: batch.cancelled_reason,
requiresBankReceipt: requiresBankReceipt(batch),
receiptCount: batch._count?.receipt_attachments ?? 0,
paymentOrderExportCount: batch.payment_order_export_count ?? 0,
});
Object.assign(paymentStage, {
detail: "待付款复核通过后由财务登记，非审批环节",
targetHref: batchTargetHref,
});
} else if (["reviewed", "executed", "failed"].includes(batch.status)) {
Object.assign(batchReviewStage, {
state: "completed",
actorName: paymentActorNames.get(batch.reviewed_by) ?? null,
occurredAt: isoDateTimeOrNull(batch.reviewed_at),
result: "通过",
detail: batch.status === "reviewed" ? "付款复核已通过" : null,
targetHref: batchTargetHref,
});
if (batch.status === "reviewed") {
Object.assign(paymentStage, {
state: "current",
result: "待付款",
detail: "待财务完成付款并登记回单，非审批环节",
targetHref: batchTargetHref,
});
} else if (batch.status === "failed") {
Object.assign(paymentStage, {
state: "exception",
actorName: paymentActorNames.get(batch.executed_by) ?? null,
occurredAt: isoDateTimeOrNull(batch.executed_at),
result: "付款失败",
detail: "付款失败，待财务重新处理，非审批环节",
const actorIds = {
reviewer: batch.reviewed_by,
executor: batch.executed_by,
canceller: batch.cancelled_by,
};
for (const [target, source] of [
[batchReviewStage, semantics.review],
[paymentStage, semantics.payment],
]) {
Object.assign(target, {
state: source.state,
actorName: source.actorSource
? paymentActorNames.get(actorIds[source.actorSource]) ?? null
: null,
occurredAt: isoDateTimeOrNull(source.occurredAt),
result: source.result,
comment: source.comment,
detail: source.detail,
targetHref: batchTargetHref,
});
}
} else if (batch.status === "cancelled") {
Object.assign(batchReviewStage, {
state: "exception",
actorName: paymentActorNames.get(batch.cancelled_by) ?? null,
occurredAt: isoDateTimeOrNull(batch.cancelled_at),
result: "批次已取消",
comment: batch.cancelled_reason ?? null,
detail: "付款安排已取消，待财务重新处理",
targetHref: batchTargetHref,
});
Object.assign(paymentStage, {
detail: "待财务重新安排付款，非审批环节",
targetHref: batchTargetHref,
});
}
if (batch?.status === "executed" || reimbursement.status === "paid") {
const receiptCount = batch?._count?.receipt_attachments ?? 0;
if (!batch && reimbursement.status === "paid") {
Object.assign(paymentStage, {
state: "completed",
actorName: reimbursement.paid_by_employee?.name ?? paymentActorNames.get(batch?.executed_by) ?? null,
occurredAt: isoDateTimeOrNull(reimbursement.paid_at ?? batch?.executed_at),
actorName: reimbursement.paid_by_employee?.name ?? null,
occurredAt: isoDateTimeOrNull(reimbursement.paid_at),
result: "已付款",
detail: receiptCount > 0 ? "付款和回单已留存" : "付款已完成，回单待留存",
targetHref: batchTargetHref,
detail: "付款已完成，回单待留存",
});
}
@@ -2591,6 +2576,10 @@ async function reimbursementRoutes(fastify) {
select: {
id: true,
status: true,
entity_type: true,
default_payment_channel: true,
payment_order_export_count: true,
created_at: true,
created_by: true,
reviewed_at: true,
reviewed_by: true,
@@ -2599,6 +2588,12 @@ async function reimbursementRoutes(fastify) {
cancelled_at: true,
cancelled_by: true,
cancelled_reason: true,
items: {
select: {
status: true,
payment_channel_override: true,
},
},
_count: {
select: { receipt_attachments: { where: { archived_at: null } } },
},
server/src/services/paymentProcessingProgress.js
+135
查看文件
@@ -0,0 +1,135 @@
const PAYMENT_PROCESSING_STAGE_DEFINITIONS = Object.freeze({
created: Object.freeze({ key: "payment_batch_created", label: "批次创建" }),
review: Object.freeze({ key: "payment_batch_review", label: "付款复核" }),
payment: Object.freeze({ key: "payment_and_receipt", label: "付款完成" }),
});
function resolveItemPaymentChannel(batch, item) {
return item?.payment_channel_override ?? batch?.default_payment_channel ??
(batch?.entity_type === "reimbursement" ? "bank" : null);
}
function requiresBankReceipt(batch) {
return (batch?.items ?? []).some((item) =>
["pending", "failed"].includes(item.status) && resolveItemPaymentChannel(batch, item) === "bank",
);
}
function buildStage(definition, overrides = {}) {
return {
...definition,
state: "pending",
result: null,
detail: null,
comment: null,
actorSource: null,
occurredAt: null,
...overrides,
};
}
function buildPaymentProcessingSemantics({
status,
createdAt = null,
reviewedAt = null,
executedAt = null,
cancelledAt = null,
cancelledReason = null,
requiresBankReceipt: bankReceiptRequired = false,
receiptCount = 0,
paymentOrderExportCount = 0,
}) {
const created = buildStage(PAYMENT_PROCESSING_STAGE_DEFINITIONS.created, {
state: "completed",
result: "已创建",
actorSource: "creator",
occurredAt: createdAt,
});
const review = buildStage(PAYMENT_PROCESSING_STAGE_DEFINITIONS.review);
const payment = buildStage(PAYMENT_PROCESSING_STAGE_DEFINITIONS.payment, {
detail: "待付款复核通过后由财务登记，非审批环节",
});
if (status === "draft") {
Object.assign(review, {
state: "current",
result: "待复核",
detail: "待非制单人复核付款",
});
} else if (["reviewed", "executed", "failed"].includes(status)) {
Object.assign(review, {
state: "completed",
result: "通过",
detail: status === "reviewed" ? "付款复核已通过" : null,
actorSource: "reviewer",
occurredAt: reviewedAt,
});
if (status === "reviewed") {
const hasReceipt = Number(receiptCount) > 0;
let detail = "付款复核已通过，等待财务登记付款完成，非审批环节";
if (bankReceiptRequired && !hasReceipt) {
detail = Number(paymentOrderExportCount) > 0
? "已生成银行制单，等待付款完成并上传回单，非审批环节"
: "等待财务线下付款并上传回单，非审批环节";
} else if (bankReceiptRequired) {
detail = "银行回单已上传，等待财务登记付款完成，非审批环节";
}
Object.assign(payment, {
state: "current",
result: "待付款",
detail,
});
} else if (status === "executed") {
Object.assign(payment, {
state: "completed",
result: "已付款",
detail: Number(receiptCount) > 0 ? "付款和回单已留存" : "付款已登记完成",
actorSource: "executor",
occurredAt: executedAt,
});
} else {
Object.assign(payment, {
state: "exception",
result: "付款失败",
detail: "付款登记失败，待财务核对后重试，非审批环节",
actorSource: "executor",
occurredAt: executedAt,
});
}
} else if (status === "cancelled") {
const cancellation = {
state: "exception",
result: "批次已取消",
detail: "付款安排已取消，流程已终止",
comment: cancelledReason,
actorSource: "canceller",
occurredAt: cancelledAt,
};
if (reviewedAt) {
Object.assign(review, {
state: "completed",
result: "通过",
actorSource: "reviewer",
occurredAt: reviewedAt,
});
Object.assign(payment, cancellation);
} else {
Object.assign(review, cancellation);
Object.assign(payment, {
state: "terminated",
result: "已终止",
detail: null,
});
}
}
return { created, review, payment };
}
module.exports = {
PAYMENT_PROCESSING_STAGE_DEFINITIONS,
buildPaymentProcessingSemantics,
requiresBankReceipt,
resolveItemPaymentChannel,
};