package com.ruoyi.user.mapper;
|
|
import java.util.Date;
|
import java.util.List;
|
import org.apache.ibatis.annotations.Param;
|
import com.ruoyi.user.domain.vo.PartnerEarningStatVo;
|
import com.ruoyi.user.domain.vo.PartnerInviteStatVo;
|
import com.ruoyi.user.domain.vo.PartnerSalesStatVo;
|
import com.ruoyi.user.domain.vo.PartnerSubAccountStatVo;
|
import com.ruoyi.user.domain.vo.PartnerSubAccountVo;
|
|
/**
|
* 服务商首页概览 数据层
|
*
|
* 全部聚合均以 account_user.supplier_id = #{providerUserId} 圈定「名下子账号」范围，
|
* 命中既有索引 idx_account_user_supplier / idx_earning_user_time /
|
* idx_sales_seller_time / idx_purchase_user_time；
|
* 时间区间由 Service 侧算好传入，避免 SQL 内做日期方言运算。
|
*
|
* @author hugray
|
*/
|
public interface AccountPartnerMapper
|
{
|
/**
|
* 聚合子账号总数 / L1-L3 等级分布 / 当月与上月新增绑定数（单条 SQL 取回，避免多次数据库往返）
|
*
|
* 三者同源 account_user（同 where 条件），故合并为一条 SQL。
|
*
|
* @param providerUserId 服务商账号ID
|
* @param monthStart 当月起始（含）
|
* @param nextMonthStart 次月起始（不含）
|
* @param prevMonthStart 上月起始（含）
|
* @return 子账号统计（无数据时各栏为 0）
|
*/
|
public PartnerSubAccountStatVo selectSubAccountStat(@Param("providerUserId") Long providerUserId,
|
@Param("monthStart") Date monthStart,
|
@Param("nextMonthStart") Date nextMonthStart,
|
@Param("prevMonthStart") Date prevMonthStart);
|
|
/**
|
* 聚合名下子账号当月与上月收益合计（来自 account_earning_record）
|
*
|
* @param providerUserId 服务商账号ID
|
* @param monthStart 当月起始（含）
|
* @param nextMonthStart 次月起始（不含）
|
* @param prevMonthStart 上月起始（含）
|
* @return 收益合计（单位：分；无流水时各栏为 0）
|
*/
|
public PartnerEarningStatVo selectEarningMonthStat(@Param("providerUserId") Long providerUserId,
|
@Param("monthStart") Date monthStart,
|
@Param("nextMonthStart") Date nextMonthStart,
|
@Param("prevMonthStart") Date prevMonthStart);
|
|
/**
|
* 聚合名下子账号当月销售额与销售单数（来自 account_sales_record）
|
*
|
* @param providerUserId 服务商账号ID
|
* @param monthStart 当月起始（含）
|
* @param nextMonthStart 次月起始（不含）
|
* @return 销售额（分）与单数（无流水时各栏为 0）
|
*/
|
public PartnerSalesStatVo selectSalesMonthStat(@Param("providerUserId") Long providerUserId,
|
@Param("monthStart") Date monthStart,
|
@Param("nextMonthStart") Date nextMonthStart);
|
|
/**
|
* 聚合名下子账号当月进货额（来自 account_purchase_order）
|
*
|
* @param providerUserId 服务商账号ID
|
* @param monthStart 当月起始（含）
|
* @param nextMonthStart 次月起始（不含）
|
* @return 进货额（单位：分；无流水时为 0）
|
*/
|
public Long selectPurchaseMonthAmount(@Param("providerUserId") Long providerUserId,
|
@Param("monthStart") Date monthStart,
|
@Param("nextMonthStart") Date nextMonthStart);
|
|
/**
|
* 聚合当月新邀请总数与等级分布（推荐人 ∈ 本服务商体系）
|
*
|
* 推荐人范围含服务商本人与名下全部子账号；时间按被邀请会员的 referrer_bind_time 归月。
|
*
|
* @param providerUserId 服务商账号ID
|
* @param monthStart 当月起始（含）
|
* @param nextMonthStart 次月起始（不含）
|
* @return 新邀请总数与 C/L1/L2/L3 分布（无数据时各栏为 0）
|
*/
|
public PartnerInviteStatVo selectInviteMonthStat(@Param("providerUserId") Long providerUserId,
|
@Param("monthStart") Date monthStart,
|
@Param("nextMonthStart") Date nextMonthStart);
|
|
/**
|
* 查询名下子账号列表（供「子账号管理」分页使用）
|
*
|
* 范围：supplier_id = 当前服务商、del_flag = '0'、system_level ∈ {L1,L2,L3}；
|
* level 非空时再按等级过滤（仅接受 L1/L2/L3，非法值由服务层归一为全部）；
|
* keyword 非空时按昵称/手机号模糊匹配（通配符已由服务层转义）；
|
* 按 user_id 倒序（新开通在前）。分页由 Controller 侧 startPage() 织入，语句本身不挂 join，
|
* 避免干扰 PageHelper 的 count SQL。
|
*
|
* @param providerUserId 服务商账号ID
|
* @param level 等级筛选（可空；L1/L2/L3）
|
* @param keyword 昵称/手机号搜索关键字（可空；已转义 like 通配符）
|
* @return 子账号列表（分页）
|
*/
|
public List<PartnerSubAccountVo> selectSubAccountList(@Param("providerUserId") Long providerUserId,
|
@Param("level") String level,
|
@Param("keyword") String keyword);
|
|
/**
|
* 统计名下子账号各等级已开通数（供剩余额度计算）
|
*
|
* 与列表同一口径（supplier_id + del_flag = '0' + system_level ∈ {L1,L2,L3}），
|
* 只为取 l1/l2/l3 计数，故不涉及月份区间列。
|
*
|
* @param providerUserId 服务商账号ID
|
* @return 各等级已开通数（无数据时各栏为 0）
|
*/
|
public PartnerSubAccountStatVo selectSubAccountLevelCount(@Param("providerUserId") Long providerUserId);
|
}
|
