csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
387 Commits 3 Branches 0 Tags
69ee754c193ba6e77947f8ec2923db024e6604d3
Commit Graph

147 Commits

Author SHA1 Message Date
huang
69ee754c19 feat: 补全网关停复机调用的关键日志（调用前/成功后均输出 INFO）
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details
2026-03-31 19:15:45 +08:00
huang
619f029a5a fix: 修复佣金计算任务载荷二次序列化导致 base64 编码错误
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m11s
Details 
问题：EnqueueTask 内部调用 sonic.Marshal，传入 []byte 时会将字节数组
base64 编码为 JSON 字符串，Handler 反序列化时类型不匹配（CommissionCalculationPayload vs string）

根因：order/service.go 的 enqueueCommissionCalculation 预先 Marshal 得到 []byte
后传给 EnqueueTask，导致载荷被二次序列化

修复：直接传入 map，由 EnqueueTask 统一序列化一次

规范同步：
- pkg/queue/client.go 函数注释明确禁止传 []byte
- AGENTS.md 新增「异步任务载荷规范」防止重现
 2026-03-31 18:48:17 +08:00
huang
31e147495c fix: 修复提现冻结逻辑错误导致数据库约束违反
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
- 余额检查从 wallet.Balance 改为 wallet.GetAvailableBalance()，
  防止 frozen_balance 已有值时误判为余额充足
- 冻结余额时只增加 frozen_balance，不再同时减少 balance，
  与系统其他冻结操作保持一致（balance = 总额，frozen 为其子集）
- 修复后 SQL 不再触发 chk_agent_wallet_frozen_balance 约束
 2026-03-31 18:41:07 +08:00
huang
6457ffa6f9 fix: 支付回调激活套餐后异步触发停机卡自动复机 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-03-31 18:12:24 +08:00
huang
8d69858413 fix: 套餐激活和流量重置后注入并调用复机回调 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-03-31 18:12:16 +08:00
huang
cf602ab5be fix: ResumeCardIfStopped 扩展 — 支持 device 类型、实名检查、并发锁 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-03-31 18:11:38 +08:00
huang
bc2dbcb416 fix: 修复 V2 微信支付参数全为空字符串的问题
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m17s
Details 
extractPaymentResult 只处理 map[string]any，而 V2 自建实现返回
map[string]string，类型断言静默失败导致所有字段为空字符串。
增加对 map[string]string 的处理分支，兼容 V1 和 V2 两种支付渠道。
 2026-03-31 14:59:43 +08:00
huang
dc4f3cb7ba feat: C端订单支付拆分 — 创建订单与发起支付分离
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m10s
Details 
- CreateOrder 改造：普通下单只建单（无支付参数），强充场景保持原有微信支付一步完成
- 新增 POST /orders/:id/pay 统一支付入口，支持 wallet（钱包）和 wechat（微信 JSAPI）
- 移除 POST /orders/:id/wallet-pay，合并至统一支付接口
- app_type 改为可选字段（强充场景必传，普通下单无需传）
- CreateOrderResponse.pay_config 改为 omitempty（普通下单不返回支付参数）
 2026-03-31 12:43:34 +08:00
huang
121462c00f feat: 给 PackageUsage 添加 package_name 快照字段，修复企业卡列表 carrier_name/package_name 为空问题 
- 迁移 000099：tb_package_usage 新增 package_name 列，回填历史数据
- PackageUsage model 添加 PackageName 字段（与 DataResetCycle 保持一致的快照设计）
- 4 处 PackageUsage 创建点补充 PackageName 快照（order/service.go + auto_purchase.go）
- EnterpriseCard ListCards：carrier_name 直接取 card.CarrierName，package_name 通过
  DISTINCT ON 批量查当前生效主套餐，单次查询覆盖整页，无 N+1
 2026-03-31 12:43:07 +08:00
