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

322 Commits

Author SHA1 Message Date
weicw-dshsa 378aa11842 ♻️ 认证迁移脚本补幂等并统一注释格式 
三个认证相关迁移脚本按项目既有约定整理，DDL 效果不变：

- driving_vehicle 扩长、owner_name/vin 加列两处原为裸 ALTER，重复执行会报
  「Duplicate column」或白白重建表；改为 DELIMITER 存储过程 + information_schema
  判定，与 doc/sql/transport 下 upgrade_* 的既有写法一致，可重复执行。
  扩长那条额外判定 character_maximum_length < 100：MODIFY COLUMN 会重建整表，
  已达标就不必再跑一次。
- cert_record 的菜单段补注 parent_id 的出处（与 blade_transport_driver.sql /
  blade_transport_vehicle.sql / blade_vehicle_dispatch.sql 同一 ID），并说明
  ON DUPLICATE KEY UPDATE 会把 parent_id / name 回写，对旧环境重跑即可收敛。
- 去掉注释里的 markdown 粗体（doc/sql/transport 的既有排版不用 markdown），
  统一以 30 个破折号的横幅开头。

已在 dev 库 transport 连跑两遍验证：两遍均无报错，且列定义 116 行、索引 29 行、
三表排序规则与整理前逐项一致。
 2026-10-04 23:43:05 +08:00
weicw-dshsa ec98954351 🔀 合并认证记录功能分支到 master 
认证记录不可变快照数据模型、司机端提交与记录查询、管理端审核、
小程序证件 OCR 适配、接单可用性门槛（带开关可回退），含迁移脚本与单元测试。
 2026-10-04 23:38:39 +08:00
weicw-dshsa 17ae367100 🐛 认证审核菜单名改为「司机审核 / 车辆审核」 
原名「认证审核-司机 / 认证审核-车辆」与需求文档的表述不一致，
后台菜单显示为「司机审核」「车辆审核」——与 .scratch 里
审核页分页签那轮需求的措辞对齐。

只改 blade_menu 的 name 字段，code / alias / path / 权限码均不变，
故不影响权限校验与前端路由。

注意：该 INSERT 是 ON DUPLICATE KEY UPDATE，改脚本本身不会改库里已有的行，
要在已有环境生效需重跑本脚本（新环境按脚本建库则直接是新名）。
 2026-10-04 19:16:38 +08:00
weicw-dshsa 04a7846328 ✨ 车辆认证扩到6张证件图，字段与车辆档案对齐；补齐建车必填列 
司机端车辆认证此前只有 3 张图、5 个字段，且语义与车辆管理不一致
（「副页」字段里装的其实是主页反面）。本次把证件内容整体对齐车辆表列：

- 车辆表新增 owner_name（所有人：行驶证登记的单位名称，不是司机）与 vin；
- 提交请求与司机端车辆卡片全量对齐表列，行驶证四张图各自独立、
  不再把「主页反面」与「副页正面」挤在同一个字段；
- 业务关系新增为司机自选（自有/管理挂靠/业务合作），不再由后端替用户猜。

顺带修掉三处会直接让功能不可用的缺陷：

1. 司机建车必失败：organization_name、approved_load_kg、business_relation、
   energy_type、registration_no 五列 NOT NULL 且无默认值，而建车链路一个都不设置，
   严格模式下 INSERT 直接报「doesn't have a default value」。已补齐并加服务端校验
   （司机提交链路此前一句都不查，全靠前端）。
2. OCR 自动填充从未生效：后端按契约透传百度原始结果（中文键），
   前端读的却是扁平字段名，永远 undefined 且不报错。新增 OcrFieldSupport
   做归一化（键名别名容错、数值/日期/「长期」归一化、外廓尺寸拆三段、
   有效期区间拆起止），响应的 fields 即前端直接回填的字段。
3. 审核通过不写回车辆档案：状态已通过、内容却还是旧的，自相矛盾。
   现把生效快照的证件内容与指针合并成同一次 UPDATE 写回；快照是改造前
   旧格式时明确报错，而不是静默写一堆空值。
 2026-10-03 16:34:47 +08:00
