Commit Graph

47 Commits

Author SHA1 Message Date
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
zhouyonggao dc2fc4068e docs(documentation): 更新模块关系表格说明
- 修改模块关系表中调用方和被调用方的描述,更清晰表达模块间调用关系
- 调整内部依赖列内容以匹配调用关系的实际情况
- 保留原有模块职责说明,增强表格易读性
- 修正部分模块调用表述,确保信息准确一致
2026-03-12 14:07:16 +08:00
zhouyonggao 97ea027390 chore(git): 添加忽略文件夹规则
- 新增 .qoder 文件夹到 .gitignore
- 新增 .vscode 文件夹到 .gitignore
2026-03-12 12:13:17 +08:00
zhouyonggao 0adeea7a06 chore(qoder): 删除过时的指令和规则文档
- 移除 .qoder 目录下所有指令同步相关的 Markdown 文件
- 删除代码审查、创建PR、记忆同步、项目测试、安全检查等指令文档
- 清理后端API服务编码规范及代码修改规范相关规则文件
- 删除项目规则索引及需求文档编写规范的规则文件
- 移除 VSCode 的 PlantUML 配置文件 settings.json
- 减少项目冗余文档,优化存储空间与项目结构
2026-03-12 12:13:02 +08:00
zhouyonggao 687f2ab37f docs(api): 补充后端API服务编码规范描述
- 添加后端API服务编码规范、技术栈及开发流程的说明
- 明确生成或修改后端API代码时需参考该规范
2026-03-12 12:10:51 +08:00
zhouyonggao 840d01eab3 docs(spec): 删除虚拟商品充值服务商系统产品需求文档
- 完全移除包含详细功能模块划分、接口说明、数据实体及流程图的产品需求文档
- 删除模块关系表、业务规则、输入输出字段及验收标准
- 清理用户故事、错误码说明、附录中专业术语和业务响应码
- 移除服务类型、厂商编码及渠道标识等所有相关描述
- 规范文档结构整体清理,去除所有内容,保持文档根目录无虚拟商品相关文件
2026-03-12 12:09:49 +08:00
zhouyonggao 5a4cb0d863 docs(spec): 删除虚拟商品充值服务商系统产品需求文档
- 完全移除包含详细功能模块划分、接口说明、数据实体及流程图的产品需求文档
- 删除模块关系表、业务规则、输入输出字段及验收标准
- 清理用户故事、错误码说明、附录中专业术语和业务响应码
- 移除服务类型、厂商编码及渠道标识等所有相关描述
- 规范文档结构整体清理,去除所有内容,保持文档根目录无虚拟商品相关文件
2026-03-12 12:02:12 +08:00
zhouyonggao cd23c4293a chore(trans_hub): 更新子项目提交引用
- 将子项目提交从 fb920e53dc82b4dbd18217e9b19582c725cd6566 更新为 c5392b5d5e90ba839a15642b122c13eb78714b66
2026-03-12 11:46:45 +08:00
zhouyonggao f3d3b1ea80 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 ecb9e7c 更新到 fb920e5
- 保持子项目依赖的最新状态
- 确保与主项目代码兼容性
2026-03-12 11:44:20 +08:00
zhouyonggao bfac63692e chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交哈希从 0bebf2c2a9 更新到 ecb9e7cde68
2026-03-12 11:29:14 +08:00
zhouyonggao 45f95e7289 chore(trans_hub): 更新子项目提交引用
- 将 trans_hub 子项目的提交从 58ca26af67 更新到 0bebf2c2a9
2026-03-12 11:21:33 +08:00
zhouyonggao 8aafbec366 docs(requirements): 更新需求文档结构和用户故事格式规范
- 将文档章节从4个调整为6个,新增“用户故事”和“附录”章节
- 用户故事章节采用标准格式,明确用户角色、功能需求和业务价值
- 附录章节新增业务术语表,包含术语、定义和示例
- 调整原有章节顺序,确保文档结构清晰规范
2026-03-12 11:09:26 +08:00
zhouyonggao f3a6d22da8 chore(memory): 删除项目记忆同步文件
- 移除 .qoder/memory-sync.md 文件
- 删除持久化存储项目记忆的实现
- 取消账号切换时记忆保持的相关机制
- 清理与记忆同步相关的文档内容
2026-03-11 12:04:14 +08:00
zhouyonggao 21d12e1c95 docs(commands): 新增Qoder指令及同步规则文档
- 新增`.qoder/commands-sync.md`,持久化存储项目指令,解决账号切换导致指令丢失
- 添加多条指令文档,涵盖代码审查、PR创建、项目测试、安全检查、记忆同步、后台启动等
- 编写指令的详细说明及操作指南,便于用户触发对应流程
- 新增`.qoder/memory-sync.md`文件,持久化存储项目记忆并定义同步规则
- 增加规则文件`.qoder/rules/`,包含代码修改规范、通用规则、需求文档规范等,规范项目管理与开发流程
- 完善项目规则索引,明确各规则文件的触发条件及适用场景
2026-03-11 12:01:11 +08:00
zhouyonggao 1912be6962 docs(api): 新增高端客户权益积分服务详细设计文档
- 添加邮储银行幸福点权益服务完整业务流程时序图
- 补充服务兑换、预约、取消、退还、完成、过期处理、对账七大流程说明
- 更新服务开放平台个人综合积分接口设计规范V1.18
- 增加接口请求响应报文结构及加解密签名规则说明
- 详细列出交易接口地址规范及示例
- 增加业务返回码及异常状态码说明
- 明确各流程状态码及状态变更规则
- 新增高端客户权益订单退还时已过期积分查询接口说明
2026-03-11 11:47:44 +08:00
zhouyonggao fa910cfe0d Initial commit 2026-03-09 10:32:00 +08:00