huang
5b283285a2 fix: 修复微信支付容器内 mkdir 权限错误，新增 wechat_v2 支付渠道
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m11s
Details 
- NewPaymentAppFromConfig 加 Log.Stdout=true，禁止 PowerWeChat SDK 在容器
  工作目录创建 wechat/ 日志文件夹（Permission denied 根因）
- 新增 ProviderTypeWechatV2 = wechat_v2 常量，与 wechat(v3) 独立区分
- 新增 PaymentV2Service：直连统一下单 v2 接口，XML + MD5 签名
- newPaymentProvider 按 ProviderType 分支路由到对应版本
 2026-03-31 12:12:13 +08:00
huang
2ef8b8a705 fix: 修复分页字段/角色DTO/套餐详情/批量分配Bug，新增C端测试登录接口和Hurl价格验证测试
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
- 修复B-2：27个分页DTO字段名统一（list→items, page_size→size，删除total_pages）
- 修复B-1：角色接口统一返回DTO（id小写，消除GORM大写字段名）
- 修复C-1：套餐详情接口（GET /packages/:id）补充代理佣金字段
- 修复C-2：批量分配已存在记录由500改为静默跳过
- 修复C-3：创建系列授权响应在事务提交后构建，packages数组不再为空
- 新增C端开发测试登录接口（POST /api/c/v1/auth/dev-login，仅logging.development=true时生效）
- 新增Hurl测试：card-price-verification-flow.hurl（导入卡→分配→C端价格验证）
- 新增测试Excel数据文件和dev.env测试变量
 2026-03-31 09:54:08 +08:00
huang
a97462dd69 fix: 支付失败时幂等标记未清理导致用户无法重试 — *created=true移到支付成功后
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m9s
Details
2026-03-30 13:06:45 +08:00
huang
d56b841443 fix: 富友回调应答XMLName缺失 + term_ip自动探测服务器IP替代硬编码
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m8s
Details
2026-03-30 12:46:50 +08:00
huang
0c82ae2b73 fix: 修复富友预下单报文格式错(1014) — XML根元素、小程序tradeType、termIP三处问题
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m27s
Details
2026-03-30 11:57:46 +08:00
huang
f339fb1987 fix: 资产钱包自动创建机制 — 修复C端购买时钱包不存在报错
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m8s
Details 
- client_order: 新增 getOrCreateWallet 兜底，钱包不存在时自动创建
- device_import: 设备导入事务内同步创建设备钱包
- iot_card_import: IoT卡批量导入后批量创建卡钱包
- queue/handler: 传递 AssetWalletStore 给两个导入 handler
- migration 000098: 为存量IoT卡和设备补建资产钱包
 2026-03-30 11:37:41 +08:00
huang
50dbc52432 fix: C端资产详情设备补充已连接数(client_number)字段
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
Gateway sync-info 返回的 client_number 字段未在整条数据链路中传递，
导致 C 端资产详情的设备实时状态缺少已连接客户端数。

修改范围：
- Gateway 模型 SyncDeviceInfoResp 新增 ClientNumber
- B 端 DTO DeviceGatewayInfo 新增 ClientNumber
- C 端 DTO DeviceRealtimeInfo 新增 ClientNumber
- 两层映射函数同步补充字段传递
 2026-03-30 10:18:30 +08:00
huang
cebcada950 refactor: 流量系统重构 — 增量累加算法 + 日粒度缓冲 + 旧详单清理
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m16s
Details 
核心改造：
- 增量算法：流量计算从覆盖式改为增量累加（gateway - lastReading），支持上游运营商重置检测
- 日流量缓冲：insertDataUsageRecord 改为 Redis INCRBYFLOAT，每日凌晨落盘到 tb_card_daily_usage
- 运营商：新增 data_reset_day 字段（联通=27，其余=1）
- IoT卡：新增 last_gateway_reading_mb 字段存储上次网关读数
- 查询层：新建 TrafficQueryService 合并 Redis（今日）+ DB（历史）数据源
- 清理：删除 DataUsageRecord model/store，移除 polling_handler 旧引用

迁移：000094-000097（carrier字段、iot_card字段、数据初始化、日流量表）
 2026-03-30 09:59:30 +08:00
