b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
609 Commits 4 Branches 0 Tags
755d420aa221e3fa96e9be3a0f709ebcc4809825
Commit Graph

609 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
刘泉佳 952b735a53 fix: 付款管理列表结算单号查询兼容预结算单号 2026-09-29 16:02:11 +08:00
刘泉佳 a9eb1d82d4 feat: 收款认领推送金蝶定时任务增加single-flight分布式锁及Nacos配置 2026-09-29 12:12:59 +08:00
刘泉佳 78e7ee7239 fix: 金蝶客商数据定时同步 2026-09-29 12:05:42 +08:00
刘泉佳 82fab4b76a feat: 已推送金蝶的认领不允许作废——后端硬校验拦截，列表带出流水推送状态 2026-09-29 11:58:20 +08:00
刘泉佳 331ea0466f feat: 定时推送按认领人串行处理——查完该认领人公告并推完名下流水再轮到下一个 2026-09-29 11:52:42 +08:00
刘泉佳 fe7a940201 fix: A301-3 成功响应 number 为空，金蝶收款单号取回执 keys.awrp_src_code；A301-1 回写命中后以真实收款单号覆盖占位 2026-09-29 11:25:58 +08:00
刘泉佳 15599e894d chore: 保留 buildKingdeeBillNo 冲单号方法，作废调用点注释保留待后续迭代 2026-09-29 11:18:48 +08:00
刘泉佳 c8b2b701a3 fix: 作废认领不再生成本地KDCX冲单——金蝶单号/状态保留原值，接口改无返回 2026-09-29 11:15:57 +08:00
刘泉佳 175dd52d33 fix: A301-3 分录按契约改为单条——e_receivableamt=全部未推送金额，seq/e_corebillno=第一张结算单id 2026-09-29 11:10:41 +08:00
刘泉佳 ffc2f6eea2 fix: A301-3 报文取数按契约修正——awrp_src_code=分摊结算单号拼接，seq/e_corebillno=结算单id 2026-09-29 10:48:50 +08:00
刘泉佳 9cf42b4105 feat: 收款流水列表补充收款金额区间与认领人筛选（认领人经认领记录参数化两段查询过滤） 2026-09-29 10:28:27 +08:00
b2894lxlx 087f361a8b ✨ 组织类型改业务字典，并完善金蝶部门代码与MK再提交 
组织类型翻译切换为 organization_type；新增金蝶部门代码字段；流程已结束或已通过时强制新建MK表单实例。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 03:15:26 +08:00
b2894lxlx 32cff235e0 🐛 修复审核通过后再提交未新建MK流程实例的问题 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 02:44:48 +08:00
b2894lxlx fc1e9a95de mk调试 2026-09-29 02:23:59 +08:00
b2894lxlx beb0850644 ✨ 解耦MK表单实例与业务ID，公开页按formInstanceId反查业务数据 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 02:23:19 +08:00
刘泉佳 4c32cb9046 docs: 新增预付款申请A103-3金蝶链路补齐方案 
覆盖三项改造：e_bebank_number 与 A103-1 统一取联行号、A103-2 消失解锁兜底（ADR-0005）、
回写任务开关默认策略；含状态机全景、时序图、配置汇总与联调验证要点
 2026-09-29 01:51:07 +08:00
刘泉佳 846f080343 fix: 金蝶付款结果回写开关注释纠正且环境配置默认开启 
PaymentKingdeeResultTask 注释写「默认开启」与 @Value 兜底默认 false 矛盾，注释纠正为代码兜底关闭；
Nacos 三套配置（blade-dev/blade-prod/third-party-api）syncEnabled 默认改 true，按环境显式开启回写任务
 2026-09-29 01:50:53 +08:00
刘泉佳 2079da6195 feat: 付款申请新增金蝶单据消失解锁兜底（A103-2连续两轮查询消失） 
金蝶侧反审核删除付款申请单后，本地停留已生成/付款中且状态门禁禁止重推，单据卡死。
按 ADR-0005 新增 unlockBill()：置生成失败、清空金蝶单据内码/编号（日志留档）、不自动重推；
A103-2 定时回写对已推送单据连续两轮未查得（Redis 计数，TTL 覆盖三个回写周期）触发解锁；
failed 单据不参与计数，Redis 异常放弃判定，重推链 A103-2 勾稽预检兜底防重复单据；
B901 UNLOCK 回调后续接入复用同一 unlockBill()
 2026-09-29 01:50:36 +08:00
刘泉佳 f4f4360e5a feat: 预付款推送金蝶往来银行编码改取客商收款账户联行号 
A103-3 分录 e_bebank_number 原取银行名称字段，与 A103-1 口径不一致；
统一改取付款申请所选客商收款账户（blade_customer_receipt_account）联行号，未维护即拦截推送
 2026-09-29 01:48:04 +08:00
