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

37 Commits

Author SHA1 Message Date
刘泉佳 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
刘泉佳 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
刘泉佳 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
刘泉佳 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
刘泉佳 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
刘泉佳 24a594185c :fix: 修正HCS来源标识约定值为WLTMS 2026-10-10 18:39:54 +08:00
刘泉佳 2ea5901238 :feat: 项目立项、合同审批通过后即时推送HCS合规系统（复用单条重推链路，扫描任务降级为兜底补偿，附前端接入设计§6增补） 2026-10-10 18:24:05 +08:00
刘泉佳 7855254a4f feat: 立项与合同HCS前端接入配套端点——C103-8合同特批发起/B103结果回传、C103-2/5附件代理、C101-1风险与C103-6/12主数据查询，合同推送高风险客商挂起待特批 2026-10-09 19:45:40 +08:00
刘泉佳 4cd7fb24df docs: HCS设计文档与实施清单同步一期范围调整（20接口口径，C103-9/C106-1/C108记录暂不对接及特批触发影响） 2026-10-09 12:00:39 +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
刘泉佳 fc5bca2b10 docs: 新增HCS合同推送业务流程梳理（审批零埋点/定时扫描/五步推送链/履约规则行级同步/状态机与补偿） 2026-09-28 00:31:09 +08:00
刘泉佳 6dd1d67844 docs: 新增HCS接入实施状态与确认清单（已实现/未实现/待确认事项与上线检查清单） 2026-09-28 00:31:08 +08:00
刘泉佳 fb39d670c0 docs: 新增收款认领金蝶对接全链路业务流程文档（A301-2公告同步/A301-3认领推送/A301-1收款单回写） 2026-09-24 22:18:46 +08:00
刘泉佳 78fabd15a5 docs: 更新金蝶票池选票业务流程（可用过滤、游标补页与固定查未用） 
同步2026-09-23选票方案演进：可用过滤口径、有界循环补页与nextCursor游标分页机制、
单据使用状态收敛为后端固定查未用、保存链路新增可用性复核步骤、前端弹窗条件与分页交互调整。
 2026-09-23 15:06:20 +08:00
刘泉佳 b322d423d0 fix: 文档重命名 2026-09-23 10:34:20 +08:00
刘泉佳 a2aeeb920d 📝 更新收票推送金蝶与票池选票业务流程文档，新增收票单推送全链路文档 2026-09-23 10:16:17 +08:00
刘泉佳 38c25d862e docs: 新增金蝶票池选票统一查镜像业务流程文档 2026-09-22 21:26:37 +08:00
刘泉佳 d64b45d55d 📝 开票申请金蝶主表字段表补购销方地址电话与开户行展示开关 2026-09-22 11:03:41 +08:00
刘泉佳 6fa7761760 📝 更新开票申请同步金蝶分录取数口径文档 
A303-1 分录字段映射表补全 goodscode/remark/单价税额来源，明确不回查开票项目主数据、不按开票明细费用行展开分摊，税收分类编码与税率为空即报错。
 2026-09-22 10:52:09 +08:00
刘泉佳 7964690e5d 📝 新增应收结算与开票申请同步金蝶设计文档及全链路业务流程文档 2026-09-21 19:14:44 +08:00
刘泉佳 b3eee6347b ⚡ 金蝶全票池定时同步按变更比对落库并加 single-flight 锁 
- 镜像批量 upsert 增加票面字段指纹比对，票面无变化不重写（含 attachments_json 大字段），口径对齐 MyBatis-Plus 非空字段更新策略
- 收票登记绑定前比对 kingdeeInvoicePoolId/kingdeeBillNo/kingdeeStatus，三项均无变化不更新；同步流水只在绑定关系变化或金蝶状态迁移时写入，原因文案按语义拆分为「定时绑定」与「定时刷新」
- 同步入口按租户加 RedisLockClient 分布式锁做 single-flight（零等待、租约可配 lockLeaseSeconds），未开启 blade.lock.enabled 时降级执行并告警
- 客商税号白名单明确为购、销双方税号均须命中客商档案（我方主体税号亦在档案中），抽出 taxNoArchived 做空值防护
- 日志补强：每页过滤漏斗明细、镜像无变化数、镜像未匹配登记提示、翻页触顶告警、补偿绑定耗时与远程补查次数、解析失败带发票号码
- Nacos 模板：MySQL 连接串补 rewriteBatchedStatements=true 使 JDBC 批量真正合批；dev/test 开启 blade.lock.enabled，prod 补开启前置条件说明
- SyncKingdeeTest：方法名更正为 syncKingdeeInvoicePool，测试属性关闭 syncEnabled，避免 cron 与手动触发在同一 JVM 并发跑
 2026-09-21 17:31:22 +08:00
