feat: 卡网关按运营商账户限流并记录停复机调用

- 新增网关限流：按本系统运营商账户（卡 carrier_id）→ 限流组 → 操作限制每秒请求数，每次 HTTP 尝试计量，默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免；支持只统计与拦截两种模式，默认只统计
- Asynq 遇限流不计失败、固定短延迟重试；轮询任务与停复机业务重试遇限流短延迟重排
- 停机、复机不再使用网关内部重试，只发一次请求
- 网关返回结构化错误；新增上游错误分类规则表与测试接口
- 新增按月分区的停复机记录表：系统自动停复机只写记录，不再写统一审计与集成日志；普通轮询查询不再写集成日志
- 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口
- 迁移 000243~000246；同步 OpenSpec 提案（含后续 6 个 change）与技术方案、工程约束

cmd/api/docs.go

@@ -31,6 +31,8 @@ func generateOpenAPIDocs(outputPath string, logger *zap.Logger) {
 	handlers.BusinessUserGroup = admin.NewBusinessUserGroupHandler(nil, nil)
 	handlers.ShopBusinessOwnerImport = admin.NewShopBusinessOwnerImportHandler(nil)
 	handlers.PhoneAssetAssociation = admin.NewPhoneAssetAssociationHandler(nil, nil)
+	// 网关限流 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
+	handlers.GatewayRateLimit = admin.NewGatewayRateLimitHandler(nil, nil, nil)
 	// 套餐真流量预警 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
 	handlers.PackageTrafficAlert = admin.NewPackageTrafficAlertHandler(nil, nil, nil, nil)
 	// 资产钱包自动续费配置 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。

cmd/api/main.go

@@ -22,6 +22,7 @@ import (
 
 	"github.com/break/junhong_cmp_fiber/internal/bootstrap"
 	"github.com/break/junhong_cmp_fiber/internal/gateway"
+	"github.com/break/junhong_cmp_fiber/internal/infrastructure/gatewaylimit"
 	internalMiddleware "github.com/break/junhong_cmp_fiber/internal/middleware"
 	"github.com/break/junhong_cmp_fiber/internal/routes"
 	"github.com/break/junhong_cmp_fiber/internal/service/verification"
@@ -71,6 +72,11 @@ func main() {
 
 	// 9. 初始化 Gateway 客户端（可选）
 	gatewayClient := initGateway(cfg, appLogger)
+	// 卡网关调用按本系统运营商账户限流与统计（默认只统计不拦截）。
+	gatewayLimit := gatewaylimit.NewRuntime(db, redisClient, appLogger)
+	if gatewayClient != nil {
+		gatewayClient.SetCallGuard(gatewayLimit.Guard)
+	}
 
 	// 10. 初始化所有业务组件（通过 Bootstrap）
 	result, err := bootstrap.Bootstrap(&bootstrap.Dependencies{
@@ -83,6 +89,7 @@ func main() {
 		QueueClient:         queueClient,
 		StorageService:      storageSvc,
 		GatewayClient:       gatewayClient,
+		GatewayLimit:        gatewayLimit,
 	})
 	if err != nil {
 		appLogger.Fatal("初始化业务组件失败", zap.Error(err))