user

type CreateUserRequest struct {
	Username       string            `json:"username"`
	Password       string            `json:"password"`
	Email          string            `json:"email,omitempty"`
	Level          Level             `json:"level,omitempty"`
	Quota          int64             `json:"quota,omitempty"`
	ExpireDays     int               `json:"expire_days,omitempty"`
	MaxConnections int               `json:"max_connections,omitempty"`
	SpeedLimit     int64             `json:"speed_limit,omitempty"`
	Metadata       map[string]string `json:"metadata,omitempty"`
}

type Level int

type ListOptions struct {
	Offset        int
	Limit         int
	SortBy        string
	SortOrder     string // "asc" or "desc"
	FilterLevel   *Level
	FilterEnabled *bool
}

type MemoryStore struct {
	// contains filtered or unexported fields
}

type SQLiteStore struct {
	// contains filtered or unexported fields
}

type Store interface {
	// Create creates a new user.
	Create(ctx context.Context, user *User) error

	// Get retrieves a user by ID.
	Get(ctx context.Context, id string) (*User, error)

	// GetByUsername retrieves a user by username.
	GetByUsername(ctx context.Context, username string) (*User, error)

	// GetByUUID retrieves a user by UUID.
	GetByUUID(ctx context.Context, uuid string) (*User, error)

	// Update updates an existing user.
	Update(ctx context.Context, user *User) error

	// Delete deletes a user by ID.
	Delete(ctx context.Context, id string) error

	// List returns all users with optional pagination.
	List(ctx context.Context, offset, limit int) ([]*User, int, error)

	// Count returns the total number of users.
	Count(ctx context.Context) (int, error)

	// Search searches users by username or email.
	Search(ctx context.Context, query string, offset, limit int) ([]*User, int, error)

	// UpdateTraffic updates a user's traffic counters.
	UpdateTraffic(ctx context.Context, id string, upload, download int64) error

	// ResetTraffic resets a user's traffic counters.
	ResetTraffic(ctx context.Context, id string) error

	// ResetAllTraffic resets all users' traffic counters.
	ResetAllTraffic(ctx context.Context) error

	// GetActiveUsers returns all active users.
	GetActiveUsers(ctx context.Context) ([]*User, error)

	// Close closes the store.
	Close() error
}

type TrafficLog struct {
	ID        int64     `json:"id"`
	UserID    string    `json:"user_id"`
	Upload    int64     `json:"upload"`
	Download  int64     `json:"download"`
	Timestamp time.Time `json:"timestamp"`
}

type TrafficStats struct {
	UserID      string    `json:"user_id"`
	Upload      int64     `json:"upload"`
	Download    int64     `json:"download"`
	Total       int64     `json:"total"`
	Quota       int64     `json:"quota"`
	Remaining   int64     `json:"remaining"`
	LastUpdated time.Time `json:"last_updated"`
}

type UpdateUserRequest struct {
	Email          *string           `json:"email,omitempty"`
	Password       *string           `json:"password,omitempty"`
	Level          *Level            `json:"level,omitempty"`
	Quota          *int64            `json:"quota,omitempty"`
	Enabled        *bool             `json:"enabled,omitempty"`
	ExpireAt       *time.Time        `json:"expire_at,omitempty"`
	MaxConnections *int              `json:"max_connections,omitempty"`
	SpeedLimit     *int64            `json:"speed_limit,omitempty"`
	AllowedIPs     []string          `json:"allowed_ips,omitempty"`
	Metadata       map[string]string `json:"metadata,omitempty"`
}

type User struct {
	// ID is the unique identifier for the user.
	ID string `json:"id"`

	// Username is the login name.
	Username string `json:"username"`

	// PasswordHash is the bcrypt hash of the password.
	PasswordHash string `json:"-"`

	// Email is the user's email address.
	Email string `json:"email,omitempty"`

	// UUID is used for VMess/VLESS authentication.
	UUID string `json:"uuid"`

	// Level is the user's privilege level.
	Level Level `json:"level"`

	// Quota is the traffic quota in bytes (0 = unlimited).
	Quota int64 `json:"quota"`

	// UsedUpload is the total uploaded bytes.
	UsedUpload int64 `json:"used_upload"`

	// UsedDownload is the total downloaded bytes.
	UsedDownload int64 `json:"used_download"`

	// ExpireAt is when the account expires (zero = never).
	ExpireAt time.Time `json:"expire_at,omitempty"`

	// Enabled indicates if the account is active.
	Enabled bool `json:"enabled"`

	// MaxConnections is the maximum concurrent connections (0 = unlimited).
	MaxConnections int `json:"max_connections"`

	// SpeedLimit is the speed limit in bytes per second (0 = unlimited).
	SpeedLimit int64 `json:"speed_limit"`

	// AllowedIPs is a list of allowed client IP addresses (empty = all).
	AllowedIPs []string `json:"allowed_ips,omitempty"`

	// Metadata holds additional user data.
	Metadata map[string]string `json:"metadata,omitempty"`

	// CreatedAt is when the account was created.
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the account was last updated.
	UpdatedAt time.Time `json:"updated_at"`

	// LastLoginAt is when the user last logged in.
	LastLoginAt time.Time `json:"last_login_at,omitempty"`

	// LastLoginIP is the IP address of the last login.
	LastLoginIP string `json:"last_login_ip,omitempty"`
}