hyapp-server/services/user-service/internal/domain/user/user.go

package user

import "regexp"

// Status 是用户主状态，业务服务只应该依赖这里的稳定语义。
type Status string

const (
	// StatusActive 表示用户可以正常登录和参与业务。
	StatusActive Status = "active"
	// StatusDisabled 表示用户被平台禁用。
	StatusDisabled Status = "disabled"
	// StatusBanned 表示用户被封禁。
	StatusBanned Status = "banned"
)

// DisplayUserIDStatus 表达短号历史记录状态。
type DisplayUserIDStatus string

const (
	// DisplayUserIDStatusActive 表示当前可被普通业务解析的短号归属。
	DisplayUserIDStatusActive DisplayUserIDStatus = "active"
	// DisplayUserIDStatusHeld 表示默认短号仍归用户所有，但被临时靓号覆盖。
	DisplayUserIDStatusHeld DisplayUserIDStatus = "held"
	// DisplayUserIDStatusExpired 表示临时靓号租约已经到期。
	DisplayUserIDStatusExpired DisplayUserIDStatus = "expired"
	// DisplayUserIDStatusReleased 表示短号曾经属于用户，但已经释放。
	DisplayUserIDStatusReleased DisplayUserIDStatus = "released"
	// DisplayUserIDStatusReserved 表示短号被系统预留，不能被普通用户占用。
	DisplayUserIDStatusReserved DisplayUserIDStatus = "reserved"
	// DisplayUserIDStatusBlocked 表示短号被运营阻断，不能分配。
	DisplayUserIDStatusBlocked DisplayUserIDStatus = "blocked"
)

// DisplayUserIDKind 表达当前展示号来源。
type DisplayUserIDKind string

const (
	// DisplayUserIDKindDefault 表示当前展示号来自用户永久默认短号。
	DisplayUserIDKindDefault DisplayUserIDKind = "default"
	// DisplayUserIDKindPretty 表示当前展示号来自有效临时靓号租约。
	DisplayUserIDKindPretty DisplayUserIDKind = "pretty"
)

// PrettyLeaseStatus 表达临时靓号租约生命周期。
type PrettyLeaseStatus string

const (
	// PrettyLeaseStatusActive 表示租约当前覆盖用户展示号。
	PrettyLeaseStatusActive PrettyLeaseStatus = "active"
	// PrettyLeaseStatusExpired 表示租约已按到期流程恢复默认短号。
	PrettyLeaseStatusExpired PrettyLeaseStatus = "expired"
	// PrettyLeaseStatusCancelled 表示租约被业务主动取消。
	PrettyLeaseStatusCancelled PrettyLeaseStatus = "cancelled"
	// PrettyLeaseStatusRefunded 表示租约被退款终止。
	PrettyLeaseStatusRefunded PrettyLeaseStatus = "refunded"
)

var displayUserIDPattern = regexp.MustCompile(`^[1-9][0-9]{5,10}$`)

// User 是 user-service 的主数据实体。
// 首版只保留全局身份和状态，不包含资料、关系链或房间内临时态。
type User struct {
	UserID                          int64
	DefaultDisplayUserID            string
	CurrentDisplayUserID            string
	CurrentDisplayUserIDKind        DisplayUserIDKind
	CurrentDisplayUserIDExpiresAtMs int64
	Status                          Status
	CreatedAtMs                     int64
	UpdatedAtMs                     int64
}

// Identity 是 user_id 与当前 active display_user_id 的绑定投影。
type Identity struct {
	UserID                   int64
	DisplayUserID            string
	DefaultDisplayUserID     string
	DisplayUserIDKind        DisplayUserIDKind
	DisplayUserIDExpiresAtMs int64
	Status                   DisplayUserIDStatus
}

// DisplayUserIDChangeCommand 描述短号变更的事务输入。
type DisplayUserIDChangeCommand struct {
	UserID           int64
	NewDisplayUserID string
	Reason           string
	OperatorUserID   int64
	RequestID        string
	ChangedAtMs      int64
	CooldownMs       int64
}

// PrettyDisplayUserIDLease 是临时靓号覆盖关系的事实记录。
type PrettyDisplayUserIDLease struct {
	LeaseID          string
	DisplayUserID    string
	UserID           int64
	Status           PrettyLeaseStatus
	StartsAtMs       int64
	ExpiresAtMs      int64
	PaymentReceiptID string
	Source           string
	CreatedAtMs      int64
	UpdatedAtMs      int64
}

// PrettyDisplayUserIDCommand 描述申请临时靓号的事务输入。
type PrettyDisplayUserIDCommand struct {
	LeaseID          string
	UserID           int64
	PrettyDisplayID  string
	LeaseDurationMs  int64
	PaymentReceiptID string
	Source           string
	RequestID        string
	OperatorUserID   int64
	NowMs            int64
}

// ExpirePrettyDisplayUserIDCommand 描述靓号过期恢复的事务输入。
type ExpirePrettyDisplayUserIDCommand struct {
	UserID    int64
	LeaseID   string
	RequestID string
	NowMs     int64
}

// CanLogin 判断用户状态是否允许签发新会话。
func (u User) CanLogin() bool {
	return u.Status == StatusActive
}

// DisplayUserIDExpired 判断当前展示号快照是否已经因为靓号到期而失效。
func (u User) DisplayUserIDExpired(nowMs int64) bool {
	return u.CurrentDisplayUserIDKind == DisplayUserIDKindPretty && u.CurrentDisplayUserIDExpiresAtMs > 0 && u.CurrentDisplayUserIDExpiresAtMs <= nowMs
}

// EffectiveIdentity 把用户当前展示号快照转换成对外身份投影。
func (u User) EffectiveIdentity() Identity {
	return Identity{
		UserID:                   u.UserID,
		DisplayUserID:            u.CurrentDisplayUserID,
		DefaultDisplayUserID:     u.DefaultDisplayUserID,
		DisplayUserIDKind:        u.CurrentDisplayUserIDKind,
		DisplayUserIDExpiresAtMs: u.CurrentDisplayUserIDExpiresAtMs,
		Status:                   DisplayUserIDStatusActive,
	}
}

// NormalizeDisplayUserIDState 补齐老测试数据或迁移窗口中的默认短号字段。
func (u User) NormalizeDisplayUserIDState() User {
	if u.DefaultDisplayUserID == "" {
		u.DefaultDisplayUserID = u.CurrentDisplayUserID
	}
	if u.CurrentDisplayUserID == "" {
		u.CurrentDisplayUserID = u.DefaultDisplayUserID
	}
	if u.CurrentDisplayUserIDKind == "" {
		u.CurrentDisplayUserIDKind = DisplayUserIDKindDefault
	}
	if u.CurrentDisplayUserIDKind == DisplayUserIDKindDefault {
		u.CurrentDisplayUserIDExpiresAtMs = 0
	}

	return u
}

// ValidDisplayUserID 校验短号格式。
func ValidDisplayUserID(value string) bool {
	return displayUserIDPattern.MatchString(value)
}