 zhouyonggao
|
f1c6c8b335
|
fix(docs): 修正openapi.yaml中券码链接字段名
- 将响应
|
2026-03-17 15:41:34 +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
|
dc2fc4068e
|
docs(documentation): 更新模块关系表格说明
- 修改模块关系表中调用方和被调用方的描述，更清晰表达模块间调用关系
- 调整内部依赖列内容以匹配调用关系的实际情况
- 保留原有模块职责说明，增强表格易读性
- 修正部分模块调用表述，确保信息准确一致
|
2026-03-12 14:07:16 +08:00 |
|
zhouyonggao
|
5a4cb0d863
|
docs(spec): 删除虚拟商品充值服务商系统产品需求文档
- 完全移除包含详细功能模块划分、接口说明、数据实体及流程图的产品需求文档
- 删除模块关系表、业务规则、输入输出字段及验收标准
- 清理用户故事、错误码说明、附录中专业术语和业务响应码
- 移除服务类型、厂商编码及渠道标识等所有相关描述
- 规范文档结构整体清理，去除所有内容，保持文档根目录无虚拟商品相关文件
|
2026-03-12 12:02:12 +08:00 |
|
zhouyonggao
|
8aafbec366
|
docs(requirements): 更新需求文档结构和用户故事格式规范
- 将文档章节从4个调整为6个，新增“用户故事”和“附录”章节
- 用户故事章节采用标准格式，明确用户角色、功能需求和业务价值
- 附录章节新增业务术语表，包含术语、定义和示例
- 调整原有章节顺序，确保文档结构清晰规范
|
2026-03-12 11:09:26 +08:00 |
|
zhouyonggao
|
1912be6962
|
docs(api): 新增高端客户权益积分服务详细设计文档
- 添加邮储银行幸福点权益服务完整业务流程时序图
- 补充服务兑换、预约、取消、退还、完成、过期处理、对账七大流程说明
- 更新服务开放平台个人综合积分接口设计规范V1.18
- 增加接口请求响应报文结构及加解密签名规则说明
- 详细列出交易接口地址规范及示例
- 增加业务返回码及异常状态码说明
- 明确各流程状态码及状态变更规则
- 新增高端客户权益订单退还时已过期积分查询接口说明
|
2026-03-11 11:47:44 +08:00 |