310 lines
11 KiB
Go
310 lines
11 KiB
Go
// Package host 定义 user-service 内 host/Agency/BD 领域事实。
|
||
package host
|
||
|
||
const (
|
||
// HostStatusActive 表示用户已经拥有长期主播身份。
|
||
HostStatusActive = "active"
|
||
// HostStatusDisabled 预留给后台停用主播身份，App Phase 1 不主动产生。
|
||
HostStatusDisabled = "disabled"
|
||
|
||
// HostSourceApplication 表示主播身份来自 Agency 申请审核通过。
|
||
HostSourceApplication = "agency_application"
|
||
// HostSourceAgencyInvitation 表示主播身份来自接受 Agency 邀请并成为 Agency owner。
|
||
HostSourceAgencyInvitation = "agency_invitation"
|
||
// HostSourceAdminCreateAgency 表示主播身份来自后台直接创建 Agency。
|
||
HostSourceAdminCreateAgency = "admin_create_agency"
|
||
|
||
// AgencyStatusActive 表示 Agency 可参与搜索、邀请和归属。
|
||
AgencyStatusActive = "active"
|
||
// AgencyStatusClosed 表示 Agency 已关闭，历史关系仍保留。
|
||
AgencyStatusClosed = "closed"
|
||
|
||
// BDStatusActive 表示 BD 或 BD Leader 可邀请下级角色。
|
||
BDStatusActive = "active"
|
||
// BDStatusDisabled 表示 BD 或 BD Leader 已停用。
|
||
BDStatusDisabled = "disabled"
|
||
|
||
// BDRoleBD 是普通拓展角色。
|
||
BDRoleBD = "bd"
|
||
// BDRoleLeader 是 BD Leader，具备邀请 BD 的能力，同时也是 BD。
|
||
BDRoleLeader = "bd_leader"
|
||
|
||
// CoinSellerStatusActive 表示币商身份有效，可以使用币商金币账户转账能力。
|
||
CoinSellerStatusActive = "active"
|
||
// CoinSellerStatusDisabled 表示币商身份被后台停用，不能继续发起币商转账。
|
||
CoinSellerStatusDisabled = "disabled"
|
||
// CoinSellerMerchantAssetType 是币商专用金币资产，不和玩家普通 COIN 混账。
|
||
CoinSellerMerchantAssetType = "COIN_SELLER_COIN"
|
||
|
||
// MembershipTypeOwner 表示 Agency owner 自动拥有的 membership。
|
||
MembershipTypeOwner = "owner"
|
||
// MembershipTypeMember 表示普通主播加入 Agency 的 membership。
|
||
MembershipTypeMember = "member"
|
||
|
||
// MembershipStatusActive 表示当前有效 Agency 归属。
|
||
MembershipStatusActive = "active"
|
||
// MembershipStatusEnded 表示历史 Agency 归属。
|
||
MembershipStatusEnded = "ended"
|
||
|
||
// ApplicationStatusPending 表示等待 Agency 审核。
|
||
ApplicationStatusPending = "pending"
|
||
// ApplicationStatusApproved 表示申请已通过并创建关系事实。
|
||
ApplicationStatusApproved = "approved"
|
||
// ApplicationStatusRejected 表示申请被拒绝，不创建主播身份。
|
||
ApplicationStatusRejected = "rejected"
|
||
// ApplicationStatusCancelled 表示申请被申请人取消。
|
||
ApplicationStatusCancelled = "cancelled"
|
||
// ApplicationStatusExpired 表示申请已过期。
|
||
ApplicationStatusExpired = "expired"
|
||
|
||
// ApplicationDecisionApprove 是审核通过动作。
|
||
ApplicationDecisionApprove = "approve"
|
||
// ApplicationDecisionReject 是审核拒绝动作。
|
||
ApplicationDecisionReject = "reject"
|
||
|
||
// InvitationTypeAgency 表示邀请用户成为 Agency owner。
|
||
InvitationTypeAgency = "agency"
|
||
// InvitationTypeBD 表示邀请用户成为 BD。
|
||
InvitationTypeBD = "bd"
|
||
|
||
// InvitationStatusPending 表示等待目标用户处理。
|
||
InvitationStatusPending = "pending"
|
||
// InvitationStatusAccepted 表示目标用户接受并创建角色事实。
|
||
InvitationStatusAccepted = "accepted"
|
||
// InvitationStatusRejected 表示目标用户拒绝。
|
||
InvitationStatusRejected = "rejected"
|
||
// InvitationStatusCancelled 表示邀请人取消。
|
||
InvitationStatusCancelled = "cancelled"
|
||
// InvitationStatusExpired 表示邀请已过期。
|
||
InvitationStatusExpired = "expired"
|
||
|
||
// InvitationActionAccept 是接受邀请动作。
|
||
InvitationActionAccept = "accept"
|
||
// InvitationActionReject 是拒绝邀请动作。
|
||
InvitationActionReject = "reject"
|
||
// InvitationActionCancel 是邀请人取消动作。
|
||
InvitationActionCancel = "cancel"
|
||
|
||
// CommandTypeApplyToAgency 记录用户申请命令。
|
||
CommandTypeApplyToAgency = "apply_to_agency"
|
||
// CommandTypeReviewAgencyApplication 记录申请审核命令。
|
||
CommandTypeReviewAgencyApplication = "review_agency_application"
|
||
// CommandTypeKickAgencyHost 记录 Agency 踢出命令。
|
||
CommandTypeKickAgencyHost = "kick_agency_host"
|
||
// CommandTypeInviteAgency 记录 Agency 邀请命令。
|
||
CommandTypeInviteAgency = "invite_agency"
|
||
// CommandTypeInviteBD 记录 BD 邀请命令。
|
||
CommandTypeInviteBD = "invite_bd"
|
||
// CommandTypeProcessRoleInvitation 记录邀请处理命令。
|
||
CommandTypeProcessRoleInvitation = "process_role_invitation"
|
||
// CommandTypeCreateBDLeader 记录后台创建 BD Leader 命令。
|
||
CommandTypeCreateBDLeader = "admin_create_bd_leader"
|
||
// CommandTypeCreateBD 记录后台创建普通 BD 命令。
|
||
CommandTypeCreateBD = "admin_create_bd"
|
||
// CommandTypeSetBDStatus 记录后台停用或恢复 BD/BD Leader 命令。
|
||
CommandTypeSetBDStatus = "admin_set_bd_status"
|
||
// CommandTypeCreateAgency 记录后台直接创建 Agency 命令。
|
||
CommandTypeCreateAgency = "admin_create_agency"
|
||
// CommandTypeCloseAgency 记录后台关闭 Agency 命令。
|
||
CommandTypeCloseAgency = "admin_close_agency"
|
||
// CommandTypeSetAgencyJoinEnabled 记录后台设置 Agency 入会开关命令。
|
||
CommandTypeSetAgencyJoinEnabled = "admin_set_agency_join_enabled"
|
||
// CommandTypeCreateCoinSeller 记录后台创建币商身份命令。
|
||
CommandTypeCreateCoinSeller = "admin_create_coin_seller"
|
||
// CommandTypeSetCoinSellerStatus 记录后台启用或停用币商身份命令。
|
||
CommandTypeSetCoinSellerStatus = "admin_set_coin_seller_status"
|
||
|
||
// ResultTypeApplication 表示命令结果是 agency_applications 行。
|
||
ResultTypeApplication = "agency_application"
|
||
// ResultTypeMembership 表示命令结果是 agency_memberships 行。
|
||
ResultTypeMembership = "agency_membership"
|
||
// ResultTypeInvitation 表示命令结果是 role_invitations 行。
|
||
ResultTypeInvitation = "role_invitation"
|
||
// ResultTypeBDProfile 表示命令结果是 bd_profiles 行。
|
||
ResultTypeBDProfile = "bd_profile"
|
||
// ResultTypeAgency 表示命令结果是 agencies 行。
|
||
ResultTypeAgency = "agency"
|
||
// ResultTypeCoinSellerProfile 表示命令结果是 coin_seller_profiles 行。
|
||
ResultTypeCoinSellerProfile = "coin_seller_profile"
|
||
)
|
||
|
||
// HostProfile 是用户长期主播身份快照。
|
||
type HostProfile struct {
|
||
UserID int64
|
||
Status string
|
||
RegionID int64
|
||
CurrentAgencyID int64
|
||
CurrentMembershipID int64
|
||
// CurrentAgencyOwnerUserID 是当前 Agency 的 owner 用户 ID，供 wallet 在送礼时固化代理工资收款人。
|
||
CurrentAgencyOwnerUserID int64
|
||
Source string
|
||
FirstBecameHostAtMs int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// Agency 是主播组织事实，由一个用户拥有并归属于 BD。
|
||
type Agency struct {
|
||
AgencyID int64
|
||
OwnerUserID int64
|
||
RegionID int64
|
||
ParentBDUserID int64
|
||
Name string
|
||
OwnerAvatar string
|
||
ActiveHostCount int32
|
||
Status string
|
||
JoinEnabled bool
|
||
MaxHosts int32
|
||
CreatedByUserID int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// BDProfile 是 BD/BD Leader 角色事实。
|
||
type BDProfile struct {
|
||
UserID int64
|
||
Role string
|
||
RegionID int64
|
||
ParentLeaderUserID int64
|
||
Status string
|
||
CreatedByUserID int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// CoinSellerProfile 是币商角色事实，余额不保存在 user-service。
|
||
type CoinSellerProfile struct {
|
||
UserID int64
|
||
Status string
|
||
MerchantAssetType string
|
||
CreatedByUserID int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// CoinSellerListItem 是 App 充值入口需要的启用币商展示资料。
|
||
// 区域来自 users 当前事实，币商状态来自 coin_seller_profiles，不在 gateway 拼装。
|
||
type CoinSellerListItem struct {
|
||
UserID int64
|
||
DisplayUserID string
|
||
Username string
|
||
Avatar string
|
||
CountryID int64
|
||
CountryCode string
|
||
CountryName string
|
||
CountryDisplayName string
|
||
RegionID int64
|
||
RegionCode string
|
||
RegionName string
|
||
Status string
|
||
MerchantAssetType string
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// UserRoleSummary 是面向 App 入口显隐的聚合 read model。
|
||
// 这里不承载团队统计或薪资指标，只表达当前用户是否拥有可用身份和待处理邀请数量。
|
||
type UserRoleSummary struct {
|
||
UserID int64
|
||
IsHost bool
|
||
IsAgency bool
|
||
IsManager bool
|
||
IsBD bool
|
||
IsBDLeader bool
|
||
IsCoinSeller bool
|
||
HostStatus string
|
||
AgencyID int64
|
||
BDID int64
|
||
BDStatus string
|
||
CoinSellerStatus string
|
||
PendingRoleInvitations int64
|
||
}
|
||
|
||
// AgencyMembership 是 host 与 Agency 的有时效归属事实。
|
||
type AgencyMembership struct {
|
||
MembershipID int64
|
||
AgencyID int64
|
||
HostUserID int64
|
||
RegionID int64
|
||
MembershipType string
|
||
Status string
|
||
JoinedAtMs int64
|
||
EndedAtMs int64
|
||
EndedByUserID int64
|
||
EndedReason string
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// AgencyApplication 是用户申请加入 Agency 的状态机事实。
|
||
type AgencyApplication struct {
|
||
ApplicationID int64
|
||
CommandID string
|
||
ApplicantUserID int64
|
||
AgencyID int64
|
||
RegionID int64
|
||
Status string
|
||
ReviewedByUserID int64
|
||
ReviewReason string
|
||
ReviewedAtMs int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// RoleInvitation 是 BD 或 BD Leader 发起的角色邀请事实。
|
||
type RoleInvitation struct {
|
||
InvitationID int64
|
||
CommandID string
|
||
InvitationType string
|
||
Status string
|
||
InviterUserID int64
|
||
InviterBDUserID int64
|
||
TargetUserID int64
|
||
RegionID int64
|
||
AgencyName string
|
||
ParentBDUserID int64
|
||
ParentLeaderUserID int64
|
||
ProcessedByUserID int64
|
||
ProcessReason string
|
||
ProcessedAtMs int64
|
||
CreatedAtMs int64
|
||
UpdatedAtMs int64
|
||
}
|
||
|
||
// CommandResult 是 host_command_results 的轻量投影，用于命令幂等返回已有事实。
|
||
type CommandResult struct {
|
||
CommandID string
|
||
CommandType string
|
||
ResultType string
|
||
ResultID int64
|
||
CreatedAtMs int64
|
||
}
|
||
|
||
// ReviewAgencyApplicationResult 聚合申请审核后需要返回给调用方的事实。
|
||
type ReviewAgencyApplicationResult struct {
|
||
Application AgencyApplication
|
||
HostProfile HostProfile
|
||
Membership AgencyMembership
|
||
}
|
||
|
||
// KickAgencyHostResult 聚合踢出后需要返回给调用方的事实。
|
||
type KickAgencyHostResult struct {
|
||
Membership AgencyMembership
|
||
HostProfile HostProfile
|
||
}
|
||
|
||
// ProcessRoleInvitationResult 聚合邀请处理后可能创建的角色事实。
|
||
type ProcessRoleInvitationResult struct {
|
||
Invitation RoleInvitation
|
||
HostProfile HostProfile
|
||
Agency Agency
|
||
Membership AgencyMembership
|
||
BDProfile BDProfile
|
||
}
|
||
|
||
// CreateAgencyResult 聚合后台创建 Agency 后同步产生的 owner 身份和 owner membership。
|
||
type CreateAgencyResult struct {
|
||
Agency Agency
|
||
HostProfile HostProfile
|
||
Membership AgencyMembership
|
||
}
|