gm-mcp 1.0.7

package/src/services/lark.service.ts

@@ -0,0 +1,122 @@
+import axios from "axios";
+import * as lark from "@larksuiteoapi/node-sdk";
+import { getEnv } from "../env";
+// const LARK_BASE_TABLE_ID = process.env['LARK_BASE_TABLE_ID'];
+// const LARK_BITABLE_APP_TOKEN = process.env['LARK_BITABLE_APP_TOKEN'];
+// group test_bot
+// const LARK_X3_GROUP_ID = 'oc_bb4e5b8dd8ada38127c790fa368c02b9';
+// Group dan choi front end
+
+const larkClient = new lark.Client({
+  appId: getEnv().LARK_APP_ID,
+  appSecret: getEnv().LARK_APP_SECRET,
+  disableTokenCache: true,
+});
+
+async function getAccessToken() {
+  const url = "https://open.larksuite.com/open-apis/auth/v3/tenant_access_token/internal";
+  return axios
+    .post<{
+      code: number;
+      msg: string;
+      tenant_access_token: string;
+      expire: number;
+    }>(url, {
+      app_id: getEnv().LARK_APP_ID,
+      app_secret: getEnv().LARK_APP_SECRET,
+    })
+    .then((res) => res.data.tenant_access_token);
+}
+
+// export async function logX3Issue(p: {
+//   phone: string;
+//   company: string;
+//   created_at: number;
+//   customer_name: string;
+//   ekyc_link: { text: string; link: string };
+//   type: "ekyc" | "cic" | "datanest" | "pending_application";
+//   ops_status: "pending" | "done";
+//   assignee: { id: string }[];
+//   created_by: { id: string }[];
+// }) {
+//   return logBaseRecord(
+//     { tableId: LARK_BASE_TABLE_ID, appToken: LARK_BITABLE_APP_TOKEN },
+//     p
+//   );
+// }
+
+// export async function logBaseRecord(
+//   config: { tableId: string; appToken: string },
+//   record: Record<string, any>
+// ) {
+//   // const fields = new Map<string, any>();
+//   // Object.entries(record).forEach(([key, value]) => fields.set(key, value))
+//   const access_token = await getAccessToken();
+//   return larkClient.bitable.appTableRecord.create(
+//     {
+//       path: {
+//         app_token: config.appToken,
+//         table_id: config.tableId,
+//       },
+//       data: {
+//         fields: record,
+//       },
+//     },
+//     lark.withTenantToken(access_token)
+//   );
+// }
+
+// Split later
+export async function sendStatisticX3Message(data: { date: string; content: string }) {
+  const access_token = await getAccessToken();
+  const { date, content } = data;
+  const messageContent = {
+    type: "template",
+    data: {
+      template_id: getEnv().LARK_X3_TEMPLATE_ID,
+      // template_id: 'ctp_AAdI5Sp48YUT',
+      template_variable: {
+        date,
+        content,
+      },
+    },
+  };
+  return larkClient.im.message.create(
+    {
+      params: {
+        receive_id_type: "chat_id",
+      },
+      data: {
+        receive_id: getEnv().LARK_X3_GROUP_ID,
+        msg_type: "interactive",
+        content: JSON.stringify(messageContent),
+      },
+    },
+    lark.withTenantToken(access_token)
+  );
+}
+
+export async function sendLarkTextMessage(p: { message_content: { text: string }; receive_id: string }) {
+  const { message_content, receive_id } = p;
+  const access_token = await getAccessToken();
+  return larkClient.im.message.create(
+    {
+      params: {
+        receive_id_type: "chat_id",
+      },
+      data: {
+        receive_id,
+        msg_type: "text",
+        content: JSON.stringify(message_content),
+      },
+    },
+    lark.withTenantToken(access_token)
+  );
+}
+
+export async function sendMessageToX3Group(message_content: { text: string }) {
+  return sendLarkTextMessage({
+    receive_id: getEnv().LARK_X3_GROUP_ID,
+    message_content,
+  });
+}

