feat: 新增数据库迁移，重命名 device_no 为 virtual_no，新增 iot_card.virtual_no 和 package.virtual_ratio 字段

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

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

internal/handler/admin/asset.go

@@ -0,0 +1,186 @@
+package admin
+
+import (
+	"strconv"
+
+	"github.com/gofiber/fiber/v2"
+
+	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"
+	"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
+}
+
+// NewAssetHandler 创建资产管理处理器
+func NewAssetHandler(
+	assetSvc *assetService.Service,
+	deviceSvc *deviceService.Service,
+	iotCardStopResume *iotCardService.StopResumeService,
+) *AssetHandler {
+	return &AssetHandler{
+		assetService:      assetSvc,
+		deviceService:     deviceSvc,
+		iotCardStopResume: iotCardStopResume,
+	}
+}
+
+// Resolve 通过任意标识符解析资产（设备或卡）
+// GET /api/admin/assets/resolve/:identifier
+func (h *AssetHandler) Resolve(c *fiber.Ctx) error {
+	userType := middleware.GetUserTypeFromContext(c.UserContext())
+	if userType == constants.UserTypeEnterprise {
+		return errors.New(errors.CodeForbidden, "企业账号暂不支持此接口")
+	}
+
+	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 {
+	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 获取资产所有套餐列表
+// 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")
+	}
+
+	result, err := h.assetService.GetPackages(c.UserContext(), assetType, uint(id))
+	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)
+}

internal/handler/admin/device.go

@@ -37,37 +37,6 @@ func (h *DeviceHandler) List(c *fiber.Ctx) error {
 	return response.SuccessWithPagination(c, result.List, result.Total, result.Page, result.PageSize)
 }
 
-func (h *DeviceHandler) GetByID(c *fiber.Ctx) error {
-	idStr := c.Params("id")
-	id, err := strconv.ParseUint(idStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "无效的设备ID")
-	}
-
-	result, err := h.service.Get(c.UserContext(), uint(id))
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, result)
-}
-
-// GetByIdentifier 通过标识符查询设备详情
-// GET /api/admin/devices/by-identifier/:identifier
-func (h *DeviceHandler) GetByIdentifier(c *fiber.Ctx) error {
-	identifier := c.Params("identifier")
-	if identifier == "" {
-		return errors.New(errors.CodeInvalidParam, "设备标识符不能为空")
-	}
-
-	result, err := h.service.GetByIdentifier(c.UserContext(), identifier)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, result)
-}
-
 func (h *DeviceHandler) Delete(c *fiber.Ctx) error {
 	userType := middleware.GetUserTypeFromContext(c.UserContext())
 	if userType != constants.UserTypeSuperAdmin && userType != constants.UserTypePlatform {
@@ -223,22 +192,6 @@ func (h *DeviceHandler) BatchSetSeriesBinding(c *fiber.Ctx) error {
 	return response.Success(c, result)
 }
 
-// GetGatewayInfo 查询设备信息
-// GET /api/admin/devices/by-identifier/:identifier/gateway-info
-func (h *DeviceHandler) GetGatewayInfo(c *fiber.Ctx) error {
-	identifier := c.Params("identifier")
-	if identifier == "" {
-		return errors.New(errors.CodeInvalidParam, "设备标识符不能为空")
-	}
-
-	resp, err := h.service.GatewayGetDeviceInfo(c.UserContext(), identifier)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, resp)
-}
-
 // GetGatewaySlots 查询设备卡槽信息
 // GET /api/admin/devices/by-identifier/:identifier/gateway-slots
 func (h *DeviceHandler) GetGatewaySlots(c *fiber.Ctx) error {

internal/handler/admin/enterprise_card.go

@@ -78,43 +78,3 @@ func (h *EnterpriseCardHandler) ListCards(c *fiber.Ctx) error {
 
 	return response.SuccessWithPagination(c, result.Items, result.Total, result.Page, result.Size)
 }
-
-func (h *EnterpriseCardHandler) SuspendCard(c *fiber.Ctx) error {
-	enterpriseIDStr := c.Params("id")
-	enterpriseID, err := strconv.ParseUint(enterpriseIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "无效的企业ID")
-	}
-
-	cardIDStr := c.Params("card_id")
-	cardID, err := strconv.ParseUint(cardIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "无效的卡ID")
-	}
-
-	if err := h.service.SuspendCard(c.UserContext(), uint(enterpriseID), uint(cardID)); err != nil {
-		return err
-	}
-
-	return response.Success(c, nil)
-}
-
-func (h *EnterpriseCardHandler) ResumeCard(c *fiber.Ctx) error {
-	enterpriseIDStr := c.Params("id")
-	enterpriseID, err := strconv.ParseUint(enterpriseIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "无效的企业ID")
-	}
-
-	cardIDStr := c.Params("card_id")
-	cardID, err := strconv.ParseUint(cardIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "无效的卡ID")
-	}
-
-	if err := h.service.ResumeCard(c.UserContext(), uint(enterpriseID), uint(cardID)); err != nil {
-		return err
-	}
-
-	return response.Success(c, nil)
-}