刘泉佳 e7d16eeb74 feat: 认领记录列表支持按流水推送状态筛选 2026-09-29 01:32:09 +08:00
刘泉佳 79abfa966b feat: 收款流水分页查询补充常用筛选条件（推送状态/金蝶回写状态/明细流水号） 2026-09-29 01:25:31 +08:00
刘泉佳 2e91e112ff feat: 收款认领本地化，认领完成才推金蝶——A301-3定时+手动双入口按流水归集推送 
- 认领只落本地：claim() 删除事务内同步推送，认领上限/认领完成口径改为公告未认领金额
- 推送闸门：认领完成且未推送过才可推；推送前重查A301-2最新公告对账，不一致拦截并提示差额
- 按流水归集：一条流水一张金蝶收款单，分录取全部有效分摊行；awrp_src_code 上移至流水、重试复用防重试双单
- 已推送终态闸门禁止二次推送；推送失败落 push_status/push_fail_reason 可重试，本地认领不回滚
- 定时任务 ReceiptClaimPushTask（thirdParty.bfi.receiptClaimPush.*，按认领人分组重查公告）+ 手动按钮 POST /receipt-flow/push-kingdee
- A301-1 回写轮询对象改流水并级联刷新认领主单冗余字段；作废仍不触发推送
- 认领链路批量化：结算单锁行/认领额聚合/汇总刷新改 IN 批量，候选单列表消除每页200次N+1，同步留痕 Db.saveBatch
 2026-09-29 01:02:54 +08:00
刘泉佳 98614a25cc perf: 结算单收款汇总批量化——refreshPaymentSummaries 固定数次批量查询替代逐单N+1，calculatePaymentSummary 拆纯计算重载保持口径一致 2026-09-29 01:02:33 +08:00
刘泉佳 f97237afe5 docs: 收款认领推送金蝶重构设计与业务流程文档、幂等变更SQL、集成语境术语 2026-09-29 01:02:14 +08:00
刘泉佳 cf6db499de fix: A301-3 收款认领结果推送接口金蝶字段 2026-09-28 18:57:42 +08:00
刘泉佳 bdae054b0b fix: 修复收款流水同步与认领推送问题 2026-09-28 18:40:05 +08:00
刘泉佳 145cb57e00 fix: 修复收款流水同步与认领推送问题 2026-09-28 17:54:43 +08:00
刘泉佳 0b88d05e93 docs: 收款流水同步方法增加详细日志和注释说明 2026-09-28 16:04:43 +08:00
刘泉佳 978caa640a perf: 收款流水同步改为批量查询与批量保存（N+1→批量） 2026-09-28 15:59:39 +08:00
刘泉佳 4d62bb6df7 feat: A301-2 认领公告查询接口适配新参数（billstatus/modifytimeS/modifytimeE），时间窗口配置化（Nacos thirdParty.bfi.claimAnnounce.months，默认6个月） 2026-09-28 15:49:53 +08:00
刘泉佳 85b703b7d5 docs: 补充KingdeeReceiptFlow实体字段说明注释 2026-09-28 15:17:18 +08:00
刘泉佳 f292bb28a0 fix: 开户银行.编码（行号） 2026-09-28 14:40:10 +08:00
刘泉佳 f901ad3ff5 fix: 合并附件上传分支的编译报错 2026-09-28 10:54:45 +08:00
刘泉佳 a2abb3f921 Merge remote-tracking branch 'origin/feature/kingdee-attachment-sync' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-common/src/main/java/org/springblade/common/feign/CustomFeignLogger.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/FormalSettlementServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/InvoiceApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/InvoiceReceiptServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/support/KingdeeApBillSyncSupport.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/support/KingdeeArBillSyncSupport.java
 2026-09-28 10:50:09 +08:00
刘泉佳 15532feb81 Merge branch 'fix/a801-3-writeback-dedup-key' into feature/payment-apply-bfi-sync 2026-09-28 09:27:58 +08:00
刘泉佳 7e76964a76 feat: 金蝶定时同步加single-flight分布式锁，多副本与手动触发共用一道闸（付款结果回写/应收勾稽/开票结果/收票结果/客商同步） 
- 新增 KingdeeSyncLockSupport：零等待tryLock+租约可配+租户隔离，未启用blade.lock.enabled时降级并告警
- 各同步方法拆为锁壳+executeXxxSync主体，锁在service层保证手动触发端点与定时任务行为一致
- 租约配置：thirdParty.bfi.{payResult|arResult|invoiceResult|receivedInvoice|customer}.lockLeaseSeconds，默认1800秒
 2026-09-28 00:52:12 +08:00
