dachui/affiliate_dash
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
151 Commits 2 Branches 0 Tags
0967ecc5db3b063c67092368316adf1db96aeaf4
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
yml2213andCursor 0967ecc5db feat(rock): 库存列表直接显示 0666 编号和完整提取码 
本地序号和上游编号不是同一个，按 0666 上的编号就能对上库存和兑换记录。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-06 11:49:47 +08:00
yml2213 3741f5ae73 feat(rock): 实现方案B智能自愈，支持买家手滑填错UID时确认为扫码角色UID自愈绑定 2026-10-06 11:04:44 +08:00
yml2213andCursor 717392b195 feat(rock): 未扫码绑定的使用中链接可释放回库存 
历史残留绑定不再占住提货链接，退款后可以把还没扫上的库存分给下一单。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-05 22:13:17 +08:00
yml2213andCursor 4c68103217 feat(routing): 渠道配置页把 Rock 作为独立履约策略展示 
最新的 Rock 商品之前被算进第一平台，配置里也无法单独选择 Rock 库存池。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-05 21:15:20 +08:00
yml2213andCursor 8c43fb4569 fix(delivery): 将第一平台发货出站超时调到 30 秒 
常态提交约 11 秒，15 秒上限会在上游偶发变慢时提前断开，可能把仍在处理的订单记成失败。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-10-05 19:57:07 +08:00
yml2213 4f23ae389d fix(rock): 补充买家更新UID时Token期望UID同步更新，保障自建发货页重入一致性 2026-10-05 19:31:43 +08:00
yml2213 9e260059ee feat(rock): 关联业务工单升级为双单号清晰展示（系统工单号 + 创建商户单号） 
1. 后端批量反查商户单号：在 RockService.ListTokens 中支持批量反查关联订单创建时由调用方传入的 ClientOrderNo（商户单号），并拓展支持通过商户单号进行全局关键词模糊搜索；
2. 管理后台双单号排版升级：在 Rock 管理表格中将「关联业务工单」升级为双行呈现——第一行高亮展示内部统一系统工单号 (FO2026...)，第二行辅助展示外部电商/商户原始单号 (如 test4 / 拼多多单号)，两行均支持一键独立复制；
3. 单元测试全覆盖：补充商户单号自动挂载关联与按商户单号模糊检索的自动化单测，确保对单溯源精准无误。
 2026-10-05 19:18:52 +08:00
yml2213 262376e603 fix(ui): 修复侧边栏选中高亮状态并为凭据列添加商品精致缩略图 
1. 修复侧边栏导航选中高亮丢失：在 MainLayout 的 getSelectedKey 路由映射中补齐 /platform-rock 与 /platform-products，确保进入页面时左侧「商品管理」父菜单自动展开，「Rock发货与库存风控」高亮激活，并增加品牌蓝内嵌发光细条指示；
2. 凭证列新增商品微光缩略图：在 Rock 管理表格的「发货结果图片」列左侧加入 44x44 的圆角立绘小缩略图，支持悬浮微光放大动效与点击一键弹出深海蓝发货凭据大图预览。
 2026-10-05 19:13:59 +08:00
yml2213 604c9d1912 fix(delivery): 提货页买家字段优先展示识别到的真实游戏角色昵称 
1. 优化买家身份呈现：当外部订单未传递 buyer_name 时，不再展示单薄的横杠 "-"，而是优先展示扫码识别到的游戏角色名（如「罡舍」）；
2. 完善多级兜底回退：依次按 游戏角色名 -> 外部买家昵称 -> 游戏UID 优先级回退，确保买家打开提货页具备强烈的游戏角色归属感。
 2026-10-05 19:08:03 +08:00
yml2213 5c3fd92738 fix(delivery): 提货详情页自动回填 Rock 绑定的游戏角色名与区服 
1. 解决提货页历史已交付订单缺失角色名的问题：在 buildDeliveryState 中新增自动回溯机制，若订单 ResultData 缺失角色名或区服，自动从关联的 rock_tokens 表提取 actual_role_name 与 actual_channel；
2. 自动修正并持久化：回填成功后自动修补至 fulfillment_orders.result_data，确保后续无需重复反查，提货页与凭据大图立即可见真实游戏昵称。
 2026-10-05 19:03:50 +08:00
yml2213 372a13e86d fix(delivery): 隐藏上游单号并对齐无角色发货结果展示 
1. 隐藏内部与上游单号：彻底移除提货页面顶部展示的内部工单号 (FO2026...)，以及凭据图片中生成的官方单号行与表格凭证单号，防止暴露上游平台来源；
2. 对齐无角色发货结果展示：当订单无游戏角色名（为空或为 "-"）时，提货页面结果卡片与 Canvas 生成的深海蓝凭据大图统一不渲染游戏角色项，消除多余占位横杠；
3. 两端信息项保持完全一致：提货结果卡片与发货凭据图片统一按照「游戏区服 -> 兑换账号/UID -> 时间」一致排版，干净清爽。
 2026-10-05 18:59:36 +08:00