huang
f5dd2ce4ab fix: Gateway 响应类型兼容 — 新增 FlexBool/FlexInt 处理设备返回的字符串类型字段
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m4s
Details 
部分设备厂商（如华为）的 Gateway 响应中 bool/int 字段返回为字符串（wifi_enabled: "1"、battery_level: "30"），
导致 sonic 严格类型检查反序列化失败，整个设备实时数据丢失。

- 新增 FlexBool 类型：兼容 true/false、"1"/"0"、"true"/"false"
- 新增 FlexInt 类型：兼容 30、"30"、null
- SyncDeviceInfoResp 所有 bool/int 字段改用 Flex 类型
- 更新 B 端和 C 端 DTO 映射函数的类型转换
 2026-03-28 18:24:17 +08:00
huang
02b10f87cf feat: 新增退款管理模块 — 完整的退款审批流程、佣金回扣和资产重置
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m8s
Details 
新增退款申请全生命周期管理：创建/列表/详情/审批通过/拒绝/退回/重新提交
审批通过后异步执行佣金全额回扣（扣减各代理佣金钱包）和资产重置（套餐失效+停机+世代重置）
新增 tb_refund_request 表（迁移 000093）、RefundRequest Model、8 个 DTO
新增 Store/Service/Handler/路由注册，仅平台用户可访问
 2026-03-28 17:57:52 +08:00
huang
623a622298 feat: 业务逻辑补全 — 佣金待审记录、C端订单重构、支付抽象、富友支付、卡设备状态联动
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
F-1: 佣金链断裂时创建 status=99 零额待审记录，新增修正接口 POST /commission-records/:id/resolve
F-4: C端订单查询从 Handler 迁移至 Service 层，移除 SkipPermissionCtx
J-1: 富友支付 JSAPI/MiniApp 预下单实现，回调补全签名验证
J-2: 平台钱包代购支持（buyerType 为空时使用资产所属代理钱包）
J-3: 套餐激活后自动更新卡/设备 status=3，最后套餐过期后更新 status=4
支付抽象: 引入 PaymentProvider 接口 + 微信/富友适配器，CreateOrder 支持多支付渠道
修复: 设备/IoT卡响应 DTO 移除 omitempty，空值字段返回 null 而非省略
 2026-03-28 16:57:39 +08:00
huang
65e461eff7 fix: 代码质量清理 — 统一C端支付枚举、修复静默错误、注入Worker回调、移除废弃同步代码
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m6s
Details 
- C端订单支付状态直接使用管理端统一枚举(1/2/3/4)，移除冗余映射函数
- 资产查询绑定卡/套餐查询失败时记录Warn日志而非静默忽略
- Worker bootstrap注入停复机回调（流量耗尽停机、套餐激活复机）
- 删除废弃的SIM状态同步服务和任务处理器
- 新增开发环境数据清理脚本（full/soft/table三种模式）
 2026-03-28 15:27:59 +08:00
huang
a202b2da8a feat(03.1-01): 建立设备实时 Gateway 调用链路，替换 mock 数据 
- GetRealtimeStatus() device case 新增 Gateway sync-info 实时调用（IMEI/SN 优先，gatewayClient nil 安全）
- 新增 mapSyncRespToDeviceGatewayInfo() 将 SyncDeviceInfoResp 映射为 B 端 DeviceGatewayInfo DTO
- 新增 strPtr() 辅助函数（空字符串→nil，防止 JSON 出现大量空字符串字段）
- client_asset.go 删除 buildMockDeviceRealtime()，改为调用 assetService.GetRealtimeStatus() 获取真实数据
- 新增 mapDeviceGatewayInfoToClientInfo() 将 B 端 DeviceGatewayInfo 映射为 C 端 DeviceRealtimeInfo
- Gateway 调用失败时 DeviceRealtime 返回 null，不阻断主流程
 2026-03-28 13:21:02 +08:00