package/src/services/lending.service.ts

@@ -0,0 +1,107 @@
+import axios from "axios";
+import { getEnv } from "../env";
+import { Gimo, GimoLending } from "./types";
+
+async function getAccessToken() {
+  const url = `${getEnv().DASH_URL}/api/v1/auth/admin/login`;
+  return axios
+    .post<Gimo.LoginRes>(url, {
+      password: getEnv().PASSWORD,
+      username: getEnv().USER_NAME,
+    })
+    .then((res) => res.data.access_token);
+}
+
+export async function listApplication(p: GimoLending.FilterApplication) {
+  const url = `${getEnv().LENDING_URL}/api/v1/admin/lending/application/pagination`;
+  const access_token = await getAccessToken();
+  return axios
+    .get<{
+      result: {
+        content: GimoLending.Application[];
+        size: number;
+        total_elements: number;
+        total_pages: number;
+      };
+    }>(url, {
+      headers: {
+        Authorization: "Bearer " + access_token,
+      },
+      params: {
+        ...p,
+        sort: "created_at,DESC",
+      },
+    })
+    .then((res) => res.data.result);
+}
+
+export async function statisticLoan(p: GimoLending.FilterLoan) {
+  const url = `${getEnv().LENDING_URL}/api/v1/admin/lending/instance/pagination`;
+  const access_token = await getAccessToken();
+  return axios
+    .get<{
+      result: {
+        loan_instance_list_statistics: GimoLending.LoanStatistic;
+      };
+    }>(url, {
+      headers: {
+        Authorization: "Bearer " + access_token,
+      },
+      params: {
+        ...p,
+        sort: "created_at,DESC",
+      },
+    })
+    .then((res) => res.data.result.loan_instance_list_statistics);
+}
+
+export async function statisticX3(p: GimoLending.FilterApplication) {
+  const { created_from, created_to } = p;
+  try {
+    const { content: applications, total_elements } = await listApplication({
+      created_to,
+      created_from,
+      size: 1_000_000,
+    });
+    const loan_statistic = await statisticLoan({
+      disbursementTimeFrom: created_from,
+      disbursementTimeTo: created_to,
+    });
+    const total_appraisal = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.APPRAISAL
+    ).length;
+    const total_approval = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.APPROVAL
+    ).length;
+    const total_confrimed = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.CONFIRMED
+    ).length;
+    const total_rejected = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.REJECTED
+    ).length;
+    const total_signed = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.SIGNED
+    ).length;
+    const total_closed = applications.filter(
+      (item) => item.status === GimoLending.LendingApplicationStatus.CLOSED
+    ).length;
+
+    const total_dibursed = applications.filter(
+      (item) => item.disbursement_status === GimoLending.LoanDisbursementStatus.DISBURSED
+    ).length;
+
+    return {
+      total: total_elements,
+      total_appraisal,
+      total_approval,
+      total_confrimed,
+      total_rejected,
+      total_signed,
+      total_closed,
+      total_dibursed,
+      loan_statistic,
+    };
+  } catch (error) {
+    throw error;
+  }
+}

package/src/services/types/gimo.type.ts

