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
b2894lxlx f606850814 🐛 修复凭证分片上传 Mixed Content，支持服务端代传兜底 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-13 20:44:09 +08:00
刘泉佳 805ca9d380 chore: 归集刘泉佳提交的金蝶对接SQL迁移脚本到doc/sql/transport/lqj 2026-10-13 18:47:11 +08:00
刘泉佳 08e07841b5 :feat: 合同特批结果定时查询兜底并同步更新设计文档 
- HcsPushTask 合同任务每轮附带 syncProcessingSpecResults：扫描特批中（processing）合同调 C103-4 详情，fdApprovalStatus=approved/approvalinvalid 联动恢复/驳回，作为合规回调未达时的补偿
- 更新 2026-10-12 特批流程梳理文档：状态机、阶段 B/C/D、§五机制汇总、§六配置、§七常量对齐当前实现
- 2026-10-09 前端接入设计文档标注 spec-apply 失效说明
 2026-10-13 18:36:38 +08:00
刘泉佳 ef09bfa9cd :fix: 特批附件校验值与业务字典对齐，变更提交补充强校验 
- 提交校验判定值由「特批说明」改为「特批附件」，与业务字典 contract_attachment_type 实际选项一致，修复高风险/黑名单客商已上传特批附件仍报错的问题
- 报错文案同步与前端下拉框一致
- submitChange（变更提交/变更驳回重提交）补充同一校验，堵住变更绕过附件强校验的缺口
- 补充字典幂等脚本 blade_contract_attachment_type_dict_20261013.sql（本地为界面新增未沉淀脚本）
 2026-10-13 18:36:07 +08:00
刘泉佳 25fbb89210 fix: TMS 币种码 -> HCS 币种名称 2026-10-13 15:24:24 +08:00
刘泉佳 7def08ab2f :chore: 对齐third-party-api.yaml的HCS推送配置结构（即时推送总开关+五类扫描独立开关，修正baseUrl网关前缀） 2026-10-13 15:20:40 +08:00
b2894lxlx e0da79d745 🐛 修复 MinIO 预签名走外网 HTTPS，并过滤无效应收应付变更记录 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-13 12:44:39 +08:00
刘泉佳 52da9aab24 docs: 补充金蝶物料映射Nacos配置样例与分录拆分逻辑梳理文档 
third-party-api.yaml 新增 thirdParty.bfi.material 物料映射段（中文key方括号写法）；新增业务流程文档：取值来源总表、三级拆分规则、大类判定与税率取值、物料计量单位映射、场景算例与已知口径
 2026-10-13 11:34:55 +08:00
刘泉佳 b7293c0ddb :feat: HCS操作人登录名配置化统一取值，模板映射改括号记法修复中文键绑定失败 2026-10-12 17:36:57 +08:00
刘泉佳 63c2f7ed1e :feat: 合同附件挂载按 eopCdraft 枚举分类（fdEntityKey） 
- HcsSyncConstant 新增 CONTRACT_ATTACH_KEY_SPECIAL/SEAL/OTHER（eopCdraftSpecial/eopCdraftSign/eopCdraftOther）
- 转传接口返回 HcsAttachmentRefDTO（fdId+fdEntityKey+fdFileName），替代纯 fdId 列表
- 合同链路：主文件 approved=true 挂 eopCdraftSign、其它附件挂 eopCdraftOther、特批说明挂 eopCdraftSpecial
- buildDraftParam 直接消费引用列表统一补 fdBindType=ADD；特批付款/履约记录/收票单/开票登记四个挂载点改为在返回引用上补各自字段，行为不变
 2026-10-12 16:52:39 +08:00
刘泉佳 9e4b8a6d58 :feat: HCS附件转传映射落库，Redis缓存判重改为blade_hcs_attachment_sync持久化表 
- 新增 HcsAttachmentSync 实体与 Mapper（biz_type+biz_id+attachment_key 唯一，照金蝶附件同步表设计，仅落成功记录）
- HcsAttachmentSupport 移除 BladeRedis 依赖，transferOne 查表命中即复用合规附件ID，未命中上传后落行
- transferAttachments/transferContractAttachments 增加 bizType/bizId 入参，六个调用点（合同主附件/特批说明/特批付款/履约记录/开票登记/收票单）传入业务上下文
- HcsSyncConstant 删除 ATTACHMENT_CACHE_KEY_PREFIX/ATTACHMENT_CACHE_TTL_DAYS 缓存常量
- 新增建表脚本 blade_hcs_attachment_sync_20261012.sql，技术设计文档 §6 映射缓存表述同步更新
 2026-10-12 16:51:04 +08:00