yml2213 bf3f3a3626 feat(delivery-voucher): 优化发货凭据为一键复制深海蓝高清图并补齐商品本地图片 
1. 管理后台 Rock 表格优化：将原「官方发货凭证(FulfillId)」列升级为「发货结果图片」列，提供一键「复制结果图」与「高清预览」Modal，点击即可自动生成凭据大图并直接写入剪贴板（支持在微信/QQ客服聊天框中直接 Ctrl+V 粘贴图片）；
2. 商品图片本地缓存与展示修复：从官方 HAR 提取黑色 ROCK 长袖 T 恤与蓝色运动服上衣高清立绘（rock_black_tshirt.webp / rock_blue_sportswear.webp），优化 productImage 自动识别与 Delivery 提货页图片自适应居中，彻底消除灰色占位块；
3. 标杆级发货凭据绘制重构：参考腾讯官方电竞风格设计，重构 640x960 视网膜双倍高清 Canvas 凭据绘制（深海蓝微光渐变背景、顶部微光加粗「兑换成功」、正圆形双层光环立绘、详细角色区服参数对齐、底部翡翠绿发光胶囊按钮），全方位超越 0666 官方粗糙原图；
4. 履约结果字段持久化：后端发货成功后同步持久化角色名、游戏大区与 UID 至 fulfillment_orders 结果报文，确保提货页区服与角色信息完整呈现。
 2026-10-05 18:52:41 +08:00
yml2213 78e2fe4c6a fix(delivery): 禁用Rock二次生成二维码并治理上游110001频控报错 
1. 业务防乱(专属通道锁定)：提货页面一旦生成二维码后，直接禁用'重新生成二维码'按钮并锁定游戏UID输入框，杜绝Token浪费与绑定混乱；
2. 频控治理(前端3秒冷却)：手动点击'检查扫码状态'增加3秒倒计时防抖冷却，且对'过于频繁/110001'错误进行平滑提示，不再触发大红报错；
3. 频控治理(后端瞬时防抖与软降级)：RockService增加800ms内存并发安全防抖缓存，当上游返回110001时自动优雅降级返回等待扫码状态，不抛出HTTP 400错误。
 2026-10-05 18:25:35 +08:00
yml2213 08a0e74cd0 fix(rock): 修复空闲库存为0时误将已分配订单判定为补货中并拦截发货的严重漏洞 
1. 根因修复(状态机死锁)：当一笔订单分配了池中最后一个可用Token后，空闲库存降为0。原PrepareDelivery仅检查AvailableStock<=0，导致已锁定Token的订单在发货校验时被误判为'库存补充中'并硬性拦截发货；
2. 逻辑重构：PrepareDelivery增加已预占Token识别，若当前订单已持有using或bound状态的专属Token，直接豁免空闲库存校验，放行扫码与发货；
3. 协议对齐：在ClaimTokens与RefreshToken中补全Origin与Referer请求头；
4. 单元测试与方案文档：新增TestRockProvider_PrepareDelivery_ZeroStockWithAssignedToken用例，5项Rock专项单测与全量Service测试100%全绿通过，方案文档追加7.5节证据与复盘记录。
 2026-10-05 18:19:40 +08:00
yml2213 1df60e5fd5 fix(rock-ui): 修复Rock平台凭据配置项被浏览器误识别触发密码自动填充的问题 
1. 根因防御(账密陷阱 Honeypot)：在配置表单头部注入隐藏的 dummy username/password 输入框，阻断 Chrome/Edge 密码管理器将 BaseURL 和 BearerToken 误判为网站登录凭据；
2. 属性隔离：为 Base URL 和 Bearer Token 分别显式指定独有 name、id 以及 autoComplete 属性（off / new-password）；
3. 样式重置：在全局 CSS 中添加 autofill 伪类样式重置，清除浏览器默认侵入的淡蓝/黄色背景色。
 2026-10-05 16:41:16 +08:00