internal/handler/admin/iot_card.go

@@ -35,20 +35,6 @@ func (h *IotCardHandler) ListStandalone(c *fiber.Ctx) error {
 	return response.SuccessWithPagination(c, result.List, result.Total, result.Page, result.PageSize)
 }
 
-func (h *IotCardHandler) GetByICCID(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	result, err := h.service.GetByICCID(c.UserContext(), iccid)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, result)
-}
-
 func (h *IotCardHandler) AllocateCards(c *fiber.Ctx) error {
 	var req dto.AllocateStandaloneCardsRequest
 	if err := c.BodyParser(&req); err != nil {
@@ -126,51 +112,6 @@ func (h *IotCardHandler) BatchSetSeriesBinding(c *fiber.Ctx) error {
 	return response.Success(c, result)
 }
 
-// GetGatewayStatus 查询卡实时状态
-func (h *IotCardHandler) GetGatewayStatus(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	resp, err := h.service.GatewayQueryCardStatus(c.UserContext(), iccid)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, resp)
-}
-
-// GetGatewayFlow 查询流量使用情况
-func (h *IotCardHandler) GetGatewayFlow(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	resp, err := h.service.GatewayQueryFlow(c.UserContext(), iccid)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, resp)
-}
-
-// GetGatewayRealname 查询实名认证状态
-func (h *IotCardHandler) GetGatewayRealname(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	resp, err := h.service.GatewayQueryRealnameStatus(c.UserContext(), iccid)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, resp)
-}
-
 // GetRealnameLink 获取实名认证链接
 func (h *IotCardHandler) GetRealnameLink(c *fiber.Ctx) error {
 	iccid := c.Params("iccid")
@@ -185,31 +126,3 @@ func (h *IotCardHandler) GetRealnameLink(c *fiber.Ctx) error {
 
 	return response.Success(c, link)
 }
-
-// StopCard 停止卡服务
-func (h *IotCardHandler) StopCard(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	if err := h.service.GatewayStopCard(c.UserContext(), iccid); err != nil {
-		return err
-	}
-
-	return response.Success(c, nil)
-}
-
-// StartCard 恢复卡服务
-func (h *IotCardHandler) StartCard(c *fiber.Ctx) error {
-	iccid := c.Params("iccid")
-	if iccid == "" {
-		return errors.New(errors.CodeInvalidParam, "ICCID不能为空")
-	}
-
-	if err := h.service.GatewayStartCard(c.UserContext(), iccid); err != nil {
-		return err
-	}
-
-	return response.Success(c, nil)
-}

internal/handler/h5/enterprise_device.go

@@ -26,9 +26,9 @@ func (h *EnterpriseDeviceHandler) ListDevices(c *fiber.Ctx) error {
 	}
 
 	serviceReq := &dto.EnterpriseDeviceListReq{
-		Page:     req.Page,
-		PageSize: req.PageSize,
-		DeviceNo: req.DeviceNo,
+		Page:      req.Page,
+		PageSize:  req.PageSize,
+		VirtualNo: req.VirtualNo,
 	}
 
 	result, err := h.service.ListDevicesForEnterprise(c.UserContext(), serviceReq)
@@ -53,55 +53,3 @@ func (h *EnterpriseDeviceHandler) GetDeviceDetail(c *fiber.Ctx) error {
 
 	return response.Success(c, result)
 }
-
-func (h *EnterpriseDeviceHandler) SuspendCard(c *fiber.Ctx) error {
-	deviceIDStr := c.Params("device_id")
-	deviceID, err := strconv.ParseUint(deviceIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "设备ID格式错误")
-	}
-
-	cardIDStr := c.Params("card_id")
-	cardID, err := strconv.ParseUint(cardIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "卡ID格式错误")
-	}
-
-	var req dto.DeviceCardOperationReq
-	if err := c.BodyParser(&req); err != nil {
-		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
-	}
-
-	result, err := h.service.SuspendCard(c.UserContext(), uint(deviceID), uint(cardID), &req)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, result)
-}
-
-func (h *EnterpriseDeviceHandler) ResumeCard(c *fiber.Ctx) error {
-	deviceIDStr := c.Params("device_id")
-	deviceID, err := strconv.ParseUint(deviceIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "设备ID格式错误")
-	}
-
-	cardIDStr := c.Params("card_id")
-	cardID, err := strconv.ParseUint(cardIDStr, 10, 64)
-	if err != nil {
-		return errors.New(errors.CodeInvalidParam, "卡ID格式错误")
-	}
-
-	var req dto.DeviceCardOperationReq
-	if err := c.BodyParser(&req); err != nil {
-		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
-	}
-
-	result, err := h.service.ResumeCard(c.UserContext(), uint(deviceID), uint(cardID), &req)
-	if err != nil {
-		return err
-	}
-
-	return response.Success(c, result)
-}