feat(yggdrasil): 实现好友系统与 profiles 查询接口
按 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 ./... 全部通过
This commit is contained in:
@@ -146,3 +146,41 @@ const (
|
||||
// IllegalArgumentException 错误消息
|
||||
YggErrProfileAlreadyAssigned = "Access token already has a profile assigned."
|
||||
)
|
||||
|
||||
// FriendsErrorStatus MinecraftServices 好友系接口业务错误码(文档 1.3.4)
|
||||
const (
|
||||
FriendsErrUnknownProfile = "UNKNOWN_PROFILE"
|
||||
FriendsErrCannotAddSelf = "CANNOT_ADD_SELF"
|
||||
FriendsErrDuplicatedProfiles = "DUPLICATED_PROFILES"
|
||||
)
|
||||
|
||||
// FriendsErrorResultCode MinecraftServices 好友系接口结果码(文档 4)
|
||||
const (
|
||||
FriendsResultSuccess = "SUCCESS"
|
||||
FriendsResultError = "ERROR"
|
||||
FriendsResultServiceUnavailable = "SERVICE_NOT_AVAILABLE"
|
||||
FriendsResultTooManyRequests = "TOO_MANY_REQUESTS"
|
||||
FriendsResultForbidden = "FORBIDDEN"
|
||||
FriendsResultUnknownProfile = "UNKNOWN_PROFILE"
|
||||
FriendsResultUnauthorized = "UNAUTHORIZED"
|
||||
)
|
||||
|
||||
// MinecraftServicesErrorResponse MinecraftServices 系接口标准错误响应(文档 0.3)
|
||||
// 与 YggdrasilErrorResponse 不同,本体系按 MinecraftServices 的结构返回:
|
||||
// { "path": "...", "error": "...", "errorMessage": "...", "details": {} }
|
||||
type MinecraftServicesErrorResponse struct {
|
||||
Path string `json:"path"`
|
||||
Error string `json:"error"` // 机器可读错误码
|
||||
ErrorMessage string `json:"errorMessage"` // 人类可读描述
|
||||
Details interface{} `json:"details,omitempty"` // 错误特定细节
|
||||
}
|
||||
|
||||
// NewMinecraftServicesErrorResponse 创建 MinecraftServices 系标准错误响应
|
||||
func NewMinecraftServicesErrorResponse(path, errorCode, errorMessage string, details interface{}) *MinecraftServicesErrorResponse {
|
||||
return &MinecraftServicesErrorResponse{
|
||||
Path: path,
|
||||
Error: errorCode,
|
||||
ErrorMessage: errorMessage,
|
||||
Details: details,
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user