weicw-dshsa cc997c1c0c ✨ 审核列表新增司机姓名与手机号，并修正驾驶车辆绑定校验 
审核页的司机姓名与手机号取司机档案的**当前值**，不是提交时的历史值：
手机号从未进入过认证快照（只有司机档案这一个来源），而队列的用途是
「找得到人、联系得上」。司机侧的认证对象就是记录本身；车辆侧记录不含任何
司机信息，取提交该记录的司机。存量订正记录里没有系统账号的那些司机解析不到，
两列为空属正常状态。

筛选必须发生在分页之前，故列表改为自定义 SQL；在 Java 层补字段再过滤会变成
「先分页再过滤」，每页条数与总数都不准。姓名搜索同时匹配档案当前姓名与提交时的
旧名，改名后按新名、旧名都搜得到。

顺带修掉两处既有缺陷：

1. 管理端保存绑定多辆车的司机会误报「驾驶车辆不存在」——小程序把车牌逗号并列
   写入 driving_vehicle，管理端却拿整串去车牌表精确查，两边口径不一致。
2. 「一个司机最多 5 辆车」后端从未校验，且 driving_vehicle 原为 varchar(30)，
   5 个车牌连分隔符要 39 字符，超长写入会被静默截断成半个车牌（还会被当成一辆车）。
   列扩到 varchar(100) 并在写入前校验数量与车牌格式。
 2026-10-03 14:35:59 +08:00
weicw-dshsa 36d23cb426 📝 认证记录相关文件去掉外部文档引用，注释改为自解释 
前一次提交的注释大量引用本仓库之外、同事看不到的东西：
docs/adr/0001、docs/adr/0002、GLOSSARY.md、.scratch/ 下的 spec 与 ticket 编号、
以及 ADR-0002 / D10 / 不变式 I1~I3 这类代号。这些都在另一个 git 仓库
（weicw/tms-erp）里，单独 checkout 本仓库的人根本找不到，只会困惑。

改为把结论直接写在注释里：
- 生效快照指针为何「一经设置永不回退」（原来只写「见 ADR-0002」）；
- 为何 redis 状态字段不能用 0 兜底；
- 为何生成列要排除 is_deleted、为何 tenant_id 必须 NOT NULL；
- changeStatus 为何被禁用（原来写「破坏 I3 的留痕」）。

顺带对齐本仓库的既有排版习惯：
- 横幅破折号由 77 个改为 30 个（与 blade_annual_inspection_record.sql 等一致）；
- 去掉 SQL 注释里的 markdown 粗体（本目录无其他脚本这么写）。

仅注释变更：SQL 的 diff 已逐行核对，非注释行改动为 0，DDL 一字未动；
迁移重跑仍 exit 0，audit-migrations 通过，mvn clean compile 成功。
 2026-10-02 15:47:39 +08:00
weicw-dshsa 87f4c3a830 ✨ 新增认证记录不可变快照数据模型与迁移脚本 
按 ADR-0001/0002 建立司机与车辆共用的认证记录表 blade_transport_cert_record
（biz_type 区分、载荷存 JSON、检索字段提升为真实列），并为司机/车辆表补生效快照指针。

不变式结构性保证：
- I1 同对象至多一条待审：生成列 pending_biz_id + 唯一索引，数据库层拦截；
  生成列同时排除 is_deleted，避免逻辑删除的待审记录永久占用唯一键。
- I3 快照不可变：snapshot_json 等 5 列标 FieldStrategy.NEVER，永不进入 UPDATE。
- status 承载审核状态（0审核中/1已通过/2已驳回/3已作废），新增时必须显式设置：
  框架 resolveEntity 会把 null 的 status 静默填成 1（即「已通过」），
  且继承来的 changeStatus 可直接写 status，两条通道均已封堵。

其他：司机表补身份证有效期三列并订正排序规则为 utf8mb4_general_ci
（原先为 0900_ai_ci，与车辆表 JOIN 已发生过 Illegal mix of collations）；
生效快照指针加 @JsonProperty(READ_ONLY)，防止以 /submit 请求体自行「认证」自己；
同步基线建表脚本与认证审核菜单/权限码。本票不含任何业务接口。
 2026-10-02 14:40:56 +08:00