yml2213 83870843ed fix(rock): 修复兑换发货401未鉴权错误与买家角色名提取解析 
1. 根因修复(兑换发货鉴权)：对比原生平台发货抓包证实 POST /api/redeem/:id 必须携带 Authorization: Bearer <token>，Origin 及 Referer 头，补齐相关请求头彻底杜绝 401 报错；
2. 根因修复(角色昵称解析)：逆向解构 0666.pro 响应报文，将角色名提取从错误的 binding.role_name 切换为 token.bound_account，消除提货页角色名显示为 '-' 的问题；
3. 协议对齐(响应结构重构)：将 RockRedeemResponse 与真实上游返回对齐（包含 token 与 status 结构），剔除臆想的 delivery 字段；
4. 单元测试与方案文档：更新单测覆盖鉴权与字段映射断言，在方案文档 7.4 节录入实测抓包报文镜像比对表。
 2026-10-05 16:30:18 +08:00
yml2213 befe50b3e5 feat(rock): 支持手动采购指定数量通用 Token 弹窗与实时积分试算 
1. 新增手动采购 Modal 弹窗，支持自由输入指定数量（InputNumber）与快捷胶囊选择（10/20/50/100/全部可购）；
2. 动态联动 0666.pro 实时积分余额，提供单价折算（21点/个）、预计消耗与结余防超支校验；
3. PageHeader 采购按钮与指标看板无缝唤起采购弹窗，采购完成后自动关闭并刷新数据。
 2026-10-05 15:54:27 +08:00
yml2213 7e5cbaf65e fix(rock): 兼容 0666.pro 接口 points 字段字符串与数值自适应解析 
1. 新增 FlexibleFloat64 类型，解决上游 /api/me 响应中 points 为字符串（如 '8271.2'）导致反序列化失败的问题；
2. 服务层与数据库快照存储统一调用 Float64() 保持类型严谨；
3. 单元测试补充真实上游字符串响应场景并全绿通过。
 2026-10-05 15:42:00 +08:00
yml2213 80554555d3 style(platform-rock): 深度重构 Rock 管理大屏 UI，全面对齐平台设计规范 
1. 页面容器对标 PlatformProducts 规范，移除内层冗余白底外壳，优化整体边距与排版；
2. 废弃原生低质感 Statistic 标签，全面改用 metric-card 高质感统计看板（可用库存、错单阻断、交付总量、上游积分）；
3. 重构通道控制与 0666.pro 凭据面板，增加通道呼吸状态条与软熔断一键切换 Banner，表单分栏结构化展示；
4. 筛选工具栏与库存审计表格全面升级，增加 UID 强一致校验高亮对比与错单解冻重置操作。
 2026-10-05 15:36:45 +08:00
yml2213 611c658a8a fix(merchant-products): 严格锁定商品价格与库存编辑权限，仅对平台超级管理员开放 
1. 前端 ProductsTab 增加 canEditPricing={isAdmin} 显式权限透传，仅超级管理员可见【编辑】按钮，普通分销商/商户完全隐藏；
2. 后端 UpdateProduct 接口补充 middleware.GetRole(c) != model.RoleAdmin 强校验，普通分销商发起请求直接 403 阻断；
3. 保障平台商品进货成本与对外积分售价的权威性，杜绝下游分销商私自篡改价格与库存风险。
 2026-10-05 15:14:33 +08:00
yml2213 0dff9d892e feat(merchant-products): 开放商品编辑功能，支持超级管理员与商户修改售价积分、成本价与库存模式 
1. 后端 Handler 新增 UpdateProduct 方法，并在 /api/merchant/products/:id 注册 PATCH 路由，支持修改商品显示名称、对外售价积分、成本价与库存；
2. 前端商户中心 merchantApi 扩充 updateProduct 接口对接；
3. 商品列表（ProductsTab）操作列新增【编辑】按钮与模态框，提供商品名称、对外售价（积分）、成本价（积分）、无限库存/指定限量模式及上架状态编辑功能；
4. 修复超级管理员在自营或商户商品列表中无法自由调价与调整库存的交互缺失问题。
 2026-10-05 15:10:21 +08:00
yml2213 ef7f67dd0c feat(fulfillment): 接入Rock发货平台(0666.pro)代理履约、通用库存池与UID强一致风控 
1. 数据库新增 012_rock_fulfillment 迁移，创建 rock_configs 配置表与 rock_tokens 通用库存表，补齐黑色ROCK长袖T恤与蓝色运动服上衣商品目录；
2. 封装 RockClient 与 RockService，实现 0666.pro 平台 Bearer Token 极简连通校验、批量采购50个入库、水位监控巡检与自动补货；
3. 新增 RockProvider 实现标准履约路由，引入 Anti-Ghost 旧绑定基线比对与 UID 强一致门禁，扫错号硬阻断并记录为 mismatch 状态；
4. 针对黑色ROCK与蓝色运动服实现动态发货（绑定后发货前动态选择 skin），并提取腾讯官方发货流水号 fulfillId 对账；
5. 新增全局自动发货总开关（Kill Switch），支持一键软熔断降级转人工接单处理；
6. 前端新增 PlatformRock 管理大屏，提供总开关切换、Token配置与连通测试、库存监控、一键补货及错单解冻重置。
 2026-10-05 14:56:11 +08:00