huang
3b54850f1b feat(03.1-01): 修复静态 DTO 映射缺口 
- toDeviceResponse() 补全 5 个 DB 缓存字段（OnlineStatus/LastOnlineTime/SoftwareVersion/SwitchMode/LastGatewaySyncAt）
- ListBindings() 补全 IsCurrent 字段映射
- buildDeviceResolveResponse() 补全 isCurrentMap + BoundCardInfo.IsCurrent + 5 个 DB 缓存字段
- GetRealtimeStatus() device case 补全 isCurrentMap + BoundCardInfo.IsCurrent
 2026-03-28 13:19:09 +08:00
huang
00dba42a63 feat(03.1-01): 补全 Gateway SyncDeviceInfoResp 缺失字段及 B 端 DeviceGatewayInfo DTO 
- SyncDeviceInfoResp 新增 Rsrp/Rsrq/Sinr/WifiPassword/IPAddress/WANIP/LANIP/MaxClients/ConnectTime/Status/IMSI/ULStats/DLStats/LimitSpeed/SyncInterval 共 15 个字段
- asset_dto.go 新增 DeviceGatewayInfo B 端实时状态结构体（49 字段，全部含 description tag）
- AssetRealtimeStatusResponse 新增 DeviceRealtime *DeviceGatewayInfo 字段
- AssetResolveResponse 新增 5 个设备 DB 缓存字段（online_status/last_online_time/software_version/switch_mode/last_gateway_sync_at）
 2026-03-28 13:17:52 +08:00
huang
d0ef3bb712 修复错误的状态码 2026-03-28 12:54:04 +08:00
huang
15dbf8dc66 feat(03-02): Asset Service 接入 Gateway sync-info（DEVICE-04） 
- Service 结构体新增 gatewayClient 字段，New() 追加 gatewayClient 参数
- Refresh device 分支在绑定卡刷新后调用 SyncDeviceInfo，nil guard + Warn 日志不阻断主流程
- 新增 updateDeviceFromSyncInfo 私有函数：更新 5 个 device 字段 + 调用 UpdateIsCurrentByDeviceID
- bootstrap/services.go asset.New() 调用追加 deps.GatewayClient
- go build ./... 零新增编译错误
 2026-03-28 11:38:14 +08:00
huang
47aa5f8d25 fix(poll): Series 删除前检查关联套餐 POLL-04 
- package_store.go 新增 CountBySeriesID 方法，统计指定系列下的活跃套餐数量
- package_series/service.go Service 注入 packageStore 字段，Delete 前调用 CountBySeriesID 检查
- bootstrap/services.go 更新 PackageSeries 服务初始化，传入 PackageStore
 2026-03-28 10:42:58 +08:00
huang
8553a46143 fix(poll): GetPackages 接口新增分页 POLL-03 
- 新增 AssetPackagesResult DTO（含 total/page/page_size/items 字段）
- GetPackages 签名新增 page/pageSize 参数，默认 page=1、pageSize=50、最大 100
- admin/asset.go:Packages 从 Query 参数读取 page/page_size 传入 Service
- client_asset.go 调用处同步更新，使用默认分页参数
 2026-03-28 10:41:20 +08:00
huang
8a531237c3 fix(poll): gatewayClient=nil 时停复机返回错误而非成功 POLL-02 
- stopCardWithRetry: gatewayClient==nil 时返回业务错误而非 nil（静默跳过会假装停机成功）
- resumeCardWithRetry: 同上修复
 2026-03-28 10:39:47 +08:00
huang
60b43bb29e fix(realname): ActivateByRealname 按 ExpiryBase 选择计时基准 REALNAME-04 
- from_purchase：用 PackageUsage.CreatedAt（购买时刻）作为激活时间起点
- from_activation（默认）：用实名被触发的当前时刻作为激活时间起点
 2026-03-28 10:39:00 +08:00
huang
bdac4ab7b2 fix(fin): 激活配置并发行锁保护 FIN-03 
- commission_withdrawal_setting/service.go: 激活事务内首步加 FOR UPDATE 行锁，防止并发时出现多条 is_active=true
- wechat_config_store.go: ActivateInTx 激活前同样加行锁保护
 2026-03-28 10:38:53 +08:00