刘泉佳 d78757b64c fix: A303-1 开票申请推送放开上游来源单据字段，awrp_src_con_no 传首张结算单金蝶应收单编号（金蝶确认单据编号口径，取 A302-4 查询结果） 2026-10-01 22:23:41 +08:00
刘泉佳 4b3edf977c Merge remote-tracking branch 'refs/remotes/origin/master' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
 2026-10-01 13:47:00 +08:00
刘泉佳 c6a817fb3a docs: HCS技术设计文档入库并同步v4认证口径（静态双头） 
- 技术设计文档（2026-09-27）首次入库：D2/§3.2/§7 更新为固定双请求头方案
- 实施状态清单：认证组件条目改写，待确认项改为附件接口头生效性
- nacos样例配置：base-url指向网关前缀，authorization/key-auth走环境变量注入
 2026-10-01 02:06:57 +08:00
刘泉佳 1906e8c80b docs: 新增桂物合同集成相关接口说明-v4.docx（合规方接口说明原件，本次认证方案变更依据） 2026-10-01 02:06:04 +08:00
刘泉佳 f8bd66aafb docs: BFI接口编号补充名称标注，新增定时任务逻辑全梳理文档 2026-09-30 15:01:57 +08:00
刘泉佳 2f6619d443 feat: 开票结果回写落库发票文件地址并支持正式结算单详情查看下载 
- A303-5 VO 补数电 PDF/XML 直链字段，回写落库四个发票文件地址（板式文件/预览图/数电PDF/数电XML）
- 已落库但缺地址的历史记录由回写任务字段级补空，不覆盖已有值
- 正式结算单详情新增 issuedInvoices：经结算单-开票申请关联查出回写发票，只读不参与匹配金额
- 新增建表补丁 blade_invoice_application_invoice_urls_20260930.sql
- 同步更新金蝶附件上传下载链路梳理文档（新增 3.4 销项直链节）
 2026-09-30 14:15:58 +08:00