yml2213 46ec3574ae fix(delivery): 治理上游 BFF 单 IP 频控限流与高频轮询雪崩问题 
1. 透传分布式客户端 IP（X-Forwarded-For）：signProxy 发包自动透传客户端 IP 与订单散列 IP，穿透上游 Nginx 限流层，避免生产服务器单出口 IP（124.223.12.34）被全盘限流（HTTP 429）；
2. 频控限流立即避让禁止盲目重试：429 与“请求过于频繁”明确判定为不可重试错误，signProxy 立即返回，消除 8.2 秒长挂与 3 倍放大重试流量；
3. 优化轮询频次与频控冷却：accountBound 未扫码缓存 TTL 提升至 5 秒（削减 60% 轮询 QPS），遭遇频控时拉长缓存避让至 15 秒并由前端平滑等待，给上游充分恢复窗口。
 2026-09-18 19:52:53 +08:00
yml2213 af0822949d fix(delivery): 修复 DLC 正式下单重复提交与发货并发冲突问题 
1. DLC 正式下单接口禁用传输层自动重试：/public/users/orders 属于非幂等状态变更接口，发生频控或抖动时由上层回调与状态同步接管，严禁盲目原单号重试导致上游抛出“该子订单已处理，请勿重复提交”；
2. 扩充队列防重与已有记录识别：识别上游“该订单已有发货记录/已处理”错误，重新建队时自动追加独立重试单号（_xxxx）并透传至正式下单，避免单号污染冲突；
3. 上游回调支持重试单号兼容：HandleShipNotify 在精准匹配未命中时，自动按下划线前缀匹配主订单号（FO..._xxxx -> FO...），保障重试单回调正常交付；
4. 加强提交并发锁防护：在 35 秒活跃执行窗口内对 in_progress 阶段实行严格并发互斥，避免上游 Webhook 提前推回失败状态导致后续重试穿透产生并发打架；提单失败时显式重置 provider_order_stage 释放锁。
 2026-09-18 16:19:37 +08:00
yml2213 40194fa7e5 fix(delivery): 增加绑定缓存防频控、发货队列防重试死锁、终止无效回调重试 2026-09-18 15:26:09 +08:00
yml2213 ec76844da8 feat(log): 全面重构日志系统，支持日志级别、去除ANSI乱码并抑制高频轮询 2026-09-18 15:04:38 +08:00
yml2213 20bde97d7a fix(delivery): add transient retry, fix queue deadlock, and gate delivery submit by scan auth 2026-09-18 14:49:54 +08:00
yml2213andCursor 848d3da809 fix(delivery): 绑定失败回退 DLC，并补齐乐玩角色名展示 
乐玩写接口失败时清除渠道锁定改试 DLC；免扫码/查绑/提交路径回传 role_name 与 game_channel。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 12:39:53 +08:00
yml2213andCursor 6c41834274 fix(delivery): 乐玩不可用时回退 DLC，避免提交 UID 绑定失败 
legacy 双渠道配置升为 priority；显式 lewan 且具备 DLC 时允许回退，缓解 LEWAN_* 未注入导致的 bind 失败。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:51:32 +08:00
yml2213andCursor 7df1330b65 fix(docker): 向 backend 容器注入乐玩 LEWAN_* 环境变量 
Docker 启动时未透传 .env 中的乐玩密钥，导致容器内始终提示 AccessKey/SecretKey 未配置。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-15 11:04:18 +08:00
yml2213andCursor 6dc2375a79 chore(catalog): 清理 LEWAN_ 列表过滤与商品图 UUID 历史回退 
商品列表不再过滤镜像 SKU；图片只按英文 SKU 解析，修正 DLC 预设文案。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 20:33:42 +08:00
yml2213andCursor c2d8228512 fix(delivery): 硬化自动发货可靠性，避免双发与无限 Webhook 重试 
恢复 ship_failed 可重试 UI；DLC 断点续传 queue；乐玩未绑定禁止进 delivering；Webhook 原子 nonce 与业务拒绝回 200。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 20:13:29 +08:00
yml2213andCursor df1a170d44 refactor(catalog): 废弃 LEWAN_ 镜像，统一英文 SKU 与积分价，商品图按 SKU 缓存 
对外目录只保留英文主 sku；迁移硬删镜像并校准 1元=100积分；发货页/凭证优先使用 local {sku}.webp。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-14 20:00:26 +08:00
yml2213 bf9614569e feat: 优化发货凭证与字段兼容，隐藏内部积分展示并增强DLC角色解析 2026-09-14 17:37:53 +08:00
yml2213 5f642eb7a6 feat: 优化发货交付页面与凭据生成，支持一键复制结果图片及官方商品图片本地缓存 
- 交付界面重构：隐藏内部订单号、流水号与发货渠道，展示聚焦于买家游戏UID、角色名与交付时间
- 发货结果凭据生成：采用 Canvas 生成高清发货存证图，优化存证说明文案与自适应排版
- 一键复制图片：支持直接将结果凭证图片写入系统剪贴板，方便客服在聊天窗口快捷粘贴
- 官方图片本地化缓存：全量下载乐玩商品官方主图并建立本地持久化路由，规避外部源站跨域及破损问题
- 修复乐玩渠道角色UID提取与履约状态幂等回填逻辑
 2026-09-14 17:19:12 +08:00
