csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
230 Commits 1 Branch 0 Tags
b1d6355a7d39c964fff60f2c2b6a0a25b8c75b15
Commit Graph

230 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
huang
804145332b chore: 归档轮询系统实现变更 (polling-system-implementation)
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 44s
Details 
已完成千万级卡规模轮询系统的完整实现和集成测试验证，将变更归档到 openspec/changes/archive/2026-02-10-polling-system-implementation/

主要成果：
- 三大轮询任务：实名检查、卡流量检查、套餐流量检查
- 快速启动（<10秒）和渐进式初始化
- 完整运营工具：配置管理、并发控制、监控面板、告警系统、数据清理、手动触发
- 任务完成度：215/216（99.5%）
- 所有 24 个新增接口已生成 OpenAPI 文档

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 10:28:47 +08:00
huang
931e140e8e feat: 实现 IoT 卡轮询系统（支持千万级卡规模）
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m35s
Details 
实现功能：
- 实名状态检查轮询（可配置间隔）
- 卡流量检查轮询（支持跨月流量追踪）
- 套餐检查与超额自动停机
- 分布式并发控制（Redis 信号量）
- 手动触发轮询（单卡/批量/条件筛选）
- 数据清理配置与执行
- 告警规则与历史记录
- 实时监控统计（队列/性能/并发）

性能优化：
- Redis 缓存卡信息，减少 DB 查询
- Pipeline 批量写入 Redis
- 异步流量记录写入
- 渐进式初始化（10万卡/批）

压测工具（scripts/benchmark/）：
- Mock Gateway 模拟上游服务
- 测试卡生成器
- 配置初始化脚本
- 实时监控脚本

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-05 17:32:44 +08:00
huang
b11edde720 fix: 注册佣金计算任务 Handler 到队列处理器
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m19s
Details 
佣金计算任务 (commission:calculate) 的 Handler 已实现但未在队列处理器中注册，
导致支付成功后入队的佣金计算任务永远不会被消费执行。

变更内容：
- 在 pkg/queue/handler.go 中添加 registerCommissionCalculationHandler() 方法
- 创建所有需要的 Store 和 Service 依赖
- 在 RegisterHandlers() 中调用注册方法

修复后，订单支付成功将正确触发佣金计算和发放。

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-04 16:08:03 +08:00
huang
8ab5ebc3af feat: 在 IoT 卡和设备列表响应中添加套餐系列名称字段
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m2s
Details 
主要变更：
- 在 StandaloneIotCardResponse 和 DeviceResponse 中添加 series_name 字段
- 在 iot_card 和 device service 中添加 loadSeriesNames 方法批量加载系列名称
- 更新相关方法以支持 series_name 的填充

其他变更：
- 新增 OpenSpec 测试生成和共识锁定 skill
- 新增 MCP 配置文件
- 更新 CLAUDE.md 项目规范文档

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-04 15:28:41 +08:00
huang
dc84cef2ce fix(package-series): 将 enable_one_time_commission 字段提升到创建/更新请求顶层
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m5s
Details 
- DTO: CreatePackageSeriesRequest 和 UpdatePackageSeriesRequest 添加 EnableOneTimeCommission 字段
- Service: Create/Update 方法处理顶层字段并同步到 JSON config 的 Enable 字段
- 确保顶层字段与 JSON config 内的 enable 保持一致，避免业务逻辑判断出错
 2026-02-04 14:38:10 +08:00
huang
b18ecfeb55 refactor: 一次性佣金配置从套餐级别提升到系列级别
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m29s
Details 
主要变更:
- 新增 tb_shop_series_allocation 表，存储系列级别的一次性佣金配置
- ShopPackageAllocation 移除 one_time_commission_amount 字段
- PackageSeries 新增 enable_one_time_commission 字段控制是否启用一次性佣金
- 新增 /api/admin/shop-series-allocations CRUD 接口
- 佣金计算逻辑改为从 ShopSeriesAllocation 获取一次性佣金金额
- 删除废弃的 ShopSeriesOneTimeCommissionTier 模型
- OpenAPI Tag '系列分配' 和 '单套餐分配' 合并为 '套餐分配'

