backend/internal/model/friends.go

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",
	}
}