huang
0ebb3d75f3 fix(realname): C 端实名检查改为按卡类型判断 REALNAME-03 
- 删除 packagesNeedRealname 函数（依赖已废弃的 EnableRealnameActivation）
- 改为按 assetInfo.CardCategory==normal 判断是否需要实名
- 行业卡（industry）绕过实名检查，普通卡（normal）需要实名
 2026-03-28 10:38:44 +08:00
huang
7dd55630dc fix(realname): activateMainPackage 三维决策重构 REALNAME-02 
- 替换 EnableRealnameActivation 布尔判断为三维决策逻辑
- 行业卡（card_category=industry）永远直接激活
- C 端购买（BuyerTypePersonal）前置实名检查已完成，直接激活
- 后台囤货按 ExpiryBase 决定：from_activation 等实名，from_purchase 立即激活
 2026-03-28 10:38:24 +08:00
huang
244a2742c1 fix(realname): DTO 更新 expiry_base 替换 enable_realname_activation REALNAME-05 
- package_dto.go: CreatePackageRequest/UpdatePackageRequest/PackageResponse 三处替换
- service.go: 同步更新 DTO 映射逻辑使用 ExpiryBase
 2026-03-28 10:37:51 +08:00
huang
8f62496250 fix(fin): 补全提现审批人字段 FIN-01 
- Approve updates map 补充 approved_by 和 approved_at 字段，确保审批人信息正确填充
 2026-03-28 10:36:33 +08:00
huang
9a4d87a0d4 feat(01-03): 充值回调触发自动购包任务入队（CRITICAL-04） 
- recharge.Service struct 新增 queueClient *queue.Client 字段
- recharge.New() 新增 queueClient 参数
- HandlePaymentCallback 事务成功后，LinkedPackageIDs 非空时入队 TaskTypeAutoPurchaseAfterRecharge
- bootstrap/services.go 的 recharge.New() 传入 deps.QueueClient
 2026-03-27 23:29:05 +08:00
huang
f74b7da25f fix(01-04): 修正场景5代理代购下级的sellerCostPrice赋值 
- 三处代理代购下级分支（wallet场景子场景2.2）均将 sellerCostPrice = buyerCostPrice 改为 sellerCostPrice = operatorCostPrice
- buyerCostPrice 是下级成本价，operatorCostPrice 是操作方（代理自己）的成本价
- 使用 buyerCostPrice 会导致佣金差额为 0，所有上级代理无法获得应有佣金
- 修复涉及三个函数（普通下单/后台下单/H5下单），行号分别约在 264/551/813
 2026-03-27 23:24:16 +08:00
huang
da50a35a62 fix(01-01): 修复 C 端实名校验使用常量（CRITICAL-02） 
- client_order/service.go: 实名校验 assetInfo.RealNameStatus != 1 改为常量比较
- client_realname.go: 实名状态检查 == 1 改为 constants.RealNameStatusVerified
- go build ./... 编译通过，无遗留硬编码 != 1 / == 1 的实名判断
 2026-03-27 22:54:50 +08:00
huang
1fd0072f69 fix(01-01): 统一实名状态常量（CRITICAL-01 核心） 
- polling_handler.go: parseRealnameStatus 不再返回硬编码 2，改为 constants.RealNameStatusVerified(=1)
- polling_handler.go: isFirstRealname 判断改用常量比较，不再使用 == 2
- polling_handler.go: HandleProtectConsistencyCheck 注释更正为 real_name_status=1
- iot_card.go: RealNameStatus gorm comment 统一为 0-未实名 1-已实名（去除行业卡说明）
- asset_dto.go: RealNameStatus description 更正为 0未实名 1已实名（去除错误的 1实名中 2已实名）
- scheduler.go: getCardCondition 改用常量替代硬编码 0/1/2 判断
- iot_card/service.go: parseGatewayRealnameStatus 注释更正，返回值改为常量
 2026-03-27 22:53:30 +08:00
