syntax = "proto3";

package hyapp.luckygift.v1;

option go_package = "hyapp.local/api/proto/luckygift/v1;luckygiftv1";

// RequestMeta 是 lucky-gift-service 的内部追踪元信息。
// request_id 只用于链路排查，不能被任何业务流程当成幂等键使用。
message RequestMeta {
  string request_id = 1;
  string caller = 2;
  string gateway_node_id = 3;
  int64 sent_at_ms = 4;
  string app_code = 5;
}

// LuckyGiftMeta 是 HyApp 内部房间送礼扣费成功后的抽奖事实输入。
// 金额、目标用户和 command_id 必须来自 wallet-service 已落账的 receipt，不能从客户端 payload 推导。
message LuckyGiftMeta {
  RequestMeta meta = 1;
  string command_id = 2;
  int64 user_id = 3;
  string device_id = 4;
  string room_id = 5;
  string anchor_id = 6;
  string gift_id = 7;
  int64 coin_spent = 8;
  int64 paid_at_ms = 9;
  string pool_id = 10;
  int64 target_user_id = 11;
  int32 gift_count = 12;
  int64 visible_region_id = 13;
  int64 country_id = 14;
}

message LuckyGiftRuleTier {
  string stage = 1;
  string tier_id = 2;
  int64 multiplier_ppm = 3;
  int64 base_weight_ppm = 4;
  bool high_water_only = 5;
  bool enabled = 6;
}

message LuckyGiftRuleStage {
  string stage = 1;
  repeated LuckyGiftRuleTier tiers = 2;
}

message LuckyGiftRuleConfig {
  string app_code = 1;
  string pool_id = 2;
  int64 rule_version = 3;
  bool enabled = 4;
  int64 target_rtp_ppm = 5;
  int64 pool_rate_ppm = 6;
  int64 settlement_window_wager = 7;
  int64 control_band_ppm = 8;
  int64 gift_price_reference = 9;
  int64 novice_max_equivalent_draws = 10;
  int64 normal_max_equivalent_draws = 11;
  int64 effective_from_ms = 12;
  int64 created_by_admin_id = 13;
  int64 created_at_ms = 14;
  repeated LuckyGiftRuleStage stages = 15;
}

message CheckLuckyGiftRequest {
  RequestMeta meta = 1;
  int64 user_id = 2;
  string room_id = 3;
  string gift_id = 4;
  string pool_id = 5;
}

message CheckLuckyGiftResponse {
  bool enabled = 1;
  string reason = 2;
  string gift_id = 3;
  int64 gift_price = 4;
  int64 rule_version = 5;
  int64 target_rtp_ppm = 6;
  string experience_pool = 7;
  string pool_id = 8;
}

message LuckyGiftDrawResult {
  string draw_id = 1;
  string command_id = 2;
  string gift_id = 3;
  int64 rule_version = 4;
  string experience_pool = 5;
  string selected_tier_id = 6;
  int64 base_reward_coins = 7;
  int64 effective_reward_coins = 8;
  string reward_status = 9;
  int64 rtp_window_index = 10;
  int64 gift_rtp_window_index = 11;
  int64 global_base_rtp_ppm = 12;
  int64 gift_base_rtp_ppm = 13;
  bool stage_feedback = 14;
  bool high_multiplier = 15;
  int64 created_at_ms = 16;
  string pool_id = 17;
  int64 multiplier_ppm = 18;
  string wallet_transaction_id = 19;
  int64 coin_balance_after = 20;
  int64 user_id = 21;
  string external_user_id = 22;
  string app_code = 23;
}

message ExecuteLuckyGiftDrawRequest {
  LuckyGiftMeta lucky_gift = 1;
}

message ExecuteLuckyGiftDrawResponse {
  LuckyGiftDrawResult result = 1;
}

message BatchExecuteLuckyGiftDrawRequest {
  repeated LuckyGiftMeta lucky_gifts = 1;
}

message BatchExecuteLuckyGiftDrawResponse {
  repeated LuckyGiftDrawResult results = 1;
}

// ExternalGiftDrawRequest 是外部 App 接入的抽奖输入。
// App 调用前必须已经完成自己的扣费，lucky-gift-service 只校验金额事实并返回中奖结果。
message ExternalGiftDrawRequest {
  RequestMeta meta = 1;
  string app_code = 3;
  string external_user_id = 4;
  string request_id = 5;
  int64 gift_count = 6;
  int64 unit_amount = 7;
  int64 total_amount = 8;
  string currency = 9;
  int64 paid_at_ms = 10;
  string metadata_json = 11;
  string pool_id = 12;
}

