feat: 套餐系统升级 - Worker 重构、流量重置、文档与规范更新

- 重构 Worker 启动流程，引入 bootstrap 模块统一管理依赖注入
- 实现套餐流量重置服务（日/月/年周期重置）
- 新增套餐激活排队、加油包绑定、囤货待实名激活逻辑
- 新增订单创建幂等性防重（Redis 业务键 + 分布式锁）
- 更新 AGENTS.md/CLAUDE.md：新增注释规范、幂等性规范，移除测试要求
- 添加套餐系统升级完整文档（API文档、使用指南、功能总结、运维指南）
- 归档 OpenSpec package-system-upgrade 变更，同步 specs 到主目录
- 新增 queue types 抽象和 Redis 常量定义

internal/bootstrap/services.go

@@ -140,7 +140,7 @@ func initServices(s *stores, deps *Dependencies) *services {
 		ShopPackageBatchPricing:    shopPackageBatchPricingSvc.New(deps.DB, s.ShopPackageAllocation, s.ShopPackageAllocationPriceHistory, s.Shop),
 		CommissionStats:            commissionStatsSvc.New(s.ShopSeriesCommissionStats),
 		PurchaseValidation:         purchaseValidation,
-		Order:                      orderSvc.New(deps.DB, s.Order, s.OrderItem, s.Wallet, purchaseValidation, s.ShopPackageAllocation, s.ShopSeriesAllocation, s.IotCard, s.Device, s.PackageSeries, s.PackageUsage, s.Package, deps.WechatPayment, deps.QueueClient, deps.Logger),
+		Order:                      orderSvc.New(deps.DB, deps.Redis, s.Order, s.OrderItem, s.Wallet, purchaseValidation, s.ShopPackageAllocation, s.ShopSeriesAllocation, s.IotCard, s.Device, s.PackageSeries, s.PackageUsage, s.Package, deps.WechatPayment, deps.QueueClient, deps.Logger),
 		Recharge:                   rechargeSvc.New(deps.DB, s.Recharge, s.Wallet, s.WalletTransaction, s.IotCard, s.Device, s.ShopSeriesAllocation, s.PackageSeries, s.CommissionRecord, deps.Logger),
 		PollingConfig:              pollingSvc.NewConfigService(s.PollingConfig),
 		PollingConcurrency:         pollingSvc.NewConcurrencyService(s.PollingConcurrencyConfig, deps.Redis),

internal/bootstrap/worker.go

@@ -0,0 +1,56 @@
+package bootstrap
+
+import (
+	"github.com/hibiken/asynq"
+	"github.com/redis/go-redis/v9"
+	"go.uber.org/zap"
+	"gorm.io/gorm"
+
+	"github.com/break/junhong_cmp_fiber/internal/gateway"
+	"github.com/break/junhong_cmp_fiber/pkg/queue"
+	"github.com/break/junhong_cmp_fiber/pkg/storage"
+)
+
+// WorkerDependencies Worker 进程的基础依赖
+type WorkerDependencies struct {
+	DB             *gorm.DB
+	Redis          *redis.Client
+	Logger         *zap.Logger
+	AsynqClient    *asynq.Client    // Worker 特有：用于 Scheduler 提交任务
+	StorageService *storage.Service // 对象存储（可选）
+	GatewayClient  *gateway.Client  // Gateway 客户端（可选）
+}
+
+// WorkerBootstrapResult Worker Bootstrap 初始化结果
+type WorkerBootstrapResult = queue.WorkerBootstrapResult
+
+// WorkerStores 导出的 Worker Store 集合
+type WorkerStores = queue.WorkerStores
+
+// WorkerServices 导出的 Worker 服务集合
+type WorkerServices = queue.WorkerServices
+
+// BootstrapWorker 初始化 Worker 进程的所有组件
+//
+// 初始化顺序：
+//  1. 初始化 Worker Store 层（数据访问）
+//  2. 初始化 Worker Service 层（业务逻辑）
+//
+// 参数：
+//   - deps: Worker 基础依赖（DB, Redis, Logger, AsynqClient, StorageService, GatewayClient）
+//
+// 返回：
+//   - *WorkerBootstrapResult: 包含 Stores 和 Services
+//   - error: 初始化错误
+func BootstrapWorker(deps *WorkerDependencies) (*WorkerBootstrapResult, error) {
+	// 1. 初始化 Worker Store 层
+	stores := initWorkerStores(deps)
+
+	// 2. 初始化 Worker Service 层
+	services := initWorkerServices(stores, deps)
+
+	return &WorkerBootstrapResult{
+		Stores:   stores,
+		Services: services,
+	}, nil
+}

internal/bootstrap/worker_services.go

@@ -0,0 +1,89 @@
+package bootstrap
+
+import (
+	"github.com/break/junhong_cmp_fiber/internal/service/commission_calculation"
+	"github.com/break/junhong_cmp_fiber/internal/service/commission_stats"
+	packagepkg "github.com/break/junhong_cmp_fiber/internal/service/package"
+	pollingSvc "github.com/break/junhong_cmp_fiber/internal/service/polling"
+	"github.com/break/junhong_cmp_fiber/pkg/queue"
+)
+
+type workerServices struct {
+	CommissionCalculation *commission_calculation.Service
+	CommissionStats       *commission_stats.Service
+	UsageService          *packagepkg.UsageService
+	ActivationService     *packagepkg.ActivationService
+	ResetService          *packagepkg.ResetService
+	AlertService          *pollingSvc.AlertService
+	CleanupService        *pollingSvc.CleanupService
+}
+
+func initWorkerServices(stores *queue.WorkerStores, deps *WorkerDependencies) *queue.WorkerServices {
+	commissionStatsService := commission_stats.New(stores.ShopSeriesCommissionStats)
+
+	commissionCalculationService := commission_calculation.New(
+		deps.DB,
+		stores.CommissionRecord,
+		stores.Shop,
+		stores.ShopPackageAllocation,
+		stores.ShopSeriesAllocation,
+		stores.PackageSeries,
+		stores.IotCard,
+		stores.Device,
+		stores.Wallet,
+		stores.WalletTransaction,
+		stores.Order,
+		stores.OrderItem,
+		stores.Package,
+		stores.ShopSeriesCommissionStats,
+		commissionStatsService,
+		deps.Logger,
+	)
+
+	usageService := packagepkg.NewUsageService(
+		deps.DB,
+		deps.Redis,
+		stores.PackageUsage,
+		stores.PackageUsageDailyRecord,
+		deps.Logger,
+	)
+
+	activationService := packagepkg.NewActivationService(
+		deps.DB,
+		deps.Redis,
+		stores.PackageUsage,
+		stores.Package,
+		stores.PackageUsageDailyRecord,
+		deps.Logger,
+	)
+
+	resetService := packagepkg.NewResetService(
+		deps.DB,
+		deps.Redis,
+		stores.PackageUsage,
+		deps.Logger,
+	)
+
+	alertService := pollingSvc.NewAlertService(
+		stores.PollingAlertRule,
+		stores.PollingAlertHistory,
+		deps.Redis,
+		deps.Logger,
+	)
+
+	cleanupService := pollingSvc.NewCleanupService(
+		stores.DataCleanupConfig,
+		stores.DataCleanupLog,
+		deps.Logger,
+	)
+
+	return &queue.WorkerServices{
+		CommissionCalculation: commissionCalculationService,
+		CommissionStats:       commissionStatsService,
+		UsageService:          usageService,
+		ActivationService:     activationService,
+		ResetService:          resetService,
+		AlertService:          alertService,
+		CleanupService:        cleanupService,
+	}
+}

internal/bootstrap/worker_stores.go

@@ -0,0 +1,83 @@
+package bootstrap
+
+import (
+	"github.com/break/junhong_cmp_fiber/internal/store/postgres"
+	"github.com/break/junhong_cmp_fiber/pkg/queue"
+)
+
+type workerStores struct {
+	IotCardImportTask         *postgres.IotCardImportTaskStore
+	IotCard                   *postgres.IotCardStore
+	DeviceImportTask          *postgres.DeviceImportTaskStore
+	Device                    *postgres.DeviceStore
+	DeviceSimBinding          *postgres.DeviceSimBindingStore
+	ShopSeriesCommissionStats *postgres.ShopSeriesCommissionStatsStore
+	ShopPackageAllocation     *postgres.ShopPackageAllocationStore
+	CommissionRecord          *postgres.CommissionRecordStore
+	Shop                      *postgres.ShopStore
+	ShopSeriesAllocation      *postgres.ShopSeriesAllocationStore
+	PackageSeries             *postgres.PackageSeriesStore
+	Wallet                    *postgres.WalletStore
+	WalletTransaction         *postgres.WalletTransactionStore
+	Order                     *postgres.OrderStore
+	OrderItem                 *postgres.OrderItemStore
+	Package                   *postgres.PackageStore
+	PackageUsage              *postgres.PackageUsageStore
+	PackageUsageDailyRecord   *postgres.PackageUsageDailyRecordStore
+	PollingAlertRule          *postgres.PollingAlertRuleStore
+	PollingAlertHistory       *postgres.PollingAlertHistoryStore
+	DataCleanupConfig         *postgres.DataCleanupConfigStore
+	DataCleanupLog            *postgres.DataCleanupLogStore
+}
+
+func initWorkerStores(deps *WorkerDependencies) *queue.WorkerStores {
+	stores := &workerStores{
+		IotCardImportTask:         postgres.NewIotCardImportTaskStore(deps.DB, deps.Redis),
+		IotCard:                   postgres.NewIotCardStore(deps.DB, deps.Redis),
+		DeviceImportTask:          postgres.NewDeviceImportTaskStore(deps.DB, deps.Redis),
+		Device:                    postgres.NewDeviceStore(deps.DB, deps.Redis),
+		DeviceSimBinding:          postgres.NewDeviceSimBindingStore(deps.DB, deps.Redis),
+		ShopSeriesCommissionStats: postgres.NewShopSeriesCommissionStatsStore(deps.DB),
+		ShopPackageAllocation:     postgres.NewShopPackageAllocationStore(deps.DB),
+		CommissionRecord:          postgres.NewCommissionRecordStore(deps.DB, deps.Redis),
+		Shop:                      postgres.NewShopStore(deps.DB, deps.Redis),
+		ShopSeriesAllocation:      postgres.NewShopSeriesAllocationStore(deps.DB),
+		PackageSeries:             postgres.NewPackageSeriesStore(deps.DB),
+		Wallet:                    postgres.NewWalletStore(deps.DB, deps.Redis),
+		WalletTransaction:         postgres.NewWalletTransactionStore(deps.DB, deps.Redis),
+		Order:                     postgres.NewOrderStore(deps.DB, deps.Redis),
+		OrderItem:                 postgres.NewOrderItemStore(deps.DB, deps.Redis),
+		Package:                   postgres.NewPackageStore(deps.DB),
+		PackageUsage:              postgres.NewPackageUsageStore(deps.DB, deps.Redis),
+		PackageUsageDailyRecord:   postgres.NewPackageUsageDailyRecordStore(deps.DB, deps.Redis),
+		PollingAlertRule:          postgres.NewPollingAlertRuleStore(deps.DB),
+		PollingAlertHistory:       postgres.NewPollingAlertHistoryStore(deps.DB),
+		DataCleanupConfig:         postgres.NewDataCleanupConfigStore(deps.DB),
+		DataCleanupLog:            postgres.NewDataCleanupLogStore(deps.DB),
+	}
+
+	return &queue.WorkerStores{
+		IotCardImportTask:         stores.IotCardImportTask,
+		IotCard:                   stores.IotCard,
+		DeviceImportTask:          stores.DeviceImportTask,
+		Device:                    stores.Device,
+		DeviceSimBinding:          stores.DeviceSimBinding,
+		ShopSeriesCommissionStats: stores.ShopSeriesCommissionStats,
+		ShopPackageAllocation:     stores.ShopPackageAllocation,
+		CommissionRecord:          stores.CommissionRecord,
+		Shop:                      stores.Shop,
+		ShopSeriesAllocation:      stores.ShopSeriesAllocation,
+		PackageSeries:             stores.PackageSeries,
+		Wallet:                    stores.Wallet,
+		WalletTransaction:         stores.WalletTransaction,
+		Order:                     stores.Order,
+		OrderItem:                 stores.OrderItem,
+		Package:                   stores.Package,
+		PackageUsage:              stores.PackageUsage,
+		PackageUsageDailyRecord:   stores.PackageUsageDailyRecord,
+		PollingAlertRule:          stores.PollingAlertRule,
+		PollingAlertHistory:       stores.PollingAlertHistory,
+		DataCleanupConfig:         stores.DataCleanupConfig,
+		DataCleanupLog:            stores.DataCleanupLog,
+	}
+}