syntax = "proto3";

package hyapp.wallet.v1;

option go_package = "hyapp/api/proto/wallet/v1;walletv1";

// DebitGiftRequest 是 room-service 送礼同步扣费的最小账务输入。
message DebitGiftRequest {
  string command_id = 1;
  string room_id = 2;
  int64 sender_user_id = 3;
  int64 target_user_id = 4;
  string gift_id = 5;
  int32 gift_count = 6;
  // price_version 为空时使用当前生效价格；非空时必须命中 active 价格版本。
  string price_version = 7;
}

// DebitGiftResponse 返回扣费流水、服务端结算值和 sender COIN 账后余额。
message DebitGiftResponse {
  string billing_receipt_id = 1;
  string transaction_id = 2;
  int64 coin_spent = 3;
  int64 gift_point_added = 4;
  int64 heat_value = 5;
  string price_version = 6;
  // balance_after 是 sender COIN available_amount 账后余额。
  int64 balance_after = 7;
}

// AssetBalance 是用户某类资产的余额投影。
message AssetBalance {
  string asset_type = 1;
  int64 available_amount = 2;
  int64 frozen_amount = 3;
  int64 version = 4;
}

// GetBalancesRequest 查询用户多资产余额；内部调用方负责鉴权和用户范围控制。
message GetBalancesRequest {
  string request_id = 1;
  int64 user_id = 2;
  repeated string asset_types = 3;
}

message GetBalancesResponse {
  repeated AssetBalance balances = 1;
}

// AdminCreditAssetRequest 是后台手动入账/调账的最小审计命令。
message AdminCreditAssetRequest {
  string command_id = 1;
  int64 target_user_id = 2;
  string asset_type = 3;
  int64 amount = 4;
  int64 operator_user_id = 5;
  string reason = 6;
  string evidence_ref = 7;
}

message AdminCreditAssetResponse {
  string transaction_id = 1;
  AssetBalance balance = 2;
}

// WalletService 是内部账务 gRPC 边界，外部 HTTP 入口仍由 gateway-service 承载。
service WalletService {
  rpc DebitGift(DebitGiftRequest) returns (DebitGiftResponse);
  rpc GetBalances(GetBalancesRequest) returns (GetBalancesResponse);
  rpc AdminCreditAsset(AdminCreditAssetRequest) returns (AdminCreditAssetResponse);
}