@@ -0,0 +1,184 @@
+// eslint-disable-next-line @typescript-eslint/no-namespace
+export namespace Gimo {
+  export interface LoginRes {
+    user_id: number;
+    access_token: string;
+    access_token_expires_at: number;
+    token_type: string;
+    change_password_token: string;
+    require_change_password: string;
+  }
+
+  export interface CustomerEWA {
+    customer_id: number;
+    customer_full_name: string;
+    customer_code?: string;
+    identify_number?: string;
+    employee_id?: number;
+    employee_code?: string;
+    partner_id?: number;
+    partner_name?: string;
+    debt_collection_type?: string;
+    onboard_method?: string;
+    verification_status?: string;
+    working_status: string;
+    dda_status?: string;
+    ewa_longest_over_due_day: string;
+    ewa_debt_amount?: number;
+    ewa_status?: string;
+    customer_phone_number: string;
+    created_at: string;
+    updated_at: string;
+    bank_full_name?: string;
+    bank_id?: number;
+    bank_name?: string;
+    bank_acc_number?: string;
+    customer_service_id?: number;
+  }
+
+  export interface Customer {
+    id: number;
+    ewa_customer_id?: number;
+    customer_code?: string;
+    avatar?: string;
+    phone_number?: string;
+    full_name?: string;
+    dda_code?: string;
+    active?: boolean;
+    created_at?: string;
+    created_by?: string;
+    verified_at?: string;
+    is_verified?: boolean;
+    customer_ewa_id?: number;
+    link_employees?: LinkedEmployee[];
+  }
+
+  export interface EmployeeV1 {
+    id: number;
+    active: boolean;
+    suspend: boolean;
+    gender: string;
+    birth_date: Date;
+    status: string;
+    code: string;
+    partner_id: number;
+    organization_id: number;
+    organization_name: number;
+    partner_name: string;
+    mobile_phone: string;
+    first_name: string;
+    middle_name: string;
+    last_name: string;
+    id_number: string;
+    bank_id: number;
+    bank_name: string;
+    bank_first_name: string;
+    bank_middle_name: string;
+    bank_last_name: string;
+    bank_full_name: string;
+    bank_acc_number: string;
+    start_date: string;
+    id_issued_date: Date;
+    id_issued_by: string;
+    number_of_dependents: number;
+    married_status: boolean;
+    mail_address: string;
+    address: string;
+    position: string;
+    wage: number;
+    full_name: string;
+    customer_code: string;
+    customer_id: number; // customer_id actually is ewa_customer_id: this is an old API from ewa service. new customer_id is migrated to customer service.
+    rules: any[];
+    total_contract_disbursed: number;
+    verified: boolean;
+    total_disbursed_contract_in_pay_period: number;
+    disbursed_contract_in_month: boolean;
+    bank_acc_verified: boolean;
+    updated_at: Date;
+    created_at: Date;
+    remaining_amount: number;
+    employee_timekeepers: any[];
+    has_income_from_attendance: boolean;
+    dda_code?: string;
+    dda_status?: string;
+    reason?: string;
+    seniority?: number;
+    partner?: any;
+    cancel_dda_count?: number;
+  }
+
+  export interface EmployeeInfo {
+    employee_id: number;
+    employee_code?: string;
+    verified?: boolean;
+    employee?: EmployeeV1 & { onboard_id?: number };
+    link_employees?: LinkedEmployee[];
+    partner_id?: number;
+    partner?: any;
+  }
+  export interface LinkedEmployee {
+    employee_id: number;
+    employee_code: string;
+    partner_id: number;
+    partner_name: string;
+    partner_onboard_method?: string;
+    verification_status: boolean;
+    work_status: boolean;
+    verification_time?: string;
+    debt_collection?: string;
+    onboard_id?: number;
+    allow_access?: boolean;
+    status?: string;
+    reason?: string;
+    seniority?: number;
+  }
+
+  export interface Contract {
+    [key: string]: any;
+  }
+
+  export interface PaymentTxn {
+    code?: string;
+    ref_transaction_id?: number;
+    ref_transaction_code?: string;
+    bank_integration_name?: string;
+    transfer_type?: string;
+    ref_customer_id?: number;
+    customer_code?: string;
+    customer_name?: string;
+    customer_phone?: string;
+    bank_account_number?: string;
+    bank_account_name?: string;
+    bank_name?: string;
+    amount?: number;
+    ref_product_id?: number;
+    ref_product_name?: string;
+    response_time: string;
+    trace_key?: string;
+    status?: string;
+    service_source?: string;
+    request_time?: string;
+    updated_at?: string;
+    debit_resource_number?: string;
+    display_error_message?: string;
+    suggestion_message?: string;
+    request_logs?: any[];
+    partner_id?: number;
+    [key: string]: any;
+  }
+
+  export interface ContractWithTxn extends Contract {
+    transactions: PaymentTxn[];
+  }
+
+  export interface AccountingCustomer {
+    customer_fee_amount: number;
+    outstanding_balance: number;
+    partner_fee_amount: number;
+    total_actual_amount: number;
+    total_contract_number: number;
+    total_fee_amount: number;
+    total_request_amount: number;
+  }
+}