迁移脚本:
- 000042: 重构佣金套餐模型
- 000043: 简化佣金分配
- 000044: 一次性佣金分配重构
- 000045: PackageSeries 添加 enable_one_time_commission 字段

测试:
- 新增验收测试 (shop_series_allocation, commission_calculation)
- 新增流程测试 (one_time_commission_chain)
- 删除过时的单元测试（已被验收测试覆盖）
 2026-02-04 14:28:44 +08:00
huang
fba8e9e76b refactor(account): 移除卡类型字段、优化账号列表查询和权限检查
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m18s
Details 
- 移除 IoT 卡和号卡的 card_type 字段（数据库迁移）
- 优化账号列表查询，支持按店铺和企业筛选
- 账号响应增加店铺名称和企业名称字段
- 实现批量加载店铺和企业名称，避免 N+1 查询
- 更新权限检查中间件，完善权限验证逻辑
- 更新相关测试用例，确保功能正确性
 2026-02-03 10:59:44 +08:00
huang
ad6d43e0cd 移除 2026-02-03 10:19:39 +08:00
huang
5a90caa619 feat(shop-role): 实现店铺角色继承功能和权限检查优化
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m39s
Details 
- 新增店铺角色管理 API 和数据模型
- 实现角色继承和权限检查逻辑
- 添加流程测试框架和集成测试
- 更新权限服务和账号管理逻辑
- 添加数据库迁移脚本
- 归档 OpenSpec 变更文档

Ultraworked with Sisyphus
 2026-02-03 10:06:13 +08:00
huang
bc7e5d6f6d 修复go的验证库把int的0当作无值的情况 2026-02-03 09:57:53 +08:00
huang
0b82f30f86 修复飘红问题
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 15h48m25s
Details
2026-02-02 17:52:14 +08:00
huang
301eb6158e docs: 添加 add-gateway-admin-api 最终报告和完成文档 2026-02-02 17:51:38 +08:00
huang
6c83087319 docs: 标记 add-gateway-admin-api 计划所有任务为完成 2026-02-02 17:49:40 +08:00
huang
2ae585225b test(integration): 添加 Gateway 接口集成测试 
- 添加 6 个卡 Gateway 接口测试（查询状态、流量、实名、获取链接、停机、复机）
- 添加 7 个设备 Gateway 接口测试（查询信息、卡槽、限速、WiFi、切卡、重启、恢复出厂）
- 每个接口测试包含成功场景和权限校验场景
- 更新测试环境初始化，添加 Gateway 客户端 mock 支持
- 所有 13 个接口测试通过
 2026-02-02 17:44:24 +08:00
huang
543c454f16 feat(routes): 注册 7 个设备 Gateway 路由 2026-02-02 17:33:39 +08:00
huang
246ea6e287 修改 Bootstrap 注入 Gateway Client 依赖到 IotCardHandler 和 DeviceHandler 2026-02-02 17:27:59 +08:00
huang
80f560df33 refactor(account): 统一账号管理API、完善权限检查和操作审计
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m17s
Details 
- 合并 customer_account 和 shop_account 路由到统一的 account 接口
- 新增统一认证接口 (auth handler)
- 实现越权防护中间件和权限检查工具函数
- 新增操作审计日志模型和服务
- 更新数据库迁移 (版本 39: account_operation_log 表)
- 补充集成测试覆盖权限检查和审计日志场景
 2026-02-02 17:23:20 +08:00
huang
5851cc6403 feat(permission): 为权限树接口添加状态查询参数和返回值
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m22s
Details 
- 新增 PermissionTreeRequest DTO 支持 status 查询参数
- PermissionTreeNode 返回值新增 status 字段
- Store 层 GetAll 方法支持状态过滤
- Handler 层使用 QueryParser 解析请求参数
 2026-02-02 17:12:14 +08:00
huang
76b539e867 chore: 归档 OpenSpec 变更 refactor-series-binding-to-series-id
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m22s
Details 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-02-02 12:21:00 +08:00
huang
b47f7b4f46 修复: 更新集成测试以适配 series_id 字段重命名 
- 将所有测试用例的 series_allocation_id 改为 series_id
- 更新测试逻辑，直接使用 series.ID 而非 allocation.ID
- 修复禁用系列测试，直接禁用 PackageSeries 而非 ShopSeriesAllocation
- 所有集成测试通过验证
 2026-02-02 12:16:55 +08:00
