@arbiwallet/contracts 1.0.279 → 1.0.281

package/gen/exchange_core.ts

@@ -361,6 +361,30 @@ export interface BatchGetUserDealStatsResponse {
   items: UserDealStats[];
 }
 
+export interface GetUserMetricsRequest {
+  userId: number;
+  dateFrom?: string | undefined;
+  dateTo?: string | undefined;
+}
+
+export interface UserDebtByCurrency {
+  currency: string;
+  amount: number;
+}
+
+export interface UserMetricsSnapshot {
+  totalProfit: number;
+  dealsCount: number;
+  clientDebt: UserDebtByCurrency[];
+  averageMarkup: number;
+  averageCheck: number;
+}
+
+export interface GetUserMetricsResponse {
+  period: UserMetricsSnapshot | undefined;
+  today: UserMetricsSnapshot | undefined;
+}
+
 export interface ExchangeCalculationsFiltersRequest {
   dateFrom?: string | undefined;
   dateTo?: string | undefined;
@@ -660,6 +684,8 @@ export interface ExchangeCoreServiceClient {
 
   batchGetUserDealStats(request: BatchGetUserDealStatsRequest): Observable<BatchGetUserDealStatsResponse>;
 
+  getUserMetrics(request: GetUserMetricsRequest): Observable<GetUserMetricsResponse>;
+
   createExchangePayment(request: CreateExchangePaymentRequest): Observable<CreateExchangePaymentResponse>;
 
   handlePaymentWebhook(request: HandlePaymentWebhookRequest): Observable<HandlePaymentWebhookResponse>;
@@ -743,6 +769,10 @@ export interface ExchangeCoreServiceController {
     request: BatchGetUserDealStatsRequest,
   ): Promise<BatchGetUserDealStatsResponse> | Observable<BatchGetUserDealStatsResponse> | BatchGetUserDealStatsResponse;
 
+  getUserMetrics(
+    request: GetUserMetricsRequest,
+  ): Promise<GetUserMetricsResponse> | Observable<GetUserMetricsResponse> | GetUserMetricsResponse;
+
   createExchangePayment(
     request: CreateExchangePaymentRequest,
   ): Promise<CreateExchangePaymentResponse> | Observable<CreateExchangePaymentResponse> | CreateExchangePaymentResponse;
@@ -806,6 +836,7 @@ export function ExchangeCoreServiceControllerMethods() {
       "cancelExchangeDeal",
       "getUserIdsWithDealsInPeriod",
       "batchGetUserDealStats",
+      "getUserMetrics",
       "createExchangePayment",
       "handlePaymentWebhook",
       "getExchangePayments",

package/gen/referral.ts

@@ -102,6 +102,48 @@ export interface GetReferralSummaryResponse {
   availableUsdtBalance: string;
 }
 
+export interface AdminGetReferralProfileByUserIdRequest {
+  userId: number;
+}
+
+export interface AdminReferralProfileByUserIdResponse {
+  profileId: string;
+  userId: number;
+  refCode: string;
+  referrerUserId?: number | undefined;
+  bonusType: ReferralBonusType;
+  refPercent: string;
+  status: ReferralProfileStatus;
+  createdAt: string;
+  updatedAt: string;
+  /** true, если в рамках AdminUpdateReferralProfileByUserId был установлен referrer_user_id. */
+  referrerChanged: boolean;
+}
+
+export interface AdminUpdateReferralProfileByUserIdRequest {
+  userId: number;
+  /**
+   * Разрешено только если у профиля еще нет реферера.
+   * Если текущий реферер уже задан, сервис возвращает ошибку REFERRER_ALREADY_SET.
+   */
+  referrerUserId?: number | undefined;
+  bonusType?: ReferralBonusType | undefined;
+  refPercent?: string | undefined;
+  refCode?: string | undefined;
+  changedBy?: string | undefined;
+}
+
+export interface GetUserReferralMetricsRequest {
+  walletUserId: string;
+  dateFrom?: string | undefined;
+  dateTo?: string | undefined;
+}
+
+export interface GetUserReferralMetricsResponse {
+  referralsCount: number;
+  referralsToday: number;
+}
+
 export interface ListReferralsRequest {
   walletUserId: string;
   page?: number | undefined;
@@ -282,6 +324,20 @@ export interface ReferralServiceClient {
 
   getReferralSummary(request: GetReferralSummaryRequest): Observable<GetReferralSummaryResponse>;
 
+  /** CRM admin: получить реферальный профиль для формы редактирования пользователя. */
+
+  adminGetReferralProfileByUserId(
+    request: AdminGetReferralProfileByUserIdRequest,
+  ): Observable<AdminReferralProfileByUserIdResponse>;
+
+  /** CRM admin: обновить реферальный профиль (реферер, тип начисления, процент, ref code). */
+
+  adminUpdateReferralProfileByUserId(
+    request: AdminUpdateReferralProfileByUserIdRequest,
+  ): Observable<AdminReferralProfileByUserIdResponse>;
+
+  getUserReferralMetrics(request: GetUserReferralMetricsRequest): Observable<GetUserReferralMetricsResponse>;
+
   listReferrals(request: ListReferralsRequest): Observable<ListReferralsResponse>;
 
   getReferredUserIds(request: GetReferredUserIdsRequest): Observable<GetReferredUserIdsResponse>;
@@ -331,6 +387,31 @@ export interface ReferralServiceController {
     request: GetReferralSummaryRequest,
   ): Promise<GetReferralSummaryResponse> | Observable<GetReferralSummaryResponse> | GetReferralSummaryResponse;
 
+  /** CRM admin: получить реферальный профиль для формы редактирования пользователя. */
+
+  adminGetReferralProfileByUserId(
+    request: AdminGetReferralProfileByUserIdRequest,
+  ):
+    | Promise<AdminReferralProfileByUserIdResponse>
+    | Observable<AdminReferralProfileByUserIdResponse>
+    | AdminReferralProfileByUserIdResponse;
+
+  /** CRM admin: обновить реферальный профиль (реферер, тип начисления, процент, ref code). */
+
+  adminUpdateReferralProfileByUserId(
+    request: AdminUpdateReferralProfileByUserIdRequest,
+  ):
+    | Promise<AdminReferralProfileByUserIdResponse>
+    | Observable<AdminReferralProfileByUserIdResponse>
+    | AdminReferralProfileByUserIdResponse;
+
+  getUserReferralMetrics(
+    request: GetUserReferralMetricsRequest,
+  ):
+    | Promise<GetUserReferralMetricsResponse>
+    | Observable<GetUserReferralMetricsResponse>
+    | GetUserReferralMetricsResponse;
+
   listReferrals(
     request: ListReferralsRequest,
   ): Promise<ListReferralsResponse> | Observable<ListReferralsResponse> | ListReferralsResponse;
@@ -398,6 +479,9 @@ export function ReferralServiceControllerMethods() {
       "getReferralLink",
       "bindReferralByCode",
       "getReferralSummary",
+      "adminGetReferralProfileByUserId",
+      "adminUpdateReferralProfileByUserId",
+      "getUserReferralMetrics",
       "listReferrals",
       "getReferredUserIds",
       "batchGetDirectReferrersByUserIds",

package/gen/user.ts

@@ -95,6 +95,53 @@ export interface UserResponse {
   advChannelName?: string | undefined;
 }
 
+export interface AdminGetUserForUpdateRequest {
+  userId: number;
+}
+
+export interface AdminUserForUpdateResponse {
+  id: number;
+  uid: number;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+  email?: string | undefined;
+  phone?: string | undefined;
+  telegramUsername?: string | undefined;
+  telegramId?: string | undefined;
+  whatsapp?: string | undefined;
+  advChannel?: string | undefined;
+  refCode?: string | undefined;
+  referrerUserId?: number | undefined;
+  bonusType?: UserSearchBonusType | undefined;
+  refPercent?:
+    | number
+    | undefined;
+  /** true, если в рамках AdminUpdateUserProfile был установлен referrer_user_id. */
+  referrerChanged: boolean;
+}
+
+export interface AdminUpdateUserProfileRequest {
+  userId: number;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+  email?: string | undefined;
+  phone?: string | undefined;
+  telegramUsername?: string | undefined;
+  telegramId?: string | undefined;
+  whatsapp?: string | undefined;
+  advChannel?: string | undefined;
+  refCode?:
+    | string
+    | undefined;
+  /**
+   * Разрешено только если у пользователя еще нет реферера.
+   * Если текущий реферер уже задан, сервис возвращает ошибку REFERRER_ALREADY_SET.
+   */
+  referrerUserId?: number | undefined;
+  bonusType?: UserSearchBonusType | undefined;
+  refPercent?: number | undefined;
+}
+
 export interface UpdateUserRequest {
   userId: number;
   firstName?: string | undefined;
@@ -582,8 +629,16 @@ export const USER_PACKAGE_NAME = "user";
 export interface UserServiceClient {
   getUser(request: GetUserRequest): Observable<UserResponse>;
 
+  /** CRM admin: получить поля пользователя для формы редактирования. */
+
+  adminGetUserForUpdate(request: AdminGetUserForUpdateRequest): Observable<AdminUserForUpdateResponse>;
+
   updateUser(request: UpdateUserRequest): Observable<UserResponse>;
 
+  /** CRM admin: обновить редактируемые поля пользователя. */
+
+  adminUpdateUserProfile(request: AdminUpdateUserProfileRequest): Observable<AdminUserForUpdateResponse>;
+
   updateUserStatus(request: UpdateUserStatusRequest): Observable<UserResponse>;
 
   listUsers(request: ListUsersRequest): Observable<ListUsersResponse>;
@@ -718,8 +773,20 @@ export interface UserServiceClient {
 export interface UserServiceController {
   getUser(request: GetUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
 
+  /** CRM admin: получить поля пользователя для формы редактирования. */
+
+  adminGetUserForUpdate(
+    request: AdminGetUserForUpdateRequest,
+  ): Promise<AdminUserForUpdateResponse> | Observable<AdminUserForUpdateResponse> | AdminUserForUpdateResponse;
+
   updateUser(request: UpdateUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
 
+  /** CRM admin: обновить редактируемые поля пользователя. */
+
+  adminUpdateUserProfile(
+    request: AdminUpdateUserProfileRequest,
+  ): Promise<AdminUserForUpdateResponse> | Observable<AdminUserForUpdateResponse> | AdminUserForUpdateResponse;
+
   updateUserStatus(request: UpdateUserStatusRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
 
   listUsers(request: ListUsersRequest): Promise<ListUsersResponse> | Observable<ListUsersResponse> | ListUsersResponse;
@@ -959,7 +1026,9 @@ export function UserServiceControllerMethods() {
   return function (constructor: Function) {
     const grpcMethods: string[] = [
       "getUser",
+      "adminGetUserForUpdate",
       "updateUser",
+      "adminUpdateUserProfile",
       "updateUserStatus",
       "listUsers",
       "updateUserSearchStats",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arbiwallet/contracts",
   "descriptions": "Generate and manage smart contracts for ArbiWallet",
-  "version": "1.0.279",
+  "version": "1.0.281",
   "scripts": {
     "generate": "protoc -I ./proto ./proto/*.proto --ts_proto_out=./gen --ts_proto_opt=nestJs=true,package=omit"
   },

package/proto/exchange_core.proto

@@ -22,6 +22,7 @@ service ExchangeCoreService {
   rpc CancelExchangeDeal(CancelExchangeDealRequest) returns (CancelExchangeDealResponse);
   rpc GetUserIdsWithDealsInPeriod(GetUserIdsWithDealsInPeriodRequest) returns (GetUserIdsWithDealsInPeriodResponse);
   rpc BatchGetUserDealStats(BatchGetUserDealStatsRequest) returns (BatchGetUserDealStatsResponse);
+  rpc GetUserMetrics(GetUserMetricsRequest) returns (GetUserMetricsResponse);
 
   rpc CreateExchangePayment(CreateExchangePaymentRequest) returns (CreateExchangePaymentResponse);
   rpc HandlePaymentWebhook(HandlePaymentWebhookRequest) returns (HandlePaymentWebhookResponse);
@@ -408,6 +409,30 @@ message BatchGetUserDealStatsResponse {
   repeated UserDealStats items = 1;
 }
 
+message GetUserMetricsRequest {
+  int32 user_id = 1;
+  optional string date_from = 2;
+  optional string date_to = 3;
+}
+
+message UserDebtByCurrency {
+  string currency = 1;
+  double amount = 2;
+}
+
+message UserMetricsSnapshot {
+  double total_profit = 1;
+  int32 deals_count = 2;
+  repeated UserDebtByCurrency client_debt = 3;
+  double average_markup = 4;
+  double average_check = 5;
+}
+
+message GetUserMetricsResponse {
+  UserMetricsSnapshot period = 1;
+  UserMetricsSnapshot today = 2;
+}
+
 message ExchangeCalculationsFiltersRequest {
   optional string date_from = 1;
   optional string date_to = 2;

package/proto/referral.proto

@@ -9,6 +9,11 @@ service ReferralService {
   rpc GetReferralLink(GetReferralLinkRequest) returns (GetReferralLinkResponse);
   rpc BindReferralByCode(BindReferralByCodeRequest) returns (BindReferralByCodeResponse);
   rpc GetReferralSummary(GetReferralSummaryRequest) returns (GetReferralSummaryResponse);
+  // CRM admin: получить реферальный профиль для формы редактирования пользователя.
+  rpc AdminGetReferralProfileByUserId(AdminGetReferralProfileByUserIdRequest) returns (AdminReferralProfileByUserIdResponse);
+  // CRM admin: обновить реферальный профиль (реферер, тип начисления, процент, ref code).
+  rpc AdminUpdateReferralProfileByUserId(AdminUpdateReferralProfileByUserIdRequest) returns (AdminReferralProfileByUserIdResponse);
+  rpc GetUserReferralMetrics(GetUserReferralMetricsRequest) returns (GetUserReferralMetricsResponse);
   rpc ListReferrals(ListReferralsRequest) returns (ListReferralsResponse);
   rpc GetReferredUserIds(GetReferredUserIdsRequest) returns (GetReferredUserIdsResponse);
   rpc BatchGetDirectReferrersByUserIds(BatchGetDirectReferrersByUserIdsRequest) returns (BatchGetDirectReferrersByUserIdsResponse);
@@ -110,6 +115,46 @@ message GetReferralSummaryResponse {
   string available_usdt_balance = 6;
 }
 
+message AdminGetReferralProfileByUserIdRequest {
+  int32 user_id = 1;
+}
+
+message AdminReferralProfileByUserIdResponse {
+  string profile_id = 1;
+  int32 user_id = 2;
+  string ref_code = 3;
+  optional int32 referrer_user_id = 4;
+  ReferralBonusType bonus_type = 5;
+  string ref_percent = 6;
+  ReferralProfileStatus status = 7;
+  string created_at = 8;
+  string updated_at = 9;
+  // true, если в рамках AdminUpdateReferralProfileByUserId был установлен referrer_user_id.
+  bool referrer_changed = 10;
+}
+
+message AdminUpdateReferralProfileByUserIdRequest {
+  int32 user_id = 1;
+  // Разрешено только если у профиля еще нет реферера.
+  // Если текущий реферер уже задан, сервис возвращает ошибку REFERRER_ALREADY_SET.
+  optional int32 referrer_user_id = 2;
+  optional ReferralBonusType bonus_type = 3;
+  optional string ref_percent = 4;
+  optional string ref_code = 5;
+  optional string changed_by = 6;
+}
+
+message GetUserReferralMetricsRequest {
+  string wallet_user_id = 1;
+  optional string date_from = 2;
+  optional string date_to = 3;
+}
+
+message GetUserReferralMetricsResponse {
+  int32 referrals_count = 1;
+  int32 referrals_today = 2;
+}
+
 message ListReferralsRequest {
   string wallet_user_id = 1;
   optional int32 page = 2;

package/proto/user.proto

@@ -3,7 +3,11 @@ package user;
 
 service UserService {
   rpc GetUser (GetUserRequest) returns (UserResponse);
+  // CRM admin: получить поля пользователя для формы редактирования.
+  rpc AdminGetUserForUpdate (AdminGetUserForUpdateRequest) returns (AdminUserForUpdateResponse);
   rpc UpdateUser (UpdateUserRequest) returns (UserResponse);
+  // CRM admin: обновить редактируемые поля пользователя.
+  rpc AdminUpdateUserProfile (AdminUpdateUserProfileRequest) returns (AdminUserForUpdateResponse);
   rpc UpdateUserStatus (UpdateUserStatusRequest) returns (UserResponse);
   rpc ListUsers (ListUsersRequest) returns (ListUsersResponse);
   rpc UpdateUserSearchStats (UpdateUserSearchStatsRequest) returns (UpdateUserSearchStatsResponse);
@@ -135,6 +139,47 @@ message UserResponse {
   optional string adv_channel_name = 42;
 }
 
+message AdminGetUserForUpdateRequest {
+  int32 user_id = 1;
+}
+
+message AdminUserForUpdateResponse {
+  int32 id = 1;
+  int32 uid = 2;
+  optional string first_name = 3;
+  optional string last_name = 4;
+  optional string email = 5;
+  optional string phone = 6;
+  optional string telegram_username = 7;
+  optional string telegram_id = 8;
+  optional string whatsapp = 9;
+  optional string adv_channel = 10;
+  optional string ref_code = 11;
+  optional int32 referrer_user_id = 12;
+  optional UserSearchBonusType bonus_type = 13;
+  optional double ref_percent = 14;
+  // true, если в рамках AdminUpdateUserProfile был установлен referrer_user_id.
+  bool referrer_changed = 15;
+}
+
+message AdminUpdateUserProfileRequest {
+  int32 user_id = 1;
+  optional string first_name = 2;
+  optional string last_name = 3;
+  optional string email = 4;
+  optional string phone = 5;
+  optional string telegram_username = 6;
+  optional string telegram_id = 7;
+  optional string whatsapp = 8;
+  optional string adv_channel = 9;
+  optional string ref_code = 10;
+  // Разрешено только если у пользователя еще нет реферера.
+  // Если текущий реферер уже задан, сервис возвращает ошибку REFERRER_ALREADY_SET.
+  optional int32 referrer_user_id = 11;
+  optional UserSearchBonusType bonus_type = 12;
+  optional double ref_percent = 13;
+}
+
 message UpdateUserRequest {
   int32 user_id = 1;
   optional string first_name = 2;