lan
f2b02682c2
按 MinecraftServices 文档实现好友系四组接口与 profiles 服务：
好友系统（/api/yggdrasil/minecraftservices/*）
- Friends（1.3）：列表查询、ADD/REMOVE 操作（发请求/接受/拒绝/撤回/删除）
- 状态枚举+单向记录模型，接受请求时合并两方向避免好友列表重复
- Player Attributes（1.2）：friendsPreferences / 脏词过滤 / 聊天偏好读写
- Upsert 用 map 显式写字段规避 gorm 对带 default 零值布尔字段的忽略
- Presence（1.1）：Redis key+TTL 上报与好友在线状态批量查询
- Blocklist（1.6）：屏蔽列表查询（含 120s Redis 缓存），Block/Unblock 内部方法
Profiles 服务
- getManyByName（2.1）：POST /api/profiles/minecraft，返回 [{id,name}]
- toLowerCase 规范化、去重、空名过滤、maxBatch=10 超限拒绝
- getByName（2.2）：GET /api/users/profiles/minecraft/:name，返回 {id,name}，未找到返回 404
路由与基础设施
- 路由按官方 host 前缀一一转发
- api.mojang.com/* -> /api/yggdrasil/api/*
- api.minecraftservices.com/* -> /api/yggdrasil/minecraftservices/*
- 新增 Friend/PlayerAttributes 模型与 AutoMigrate 注册
- 新增 FriendsService 与 Container 装配
- 抽 extractBearerToken helper，统一 MinecraftServices 错误响应
修复
- texture_service: ToggleFavorite 在 db 为 nil 时降级非事务执行
修复 TestTextureServiceImpl_ToggleFavorite 空指针 panic
- texture_service_test: UploadTexture 用例改用真实 SHA-256 命中 mock
修复 4 个子用例因文件大小/Hash 不匹配的失败
- profile_repository: GetByNames/FindByName 改 LOWER() 大小写不敏感
与客户端 toLowerCase 规范化对齐
测试
- 好友模型、ADD/REMOVE/接受、属性、屏蔽、Bearer 解析单测全绿
- profiles 查询规范化、去重、超限、大小写不敏感单测全绿
- go build ./... && go test ./... 全部通过
90 lines
4.2 KiB
Go
90 lines
4.2 KiB
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"`
|
||
}
|