Merge branch 'main' of http://1.117.67.95:3000/team/qnc-server-v3

2026-03-02 12:57:17 +08:00
parent 6db59f1dea a083fdca46
commit e8da86f1a6
45 changed files with 1788 additions and 246 deletions
--- a/app/main/api/desc/front/agent.api
+++ b/app/main/api/desc/front/agent.api
@@ -1,5 +1,7 @@
 syntax = "v1"

+import "product.api"
+
 info (
 	title:   "代理服务"
 	desc:    "新代理系统接口"
@@ -121,6 +123,14 @@ type (
 	GetInviteLinkResp {
 		InviteLink string `json:"invite_link"` // 邀请链接
 	}
+	// 生成邀请海报请求
+	GenerateInvitePosterReq {
+		InviteLink string `form:"invite_link"` // 邀请链接（用于生成二维码）
+	}
+	// 生成邀请海报响应
+	GenerateInvitePosterResp {
+		PosterUrl string `json:"poster_url"` // 海报图片URL（base64编码的data URL）
+	}
 	// 获取代理等级特权信息
 	GetLevelPrivilegeResp {
 		Levels                 []LevelPrivilegeItem `json:"levels"`
@@ -224,6 +234,10 @@ service main {
 	@handler ApplyWithdrawal
 	post /withdrawal/apply (ApplyWithdrawalReq) returns (ApplyWithdrawalResp)

+	// 获取上次提现信息（用于前端预填）
+	@handler GetLastWithdrawalInfo
+	get /withdrawal/last_info (GetLastWithdrawalInfoReq) returns (GetLastWithdrawalInfoResp)
+
 	// 实名认证
 	@handler RealNameAuth
 	post /real_name (RealNameAuthReq) returns (RealNameAuthResp)
@@ -244,6 +258,10 @@ service main {
 	@handler GetInviteLink
 	get /invite_link (GetInviteLinkReq) returns (GetInviteLinkResp)

+	// 生成邀请海报（带二维码的图片）
+	@handler GenerateInvitePoster
+	get /invite/poster (GenerateInvitePosterReq) returns (GenerateInvitePosterResp)
+
 	// 获取代理等级特权信息
 	@handler GetLevelPrivilege
 	get /level/privilege returns (GetLevelPrivilegeResp)
@@ -277,6 +295,32 @@ service main {
 	// 检查订单是否属于当前代理推广
 	@handler CheckOrderAgent
 	get /order/agent (CheckOrderAgentReq) returns (CheckOrderAgentResp)
+
+	// ============================================
+	// 用户模块白名单相关接口
+	// ============================================
+	@handler GetWhitelistFeatures
+	get /whitelist/features (GetWhitelistFeaturesReq) returns (GetWhitelistFeaturesResp)
+
+	// 创建白名单订单
+	@handler CreateWhitelistOrder
+	post /whitelist/order/create (CreateWhitelistOrderReq) returns (CreateWhitelistOrderResp)
+
+	// 获取用户白名单列表
+	@handler GetWhitelistList
+	get /whitelist/list (GetWhitelistListReq) returns (GetWhitelistListResp)
+
+	// 检查模块是否已下架（用于显示下架按钮状态）
+	@handler CheckFeatureWhitelistStatus
+	get /whitelist/check (CheckFeatureWhitelistStatusReq) returns (CheckFeatureWhitelistStatusResp)
+
+	// 下架单个模块（创建订单并支付）
+	@handler OfflineFeature
+	post /whitelist/offline (OfflineFeatureReq) returns (OfflineFeatureResp)
+
+	// 检查订单是否属于当前代理推广
+	@handler CheckOrderAgent
+	get /order/agent (CheckOrderAgentReq) returns (CheckOrderAgentResp)
 }

 type (
@@ -439,28 +483,30 @@ type (
 		LevelName         string  `json:"level_name"` // 等级名称
 		Mobile            string  `json:"mobile"` // 手机号
 		CreateTime        string  `json:"create_time"` // 加入团队时间
-		TotalRebateAmount float64 `json:"total_rebate_amount"` // 返佣给我的总金额
-		TodayRebateAmount float64 `json:"today_rebate_amount"` // 返佣给我的今日金额
-		TodayInvites      int64   `json:"today_invites"` // 邀请加入团队的今日人数
-		MonthInvites      int64   `json:"month_invites"` // 邀请加入团队的本月人数
-		TotalInvites      int64   `json:"total_invites"` // 邀请加入团队的总人数
 		TodayQueries      int64   `json:"today_queries"` // 当日查询量
 		MonthQueries      int64   `json:"month_queries"` // 本月查询量
 		TotalQueries      int64   `json:"total_queries"` // 总查询量
+		TotalRebateAmount float64 `json:"total_rebate_amount"` // 返佣给我的总金额
+		TodayRebateAmount float64 `json:"today_rebate_amount"` // 返佣给我的今日金额
+		TotalInvites      int64   `json:"total_invites"` // 邀请加入团队的总人数
+		TodayInvites      int64   `json:"today_invites"` // 邀请加入团队的今日人数
+		MonthInvites      int64   `json:"month_invites"` // 邀请加入团队的本月人数
 		IsDirect          bool    `json:"is_direct"` // 是否直接下级
 	}
 	// 收益信息
 	GetRevenueInfoResp {
-		Balance         float64 `json:"balance"` // 可用余额
-		FrozenBalance   float64 `json:"frozen_balance"` // 冻结余额
-		TotalEarnings   float64 `json:"total_earnings"` // 累计收益（钱包总收益）
-		WithdrawnAmount float64 `json:"withdrawn_amount"` // 累计提现
-		CommissionTotal float64 `json:"commission_total"` // 佣金累计总收益（推广订单获得的佣金）
-		CommissionToday float64 `json:"commission_today"` // 佣金今日收益
-		CommissionMonth float64 `json:"commission_month"` // 佣金本月收益
-		RebateTotal     float64 `json:"rebate_total"` // 返佣累计总收益（包括推广返佣和升级返佣）
-		RebateToday     float64 `json:"rebate_today"` // 返佣今日收益
-		RebateMonth     float64 `json:"rebate_month"` // 返佣本月收益
+		Balance          float64 `json:"balance"` // 可用余额
+		FrozenBalance    float64 `json:"frozen_balance"` // 冻结余额
+		TotalEarnings    float64 `json:"total_earnings"` // 累计收益（钱包总收益）
+		WithdrawnAmount  float64 `json:"withdrawn_amount"` // 累计提现
+		CommissionTotal  float64 `json:"commission_total"` // 佣金累计总收益（推广订单获得的佣金）
+		CommissionToday  float64 `json:"commission_today"` // 佣金今日收益
+		CommissionMonth  float64 `json:"commission_month"` // 佣金本月收益
+		RebateTotal      float64 `json:"rebate_total"` // 返佣累计总收益（包括推广返佣和升级返佣）
+		RebateToday      float64 `json:"rebate_today"` // 返佣今日收益
+		RebateMonth      float64 `json:"rebate_month"` // 返佣本月收益
+		AlipayMonthQuota float64 `json:"alipay_month_quota"` // 支付宝每月提现总额度
+		AlipayMonthUsed  float64 `json:"alipay_month_used"` // 本月已使用的支付宝提现额度
 	}
 	// 佣金记录
 	GetCommissionListReq {
@@ -499,6 +545,7 @@ type (
 		OrderNo           string  `json:"order_no"` // 订单号
 		RebateType        int64   `json:"rebate_type"` // 返佣类型：1=直接上级，2=钻石上级，3=黄金上级
 		Amount            float64 `json:"amount"` // 返佣金额
+		Status            int64   `json:"status"` // 状态：1=已发放，2=已冻结，3=已取消（已退款）
 		CreateTime        string  `json:"create_time"` // 创建时间
 	}
 	// 升级返佣记录
@@ -565,28 +612,46 @@ type (
 		Total int64            `json:"total"` // 总数
 		List  []WithdrawalItem `json:"list"` // 列表
 	}
+	// 提现记录
 	WithdrawalItem {
-		Id           string  `json:"id"` // 记录ID
-		WithdrawalNo string  `json:"withdrawal_no"` // 提现单号
-		Amount       float64 `json:"amount"` // 提现金额
-		TaxAmount    float64 `json:"tax_amount"` // 税费金额
-		ActualAmount float64 `json:"actual_amount"` // 实际到账金额
-		Status       int64   `json:"status"` // 状态：1=待审核，2=审核通过，3=审核拒绝，4=提现中，5=提现成功，6=提现失败
-		PayeeAccount string  `json:"payee_account"` // 收款账户
-		PayeeName    string  `json:"payee_name"` // 收款人姓名
-		Remark       string  `json:"remark"` // 备注
-		CreateTime   string  `json:"create_time"` // 创建时间
+		Id             string  `json:"id"` // 记录ID
+		WithdrawalNo   string  `json:"withdrawal_no"` // 提现单号
+		Amount         float64 `json:"amount"` // 提现金额
+		TaxAmount      float64 `json:"tax_amount"` // 税费金额
+		ActualAmount   float64 `json:"actual_amount"` // 实际到账金额
+		Status         int64   `json:"status"` // 状态：1=待审核，2=审核通过，3=审核拒绝，4=提现中，5=提现成功，6=提现失败
+		WithdrawalType int64   `json:"withdrawal_type"` // 提现方式：1=支付宝，2=银行卡
+		PayeeAccount   string  `json:"payee_account"` // 收款账户（支付宝账号或银行卡号）
+		PayeeName      string  `json:"payee_name"` // 收款人姓名
+		BankCardNo     string  `json:"bank_card_no"` // 银行卡号（银行卡提现时填写）
+		BankName       string  `json:"bank_name"` // 开户行名称（银行卡提现时填写）
+		Remark         string  `json:"remark"` // 备注
+		CreateTime     string  `json:"create_time"` // 创建时间
 	}
 	// 申请提现
 	ApplyWithdrawalReq {
-		Amount       float64 `json:"amount"` // 提现金额
-		PayeeAccount string  `json:"payee_account"` // 收款账户
-		PayeeName    string  `json:"payee_name"` // 收款人姓名
+		Amount         float64 `json:"amount"` // 提现金额
+		WithdrawalType int64   `json:"withdrawal_type"` // 提现方式：1=支付宝，2=银行卡
+		PayeeAccount   string  `json:"payee_account"` // 收款账户（支付宝账号或银行卡号）
+		PayeeName      string  `json:"payee_name"` // 收款人姓名
+		BankCardNo     string  `json:"bank_card_no,optional"` // 银行卡号（银行卡提现必填）
+		BankName       string  `json:"bank_name,optional"` // 开户行名称（银行卡提现必填）
 	}
 	ApplyWithdrawalResp {
 		WithdrawalId string `json:"withdrawal_id"` // 提现记录ID
 		WithdrawalNo string `json:"withdrawal_no"` // 提现单号
 	}
+	// 获取上次提现信息（用于前端预填）
+	GetLastWithdrawalInfoReq {
+		WithdrawalType int64 `form:"withdrawal_type"` // 提现方式：1=支付宝，2=银行卡
+	}
+	GetLastWithdrawalInfoResp {
+		WithdrawalType int64  `json:"withdrawal_type"` // 提现方式
+		PayeeAccount   string `json:"payee_account"` // 收款账户（支付宝账号或银行卡号）
+		PayeeName      string `json:"payee_name"` // 收款人姓名
+		BankCardNo     string `json:"bank_card_no"` // 银行卡号
+		BankName       string `json:"bank_name"` // 开户行名称
+	}
 	// 实名认证
 	RealNameAuthReq {
 		Name   string `json:"name"` // 姓名
@@ -607,13 +672,13 @@ type (
 		List  []PromotionQueryItem `json:"list"` // 列表
 	}
 	PromotionQueryItem {
-		Id          string  `json:"id"` // 查询ID
-		OrderId     string  `json:"order_id"` // 订单ID
-		ProductName string  `json:"product_name"` // 产品名称
-		CreateTime  string  `json:"create_time"` // 创建时间
-		QueryState  string  `json:"query_state"` // 查询状态
+		Id          string                 `json:"id"` // 查询ID
+		OrderId     string                 `json:"order_id"` // 订单ID
+		ProductName string                 `json:"product_name"` // 产品名称
+		CreateTime  string                 `json:"create_time"` // 创建时间
+		QueryState  string                 `json:"query_state"` // 查询状态
 		Params      map[string]interface{} `json:"params,optional"` // 查询参数（已脱敏）
-		Price       float64 `json:"price"` // 查询价格
+		Price       float64                `json:"price"` // 查询价格
 	}
 	// ============================================
 	// 用户模块白名单相关类型
--- a/app/main/api/desc/front/pay.api
+++ b/app/main/api/desc/front/pay.api
@@ -47,6 +47,7 @@ type (
 		Id        string `json:"id"`
 		PayMethod string `json:"pay_method"` // 支付方式: wechat, alipay, appleiap, test(仅开发环境), test_empty(仅开发环境-空报告模式)
 		PayType   string `json:"pay_type" validate:"required,oneof=query agent_vip agent_upgrade"`
+		Code      string `json:"code,optional"` // 微信小程序/H5授权码，用于自动绑定微信账号（当用户未绑定微信时）
 	}
 	PaymentResp {
 		PrepayData interface{} `json:"prepay_data"`
--- a/app/main/api/desc/front/user.api
+++ b/app/main/api/desc/front/user.api
@@ -156,8 +156,26 @@ service main {

 type (
 	sendSmsReq {
-		Mobile     string `json:"mobile" validate:"required,mobile"`
-		ActionType string `json:"actionType" validate:"required,oneof=login register query agentApply realName bindMobile"`
+		Mobile            string `json:"mobile" validate:"required,mobile"`
+		ActionType        string `json:"actionType" validate:"required,oneof=login register query agentApply realName bindMobile"`
+		CaptchaVerifyParam string `json:"captchaVerifyParam,optional"`
+	}
+)
+
+//============================> captcha v1 <============================
+@server (
+	prefix: api/v1
+	group:  captcha
+)
+service main {
+	@doc "get encrypted scene id for aliyun captcha"
+	@handler getEncryptedSceneId
+	post /captcha/encryptedSceneId returns (GetEncryptedSceneIdResp)
+}
+
+type (
+	GetEncryptedSceneIdResp {
+		EncryptedSceneId string `json:"encryptedSceneId"`
 	}
 )