Commit Graph

65 Commits

Author SHA1 Message Date
zhouyonggao 88b596a435 fix(trans_hub): 更新子项目提交版本
- 将 trans_hub 子项目提交版本从 7274be3a27b5c473515cff79a20d5ed885b15083
  更新到 1a97b2bae043b42f0440c837d8c16717e14c5fac
2026-03-16 17:34:14 +08:00
zhouyonggao 94e744970c chore(trans_hub): 更新子项目提交版本
- 将 trans_hub 子项目的提交哈希从 710ff73b16ad9a82796c1b9d4ec7d1da69ca8afa 更新为 7274be3a27b5c473515cff79a20d5ed885b15083
2026-03-16 17:33:41 +08:00
zhouyonggao f47c4490a1 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交哈希从 c3b88cb 更新为 710ff73b
- 同步子项目状态以反映最新的代码变更
2026-03-16 17:33:20 +08:00
zhouyonggao 2cf186fa8b chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交版本从 02e6a45 更新为 c3b88cb
- 保持子项目依赖的最新状态以包含最新改动
2026-03-16 17:26:10 +08:00
zhouyonggao 80742c9f37 chore(trans_hub): 更新子项目提交引用
- 更新 trans_hub 子项目的提交版本号
- 保证子项目代码库一致性
- 便于追踪依赖的具体版本变更
2026-03-16 16:13:24 +08:00
zhouyonggao 207817f46b chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 e641be15f13ade3a15e83f54c23131d3167956cb 更新到 0669a44f01d111680f8655b88a54eed694e51cbf
2026-03-16 15:09:21 +08:00
zhouyonggao 5b818cba3c chore(trans_hub): 更新子项目提交ID
- 将子项目提交ID从de03b84f797899e1234b630f89aad2735d60598c更新为e641be15f13ade3a15e83f54c23131d3167956cb
2026-03-16 14:47:06 +08:00
zhouyonggao 50ca49ec69 chore(trans_hub): 更新子项目提交指向
- 将 trans_hub 子项目的提交哈希由 bfc9d56 更改为 de03b84f
- 保持子项目同步至最新代码状态
2026-03-16 14:41:59 +08:00
zhouyonggao 8efd47cbbb chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 6538c651f79b3f78851f226eeb276074837d7c4f 更新到 bfc9d56ccf08ae6515d9abd3546337bcb592b4e2
2026-03-16 14:39:32 +08:00
zhouyonggao 57667f698e chore(trans_hub): 更新子模块提交指针
- 子模块 trans_hub 从 cc0ab63 提交更新至 6538c65
- 保持子模块指向最新版本以同步依赖调整
2026-03-16 14:27:52 +08:00
zhouyonggao 4c447c91c1 fix(trans_hub): 修复子项目脏状态提交问题
- 更新了 trans_hub 子项目的提交哈希,标记为脏状态
- 修正了子项目版本同步问题
- 确保子项目状态准确反映当前工作区修改情况
2026-03-16 14:16:56 +08:00
zhouyonggao c56362b610 fix(trans_hub): 修复子项目dirty状态标识问题
- 修正子项目提交状态标记为dirty的问题
- 确保子模块状态与主仓库同步显示
- 防止错误的dirty标识影响构建和提交流程
- 改善子项目状态检测的准确性
2026-03-16 14:16:29 +08:00
zhouyonggao 57c8657140 chore(trans_hub): 更新子模块提交引用
- 将 trans_hub 子模块的提交哈希更新为 e7fff6fa6fbc2d4b83d8b2aea0d5a0c19c8baa5a-dirty
- 确保代码基依赖正确指向最新提交
2026-03-16 14:15:37 +08:00
zhouyonggao 5b2ede4b9e fix(trans_hub): 修复子项目提交状态标记问题
- 修正了子项目提交记录显示为“dirty”的问题
- 确保子项目提交状态与实际代码一致
- 防止错误的提交状态影响整体构建过程
2026-03-16 14:11:45 +08:00
zhouyonggao dc8e2840fb chore(trans_hub): 更新子项目提交引用
- 将子项目提交版本从 a9ed679d63ab7e591944dad038e5657e83c8aaef 更新为 c3a015bd7180c660e2c14d84cb2717bf9ffa503f
2026-03-16 14:10:33 +08:00
zhouyonggao 9ffe87f0c2 chore(trans_hub): 更新子项目提交版本
- 将 trans_hub 子项目的提交版本从 60ecb8361525f81c6d3fbbba8336905f14b410dc 更新为 a9ed679d63ab7e591944dad038e5657e83c8aaef
2026-03-16 14:04:55 +08:00
zhouyonggao 5b8a3dca99 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 b03b8c5d95 更新至 60ecb83615
- 同步子项目代码库,确保引用版本一致
- 提升整体代码库稳定性和一致性
2026-03-16 13:52:57 +08:00
zhouyonggao 795e4be5b7 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交更新到最新版本
- 通过新的提交引用同步子项目状态
2026-03-16 13:49:33 +08:00
zhouyonggao c9ed960edf chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交哈希从 f126867fc4962f244b92a0c9969e750c85343cd6 更新为 5a72849ba89e83a90b341d4f8c171c72a602b8dd
2026-03-16 13:14:23 +08:00
zhouyonggao 7b6f404ca0 chore(trans_hub): 更新子模块指向的提交
- 将 trans_hub 子模块的提交从 89365a6 更新到 f126867
- 保持子模块版本同步以获取最新代码更改
2026-03-16 13:01:48 +08:00
zhouyonggao 2bd5148856 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 67b0963 更新到 89365a6
2026-03-16 12:59:58 +08:00
zhouyonggao bd8bc25024 chore(trans_hub): 更新子项目提交引用
- 将子项目提交哈希从 c8cb7478e7aa533e7486e2e2e0d1162a1eabbcb4 更新为 67b09636a8143eeebce7d810fc1c2c373c8d686e
2026-03-16 12:54:18 +08:00
zhouyonggao 556dec1b0a chore(trans_hub): 更新子项目提交版本
- 将 trans_hub 子项目的提交版本从 0b52033fa070eee4b84eabbf81d7044d41ef5ba5 更新到 c8cb7478e7aa533e7486e2e2e0d1162a1eabbcb4
2026-03-16 11:22:19 +08:00
zhouyonggao db31d462a5 chore(trans_hub): 更新子项目提交哈希值
- 将子项目 trans_hub 的提交哈希由56a9478更新为0b52033
- 确保子项目引用指向最新的提交记录
2026-03-16 11:09:21 +08:00
zhouyonggao 015258920d chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交更改为 56a947800fc2e1d6055dbd083f11ff53ef3d23e4
2026-03-16 10:55:16 +08:00
zhouyonggao 80990be1a7 chore(trans_hub): 更新子模块提交引用
- 将 trans_hub 子模块的提交从 6aaea4f7 更新到 3451f0b9
2026-03-16 10:52:56 +08:00
zhouyonggao 20c506264f chore(trans_hub): 更新子项目提交状态信息
- 修改了子项目 trans_hub 的提交哈希,标记为脏状态
- 确保当前工作目录状态在子项目提交中得到反映
2026-03-16 10:47:58 +08:00
zhouyonggao d1a890682e chore(trans_hub): 更新子模块提交引用
- 将 trans_hub 子模块的提交从 81f97ce 变更为 3374fb8
- 标记子模块状态为 dirty,表明存在未提交的更改
2026-03-16 10:47:32 +08:00
zhouyonggao 19eaeb7508 chore(trans_hub): 更新子项目提交版本
- 将 trans_hub 子项目的提交从 685625b 更新到 81f97ce
- 保持子项目版本同步与依赖一致
- 确保集成最新代码变更及修复
2026-03-16 10:43:48 +08:00
zhouyonggao 11331968ea chore(trans_hub): 标记子模块状态为脏标志
- 更新trans_hub子模块指针,添加-dirty后缀
- 表示子模块有未提交的本地修改内容
2026-03-16 10:42:34 +08:00
zhouyonggao 4cd6adf4b8 chore(trans_hub): 更新子项目提交引用
- 更新 trans_hub 子模块指向的新提交哈希值
- 保持子模块与目标代码库同步
- 提升项目依赖的一致性和稳定性
2026-03-16 10:40:39 +08:00
zhouyonggao 30a2185876 fix(trans_hub): 更新子项目提交指针
- 子项目 trans_hub 的提交指针从 3a193f4 更新到 1a48912
- 确保依赖的子项目代码版本同步最新提交
2026-03-16 10:14:07 +08:00
zhouyonggao f1a58999d4 chore(trans_hub): 更新子项目提交引用
- 将子项目提交从 bd4866457df441eae073ed52b4537c31827daa63 更新到 3a193f48f8a6f05d8b2ea5acdf44726c94833e55-dirty
- 反映子项目最新变更状态
2026-03-16 09:57:13 +08:00
zhouyonggao d13fb3860a docs(api): 删除接口需求及校验相关的陈旧内容
- 移除了关于接口需求、业务逻辑、字段规则等核查的旧版文档
- 删除了未处理异常、边界情况及错误信息检查的描述
- 去除了关于避免亏损和对账准确性的相关文档内容
2026-03-13 17:54:31 +08:00
zhouyonggao 60660da7ad docs(api): 优化订单状态和券码状态描述格式
- 调整订单状态描述的换行格式,提升可读性
- 调整券码状态描述的换行格式,保持风格一致
- 保持示例值和状态解释内容不变只改进格式布局
2026-03-13 17:51:14 +08:00
zhouyonggao bd7c955654 feat(reconciliation): 新增对账文件查询及下载接口
- 新增POST方式的对账文件查询接口,支持按会计日期和文件接口名查询文件列表
- 新增POST方式的对账文件下载接口,支持通过文件ID、接口名和密码下载指定对账文件
- 规范对账文件的命名及格式说明,采用CSV UTF-8-BOM编码
- 增加接口参数及返回字段定义,增强错误场景提示,提升接口安全性及易用性
- 更新相关文档,补充详细接口使用说明、业务规则及测试用例
- 调整旧有对账单下载接口为文件查询和文件下载分离设计,提高接口职责明确度
2026-03-13 17:49:37 +08:00
zhouyonggao d96a8b2a13 feat(reconciliation): 新增对账文件查询下载及批量补推接口
- 新增GET接口支持按对账月份查询及下载对账文件,文件为CSV格式
- 实现每月3号生成上月完成订单对账文件,文件名格式统一规范
- 支持对账文件内容字段定义及编码格式为UTF-8-BOM以兼容Excel
- 新增POST接口支持手动批量补推服务完成通知,支持权益码列表和时间范围筛选
- 实现补推接口的数量限制、幂等处理和dryRun试运行模式
- 添加详细业务规则、输入输出字段及验收标准
- 补充对账流程和批量补推流程的PlantUML流程图及步骤说明
2026-03-13 17:37:01 +08:00
zhouyonggao 601129a28d docs(order): 更新订单号及相关业务号生成规则说明
- 优化订单号(order_no)生成规则,采用时间戳+机器ID+序列号结构,确保全局唯一且可读性强
- 详细说明外部业务号(out_biz_no)的格式和用途,添加服务类型编码实现幂等标识
- 新增合作方交易流水号(partner_tx_sri_no)规则,满足邮储服务开放平台接口要求
- 补充各类编号示例及特点,便于理解与实际应用
2026-03-13 17:13:02 +08:00
zhouyonggao 4bf4950aad docs(README): 更新重试机制及失败任务处理说明
- 新增第9次及以后重试间隔为每2小时重试一次
- 将超过失败次数限制调整为超过72小时仍失败则标记为“已放弃”
- 明确任务放弃后不再自动重试,等待告警通知人工介入
2026-03-13 17:11:31 +08:00
zhouyonggao c478f7a146 docs(sequence-diagrams): 更新服务兑换过期处理流程说明
- 修改业务说明为系统自动处理券码已过期的订单
- 更新关键规则以券码过期状态由上游蓝色兄弟系统定义为准
- 调整定时任务扫描条件为券码状态为已过期(4)的订单
- 说明服务预约后权益码永久有效,不会过期
- 更新流程步骤描述,突出券码状态和订单状态的判定
- 增加特别说明,强调过期处理针对未预约状态且由上游系统定义的券码过期状态进行
2026-03-13 17:11:22 +08:00
zhouyonggao 75acb12f95 docs(api): 更新接口响应和订单状态规则文档
- 规范请求追踪ID生成规则,支持雪花算法或UUID确保唯一性
- 新增时间格式规范,内部使用yyyyMMddHHmmss,交互时需转换格式
- 明确邮储服务开放平台接口校验权益码过期的描述和返回提示区分
- 修改订单初始状态为"服务未预约"(100),预约成功后更新为"服务已预约"(200)
- 细化订单状态流转规则,新增从未预约到已预约状态的变更路径
- 注明服务预约接口幂等策略中code字段与邮储接口rightsCode的映射关系
2026-03-13 17:10:16 +08:00
zhouyonggao e8f2c616d4 docs(api): 更新接口响应和订单状态规则文档
- 规范请求追踪ID生成规则,支持雪花算法或UUID确保唯一性
- 新增时间格式规范,内部使用yyyyMMddHHmmss,交互时需转换格式
- 明确邮储服务开放平台接口校验权益码过期的描述和返回提示区分
- 修改订单初始状态为"服务未预约"(100),预约成功后更新为"服务已预约"(200)
- 细化订单状态流转规则,新增
2026-03-13 17:09:24 +08:00
zhouyonggao ec186dc3b5 docs(api): 更新接口文档,新增过期积分查询接口并规范参数名称
- 新增“过期积分查询接口”文档说明及调用说明
- 优化订单状态流转状态展示,更清晰展示状态顺序
- 修改接口文档中字段名class为type,统一参数命名
- 规范接口入参验证,补充必填参数缺失和服务编码不存在的错误处理
- 新增接口验收标准及测试用例,覆盖参数校验、AES解密和业务异常场景
- 补充过期积分查询接口业务流程和返回字段说明
- 完善券码链接查询接口业务规则和验收标准及对应测试用例
2026-03-13 16:25:05 +08:00
zhouyonggao 9223a61b92 docs(api): 补充完善虚拟商品充值服务接口文档及任务说明
- 新增接口与任务索引表,明确对外接口、下游接口、上游接口及定时任务
- 增加服务详情查询接口,详细说明功能、业务规则及输入输出字段
- 统一部分接口参数名称由type改为class,明确服务编码含义
- 修改任务类型命名,将取消补偿统一改为作废补偿,确保术语一致性
- 更新数据库表字段及流程图,反映任务类型名称调整
- 丰富订单状态流转说明及异步通知任务处理逻辑
2026-03-13 16:08:12 +08:00
zhouyonggao ae8ced3d6f feat(order): 增加服务已过期状态支持及相关流程优化
- 添加订单状态「服务已过期(500)」的处理逻辑和返回信息
- 更新幂等验证逻辑,支持已过期状态返回对应提示
- 扩展订单状态流转,允许200状态变更到500状态
- 新增通知任务表,支持服务完成、过期处理和取消补偿三种任务类型
- 实现券码状态同步流程及通知任务执行流程,包含任务重试和失败告警机制
- 订单取消流程支持已过期状态,返回明确错误提示
- 调整接口请求超时设置为5秒,增强调用稳定性
- 修改对账及监控指标,支持任务执行状态和失败告警
- 增加流程图说明,清晰展示状态同步及通知任务执行步骤
2026-03-13 15:37:10 +08:00
zhouyonggao 0fcbaf8079 feat(order): 优化预约与取消流程,增强幂等与锁机制
- 对预约流程新增数据库校验服务编码,提取对应AES密钥解密请求参数
- 新增基于权益码的分布式锁,防止并发重复提交,锁未获取时返回错误
- 调整幂等校验逻辑,准确区分已预约、已取消、已完成等状态返回对应响应
- 调整权益码过期及渠道相关的错误返回信息,提升用户提示准确性
- 增加预约流程中锁的defer释放,确保流程结束自动释放锁资源
- 预约流程新增调用蓝色兄弟券码接口,支持幂等和超时处理
- 取消流程新增分布式锁控制,对订单状态进行更细化判定及返回
- 取消作废逻辑完善,失败时查询券码状态确认后续处理
- 完善预约和取消流程步骤及验收标准,新增并发和锁竞争等测试用例
- 更新相关API文档及流程图,补充异常场景处理说明
- 在docs中新增AES加解密算法支持AES,完善对账及安全模块说明
2026-03-13 15:07:34 +08:00
zhouyonggao 1d123399f6 feat(service): 优化服务预约与取消流程及完善验收标准和测试用例
- 完善服务预约流程,增加幂等验证,区分不同订单状态的处理逻辑
- 新增多渠道权益码过期提示,区分CRM和手机银行渠道返回不同错误信息
- 细化邮储预约成功与失败时订单状态及返回结果的处理
- 补充蓝色兄弟券码获取成功和异常
2026-03-13 14:11:52 +08:00
zhouyonggao 5cdec2d684 docs(prd): 更新服务预约流程及一致性保障机制说明
- 增加服务编码不存在时的处理提示“暂不支持此服务”
- 增加权益码过期时CRM及手机银行渠道的响应提示
- 调整一致性保障机制为异步消息+最终一致
- 优化核销回调处理流程,快速响应避免超时
- 说明不使用本地事务,采用重试、补偿及对账保证最终一致性
2026-03-13 11:30:28 +08:00
zhouyonggao b1fac44487 docs(api): 完善邮储银行服务平台接口文档与设计方案
- 统一接口公共响应规范,定义code/msg/traceId/data字段及响应码说明
- 详细补充服务预约接口请求解密、业务流程及幂等设计
- 更新服务取消、完成通知、订单查询等接口数据结构与响应字段
- 修订加密解密方案,新增预约请求AES解密规则
- 规范数据库表结构,调整订单表、券码表及新增服务编码映射表
- 明确高性能响应时间、并发指标及缓存设计策略
- 增加数据一致性保障方案,包括本地事务和异步消息机制
- 描述幂等设计、数据一致性监控与告警指标
- 补充系统可用性、安全要求及异常处理流程
- 规划流程图和用户故事章节,完善整体设计文档结构
2026-03-13 11:10:01 +08:00
zhouyonggao 05268a1895 chore(trans_hub): 更新子模块提交引用
- 将子模块 trans_hub 的提交从 c5392b5d5e90ba839a15642b122c13eb78714b66 更新至 bd4866457df441eae073ed52b4537c31827daa63
2026-03-12 14:34:50 +08:00