刘泉佳 8b98e33daa fix: 修复A801-3收票单定时回写按发票号匹配防重键导致回写失效 
回写查询集与命中查找改用收票登记id（String.valueOf(receipt.getId())），
与A303-2落库的awrp_src_code及243d5be已修复的推送预检/A302-6路径同源；
原按发票号匹配永远查不到TMS自推单据，异常回收/指定补偿/单号补登全部静默失效。
同步修正queryReceivedInvoiceBySrcCodes过时javadoc（发票号码→收票登记id）。
 2026-09-28 00:44:10 +08:00
b2894lxlx 247440288b 🐛 修复运单计划-1占位，并对账导入失败明细按原表全量列导出 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 23:16:17 +08:00
b2894lxlx eef9d7ad9d ✨ 完善运单导入配载标识、导入状态与凭证文件夹统计 
记录配载标识号并在同批次多运单时生成配载单，导入状态与运单状态对齐，凭证按车牌文件夹统计并支持压缩包重传匹配。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 22:54:30 +08:00
刘泉佳 2f5bb4a5a8 📝 新增金蝶附件上传下载链路梳理文档（A902上传+A801-2下载+对应关系核对） 2026-09-27 22:40:21 +08:00
刘泉佳 4e2f565d2f fix: 金蝶附件同步失败转成功时显式置空失败原因，修复updateById忽略null字段导致历史失败原因残留 2026-09-27 22:38:14 +08:00
b2894lxlx f3a614ffe9 Merge branch 'master' of https://git.websoft.top/b2894lxlx/tms-erp-api 2026-09-27 21:27:14 +08:00
b2894lxlx 1185c9792c 🐛 修复车务非必填-1占位落库，并完善总单分段调度与运单导入 
上一段运单完成到达后才可调度且不超过到达量；车务多模块保存/列表/导出将-1归一为null；同步网关大报文限制与导入校验能力。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 21:26:54 +08:00
刘泉佳 a3f1e07b2f feat: 金蝶票池发票文件下载（A801-2）：按发票号镜像优先/实时回源定位，后端流式代理供前端查看下载 2026-09-27 21:17:52 +08:00
b2894lxlx 0c52797c31 Merge remote-tracking branch 'websoft/fix/issue-2-10-import-batch-rollback' 2026-09-27 13:03:12 +08:00
weicw-dshsa c86c5ff968 🔀 合并 fix/issue-2-10-import-batch-rollback 
导入链路整批修复（issues #2-#10 + 违章/记录类/台账类/运输对账等）：
- 所有批量导入改为「任一行失败即整批回滚」
- 失败明细返回原表全量并逐列标红（不再只给错误行）
- 读取阶段异常兜底，不再暴露 HTTP 500 技术文案
- 空表提示改为「未读取到数据行，请确认表头下方已填写内容」
- 修复常用货物型号必填漏校验、运输对账动态费用列静默转 0、
  失败明细行号错位等
详见该分支 16 个提交。
 2026-09-26 15:30:04 +08:00
weicw-dshsa 4ccc28e991 🐛 修复三处导入校验缺陷与失败明细行号错位 
对全仓 31 处导入入口做了一次「导入校验 vs 新增/编辑校验」的一致性审计，
以下三处是审计中严重度最高的、且业务口径无歧义的缺陷：

1) 常用货物：型号必填只在新增/编辑生效，导入侧被放过
   submit(CommonCargo) 走 validate(cargo, requireModel=true)，而导入调
   submit(cargo, false) —— 页面上存不进去的数据（型号为空）却能通过导入写进库。
   CommonCargoExcel 的「型号」列也没标 *，用户按模板填根本不知道它必填。
   改法：去掉 requireModel 开关（该参数已成死参数，留着只会让两边再次分叉），
   导入与新增/编辑共用同一个 validate；模板表头改 *型号。

2) 运输对账：动态费用列填非数字被静默改成 0.00
   VehicleReconciliationFeeReader / CargoReconciliationFeeReader 的 decimal()
   在 catch (NumberFormatException) 后直接返回 ZERO —— 「一百元」变成 0.00 存进
   feeItemsJson，参与结算金额与自动匹配，属静默写脏数据。
   改法：抛新增的 ImportCellReadException（blade-common），带上行号/列名/原值，
   由既有读取阶段兜底导出原表全量明细。

3) 运输计划：文案「数量/里程必须为正数」与规则不符
   条件只判 < 0（0 是合法值），新增/编辑侧的文案是「不能小于0」。统一为「不能小于0」。