huang
db166807c7 fix(01-05): 提现冻结并发校验缺失（CRITICAL-08） 
- 冻结余额改为 result := tx...Updates()，分离结果对象
- 检查 result.Error 处理数据库错误
- 检查 result.RowsAffected == 0 防止并发余额不足时仍创建提现单
- RowsAffected == 0 时返回 errors.New(CodeInsufficientBalance, ...)
 2026-03-27 22:50:18 +08:00
huang
7dfcf41b41 fix: 修复卡类型资产绑定键错误导致归属校验永远失败
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m48s
Details 
resolveAssetBindingKey 对卡类型错误地返回 card.ICCID 作为绑定键，
但归属校验 isCustomerOwnAsset 使用 card.VirtualNo 比对，二者不一致
导致所有卡资产的 C 端接口返回 403 无权限。

修复：卡类型绑定键改为 card.VirtualNo，与设计文档一致。
附带数据迁移修正已有的错误绑定记录。
 2026-03-21 11:33:57 +08:00
huang
ed334b946b refactor: 清理重构遗留的死代码
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
- personal_customer.Service: 删除已迁移到 client_auth 的死方法
  (GetProfile/SendVerificationCode/VerifyCode)，移除多余的
  verificationService/jwtManager 依赖
- 删除 internal/service/customer/ 整个目录（零引用的早期残留）
 2026-03-21 11:33:06 +08:00
huang
d2494798aa fix: 修正停复机接口错误码，网关失败不再返回模糊的内部服务器错误
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m13s
Details 
- 单卡停复机：网关错误从 CodeInternalError(2001) 改为 CodeGatewayError(1110)，前端可看到具体失败原因
- 单卡停复机：DB 更新裸返 GORM error 改为 CodeDatabaseError(2002) 包装
- 设备复机：全部卡失败时错误码从 CodeInternalError 改为 CodeGatewayError
 2026-03-19 18:37:03 +08:00
huang
b9733c4913 fix: 修正零售价架构错误 + 清理旧微信配置 + 归档提案 + 前端接口文档
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m12s
Details 
1. 修正 retail_price 架构：
   - 删除 batch-pricing 接口的 pricing_target 字段和 retail_price 分支
     （上级只能改下级成本价，不能改零售价）
   - 新增 PATCH /api/admin/packages/:id/retail-price 接口
     （代理自己改自己的零售价，校验 retail_price >= cost_price）

2. 清理旧微信 YAML 配置（已全部迁移到数据库 tb_wechat_config）：
   - 删除 config.yaml 中 wechat.official_account 配置节
   - 删除 NewOfficialAccountApp() 旧工厂函数
   - 清理 personal_customer service 中的死代码（旧登录/绑定微信方法）
   - 清理 docker-compose.prod.yml 中旧微信环境变量和证书挂载注释

3. 归档四个已完成提案到 openspec/changes/archive/

4. 新增前端接口变更说明文档（docs/前端接口变更说明.md）

5. 修正归档提案和 specs 中关于 pricing_target 的错误描述
 2026-03-19 17:39:43 +08:00
huang
9bd55a1695 feat: 实现客户端核心业务接口（client-core-business-api） 
新增客户端资产、钱包、订单、实名、设备管理等核心业务 Handler 与 DTO：
- 客户端资产信息查询、套餐列表、套餐历史、资产刷新
- 客户端钱包详情、流水、充值校验、充值订单、充值记录
- 客户端订单创建、列表、详情
- 客户端实名认证链接获取
- 客户端设备卡列表、重启、恢复出厂、WiFi配置、切卡
- 客户端订单服务（含微信/支付宝支付流程）
- 强充自动代购异步任务处理
- 数据库迁移 000084：充值记录增加自动代购状态字段
 2026-03-19 13:28:04 +08:00
