270 lines
6.9 KiB
Protocol Buffer
270 lines
6.9 KiB
Protocol Buffer
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);
|
||
}
|