刘泉佳 9a82ed2eaf 📝 新增收票管理同步金蝶全票池发票（A801-1 查询+批量同步+定时绑定关联）业务流程文档 2026-09-21 13:19:10 +08:00
刘泉佳 7ec3b2adbc ⚡ A801-1 全票池发票查询改为 pageNo/pageSize 透传分页 
- IBfiService.queryInvoicePool 改为单页查询返回 BfiPageVO，BfiServiceImpl 移除 queryAllPages 全量翻页
- 正式结算单认领查询透传 current/size，多取 1 条探测 hasMore 并合成 total，前端 R<IPage> 契约不变
- 移除内存作废过滤（rim 无对应查询条件，透传分页下会产生页内空洞）
- 同步更新 BfiUtil 技术文档 A801-1 说明与使用方清单
 2026-09-20 21:08:42 +08:00
刘泉佳 44a34f57f0 🔥 移除业财融合资料文档的版本跟踪（TMS业财融合方案/接口文档/编码规范/集成流程梳理） 2026-09-20 16:46:15 +08:00
刘泉佳 719ec4e8f6 ✨ 客商档案同步金蝶完善：伙伴类型按客商性质字典解析、推送银行/联系人分录、BFI配置抽取BfiProperties 2026-09-20 16:05:54 +08:00
刘泉佳 0531177ed7 ✨ 新增金蝶客商数据定时同步任务（自动推送+使用状态停用联动） 2026-09-18 21:34:37 +08:00
刘泉佳 d9f94bb161 📝 新增客商档案同步金蝶技术文档 2026-09-18 20:01:36 +08:00
刘泉佳 aa22ad98d8 🐛 修复付款申请同步金蝶断链后重推被拦截问题，推送与回写全链路支持幂等恢复 
- A102-2 应付单已生成时幂等跳过保存并续推 A103-1，A103-2 勾稽已下推成功则直接回填
- 预付款 A103-3 恢复推送前增加 A103-2 预检，避免重复推送
- 定时回写任务将生成失败单据纳入 A103-2 轮询，自动纠偏远端已生成单据
- 抽取公共方法：A103-2 取最近修改、分录标识生成、批量分批、统一日期格式（yyyy-MM-dd HH:mm:ss）
- 新增全链路逻辑梳理文档（推送链路与回写链路连贯性）
 2026-09-18 14:15:07 +08:00
刘泉佳 20fddf2c60 fix: - 修复BFI单据保存结果反序列化失败导致错误信息丢失。 
- 财务应付单保存A102-2,传业务字段。并保存id
- 付款管理批量同步方法优化
 2026-09-18 10:48:43 +08:00
刘泉佳 bdd1d7571f ✨ 新增金蝶付款结果定时回写任务（A103-2/A103-4）并抽取BFI分页通用翻页工具 2026-09-17 18:57:19 +08:00
刘泉佳 e18c7dcfda 📝 新增付款管理正式付款同步金蝶技术文档 2026-09-17 10:39:08 +08:00
刘泉佳 345d8ebe38 fix: 付款申请同步组织编码与币种改为取自关联合同并调整默认推送配置 2026-09-16 17:30:28 +08:00
刘泉佳 380d36ee45 📝 新增付款申请同步金蝶（星瀚）技术文档 2026-09-16 16:52:22 +08:00