All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m46s
【核心变更】
1. 停复机逻辑统一(StopResumeService)
- 新增 EvaluateAndAct 统一入口,封装三条件停复机判断
- 停机条件:无套餐(no_package) / 流量耗尽(traffic_exhausted) / 未实名(not_realname)
- 复机条件:stop_reason 合规 + 有套餐且未耗尽 + 已实名或行业卡
- 修复设备套餐 Bug:hasValidPackage 按 device_id 查套餐,而非仅 iot_card_id
- 设备维度停复机加幂等锁(Redis SetNX,TTL 30s),防止多卡并发重复调 Gateway
2. Redis 分片队列(PollingQueueManager)
- 新建 queue_manager.go,封装所有轮询 Redis 操作
- 16 分片 Sorted Set,Key 格式:polling:shard:{shardID}:queue:{taskType}
- Lua 脚本原子出队(ZRANGEBYSCORE + 分批 ZREM),消除竞态窗口
- 新增背压检测:队列深度超 50 万时 Scheduler 跳过该分片
- RemoveFromAllQueues 覆盖 4 种任务类型(含 protect)
3. Handler 拆分(polling_handler.go 1360行 → 5个专注文件)
- polling_base.go:共享基类(并发控制/卡缓存/重入队)
- polling_realname_handler.go:实名采集,实名 0→1 时立即触发复机
- polling_carddata_handler.go:流量采集,保留跨月边界检测逻辑
- polling_package_handler.go:套餐采集,委托 EvaluateAndAct 决策
- polling_protect_handler.go:保护期一致性检查,保护期内强制修正
4. 配置管理(PollingConfigManager)
- 新建 config_manager.go,从 scheduler.go 提取配置职责
- 内存缓存 + 5 分钟定时刷新,刷新失败保留原缓存
- 修复 getCardCondition:停机卡返回 suspended,不再错配 activated 配置
5. 渐进式初始化(CardInitializer)
- 新建 initializer.go,分批加载(每批 10 万),批次间 sleep 500ms
- 过滤 enable_polling=false 的卡,初始化完成前 Scheduler 不出队
6. 卡生命周期服务(PollingLifecycleService)
- 新建 lifecycle_service.go,替代已删除的 callbacks.go 和 api_callback.go
- OnCardCreated/OnCardEnabled/OnCardStatusChanged 入队前检查 enable_polling
7. Scheduler 精简(1000+行 → 227行)
- 保留纯调度循环:scheduleLoop + processShardSchedule + enqueueBatch
- 保留每 10 秒触发套餐过期检测和流量重置
- 移除所有 DB 操作、配置加载、卡初始化逻辑
8. 轮询管控 API(enable_polling)
- 新增 PUT /api/admin/assets/:id/polling-status 接口
- 支持对设备/卡维度开关轮询,关闭后从所有分片队列移除
9. 数据库迁移
- 000103:tb_device 新增 enable_polling 字段(boolean, NOT NULL, DEFAULT true)
- 000104:新增 suspended 轮询配置,为 activated 配置补全 protect_check_interval
【文件统计】
- 新增:19 个文件(handler × 5、polling 组件 × 4、迁移 × 3 等)
- 修改:20 个文件(bootstrap 注入、store 接口、monitoring 适配分片等)
- 删除:3 个文件(polling_handler.go、callbacks.go、api_callback.go)
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
232 lines
6.8 KiB
Go
232 lines
6.8 KiB
Go
package admin
|
||
|
||
import (
|
||
"strconv"
|
||
|
||
"github.com/gofiber/fiber/v2"
|
||
|
||
dto "github.com/break/junhong_cmp_fiber/internal/model/dto"
|
||
assetService "github.com/break/junhong_cmp_fiber/internal/service/asset"
|
||
deviceService "github.com/break/junhong_cmp_fiber/internal/service/device"
|
||
iotCardService "github.com/break/junhong_cmp_fiber/internal/service/iot_card"
|
||
pollingSvc "github.com/break/junhong_cmp_fiber/internal/service/polling"
|
||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||
"github.com/break/junhong_cmp_fiber/pkg/middleware"
|
||
"github.com/break/junhong_cmp_fiber/pkg/response"
|
||
)
|
||
|
||
// AssetHandler 资产管理处理器
|
||
// 提供统一的资产解析、实时状态、套餐查询、停复机、轮询管控等接口
|
||
type AssetHandler struct {
|
||
assetService *assetService.Service
|
||
deviceService *deviceService.Service
|
||
iotCardStopResume *iotCardService.StopResumeService
|
||
assetPolling *pollingSvc.AssetPollingService
|
||
}
|
||
|
||
// NewAssetHandler 创建资产管理处理器
|
||
func NewAssetHandler(
|
||
assetSvc *assetService.Service,
|
||
deviceSvc *deviceService.Service,
|
||
iotCardStopResume *iotCardService.StopResumeService,
|
||
assetPolling *pollingSvc.AssetPollingService,
|
||
) *AssetHandler {
|
||
return &AssetHandler{
|
||
assetService: assetSvc,
|
||
deviceService: deviceSvc,
|
||
iotCardStopResume: iotCardStopResume,
|
||
assetPolling: assetPolling,
|
||
}
|
||
}
|
||
|
||
// Resolve 通过任意标识符解析资产(设备或卡)
|
||
// GET /api/admin/assets/resolve/:identifier
|
||
func (h *AssetHandler) Resolve(c *fiber.Ctx) error {
|
||
identifier := c.Params("identifier")
|
||
if identifier == "" {
|
||
return errors.New(errors.CodeInvalidParam, "标识符不能为空")
|
||
}
|
||
|
||
result, err := h.assetService.Resolve(c.UserContext(), identifier)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// RealtimeStatus 获取资产实时状态
|
||
// GET /api/admin/assets/:asset_type/:id/realtime-status
|
||
func (h *AssetHandler) RealtimeStatus(c *fiber.Ctx) error {
|
||
assetType := c.Params("asset_type")
|
||
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的资产ID")
|
||
}
|
||
|
||
result, err := h.assetService.GetRealtimeStatus(c.UserContext(), assetType, uint(id))
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// Refresh 刷新资产状态(调网关同步)
|
||
// POST /api/admin/assets/:asset_type/:id/refresh
|
||
func (h *AssetHandler) Refresh(c *fiber.Ctx) error {
|
||
// 企业账号只读,不允许主动触发运营商刷新
|
||
userType := middleware.GetUserTypeFromContext(c.UserContext())
|
||
if userType == constants.UserTypeEnterprise {
|
||
return errors.New(errors.CodeForbidden, "企业账号无权主动刷新资产状态")
|
||
}
|
||
assetType := c.Params("asset_type")
|
||
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的资产ID")
|
||
}
|
||
|
||
result, err := h.assetService.Refresh(c.UserContext(), assetType, uint(id))
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// Packages 获取资产所有套餐列表(支持分页,默认 page=1 pageSize=50)
|
||
// GET /api/admin/assets/:asset_type/:id/packages
|
||
func (h *AssetHandler) Packages(c *fiber.Ctx) error {
|
||
assetType := c.Params("asset_type")
|
||
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的资产ID")
|
||
}
|
||
|
||
page := c.QueryInt("page", 1)
|
||
pageSize := c.QueryInt("page_size", 50)
|
||
|
||
result, err := h.assetService.GetPackages(c.UserContext(), assetType, uint(id), page, pageSize)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// CurrentPackage 获取资产当前生效套餐
|
||
// GET /api/admin/assets/:asset_type/:id/current-package
|
||
func (h *AssetHandler) CurrentPackage(c *fiber.Ctx) error {
|
||
assetType := c.Params("asset_type")
|
||
id, err := strconv.ParseUint(c.Params("id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的资产ID")
|
||
}
|
||
|
||
result, err := h.assetService.GetCurrentPackage(c.UserContext(), assetType, uint(id))
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// StopDevice 设备停机(批量停机设备下所有已实名卡)
|
||
// POST /api/admin/assets/device/:device_id/stop
|
||
func (h *AssetHandler) StopDevice(c *fiber.Ctx) error {
|
||
deviceID, err := strconv.ParseUint(c.Params("device_id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的设备ID")
|
||
}
|
||
|
||
result, err := h.deviceService.StopDevice(c.UserContext(), uint(deviceID))
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, result)
|
||
}
|
||
|
||
// StartDevice 设备复机(批量复机设备下所有已实名卡)
|
||
// POST /api/admin/assets/device/:device_id/start
|
||
func (h *AssetHandler) StartDevice(c *fiber.Ctx) error {
|
||
deviceID, err := strconv.ParseUint(c.Params("device_id"), 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam, "无效的设备ID")
|
||
}
|
||
|
||
if err := h.deviceService.StartDevice(c.UserContext(), uint(deviceID)); err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, nil)
|
||
}
|
||
|
||
// StopCard 单卡停机(通过ICCID)
|
||
// POST /api/admin/assets/card/:iccid/stop
|
||
func (h *AssetHandler) StopCard(c *fiber.Ctx) error {
|
||
iccid := c.Params("iccid")
|
||
if iccid == "" {
|
||
return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
|
||
}
|
||
|
||
if err := h.iotCardStopResume.ManualStopCard(c.UserContext(), iccid); err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, nil)
|
||
}
|
||
|
||
// StartCard 单卡复机(通过ICCID)
|
||
// POST /api/admin/assets/card/:iccid/start
|
||
func (h *AssetHandler) StartCard(c *fiber.Ctx) error {
|
||
iccid := c.Params("iccid")
|
||
if iccid == "" {
|
||
return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
|
||
}
|
||
|
||
if err := h.iotCardStopResume.ManualStartCard(c.UserContext(), iccid); err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, nil)
|
||
}
|
||
|
||
// UpdatePollingStatus 更新资产轮询状态
|
||
// PATCH /api/admin/assets/:asset_type/:id/polling-status
|
||
func (h *AssetHandler) UpdatePollingStatus(c *fiber.Ctx) error {
|
||
assetType := c.Params("asset_type")
|
||
idStr := c.Params("id")
|
||
|
||
if assetType == "" || idStr == "" {
|
||
return errors.New(errors.CodeInvalidParam)
|
||
}
|
||
|
||
id, err := strconv.ParseUint(idStr, 10, 64)
|
||
if err != nil {
|
||
return errors.New(errors.CodeInvalidParam)
|
||
}
|
||
|
||
var req dto.UpdateAssetPollingStatusRequest
|
||
if err := c.BodyParser(&req); err != nil {
|
||
return errors.New(errors.CodeInvalidParam)
|
||
}
|
||
|
||
_ = middleware.GetUserIDFromContext(c.UserContext())
|
||
|
||
if h.assetPolling == nil {
|
||
return errors.New(errors.CodeInternalError, "轮询管控服务未配置")
|
||
}
|
||
|
||
if err := h.assetPolling.UpdatePollingStatus(c.UserContext(), assetType, uint(id), req.EnablePolling); err != nil {
|
||
return err
|
||
}
|
||
|
||
return response.Success(c, &dto.UpdateAssetPollingStatusResponse{
|
||
AssetType: assetType,
|
||
AssetID: uint(id),
|
||
EnablePolling: req.EnablePolling,
|
||
})
|
||
}
|