package model import "time" // FriendsStatus 好友关系状态 // @Description 好友关系状态枚举 type FriendsStatus string const ( // FriendsStatusPending 待处理(已发出请求,对方尚未接受) FriendsStatusPending FriendsStatus = "pending" // FriendsStatusAccepted 已互相成为好友 FriendsStatusAccepted FriendsStatus = "accepted" // FriendsStatusBlocked 屏蔽(requester 屏蔽 target,单向) FriendsStatusBlocked FriendsStatus = "blocked" ) // Friend 好友/屏蔽关系记录 // @Description 玩家好友与屏蔽关系数据模型 // // 设计说明: // - 采用状态枚举+单条记录模型,区分 pending/accepted/blocked。 // - 屏蔽(blocked)复用本表,requester 为屏蔽发起者,target 为被屏蔽者。 // - 好友关系在 accepted 状态下,仍以 requester->target 单条记录表示; // 当 B 接受 A 的请求时,若不存在 B->A 记录则补建一条 accepted 记录, // 从而双方在 ListFriends 中都能看到对方。 type Friend struct { ID int64 `gorm:"column:id;primaryKey;autoIncrement" json:"id"` RequesterUUID string `gorm:"column:requester_uuid;type:varchar(32);not null;uniqueIndex:uk_friend_pair,priority:1;index:idx_friend_requester_status,priority:1" json:"requester_uuid"` TargetUUID string `gorm:"column:target_uuid;type:varchar(32);not null;uniqueIndex:uk_friend_pair,priority:2;index:idx_friend_target_status,priority:1" json:"target_uuid"` Status FriendsStatus `gorm:"column:status;type:varchar(16);not null;default:'pending';index:idx_friend_requester_status,priority:2;index:idx_friend_target_status,priority:2" json:"status"` CreatedAt time.Time `gorm:"column:created_at;type:timestamp;not null;default:CURRENT_TIMESTAMP" json:"created_at"` UpdatedAt time.Time `gorm:"column:updated_at;type:timestamp;not null;default:CURRENT_TIMESTAMP" json:"updated_at"` } // TableName 指定表名 func (Friend) TableName() string { return "friends" } // PlayerAttributes 玩家好友/聊天偏好属性 // @Description 玩家偏好属性数据模型(对应文档 friendsPreferences / profanityFilterPreferences / chatPreferences) type PlayerAttributes struct { ProfileUUID string `gorm:"column:profile_uuid;type:varchar(32);primaryKey" json:"profile_uuid"` FriendsEnabled bool `gorm:"column:friends_enabled;not null;default:true" json:"friends_enabled"` AcceptInvites bool `gorm:"column:accept_invites;not null;default:true" json:"accept_invites"` ProfanityFilterOn bool `gorm:"column:profanity_filter_on;not null;default:true" json:"profanity_filter_on"` // TextCommunication 聊天文本通信偏好:ENABLED / FRIENDS_ONLY / DISABLED TextCommunication string `gorm:"column:text_communication;type:varchar(16);not null;default:'ENABLED'" json:"text_communication"` CreatedAt time.Time `gorm:"column:created_at;type:timestamp;not null;default:CURRENT_TIMESTAMP" json:"created_at"` UpdatedAt time.Time `gorm:"column:updated_at;type:timestamp;not null;default:CURRENT_TIMESTAMP" json:"updated_at"` } // TableName 指定表名 func (PlayerAttributes) TableName() string { return "player_attributes" } // DefaultPlayerAttributes 返回某 profile 的默认属性(数据库无记录时使用) func DefaultPlayerAttributes(profileUUID string) PlayerAttributes { return PlayerAttributes{ ProfileUUID: profileUUID, FriendsEnabled: true, AcceptInvites: true, ProfanityFilterOn: true, TextCommunication: "ENABLED", } }