package/src/services/types/index.ts

@@ -0,0 +1,2 @@
+export * from './gimo.type';
+export * from './lending.type';

package/src/services/types/lending.type.ts

@@ -0,0 +1,181 @@
+export namespace GimoLending {
+  export interface Application {
+    id: string;
+    fund_provider_code: string;
+    product_scheme_name: any;
+    status: string;
+    bank_id: number;
+    bank_account_number: string;
+    bank_code: string;
+    bank_account_name: string;
+    loan_request: LoanRequest;
+    loan_offer?: LoanOffer;
+    loan_instance: any;
+    customer_info?: CustomerInfo;
+    underwriting_decision_result: UnderwritingDecisionResult;
+    suspend_registration_reason?: string;
+    suspend_registration_until?: string;
+    disbursement_time?: string;
+    disbursement_status?: string;
+    contract_error_code?: string;
+    reject_message?: string;
+    contract_status?: string;
+    created_at: string;
+    updated_at: string;
+    created_by: string;
+    updated_by: string;
+  }
+
+  export interface FilterApplication {
+    created_from?: string;
+    created_to?: string;
+    page?: number;
+    size?: number;
+    sort?: string;
+    [key: string]: any;
+  }
+
+  export interface FilterLoan {
+    disbursementTimeFrom?: string;
+    disbursementTimeTo?: string;
+    page?: number;
+    size?: number;
+    sort?: string;
+    [key: string]: any;
+  }
+
+  export interface LoanStatistic {
+    total_disbursement_amount: number;
+    total_interest_amount: number;
+    total_payment_amount: number;
+  }
+
+  export interface LoanOffer {
+    id: string;
+    loan_offer_amount?: number | null;
+    interest_rate: number;
+    repayment_amount_per_repayment: number;
+    repayment_frequency_type: string;
+    repayment_every: number;
+    number_of_repayments: number;
+    offer_at: string;
+    offer_expire_at: string;
+    created_by: string;
+    created_at: string;
+    updated_by: string;
+    updated_at: string;
+    offer_emi?: number;
+  }
+
+  export interface LoanRequest {
+    id: string;
+    submit_form_id: number;
+    loan_request_amount?: number | null;
+    interest_rate: number;
+    repayment_amount_per_repayment: number;
+    repayment_frequency_type: string;
+    repayment_every: number;
+    number_of_repayments: number;
+    created_by: string;
+    created_at: string;
+    updated_by: string;
+    updated_at: string;
+    request_emi?: number;
+  }
+
+  export interface CustomerInfo {
+    customer_service_id: number;
+    customer_code: string;
+    customer_ewa_id: number;
+    phone_number: string;
+    full_name: string;
+    occupation: string;
+    partner_id: number;
+    partner_name: string;
+    position: any;
+    average_income: number;
+    sector_income: number;
+    address: string;
+    province_code: string;
+    province_name: string;
+    ward_code: string;
+    ward_name: string;
+    district_code: string;
+    district_name: string;
+    marital_status: string;
+    ekyc_request_id: number;
+    id_front_image: string;
+    id_back_image: string;
+    id_issue_date: string;
+    id_issue_loc: string;
+    identification_number?: number;
+    contact_person_list: ContactPersonList[];
+    tem_address?: string;
+    tem_district_code?: string;
+    tem_district_name?: string;
+    tem_province_code?: string;
+    tem_province_name?: string;
+    tem_ward_code?: string;
+    tem_ward_name?: string;
+  }
+
+  export interface ContactPersonList {
+    full_name: string;
+    phone_number: string;
+    relation_ship: string;
+    identification_number?: string;
+  }
+
+  export interface UnderwritingDecisionResult {
+    hard_rule?: {
+      error_message: string;
+      screen_solution: string;
+      trace_id: string;
+      hard_rule_criteria: HardRuleCriteria[];
+      pass: boolean;
+    };
+    segment_rule?: SegmentRuleCriteria;
+  }
+
+  export interface HardRuleCriteria {
+    criteria: string;
+    is_passed: boolean;
+    key: string;
+    key_banned: string;
+    value: any;
+  }
+
+  export interface SegmentRuleCriteria {
+    portfolio: string;
+    product_scheme: any;
+    income: number;
+    seniority: number;
+  }
+
+  export enum LendingApplicationStatus {
+    APPRAISAL = "APPRAISAL",
+    APPROVAL = "APPROVAL",
+    CONFIRMED = "CONFIRMED",
+    REJECTED = "REJECTED",
+    SIGNED = "SIGNED",
+    CLOSED = "CLOSED",
+  }
+
+  export enum LoanDisbursementStatus {
+    DISBURSING = "DISBURSING",
+    DISBURSED = "DISBURSED",
+    FAILED = "FAILED",
+  }
+
+  export interface StatisticX3 {
+    total?: number;
+    total_appraisal?: number;
+    total_approval?: number;
+    total_confrimed?: number;
+    total_rejected?: number;
+    total_signed?: number;
+    total_closed?: number;
+    total_dibursed?: number;
+    loan_statistic?: GimoLending.LoanStatistic;
+  }
+}

