syntax = "proto3";

package topfans.common;

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

// 通用响应状态码
enum StatusCode {
  STATUS_UNSPECIFIED = 0;
  STATUS_OK = 200;
  STATUS_BAD_REQUEST = 400;
  STATUS_UNAUTHORIZED = 401;
  STATUS_FORBIDDEN = 403;
  STATUS_NOT_FOUND = 404;
  STATUS_TOO_MANY_REQUESTS = 429;
  STATUS_INTERNAL_ERROR = 500;
}

// 通用响应结构
message BaseResponse {
  StatusCode code = 1;      // 状态码
  string message = 2;       // 错误信息（成功时为空）
  int64 timestamp = 3;      // 响应时间戳（Unix时间戳毫秒）
}

// 分页请求--如好友功能
message PageRequest {
  int32 page = 1;        // 页码，从1开始
  int32 page_size = 2;   // 每页数量
}

// 分页响应
message PageResponse {
  int32 page = 1;
  int32 page_size = 2;
  int64 total = 3;       // 总记录数
  int32 total_pages = 4; // 总页数
}

// 空消息（用于无参数的RPC方法）
message Empty {
}