backend/internal/model/profile.go

package model

import (
	"time"
)

// Profile Minecraft 档案模型
// @Description Minecraft角色档案数据模型
type Profile struct {
	UUID   string `gorm:"column:uuid;type:varchar(32);primaryKey" json:"uuid"`
	UserID int64  `gorm:"column:user_id;not null;index:idx_profiles_user_created,priority:1" json:"user_id"`
	Name   string `gorm:"column:name;type:varchar(16);not null;uniqueIndex:idx_profiles_name" json:"name"` // Minecraft 角色名
	SkinID *int64 `gorm:"column:skin_id;type:bigint;index:idx_profiles_skin_id" json:"skin_id,omitempty"`
	CapeID *int64 `gorm:"column:cape_id;type:bigint;index:idx_profiles_cape_id" json:"cape_id,omitempty"`
	// RSA 私钥不返回给前端
	RSAPrivateKey string `gorm:"column:rsa_private_key;type:text;not null" json:"-"`
	// 玩家证书完整密钥对（持久化以避免每次请求都重新生成 RSA 4096 密钥）
	RSAPublicKey         string     `gorm:"column:rsa_public_key;type:text" json:"-"`
	PublicKeySignature   string     `gorm:"column:public_key_signature;type:text" json:"-"`
	PublicKeySignatureV2 string     `gorm:"column:public_key_signature_v2;type:text" json:"-"`
	KeyExpiresAt         *time.Time `gorm:"column:key_expires_at;type:timestamp" json:"-"`
	KeyRefreshAt         *time.Time `gorm:"column:key_refresh_at;type:timestamp" json:"-"`
	LastUsedAt           *time.Time `gorm:"column:last_used_at;type:timestamp;index:idx_profiles_last_used,sort:desc" json:"last_used_at,omitempty"`
	CreatedAt            time.Time  `gorm:"column:created_at;type:timestamp;not null;default:CURRENT_TIMESTAMP;index:idx_profiles_user_created,priority:2,sort:desc" json:"created_at"`
	UpdatedAt            time.Time  `gorm:"column:updated_at;type:timestamp;not null;default:CURRENT_TIMESTAMP" json:"updated_at"`

	// 关联
	User *User    `gorm:"foreignKey:UserID;constraint:OnDelete:CASCADE" json:"user,omitempty"`
	Skin *Texture `gorm:"foreignKey:SkinID;constraint:OnDelete:SET NULL" json:"skin,omitempty"`
	Cape *Texture `gorm:"foreignKey:CapeID;constraint:OnDelete:SET NULL" json:"cape,omitempty"`
}

// TableName 指定表名
func (Profile) TableName() string {
	return "profiles"
}

// ProfileResponse 档案响应（包含完整的皮肤/披风信息）
// @Description Minecraft档案完整响应数据
type ProfileResponse struct {
	UUID       string              `json:"uuid"`
	Name       string              `json:"name"`
	Textures   ProfileTexturesData `json:"textures"`
	LastUsedAt *time.Time          `json:"last_used_at,omitempty"`
	CreatedAt  time.Time           `json:"created_at"`
}

// ProfileTexturesData Minecraft 材质数据结构
// @Description Minecraft档案材质数据
type ProfileTexturesData struct {
	Skin *ProfileTexture `json:"SKIN,omitempty"`
	Cape *ProfileTexture `json:"CAPE,omitempty"`
}

// ProfileTexture 单个材质信息
// @Description 单个材质的详细信息
type ProfileTexture struct {
	URL      string                  `json:"url"`
	Metadata *ProfileTextureMetadata `json:"metadata,omitempty"`
}

// ProfileTextureMetadata 材质元数据
// @Description 材质的元数据信息
type ProfileTextureMetadata struct {
	Model string `json:"model,omitempty"` // "slim" or "classic"
}

// KeyPair RSA密钥对
// @Description 用于Yggdrasil认证的RSA密钥对
type KeyPair struct {
	PrivateKey           string    `json:"private_key" bson:"private_key"`
	PublicKey            string    `json:"public_key" bson:"public_key"`
	PublicKeySignature   string    `json:"public_key_signature" bson:"public_key_signature"`
	PublicKeySignatureV2 string    `json:"public_key_signature_v2" bson:"public_key_signature_v2"`
	YggdrasilPublicKey   string    `json:"yggdrasil_public_key" bson:"yggdrasil_public_key"`
	Expiration           time.Time `json:"expiration" bson:"expiration"`
	Refresh              time.Time `json:"refresh" bson:"refresh"`
}

// NameAndId 简化的档案标识响应（文档 2.1 / 2.2 ProfileSearchResultsResponse / NameAndId）
// @Description 仅包含档案 UUID 与用户名的最小响应结构
//
// 用于 profiles.getManyByName / profiles.getByName 接口：
//   - id：档案 UUID（32 位无连字符十六进制）
//   - name：用户名（保持存储的大小写）
type NameAndId struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}