b2894lxlx 2f4513d501 📝 新增指定账号各业务模块创建量统计 SQL 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 21:42:34 +08:00
刘泉佳 a9eb1d82d4 feat: 收款认领推送金蝶定时任务增加single-flight分布式锁及Nacos配置 2026-09-29 12:12:59 +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
刘泉佳 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
b2894lxlx 087f361a8b ✨ 组织类型改业务字典，并完善金蝶部门代码与MK再提交 
组织类型翻译切换为 organization_type；新增金蝶部门代码字段；流程已结束或已通过时强制新建MK表单实例。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-29 03:15:26 +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
刘泉佳 f97237afe5 docs: 收款认领推送金蝶重构设计与业务流程文档、幂等变更SQL、集成语境术语 2026-09-29 01:02:14 +08:00
刘泉佳 4d62bb6df7 feat: A301-2 认领公告查询接口适配新参数（billstatus/modifytimeS/modifytimeE），时间窗口配置化（Nacos thirdParty.bfi.claimAnnounce.months，默认6个月） 2026-09-28 15:49:53 +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
刘泉佳 fc5bca2b10 docs: 新增HCS合同推送业务流程梳理（审批零埋点/定时扫描/五步推送链/履约规则行级同步/状态机与补偿） 2026-09-28 00:31:09 +08:00
刘泉佳 6dd1d67844 docs: 新增HCS接入实施状态与确认清单（已实现/未实现/待确认事项与上线检查清单） 2026-09-28 00:31:08 +08:00
刘泉佳 165c22c2d7 feat: HCS开票收票数据层与零埋点接线（实体合规字段组/收票合同补录字段/审批与金蝶开票回写置待同步） 2026-09-28 00:31:06 +08:00
刘泉佳 d6561dda17 feat: HCS付款链推送（C106-3/4结算付款特批/C108-1/2履约记录/扫描编排与手动端点/特批结果人工确认） 2026-09-28 00:31:06 +08:00
刘泉佳 594773d7c7 feat: HCS付款申请数据层与零埋点接线（特批字段组/履约记录ID字段/审批与付款推进置待同步） 2026-09-28 00:31:05 +08:00
刘泉佳 892035ee6f feat: HCS履约规则数据层与表单维护（blade_contract_exe_stage表/行级差异标记维护接口/合同审批置行待同步） 2026-09-28 00:31:04 +08:00
刘泉佳 f01cd9ec71 feat: HCS主数据缓存与附件转传支撑（C103-6/7/12模板分类币种缓存、C103-2附件转传与合规附件ID映射缓存） 2026-09-28 00:31:03 +08:00
b2894lxlx eef9d7ad9d ✨ 完善运单导入配载标识、导入状态与凭证文件夹统计 
记录配载标识号并在同批次多运单时生成配载单，导入状态与运单状态对齐，凭证按车牌文件夹统计并支持压缩包重传匹配。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-27 22:54:30 +08:00
刘泉佳 cc9e01cff4 feat: HCS立项与合同数据层（实体合规字段组/合同风险留痕字段/校验留痕表/transport接入hcs-api依赖） 2026-09-27 22:41:04 +08:00
刘泉佳 2f5bb4a5a8 📝 新增金蝶附件上传下载链路梳理文档（A902上传+A801-2下载+对应关系核对） 2026-09-27 22:40:21 +08:00
刘泉佳 a739211d6f feat: 新增桂物合同合规系统（HCS）接入P0骨架（blade-hcs-api模块：Feign/认证拦截器/令牌服务/24接口DTO/分页工具，附Nacos配置段与业务表统一字段组SQL） 2026-09-27 22:22:36 +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
刘泉佳 d94b956f26 fix: 文件上传到金蝶后，加个金蝶附件同步表报存文件信息 2026-09-24 22:51:35 +08:00
刘泉佳 e50f4cbba6 feat: 收款认领金蝶对接新增数据字段与迁移SQL（流水表公告字段、认领来源编码） 2026-09-24 22:20:21 +08:00
刘泉佳 fb39d670c0 docs: 新增收款认领金蝶对接全链路业务流程文档（A301-2公告同步/A301-3认领推送/A301-1收款单回写） 2026-09-24 22:18:46 +08:00
刘泉佳 1b4ed22df3 📝 金蝶附件同步设计文档梳理对齐实施（as-built）：勘误前提、回填路径、事务边界与实施记录 2026-09-24 22:15:43 +08:00
刘泉佳 a2fd96da9d fix: 开票申请同步金蝶按发票张次拆分开票，提交sql 2026-09-24 19:47:54 +08:00
刘泉佳 c2f3a48c0e ✨ 金蝶附件同步（A902）：五类单据推送后联带上传附件、独立同步状态与列表聚合 2026-09-24 13:26:54 +08:00
刘泉佳 a17dd826ec docs: 金蝶附件同步（A902）设计文档与接口文档 2026-09-24 12:44:34 +08:00
刘泉佳 cae284483e Merge remote-tracking branch 'origin/master' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-common/src/main/java/org/springblade/common/config/BladeCommonConfiguration.java
#	blade-service-api/blade-system-api/src/main/java/org/springblade/system/feign/ISysClient.java
#	blade-service-api/blade-system-api/src/main/java/org/springblade/system/feign/ISysClientFallback.java
#	blade-service/blade-system/src/main/java/org/springblade/system/feign/SysClient.java
#	blade-service/blade-transport/pom.xml
#	blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/wrapper/PaymentApplicationWrapper.java
#	blade-service/blade-transport/src/main/resources/application-dev.yml
#	blade-third-party-api/pom.xml
#	doc/nacos/blade-dev.yaml
#	doc/nacos/blade-prod.yaml
#	doc/nacos/third-party-api.yaml
#	pom.xml
 2026-09-24 03:15:30 +08:00
刘泉佳 78fabd15a5 docs: 更新金蝶票池选票业务流程（可用过滤、游标补页与固定查未用） 
同步2026-09-23选票方案演进：可用过滤口径、有界循环补页与nextCursor游标分页机制、
单据使用状态收敛为后端固定查未用、保存链路新增可用性复核步骤、前端弹窗条件与分页交互调整。
 2026-09-23 15:06:20 +08:00