yml2213andCursor f7f48d0feb 功能：接入乐玩开放平台双渠道路由，并修复渠道锁定与 Webhook 可靠性 
在保持 DLC 默认零破坏的前提下，支持 priority/仅乐玩/仅 DLC 履约策略与后台 GUI 配置；同步补齐 Prepare 渠道落库、乐玩订单取消、Webhook 验签与失败重试。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-11 15:48:03 +08:00
yml2213 a314f3f51b 修复：发货创建队列与补全接口透传 h5_prefix 和商品信息，解决上游报错缺少渠道标识 
- 上游 /public/users/orders-queue (POST/PATCH) 补充传递 h5_prefix、goods_no 和 goods_name
- delivery.go submit 流程透传商品 SKU 与商品名称至队列相关方法
- 解决上游创建订单报"缺少渠道标识 h5_prefix，无法校验第三方订单状态"的故障
 2026-09-08 12:44:45 +08:00
yml2213 114dcdf7d8 优化：订单列表发货链接列固定在最右侧，滚动时保持可见 2026-08-14 14:28:20 +08:00
yml2213 b76d8dc257 功能：发货链接支持永久有效，默认 TTL=0 
- DELIVERY_LINK_TTL_MINUTES 设为 0 或负数时链接永久有效（expires_at 存 NULL），
  默认值由 120 改为 0，本地 .env 同步改为永久
- 新增 delivery_link_generated_at 列区分从未生成与永久链接，兼容历史数据
- 永久链接授权仅校验 HMAC 签名、不校验过期（exp=0），作废/恢复语义不变
- 前端链接有效期列对永久链接显示"永久有效"
 2026-08-14 14:26:06 +08:00
yml2213 11bce9c87e 优化：已交付订单保留复制/打开发货链接，去掉作废操作 
- 已交付订单仍可复用未过期链接查看兑换结果，但不再生成/续期新链接
- 商户后台已交付订单仅显示复制/打开，已作废/已过期单独标识
- 发货中/已取消订单不展示链接操作，避免无效按钮
 2026-08-14 13:19:27 +08:00
yml2213 99a33675b0 优化商户管理, 增加商户名重置密码等等 2026-08-14 13:09:56 +08:00
yml2213 ee3e427ab7 作废链接和取消订单 2026-08-14 12:58:20 +08:00
yml2213 33a30fcd99 修复：软删除账号可复用用户名 2026-08-13 14:40:22 +08:00
yml2213 91c055c130 功能：平台管理员删除商户账号 2026-08-13 14:35:30 +08:00
yml2213 a637101ca8 重构：移除环境变量管理员初始化 2026-08-13 14:21:22 +08:00
yml2213 538be52636 修复：管理员默认商户与账户设置 2026-08-13 14:12:25 +08:00
yml2213 6dae7fafa8 功能：恢复商户账号分组查看 2026-08-13 13:39:37 +08:00
yml2213 cfdc12cf94 优化：平台管理员账号独立管理 2026-08-13 13:31:06 +08:00
yml2213 c928c5b8e8 优化：按商户分组展示员工账号 2026-08-13 13:23:12 +08:00
yml2213 1f85add5e0 功能：优化账号分层与管理员初始化 2026-08-13 13:18:41 +08:00
yml2213 ac44fda08b 功能：增加订单搜索与状态筛选 2026-08-13 12:58:06 +08:00
yml2213 2b3a1b111b 功能：增加平台账号管理与管理员保护 2026-08-13 12:52:50 +08:00
yml2213 8c47b961e1 功能：完善登录安全与客服手动下单 2026-08-13 12:40:04 +08:00
yml2213 aea65a2fd3 feat: manage merchant members 2026-08-13 11:45:55 +08:00
yml2213 a4791decb0 feat: support merchant team roles and permissions 2026-08-13 11:41:34 +08:00
yml2213 6c98fa557e 增加文档 2026-08-11 16:23:55 +08:00
yml2213 b686a82e60 feat: add manual fulfillment order creation 2026-08-11 11:49:58 +08:00
yml2213 2264851d5d 拆分 service 与前端大文件,修复 CORS 配置与格式问题 
- 后端 internal/service 按职责拆分:
  fulfillment.go(1397→527)拆出 wallet/timeout/data/order/query/dashboard/shipnotify
  delivery.go(1124→801)拆出 upstream/link/state/helpers
  merchant.go(855→251)拆出 member/product/api_client/catalog/helpers