huang
37f43d2e2d 重构: 将卡/设备的套餐系列绑定从分配ID改为系列ID 
- 数据库: 重命名 series_allocation_id → series_id
- Model: IotCard 和 Device 字段重命名
- DTO: 所有请求/响应字段统一为 series_id
- Store: 方法重命名，新增 GetByShopAndSeries 查询
- Service: 业务逻辑优化，系列验证和权限验证分离
- 测试: 更新所有测试用例，新增 shop_series_allocation_store_test.go
- 文档: 更新 API 文档说明参数变更

BREAKING CHANGE: API 参数从 series_allocation_id 改为 series_id
 2026-02-02 12:09:53 +08:00
huang
a30b3036bb feat(iot-card-import): 为导入任务接口添加平台用户权限控制
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m10s
Details 
- 在 Import/List/GetByID 接口添加用户类型校验
- 仅超级管理员和平台用户可访问
- 同步更新 OpenAPI 路由描述
- 补充集成测试覆盖权限拒绝场景
 2026-02-02 10:25:03 +08:00
huang
d81bd242a4 fix(force-recharge): 补充强充配置缺失的接口和数据库字段
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m19s
Details 
- 订单管理：增加 payment_method 字段支持，合并代购订单逻辑
- 套餐系列分配：增加强充配置字段（enable_force_recharge、force_recharge_amount、force_recharge_trigger_type）
- 数据库迁移：添加 force_recharge_trigger_type 字段
- 测试：更新订单服务测试用例
- OpenSpec：归档 fix-force-recharge-missing-interfaces 变更
 2026-01-31 15:34:32 +08:00
huang
d309951493 feat(import): 用 Excel 格式替换 CSV 导入
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m33s
Details 
- 删除 CSV 解析代码，新增 Excel 解析器 (excelize)

- 更新 IoT 卡和设备导入任务处理器

- 更新 API 路由文档和前端接入指南

- 归档变更到 openspec/changes/archive/

- 同步 delta specs 到 main specs
 2026-01-31 14:13:02 +08:00
huang
62708892ec 文档
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m2s
Details
2026-01-31 13:06:30 +08:00
huang
b8dda7e62a chore(bootstrap): 更新依赖注入和 API 文档 
- Bootstrap 注册 RechargeHandler 和 RechargeService
- Bootstrap 注册 RechargeStore 数据访问层
- 更新 PaymentCallback 依赖注入（添加 RechargeService）
- 更新 OpenAPI 文档生成器注册充值接口
- 同步 admin-openapi.yaml 文档（新增充值和代购预检接口）
 2026-01-31 12:15:12 +08:00
huang
5891e9db8d feat(routes): 注册充值和代购订单路由 
- 新增 H5 充值路由（创建订单、预检、列表、详情）
- 新增 Admin 代购订单预检路由
- 更新 H5 路由组注册充值处理器
- 更新 Admin 路由组注册代购预检接口
 2026-01-31 12:15:07 +08:00
huang
902ddb3687 feat(handler): 支持代购订单预检和充值订单支付回调 
- OrderHandler 新增 PurchaseCheck 接口用于代购订单预检
- PaymentCallback 支持充值订单支付回调处理
- 根据订单号前缀区分订单类型（代购订单 vs 充值订单）
- 充值订单回调自动更新订单状态和钱包余额
 2026-01-31 12:15:03 +08:00
huang
760b3db1df feat(h5): 新增充值订单处理器和 DTO 
- 实现 RechargeHandler 处理充值订单创建、预检、查询等接口
- 添加充值相关 DTO（CreateRechargeRequest、RechargeCheckRequest 等）
- 支持充值预检（强充检查、金额限制等）
- 支持充值订单列表和详情查询
 2026-01-31 12:14:59 +08:00