message ExternalGiftDrawResponse {
  string draw_id = 1;
  string request_id = 2;
  string app_code = 4;
  string external_user_id = 5;
  int64 gift_count = 6;
  int64 unit_amount = 7;
  int64 total_amount = 8;
  int64 reward_amount = 9;
  int64 multiplier_ppm = 10;
  string reward_status = 11;
  int64 rule_version = 12;
  int64 created_at_ms = 13;
}

message GetLuckyGiftConfigRequest {
  RequestMeta meta = 1;
  string pool_id = 2;
}

message GetLuckyGiftConfigResponse {
  LuckyGiftRuleConfig config = 1;
}

message UpsertLuckyGiftConfigRequest {
  RequestMeta meta = 1;
  LuckyGiftRuleConfig config = 2;
  int64 operator_admin_id = 3;
}

message UpsertLuckyGiftConfigResponse {
  LuckyGiftRuleConfig config = 1;
}

message ListLuckyGiftConfigsRequest {
  RequestMeta meta = 1;
}

message ListLuckyGiftConfigsResponse {
  repeated LuckyGiftRuleConfig configs = 1;
}

message ListLuckyGiftDrawsRequest {
  RequestMeta meta = 1;
  string gift_id = 2;
  int64 user_id = 3;
  string room_id = 4;
  string status = 5;
  int32 page = 6;
  int32 page_size = 7;
  string pool_id = 8;
  string external_user_id = 10;
  bool external_only = 11;
}

message ListLuckyGiftDrawsResponse {
  repeated LuckyGiftDrawResult draws = 1;
  int64 total = 2;
}

message LuckyGiftDrawSummary {
  string pool_id = 1;
  int64 total_draws = 2;
  int64 unique_users = 3;
  int64 unique_rooms = 4;
  int64 total_spent_coins = 5;
  int64 total_reward_coins = 6;
  int64 base_reward_coins = 7;
  int64 actual_rtp_ppm = 8;
  int64 pending_draws = 9;
  int64 granted_draws = 10;
  int64 failed_draws = 11;
}

message LuckyGiftPoolBalance {
  string app_code = 1;
  string pool_id = 2;
  int64 balance = 3;
  int64 reserve_floor = 4;
  int64 available_balance = 5;
  int64 total_in = 6;
  int64 total_out = 7;
  bool materialized = 8;
  int64 updated_at_ms = 9;
}

message GetLuckyGiftDrawSummaryRequest {
  RequestMeta meta = 1;
  string gift_id = 2;
  int64 user_id = 3;
  string room_id = 4;
  string status = 5;
  string pool_id = 6;
  string external_user_id = 8;
  bool external_only = 9;
}

message GetLuckyGiftDrawSummaryResponse {
  LuckyGiftDrawSummary summary = 1;
}

message ListLuckyGiftPoolBalancesRequest {
  RequestMeta meta = 1;
  string pool_id = 2;
}

message ListLuckyGiftPoolBalancesResponse {
  repeated LuckyGiftPoolBalance pools = 1;
}

service LuckyGiftService {
  rpc CheckLuckyGift(CheckLuckyGiftRequest) returns (CheckLuckyGiftResponse);
  rpc ExecuteLuckyGiftDraw(ExecuteLuckyGiftDrawRequest) returns (ExecuteLuckyGiftDrawResponse);
  rpc BatchExecuteLuckyGiftDraw(BatchExecuteLuckyGiftDrawRequest) returns (BatchExecuteLuckyGiftDrawResponse);
  rpc ExecuteExternalGiftDraw(ExternalGiftDrawRequest) returns (ExternalGiftDrawResponse);
}

service AdminLuckyGiftService {
  rpc GetLuckyGiftConfig(GetLuckyGiftConfigRequest) returns (GetLuckyGiftConfigResponse);
  rpc UpsertLuckyGiftConfig(UpsertLuckyGiftConfigRequest) returns (UpsertLuckyGiftConfigResponse);
  rpc ListLuckyGiftConfigs(ListLuckyGiftConfigsRequest) returns (ListLuckyGiftConfigsResponse);
  rpc ListLuckyGiftDraws(ListLuckyGiftDrawsRequest) returns (ListLuckyGiftDrawsResponse);
  rpc GetLuckyGiftDrawSummary(GetLuckyGiftDrawSummaryRequest) returns (GetLuckyGiftDrawSummaryResponse);
  rpc ListLuckyGiftPoolBalances(ListLuckyGiftPoolBalancesRequest) returns (ListLuckyGiftPoolBalancesResponse);
}