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/service/iot_card/stop_resume_service.go

@@ -8,22 +8,25 @@ import (
 	"go.uber.org/zap"
 	"gorm.io/gorm"
 
+	stderrors "errors"
+
 	"github.com/break/junhong_cmp_fiber/internal/gateway"
 	"github.com/break/junhong_cmp_fiber/internal/model"
 	"github.com/break/junhong_cmp_fiber/internal/store/postgres"
 	"github.com/break/junhong_cmp_fiber/pkg/constants"
+	"github.com/break/junhong_cmp_fiber/pkg/errors"
 )
 
 // StopResumeService 停复机服务
-// 任务 24.2: 处理 IoT 卡的自动停机和复机逻辑
+// 处理 IoT 卡的自动停机、复机和手动停复机逻辑
 type StopResumeService struct {
-	db            *gorm.DB
-	redis         *redis.Client
-	iotCardStore  *postgres.IotCardStore
-	gatewayClient *gateway.Client
-	logger        *zap.Logger
+	db                    *gorm.DB
+	redis                 *redis.Client
+	iotCardStore          *postgres.IotCardStore
+	deviceSimBindingStore *postgres.DeviceSimBindingStore
+	gatewayClient         *gateway.Client
+	logger                *zap.Logger
 
-	// 重试配置
 	maxRetries    int
 	retryInterval time.Duration
 }
@@ -33,17 +36,19 @@ func NewStopResumeService(
 	db *gorm.DB,
 	redis *redis.Client,
 	iotCardStore *postgres.IotCardStore,
+	deviceSimBindingStore *postgres.DeviceSimBindingStore,
 	gatewayClient *gateway.Client,
 	logger *zap.Logger,
 ) *StopResumeService {
 	return &StopResumeService{
-		db:            db,
-		redis:         redis,
-		iotCardStore:  iotCardStore,
-		gatewayClient: gatewayClient,
-		logger:        logger,
-		maxRetries:    3,               // 默认最多重试 3 次
-		retryInterval: 2 * time.Second, // 默认重试间隔 2 秒
+		db:                    db,
+		redis:                 redis,
+		iotCardStore:          iotCardStore,
+		deviceSimBindingStore: deviceSimBindingStore,
+		gatewayClient:         gatewayClient,
+		logger:                logger,
+		maxRetries:            3,
+		retryInterval:         2 * time.Second,
 	}
 }
 
@@ -233,3 +238,75 @@ func (s *StopResumeService) resumeCardWithRetry(ctx context.Context, card *model
 
 	return lastErr
 }
+
+// ManualStopCard 手动停机单张卡（通过ICCID）
+func (s *StopResumeService) ManualStopCard(ctx context.Context, iccid string) error {
+	card, err := s.iotCardStore.GetByICCID(ctx, iccid)
+	if err != nil {
+		return errors.New(errors.CodeNotFound, "卡不存在")
+	}
+
+	if card.RealNameStatus != constants.RealNameStatusVerified {
+		return errors.New(errors.CodeForbidden, "卡未实名，无法操作")
+	}
+
+	// 检查绑定设备是否在复机保护期
+	if s.deviceSimBindingStore != nil && s.redis != nil {
+		binding, bindErr := s.deviceSimBindingStore.GetActiveBindingByCardID(ctx, card.ID)
+		if bindErr == nil && binding != nil {
+			exists, _ := s.redis.Exists(ctx, constants.RedisDeviceProtectKey(binding.DeviceID, "start")).Result()
+			if exists > 0 {
+				return errors.New(errors.CodeForbidden, "设备复机保护期内，禁止停机")
+			}
+		} else if bindErr != nil && !stderrors.Is(bindErr, gorm.ErrRecordNotFound) {
+			return errors.Wrap(errors.CodeInternalError, bindErr, "查询卡绑定关系失败")
+		}
+	}
+
+	if err := s.stopCardWithRetry(ctx, card); err != nil {
+		return errors.Wrap(errors.CodeInternalError, err, "调网关停机失败")
+	}
+
+	now := time.Now()
+	return s.db.WithContext(ctx).Model(card).Updates(map[string]any{
+		"network_status": constants.NetworkStatusOffline,
+		"stopped_at":     now,
+		"stop_reason":    constants.StopReasonManual,
+	}).Error
+}
+
+// ManualStartCard 手动复机单张卡（通过ICCID）
+func (s *StopResumeService) ManualStartCard(ctx context.Context, iccid string) error {
+	card, err := s.iotCardStore.GetByICCID(ctx, iccid)
+	if err != nil {
+		return errors.New(errors.CodeNotFound, "卡不存在")
+	}
+
+	if card.RealNameStatus != constants.RealNameStatusVerified {
+		return errors.New(errors.CodeForbidden, "卡未实名，无法操作")
+	}
+
+	// 检查绑定设备是否在停机保护期
+	if s.deviceSimBindingStore != nil && s.redis != nil {
+		binding, bindErr := s.deviceSimBindingStore.GetActiveBindingByCardID(ctx, card.ID)
+		if bindErr == nil && binding != nil {
+			exists, _ := s.redis.Exists(ctx, constants.RedisDeviceProtectKey(binding.DeviceID, "stop")).Result()
+			if exists > 0 {
+				return errors.New(errors.CodeForbidden, "设备停机保护期内，禁止复机")
+			}
+		} else if bindErr != nil && !stderrors.Is(bindErr, gorm.ErrRecordNotFound) {
+			return errors.Wrap(errors.CodeInternalError, bindErr, "查询卡绑定关系失败")
+		}
+	}
+
+	if err := s.resumeCardWithRetry(ctx, card); err != nil {
+		return errors.Wrap(errors.CodeInternalError, err, "调网关复机失败")
+	}
+
+	now := time.Now()
+	return s.db.WithContext(ctx).Model(card).Updates(map[string]any{
+		"network_status": constants.NetworkStatusOnline,
+		"resumed_at":     now,
+		"stop_reason":    "",
+	}).Error
+}