huang
001eb81e5e chore(openspec): 清理已归档的 gateway-integration 变更 2026-01-31 12:01:47 +08:00
huang
1ec7de4ec4 chore(bootstrap): 更新依赖注入和配置 
- bootstrap/services.go
  - OrderService 初始化新增依赖注入
  - 添加 ShopSeriesAllocationStore、IotCardStore、DeviceStore
- docker-compose.prod.yml
  - 对象存储 S3 端点改为 HTTPS（安全性提升）
  - 同时更新 API 和 Worker 服务配置

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-01-31 12:01:37 +08:00
huang
113b3edd69 feat(order): 支持代购订单和强充要求检查 
- OrderService 新增代购订单支持
  - 强充要求检查（首次购买最低充值）
  - 代购订单支付限制（无需支付）
  - 强充金额验证
- 新增 OrderDTO 请求/响应结构
  - PurchaseCheckRequest/Response（购买预检）
  - CreatePurchaseOnBehalfRequest（代购订单创建）
- Order 模型新增支付方式
  - PaymentMethodOffline（线下支付，仅平台代购使用）
- OrderService 依赖注入扩展
  - 新增 SeriesAllocationStore、IotCardStore、DeviceStore
  - 支持强充要求检查逻辑
- 完整的集成测试覆盖（534 行）
  - 代购订单创建、强充验证、支付限制等场景

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-01-31 12:01:33 +08:00
huang
22f19377a5 feat(recharge): 新增充值服务和 DTO 
- 实现 RechargeService 完整充值业务逻辑
  - 创建充值订单、预检强充要求
  - 支付回调处理、幂等性检查
  - 累计充值更新、一次性佣金触发
- 新增 RechargeDTO 请求/响应结构
  - CreateRechargeRequest、RechargeResponse
  - RechargeListRequest/Response、RechargeCheckRequest/Response
- 完整的单元测试覆盖（1488 行）
  - 强充要求检查、支付回调、佣金发放等场景
  - 事务处理、幂等性验证

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-01-31 12:01:26 +08:00
huang
c7bf43f306 fix(commission): 代购订单跳过一次性佣金和累计充值更新 2026-01-31 11:46:50 +08:00
huang
1036b5979e feat(store): 新增 RechargeStore 充值订单数据访问层 
实现充值订单的完整 CRUD 操作：
- Create: 创建充值订单
- GetByRechargeNo: 根据订单号查询（不存在返回 nil）
- GetByID: 根据 ID 查询
- List: 支持分页和多条件筛选（用户、钱包、状态、时间范围）
- UpdateStatus: 更新状态（支持乐观锁检查）
- UpdatePaymentInfo: 更新支付信息

测试覆盖率: 94.7%（7个方法全部覆盖）
- 包含正常流程、边界条件、错误处理测试
- 使用 testutils.NewTestTransaction 和 GetTestRedis
- 所有测试通过

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

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-01-31 11:37:47 +08:00
huang
cb0835cd94 feat(constants): 添加充值订单状态和配置常量 2026-01-31 11:32:07 +08:00
huang
526d9c62b7 feat(errors): 添加充值和代购相关错误码 
- 充值相关: CodeRechargeAmountInvalid (1120), CodeRechargeNotFound (1121), CodeRechargeAlreadyPaid (1122)
- 代购相关: CodePurchaseOnBehalfForbidden (1130), CodePurchaseOnBehalfInvalidTarget (1131)
- 强充验证: CodeForceRechargeRequired (1140), CodeForceRechargeAmountMismatch (1141)
 2026-01-31 11:31:58 +08:00
huang
116355835a feat(model): 添加代购和强充配置字段 2026-01-31 11:31:57 +08:00
huang
f6a0f0f39c feat(migration): 添加代购和强充配置字段迁移 2026-01-31 11:31:42 +08:00
huang
e461791a0e 解决冲突
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m7s
Details
2026-01-30 18:09:31 +08:00
huang
109ae688d2 解决冲突 2026-01-30 17:37:35 +08:00
huang
65b4127b84 Merge branch 'emdash/wechat-official-account-payment-integration-30g' 
# Conflicts:
#	README.md
#	cmd/api/main.go
#	internal/bootstrap/dependencies.go
#	pkg/config/config.go
#	pkg/config/defaults/config.yaml
 2026-01-30 17:32:33 +08:00