- 前端 MerchantCenter.tsx(1327→606)拆出 merchantCenterTabs/merchantCenterUtils
- docker-compose backend 透传 CORS_ALLOWED_ORIGINS
- CORS 白名单实现(config/router/README/.env.example 配套)
- 修复 gofmt 与文件尾部多余空行
 2026-08-05 13:32:11 +08:00
yml2213 569109cd92 修改常见默认端口 2026-08-04 15:34:34 +08:00
yml2213 68cf35b272 优化积分充值、余额告警、开放文档与面包屑层级路径 2026-08-04 14:39:45 +08:00
yml2213 16b508eb9b 商户管理优化, 商户只能上架下架, 管理员可以编辑 2026-08-04 14:35:53 +08:00
yml2213 6404b10626 优化api文档ui 2026-08-04 14:12:43 +08:00
yml2213 ca58c2bcaa 余额告警独立页面与多渠道通知：钉钉/飞书/企业微信/Bark，支持通知频率策略 
- 告警设置拆分为独立页面，支持钉钉/飞书/企业微信/Bark/通用Webhook 多渠道
- 通知策略：低于阈值后按间隔重复提醒，达到最大次数停止，余额恢复自动重置
- 旧 webhook 配置自动迁移为通用渠道，渠道支持测试发送
- 优化告警话术：去商户ID展示、数字千分位格式化
 2026-08-04 13:56:26 +08:00
yml2213 941e7ad79a 积分充值全流程落地：申请审核入账、凭证上传压缩转webp、管理员调账收权 
- 新增积分充值申请与审核：商户提交充值申请（凭证图片必填，1元=100积分），
  管理员审核通过后事务内自动入账，幂等键防重复
- 新增通用图片上传组件 ImageUploader：canvas 压缩转 webp、预览、删除，
  后端按魔数校验图片格式并持久化到 data/uploads
- 管理员钱包调整改为按商户维度：移除商户侧调账接口，新增管理员
  平台商户积分调整与钱包流水查看
- 低余额 Webhook 告警配置持久化，充值入账/调账后自动检查推送
- 平台商户操作列移除进入/成员，积分充值页接入真实接口并修复金额单位换算
 2026-08-04 13:03:29 +08:00
yml2213 54f05c15a4 实现侧边栏分组展开折叠状态持久化记忆 2026-08-04 11:27:40 +08:00
yml2213 aa2eac8d51 重构主导航栏父子菜单选中态与树形分支样式 2026-08-04 11:25:27 +08:00
yml2213 e6f09eaf14 优化商品列表表格列宽与上架配置面板 2026-08-04 11:16:54 +08:00
yml2213 71bdbf527c 优化积分明细与商户中心UI排版 2026-08-04 11:07:52 +08:00
yml2213 627d5cafa6 优化平台商户管理表格列宽分布 2026-08-04 11:05:01 +08:00
yml2213 c015def4cd 优化后台UI与开放文档排版设计 2026-08-04 11:01:52 +08:00
yml2213 ae9804e158 访问日志跳过 /health 健康检查，避免每 30 秒刷屏 2026-08-04 09:43:39 +08:00
yml2213 5f547546c3 日志按天分割并自动清理：app-YYYYMMDD.log，保留天数可配 
- dailyFileWriter 按天轮转：跨天自动切换到新文件（app-20260804.log）
- LOG_RETAIN_DAYS 控制保留天数（默认 30），到期自动删除
- docker-compose 透传 LOG_RETAIN_DAYS，README 更新环境变量说明
- 补充轮转/清理单测
 2026-08-04 09:42:20 +08:00