package/src/test.ts

@@ -0,0 +1,38 @@
+import { ensureEnvVariables, getEnv } from "./env";
+import { sendLarkTextMessage, sendMessageToX3Group } from "./services/lark.service";
+import {
+  statisticX3RangeTool,
+  statisticX3TodayTool,
+  statisticX3Tool,
+  statisticX3WeekTool,
+  statisticX3YesterdayTool,
+} from "./tools";
+
+async function setupTest() {
+  ensureEnvVariables();
+  const sendMessageToLark = getEnv().SEND_MESSAGE_TO_LARK;
+
+  // const reuslt = await statisticX3TodayTool({ sendMessageToLark: false });
+  // console.log(reuslt);
+  // const reuslt = await statisticX3Tool({ sendMessageToLark: false, date: "11/06/2025" });
+  // console.log(reuslt);
+  // const reuslt = await statisticX3WeekTool({ sendMessageToLark: false });
+  // console.log(reuslt);
+  // const reuslt = await statisticX3YesterdayTool({ sendMessageToLark: false });
+  // console.log(reuslt);
+
+  // const reuslt = await statisticX3RangeTool({
+  //   sendMessageToLark: sendMessageToLark,
+  //   startDateStr: "10-06-2025",
+  //   endDateStr: "20-06-2025",
+  // });
+  // console.log(reuslt);
+  // const inovationMess =
+  //   "Một tuần làm việc sắp kết thúc, tất cả chúng ta đều đã rất nỗ lực và cố gắng. Hãy cùng điểm nhanh lại những thông số của dự án nhé. Dành thời gian cho bản thân và nạp năng lượng cho tuần mới nhé cả nhé GIMO";
+  // const inovationMess2 = "end of week";
+  // await sendMessageToX3Group({ text: inovationMess });
+  // await statisticX3WeekTool({ sendMessageToLark: true });
+  // console.log('done');
+}
+
+setupTest();

package/src/tools/index.ts

@@ -0,0 +1 @@
+export * from './statistic-x3';