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

241 Commits

Author SHA1 Message Date
刘泉佳 ed5eda6ed2 :docs: 更新HCS审批同步推送说明 2026-10-20 21:45:37 +08:00
刘泉佳 7a48057019 :feat: 新增合同金蝶同步结果回调（D903） 
- 新增 /hcs/contractKingdee/result 免登回调端点，投送人/钢厂/结算中心合同共用
- 按合同编号定位回填金蝶合同ID，失败记录原因；本接口不处理法务审批结论
- contractType/sourceSystem 均按非必填处理，传值时校验来源标识为 WCCK
- 回调成功/失败追加变更记录并原文留痕 blade_hcs_check_log（check_type=kingdee）
 2026-10-20 16:45:52 +08:00
刘泉佳 fac4c112aa :feat: 新增项目金蝶同步结果回调并回填金蝶ID 
- 新增 /hcs/projectLegal/result 免登回调端点（D902），按项目编号定位回填金蝶项目ID/编号，原文留痕 blade_hcs_check_log
- 合同 contractLegal/result 回调成功分支回填金蝶合同ID
- 项目/合同金蝶回调成功与失败均追加变更记录（changeRecordJson）
- 项目立项/合同列表支持按是否同步金蝶、是否同步合规筛选
- 新增增量SQL：blade_project_apply.kingdee_id/kingdee_number、blade_contract_manage.kingdee_id
 2026-10-20 11:05:11 +08:00
刘泉佳 50cce600ab :feat: 新增HCS合同合规对接配置并更新dev环境模板与凭据 
- blade-dev.yaml：新增 hcs 配置块（mock 开关、baseUrl、Authorization/Key-Auth、
  创建单位、五类推送开关、立项/合同模板映射、风险与额度校验、特批/开票/收票单、
  附件转传、主数据缓存等）
- blade-dev.yaml：补充 bfi 物料映射、收款认领公告、全票池发票绑定与审批通过自动同步配置
- blade-dev.yaml：新增 MinIO 文件存储配置；caller 侧调整 lock、logging、wechat.mini 位置
- third-party-api.yaml：更新 hcs Authorization、创建单位 id/name（百色物产新源供应链有限公司）、
  立项 template-code 回退为 template_15x0og、承运商合同模板 id
 2026-10-16 19:10:51 +08:00
刘泉佳 6fc2cca9ef Merge branch 'feature/payment-apply-bfi-sync' into feature/hcs-api-p0 
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/mk/MkProcessBizHandlers.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/ContractManageServiceImpl.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/task/CustomerKingdeeSyncTask.java
#	blade-service/blade-transport/src/main/java/org/springblade/transport/task/PaymentKingdeeResultTask.java
#	doc/nacos/blade.yaml
#	doc/nacos/third-party-api.yaml
 2026-10-15 04:07:13 +08:00
刘泉佳 259407c3b9 docs: 新增金蝶BFI全链路梳理总纲与BFI对接纯操作手册（2026-10-14） 
总纲：按业务域汇总前端入口-后端链路-定时任务三层流程，含审批自动同步/单据锁单解锁/failed重推/票池镜像读等新机制、状态机、配置开关与风险清单，并补充金蝶侧效果图14张；操作手册：面向业务与运维的纯操作版，含客商/预结算/结算/付款/开票/收票/收款认领与汇率维护全流程截图，TMS页面截图10张
 2026-10-15 03:31:23 +08:00
刘泉佳 e24314d6cb :feat: 新增金蝶单据锁定解锁总开关（billLock.enabled，控制推送锁单/解锁回调/补偿重锁） 2026-10-15 03:21:33 +08:00
刘泉佳 94acfc2174 Merge branch 'master' into feature/payment-apply-bfi-sync 2026-10-14 15:34:45 +08:00
b2894lxlx b791401620 🐛 扩容用户手机号字段并规范化 OA 多号码同步 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-14 15:15:53 +08:00
b2894lxlx dee392eb48 🐛 修复 IAM 同步 dept_id 超长与手机号明文解密失败 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-14 15:13:19 +08:00
刘泉佳 865e3a0498 Merge branch 'master' into feature/payment-apply-bfi-sync 
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
 2026-10-14 14:24:27 +08:00
刘泉佳 076145d7f6 :feat: 审批通过自动创建履约计划行，C103-9同步前置至特批挂起之前 2026-10-14 14:11:31 +08:00
b2894lxlx 6f4812db75 ✨ 项目申请平台公司多选，运单导入承运商筛选与复制草稿优化 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-14 12:59:31 +08:00
刘泉佳 40181a64b0 chore: 样例配置补充receivedInvoiceResult/billLock/customer金蝶调度段 
三个定时任务此前仅在代码里有默认值、Nacos无显式配置，错峰值无法按环境显式下发；样例与 Nacos blade-dev.yaml 同步补齐（receivedInvoiceResult :08/10min、billLock.retry :02/5min、customer 每日02:00），开关默认关闭与代码兜底一致
 2026-10-14 11:29:40 +08:00
刘泉佳 5211e8f18e chore: 按业务复杂度错峰分散金蝶BFI定时任务调度时间 
原 6 个调度默认值全部压在整点边界（:00/:10/:20 同时起 4 个重任务），按复杂度错开起始分钟、频率不变、互不重叠：payResult :01/10min、receiptClaimPush :04/10min、autoSync.retry :05/10min、receivedInvoiceResult :08/10min、invoiceReceipt :16/30min、billLock.retry :02/5min；整点留缓冲，同步更新代码默认值、本地 yaml 兜底与 Nacos blade-dev.yaml
 2026-10-14 11:10:38 +08:00
刘泉佳 5470eaf9c5 refactor: 统一金蝶BFI配置为BfiProperties类注入并补齐Nacos配置缺项 
1. BfiProperties 新增 payResult/receivedInvoiceResult/receiptClaimPush/invoiceReceipt/customer/blacklist/invoiceResult/arResult/billLock/autoSync 嵌套配置类，收口 thirdParty.bfi.* 全部键；receivedInvoice 补 queryWindowDays/resultWindowDays/lockLeaseSeconds
2. 6 个定时任务、审批监听器及 6 个 ServiceImpl 共 13 处 @Value 改为 BfiProperties 注入（Nacos 刷新后自动重绑定，无需重启）
3. 本地 third-party-api.yaml 补 invoiceReceipt.invoiceTypes/compensateLimit 与 autoSync 整段，Nacos blade-dev.yaml 补 invoiceReceipt.lockLeaseSeconds
 2026-10-14 11:10:20 +08:00
刘泉佳 30028b9e27 :feat: 付款申请收款方高风险黑名单统一走特批（特批附件校验/特批审核挂起/结果联动审批状态/金蝶推送门禁） 2026-10-14 10:05:46 +08:00
b2894lxlx fe78152515 🐛 MinIO 客户端支持 /oss 路径前缀并固定 region，修复合并分片失败 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-14 00:50:27 +08:00
b2894lxlx 7c7fe2e1c1 🐛 修复 MinIO endpoint 含 path 导致 blade-transport 启动失败 
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-13 22:14:50 +08:00
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