yml2213 90f4fb255e 容器 user 默认值调整为 1000:1000（与服务器一致） 2026-08-04 09:37:21 +08:00
yml2213 a3970bc5dc 后端容器以宿主用户运行，日志权限修复；移除未使用的 backend-data 卷 2026-08-04 09:32:53 +08:00
yml2213 d6b426ab2a 查询绑定结果增加预期账号比对：mismatch 提前拦截 
- 下单 data 传了 game_account 时，bind-result 返回 expected_game_account 与 mismatch
- 绑定账号与预期不一致时 message 提示，配合 submit 已有的一致性校验提前发现
- 对接文档补充 mismatch 字段与说明
 2026-08-03 17:47:12 +08:00
yml2213 2e67e2cc3b 发货链接返回完整域名：DELIVERY_BASE_URL 未配置时按请求 scheme+Host 推导 
- GetOrCreateDeliveryLink/RestoreDeliveryLink 增加 requestBaseURL 参数
- buildDeliveryURL 优先级：DELIVERY_BASE_URL → 请求域名 → 路径
- 支持 X-Forwarded-Proto 与 TLS 判断 https
 2026-08-03 17:38:11 +08:00
yml2213 19ada1282e 新增查询绑定结果接口（自建发货页轮询角色信息） 
- GET /api/client/v1/orders/{order_no}/delivery/bind-result?bind_uuid=xxx
- 返回 bound/game_account/role_name/game_channel；未绑定返回 bound=false（不报错，供轮询）
- 对接文档自建发货页模式新增该接口，注明轮询建议间隔
 2026-08-03 17:10:50 +08:00
yml2213 8da9dcec43 发货订单列表移除上游单号列，文档弱化内部发货单号 
- 前端订单表格删除「上游单号」列（商户无需关注）
- 对接文档 provider_order_no 标注为平台内部发货单号
- 后端 provider_order_no 保留（防重复发货标记）
 2026-08-03 16:31:50 +08:00
yml2213 235ada0786 优化导航栏缩小按钮 2026-08-03 16:21:53 +08:00
yml2213 90e5690a0a 对接文档移除顶部「开放 API/API 密钥」切换按钮，统一由左侧目录导航 2026-08-03 16:07:31 +08:00
yml2213 cf2a1b452c 对接文档配色优化：分组标题品牌蓝+分隔线，接口项/子项灰阶拉开，小节标题蓝竖线区分 2026-08-03 15:50:34 +08:00
yml2213 4406d492d7 对接文档目录字号优化：分组标题 12→14px 加粗，接口项/子项同步放大，目录加宽 2026-08-03 15:18:07 +08:00
yml2213 b7b9132242 对接文档重构：两种发货对接方式分开展示 
- 左侧目录按分组展示：基础接口 / 发货链接模式 / 自建发货页模式 / 回调 / 附录
- 概述页发货对接方式对比表强化（适用场景/接口顺序/建议）
- 创建订单响应示例 data 统一为约定字段，补充 201/200 状态说明
- 对外响应字段 upstream_order 更名为 delivery（result_data 存储键兼容旧数据）
 2026-08-03 14:48:30 +08:00
yml2213 4019b657c4 对接文档去除上游概念，只展示商户对接平台 
- 文档移除所有上游/发货平台/BFF 表述：接口字段说明、示例、推荐流程全部中性化
- 代码用户可见文案同步中性化：提交发货 message、错误提示、发货配置相关措辞
- 概述去掉 /api/open/v1 上游链路提示
 2026-08-03 14:34:58 +08:00
yml2213 f95075e2e4 data 透传闭环：发货数据回显、回调带回，并限制 2KB 
- 「查询发货数据」响应新增 data（下单透传原样回显，供自建发货页预填/展示）
- 回调 payload 带回 data（下单传 → 回调收，商户对接免回查）
- 创建订单 data 限制最长 2048 字节
- 文档更新：data 用途（自建页预填/回调/上游查单约定字段）、发货数据与回调示例
- 单测覆盖 data 回显
 2026-08-03 14:32:08 +08:00
yml2213 a44f58cd0f 优化开放 API 文档：创建订单响应示例补全为真实完整字段 
- 响应示例从 4 个字段补全为完整订单对象（product/金额/手续费/时间等 21 字段）
- 备注补充双单号说明：下单后保存 order_no 用于后续链路，client_order_no 仅用于幂等
- 说明 data 透传字段行为
 2026-08-03 13:53:18 +08:00
yml2213 fe55585f4d 修复发货提交卡死恢复 2026-08-03 13:24:47 +08:00
yml2213 6eb05b322c 对照生产抓包修复发货链路：BFF 地址、上游单号取值与直判交付 
- DELIVERY_BFF_BASE_URL 默认改为 https://www.jxya.top/bff（生产实际路径，非 bff-stg）
- provider_order_no 取值优先级调整为 order_no/_id/id/order_sn：抓包确认 order_sn 为平台单号回显，上游真实单号是 _id
- 上游创建订单响应 status=FINISHED 或 send_status=SUCCESS 时订单直接置为 delivered，无需等待 ship-notify
- 同步更新单测（mock 上游返回 _id/order_sn/FINISHED/SUCCESS）
 2026-08-03 13:06:43 +08:00
