feat: 选票自动生成报销明细并支持集中分类（08-29-reimbursement-expense-policy-invoice-guard）

server/src/routes/invoicePool.js

@@ -1,4 +1,5 @@
 const { buildBusinessValidationError } = require("../utils/businessValidationError");
+const { suggestInvoiceExpenseType } = require("../services/invoiceExpenseClassification");
 const crypto = require("node:crypto");
 const path = require("node:path");
 
@@ -37,8 +38,10 @@ const bindBodySchema = z.union([
     .object({
       reimbursementId: z.string().uuid(),
       linkedItemId: z.string().uuid().optional(),
+      createItem: z.literal(true).optional(),
     })
-    .strict(),
+    .strict()
+    .refine((body) => !(body.createItem && body.linkedItemId)),
   z
     .object({
       travelOrderId: z.string().uuid(),
@@ -264,7 +267,31 @@ async function recomputeReimbursementTotal(tx, reimbursementId, actorId) {
   return nextTotal;
 }
 
-async function resolveInvoiceLinkedItem(tx, { reimbursementId, reimbursementDate, invoice, linkedItemId, actorId }) {
+async function resolveInvoiceLinkedItem(tx, { reimbursementId, reimbursementDate, invoice, linkedItemId, actorId, createItem }) {
+  if (createItem) {
+    const expenseDate = toDateOnlyFromDate(invoice.invoice_date);
+    if (!expenseDate || !Number.isFinite(expenseDate.getTime()) || invoice.total_amount == null || Number(invoice.total_amount) <= 0 || !Number.isFinite(Number(invoice.total_amount))) {
+      throw buildBusinessValidationError("reimbursement.invoice_prefill_incomplete", { invoice: "missing_date_or_positive_amount" }, 409);
+    }
+    const expenseTypes = await tx.expenseType.findMany({
+      where: { enabled: true, code: "travel_train" },
+      select: { id: true, code: true, enabled: true },
+    });
+    const suggestion = suggestInvoiceExpenseType(invoice, expenseTypes);
+    const created = await tx.reimbursementItem.create({
+      data: {
+        reimbursement_id: reimbursementId,
+        expense_type_id: suggestion?.expenseTypeId ?? null,
+        expense_date: expenseDate,
+        amount: toMoneyString(invoice.total_amount),
+        description: suggestion?.source === "document_category" ? "铁路交通费用" : "",
+        created_by: actorId,
+        updated_by: actorId,
+      },
+      select: { id: true },
+    });
+    return { linkedItemId: created.id, createdItem: true };
+  }
   if (linkedItemId) {
     const linkedItem = await tx.reimbursementItem.findFirst({
       where: {
@@ -1016,6 +1043,16 @@ async function invoicePoolRoutes(fastify) {
       let responseInvoice = null;
 
       await fastify.prisma.$transaction(async (tx) => {
+        const bindingSnapshot = await tx.invoicePool.findUnique({
+          where: { id: invoiceId },
+          select: { linked_reimbursement_id: true },
+        });
+        if (bindingSnapshot?.linked_reimbursement_id) {
+          await tx.$queryRaw`
+            SELECT id FROM "reimbursement_forms"
+            WHERE id = ${bindingSnapshot.linked_reimbursement_id}::uuid FOR UPDATE
+          `;
+        }
         const invoiceRows = await tx.$queryRaw`
           SELECT id, status, linked_reimbursement_id, travel_order_id
           FROM "invoice_pool"
@@ -1032,6 +1069,9 @@ async function invoicePoolRoutes(fastify) {
         }
 
         const invoice = invoiceRows[0];
+        if ((invoice.linked_reimbursement_id ?? null) !== (bindingSnapshot?.linked_reimbursement_id ?? null)) {
+          throw buildBusinessValidationError("reimbursement.invoice_unbind_status_invalid", { invoice: "binding_changed" }, 409);
+        }
         if (invoice.status !== "bound" || (!invoice.linked_reimbursement_id && !invoice.travel_order_id)) {
           throw buildBusinessValidationError("reimbursement.invoice_not_bound", { invoice: "not_bound" }, 409);
         }
@@ -1440,6 +1480,23 @@ async function invoicePoolRoutes(fastify) {
 
       try {
         await fastify.prisma.$transaction(async (tx) => {
+          if ("reimbursementId" in parsedBody.data) {
+            if (!fastify.hasPermission(request.employee, "invoice.upload")) {
+              throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 });
+            }
+            const forms = await tx.$queryRaw`
+              SELECT id, owner_id, submitter_id, status FROM "reimbursement_forms"
+              WHERE id = ${parsedBody.data.reimbursementId}::uuid FOR UPDATE
+            `;
+            const form = forms[0];
+            if (!form) throw new AppError({ code: "SYS_404", message: "Not Found", statusCode: 404 });
+            if (form.owner_id !== request.employee.id && form.submitter_id !== request.employee.id) {
+              throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403 });
+            }
+            if (!["draft", "rejected"].includes(form.status)) {
+              throw buildBusinessValidationError("reimbursement.invoice_bind_status_invalid", { reimbursement: "invalid_status_for_bind" }, 409);
+            }
+          }
           const invoiceRows = await tx.$queryRaw`
             SELECT id
             FROM "invoice_pool"
@@ -1472,6 +1529,7 @@ async function invoicePoolRoutes(fastify) {
               travel_order_id: true,
               archived_reason: true,
               is_duplicate_override: true,
+              ocr_result: { select: { result_json: true } },
             },
           });
 
@@ -1483,7 +1541,10 @@ async function invoicePoolRoutes(fastify) {
             });
           }
 
-          if (invoice.status === "bound" || invoice.linked_reimbursement_id || invoice.travel_order_id) {
+          const sameFormRetry = parsedBody.data.createItem === true &&
+            invoice.status === "bound" && !invoice.travel_order_id &&
+            invoice.linked_reimbursement_id === parsedBody.data.reimbursementId && Boolean(invoice.linked_item_id);
+          if (!sameFormRetry && (invoice.status === "bound" || invoice.linked_reimbursement_id || invoice.travel_order_id)) {
             throw new AppError({
               code: "VALID_005",
               message: "发票已被其他业务单据占用/绑定",
@@ -1491,7 +1552,7 @@ async function invoicePoolRoutes(fastify) {
             });
           }
 
-          if (invoice.status !== "available") {
+          if (!sameFormRetry && invoice.status !== "available") {
             throw new AppError({
               code: "VALID_005",
               message: "发票已被其他业务单据占用/绑定",
@@ -1500,7 +1561,7 @@ async function invoicePoolRoutes(fastify) {
             });
           }
 
-          if (!invoice.is_duplicate_override) {
+          if (!sameFormRetry && !invoice.is_duplicate_override) {
             const duplicateBlocker = await resolveInvoiceDedupBlocker(tx, {
               excludeInvoiceId: invoiceId,
               fileSha256: invoice.file_sha256,
@@ -1533,7 +1594,7 @@ async function invoicePoolRoutes(fastify) {
               });
             }
 
-            const { reimbursementId, linkedItemId } = parsedBody.data;
+            const { reimbursementId, linkedItemId, createItem } = parsedBody.data;
             const reimbursementRows = await tx.$queryRaw`
               SELECT id, owner_id, submitter_id, department_id, status, reimbursement_date
               FROM "reimbursement_forms"
@@ -1568,6 +1629,13 @@ async function invoicePoolRoutes(fastify) {
               throw buildBusinessValidationError("reimbursement.invoice_owner_mismatch", { invoice: "owner_mismatch" }, 409);
             }
 
+            if (sameFormRetry) {
+              await resolveInvoiceLinkedItem(tx, {
+                reimbursementId, invoice, linkedItemId: invoice.linked_item_id, actorId: request.employee.id,
+              });
+              return;
+            }
+
             const invoiceGuardGate = await evaluateFeatureFlag({
               prisma: tx,
               config: fastify.config,
@@ -1575,7 +1643,7 @@ async function invoicePoolRoutes(fastify) {
               departmentId: reimbursement.department_id ?? null,
               strictDepartment: true,
             });
-            if (invoiceGuardGate.enabled && !linkedItemId) {
+            if (invoiceGuardGate.enabled && !linkedItemId && !createItem) {
               throw buildBusinessValidationError("reimbursement.invoice_item_required", { linkedItemId: "required_when_invoice_guard_enabled" }, 400);
             }
 
@@ -1585,6 +1653,7 @@ async function invoicePoolRoutes(fastify) {
               invoice,
               linkedItemId,
               actorId: request.employee.id,
+              createItem,
             });
 
             await tx.invoicePool.update({