2026-11-06.md 3.13 KB

2026-11-06 资金支付-供应商信息新模块(后端)

  • 新建模块:资金支付-供应商信息(fund_payment_supplier,utf8mb3),字段:客户名称/开户行/卡号(卡号文本、中间含空格,比对时忽略空格)
  • 位置:xingyun-sc,controller/ledger/FundPaymentSupplierController,路由 /fund/payment/supplier,权限前缀 fund-manage:payment-supplier:*
  • 完整链路:entity → vo/ledger/fundpayment → bo/ledger/fundpayment → mappers/FundPaymentSupplierMapper(+resources/mappers/ledger/XML) → service+impl/ledger → excel/ledger(导入模型/监听器/导出模型) → controller
  • 功能:分页查询(名称/开户行/卡号模糊,卡号查重忽略空格)、增/改/删(物理删除)、同步导出(GET /export 按筛选条件)、导入模板(GET /import/template)、导入(POST /import,客户名称+卡号唯一,文件内与库内均查重)
  • 参照实现:RecapitalizeController(CRUD+导入)、SupplierImportListener(导入校验模式)
  • SQL 已追加到 xingyun-api/src/main/resources/db/chujiang/base.sql 尾部(CREATE TABLE fund_payment_supplier)
  • 编译验证:mvn -o compile 仅存量 3 个文件报错(FlowTaskServiceImpl/BusinessDataHandlerServiceImpl/BusinessDataExportHandler,与历史日志一致,系本地 bpm/mq jar 版本问题),新文件无编译错误
  • 待办:前端需新建页面与菜单权限(query/add/modify/delete/import/export);存量库执行 base.sql 尾部的建表语句

补充:资金支付-供应商信息模块整体迁移到 procurement 包

  • 用户要求:资金支付属采购线,代码放 com/lframework/xingyun/sc/procurement 下
  • 新位置:procurement/{entity,vo,mappers,service,impl,controller}/fundpayment/;Bo 在 sc/bo/procurement/(项目惯例);Excel 在 sc/excel/fundPayment/;XML 在 resources/mappers/procurement/fundpayment/
  • 同步调整:路由改为 /procurement/fundPaymentSupplier;权限前缀改为 procure-manage:payment-supplier:*(照抄采购线惯例);表名仍为 fund_payment_supplier 未变
  • 旧位置 14 个文件已全部删除,无残留引用;编译验证仅存量 3 文件报错(与历史一致),新代码零错误

补充:资金支付供应商导入查重口径改为三字段

  • 规则变更:原"客户名称+卡号"两项去重 → 改为"客户名称+开户行+卡号"三项完全一致才算重复(卡号仍忽略空格比对,开户行空串与 null 视为相同)
  • 同步改动:Service 方法 getByCustomerNameAndCardNo → getDuplicate(customerName, bankName, cardNo);create/update/导入监听器三处统一走同一口径(避坑清单 #1 口径一致性)
  • 导入文件内重复提示保留行号;库内重复提示"第N行的数据系统中已存在"

修正:资金支付供应商导入报错行号

  • 问题:EasyExcel 的 context.readRowHolder().getRowIndex() 从 0 开始且含表头行,直接输出会少一行
  • 修正:rowNum = getRowIndex() + 1,报错显示 Excel 实际行号(第1行为表头,数据从第2行始)
  • 重复提示的"与第M行重复"改用 Map<查重key, 首次出现的Excel行号>,不再用数据列表下标+1