yml2213 8dc2a4077a 新增荣耀勋章/幸运币商品：迁移、上游商品映射与测试 2026-08-03 12:35:39 +08:00
yml2213 e7c875c715 docs: 商品列表补充 sku，新增荣耀勋章/幸运币中英文对照 2026-08-03 12:02:51 +08:00
yml2213 ef8b8a7213 回调签名改为与开放 API 一致的字典序拼接风格 
- 签名串由 timestamp+换行+bodyhash 改为 body_sha256=<hash>&timestamp=<unix秒>（ASCII 字典序 & 拼接）
- 同步更新对接文档
 2026-08-03 11:48:10 +08:00
yml2213 3e8526d5d7 对接文档新增回调通知章节（事件/签名/推送重试） 
- 回调文档三个区块：回调通知（事件列表、推送示例、接收方要求）、签名校验（算法与伪代码）、推送与重试（微信式 16 次退避序列）
- 概述一句话上手补充回调配置步骤
 2026-08-03 11:33:36 +08:00
yml2213 27a86f5311 回调优化为单地址 upsert 配置并支持重置密钥 
- 回调订阅改为单记录 upsert：保存即覆盖（URL/事件/状态），自动停用其他订阅，无新增/删除
- 新增重置密钥：保存时传 rotate_secret=true 重新生成密钥并返回一次，解决密钥丢失无法找回
- 删除不再使用的 PATCH /callbacks/:id/status 路由及对应 handler/service 死代码
- 前端回调页改为内联表单（URL/事件/状态），新增重置密钥按钮（确认后展示新密钥一次）
- 补充单地址复用、disabled 不投递、密钥轮换测试
 2026-08-03 11:23:46 +08:00
yml2213 cf2ee96baa 优化回调推送：参考微信/支付宝机制，限制每商户单一回调地址 
- 回调重试改为微信式固定退避序列（15s/15s/30s/3m/10m/20m/30m/30m/30m/1h/3h/3h/3h/6h/6h），共 16 次尝试
- 重试次数/推送超时/退避序列可通过环境变量配置（CALLBACK_MAX_ATTEMPTS/CALLBACK_PUSH_TIMEOUT_SECONDS/CALLBACK_RETRY_SCHEDULE）
- 每个商户仅允许 1 个 active 回调订阅，创建前校验，先停用后新建
- 前端回调页提示推送策略与单地址限制
- docker-compose 透传回调相关配置
 2026-08-03 10:57:21 +08:00
yml2213 7fe4a05ed7 优化api密钥 2026-08-03 10:38:06 +08:00
yml2213 9a3471cc61 优化钱包界面：改名积分明细，添加筛选功能，优化表格列宽 
- 侧边栏和页面标题改为'积分明细'
- 新增关联单号、收支类型筛选功能
- 后端 ledger API 支持 reference_no 和 type 筛选参数
- 表格列宽优化，流水号完整展示，备注列限制宽度
- 隐藏固定 tab 模式下的商户介绍文字
 2026-07-31 20:18:06 +08:00
yml2213 8672ab2dca 优化 API 密钥管理与展示 
- 每个商户限制最多 5 个 API 密钥，超限拒绝创建并提示
- API 密钥权限列改用中文标签展示，新增按用途命名提示
- 优化 API 密钥表格列宽，App Key 完整单行展示
- 补充密钥数量上限测试
 2026-07-31 19:58:17 +08:00
yml2213 eac025c92f 加强发货提交可靠性并统一契约口径 
- 发货提交记录阶段推进与失败分类，失败不再清空 result_data
- 超时巡检区分已提交上游与提交中断两类卡单，避免误判
- 已提交上游的失败订单禁止自动重发，防止重复发货
- ship_attempts 仅在 claim 时计数，失败阶段只记录分类信息
- CanFulfill 对已提交上游的失败单返回不可发货
- 删除预留的 pending 订单状态，统一订单状态模型
- 契约改名：order.fulfillment.updated -> order.shipping.updated，fulfillment:read -> shipping:read
- 文档修正 scope 为或关系
 2026-07-31 18:42:52 +08:00
yml2213 4aa5258c2d 统一发货口径并保护结果数据 2026-07-31 17:45:20 +08:00
yml2213 4ae9ef53ff 压平数据库初始化迁移 2026-07-31 17:19:29 +08:00