syntax = "proto3";

package topfans.ranking;

option go_package = "github.com/topfans/backend/pkg/proto/ranking;ranking";

import "proto/common.proto";
import "google/api/annotations.proto";

// ==================== 排行榜相关消息 ====================

// 排行榜请求（热度/自制）
message GetRankingRequest {
  string dimension = 1;  // 统计维度：displaying(展示中), month(本月), total(全部)
  int64 star_id = 2;     // 粉丝身份ID（可选，不传则使用当前身份）
  int32 page = 3;        // 页码（默认1）
  int32 page_size = 4;   // 每页数量（默认10）
  int64 user_id = 5;     // 当前用户ID
}

// 排行榜项
message RankingItem {
  int32 rank = 1;              // 排名
  int64 asset_id = 2;           // 藏品ID
  string asset_name = 3;        // 藏品名称
  string cover_url = 4;        // 封面图URL
  int64 owner_uid = 5;         // 持有者ID
  string owner_nickname = 6;   // 持有者昵称
  string owner_avatar = 9;     // 持有者头像
  int32 like_count = 7;        // 点赞数
  bool is_original = 8;        // 是否自制藏品
}

// 我的排名信息
message MyRanking {
  int32 rank = 1;              // 排名（上榜时返回）
  int64 asset_id = 2;          // 藏品ID
  string asset_name = 3;       // 藏品名称
  string cover_url = 4;        // 封面图URL
  int32 like_count = 5;        // 点赞数
  string status = 6;            // 状态：ranked(上榜), unranked(未上榜)
  int32 diff_to_rank = 7;      // 距离上榜的差距（未上榜时返回）
  string owner_nickname = 8;   // 持有者昵称
  string owner_avatar = 9;     // 持有者头像
}

// 排行榜响应
message GetRankingResponse {
  topfans.common.BaseResponse base = 1;
  MyRanking my_ranking = 2;              // 我的排名
  repeated RankingItem items = 3;       // 排行榜列表
  int32 page = 4;                        // 当前页码
  int32 page_size = 5;                  // 每页数量
  int32 total = 6;                      // 总数
}

// ==================== 排行榜服务 ====================

service RankingService {
  // 获取热度排行榜
  rpc GetHotRanking(GetRankingRequest) returns (GetRankingResponse) {
    option (google.api.http) = {
      get: "/api/v1/rankings/hot"
    };
  }

  // 获取自制排行榜
  rpc GetOriginalRanking(GetRankingRequest) returns (GetRankingResponse) {
    option (google.api.http) = {
      get: "/api/v1/rankings/original"
    };
  }
}