Features:

- Node group CRUD operations with traffic-based filtering
  - Three grouping modes: average distribution, subscription-based, and traffic-based
  - Automatic and manual group recalculation with history tracking
  - Group assignment preview before applying changes
  - User subscription group locking to prevent automatic reassignment
  - Subscribe-to-group mapping configuration
  - Group calculation history and detailed reports
  - System configuration for group management (enabled/mode/auto_create)

  Database:
  - Add node_group table for group definitions
  - Add group_history and group_history_detail tables for tracking
  - Add node_group_ids (JSON) to nodes and subscribe tables
  - Add node_group_id and group_locked fields to user_subscribe table
  - Add migration files for schema changes

internal/model/group/history.go

@@ -0,0 +1,54 @@
+package group
+
+import (
+	"time"
+
+	"gorm.io/gorm"
+)
+
+// GroupHistory 分组历史记录模型
+type GroupHistory struct {
+	Id           int64      `gorm:"primaryKey"`
+	GroupMode    string     `gorm:"type:varchar(50);not null;index:idx_group_mode;comment:Group Mode: average/subscribe/traffic"`
+	TriggerType  string     `gorm:"type:varchar(50);not null;index:idx_trigger_type;comment:Trigger Type: manual/auto/schedule"`
+	State        string     `gorm:"type:varchar(50);not null;index:idx_state;comment:State: pending/running/completed/failed"`
+	TotalUsers   int        `gorm:"default:0;not null;comment:Total Users"`
+	SuccessCount int        `gorm:"default:0;not null;comment:Success Count"`
+	FailedCount  int        `gorm:"default:0;not null;comment:Failed Count"`
+	StartTime    *time.Time `gorm:"comment:Start Time"`
+	EndTime      *time.Time `gorm:"comment:End Time"`
+	Operator     string     `gorm:"type:varchar(100);comment:Operator"`
+	ErrorMessage string     `gorm:"type:TEXT;comment:Error Message"`
+	CreatedAt    time.Time  `gorm:"<-:create;index:idx_created_at;comment:Create Time"`
+}
+
+// TableName 指定表名
+func (*GroupHistory) TableName() string {
+	return "group_history"
+}
+
+// BeforeCreate GORM hook - 创建前回调
+func (gh *GroupHistory) BeforeCreate(tx *gorm.DB) error {
+	return nil
+}
+
+// GroupHistoryDetail 分组历史详情模型
+type GroupHistoryDetail struct {
+	Id          int64     `gorm:"primaryKey"`
+	HistoryId   int64     `gorm:"not null;index:idx_history_id;comment:History ID"`
+	NodeGroupId int64     `gorm:"not null;index:idx_node_group_id;comment:Node Group ID"`
+	UserCount   int       `gorm:"default:0;not null;comment:User Count"`
+	NodeCount   int       `gorm:"default:0;not null;comment:Node Count"`
+	UserData    string    `gorm:"type:text;comment:User data JSON (id and email/phone)"`
+	CreatedAt   time.Time `gorm:"<-:create;comment:Create Time"`
+}
+
+// TableName 指定表名
+func (*GroupHistoryDetail) TableName() string {
+	return "group_history_detail"
+}
+
+// BeforeCreate GORM hook - 创建前回调
+func (ghd *GroupHistoryDetail) BeforeCreate(tx *gorm.DB) error {
+	return nil
+}

internal/model/group/model.go

@@ -0,0 +1,14 @@
+package group
+
+import (
+	"gorm.io/gorm"
+)
+
+// AutoMigrate 自动迁移数据库表
+func AutoMigrate(db *gorm.DB) error {
+	return db.AutoMigrate(
+		&NodeGroup{},
+		&GroupHistory{},
+		&GroupHistoryDetail{},
+	)
+}

internal/model/group/node_group.go

@@ -0,0 +1,30 @@
+package group
+
+import (
+	"time"
+
+	"gorm.io/gorm"
+)
+
+// NodeGroup 节点组模型
+type NodeGroup struct {
+	Id             int64     `gorm:"primaryKey"`
+	Name           string    `gorm:"type:varchar(255);not null;comment:Name"`
+	Description    string    `gorm:"type:varchar(500);comment:Description"`
+	Sort           int       `gorm:"default:0;index:idx_sort;comment:Sort Order"`
+	ForCalculation *bool     `gorm:"default:true;not null;comment:For Calculation: whether this node group participates in grouping calculation"`
+	MinTrafficGB   *int64    `gorm:"default:0;comment:Minimum Traffic (GB) for this node group"`
+	MaxTrafficGB   *int64    `gorm:"default:0;comment:Maximum Traffic (GB) for this node group"`
+	CreatedAt      time.Time `gorm:"<-:create;comment:Create Time"`
+	UpdatedAt      time.Time `gorm:"comment:Update Time"`
+}
+
+// TableName 指定表名
+func (*NodeGroup) TableName() string {
+	return "node_group"
+}
+
+// BeforeCreate GORM hook - 创建前回调
+func (ng *NodeGroup) BeforeCreate(tx *gorm.DB) error {
+	return nil
+}