huang
e78f5794b9 feat: 实现客户端换货系统（client-exchange-system） 
新增完整换货生命周期管理：后台发起 → 客户端填收货信息 → 后台发货 → 确认完成（含可选全量迁移） → 旧资产转新再销售

后台接口（7个）：
- POST /api/admin/exchanges（发起换货）
- GET /api/admin/exchanges（换货列表）
- GET /api/admin/exchanges/:id（换货详情）
- POST /api/admin/exchanges/:id/ship（发货）
- POST /api/admin/exchanges/:id/complete（确认完成+可选迁移）
- POST /api/admin/exchanges/:id/cancel（取消）
- POST /api/admin/exchanges/:id/renew（旧资产转新）

客户端接口（2个）：
- GET /api/c/v1/exchange/pending（查询换货通知）
- POST /api/c/v1/exchange/:id/shipping-info（填写收货信息）

核心能力：
- ExchangeOrder 模型与状态机（1待填写→2待发货→3已发货→4已完成，1/2可取消→5）
- 全量迁移事务（11张表：钱包、套餐、标签、客户绑定等）
- 旧资产转新（generation+1、状态重置、新钱包、历史隔离）
- 旧 CardReplacementRecord 表改名为 legacy，is_replaced 过滤改为查新表
- 数据库迁移：000085 新建 tb_exchange_order，000086 旧表改名
 2026-03-19 13:26:54 +08:00
huang
df76e33105 feat: 实现 C 端完整认证系统（client-auth-system） 
实现面向个人客户的 7 个认证接口（A1-A7），覆盖资产验证、
微信公众号/小程序登录、手机号绑定/换绑、退出登录完整流程。

主要变更：
- 新增 PersonalCustomerOpenID 模型，支持多 AppID 多 OpenID 管理
- 实现有状态 JWT（JWT + Redis 双重校验），支持服务端主动失效
- 扩展微信 SDK：小程序 Code2Session + 3 个 DB 动态工厂函数
- 实现 A1 资产验证 IP 限流（30/min）和 A4 三层验证码限流
- 新增 7 个错误码（1180-1186）和 6 个 Redis Key 函数
- 注册 /api/c/v1/auth/* 下 7 个端点并更新 OpenAPI 文档
- 数据库迁移 000083：新建 tb_personal_customer_openid 表
 2026-03-19 11:33:41 +08:00
huang
ec86dbf463 feat: 客户端接口数据模型基础准备 
- 新增资产状态、订单来源、操作人类型、实名链接类型常量
- 8个模型新增字段（asset_status/generation/source/retail_price等）
- 数据库迁移000082：7张表15+字段，含存量retail_price回填
- BUG-1修复：代理零售价渠道隔离，cost_price分配锁定
- BUG-2修复：一次性佣金仅客户端订单触发
- BUG-4修复：充值回调Store操作纳入事务
- 新增资产手动停用接口（PATCH /iot-cards/:id/deactivate、/devices/:id/deactivate）
- Carrier管理新增实名链接配置
- 后台订单generation写时快照
- BatchUpdatePricing支持retail_price调价目标
- 清理全部H5旧接口和个人客户旧登录方法
 2026-03-19 10:56:50 +08:00
huang
b44363b335 fix: 修复新建店铺未初始化代理钱包导致充值订单报错
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m6s
Details 
新建店铺时在 shop.Service.Create() 中自动初始化主钱包(main)和分佣钱包(commission)，修复充值订单创建时「目标店铺主钱包不存在」错误

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-03-17 14:08:26 +08:00
huang
269769bfe4 refactor: 改造订单和资产充值 Service，支持动态支付配置 
- order/service.go: 注入 wechatConfigService，CreateH5Order/CreateAdminOrder 下单时查询 active 配置并记录 payment_config_id；无配置时拒绝第三方支付；WechatPayJSAPI/WechatPayH5/FuiouPayJSAPI/FuiouPayMiniApp 添加 TODO 留桩
- recharge/service.go: Create 方法记录 payment_config_id，HandlePaymentCallback 留桩

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-03-16 23:30:05 +08:00