b2894lxlx 17ede93a04 ✨ 新增小程序用户后台管理接口与菜单 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-12 13:49:08 +08:00
b2894lxlx e19c3b100a ✨ 小程序用户独立为 blade_mp_user，并兼容司机/车辆 OCR 宽松日期 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-12 13:02:08 +08:00
刘泉佳 b8d93bc921 :feat: 特批结果回传校验来源系统标识，不符抛出来源系统标识错误异常 2026-10-12 11:48:13 +08:00
刘泉佳 e44270e6f0 :fix: 特批结果回传接口改为secure白名单放行，移除PERMIT_ALL注解 2026-10-12 11:36:54 +08:00
刘泉佳 6f774d50c7 :docs: 更新HCS特批结果回传机制相关文档 2026-10-12 11:18:35 +08:00
刘泉佳 3b7559e9d6 Merge branch 'feature/payment-apply-bfi-autoSync' into feature/payment-apply-bfi-sync 
# Conflicts:
#	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
 2026-10-12 10:59:15 +08:00
刘泉佳 8e6e263921 :feat: 新增外部客商高风险黑名单管控与合同自动特批 
1. GET /hcs/risk 返回 CustomerRiskVO：内部组织客商默认无风险不调合规，外部客商高风险/黑名单返回固定风险提示文案（riskTip），供基本信息备注后展示
2. 合同三个提交入口（submit/toTemporary/submitFormal）校验：甲乙方任一方高风险/黑名单时必须上传特批说明附件（attachmentType=spec_explanation）
3. pushContract 流程重排：C101-1 风险校验仅留痕不再阻断，C103-1 起草成功后高风险/黑名单合同自动挂起特批审核（currentNode）并发起 C103-8，解开原 need 挂起无 hcs_fd_id 的特批死锁
4. 特批结果联动：B103 回传/人工确认 approved 恢复审批通过展示，rejected 联动合同审批驳回走重新审批闭环
5. 补充推送入口/自动特批触发/跳过原因日志，流程梳理文档同步更新（§二/§七/§八/新增§九）
 2026-10-11 17:47:53 +08:00