顺带修掉一个更基础的错位：
   ImportFailureExcelUtil.readFailureRowIndex 直接拿
   ExcelDataConvertException.getRowIndex() 当失败明细的行下标，但前者是
   【绝对 0 基行号】（表头=0），后者只对数据行计数。错误恰好落在最后一行时
   靠 clamping 侥幸正确，落在首行就会把原因标到下一行 —— 实测首行出错时原因
   被标到了第 3 行（应为第 2 行）。现统一换算（-1）并把两类异常收口到
   readFailureExcelRowIndex。

验证：
- mvn clean install -DskipTests 通过。
- 全套 16 个导入回归脚本 469 项断言全绿，其中：
  - 运单核对新增用例 04（首行读取失败须标在第 2 行）、05（动态费用列填中文
    必须报错），运单核对套件 28 项全绿；
  - 常用货物新增用例 08（型号为空须整批回滚），套件 29 项全绿；
  - 读取失败套件 4 项全绿，证明行号修正未破坏既有断言。
 2026-09-26 12:45:17 +08:00
weicw-dshsa 9bf7fdfe99 ⚡ 空表导入提示改为「未读取到数据行，请确认表头下方已填写内容」 
原提示「导入数据不能为空」在用户上传「只有表头、未填数据行」的文件时容易误解
（文件并非空文件，只是没填内容）。全项目 27 个模块、30 处统一替换该文案。

验证：mvn install -DskipTests 通过；空表上传返回新文案；
13 个导入回归脚本 383 项断言全绿。
 2026-09-26 11:50:57 +08:00
weicw-dshsa 2d185f0de6 🐛 导入单元格无法转换时改为返回可读失败明细，兜底 26 个导入接口 
问题（用户实测反馈）：金额列填「一万二千元」这类无法转换的内容时，EasyExcel 在
ExcelUtil.read(...) 阶段就抛 ExcelDataConvertException，根本走不到行级校验；
控制器只 catch ImportFailureException，异常穿透到全局处理器，用户看到的是
HTTP 500 + 「Convert data ... to class java.math.BigDecimal error」这类技术文案，
且完全拿不到失败明细。

影响面：全部 27 个导入接口（读阶段的 ExcelUtil.read 都在 try 内、只 catch
ImportFailureException），非维修记录独有。

改动：
- ImportFailureExcelUtil 新增三个能力（blade-common，公共层一次覆盖各模块）：
  1) describeReadFailure：把 ExcelDataConvertException 转成
     「第N行「列名」格式不正确：<原值>」，列名按列序号反查 @ExcelProperty；
  2) readRawRows：以原始文本（Map）方式重读文件，不做类型转换因此绝不抛异常，
     用于拿回「原表全部行」；
  3) exportReadFailure：一站式兜底（重读 → 导出全量行 + 仅出错行带原因 +
     按列标红），返回 false 表示非转换类异常，调用方继续抛出保持原行为。
- 26 个导入控制器在现有 catch 之后追加 catch(Exception) 兜底，未改动原有
  行级校验与整批回滚逻辑。

验证：
- 实测维修记录/费用项/币种汇率三个模块：HTTP 500→200，返回全量明细，
  文案如「第5行「费用」格式不正确：一万二千元」（行号经单行/四行文件双向校准）。
- 既有回归无退化：记录类 80/80、台账 32/32、港口码头 45/45、货物类型 24/24、
  费用项 20/20、币种汇率 25/25。
- 新增 scripts/api-read-failure-test.sh（4 断言）固化该场景。
 2026-09-26 11:37:07 +08:00
weicw-dshsa be02a5e942 🐛 修复运输对账导入无回滚与运输计划明细不全（批次4） 
本批是 16 个模块收尾，两个特殊模块：

1) 运输对账（importVehicles / importCargoes）——最严重的一例：
   既无 setRollbackOnly 也不抛异常。方法开头 resetExternal(id) 清空既有外部账单，
   循环末尾无条件插入本批正确行，然后 return failures。一旦有失败行：
   旧外部账单已被清空、新账单只插入了部分——数据损坏且不可恢复。
   改法：任一行失败时抛 ImportFailureException(rows)，让 resetExternal 清空
   与本批插入在同一事务内一起回滚。另把失败原因写回原行（异常携带原表 rows，
   只写 Vehicle/CargoReconciliationFailureExcel 副本会丢原因）。
   控制器改 catch 异常导出原表全量（用 export 保留按列标红）。

2) 运输计划（importTransportPlan）——失败明细只返回 errorMap.values()（仅错误行）。
   改为抛 ImportFailureException(data) 携带原表全量；控制器 catch 后导出。

验证：mvn install -DskipTests 通过；全项目 12 个导入回归脚本 379 项断言全绿。
全项目已无 TransactionAspectSupport...setRollbackOnly() 调用残留。

注：运输对账需先建对账草稿（多张前置表）才能端到端回归，
本批仅完成代码改造与编译验证，回归用例待补（见后续说明）。
 2026-09-26 11:10:37 +08:00