huang
bf591095a2 微信相关能力 2026-01-30 17:25:30 +08:00
huang
accf7cb293 Merge branch 'emdash/login-prome-47c' 2026-01-30 17:23:33 +08:00
huang
ffeb0417c0 登录权限返回修改 2026-01-30 17:22:38 +08:00
huang
32beac4424 chore: 更新 Gateway 集成任务清单，标记所有任务完成
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details 
- 完成 Phase 1-5 所有任务（14 个 API 接口、45 个测试、2 个文档）
- 测试覆盖率 88.8%（接近 90% 目标）
- 编译通过，无 LSP 错误
- 依赖注入到 Service 层成功
- 符合项目代码规范（中文注释、Go 命名规范）
 2026-01-30 17:12:14 +08:00
huang
3f63fffbb1 chore: apply task changes 2026-01-30 17:05:44 +08:00
huang
4856a88d41 docs: 新增 Gateway 集成和微信公众号支付集成的 OpenSpec 规划文档
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 43s
Details
2026-01-30 16:09:32 +08:00
huang
1cf17e8f14 清理冗余的梯度返佣(TierCommission)配置
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m46s
Details 
- 移除 Model 层：删除 ShopSeriesCommissionTier 模型及相关字段
- 更新 DTO：删除 TierCommissionConfig、TierEntry 类型及相关请求/响应字段
- 删除 Store 层：移除 ShopSeriesCommissionTierStore 及相关查询逻辑
- 简化 Service 层：删除梯度返佣处理逻辑，统计查询移除 tier_bonus 字段
- 数据库迁移：创建 000034_remove_tier_commission 移除相关表和字段
- 更新测试：移除梯度返佣相关测试用例，更新集成测试
- OpenAPI 文档：删除梯度返佣相关 schema 和枚举值
- 归档变更：归档 remove-tier-commission-redundancy 到 archive/2026-01-30-
- 同步规范：更新 4 个主 specs，标记废弃功能并添加迁移指引

原因：梯度返佣功能与一次性梯度佣金功能重复，且从未实现实际计算逻辑
迁移：使用一次性佣金的梯度模式 (OneTimeCommissionConfig.type = "tiered") 替代
 2026-01-30 14:57:24 +08:00
huang
409a68d60b feat: OpenAPI 契约对齐与框架优化
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m45s
Details 
主要变更：
1. OpenAPI 文档契约对齐
   - 统一错误响应字段名为 msg（非 message）
   - 规范 envelope 响应结构（code, msg, data, timestamp）
   - 个人客户路由纳入文档体系（使用 Register 机制）
   - 新增 BuildDocHandlers() 统一管理 handler 构造
   - 确保文档生成的幂等性

2. Service 层错误处理统一
   - 全面替换 fmt.Errorf 为 errors.New/Wrap
   - 统一错误码使用规范
   - Handler 层参数校验不泄露底层细节
   - 新增错误码验证集成测试

3. 代码质量提升
   - 删除未使用的 Task handler 和路由
   - 新增代码规范检查脚本（check-service-errors.sh）
   - 新增注释路径一致性检查（check-comment-paths.sh）
   - 更新 API 文档生成指南

4. OpenSpec 归档
   - 归档 openapi-contract-alignment 变更（63 tasks）
   - 归档 service-error-unify-core 变更
   - 归档 service-error-unify-support 变更
   - 归档 code-cleanup-docs-update 变更
   - 归档 handler-validation-security 变更
   - 同步 delta specs 到主规范文件

影响范围：
- pkg/openapi: 新增 handlers.go，优化 generator.go
- internal/service/*: 48 个 service 文件错误处理统一
- internal/handler/admin: 优化参数校验错误提示
- internal/routes: 个人客户路由改造，删除 task 路由
- scripts: 新增 3 个代码检查脚本
- docs: 更新 OpenAPI 文档（15750+ 行）
- openspec/specs: 同步 3 个主规范文件

破坏性变更：无
向后兼容：是
 2026-01-30 11:40:36 +08:00