刘泉佳 bce360350c fix: 审批通过自动同步金蝶文档 2026-10-11 15:51:03 +08:00
刘泉佳 78dd523e2f 📝 新增C102-1与C103-1接口页面字段取值说明文档（含必填项标记与自检清单） 2026-10-10 20:19:17 +08:00
刘泉佳 7e6970277c :feat: HCS接口500错误信息还原（Feign降级工厂还原远程msg/traceId，落库hcs_sync_msg） 2026-10-10 20:16:39 +08:00
刘泉佳 9ba9fe4dd8 :feat: HCS创建单位改为固定组织配置（creator-unit-id/name，项目立项fd_creator_unit与fd_avail_units共用，环境变量可覆盖） 2026-10-10 18:58:30 +08:00
刘泉佳 24a594185c :fix: 修正HCS来源标识约定值为WLTMS 2026-10-10 18:39:54 +08:00
刘泉佳 2ea5901238 :feat: 项目立项、合同审批通过后即时推送HCS合规系统（复用单条重推链路，扫描任务降级为兜底补偿，附前端接入设计§6增补） 2026-10-10 18:24:05 +08:00
刘泉佳 5d1f977abd feat: 付款申请纳入金蝶单据锁定与解锁流程（推送后锁单-删单回调还原-作废守卫-锁状态展示） 2026-10-10 16:00:32 +08:00
刘泉佳 15d6f736e5 feat: 金蝶锁单改1对1逐张调用并新增列表锁状态展示 2026-10-10 15:18:57 +08:00
b2894lxlx 4e7193893f ✨ 组织与人员支持OA增量同步，并完善用户启停与性别空值 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-10 13:56:29 +08:00
刘泉佳 7cae2034a4 chore: 模板补齐kingdee-bfi回调secure.auth放行规则并与Nacos实际配置对齐 2026-10-10 10:34:48 +08:00
刘泉佳 b4119d9dfa feat: 金蝶解锁回调端点加入secure免登放行白名单（blade.secure.skip-url） 2026-10-10 09:38:46 +08:00
b2894lxlx e20afc0d55 ✨ 合同结算币种贯通应收应付与结算，并完善合同编号与字段 
合同结算币种写入应收应付与预结算；总单运费默认币种统一为 RMB；同步合同申请日期、主要内容、部门合同编号前缀及用印材料字典等能力。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-10 00:53:17 +08:00
刘泉佳 1063d5875c docs: 金蝶单据锁定与解锁业务流程文档 2026-10-09 19:52:53 +08:00
刘泉佳 e08be9a297 feat: 正式结算单/开票申请同步金蝶后联带锁单，支持解锁回调与金蝶删单还原 2026-10-09 19:52:15 +08:00
刘泉佳 7855254a4f feat: 立项与合同HCS前端接入配套端点——C103-8合同特批发起/B103结果回传、C103-2/5附件代理、C101-1风险与C103-6/12主数据查询，合同推送高风险客商挂起待特批 2026-10-09 19:45:40 +08:00
刘泉佳 5e6ff08460 feat: HCS配置补充默认鉴权头与立项模板编码 2026-10-09 17:49:19 +08:00
b2894lxlx ef9eab737f ✨ 优化主数据校验与运单导入空值处理 
电报略码改为选填且填写时唯一；用户支持账号姓名手机模糊查询；合同名称允许重复；项目情况说明扩至1000字；导入运单未填里程费用不再落库-1。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-09 17:07:56 +08:00
刘泉佳 d09e4faf0b feat: HCS配置补充默认鉴权头与立项模板编码 2026-10-09 15:02:01 +08:00
刘泉佳 4cd7fb24df docs: HCS设计文档与实施清单同步一期范围调整（20接口口径，C103-9/C106-1/C108记录暂不对接及特批触发影响） 2026-10-09 12:00:39 +08:00
刘泉佳 b96a17dbef feat: HCS Nacos配置段补充exe-stage/credit/perf-record同步开关（默认false，一期暂不对接） 2026-10-09 12:00:29 +08:00
刘泉佳 ef0f9e6e36 fix: A303-1 开票申请推送放开来源单据字段 2026-10-08 19:59:04 +08:00
刘泉佳 a6af9a2ccd feat: 收款认领公告查询认领人改取Nacos配置thirdParty.bfi.claimAnnounce.claimusers，不再按当前登录用户姓名查询 2026-10-08 17:34:11 +08:00
刘泉佳 7505d9bc55 feat: 全票池同步发票种类白名单下推远端——invoiceTypes单值参数按编码拆轮独立切片续扫，不再拉回后内存过滤消耗翻页额度；配置键 thirdParty.bfi.invoiceReceipt.invoiceTypes 2026-10-08 10:59:09 +08:00
weicw-dshsa ac6318d174 ✨ 新增存量司机/车辆补生效快照的订正脚本 
「能否接单」的判据是生效快照指针，该列随认证门槛一起新增时对存量对象一律为 NULL，门槛默认开启后存量司机与车辆全部被判未认证、接不了单。脚本给尚无快照的对象补一条已通过记录并把指针指过去，含备份、校验与回退；幂等，且能在已订正过的库上续跑（从段内最大号之后接着发号，不撞主键）。
 2026-10-07 18:21:38 +08:00
weicw-dshsa 2e5eae4d32 ✨ 打卡照片按类型最多传 9 张，照片列加宽为 text 
- 节点打卡提交新增 photoItems（带显式类型），photos 原样保留供旧版小程序按下标回推
- 打卡照片是每个打卡节点必有的类型，不由过程配置决定，与各凭证类型各自最多 9 张
- 新版提交要求每个类型至少 1 张；旧版仍只要求至少 1 张，避免打断未升级的小程序
- 管理端订正只校验每类上限，不校验必填
- photos 由 varchar(2000) 改 text：36 张约 4000 字符，旧列宽约 17 张即溢出
- 基线建表脚本补 COLLATE=utf8mb4_0900_ai_ci（与本机库实际排序规则一致）
 2026-10-07 16:49:19 +08:00
刘泉佳 eb1edd3bbe docs: 金蝶票池选票回切镜像读终态口径文档，09-22实时版加退役声明 2026-10-05 17:54:03 +08:00
刘泉佳 0dc6c9457a chore: 金蝶票池镜像读回切SQL（可用过滤两列+认领索引幂等脚本）与全票池同步Nacos配置键 2026-10-05 17:51:54 +08:00
weicw-dshsa 7c30ead839 ✨ 异常处置支持归属过程节点并新增打卡门禁 
异常上报强制选择过程节点，节点归属写入 node_code / node_name；节点存在未了结
异常时，该节点及其后节点不可打卡（异常门禁），被拦节点仍可展开查看回填内容。

另新增顺序门禁：前置打卡节点未完成时后续节点不可打卡且不可展开；在途节点不受
顺序门禁约束，但仍受异常门禁约束。

配套：
- 过程配置「上传货量为是、货量类型为空」的脏配置订正为不采集货量
- 网关补充 /blade-resource/** 路由（图片上传，小程序打卡与异常上报照片均经此）
 2026-10-05 15:10:24 +08:00
weicw-dshsa 7296a5af21 ✨ 异常处置跟进支持上传附件 
跟进记录新增 attachments_json 列，存 [{name, url}] 形式的 JSON 数组。
跟进说明与附件至少填其一即可：只传附件时，follow_content 列为 NOT NULL，
故写入固定文案「已上传跟进附件」，列表按该文案展示。

建表脚本补 COLLATE：原先只写 CHARSET，落到 MySQL 8 服务器默认排序规则，
与库中实际的 utf8mb4_0900_ai_ci 不一致。
 2026-10-05 01:09:33 +08:00
weicw-dshsa 8d35abd23e ✨ 异常处置新增编辑功能 
运管员可订正已上报的异常内容：异常类型、异常原因、上报说明、现场照片。
车牌、项目、承运商、配载单号由上报时从运单回填，不开放编辑，避免与运单脱钩。

编辑不改动处置状态。状态只能经跟进与完成流转，因为运单详情、运单列表、
首页计数与待办四处都以 disposal_status IN (pending, processing) 判定未完成，
允许编辑改状态会让已结案的异常重新长出来，而那四处判定无从知晓。

每次编辑按字段逐项比对生成变更说明，写入一条跟进记录留痕。
变更说明会内嵌修改前后的原文，长文本字段一次编辑就可能超过跟进内容的
varchar(500) 上限，故按 500 截断。

Permission 表达式用 hasMenu('exception_disposal_edit')：
@PreAuth 的值由 SpEL 求值，root object 是 AuthFun，
写成裸字符串会被当作属性访问而在请求时抛错。
 2026-10-05 00:54:08 +08:00
weicw-dshsa 5061df8c78 📝 删除认证迁移脚本里的解释性注释 
SQL 本身（列名、列 COMMENT、IF 条件）已经把意图说清楚了，注释在复述它、
或是在讲当时的排查过程，对读者没有增量信息。只留一处真正反直觉的：
唯一索引不对 NULL 去重，故 tenant_id 必须 NOT NULL。

注释 31 -> 8 行，DDL 未动，重跑两遍验证。
 2026-10-04 23:49:33 +08:00
weicw-dshsa 4a65951adc 📝 精简认证迁移脚本注释 
上一版注释把决策理由、备选方案、实测数据都写进了脚本，篇幅盖过 SQL 本身
（cert_record 注释 58 行 / 非空 170 行），后续阅读反而更难抓到重点。
按同目录既有脚本的密度收敛：只留「从 SQL 本身看不出来」的事实
（字段业务含义、不可回退的指针语义、排序规则不能改的原因），
删掉论证过程与常识性说明。

cert_record 注释 58 -> 31 行，另两个 14 -> 6 行；
DDL 一个字未动，重跑一遍验证仍无报错。
 2026-10-04 23:46:39 +08:00